Tipo de GEOGRAPHY

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 geográfico (ponto, linhagem, polígono etc.) cujo sistema de referência de coordenadas é geográfico e é descrito pelo valor SRID do GEOGRAPHY tipo. O espaço subjacente no qual o objeto geográfico vive é um espaço periódico com o primeiro eixo representando longitudes em graus e o segundo eixo representando latitudes em graus. Espera-se que as coordenadas estejam no intervalo [-180, 180] para longitudes e no intervalo [-90, 90] para latitudes.

Note

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

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

GEOGRAPHY ( { srid | ANY } )

Limits

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

O único valor SRID permitido para o GEOGRAPHY tipo é 4326. O usuário receberá um erro ST_INVALID_SRID_VALUE se tentar definir uma GEOGRAPHY coluna com um valor SRID diferente de 4326.

Literals

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