Aracılığıyla paylaş


ST uzamsal işlevler

Şunun için geçerlidir:evet olarak işaretlendi Databricks SQL denetimi evet olarak işaretlendi Databricks Runtime 17.1 ve üzeri

Important

Bu özellik Genel Önizleme aşamasındadır.

ST jeo-uzamsal işlevleri, GEOGRAPHY ve/veya GEOMETRY türündeki nesneler üzerinde çalışır veya standart ya da popüler jeo-uzamsal biçimlerden GEOGRAPHY ve GEOMETRY değerleri oluşturulmasına olanak tanır veya GEOGRAPHY ve GEOMETRY değerlerini standart veya popüler jeo-uzamsal biçimlere dışa aktarır.

Ayrıca bkz:

ST işlevlerini almak için Databricks işlevlerini içeri aktarma (Databricks Runtime)

Databricks SQL ve Spark SQL için içeri aktarma gerekmez.

Not defterlerinde Python veya Scala'nın ST işlevlerini içeri aktarmak için aşağıdaki komutları kullanın:

Python

from pyspark.databricks.sql import functions as dbf

Scala

import com.databricks.sql.functions._

ST jeo-uzamsal işlevlerinin listesi (Databricks SQL)

Import

Function Description
st_geogfromewkt(ewktExpr) EWKT gösteriminden bir GEOGRAPHY(ANY) değer döndürür.
st_geogfromgeojson(geojsonExpr) GeoJSON gösteriminden bir GEOGRAPHY(4326) değer döndürür.
st_geogfromtext(wktExpr) WKT gösteriminden bir GEOGRAPHY(4326) değer döndürür.
st_geogfromwkb(wktExpr) WKB gösteriminden bir GEOGRAPHY(4326) değer döndürür.
st_geogfromwkt(wktExpr) WKT gösteriminden bir GEOGRAPHY(4326) değer döndürür.
st_geomfromewkb(wktExpr) EWKB gösteriminden bir GEOMETRY(ANY) değer döndürür.
st_geomfromewkt(ewktExpr) EWKT gösteriminden bir GEOMETRY(ANY) değer döndürür.
st_geomfromgeohash(geohashExpr) Giriş geohash değerine karşılık gelen geohash kılavuz kutusunu 2B çokgen GEOMETRY değer olarak döndürür.
st_geomfromgeojson(geojsonExpr) GeoJSON gösteriminden bir GEOMETRY(4326) değer döndürür.
st_geomfromtext(wktExpr[, sridExpr]) WKT gösteriminden bir GEOMETRY(srid) veya GEOMETRY(ANY) değeri döndürür ve SRID değerini sridExpr değerine veya 0 atlandığında sridExpr değerine ayarlar.
st_geomfromwkb(wkbExpr[, sridExpr]) WKB gösteriminden bir GEOMETRY(srid) veya GEOMETRY(ANY) değeri döndürür ve SRID değerini sridExpr değerine veya 0 atlanırsa sridExpr olarak ayarlar.
st_geomfromwkt(wktExpr[, sridExpr]) WKT gösteriminden bir GEOMETRY(srid) veya GEOMETRY(ANY) değeri döndürür ve SRID değerini sridExpr değerine veya 0 atlandığında sridExpr değerine ayarlar.
st_pointfromgeohash(geohash) Giriş geohash değerine karşılık gelen geohash kılavuz kutusunun merkezini 2B nokta geometrisi olarak döndürür.
to_geography(georepExpr) GeoJSON, WKB veya WKT gösteriminden bir GEOGRAPHY(ANY) değer döndürür.
to_geometry(georepExpr) EWKB, GeoJSON, WKB veya WKT gösteriminden bir GEOMETRY(ANY) değer döndürür.
try_to_geography(georepExpr) GeoJSON, WKB veya WKT gösteriminden bir GEOGRAPHY(ANY) değeri döndürür, giriş gösterimi geçersizse NULL döndürür.
try_to_geometry(georepExpr) Bir GEOMETRY(ANY) değeri döndürür, EWKB, GeoJSON, WKB veya WKT gösteriminden; veya giriş gösterimi geçersizse NULL döndürür.

Export

Function Description
st_asbinary(geoExpr) Girdi GEOGRAPHY veya GEOMETRY değerinin WKB gösterimini BINARY formatı olarak döndürür.
st_asewkb(geoExpr) Giriş GEOMETRY değerinin EWKB gösterimini değer BINARY olarak döndürür.
st_asgeojson(geoExpr) Girişin GEOGRAPHY veya GEOMETRY değerin GeoJSON gösterimini değer STRING olarak döndürür.
st_asewkt(geoExpr) Girişin GEOGRAPHY veya GEOMETRY değerin EWKT gösterimini değer STRING olarak döndürür.
st_astext(geoExpr) GEOGRAPHY veya GEOMETRY değerinin WKT gösterimini STRING değeri olarak döndürür.
st_aswkb(geoExpr) Girdi GEOGRAPHY veya GEOMETRY değerinin WKB gösterimini BINARY formatı olarak döndürür.
st_aswkt(geoExpr) GEOGRAPHY veya GEOMETRY değerinin WKT gösterimini STRING değeri olarak döndürür.
st_geohash(geoExpr [, precisionExpr]) Verilen hassasiyette giriş geometrisinin geohash değerini geri döndürür.

Measurements

Function Description
st_area(geoExpr) Girişin GEOGRAPHY veya GEOMETRY değerin alanını döndürür.
st_azimuth(geoExpr1, geoExpr2) [0, 2π)de radyan cinsinden ilk noktadan ikinciye kuzey tabanlı azimutu döndürür.
st_closestpoint(geoExpr1, geoExpr2) Öklid uzaklığı açısından ikinci GEOMETRY değere en yakın olan ilk GEOMETRY değerdeki bir noktanın 2B projeksiyonunu döndürür.
st_distance(geoExpr1, geoExpr2) İki giriş GEOMETRY değeri arasındaki 2B Kartezyen mesafeyi döndürür.
st_distancesphere(geoExpr1, geoExpr2) yarıçapı WGS84 elipsoidinin ortalama yarıçapı olan bir küre üzerinde ölçülen iki nokta GEOMETRY değeri arasındaki küresel uzaklığı (metre cinsinden) verir.
st_distancespheroid(geoExpr1, geoExpr2) WGS84 elipsoidindeki iki nokta GEOMETRY değeri arasındaki jeodezik uzaklığı (metre cinsinden) verir.
st_length(geoExpr) Girişin GEOGRAPHY veya GEOMETRY değerin uzunluğunu döndürür.
st_perimeter(geoExpr) Girişin GEOGRAPHY veya GEOMETRY değerin çevresini döndürür.

Constructors

Function Description
st_makeline(geoArray) Geometri giriş dizisindeki geometrilerin boş olmayan noktalarını içeren ve bu geometrilerin noktalar, çizgi dizileri veya çok noktalı olması beklenen bir çizgi dizisi GEOMETRY değeri döndürür.
st_makepolygon(outer[, innerArray]) Giriş dış sınırından ve kapalı çizgi dizeleri olarak temsil edilen isteğe bağlı iç sınır dizisinden çokgen GEOMETRY bir değer oluşturur.
st_point(x, y [, srid]) Verilen X ve Y koordinatları ve SRID değeri (sağlanmışsa) ile bir nokta GEOMETRY değeri döndürür.

Accessors

