Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a:
Databricks SQL Databricks Runtime 17.1 e superior
As funções geoespaciais ST operam em objetos do tipo GEOGRAPHY e/ou GEOMETRY, ou permitem construir GEOGRAPHY e GEOMETRY valores a partir de formatos geoespaciais padrão ou populares, ou exportar GEOGRAPHY e GEOMETRY valores para formatos geoespaciais padrão ou populares.
Ver também:
Importar funções Databricks para obter funções ST (Databricks Runtime)
Nenhuma importação necessária para Databricks SQL e Spark SQL.
Para importar funções ST para Python ou Scala em blocos de anotações, 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 GEOGRAPHY(4326) valor da sua representação GeoJSON. |
| st_geogfromtext(wktExpr) | Retorna um GEOGRAPHY(4326) valor da sua representação WKT. |
| st_geogfromwkb(wktExpr) | Retorna um GEOGRAPHY(4326) valor da representação WKB. |
| st_geogfromwkt(wktExpr) | Retorna um GEOGRAPHY(4326) valor da sua representação WKT. |
| st_geomfromewkb(wktExpr) | Retorna um valor da sua representação EWKB. |
| st_geomfromgeohash(geohashExpr) | Retorna a caixa de grade geohash correspondente ao valor geohash de entrada como um valor de polígono GEOMETRY 2D. |
| st_geomfromgeojson(geojsonExpr) | Retorna um GEOMETRY(4326) valor da sua representação GeoJSON. |
| st_geomfromtext(wktExpr[, sridExpr]) | Retorna um GEOMETRY(srid) ou GEOMETRY(ANY) valor da sua representação WKT e define o seu valor SRID como sridExpr, ou 0 caso sridExpr seja omitido. |
| st_geomfromwkb(wkbExpr[, sridExpr]) | Retorna um valor de GEOMETRY(srid) ou GEOMETRY(ANY) da sua representação WKB e define o seu valor SRID como o valor de sridExpr, ou 0 se sridExpr for omitido. |
| st_geomfromwkt(wktExpr[, sridExpr]) | Retorna um GEOMETRY(srid) ou GEOMETRY(ANY) valor da sua representação WKT e define o seu valor SRID como sridExpr, ou 0 caso sridExpr seja omitido. |
| st_pointfromgeohash(geohash) | Retorna o centro da caixa de grade do geohash correspondente ao valor geohash de entrada como uma geometria de ponto 2D. |
| to_geography(georepExpr) | Retorna um GEOGRAPHY(ANY) valor da sua representação GeoJSON, WKB ou WKT. |
| to_geometry(georepExpr) | Retorna um GEOMETRY(ANY) valor a partir da sua representação EWKB, GeoJSON, 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 da sua representação EWKB, GeoJSON, WKB ou WKT, ou NULL caso a representação fornecida seja inválida. |
Export
| Function | Description |
|---|---|
| st_asbinary(geoExpr) | Retorna a representação WKB do valor de entrada GEOGRAPHY ou GEOMETRY como um valor de 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 valor como um STRING valor. |
| st_asewkt(geoExpr) | Retorna a representação EWKT do valor de entrada GEOGRAPHY ou GEOMETRY como STRING. |
| st_astext(geoExpr) | Retorna a representação WKT do valor de entrada GEOGRAPHY ou GEOMETRY como um valor STRING. |
| st_aswkb(geoExpr) | Retorna a representação WKB do valor de entrada GEOGRAPHY ou GEOMETRY como um valor de BINARY. |
| st_aswkt(geoExpr) | Retorna a representação WKT do valor de entrada GEOGRAPHY ou GEOMETRY como um valor STRING. |
| st_geohash(geoExpr [, precisionExpr]) | Devolve o geohash da geometria de entrada com a precisão dada. |
Measurements
| Function | Description |
|---|---|
| st_area(geoExpr) | Retorna a área do valor de entrada GEOGRAPHY ou GEOMETRY. |
| st_distance(geoExpr1, geoExpr2) | Devolve a distância cartesiana 2D entre os dois valores de entrada GEOMETRY . |
| st_distancesphere(geoExpr1, geoExpr2) | Devolve a distância esférica (em metros) entre dois valores pontuais GEOMETRY , medidos numa esfera cujo raio é o raio médio do elipsoide WGS84. |
| st_distancespheroid(geoExpr1, geoExpr2) | Devolve a distância geodésica (em metros) entre dois valores de pontos GEOMETRY no elipsoide WGS84. |
| st_length(geoExpr) | Devolve o comprimento do valor de entrada GEOGRAPHY ou GEOMETRY. |
| st_perimeter(geoExpr) | Retorna o perímetro do valor de entrada GEOGRAPHY ou GEOMETRY. |
Constructors
| Function | Description |
|---|---|
| st_makeline(geoArray) | Retorna um valor de cadeia de caracteres GEOMETRY de linha cujos pontos são os pontos não vazios das geometrias na matriz de entrada de geometrias, que se espera que sejam pontos, cadeias de caracteres de linha ou multipontos. |
| st_makepolygon(exterior[, innerArray]) | Constrói um valor de polígono GEOMETRY a partir do limite externo de entrada e da matriz opcional de limites internos, representados como cadeias de caracteres de linha fechadas. |
| 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) | Devolve a dimensão topológica da projeção 2D do GEOMETRY valor. |
| st_dump(geoExpr) | Retorna uma matriz contendo as geometrias únicas na geometria de entrada. |
| st_endpoint(geoExpr) | Retorna o último ponto da entrada GEOGRAPHY ou GEOMETRY valor, se o valor geoespacial de entrada for uma cadeia de caracteres de linha não vazia. |
| st_envelope(geoExpr) | Devolve um valor cartesiano GEOMETRY 2D que representa a caixa delimitadora mínima (envelope) alinhada ao eixo 2D do valor de entrada GEOMETRY . |
| st_envelope_agg(geoCol) | Retorna o envelope de todas as geometrias presentes na coluna, ou NULL caso a coluna tenha zero linhas, ou contenha apenas valores NULL. |
| st_exteriorring(geoExpr) | Retorna o anel externo do polígono GEOGRAPHY de entrada ou GEOMETRY como uma cadeia de linha. |
| st_geometryn(geoExpr, nExpr) | Retorna o elemento n-ésimo, começando do 1, do valor de entrada GEOMETRY, como um valor de GEOMETRY. |
| st_geometrytype(geoExpr) | Retorna o tipo da entrada GEOGRAPHY ou GEOMETRY valor como uma cadeia de caracteres. |
| st_interiorringn(geoExpr, indexExpr) | Devolve o n-ésimo anel interior do polígono GEOGRAPHY de entrada ou GEOMETRY como uma cadeia de linha. |
| st_isempty(geoExpr) | Retorna verdadeiro 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 da entrada GEOGRAPHY ou GEOMETRY. |
| st_npoints(geoExpr) | Devolve o número de pontos não vazios na entrada GEOGRAPHY ou no valor GEOMETRY. |
| st_numgeometries(geoExpr) | Devolve o número de geometrias no valor de entrada GEOMETRY . |
| st_numinteriorrings(geoExpr) | Retorna o número de anéis interiores no polígono de entrada GEOGRAPHY ou no valor GEOMETRY. |
| st_pointn(geoExpr, indexExpr) | Retorna o n-ésimo ponto da cadeia de caracteres GEOGRAPHYGEOMETRY ou valor da linha de entrada. |
| st_startpoint(geoExpr) | Retorna o primeiro ponto do valor de entrada GEOGRAPHY ou GEOMETRY, se o valor geoespacial de entrada for uma linha de polígono não vazia. |
| st_x(geoExpr) | Retorna a coordenada X do valor do ponto GEOMETRY de entrada ou NULL se o ponto estiver 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) | Devolve 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 estiver vazio. |
| st_ymax(geoExpr) | Devolve a coordenada Y máxima do valor de entrada GEOMETRY ou NULL se a geometria estiver vazia. |
| st_ymin(geoExpr) | Retorna a coordenada Y mínima 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 estiver vazio ou não tiver 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) | Devolve 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
| Function | Description |
|---|---|
| st_addpoint(geo1Expr, geo2Expr[, indexExpr]) | Adiciona um novo ponto à n-ésima posição na sequência de linhas de entrada GEOGRAPHY ou GEOMETRY valor. |
| st_flipcoordinates(geoExpr) | Troca as coordenadas X e Y do valor de entrada GEOMETRY . |
| st_multi(geoExpr) | Devolve GEOGRAPHY ou GEOMETRY como um valor equivalente multigeoespacial. |
| st_removepoint(geoExpr, indexExpr) | Remove o n-ésimo ponto da cadeia de caracteres GEOGRAPHYGEOMETRY ou valor da linha de entrada. |
| st_reverse(geoExpr) | Inverte o valor de entrada GEOGRAPHY ou GEOMETRY. |
| st_setpoint(geo1Expr, indexExpr, geo2Expr) | Define o n-ésimo ponto da cadeia de caracteres GEOGRAPHYGEOMETRY ou valor da linha de entrada. |
Validação de geometria
| Function | Description |
|---|---|
| st_isvalid(geoExpr) | Retorna 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 valor SRID da 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 à distância
| Function | Description |
|---|---|
| st_dwithin(geoExpr1, geoExpr2, distanceExpr) | Retorna true se a distância cartesiana 2D entre os dois valores de entrada GEOMETRY for menor ou igual ao valor da distância de entrada. |
Relações topológicas
| Function | Description |
|---|---|
| st_contains(geo1, geo2) | Retorna true se o primeiro GEOMETRY valor contiver o segundo GEOMETRY valor. |
| st_covers(geoExpr1, geoExpr2) | Retorna verdadeiro se o primeiro GEOMETRY valor cobrir o segundo GEOMETRY valor. |
| st_disjoint(geoExpr1, geoExpr2) | Retorna true se os dois valores de entrada GEOMETRY estiverem separados. |
| st_equals(geoExpr1, geoExpr2) | Retorna true se os dois valores de entrada GEOMETRY forem geometricamente iguais, o que significa que correspondem ao mesmo conjunto de pontos. |
| st_intersects(geoExpr1, geoExpr2) | Retorna true se os dois valores de entrada GEOMETRY se cruzarem. |
| st_touches(geo1, geo2) | Retorna verdadeiro se os dois valores de entrada GEOMETRY tocarem um no outro. |
| st_within(geo1, geo2) | Retorna true se o primeiro GEOMETRY valor estiver dentro do segundo GEOMETRY valor. |
Funções de sobreposição
| Function | Description |
|---|---|
| st_difference(geoExpr1, geoExpr2) | Devolve a diferença do 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) | Devolve a união do conjunto de pontos dos dois valores de entrada GEOMETRY como uma geometria 2D. |
| st_union_agg(geoCol) | Devolve a união pontual de todas as geometrias na coluna, ou NULL se a coluna tiver zero linhas, ou contiver apenas NULL valores. |
Transformações afins
| Function | Description |
|---|---|
| st_rotate(geoExpr, rotaÂngulo) | Gira o valor de entrada GEOMETRY em torno do eixo Z pelo ângulo de rotação dado (em radianos). |
| st_scale(geoExpr, xfactor, yfactor[, zfactor]) | Dimensiona o valor de entrada GEOMETRY nas direções X, Y e, se especificado, 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
| Function | Description |
|---|---|
| st_buffer(geoExpr, radiusExpr) | Retorna o buffer do valor de entrada GEOMETRY usando o raio especificado. |
| st_centroid(geoExpr) | Devolve o centróide do valor de entrada GEOMETRY como um valor de ponto GEOMETRY 2D. |
| st_concavehull(geoExpr, lengthRatioExpr[, allowHolesExpr]) | Retorna o casco côncavo do valor de entrada GEOMETRY como um GEOMETRY valor usando a razão de comprimento especificada. |
| st_convexhull(geoExpr) | Retorna o casco convexo do valor de entrada GEOMETRY como valor GEOMETRY. |
| st_simplify(geo, tolerância) | Simplifica o valor de entrada GEOMETRY usando o algoritmo Douglas-Peucker. |