h3_validate
işlevi
Şunlar için geçerlidir: Databricks SQL Databricks Runtime 11.3 LTS ve üzeri
Geçerli bir H3 hücre kimliğine karşılık geliyorsa, BIGINT veya STRING türünde bir giriş değeri döndürür veya aksi takdirde bir hata yayar. STRING girişi söz konusu olduğunda, baştaki sıfırlar kırpılır.
Söz dizimi
h3_validate ( h3CellIdExpr )
Bağımsız değişkenler
h3CellIdExpr
: BigINT ifadesi veya geçerli bir H3 hücre kimliğini temsil eden bir STRING ifadesi.
Döndürülenler
İfadenin türüyle h3CellIdExpr
aynı türde ve giriş h3CellIdExpr
ifadesinin değerine eşit bir değer. STRING girişi söz konusu olduğunda, baştaki sıfırlar kırpılır.
Giriş NULL ise işlev NULL döndürür.
Hata koşulları
- Geçerli bir H3 hücre kimliği değilse
h3CellIdExpr
, işlev H3_INVALID_CELL_ID döndürür.
Örnekler
-- Simple example taking a long as input.
> SELECT h3_validate(590112357393367039)
590112357393367039
-- Simple example taking a hexadecimal string as input.
> SELECT h3_validate('85283473fffffff')
85283473fffffff
-- Example taking a long as input that is not a valid H3 cell ID.
> SELECT h3_validate(599686042433355776)
[H3_INVALID_CELL_ID] 599686042433355776 is not a valid H3 cell ID
-- Example where the input is an invalid hexadecimal string.
> SELECT h3_validate('I am not an H3 cell id')
[H3_INVALID_CELL_ID] 'I am not an H3 cell id' is not a valid H3 cell ID