try_to_geography Función

Se aplica a: Databricks SQL Databricks Runtime 17.1 y versiones posteriores

Important

Esta característica está en versión preliminar pública.

Nota:

Esta característica no está disponible en almacenes clásicos de Databricks SQL. Para más información sobre los almacenes de SQL de Databricks, consulte Tipos de almacenamiento de SQL.

Analiza la descripción de entrada de una geografía y devuelve el valor correspondiente GEOGRAPHY , o NULL si la descripción de entrada no es válida. El valor SRID del valor devuelto GEOGRAPHY es 4326.

Syntax

try_to_geography ( geoRepExpr )

Arguments

• geoRepExpr: expresión BINARY o STRING que representa una geografía en WKB, WKT o GeoJSON.

Returns

Valor de tipo GEOGRAPHY(ANY), que corresponde a la descripción de geografía de entrada.

• La función devuelve NULL si la entrada es NULL.
• La función devuelve NULL si la entrada BINARY o STRING el valor es una descripción no válida de una geografía.

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

Funciones relacionadas

• st_asbinary Función
• st_asewkb Función
• st_asewkt Función
• st_asgeojson Función
• st_astext Función
• st_aswkb Función
• st_aswkt Función
• st_geogfromgeojson Función
• st_geogfromtext Función
• st_geogfromwkb Función
• st_geogfromwkt Función
• st_geomfromewkb Función
• st_geomfromgeojson Función
• st_geomfromtext Función
• st_geomfromwkb Función
• st_geomfromwkt Función
• to_geography Función
• to_geometry Función
• try_to_geometry Función