h3_try_validate
関数
適用対象: 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