次の方法で共有

h3_stringtoh3 関数

  • [アーティクル]

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

入力文字列 (H3 セルを表す 16 進数の文字列であると予想される) を、対応する H3 セルの BIGINT 表現に変換します。

構文

h3_stringtoh3 ( h3CellIdExpr )

引数

  • h3CellIdStringExpr: 有効な H3 セル ID を表す整形式の 16 進数の STRING 式。

戻り値

BIGINT 型の値。 戻り値は、入力 16 進数の文字列の BIGINT 表現です。

入力が NULL の場合、この関数は NULL を返します。 この関数は、16 進数の文字列を対応する BIGINT 番号に変換します。 この関数は、入力引数が有効な H3 セル ID であるかどうかに関する部分的な検証を行います。 有効な H3 ID の必要条件 (ただし、十分条件ではない) は、その値が 0x08001fffffffffff と 0x08ff3b6db6db6db6 の間にあることです。 入力セル ID が有効なセル ID でない場合、関数の動作は未定義です。

エラー条件

  • h3CellIdStringExpr の値が BIGINT に変換できないか、この値が 0x08001fffffffffff より小さいか 0x08ff3b6db6db6db6 より大きい BIGINT 値に対応する場合、関数は H3_INVALID_CELL_ID を返します。

例

-- Simple example
> SELECT h3_stringtoh3('85283473fffffff')
  599686042433355775

-- Input is an invalid H3 cell ID.
> SELECT h3_stringtoh3('0')
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID