H3 jeo-uzamsal işlevleri

Şunlar için geçerlidir: Databricks SQL Databricks Runtime

H3, genel bir kılavuz dizinleme sistemidir. Izgara sistemleri, bir yüzeyi kaplamak için dikdörtgenler veya üçgenler gibi bir şekil kullanır ve bu durumda Dünya'nın yüzeyidir. H3 sistemi altıgenleri (ve birkaç beşgeni) kullanacak şekilde tasarlanmıştır ve hiyerarşisinde 16 düzey çözünürlük sunar. Daha yüksek çözünürlüklerde, mozaik şekiller daha küçüktür.

Databricks Runtime 17.0 veya üzerinde, H3 ifadeleri Foton olmayan kümeler de dahil olmak üzere klasik Databricks SQL ambarları dışındaki tüm işlem türlerinde desteklenir.

H3 çözünürlükleri ve H3'ün çıkış noktaları hakkında daha fazla bilgi edinin.

Ayrıca bkz:

• H3 hızlı başlangıcı (Databricks SQL)
• H3 jeo-uzamsal işlevler örneği
• H3 jeo-uzamsal işlevlerin alfabetik listesi

Jeo-Uzamsal Analiz için H3

H3, uzamsal verileri işlemek ve analiz etmek için ortak bir deseni destekler. İlk olarak standart biçimlerden (enlem ve boylam, İyi bilinen metin (WKT), İyi bilinen ikili (WKB) veya GeoJSON'dan H3 hücre kimliklerine jeo-uzamsal verilerin dizinini oluşturun. Tek bir veri kümesiyle, konum temelli soruları yanıtlamak için hücre kimliğine göre toplama yapabilirsiniz. Birden çok dizine alınmış veri kümesiyle, hücre kimliklerini kullanarak bunları birleştirerek birbirinden farklı veri kümelerinin birbirleriyle ilişkisini ortaya çıkarabilirsiniz. Veri kümelerinin bu birleşimi, uzamsal bir koşula gerek kalmadan bir uzamsal birleşimdir.

Databricks içinde H3 kullanmanın avantajları nelerdir?

H3 dizinli verilerinizin verimli bir şekilde depolanması ve düzeni için Delta Lake özelliklerinden yararlanın. H3 hücre kimliklerinde sıvı kümeleme, verileri uzamsal olarak birlikte bulmanıza olanak tanır. Ayrıca Delta Lake'in veri atlama algoritmaları, okunması gereken veri hacmini akıllı bir şekilde azaltmak için ortak yerellik kullanır.

Verilerle çalışma konusunda esnekliğiniz vardır. Büyük tamsayılar veya dizeler olarak depolanan H3 hücre kimlikleriyle çalışmayı seçebilirsiniz. H3 hücre kimliklerini kullanarak en iyi performans için büyük tamsayı gösterimini kullanın. H3 ifadelerinin ayrıntılı kullanımı için SQL başvuru kılavuzuna bakın.

Uyarı

H3 kitaplığını yüklemeniz gerekmez. H3 Java kitaplığının 3.7.0 sürümü kullanılarak Databricks Runtime 11.2 ile başlayarak Databricks Runtime'a görünür bir bağımlılık olarak eklenir.

H3 elde etmek 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 için H3 işlevlerini içeri aktarmak için aşağıdaki komutları kullanın:

Python

from pyspark.databricks.sql import functions as dbf

Scala programlama dili

import com.databricks.sql.functions._

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

İthalat

İşlev	Açıklama
h3_coverash3(geographyExpr, resolutionExpr)	Belirtilen çözünürlüğün asgari sayıda onaltılık veya beşgen kümesine karşılık gelen ve girilen doğrusal veya yüzeysel coğrafi alanı tamamen kapsayan H3 hücre kimliklerinden oluşan bir ARRAY (BIGINT olarak gösterilir) döndürür.
h3_coverash3string(geographyExpr, resolutionExpr)	Belirtilen çözünürlükte, doğrusal veya yüzeysel girdi coğrafyasını tamamen kaplayan ve en az altıgen veya beşgen kümesine karşılık gelen H3 hücre kimliklerini (STRING olarak temsil edilir) içeren bir DİZİ döndürür.
h3_longlatash3(longitudeExpr [boylam ifadesi], latitudeExpr [enlem ifadesi], resolutionExpr [çözünürlük ifadesi])	Belirtilen çözünürlükte sağlanan boylam ve enlem ile ilgili H3 hücre kimliğini (BIGINT olarak) döndürür.
h3_longlatash3string(longitudeExpr, latitudeExpr, resolutionExpr)	Belirtilen çözünürlükte sağlanan boylam ve enleme karşılık gelen H3 hücre kimliğini (onaltılık DIZE olarak) döndürür.
h3_pointash3(geographyExpr, resolutionExpr)	Belirtilen çözünürlükte sağlanan noktaya karşılık gelen H3 hücre kimliğini (BIGINT olarak) döndürür.
h3_pointash3string(geographyExpr, resolutionExpr)	Belirtilen çözünürlükteki noktaya karşılık gelen H3 hücre kimliğini (string olarak) döndürür.
h3_polyfillash3(geographyExpr, resolutionExpr)	Giriş areal coğrafyasında yer alan belirtilen çözünürlüğün altıgenlerine veya beşgenlerine karşılık gelen H3 hücre kimliklerinden oluşan bir DIZI (BIGINT olarak gösterilir) döndürür.
h3_polyfillash3string(geographyExpr, resolutionExpr)	Centroid'leri giriş areal coğrafyasında yer alan belirtilen çözünürlüğün altıgenlerine veya beşgenlerine karşılık gelen H3 hücre kimliklerinden oluşan bir DIZI (STRING olarak temsil edilir) döndürür.
h3_tessellateaswkb(geographyExpr, resolutionExpr)	Belirtilen çözünürlükte H3 hücreleri kullanarak giriş coğrafyasının bölünmesini döndürür.
h3_try_coverash3(geographyExpr, resolutionExpr)	Belirtilen çözünürlüğün en az altıgen veya beşgen kümesine karşılık gelen, giriş doğrusal veya yüzeysel coğrafyayı tamamen kapsayan H3 hücre kimliklerinden oluşan bir DİZİ (BIGINT olarak temsil edilir) döndürür veya ilk bağımsız değişken geçersizse NULL döner.
h3_try_coverash3string(geographyExpr, resolutionExpr)	Belirtilen çözünürlükteki en küçük altıgen veya beşgen kümesine karşılık gelen, giriş doğrusal veya alan coğrafyasını tamamen kapsayan H3 hücre kimliklerinden oluşan bir DİZİ (STRING olarak temsil edilir) döndürür veya ilk bağımsız değişken geçersizse NULL döndürür.
h3_try_polyfillash3(geographyExpr, resolutionExpr)	Giriş areal coğrafyasında yer alan belirtilen çözünürlüğün altıgenlerine veya beşgenlerine karşılık gelen H3 hücre kimliklerinden oluşan bir DIZI (BIGINT olarak gösterilir) döndürür.
h3_try_polyfillash3string(geographyExpr, resolutionExpr)	Centroid'leri giriş areal coğrafyasında yer alan belirtilen çözünürlüğün altıgenlerine veya beşgenlerine karşılık gelen H3 hücre kimliklerinden oluşan bir DIZI (STRING olarak temsil edilir) döndürür.
h3_try_tessellateaswkb(geographyExpr, resolutionExpr)	Belirtilen çözünürlükte H3 hücreleri kullanarak giriş coğrafyasının tessellasyonunu döndürür veya ilk bağımsız değişken geçersizse ya da işlev bir tessellasyonu hesaplayamadıysa NULL değerini döndürür.

İhracat

İşlev	Açıklama
h3_boundaryasgeojson(h3CellIdExpr)	GeoJSON biçimindeki giriş H3 hücresinin çokgen sınırını döndürür.
h3_boundaryaswkb(h3CellIdExpr)	WKB biçimindeki giriş H3 hücresinin çokgen sınırını döndürür.
h3_boundaryaswkt(h3CellIdExpr)	WKT biçimindeki giriş H3 hücresinin çokgen sınırını döndürür.
h3_centerasgeojson(h3CellIdExpr)	Giriş H3 hücresinin merkezini GeoJSON biçiminde bir nokta olarak döndürür.
h3_centeraswkb(h3CellIdExpr)	Giriş H3 hücresinin merkezini WKB biçiminde bir nokta olarak döndürür.
h3_centeraswkt(h3CellIdExpr)	Giriş H3 hücresinin merkezini WKT biçiminde bir nokta olarak döndürür.

Dönüşümler

İşlev	Açıklama
h3_h3tostring(h3CellIdExpr)	Giriş H3 hücre kimliğini eşdeğer onaltılık dize gösterimine dönüştürür.
h3_stringtoh3(h3CellIdStringExpr)	Bir H3 hücre kimliğini temsil eden onaltılık bir dize olması beklenen giriş dizesini H3 hücre kimliğinin ilgili BIGINT gösterimine dönüştürür.

Yüklemler

İşlev	Açıklama
h3_ischildof(h3CellId1Expr, h3CellId2Expr)	İlk H3 hücre kimliği ikinci H3 hücre kimliğine eşitse veya onun bir alt hücresiyse true döndürür.
h3_ispentagon(h3CellIdExpr)	BIGINT veya onaltılık STRING girişi bir beşgen H3 hücresine karşılık geliyorsa true döndürür, aksi takdirde false döndürür.

Geçerlilik

İşlev	Açıklama
h3_isvalid(expr)	BIGINT veya STRING girişi geçerli bir H3 hücre kimliğiyse true döndürür.
h3_try_validate(h3CellIdExpr)	Geçerli bir H3 hücre kimliğine karşılık geliyorsa BIGINT veya STRING türündeki giriş değerini veya aksi takdirde NULL değerini döndürür.
h3_validate(h3CellIdExpr)	Geçerli bir H3 hücre kimliğine karşılık geliyorsa, BIGINT veya STRING türünde bir giriş değeri döndürür veya aksi takdirde bir hata yayar.

Mesafeyle ilgili

İşlev	Açıklama
h3_distance(h3CellId1Expr, h3CellId2Expr)	İki giriş H3 hücre kimliğinin ızgara uzaklığını döndürür.
h3_hexring(h3CellIdExpr, kExpr)	Merkez H3 hücresinde ortalanmış ve kaynak H3 hücresinden kılavuz uzaklığında k olan boş bir altıgen halka oluşturan bir H3 hücre kimlikleri dizisi döndürür.
h3_kring(h3CellIdExpr, kExpr)	Kaynak hücre kimliğinin (kılavuz) uzaklığındaki k H3 hücre kimliklerini döndürür.
h3_kringdistances(h3CellIdExpr, kExpr)	Kaynak H3 hücre kimliğinden belirli bir k kılavuz uzaklığındaki tüm H3 hücre kimliklerini (uzun tamsayılar veya dizeler olarak gösterilir) ve bu hücrelerin kaynak H3 hücre kimliğinden olan uzaklıklarını döndürür.
h3_try_distance(h3CellId1Expr, h3CellId2Expr)	Aynı çözünürlükteki iki giriş H3 hücre kimliğinin ızgara mesafesini döndürür; eğer mesafe tanımlanmamışsa, NULL değerini verir.

Geçişi

İşlev	Açıklama
h3_maxchild(h3CellIdExpr, resolutionExpr)	Belirtilen çözünürlükte giriş H3 hücresinin en büyük değerli çocuğunu döndürür.
h3_minchild(h3CellIdExpr, resolutionExpr)	Belirtilen çözünürlük düzeyinde, giriş H3 hücresinin en düşük değerli alt öğesini döndürür.
h3_resolution(h3CellIdExpr)	Giriş H3 hücre kimliğinin çözünürlüğünü döndürür.
h3_tochildren(h3CellIdExpr, resolutionExpr)	Belirtilen çözünürlükte giriş H3 hücre kimliğinin alt H3 hücre kimliklerinden oluşan bir dizi döndürür.
h3_toparent(h3CellIdExpr, resolutionExpr)	Belirtilen çözünürlükte giriş H3 hücre kimliğinin ebeveyn H3 hücre kimliğini geri döndürür.

Sıkıştırma

İşlev	Açıklama
h3_compact(h3CellIdsExpr)	H3 hücre kimliklerinin giriş kümesini mümkün olan en iyi şekilde sıkıştırıyor.
h3_uncompact(h3CellIdsExpr, resolutionExpr)	H3 hücre kimliklerinin giriş kümesini belirtilen çözünürlüğe genişletir.