Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A következőre vonatkozik:
Databricks SQL Databricks Runtime 17.1 és újabb
Important
Ez a funkció nyilvános előzetes verzióban van.
Az ST térinformatikai függvények olyan típusú GEOGRAPHY és/vagy GEOMETRY típusú objektumokon működnek, vagy lehetővé teszik GEOGRAPHY és GEOMETRY értékek előállítását szabványos vagy népszerű térinformatikai formátumokból, illetve GEOGRAPHY és GEOMETRY értékek exportálását ezekbe a formátumokba.
Lásd még:
Databricks-függvények importálása ST-függvények lekéréséhez (Databricks Runtime)
Nincs szükség importálásra a Databricks SQL-hez és a Spark SQL-hez.
Ha a Python vagy a Scala ST-függvényeit jegyzetfüzetekbe szeretné importálni, használja a következő parancsokat:
Python
from pyspark.databricks.sql import functions as dbf
Scala
import com.databricks.sql.functions._
ST térinformatikai függvények listája (Databricks SQL)
Import
| Function | Description |
|---|---|
| st_geogfromgeojson(geojsonExpr) | Egy értéket ad GEOGRAPHY(4326) vissza a GeoJSON-ábrázolásból. |
| st_geogfromtext(wktExpr) |
GEOGRAPHY(4326) A WKT-ábrázolásból származó értéket ad vissza. |
| st_geogfromwkb(wktExpr) |
GEOGRAPHY(4326) A WKB-ábrázolásból származó értéket ad vissza. |
| st_geogfromwkt(wktExpr) |
GEOGRAPHY(4326) A WKT-ábrázolásból származó értéket ad vissza. |
| st_geomfromewkb(wktExpr) | Egy GEOMETRY(ANY) értéket ad vissza az EWKB-ábrázolásból. |
| st_geomfromgeohash(geohashExpr) | A bemeneti geohash értéknek megfelelő geohash rácsmezőt adja vissza 2D sokszögértékként GEOMETRY . |
| st_geomfromgeojson(geojsonExpr) | Egy értéket ad GEOMETRY(4326) vissza a GeoJSON-ábrázolásból. |
| st_geomfromtext(wktExpr[, sridExpr]) |
GEOMETRY(srid) vagy GEOMETRY(ANY) értéket ad vissza a WKT-ábrázolásából, és az SRID értékét sridExpr-ra állítja, vagy 0-ra, ha sridExpr elmarad. |
| st_geomfromwkb(wkbExpr[, sridExpr]) |
GEOMETRY(srid) vagy GEOMETRY(ANY) értéket ad vissza a WKB-reprezentációjából, és az SRID értékét sridExpr-re állítja, vagy 0-re, ha sridExpr nincs megadva. |
| st_geomfromwkt(wktExpr[, sridExpr]) |
GEOMETRY(srid) vagy GEOMETRY(ANY) értéket ad vissza a WKT-ábrázolásából, és az SRID értékét sridExpr-ra állítja, vagy 0-ra, ha sridExpr elmarad. |
| st_pointfromgeohash(geohash) | A geohash rácsmező középpontját adja vissza, amely a bemeneti geohash értéknek felel meg 2D pontgeometriaként. |
| to_geography(georepExpr) | Visszaad egy GEOGRAPHY(ANY) értéket annak GeoJSON, WKB vagy WKT ábrázolásából. |
| to_geometry(georepExpr) | Egy értéket ad GEOMETRY(ANY) vissza az EWKB, a GeoJSON, a WKB vagy a WKT ábrázolásából. |
| try_to_geography(georepExpr) | Egy értéket ad GEOGRAPHY(ANY) vissza a GeoJSON, WKB vagy WKT-ábrázolásából, vagy NULL ha a bemeneti ábrázolás érvénytelen. |
| try_to_geometry(georepExpr) | Értéket ad GEOMETRY(ANY) vissza az EWKB, GeoJSON, WKB vagy WKT ábrázolásából, vagy NULL ha a bemeneti ábrázolás érvénytelen. |
Export
| Function | Description |
|---|---|
| st_asbinary(geoExpr) | A bemenet GEOGRAPHY vagy GEOMETRY érték WKB-ábrázolását adja vissza értékként BINARY . |
| st_asewkb(geoExpr) | A bemeneti GEOMETRY érték EWKB-ábrázolását adja vissza értékként BINARY . |
| st_asgeojson(geoExpr) | A bemenet GEOGRAPHY vagy GEOMETRY érték GeoJSON-ábrázolását adja vissza értékként STRING . |
| st_asewkt(geoExpr) | A bemenet GEOGRAPHY vagy GEOMETRY érték EWKT-ábrázolását adja vissza értékként STRING . |
| st_astext(geoExpr) | A bemenet GEOGRAPHY vagy GEOMETRY érték WKT-ábrázolását adja vissza értékként STRING . |
| st_aswkb(geoExpr) | A bemenet GEOGRAPHY vagy GEOMETRY érték WKB-ábrázolását adja vissza értékként BINARY . |
| st_aswkt(geoExpr) | A bemenet GEOGRAPHY vagy GEOMETRY érték WKT-ábrázolását adja vissza értékként STRING . |
| st_geohash(geoExpr [, precisionExpr]) | A bemeneti geometria geohash-értékét adja vissza a megadott pontossággal. |
Measurements
| Function | Description |
|---|---|
| st_area(geoExpr) | A bemenet GEOGRAPHY vagy GEOMETRY érték területét adja vissza. |
| st_distance(geoExpr1, geoExpr2) | A két bemeneti GEOMETRY érték közötti 2D cartesian távolságot adja vissza. |
| st_distancesphere(geoExpr1, geoExpr2) | A két pont-érték GEOMETRY közötti gömbtávolságot adja vissza (méterben), egy olyan gömbön mérve, amelynek sugara a WGS84 ellipszoid közepes sugara. |
| st_distancespheroid(geoExpr1, geoExpr2) | A WGS84 ellipszoidon visszaadja a két pont c0 közötti geodéziai távolságot (méterben). |
| st_length(geoExpr) | A bemenet GEOGRAPHY vagy GEOMETRY értékének hosszát adja vissza. |
| st_perimeter(geoExpr) | A bemenet GEOGRAPHY vagy GEOMETRY érték szegélyét adja vissza. |
Constructors
| Function | Description |
|---|---|
| st_makeline(geoArray) | Olyan vonalzóértéket GEOMETRY ad vissza, amelynek pontjai a geometriák bemeneti tömbjének nem üres pontjai, amelyek várhatóan pontok, vonalzók vagy többpontok lesznek. |
| st_makepolygon(külső[, innerArray]) | A bemeneti külső határ és a belső határok választható tömbjének sokszögértéket GEOMETRY hoz létre, zárt vonalláncként ábrázolva. |
| st_point(x, y [, srid]) | Egy pontértéket GEOMETRY ad vissza a megadott X és Y koordinátákkal és SRID értékkel (ha van ilyen). |
Accessors
| Function | Description |
|---|---|
| st_dimension(geoExpr) | Adja vissza a GEOMETRY érték 2D vetületének topológiai dimenzióját. |
| st_dump(geoExpr) | A bemeneti geometria egyetlen geometriáit tartalmazó tömböt ad vissza. |
| st_endpoint(geoExpr) | A bemenet GEOGRAPHY vagy GEOMETRY érték utolsó pontját adja vissza, ha a bemeneti térinformatikai érték nem üres vonalvezetés. |
| st_envelope(geoExpr) | Egy 2D cartesian GEOMETRY értéket ad vissza, amely a bemeneti GEOMETRY érték 2D tengelyhez igazított minimális határolókeretét (borítékát) jelöli. |
| st_envelope_agg(geoCol) | Az oszlop összes geometriája borítékját adja vissza, vagy NULL ha az oszlop nulla sorból áll, vagy csak NULL értékeket tartalmaz. |
| st_exteriorring(geoExpr) | A bemeneti sokszög GEOGRAPHY külső gyűrűjét adja vissza, vagy GEOMETRY vonalzóként. |
| st_geometryn(geoExpr, nExpr) | A bemeneti GEOMETRY érték 1-alapú n-edik elemét adja vissza értékként GEOMETRY . |
| st_geometrytype(geoExpr) | A bemenet GEOGRAPHY vagy GEOMETRY érték típusát adja vissza sztringként. |
| st_interiorringn(geoExpr, indexExpr) | A bemeneti sokszög GEOGRAPHY n-edik belső gyűrűjét adja vissza, vagy GEOMETRY vonalzóként. |
| st_isempty(geoExpr) | Igaz értéket ad vissza, ha a bemenet GEOGRAPHY vagy GEOMETRY érték nem tartalmaz nem üres pontokat. |
| st_m(geoExpr) | A bemeneti pont GEOMETRY értékének M koordinátáját adja vissza, vagy NULL értéket, ha a pont üres, vagy nincs M koordinátája. |
| st_ndims(geoExpr) | A bemenet GEOGRAPHY vagy GEOMETRY érték koordináta-dimenzióját adja vissza. |
| st_npoints(geoExpr) | A bemeneti GEOGRAPHY vagy GEOMETRY érték nem üres pontjainak számát adja vissza. |
| st_numgeometries(geoExpr) | A bemeneti GEOMETRY érték geometriáinak számát adja vissza. |
| st_numinteriorrings(geoExpr) | A bemeneti sokszög GEOGRAPHY vagy GEOMETRY érték belső gyűrűinek számát adja vissza. |
| st_pointn(geoExpr, indexExpr) | Az n-edik pontot adja vissza a bemeneti vonal GEOGRAPHY vagy GEOMETRY értékéből. |
| st_startpoint(geoExpr) | A bemenet GEOGRAPHY vagy GEOMETRY érték első pontját adja vissza, ha a bemeneti térinformatikai érték nem üres vonalvezetés. |
| st_x(geoExpr) | A bemeneti pont GEOMETRY értékének X koordinátáját adja vissza, vagy NULL ha a pont üres. |
| st_xmax(geoExpr) | A bemeneti GEOMETRY érték maximális X koordinátáját adja vissza, vagy NULL ha a geometria üres. |
| st_xmin(geoExpr) | A bemeneti GEOMETRY érték minimális X koordinátáját adja vissza, vagy NULL ha a geometria üres. |
| st_y(geoExpr) | A bemeneti pont GEOMETRY értékének Y koordinátáját adja vissza, vagy NULL ha a pont üres. |
| st_ymax(geoExpr) | A bemeneti GEOMETRY érték maximális Y koordinátáját adja vissza, vagy NULL ha a geometria üres. |
| st_ymin(geoExpr) | A bemeneti GEOMETRY érték minimális Y koordinátáját adja vissza, vagy NULL ha a geometria üres. |
| st_z(geoExpr) | A bemeneti pont GEOMETRY értékének Z koordinátáját adja vissza, vagy NULL ha a pont üres, vagy nincs Z koordinátája. |
| st_zmax(geoExpr) | A bemeneti GEOMETRY érték maximális Z koordinátáját adja vissza, vagy NULL ha a geometria üres, vagy nincs Z koordinátája. |
| st_zmin(geoExpr) | A bemeneti GEOMETRY érték minimális Z koordinátáját adja vissza, vagy NULL ha a geometria üres, vagy nincs Z koordinátája. |
Editors
| Function | Description |
|---|---|
| st_addpoint(geo1Expr, geo2Expr[, indexExpr]) | Új pontot ad hozzá az n-edik pozícióhoz a bemeneti vonalvezetésben GEOGRAPHY vagy GEOMETRY -értékben. |
| st_flipcoordinates(geoExpr) | A bemeneti GEOMETRY érték X és Y koordinátáinak felcserélése. |
| st_multi(geoExpr) | Visszaadja a GEOGRAPHY vagy GEOMETRY bemenetet egyenértékű több helyhez kötött értékként. |
| st_removepoint(geoExpr, indexExpr) | Eltávolítja az n-edik pontot a bemeneti sorból GEOGRAPHY vagy GEOMETRY értékből. |
| st_reverse(geoExpr) | Megfordítja a bemeneti GEOGRAPHY vagy GEOMETRY értéket. |
| st_setpoint(geo1Expr, indexExpr, geo2Expr) | Az n-edik pontot állítja be a bemeneti vonalláncon az GEOGRAPHY vagy GEOMETRY értéknél. |
Geometria ellenőrzése
| Function | Description |
|---|---|
| st_isvalid(geoExpr) | Igaz értéket ad vissza, ha a bemeneti GEOMETRY érték OGC-értelemben érvényes geometria. |
Térbeli referenciarendszerfüggvények
| Function | Description |
|---|---|
| st_setsrid(geo, srid) | Egy új GEOMETRY értéket ad vissza, amelynek SRID értéke a megadott SRID érték. |
| st_srid(geoExpr) | A bemenet GEOGRAPHY vagy GEOMETRY érték SRID értékét adja vissza. |
| st_transform(geo, srid) | Átalakítja az aktuális koordináta-referenciarendszer bemenetének GEOMETRY X és Y koordinátáit a megadott SRID-érték által leírt koordináta-referenciarendszerre. |
Távolsági kapcsolatok
| Function | Description |
|---|---|
| st_dwithin(geoExpr1, geoExpr2, distanceExpr) | Igaz értéket ad vissza, ha a két bemeneti GEOMETRY érték közötti 2D cartesian távolság kisebb vagy egyenlő a bemeneti távolság értékével. |
Topológiai kapcsolatok
| Function | Description |
|---|---|
| st_contains(geo1, geo2) | Igaz értéket ad vissza, ha az első GEOMETRY érték a második GEOMETRY értéket tartalmazza. |
| st_covers(geoExpr1, geoExpr2) | Igaz értéket ad vissza, ha az első GEOMETRY érték a második GEOMETRY értéket fedi le. |
| st_disjoint(geoExpr1, geoExpr2) | Akkor adja true vissza, ha a két bemeneti GEOMETRY érték nem egybeesik. |
| st_equals(geoExpr1, geoExpr2) | Igaz értéket ad vissza, ha a két bemeneti GEOMETRY érték geometriailag egyenlő, ami azt jelenti, hogy azonos pontkészletnek felelnek meg. |
| st_intersects(geoExpr1, geoExpr2) | Igaz értéket ad vissza, ha a két bemeneti GEOMETRY érték metszi egymást. |
| st_touches(geo1, geo2) | Igaz értéket ad vissza, ha a két bemeneti GEOMETRY érték megérinti egymást. |
| st_within(geo1, geo2) | Igaz értéket ad vissza, ha az első GEOMETRY érték a második GEOMETRY értéken belül van. |
Átfedési függvények
| Function | Description |
|---|---|
| st_difference(geoExpr1, geoExpr2) | A két bemeneti GEOMETRY érték pontkészlet-különbségét adja vissza 2D GEOMETRY értékként. |
| st_intersection(geoExpr1, geoExpr2) | A két bemeneti GEOMETRY érték pontkészletes metszetét adja vissza 2D GEOMETRY értékként. |
| st_union(geo1, geo2) | A két bemeneti GEOMETRY érték ponthalmaz-egyesítését adja vissza 2D geometriaként. |
| st_union_agg(geoCol) | Az oszlop összes geometriája pontalapú egyesítését adja vissza, vagy NULL ha az oszlop nulla sorból áll, vagy csak NULL értékeket tartalmaz. |
Affine-átalakítások
| Function | Description |
|---|---|
| st_rotate(geoExpr, rotationAngle) | Elforgatja a bemeneti GEOMETRY értéket a Z tengely körül a megadott forgatási szög alapján (radiánban). |
| st_scale(geoExpr, xfactor, yfactor[, zfactor]) | A megadott skálázási tényezők használatával skálázza a bemeneti GEOMETRY értéket az X, az Y és a Z irányban. |
| st_translate(geoExpr, xoffset, yoffset[, zoffset]) | A megadott eltolásokkal lefordítja az X, az Y és a Z irányok bemeneti GEOMETRY értékét. |
Geometriafeldolgozás
| Function | Description |
|---|---|
| st_buffer(geoExpr, radiusExpr) | A bemeneti GEOMETRY érték pufferét adja vissza a megadott sugár használatával. |
| st_centroid(geoExpr) | A bemeneti GEOMETRY érték centroidját adja vissza 2D pontértékként GEOMETRY . |
| st_concavehull(geoExpr, lengthRatioExpr[, allowHolesExpr]) | A megadott hosszarány használatával visszaadja a bemeneti GEOMETRY érték konkáv burkát GEOMETRY értékként. |
| st_convexhull(geoExpr) | A bemeneti GEOMETRY érték konvex burkolatát adja vissza GEOMETRY értékként. |
| st_simplify(geo, tolerancia) | Leegyszerűsíti a bemeneti GEOMETRY értéket a Douglas-Peucker algoritmus használatával. |