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 . El valor SRID del valor devuelto GEOMETRY depende del formato de entrada.

Syntax

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 geografía de entrada.

La función devuelve NULL si la entrada es NULL.

Condiciones de error

• Si geoRepExpr es de tipo BINARY y el valor es un EWKB no válido, la función devuelve EWKB_PARSE_ERROR.
• Si geoRepExpr es de tipo BINARY y el valor es un WKB no válido, la función devuelve WKB_PARSE_ERROR.
• Si geoRepExpr es de tipo STRING y el valor es un WKT no válido, la función devuelve WKT_PARSE_ERROR.
• Si geoRepExpr es de tipo STRING y el valor es un GeoJSON no válido, la función devuelve GEOJSON_PARSE_ERROR.

Examples

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

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

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

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

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
• try_to_geography Función
• try_to_geometry Función