Partilhar via

to_geography Função

Aplica-se a:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 e superior

Important

Este recurso está no Public Preview.

Observação

Esse recurso não está disponível nos armazéns Databricks SQL Classic. Para saber mais sobre os armazéns SQL do Databricks, consulte Tipos de armazém SQL.

Analisa a descrição de entrada de uma geografia e retorna o valor correspondente GEOGRAPHY . O valor SRID do valor retornado GEOGRAPHY é 4326.

Syntax

to_geography ( geoRepExpr )

Arguments

  • geoRepExpr: Uma BINARY ou STRING expressão que representa uma geografia em WKB, WKT ou GeoJSON.

Returns

Um valor do tipo GEOGRAPHY(ANY), correspondente à descrição da geografia de entrada.

A função retorna NULL se a entrada for NULL.

Condições de erro

  • Se geoRepExpr for do tipo BINARY e o valor for um WKB inválido, a função retornará WKB_PARSE_ERROR.
  • Se geoRepExpr for do tipo STRING e o valor for um WKT inválido, a função retornará WKT_PARSE_ERROR.
  • Se geoRepExpr for do tipo STRING e o valor for um GeoJSON inválido, a função retornará GEOJSON_PARSE_ERROR.

Examples

-- Input geography is in WKT format.
> SELECT st_asgeojson(to_geography('POINT Z (3 4 5)'));
  {"type":"Point","coordinates":[3,4,5]}

-- Input geography is in GeoJSON format.
> SELECT st_asewkt(to_geography('{"type":"Point","coordinates":[3,4,5]}'));
  SRID=4326;POINT Z (3 4 5)

-- Input geography is in WKB format.
> SELECT st_astext(to_geography(X'01b90b0000000000000000084000000000000010400000000000001440000000000000f0bf'))
  POINT ZM (3 4 5 -1)
  • Last updated on