h3_validate fungsi

Berlaku untuk: 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

Fungsi terkait

• h3_isvalid fungsi
• h3_try_validate fungsi