h3_stringtoh3
fungsi
Berlaku untuk: Databricks SQL Databricks Runtime 11.3 LTS ke atas
Mengonversi string input, yang diharapkan menjadi string heksadesimal yang mewakili sel H3, ke representasi BIGINT yang sesuai dari sel H3.
Sintaks
h3_stringtoh3 ( h3CellIdExpr )
Argumen
h3CellIdStringExpr
: Ekspresi STRING heksadesimal yang terbentuk dengan baik yang mewakili ID sel H3 yang valid.
Mengembalikan
Nilai jenis BIGINT. Nilai yang dikembalikan adalah representasi BIGINT dari string heksadesimal input.
Fungsi mengembalikan NULL jika input adalah NULL.
Fungsi ini mengonversi string heksadesimal ke angka BIGINT yang sesuai.
Fungsi melakukan validasi parsial mengenai apakah argumen input adalah ID sel H3 yang valid. Kondisi yang diperlukan, tetapi tidak memadai untuk ID H3 yang valid adalah bahwa nilainya antara 0x08001fffffffffff
dan 0x08ff3b6db6db6db6
.
Perilaku fungsi tidak ditentukan jika ID sel input bukan ID sel yang valid.
Kondisi kesalahan
- Jika nilai
h3CellIdStringExpr
tidak dapat dikonversi ke BIGINT atau jika nilai sesuai dengan nilai BIGINT yang lebih kecil dari0x08001fffffffffff
atau lebih besar dari0x08ff3b6db6db6db6
, fungsi mengembalikan H3_INVALID_CELL_ID.
Contoh
-- 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