h3_toparent
işlevi
Şunlar için geçerlidir: Databricks SQL Databricks Runtime 11.3 LTS ve üzeri
Belirtilen çözünürlükte giriş H3 hücresinin üst H3 hücresini döndürür.
Söz dizimi
h3_toparent ( h3cellIdExpr, resolutionExpr )
Bağımsız değişkenler
h3CellIdExpr
: H3 hücre kimliğini temsil eden bir BIGINT ifadesi veya onaltılık STRING ifadesi.resolutionExpr
: Değerinin arasında0
veh3_resolution(h3CellIdExpr)
kapsayıcı olması beklenen, üst H3 hücre kimliğinin çözünürlüğünü belirten bir INT ifadesi.
Döndürülenler
Belirtilen çözünürlükte giriş H3 hücresinin üst H3 hücre kimliğine karşılık gelen, ifadenin türüyle aynı türde h3CellIdExpr
bir değer.
İki giriş ifadelerinden herhangi biri NULL ise işlev NULL döndürür.
İşlev, giriş bağımsız değişkeninin geçerli bir H3 hücre kimliği olup olmadığıyla ilgili kısmi doğrulama yapar. Geçerli bir H3 kimliği için gerekli ancak yeterli olmayan bir koşul, değerinin ile 0x08ff3b6db6db6db6
arasında 0x08001fffffffffff
olmasıdır.
Giriş hücresi kimliği geçerli bir hücre kimliği değilse işlevin davranışı tanımsız olur.
değerinin resolutionExpr
değeri giriş H3 hücre kimliğinin çözünürlüğüne eşitse, giriş H3 hücre kimliği döndürülür.
Hata koşulları
- BIR BIGINT'e dönüştürülemeyen veya değerinden küçük
0x08001fffffffffff
veya daha büyük0x08ff3b6db6db6db6
bir BIGINT değerine karşılık gelen bir STRING iseh3CellIdExpr
, işlev H3_INVALID_CELL_ID döndürür. - değerinden küçük
0
veya dahah3_resolution(h3CellIdExpr)
büyükseresolutionExpr
işlev H3_INVALID_RESOLUTION_VALUE döndürür.
Örnekler
-- Simple example taking a long as input.
> SELECT h3_toparent(599686042433355775, 0)
577199624117288959
-- Simple example taking a valid hexadecimal string as input.
> SELECT h3_toparent('85283473fffffff', 0)
8029fffffffffff
-- First input is an invalid H3 cell ID.
> SELECT h3_toparent(0, 0)
[H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID
-- Second input is an invalid resolution value.
> SELECT h3_toparent('85283473fffffff', -1)
[H3_INVALID_RESOLUTION_VALUE] H3 resolution -1 must be between 0 and 5, inclusive