Share via


h3_h3tostring 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

Giriş H3 hücre kimliğini eşdeğer onaltılık dize gösterimine dönüştürür.

Söz dizimi

h3_h3tostring ( h3CellIdExpr )

Bağımsız değişkenler

  • h3CellIdExpr: H3 hücre kimliğini temsil eden BIGINT ifadesi.

Döndürülenler

STRING türünde bir değer. Döndürülen sonuç, girişin big-endian onaltılık gösterimidir ve önünde sıfırlar çıkarılır.

Giriş NULL ise işlev NULL döndürür. işlevi BIGINT'i karşılık gelen onaltılık dizeye dönüştü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.

Hata koşulları

  • değerinin değeri değerinden h3CellIdExpr küçükse 0x08001fffffffffff veya değerinden 0x08ff3b6db6db6db6büyükse işlevi H3_INVALID_CELL_ID döndürür.

Örnekler

-- Simple example
> SELECT h3_h3tostring(599686042433355775)
  85283473fffffff

-- Input is an invalid H3 cell ID.
> SELECT h3_h3tostring(0)
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID