`h3_validate` fungsi

Artikel
04/22/2024

Berlaku untuk: centang ditandai ya Databricks SQL Databricks Runtime 11.3 LTS ke atas

Mengembalikan nilai input, yaitu jenis BIGINT atau STRING, jika sesuai dengan ID sel H3 yang valid, atau mengeluarkan kesalahan sebaliknya. Dalam kasus input STRING, nol di depan dipangkas.

Sintaks

h3_validate ( h3CellIdExpr )

Argumen

h3CellIdExpr: Ekspresi BIGINT, atau ekspresi STRING yang diharapkan mewakili ID sel H3 yang valid.

Mengembalikan

Nilai dengan jenis yang sama dengan jenis h3CellIdExpr ekspresi, dan sama dengan nilai ekspresi input h3CellIdExpr . Dalam kasus input STRING, nol di depan dipangkas.

Fungsi mengembalikan NULL jika input adalah NULL.

Kondisi kesalahan

Jika h3CellIdExpr bukan ID sel H3 yang valid, fungsi mengembalikan H3_INVALID_CELL_ID.

Contoh

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

h3_validate fungsi