Share via


h3_try_validate 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

Geçerli bir H3 hücresine karşılık geliyorsa BIGINT veya STRING türünde bir giriş değeri veya aksi takdirde NULL değerini döndürür. STRING girişi söz konusu olduğunda, baştaki sıfırlar kırpılır.

Söz dizimi

h3_try_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 aynı türde ve giriş h3CellIdExpr ifadesinin h3CellIdExpr değerine eşit bir değer veya NULL. 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. İşlev, NULL olmayan girişler için NULL döndürebilir.

Örnekler

-- Simple example taking a long as input.
> SELECT h3_try_validate(590112357393367039)
  590112357393367039

-- Simple example taking a hexadecimal string as input.
> SELECT h3_try_validate('85283473fffffff')
  85283473fffffff

-- Simple taking a long as input, that is not a valid H3 cell ID.
> SELECT h3_try_validate(599686042433355776)
  null