Function Description
st_dimension(geoExpr) 2B projeksiyonunun GEOMETRY değerinin topolojik boyutunu verir.
st_dump(geoExpr) Giriş geometrisindeki tek geometrileri içeren bir dizi döndürür.
st_endpoint(geoExpr) Girdi jeo-uzamsal değeri boş olmayan bir çizgi dizisi olduğunda, GEOGRAPHY veya GEOMETRY değerinin son noktasını döndürür.
st_envelope(geoExpr) Giriş GEOMETRY değerinin 2B eksene dik şekilde hizalanmış minimum sınırlayıcı kutusunu (zarf) temsil eden 2B Kartezyen GEOMETRY değerini döndürür.
st_envelope_agg(geoCol) Sütundaki tüm geometrilerin zarfını veya NULL sütunda sıfır satır varsa veya yalnızca NULL değerleri içeriyorsa, zarfı döndürür.
st_exteriorring(geoExpr) Giriş çokgeninin GEOGRAPHY dış halkasını veya GEOMETRY çizgi dizesi olarak döndürür.
st_geometryn(geoExpr, nExpr) Giriş GEOMETRY değerinin 1 tabanlı n. öğesini değer GEOMETRY olarak döndürür.
st_geometrytype(geoExpr) Girişin GEOGRAPHY veya GEOMETRY değerin türünü dize olarak döndürür.
st_interiorringn(geoExpr, indexExpr) Giriş çokgeninin GEOGRAPHY n. iç halkasını veya GEOMETRY bir çizgi dizesi olarak döndürür.
st_isempty(geoExpr) Giriş GEOGRAPHY veya GEOMETRY değer boş olmayan noktalar içermiyorsa true döndürür.
st_m(geoExpr) Giriş noktası GEOMETRY değerinin M koordinatını veya nokta boşsa veya M koordinatı yoksa NULL değerini döndürür.
st_ndims(geoExpr) Girişin GEOGRAPHY veya GEOMETRY değerin koordinat boyutunu döndürür.
st_npoints(geoExpr) Giriş GEOGRAPHY veya GEOMETRY değerdeki boş olmayan noktaların sayısını döndürür.
st_numgeometries(geoExpr) Giriş GEOMETRY değerindeki geometri sayısını döndürür.
st_numinteriorrings(geoExpr) Giriş çokgenindeki GEOGRAPHY veya GEOMETRY değerdeki iç halka sayısını döndürür.
st_pointn(geoExpr, indexExpr) Giriş satır GEOGRAPHY dizesinden veya GEOMETRY değerinden n. noktayı döndürür.
st_startpoint(geoExpr) Girişteki jeo-uzamsal değer boş olmayan bir linestring ise, GEOGRAPHY veya GEOMETRY değerinin ilk noktasını döndürür.
st_x(geoExpr) Giriş noktası GEOMETRY değerinin X koordinatını veya NULL nokta boşsa döndürür.
st_xmax(geoExpr) Giriş GEOMETRY değerinin maksimum X koordinatını veya NULL geometri boşsa verir.
st_xmin(geoExpr) Giriş GEOMETRY değerinin en düşük X koordinatını veya NULL geometri boşsa verir.
st_y(geoExpr) Giriş noktası GEOMETRY değerinin Y koordinatını veya NULL nokta boşsa döndürür.
st_ymax(geoExpr) Giriş GEOMETRY değerinin maksimum Y koordinatını veya NULL geometri boşsa verir.
st_ymin(geoExpr) Giriş GEOMETRY değerinin en düşük Y koordinatını veya NULL geometri boşsa verir.
st_z(geoExpr) Giriş noktası GEOMETRY değerinin Z koordinatını döndürür veya NULL nokta boşsa veya Z koordinatı yoksa.
st_zmax(geoExpr) Giriş GEOMETRY değerinin maksimum Z koordinatını döndürür veya NULL geometri boşsa veya Z koordinatı yoksa.
st_zmin(geoExpr) Giriş GEOMETRY değerinin en düşük Z koordinatını verir veya NULL geometri boşsa veya Z koordinatı yoksa.

Editors

Function Description
st_addpoint(geo1Expr, geo2Expr[, indexExpr]) Giriş satır dizesindeki GEOGRAPHY veya GEOMETRY değerdeki n. konuma yeni bir nokta ekler.
st_flipcoordinates(geoExpr) Giriş GEOMETRY değerinin X ve Y koordinatlarını değiştirir.
st_multi(geoExpr) Giriş GEOGRAPHY veya GEOMETRY değerini eşdeğer bir çoklu coğrafi-değer olarak döndürür.
st_removepoint(geoExpr, indexExpr) Giriş satır GEOGRAPHY dizesinden veya GEOMETRY değerinden n. noktayı kaldırır.
st_reverse(geoExpr) Girişin GEOGRAPHY veya GEOMETRY değerini ters çevirir.
st_setpoint(geo1Expr, indexExpr, geo2Expr) Giriş çizgi dizesinin GEOGRAPHY veya GEOMETRY değerin n. noktasını ayarlar.

Geometri Doğrulaması

Function Description
st_isvalid(geoExpr) Giriş GEOMETRY değeri OGC anlamda geçerli bir geometriyse true döndürür.

Uzamsal Başvuru Sistemi İşlevleri

