h3_ischildof
fungsi
Berlaku untuk: Databricks SQL Databricks Runtime 11.3 LTS ke atas
Mengembalikan true jika sel H3 pertama sama dengan atau anak dari sel H3 kedua.
Sintaks
h3_ischildof ( h3CellId1Expr, h3cellId2Expr )
Argumen
h3CellId1Expr
: Ekspresi BIGINT, atau ekspresi STRING heksadesimal yang mewakili ID sel H3.h3CellId2Expr
: Ekspresi BIGINT, atau ekspresi STRING heksadesimal yang mewakili ID sel H3.
Mengembalikan
Nilai jenis BOOLEAN yang menunjukkan apakah sel H3 pertama sama dengan atau anak dari sel H3 kedua.
Fungsi mengembalikan NULL jika salah satu input adalah NULL.
Fungsi melakukan validasi parsial mengenai apakah salah satu dari dua 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 terdefinisi jika salah satu dari dua ID sel input bukan ID sel yang valid.
Kondisi kesalahan
- Jika
h3CellId1Expr
atauh3CellId2Expr
adalah STRING yang tidak dapat dikonversi ke BIGINT atau sesuai dengan nilai BIGINT yang lebih kecil dari0x08001fffffffffff
atau lebih besar dari0x08ff3b6db6db6db6
, fungsi mengembalikan H3_INVALID_CELL_ID.
Contoh
-- Simple example taking two longs as input.
> SELECT h3_ischildof(608693241318998015, 599686042433355775)
true
-- Simple example taking two strings as input.
> SELECT h3_ischildof('88283471b9fffff', '85283473fffffff')
true
-- Simple example taking a long integer and a string as input.
> SELECT h3_ischildof(580260664489017343, '85283473fffffff')
false
-- First input is an invalid H3 cell ID.
> SELECT h3_ischildof(0, 599686042433355775)
[H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID
-- Second input is an invalid H3 cell ID.
> SELECT h3_ischildof(608693241318998015, 'xyz')
[H3_INVALID_CELL_ID] 'xyz' is not a valid H3 cell ID