Aracılığıyla paylaş

h3_kring işlevi

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

Kaynak hücrenin (kılavuz) uzaklığındaki k H3 hücrelerini döndürür. Bu H3 hücrelerinin kümesi, kaynak hücrenin khalkası olarak adlandırılır.

Söz dizimi

h3_kring ( h3CellIdExpr, kExpr )

Tartışmalar

  • h3CellIdExpr: BIGINT ifadesi veya H3 hücre kimliğini temsil eden bir onaltılık STRING ifadesi.
  • kExpr: Kılavuz mesafesini temsil eden bir tam sayı ifadesi. kExpr negatif olmamalıdır.

İadeler

h3CellIdExpr ifadesinin türüyle aynı türde değerlerden oluşan bir DİZİ; bu dizinin değerleri, giriş H3 hücresine aynı çözünürlüğe sahip H3 hücre kimliklerine karşılık gelir ve giriş H3 hücresinin kılavuz mesafesi k dahilindedir; burada k, kExpr'ün değeridir.

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, değerinin 0x08001fffffffffff ile 0x08ff3b6db6db6db6 arasında olması gerekli, ancak yeterli olmayan bir koşuldur. Giriş hücresi kimliği geçerli bir hücre kimliği değilse işlevin davranışı tanımsız olur. Kılavuz uzaklığı değeri sıfırsa, döndürülen dizi giriş H3 hücre kimliğine eşit tek bir değer içerir.

Hata koşulları

  • Eğer h3CellIdExpr BIGINT'e dönüştürülemeyen bir STRING ise veya BIGINT değeri olarak 0x08001fffffffffff'den küçük veya 0x08ff3b6db6db6db6'den büyük bir değere karşılık geliyorsa, işlev H3_INVALID_CELL_ID döndürür.
  • Negatifse kExpr işlev H3_INVALID_GRID_DISTANCE_VALUE döndürür.

Örnekler

-- Simple example where the first argument is a BIGINT.
> SELECT h3_kring(599686042433355775, 1)
  [599686042433355775,599686030622195711,599686044580839423,599686038138388479,599686043507097599,599686015589810175,599686014516068351]

-- Simple example where the first argument is a STRING.
> SELECT h3_kring('85283473fffffff', 1)
  [85283473fffffff,85283447fffffff,8528347bfffffff,85283463fffffff,85283477fffffff,8528340ffffffff,8528340bfffffff]

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

-- Second input is an invalid grid distance value.
> SELECT h3_kring('85283473fffffff', -1)
  [H3_INVALID_GRID_DISTANCE_VALUE] H3 grid distance -1 must be non-negative