Compartilhar via


Função h3_h3tostring

Aplica-se a:verificação marcada como sim Databricks SQL verificação marcada como sim Databricks Runtime 11.3 LTS e versões superiores

Converte a ID da célula H3 de entrada em sua representação de cadeia de caracteres hexadecimal equivalente.

Sintaxe

h3_h3tostring ( h3CellIdExpr )

Argumentos

  • h3CellIdExpr: uma expressão BIGINT que representa uma ID de célula H3.

Retornos

Um valor do tipo STRING. O resultado retornado é a representação hexadecimal big-endian do BIGINT de entrada com quaisquer zeros à esquerda removidos.

A função retornará NULL se a entrada for NULL. A função converte o BIGINT em sua cadeia de caracteres hexadecimal correspondente. A função faz validação parcial sobre se o argumento de entrada é uma ID de célula H3 válida. Uma condição necessária, mas não suficiente para uma ID H3 válida, é que seu valor esteja entre 0x08001fffffffffff e 0x08ff3b6db6db6db6. O comportamento da função será indefinido se a ID da célula de entrada não for uma ID de célula válida.

Condições de erro

  • Se o valor de h3CellIdExpr for menor do que 0x08001fffffffffff ou maior que 0x08ff3b6db6db6db6, a função retornará H3_INVALID_CELL_ID.

Exemplos

-- 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