GEOGRAPHY 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 geográfico (point, linestring, polygon, etc.) cuyo sistema de referencia de coordenadas es geográfico y se describe mediante el valor SRID del GEOGRAPHY tipo. El espacio subyacente en el que reside el objeto geográfico es un espacio periódico con el primer eje que representa longitudes en grados y el segundo eje que representa las latitudes en grados. Se espera que las coordenadas estén en [-180, 180] para las longitudes y en el rango [-90, 90] para las latitudes.

Note

  • Las tablas Iceberg no admiten GEOGRAPHY columnas.

  • GEOGRAPHY 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

GEOGRAPHY ( { srid | ANY } )

Limits

Una columna de tipo GEOGRAPHY(ANY) puede contener zonas geográficas cuyos valores SRID pueden ser diferentes por fila. No se puede conservar una columna de tipo GEOGRAPHY(ANY) .

El único valor SRID permitido para el GEOGRAPHY tipo es 4326. El usuario obtendrá un error de ST_INVALID_SRID_VALUE si intenta definir una GEOGRAPHY columna con un valor SRID distinto de 4326.

Literals

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

Notes

Examples

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

> SELECT st_asewkt(st_geogfromwkb(X'0101000000000000000000f03f0000000000000040'));
  SRID=4326;POINT(1 2)

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

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

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

> SELECT try_to_geography('not a geography value');
  NULL