GEOMETRY tipo

Se aplica a:check marcado yes Databricks SQL check marcado yes 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.

  • GEOMETRY Las columnas no se admiten como dimensiones en las vistas de métricas o en las vistas declarativas de Spark de Lakeflow vistas materializadas porque esos contextos requieren GROUP BY compatibilidad, que los datos geoespaciales no proporcionan actualmente. Para usar datos geoespaciales en una vista de métrica, agregue la columna como medida en lugar de una dimensión.

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:

Notes

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