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 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.GEOMETRYNã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
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:
-
st_geomfromewktfunção -
st_geomfromgeojsonfunção -
st_geomfromtextfunção -
st_geomfromwkbfunção -
st_geomfromwktfunção -
to_geometryfunção -
try_to_geometryfunção
Notes
- Para converter um
GEOMETRYvalor em um dos formatos geoespaciais padrão ou amplamente usados, você pode usar:-
st_asbinaryfunção para exportar umGEOMETRYno formato WKB. -
st_asewkbfunção para exportar umGEOMETRYno formato EWKB (WKB estendido). -
st_asewktfunção para exportar umGEOMETRYno formato EWKT (WKT estendido). -
st_asgeojsonfunção para exportar umGEOMETRYno formato GeoJSON. -
st_astextfunção para exportar umGEOMETRYno formato WKT.
-
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