h3_minchild fungsi

Mengembalikan turunan dari nilai minimum sel H3 input pada resolusi yang ditentukan.

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

Sintaks

h3_minchild ( h3cellIdExpr, resolutionExpr )

Argumen

  • h3CellIdExpr: Ekspresi BIGINT, atau ekspresi STRING heksadesimal yang mewakili ID sel H3.
  • resolutionExpr : Ekspresi INT, yang nilainya diharapkan antara h3_resolution(h3CellIdExpr) dan 15 inklusif, menentukan resolusi ID sel H3 anak.

Mengembalikan

Nilai dengan jenis yang sama dengan jenis h3CellIdExpr ekspresi, yang sesuai dengan turunan nilai minimum ID sel H3 input pada resolusi yang ditentukan.

Fungsi mengembalikan NULL jika salah satu dari dua ekspresi input adalah NULL. 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. Jika nilai resolutionExpr sama dengan resolusi ID sel H3 input, ID sel H3 input dikembalikan.

Kondisi kesalahan

  • Jika h3CellIdExpr adalah STRING yang tidak dapat dikonversi ke BIGINT atau sesuai dengan nilai BIGINT yang lebih kecil dari 0x08001fffffffffff atau lebih besar dari 0x08ff3b6db6db6db6, fungsi mengembalikan H3_INVALID_CELL_ID.
  • Jika resolutionExpr lebih kecil dari h3_resolution(h3CellIdExpr) atau lebih besar dari 15, fungsi mengembalikan H3_INVALID_RESOLUTION_VALUE.

Contoh

-- Simple example taking a long as input.
> SELECT h3_minchild(599686042433355775, 10)
  622204039496499199

-- Simple example taking a valid hexadecimal string as input.
> SELECT h3_minchild('85283473fffffff', 10)
  8a2834700007fff

-- First input is an invalid H3 cell ID.
> SELECT h3_minchild(0, 15)
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID

-- Second input is an invalid resolution value.
> SELECT h3_minchild('85283473fffffff', 4)
  [H3_INVALID_RESOLUTION_VALUE] H3 resolution 4 must be between 5 and 15, inclusive