次の方法で共有


h3_try_validate 関数

適用対象: check marked yes Databricks SQL Databricks Runtime 11.3 LTS 以降

有効な H3 セルに対応する場合は BIGINT 型または STRING 型の入力値を返し、それ以外の場合は NULL を返します。 STRING 型の入力値の場合、先頭のゼロはすべてトリミングされます。

構文

h3_try_validate ( h3CellIdExpr )

引数

  • h3CellIdExpr: 有効な H3 セル ID を表すことが想定される BIGINT 式または STRING 式。

戻り値

h3CellIdExpr 式の型と同じ型で、入力 h3CellIdExpr 式の値と等しい値、または NULL。 STRING 入力の場合、先頭のゼロはすべてトリミングされます。

入力が NULL の場合、この関数は NULL を返します。 この関数は、NULL 以外の入力に対して NULL を返すことがあります。

-- 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