Aplica-se a:
Databricks SQL Databricks Runtime 17.1 and above
As funções geoespaciais ST operam em objetos de tipo GEOGRAPHY e/ou GEOMETRY, ou permitem construir GEOGRAPHY e GEOMETRY valores de formatos geoespaciais padrão ou populares, ou exportar GEOGRAPHY e GEOMETRY valores para formatos geoespaciais padrão ou populares.
Veja também:
Importar funções do Databricks para obter funções ST (Databricks Runtime)
Nenhuma importação necessária para o SQL do Databricks e o SQL do Spark.
Para importar funções ST para Python ou Scala em notebooks, use os seguintes comandos:
Python
from pyspark.databricks.sql import functions as dbf
Scala
import com.databricks.sql.functions._
Lista de Funções Geoespaciais ST (Databricks SQL)
Import
| Function |
Description |
|
st_geogfromgeojson(geojsonExpr) |
Retorna um valor GEOGRAPHY(4326) de sua representação GeoJSON. |
|
st_geogfromtext(wktExpr) |
Retorna um valor GEOGRAPHY(4326) a partir de sua representação WKT. |
|
st_geogfromwkb(wktExpr) |
Retorna um valor GEOGRAPHY(4326) a partir de sua representação WKB. |
|
st_geogfromwkt(wktExpr) |
Retorna um valor GEOGRAPHY(4326) a partir de sua representação WKT. |
|
st_geomfromewkb(wktExpr) |
Retorna um valor GEOMETRY(ANY) de sua representação EWKB. |
|
st_geomfromgeohash(geohashExpr) |
Retorna a caixa de grade geohash correspondente ao valor de geohash de entrada como um polígono 2D GEOMETRY. |
|
st_geomfromgeojson(geojsonExpr) |
Retorna um valor GEOMETRY(4326) de sua representação GeoJSON. |
|
st_geomfromtext(wktExpr[, sridExpr]) |
Retorna o valor de GEOMETRY(srid) ou de GEOMETRY(ANY) de sua representação WKT, e define seu valor SRID como o valor de sridExpr, ou de 0 se sridExpr for omitido. |
|
st_geomfromwkb(wkbExpr[, sridExpr]) |
Retorna um valor GEOMETRY(srid) ou GEOMETRY(ANY) de sua representação WKB e define o valor SRID como o valor de sridExpr, ou 0 se sridExpr for omitido. |
|
st_geomfromwkt(wktExpr[, sridExpr]) |
Retorna o valor de GEOMETRY(srid) ou de GEOMETRY(ANY) de sua representação WKT, e define seu valor SRID como o valor de sridExpr, ou de 0 se sridExpr for omitido. |
|
st_pointfromgeohash(geohash) |
Retorna o centro da caixa de grade de geohash correspondente ao geohash de entrada como uma geometria de ponto 2D. |
|
to_geography(georepExpr) |
Retorna um valor GEOGRAPHY(ANY) de sua representação GeoJSON, WKB ou WKT. |
|
to_geometry(georepExpr) |
Retorna um valor GEOMETRY(ANY) de sua representação em GeoJSON, EWKB, WKB ou WKT. |
|
try_to_geography(georepExpr) |
Retorna um GEOGRAPHY(ANY) valor de sua representação GeoJSON, WKB ou WKT ou NULL se a representação de entrada for inválida. |
|
try_to_geometry(georepExpr) |
Retorna um GEOMETRY(ANY) valor de sua representação EWKB, GeoJSON, WKB ou WKT ou NULL se a representação de entrada for inválida. |
Export
| Function |
Description |
|
st_asbinary(geoExpr) |
Retorna a representação WKB do valor de entrada GEOGRAPHY ou GEOMETRY como valor BINARY. |
|
st_asewkb(geoExpr) |
Retorna a representação EWKB do valor de entrada GEOMETRY como um BINARY valor. |
|
st_asgeojson(geoExpr) |
Retorna a representação GeoJSON da entrada GEOGRAPHY ou GEOMETRY, transformando o valor em um STRING. |
|
st_asewkt(geoExpr) |
Retorna como valor GEOGRAPHY a representação EWKT do valor de entrada GEOMETRY ou STRING. |
|
st_astext(geoExpr) |
Retorna a representação WKT da entrada GEOGRAPHY ou GEOMETRY como valor STRING. |
|
st_aswkb(geoExpr) |
Retorna a representação WKB do valor de entrada GEOGRAPHY ou GEOMETRY como valor BINARY. |
|
st_aswkt(geoExpr) |
Retorna a representação WKT da entrada GEOGRAPHY ou GEOMETRY como valor STRING. |
|
st_geohash(geoExpr [, precisionExpr]) |
Retorna o geohash da geometria de entrada na precisão especificada. |
Measurements
Constructors
| Function |
Description |
|
st_makeline(geoArray) |
Retorna um valor linestring GEOMETRY cujos pontos são os pontos não vazios das geometrias na matriz de entrada de geometrias, que devem ser pontos, linhas de linha ou vários pontos. |
|
st_makepolygon(outer[, innerArray]) |
Constrói um valor de polígono GEOMETRY a partir do limite externo de entrada e de uma matriz opcional de limites internos, representados como linestrings fechados. |
|
st_point(x, y [, srid]) |
Retorna um valor de ponto GEOMETRY com as coordenadas X e Y fornecidas e o valor SRID (se fornecido). |
Accessors
| Function |
Description |
|
st_dimension(geoExpr) |
Retorna a dimensão topológica da projeção 2D do GEOMETRY valor. |
|
st_dump(geoExpr) |
Retorna uma matriz que contém as geometrias simples na geometria de entrada. |
|
st_endpoint(geoExpr) |
Retorna o último ponto da entrada GEOGRAPHY ou GEOMETRY, se o valor geoespacial de entrada for um linestring não vazio. |
|
st_envelope(geoExpr) |
Retorna um valor cartesiano GEOMETRY 2D que representa a caixa delimitadora mínima alinhada aos eixos 2D (envelope) do valor de entrada GEOMETRY. |
|
st_envelope_agg(geoCol) |
Retorna o envelope de todas as geometrias na coluna ou NULL se a coluna tem zero linhas ou se a coluna contém somente valores NULL. |
|
st_exteriorring(geoExpr) |
Retorna o anel exterior do polígono GEOGRAPHY de entrada ou GEOMETRY como um linestring. |
|
st_geometryn(geoExpr, nExpr) |
Retorna o n-ésimo elemento indexado a partir de 1 do valor de entrada GEOMETRY como um valor GEOMETRY. |
|
st_geometrytype(geoExpr) |
Retorna o tipo de entrada GEOGRAPHY ou GEOMETRY valor como uma cadeia de caracteres. |
|
st_interiorringn(geoExpr, indexExpr) |
Retorna o anel interior n-ésimo do polígono GEOGRAPHY de entrada ou GEOMETRY como um LineString. |
|
st_isempty(geoExpr) |
Retorna true se o valor da entrada GEOGRAPHY ou GEOMETRY não contiver nenhum ponto não vazio. |
|
st_m(geoExpr) |
Retorna a coordenada M do valor do ponto GEOMETRY de entrada ou NULL se o ponto estiver vazio ou não tiver uma coordenada M. |
|
st_ndims(geoExpr) |
Retorna a dimensão da coordenada do valor de entrada GEOGRAPHY ou GEOMETRY. |
|
st_npoints(geoExpr) |
Retorna o número de pontos não vazios nos valores de entrada GEOGRAPHY ou GEOMETRY. |
|
st_numgeometries(geoExpr) |
Retorna o número de geometrias no valor de entrada GEOMETRY . |
|
st_numinteriorrings(geoExpr) |
Retorna o número de anéis interiores no polígono GEOGRAPHY ou GEOMETRY valor de entrada. |
|
st_pointn(geoExpr, indexExpr) |
Retorna o n-ésimo ponto da linestring GEOGRAPHY de entrada ou do valor GEOMETRY. |
|
st_startpoint(geoExpr) |
Retorna o primeiro ponto do valor de entrada GEOGRAPHY ou GEOMETRY, se o valor geoespacial de entrada for um linestring não vazio. |
|
st_x(geoExpr) |
Retorna a coordenada X do valor do ponto GEOMETRY de entrada ou NULL se o ponto está vazio. |
|
st_xmax(geoExpr) |
Retorna a coordenada X máxima do valor de entrada GEOMETRY ou NULL se a geometria estiver vazia. |
|
st_xmin(geoExpr) |
Retorna a coordenada X mínima do valor de entrada GEOMETRY ou NULL se a geometria estiver vazia. |
|
st_y(geoExpr) |
Retorna a coordenada Y do valor do ponto GEOMETRY de entrada ou NULL se o ponto está vazio. |
|
st_ymax(geoExpr) |
Retorna a coordenada Y máxima do valor de entrada GEOMETRY ou NULL se a geometria estiver vazia. |
|
st_ymin(geoExpr) |
Retorna a coordenada mínima Y do valor de entrada GEOMETRY ou NULL se a geometria estiver vazia. |
|
st_z(geoExpr) |
Retorna a coordenada Z do valor do ponto GEOMETRY de entrada ou NULL se o ponto está vazio ou não tem uma coordenada Z. |
|
st_zmax(geoExpr) |
Retorna a coordenada Z máxima do valor de entrada GEOMETRY ou NULL se a geometria estiver vazia ou não tiver uma coordenada Z. |
|
st_zmin(geoExpr) |
Retorna a coordenada Z mínima do valor de entrada GEOMETRY ou NULL se a geometria estiver vazia ou não tiver uma coordenada Z. |
Editors
Validação de geometria
| Function |
Description |
|
st_isvalid(geoExpr) |
Retornará true se o valor de entrada GEOMETRY for uma geometria válida no sentido OGC. |
Funções do sistema de referência espacial
| Function |
Description |
|
st_setsrid(geo, srid) |
Retorna um novo GEOMETRY valor cujo SRID é o valor SRID especificado. |
|
st_srid(geoExpr) |
Retorna o SRID do valor de entrada GEOGRAPHY ou GEOMETRY. |
|
st_transform(geo, srid) |
Transforma as coordenadas X e Y da entrada GEOMETRY do sistema de referência de coordenadas atual para o sistema de referência de coordenadas descrito pelo valor SRID fornecido. |
Relações de distância
Relações topológicas
Funções de sobreposição
| Function |
Description |
|
st_difference(geoExpr1, geoExpr2) |
Retorna a diferença de conjunto de pontos dos dois valores de entrada GEOMETRY como um valor 2D GEOMETRY . |
|
st_intersection(geoExpr1, geoExpr2) |
Retorna a interseção do conjunto de pontos dos dois valores de entrada GEOMETRY como um valor 2D GEOMETRY. |
|
st_union(geo1, geo2) |
Retorna a união de conjunto de pontos dos dois valores de entrada GEOMETRY como uma geometria 2D. |
|
st_union_agg(geoCol) |
Retorna a união pontual de todas as geometrias na coluna ou NULL se a coluna tem zero linhas ou contém apenas NULL valores. |
| Function |
Description |
|
st_rotate(geoExpr, rotationAngle) |
Gira o valor de entrada GEOMETRY em torno do eixo Z pelo ângulo de rotação fornecido (em radianos). |
|
st_scale(geoExpr, xfactor, yfactor[, zfactor]) |
Dimensiona o valor de entrada GEOMETRY nas direções X, Y e, se especificada, Z usando os fatores de dimensionamento fornecidos. |
|
st_translate(geoExpr, xoffset, yoffset[, zoffset]) |
Traduz o valor de entrada GEOMETRY nas direções X, Y e, se especificado, Z usando os deslocamentos fornecidos. |
Processamento de geometria