try_to_geometry 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 geometría y devuelve el valor correspondiente GEOMETRY , o NULL si la descripción de entrada no es válida. El valor SRID del valor devuelto GEOMETRY depende del formato de entrada.

Syntax

try_to_geometry ( geoRepExpr )

Arguments

• geoRepExpr: una BINARY expresión o STRING que representa una geometría en WKB, WKT, GeoJSON o WKB extendido (EWKB).

Returns

Valor de tipo GEOMETRY(ANY), que corresponde a la descripción de geometrí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 geometría.

Examples

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

-- Input geometry is in GeoJSON format.
> SELECT st_astext(try_to_geometry('{"type":"Point","coordinates":[3,4,5]}'));
  POINT Z (3 4 5)

-- Input geometry is in WKB format.
> SELECT st_astext(try_to_geometry(X'0101000060110f0000000000000000084000000000000010400000000000001440'));
  POINT M (3 4 5)

-- Input geometry is in EWKB format.
> SELECT st_asewkt(try_to_geometry(X'01010000E0110F0000000000000000084000000000000010400000000000001440000000000000F0BF'));
  SRID=3857;POINT ZM (3 4 5 -1)

-- Input value is not the description of a geometry.
> SELECT st_astext(try_to_geometry('some string that does not represent a geometry'))
  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_geography Función