Si applica a:
controllo SQL di Databricks Databricks Runtime 17.1 e versioni successive
Le funzioni geospaziali ST operano su oggetti di tipo GEOGRAPHY e/o GEOMETRYoppure consentono di costruire GEOGRAPHY valori e GEOMETRY da formati geospaziali standard o popolari oppure esportare GEOGRAPHY e GEOMETRY valori in formati geospaziali standard o diffusi.
Vedere anche:
Importare le funzioni di Databricks per ottenere le funzioni ST (Databricks Runtime)
Nessuna importazione necessaria per Sql Databricks e Spark SQL.
Per importare le funzioni ST per Python o Scala nei notebook, usare i comandi seguenti:
Python
from pyspark.databricks.sql import functions as dbf
Scala
import com.databricks.sql.functions._
Elenco di funzioni geospaziali st (Databricks SQL)
Import
| Function |
Description |
|
st_geogfromgeojson(geojsonExpr) |
Restituisce un GEOGRAPHY(4326) valore dalla relativa rappresentazione GeoJSON. |
|
st_geogfromtext(wktExpr) |
Restituisce un GEOGRAPHY(4326) valore dalla sua rappresentazione WKT. |
|
st_geogfromwkb(wktExpr) |
Restituisce un GEOGRAPHY(4326) valore dalla relativa rappresentazione WKB. |
|
st_geogfromwkt(wktExpr) |
Restituisce un GEOGRAPHY(4326) valore dalla sua rappresentazione WKT. |
|
st_geomfromewkb(wktExpr) |
Restituisce un GEOMETRY(ANY) valore dalla sua rappresentazione EWKB. |
|
st_geomfromgeohash(geohashExpr) |
Restituisce il riquadro della griglia geohash corrispondente al valore geohash di input come poligono 2D GEOMETRY. |
|
st_geomfromgeojson(geojsonExpr) |
Restituisce un GEOMETRY(4326) valore dalla relativa rappresentazione GeoJSON. |
|
st_geomfromtext(wktExpr[, sridExpr]) |
Restituisce un valore GEOMETRY(srid) o GEOMETRY(ANY) dalla sua rappresentazione WKT e imposta il valore SRID, impostandolo su sridExpr o 0 se sridExpr viene omesso. |
|
st_geomfromwkb(wkbExpr[, sridExpr]) |
Restituisce un valore GEOMETRY(srid) o GEOMETRY(ANY) dalla sua rappresentazione WKB e imposta il valore SRID a sridExpr, oppure a 0 se sridExpr viene omesso. |
|
st_geomfromwkt(wktExpr[, sridExpr]) |
Restituisce un valore GEOMETRY(srid) o GEOMETRY(ANY) dalla sua rappresentazione WKT e imposta il valore SRID, impostandolo su sridExpr o 0 se sridExpr viene omesso. |
|
st_pointfromgeohash(geohash) |
Restituisce il centro della casella della griglia geohash corrispondente al valore geohash di input come geometria di punto 2D. |
|
to_geography(georepExpr) |
Restituisce un GEOGRAPHY(ANY) valore dalla relativa rappresentazione GeoJSON, WKB o WKT. |
|
to_geometry(georepExpr) |
Restituisce un GEOMETRY(ANY) valore dalla relativa rappresentazione EWKB, GeoJSON, WKB o WKT. |
|
try_to_geography(georepExpr) |
Restituisce un GEOGRAPHY(ANY) valore dalla relativa rappresentazione GeoJSON, WKB o WKT oppure NULL se la rappresentazione di input non è valida. |
|
try_to_geometry(georepExpr) |
Restituisce un GEOMETRY(ANY) valore dalla relativa rappresentazione EWKB, GeoJSON, WKB o WKT oppure NULL se la rappresentazione di input non è valida. |
Export
| Function |
Description |
|
st_asbinary(geoExpr) |
Restituisce la rappresentazione WKB del valore di input GEOGRAPHY o GEOMETRY come valore BINARY. |
|
st_asewkb(geoExpr) |
Restituisce la rappresentazione EWKB del valore di input GEOMETRY come valore BINARY. |
|
st_asgeojson(geoExpr) |
Restituisce la rappresentazione GeoJSON dell'input GEOGRAPHY o GEOMETRY come valore STRING. |
|
st_asewkt(geoExpr) |
Restituisce la rappresentazione EWKT dell'input GEOGRAPHY o GEOMETRY come valore STRING. |
|
st_astext(geoExpr) |
Restituisce la rappresentazione WKT dell'input GEOGRAPHY o GEOMETRY come valore STRING. |
|
st_aswkb(geoExpr) |
Restituisce la rappresentazione WKB del valore di input GEOGRAPHY o GEOMETRY come valore BINARY. |
|
st_aswkt(geoExpr) |
Restituisce la rappresentazione WKT dell'input GEOGRAPHY o GEOMETRY come valore STRING. |
|
st_geohash(geoExpr [, precisionExpr]) |
Restituisce il geohash della geometria di input in corrispondenza della precisione specificata. |
Measurements
Constructors
| Function |
Description |
|
st_makeline(geoArray) |
Restituisce un valore linestring GEOMETRY i cui punti sono i punti non vuoti delle geometrie presenti nell'array di geometrie di input, che devono essere punti, linestring o multipunti. |
|
st_makepolygon(outer[, innerArray]) |
Costruisce un valore poligono GEOMETRY dal limite esterno di input e dalla matrice facoltativa di limiti interni, rappresentati come stringhe di riga chiuse. |
|
st_point(x, y [, srid]) |
Restituisce un valore di punto GEOMETRY con le coordinate X e Y specificate e il valore SRID (se specificato). |
Accessors
| Function |
Description |
|
st_dimension(geoExpr) |
Restituisce la dimensione topologica della proiezione 2D del GEOMETRY valore. |
|
st_dump(geoExpr) |
Restituisce una matrice contenente le singole geometrie nella geometria di input. |
|
st_endpoint(geoExpr) |
Restituisce l'ultimo punto del valore di input GEOGRAPHY o GEOMETRY, se il valore geospaziale di input è un LineString non vuoto. |
|
st_envelope(geoExpr) |
Restituisce un valore cartesiano GEOMETRY 2D che rappresenta il rettangolo di selezione minimo (busta) allineato all'asse 2D del valore di input GEOMETRY . |
|
st_envelope_agg(geoCol) |
Restituisce l'involucro di tutte le geometrie della colonna, oppure NULL se la colonna ha zero righe, o contiene solo valori di NULL. |
|
st_exteriorring(geoExpr) |
Restituisce l'anello esterno del poligono GEOGRAPHY di input o GEOMETRY come lineare. |
|
st_geometryn(geoExpr, nExpr) |
Restituisce l'n-esimo elemento con base 1 del valore di input GEOMETRY come valore GEOMETRY. |
|
st_geometrytype(geoExpr) |
Restituisce come stringa il tipo dell'input GEOGRAPHY o GEOMETRY. |
|
st_interiorringn(geoExpr, indexExpr) |
Restituisce l'n-esimo anello interno del poligono di input GEOGRAPHY o GEOMETRY come linea. |
|
st_isempty(geoExpr) |
Restituisce true se l'input GEOGRAPHY o GEOMETRY non contiene alcun punto non vuoto. |
|
st_m(geoExpr) |
Restituisce la coordinata M del valore del punto GEOMETRY di input o NULL se il punto è vuoto o non ha una coordinata M. |
|
st_ndims(geoExpr) |
Restituisce la dimensione della coordinata del valore di input GEOGRAPHY o GEOMETRY. |
|
st_npoints(geoExpr) |
Restituisce il numero di punti non vuoti nei valori di input GEOGRAPHY o GEOMETRY. |
|
st_numgeometries(geoExpr) |
Restituisce il numero di geometrie nel valore di input GEOMETRY . |
|
st_numinteriorrings(geoExpr) |
Restituisce il numero di anelli interni nel poligono di input GEOGRAPHY o nel valore GEOMETRY. |
|
st_pointn(geoExpr, indexExpr) |
Restituisce il n-esimo punto dalla stringa di riga GEOGRAPHY o GEOMETRY dal valore di input. |
|
st_startpoint(geoExpr) |
Restituisce il primo punto del valore di input GEOGRAPHY o GEOMETRY, se il valore geospaziale di input è una linea non vuota. |
|
st_x(geoExpr) |
Restituisce la coordinata X del valore del punto GEOMETRY di input o NULL se il punto è vuoto. |
|
st_xmax(geoExpr) |
Restituisce la coordinata X massima del valore di input GEOMETRY o NULL se la geometria è vuota. |
|
st_xmin(geoExpr) |
Restituisce la coordinata X minima del valore di input GEOMETRY o NULL se la geometria è vuota. |
|
st_y(geoExpr) |
Restituisce la coordinata Y del valore del punto GEOMETRY di input o NULL se il punto è vuoto. |
|
st_ymax(geoExpr) |
Restituisce la coordinata Y massima del valore di input GEOMETRY o NULL se la geometria è vuota. |
|
st_ymin(geoExpr) |
Restituisce la coordinata Y minima del valore di input GEOMETRY o NULL se la geometria è vuota. |
|
st_z(geoExpr) |
Restituisce la coordinata Z del valore del punto GEOMETRY di input oppure NULL se il punto è vuoto o non ha una coordinata Z. |
|
st_zmax(geoExpr) |
Restituisce la coordinata Z massima del valore di input GEOMETRY oppure NULL se la geometria è vuota o non ha una coordinata Z. |
|
st_zmin(geoExpr) |
Restituisce la coordinata Z minima del valore di input GEOMETRY oppure NULL se la geometria è vuota o non ha una coordinata Z. |
Editors
Convalida della geometria
| Function |
Description |
|
st_isvalid(geoExpr) |
Restituisce true se il valore di input GEOMETRY è una geometria valida nel senso OGC. |
Funzioni del sistema di riferimento spaziale
| Function |
Description |
|
st_setsrid(geo, srid) |
Restituisce un nuovo GEOMETRY valore il cui SRID è il valore SRID specificato. |
|
st_srid(geoExpr) |
Restituisce lo SRID del valore di input GEOGRAPHY o GEOMETRY. |
|
st_transform(geo, srid) |
Trasforma le coordinate X e Y dell'input GEOMETRY dal sistema di riferimento delle coordinate corrente al sistema di riferimento delle coordinate descritto dal valore SRID fornito. |
Relazioni di distanza
Relazioni topologiche
Funzioni di sovrapposizione
| Function |
Description |
|
st_difference(geoExpr1, geoExpr2) |
Restituisce la differenza del set di punti dei due valori di input GEOMETRY come valore 2D GEOMETRY . |
|
st_intersection(geoExpr1, geoExpr2) |
Restituisce l'intersezione del set di punti dei due valori di input GEOMETRY come valore 2D GEOMETRY . |
|
st_union(geo1, geo2) |
Restituisce il set di punti uniti dei due valori di input GEOMETRY come geometria 2D. |
|
st_union_agg(geoCol) |
Restituisce l'unione a livello di punto di tutte le geometrie della colonna oppure NULL se la colonna contiene zero righe o contiene solo NULL valori. |
| Function |
Description |
|
st_rotate(geoExpr, rotationAngle) |
Ruota il valore di input GEOMETRY attorno all'asse Z in base all'angolo di rotazione specificato (in radianti). |
|
st_scale(geoExpr, xfactor, yfactor[, zfactor]) |
Ridimensiona il valore di input GEOMETRY nelle direzioni X, Y e, se specificato, Z usando i fattori di ridimensionamento forniti. |
|
st_translate(geoExpr, xoffset, yoffset[, zoffset]) |
Converte il valore di input GEOMETRY nelle direzioni X, Y e, se specificato, Z utilizzando gli offset specificati. |
Elaborazione geometry