次の方法で共有

h3_validate 関数

  • [アーティクル]

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

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

構文

h3_validate ( h3CellIdExpr )

引数

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

戻り値

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

入力が NULL の場合、この関数は NULL を返します。

エラー条件

  • h3CellIdExpr が有効な H3 セル ID でない場合、関数は H3_INVALID_CELL_ID を返します。

例

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