Se aplica a:
Databricks SQL Databricks Runtime 17.1 y versiones posteriores
Las funciones geoespaciales ST funcionan en objetos de tipo GEOGRAPHY o GEOMETRY, o permiten construir GEOGRAPHY y GEOMETRY valores a partir de formatos geoespaciales estándar o populares, o exportar GEOGRAPHY y GEOMETRY valores a formatos geoespaciales estándar o populares.
Consulte también:
Importación de funciones de Databricks para obtener funciones ST (Databricks Runtime)
No se necesita ninguna importación para Databricks SQL y Spark SQL.
Para importar funciones ST para Python o Scala en cuadernos, use los siguientes comandos:
Python
from pyspark.databricks.sql import functions as dbf
Scala
import com.databricks.sql.functions._
Lista de funciones geoespaciales de ST (Databricks SQL)
Import
| Function |
Description |
|
st_geogfromgeojson(geojsonExpr) |
Devuelve un GEOGRAPHY(4326) valor de su representación GeoJSON. |
|
st_geogfromtext(wktExpr) |
Devuelve un valor GEOGRAPHY(4326) de su representación WKT. |
|
st_geogfromwkb(wktExpr) |
Devuelve un valor GEOGRAPHY(4326) de su representación WKB. |
|
st_geogfromwkt(wktExpr) |
Devuelve un valor GEOGRAPHY(4326) de su representación WKT. |
|
st_geomfromewkb(wktExpr) |
Devuelve un valor GEOMETRY(ANY) a partir de su representación EWKB. |
|
st_geomfromgeohash(geohashExpr) |
Devuelve el cuadro de cuadrícula geohash como un valor de polígono 2D correspondiente al valor de geohash de entrada GEOMETRY. |
|
st_geomfromgeojson(geojsonExpr) |
Devuelve un GEOMETRY(4326) valor de su representación GeoJSON. |
|
st_geomfromtext(wktExpr[, sridExpr]) |
Devuelve un valor GEOMETRY(srid) o GEOMETRY(ANY) de su representación WKT, y establece su valor SRID en el valor de sridExpr, o 0 si sridExpr se omite. |
|
st_geomfromwkb(wkbExpr[, sridExpr]) |
Devuelve un valor GEOMETRY(srid) o GEOMETRY(ANY) desde su representación WKB y establece su SRID al valor de sridExpr, o al valor de 0 si se omite sridExpr. |
|
st_geomfromwkt(wktExpr[, sridExpr]) |
Devuelve un valor GEOMETRY(srid) o GEOMETRY(ANY) de su representación WKT, y establece su valor SRID en el valor de sridExpr, o 0 si sridExpr se omite. |
|
st_pointfromgeohash(geohash) |
Devuelve el centro del cuadro de cuadrícula de geohash correspondiente al valor de geohash de entrada como una geometría de puntos 2D. |
|
to_geography(georepExpr) |
Devuelve un GEOGRAPHY(ANY) valor de su representación GeoJSON, WKB o WKT. |
|
to_geometry(georepExpr) |
Devuelve un valor de GEOMETRY(ANY) de su representación EWKB, GeoJSON, WKB o WKT. |
|
try_to_geography(georepExpr) |
Devuelve un GEOGRAPHY(ANY) valor de su representación GeoJSON, WKB o WKT, o NULL si la representación de entrada no es válida. |
|
try_to_geometry(georepExpr) |
Devuelve un GEOMETRY(ANY) valor de su representación EWKB, GeoJSON, WKB o WKT, o NULL si la representación de entrada no es válida. |
Export
| Function |
Description |
|
st_asbinary(geoExpr) |
Devuelve la representación WKB del valor de entrada GEOGRAPHY o GEOMETRY como valor de BINARY. |
|
st_asewkb(geoExpr) |
Devuelve la representación EWKB del valor de entrada GEOMETRY como un BINARY valor. |
|
st_asgeojson(geoExpr) |
Devuelve la representación GeoJSON de la entrada GEOGRAPHY o GEOMETRY valor como un STRING valor. |
|
st_asewkt(geoExpr) |
Devuelve la representación EWKT de la entrada GEOGRAPHY o GEOMETRY como valor STRING. |
|
st_astext(geoExpr) |
Devuelve la representación WKT del valor de entrada GEOGRAPHY o GEOMETRY como un STRING. |
|
st_aswkb(geoExpr) |
Devuelve la representación WKB del valor de entrada GEOGRAPHY o GEOMETRY como valor de BINARY. |
|
st_aswkt(geoExpr) |
Devuelve la representación WKT del valor de entrada GEOGRAPHY o GEOMETRY como un STRING. |
|
st_geohash(geoExpr [, precisionExpr]) |
Devuelve el geohash de la geometría de entrada con la precisión especificada. |
Measurements
Constructors
| Function |
Description |
|
st_makeline(geoArray) |
Devuelve un valor de línea GEOMETRY cuyos puntos son los puntos no vacíos de las geometrías de la matriz de geometrías de entrada, que se espera que sean puntos, líneas o multipuntos. |
|
st_makepolygon(outer[, innerArray]) |
Construye un valor de polígono GEOMETRY a partir del límite exterior de entrada y una matriz opcional de límites internos, representado como líneas cerradas. |
|
st_point(x, y [, srid]) |
Devuelve un valor de punto GEOMETRY con las coordenadas X e Y especificadas y el valor SRID (si se proporciona). |
Accessors
| Function |
Description |
|
st_dimension(geoExpr) |
Devuelve la dimensión topológica de la proyección 2D del GEOMETRY valor. |
|
st_dump(geoExpr) |
Devuelve una matriz que contiene las geometrías únicas de la geometría de entrada. |
|
st_endpoint(geoExpr) |
Devuelve el último punto del valor de entrada GEOGRAPHY o GEOMETRY, si el valor geoespacial de entrada es una línea no vacía. |
|
st_envelope(geoExpr) |
Devuelve un valor cartesiano GEOMETRY 2D que representa el cuadro de límite mínimo alineado con el eje 2D (sobre) del valor de entrada GEOMETRY . |
|
st_envelope_agg(geoCol) |
Devuelve el sobre de todas las geometrías de la columna, o NULL si la columna tiene cero filas o contiene solo valores NULL. |
|
st_exteriorring(geoExpr) |
Devuelve el anillo exterior del polígono GEOGRAPHY de entrada o GEOMETRY como una cadena de líneas. |
|
st_geometryn(geoExpr, nExpr) |
Devuelve el n-ésimo elemento contado desde 1 del valor de entrada GEOMETRY como un valor GEOMETRY. |
|
st_geometrytype(geoExpr) |
Devuelve el tipo de entrada GEOGRAPHY o GEOMETRY valor como una cadena. |
|
st_interiorringn(geoExpr, indexExpr) |
Devuelve el n-ésimo anillo interior del polígono GEOGRAPHY de entrada o GEOMETRY como una línea. |
|
st_isempty(geoExpr) |
Devuelve verdadero si el valor de la entrada GEOGRAPHY o GEOMETRY no contiene ningún punto no vacío. |
|
st_m(geoExpr) |
Devuelve la coordenada M del valor del punto GEOMETRY de entrada o NULL si el punto está vacío o no tiene una coordenada M. |
|
st_ndims(geoExpr) |
Devuelve la dimensión de coordenada del valor de entrada GEOGRAPHY o GEOMETRY. |
|
st_npoints(geoExpr) |
Devuelve el número de puntos no vacíos en la entrada GEOGRAPHY o en el valor GEOMETRY. |
|
st_numgeometries(geoExpr) |
Devuelve el número de geometrías del valor de entrada GEOMETRY . |
|
st_numinteriorrings(geoExpr) |
Devuelve el número de anillos interiores del polígono GEOGRAPHY o GEOMETRY valor de entrada. |
|
st_pointn(geoExpr, indexExpr) |
Devuelve el punto n-ésimo del linestring de entrada GEOGRAPHY o del valor GEOMETRY. |
|
st_startpoint(geoExpr) |
Devuelve el primer punto de la entrada GEOGRAPHY o GEOMETRY valor, si el valor geoespacial de entrada es una cadena de línea no vacía. |
|
st_x(geoExpr) |
Devuelve la coordenada X del valor del punto GEOMETRY de entrada o NULL si el punto está vacío. |
|
st_xmax(geoExpr) |
Devuelve la coordenada X máxima del valor de entrada GEOMETRY o NULL si la geometría está vacía. |
|
st_xmin(geoExpr) |
Devuelve la coordenada X mínima del valor de entrada GEOMETRY o NULL si la geometría está vacía. |
|
st_y(geoExpr) |
Devuelve la coordenada Y del valor del punto GEOMETRY de entrada o NULL si el punto está vacío. |
|
st_ymax(geoExpr) |
Devuelve la coordenada Y máxima del valor de entrada GEOMETRY o NULL si la geometría está vacía. |
|
st_ymin(geoExpr) |
Devuelve la coordenada Y mínima del valor de entrada GEOMETRY o NULL si la geometría está vacía. |
|
st_z(geoExpr) |
Devuelve la coordenada Z del valor del punto GEOMETRY de entrada o NULL si el punto está vacío o no tiene una coordenada Z. |
|
st_zmax(geoExpr) |
Devuelve la coordenada Z máxima del valor de entrada GEOMETRY o NULL si la geometría está vacía o no tiene una coordenada Z. |
|
st_zmin(geoExpr) |
Devuelve la coordenada Z mínima del valor de entrada GEOMETRY o NULL si la geometría está vacía o no tiene una coordenada Z. |
Editors
Validación de geometría
| Function |
Description |
|
st_isvalid(geoExpr) |
Devuelve true si el valor de entrada GEOMETRY es una geometría válida en el sentido de OGC. |
Funciones del sistema de referencia espacial
| Function |
Description |
|
st_setsrid(geo, srid) |
Devuelve un nuevo GEOMETRY valor cuyo SRID es el valor SRID especificado. |
|
st_srid(geoExpr) |
Devuelve el SRID del valor de entrada GEOGRAPHY o GEOMETRY. |
|
st_transform(geo, srid) |
Transforma las coordenadas X e Y de la entrada GEOMETRY del sistema de referencia de coordenadas actual al sistema de referencia de coordenadas descrito por el valor SRID proporcionado. |
Relaciones de distancia
Relaciones topológicas
Funciones de superposición
| Function |
Description |
|
st_difference(geoExpr1, geoExpr2) |
Devuelve la diferencia de conjunto de puntos de los dos valores de entrada GEOMETRY como un valor 2D GEOMETRY . |
|
st_intersection(geoExpr1, geoExpr2) |
Devuelve la intersección del conjunto de puntos de los dos valores de entrada GEOMETRY como un valor 2D GEOMETRY . |
|
st_union(geo1, geo2) |
Devuelve la unión de conjunto de puntos de los dos valores de entrada GEOMETRY como una geometría 2D. |
|
st_union_agg(geoCol) |
Devuelve la unión a un punto de todas las geometrías de la columna, o NULL si la columna tiene cero filas o solo NULL contiene valores. |
| Function |
Description |
|
st_rotate(geoExpr, rotationAngle) |
Gira el valor de entrada GEOMETRY alrededor del eje Z por el ángulo de rotación especificado (en radianes). |
|
st_scale(geoExpr, xfactor, yfactor[, zfactor]) |
Escala el valor de entrada GEOMETRY en las direcciones X, Y y, si se especifica, Z utilizando los factores de escalado proporcionados. |
|
st_translate(geoExpr, xoffset, yoffset[, zoffset]) |
Traduce el valor de entrada GEOMETRY en las direcciones X, Y y, si se especifica, Z utilizando los desplazamientos proporcionados. |
Procesamiento de geometría