Function Description
st_setsrid(coğrafi, srid) Belirtilen SRID değeri için yeni bir değeri döndürür.
st_srid(geoExpr) Girişin GEOGRAPHY veya GEOMETRY değerin SRID değerini döndürür.
st_transform(coğrafi, srid) Girişin X ve Y koordinatlarını GEOMETRY geçerli koordinat başvuru sisteminden sağlanan SRID değeri tarafından açıklanan koordinat başvuru sistemine dönüştürür.

Uzaklık İlişkileri

Function Description
st_dwithin(geoExpr1, geoExpr2, distanceExpr) İki giriş değeri arasındaki 2B Kartezyen uzaklık, giriş GEOMETRY uzaklığı değerinden küçük veya buna eşitse true döndürür.

Topolojik İlişkiler

Function Description
st_contains(coğrafi1, coğrafi2) İlk GEOMETRY değer ikinci GEOMETRY değeri içeriyorsa true döndürür.
st_covers(geoExpr1, geoExpr2) İlk GEOMETRY değer ikinci GEOMETRY değeri kapsıyorsa true döndürür.
st_disjoint(geoExpr1, geoExpr2) İki giriş true değeri ayrık olduğunda GEOMETRY döndürür.
st_equals(geoExpr1, geoExpr2) İki giriş GEOMETRY değeri geometrik olarak eşitse true döndürür, yani aynı nokta kümesine karşılık gelir.
st_intersects(geoExpr1, geoExpr2) İki giriş GEOMETRY değeri kesişirse true döndürür.
st_touches(coğrafi1, coğrafi2) İki giriş GEOMETRY değeri birbirine dokunursa true döndürür.
st_within(coğrafi1, coğrafi2) İlk GEOMETRY değer ikinci GEOMETRY değer içindeyse true döndürür.

Katman İşlevleri

Function Description
st_difference(geoExpr1, geoExpr2) İki GEOMETRY giriş değerinin nokta kümesi farkını 2D bir GEOMETRY değer olarak döndürür.
st_intersection(geoExpr1, geoExpr2) İki giriş GEOMETRY değerinin nokta kümesi kesişimini 2B GEOMETRY değeri olarak döndürür.
st_union(coğrafi1, coğrafi2) İki giriş GEOMETRY değerinin nokta kümesi birleşimini 2B geometri olarak döndürür.
st_union_agg(geoCol) Sütundaki tüm geometrilerin nokta açısından birleşimini veya NULL sütunda sıfır satır varsa veya yalnızca NULL değerleri içeriyorsa döndürür.

Affine Dönüşümleri

Function Description
st_rotate(geoExpr, rotationAngle) Giriş GEOMETRY değerini verilen döndürme açısına göre (radyan cinsinden) Z ekseni çevresinde döndürür.
st_scale(geoExpr, xfactor, yfactor[, zfactor]) Sağlanan ölçeklendirme faktörlerini kullanarak X, Y ve belirtilirse Z yönlerindeki giriş GEOMETRY değerini ölçeklendirir.
st_translate(geoExpr, xoffset, yoffset[, zoffset]) Sağlanan uzaklıkları kullanarak X, Y ve belirtildiyse Z yönlerindeki giriş GEOMETRY değerini çevirir.

Geometri İşleme

Function Description
st_boundary(geoExpr) Giriş GEOMETRY değerinin sınırını temsil eden bir GEOMETRY değer döndürür.
st_buffer(geoExpr, radiusExpr) Giriş GEOMETRY değerinin arabelleğini belirtilen yarıçap kullanılarak döndürür.
st_centroid(geoExpr) Giriş GEOMETRY değerinin centroid değerini 2B nokta GEOMETRY değeri olarak döndürür.
st_concavehull(geoExpr, lengthRatioExpr[, allowHolesExpr]) Belirtilen uzunluk oranını kullanarak giriş GEOMETRY değerinin konka gövdesini bir GEOMETRY değer olarak döndürür.
st_convexhull(geoExpr) Girdi GEOMETRY değerinin dışbükey kubbesini GEOMETRY değeri olarak döndürür.
st_simplify(coğrafi, tolerans) Douglas-Peucker algoritmasını kullanarak giriş GEOMETRY değerini basitleştirir.