h3_stringtoh3 işlevi

Şunlar için geçerlidir: Databricks SQL Databricks Runtime 11.3 LTS ve üzeri

Bir H3 hücresini temsil eden onaltılık bir dize olması beklenen giriş dizesini, H3 hücresinin karşılık gelen BIGINT gösterimine dönüştürür.

Söz dizimi

h3_stringtoh3 ( h3CellIdExpr )

Bağımsız değişkenler

• h3CellIdStringExpr: Geçerli bir H3 hücre kimliğini temsil eden iyi biçimlendirilmiş onaltılık STRING ifadesi.

Döndürülenler

BIGINT türünde bir değer. Döndürülen değer, giriş onaltılık dizesinin BIGINT gösterimidir.

Giriş NULL ise işlev NULL döndürür. işlevi onaltılık dizeyi ilgili BIGINT numarasına 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 0x08001fffffffffffarasında 0x08ff3b6db6db6db6 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ğeri h3CellIdStringExpr BIR BIGINT'e dönüştürülemiyorsa veya değeri değerinden küçük 0x08001fffffffffff veya daha 0x08ff3b6db6db6db6büyük bir BIGINT değerine karşılık geliyorsa, işlevi H3_INVALID_CELL_ID döndürür.

Örnekler

-- Simple example
> SELECT h3_stringtoh3('85283473fffffff');
  599686042433355775

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

İlgili işlevler

• h3_h3tostring işlev