h3_h3tostring fungsi

  • Artikel

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

Mengonversi ID sel H3 input ke representasi string heksadesimal yang setara.

Sintaks

h3_h3tostring ( h3CellIdExpr )

Argumen

  • h3CellIdExpr: Ekspresi BIGINT yang mewakili ID sel H3.

Mengembalikan

Nilai jenis STRING. Hasil yang dikembalikan adalah representasi heksadesimal big-endian dari INPUT BIGINT dengan nol awal yang dilucuti.

Fungsi mengembalikan NULL jika input adalah NULL. Fungsi ini mengonversi BIGINT ke string heksadesimal 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 h3CellIdExpr lebih kecil dari 0x08001fffffffffff atau lebih besar dari 0x08ff3b6db6db6db6, fungsi mengembalikan H3_INVALID_CELL_ID.

Contoh

-- Simple example
> SELECT h3_h3tostring(599686042433355775)
  85283473fffffff

-- Input is an invalid H3 cell ID.
> SELECT h3_h3tostring(0)
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID