Share via

h3_validate işlevi

  • Makale

Ş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ü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ğilseh3CellIdExpr, 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