Compartilhar via


try_to_geography Função

Aplica-se a:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

Important

Esse recurso está em Visualização Pública.

Observação

Esse recurso não está disponível em databricks SQL Classic warehouses. Para saber mais sobre os sql warehouses do Databricks, consulte os tipos de sql warehouse.

Analisa a descrição de entrada de uma geografia e retorna o valor correspondente GEOGRAPHY ou NULL se a descrição de entrada é inválida. O valor SRID do valor retornado GEOGRAPHY é 4326.

Syntax

try_to_geography ( geoRepExpr )

Arguments

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

Returns

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

  • A função retorna NULL se a entrada for NULL.
  • A função retornará NULL se a entrada BINARY ou STRING o valor for uma descrição inválida de uma geografia.

Examples

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

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

-- Input geography is in WKB format.
> SELECT st_astext(try_to_geography(X'01b90b0000000000000000084000000000000010400000000000001440000000000000f0bf'))
  POINT ZM (3 4 5 -1)

-- Input value is not the description of a geography.
> SELECT st_astext(try_to_geography('some string that does not represent a geography'))
  NULL