Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Tipo de
Aplica-se a:
Databricks SQL
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.GEOGRAPHYNã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 exigemGROUP BYsuporte, 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:
-
st_geogfromewktfunção -
st_geogfromgeojsonfunção -
st_geogfromtextfunção -
st_geogfromwkbfunção -
st_geogfromwktfunção -
to_geographyfunção -
try_to_geographyfunção
Notes
- Para converter um
GEOGRAPHYvalor em um dos formatos geoespaciais padrão ou amplamente usados, você pode usar:-
st_asbinaryfunção para exportar umGEOGRAPHYno formato WKB. -
st_asewktfunção para exportar umGEOGRAPHYno formato EWKT (WKT estendido). -
st_asgeojsonfunção para exportar umGEOGRAPHYno formato GeoJSON. -
st_astextfunção para exportar umGEOGRAPHYno formato WKT.
-
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