GEOMETRY tipo

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

Important

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

Representa un objeto geométrico (point, linestring, polygon, etc.) cuyo sistema de referencia de coordenadas es Euclidean para las coordenadas primera (X) y segunda (Y), así como su coordenada Z si existe. El sistema de referencia de coordenadas subyacente se describe mediante el valor SRID del GEOMETRY tipo . Si el sistema de referencia de coordenadas subyacente es desconocido, se usa el valor 0 . Las unidades de las coordenadas X, Y, opcionalmente, Z son las implícitas por el SRID (excepto el valor 0 SRID en cuyo caso depende del contexto de uso del usuario).

Note

Las tablas Iceberg no admiten GEOMETRY columnas.

Syntax

GEOMETRY ( { srid | ANY } )

Limits

Una columna de tipo GEOMETRY(ANY) puede contener geometrías cuyos valores SRID pueden ser diferentes por fila. No se puede conservar una columna de tipo GEOMETRY(ANY) .

Se admiten unos 11000 valores SRID. Más información sobre SRID. El usuario recibirá un error de ST_INVALID_SRID_VALUE si intenta definir una GEOMETRY columna con un valor SRID no admitido.

Literals

Para obtener más información sobre cómo crear un GEOMETRY valor, consulte:

• st_geomfromgeojson Función
• st_geomfromtext Función
• st_geomfromwkb Función
• st_geomfromwkt Función
• to_geometry Función
• try_to_geometry Función

Notes

• Para convertir un GEOMETRY valor en uno de los formatos estándar geoespaciales o ampliamente usados, puede usar:
  • st_asbinary función para exportar un objeto GEOMETRY en formato WKB.
  • st_asewkb función para exportar un objeto GEOMETRY en formato WKB extendido (EWKB).
  • st_asewkt función para exportar un GEOMETRY en formato WKT extendido (EWKT).
  • st_asgeojson función para exportar un objeto GEOMETRY en formato GeoJSON.
  • st_astext función para exportar un GEOMETRY en formato WKT.

Examples

> SELECT hex(st_asbinary(st_geomfromtext('POINT(1 2)')));
  0101000000000000000000f03f0000000000000040

> SELECT st_asewkt(st_geomfromwkb(X'0101000000000000000000f03f0000000000000040'));
  POINT(1 2)

> SELECT st_asgeojson(st_geomfromtext('POINT(1 2)'));
  {"type":"Point","coordinates":[[1,2]]}

> SELECT st_astext(st_geomfromgeojson('{"type":"Point","coordinates":[[1,2]]}'));
  POINT(1 2)

> SELECT st_astext(to_geometry('{"type":"Point","coordinates":[[1,2]]}'));
  POINT(1 2)

> SELECT try_to_geometry('not a geometry value');
  NULL

Related

• st_asbinary Función
• st_asgeojson Función
• st_asewkb Función
• st_asewkt Función
• st_astext Función
• st_geomfromewkb Función
• st_geomfromgeojson Función
• st_geomfromtext Función
• st_geomfromwkb Función
• to_geometry Función
• try_to_geometry Función