Tipo de GEOMETRY

Aplica-se a:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

Important

Esse recurso está em Visualização Pública.

Representa um objeto geométrico (ponto, linhagem, polígono etc.) cujo sistema de referência de coordenadas é euclidiano para as primeiras coordenadas (X) e segunda (Y), bem como sua coordenada Z, se existir. O sistema de referência de coordenadas subjacente é descrito pelo valor SRID do GEOMETRY tipo. Se o sistema de referência de coordenadas subjacente for desconhecido, o valor 0 será usado. As unidades das coordenadas X, Y, opcionalmente Z são aquelas implícitas pelo SRID (exceto pelo valor 0 SRID, nesse caso, depende do contexto de uso do usuário).

Note

  • Tabelas iceberg não dão suporte a colunas GEOMETRY.

  • GEOMETRY Não há suporte para colunas como dimensões em exibições de métrica ou exibições materializadas do Lakeflow Spark Declarative Pipelines porque esses contextos exigem GROUP BY suporte, que os dados geoespaciais não fornecem no momento. Para usar dados geoespaciais em uma exibição de métrica, adicione a coluna como medida em vez de uma dimensão.

Syntax

GEOMETRY ( { srid | ANY } )

Limits

Uma coluna de tipo GEOMETRY(ANY) pode conter geometrias cujos valores SRID podem ser diferentes por linha. Não é possível persistir uma coluna do tipo GEOMETRY(ANY).

Há suporte para cerca de 11.000 valores SRID. Saiba mais sobre o SRID. O usuário receberá um erro ST_INVALID_SRID_VALUE se tentar definir uma GEOMETRY coluna com um valor SRID sem suporte.

Literals

Para obter detalhes sobre como criar um 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