Aracılığıyla paylaş

h3_maxchild işlevi

  • Makale

Belirtilen çözünürlükte giriş H3 hücresinin en büyük değerinin alt öğesini döndürür.

Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL önizlemesi onay işareti evet olarak işaretlenmiş Databricks Runtime 11.3 LTS ve üzeri

Söz dizimi

h3_maxchild ( 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ında h3_resolution(h3CellIdExpr) ve 15 kapsayıcı olması beklenen, alt H3 hücre kimliğinin çözümlemesini belirten bir INT ifadesi.

Döndürülenler

Belirtilen çözünürlükte giriş H3 hücre kimliğinin en büyük değerinin alt öğesine 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 0x08ff3b6db6db6db6arası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ük 0x08ff3b6db6db6db6bir BIGINT değerine karşılık gelen bir STRING iseh3CellIdExpr, işlev H3_INVALID_CELL_ID döndürür.
  • değerinden küçük h3_resolution(h3CellIdExpr) veya daha 15büyükse resolutionExpr işlev H3_INVALID_RESOLUTION_VALUE döndürür.

Örnekler

-- Simple example taking a long as input.
> SELECT h3_maxchild(599686042433355775, 10)
  622204040416821247

-- Simple example taking a valid hexadecimal string as input.
> SELECT h3_maxchild('85283473fffffff', 10)
  8a2834736db7fff

-- First input is an invalid H3 cell ID.
> SELECT h3_maxchild(0, 15)
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID

-- Second input is an invalid resolution value.
> SELECT h3_maxchild('85283473fffffff', 4)
  [H3_INVALID_RESOLUTION_VALUE] H3 resolution 4 must be between 5 and 15, inclusive