Função h3_h3tostring

Aplica-se a: Databricks SQL Databricks Runtime 11.3 LTS e superior

Converte o 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 um ID de célula H3.

Devoluções

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 retorna NULL se a entrada for NULL. A função converte o BIGINT em sua cadeia hexadecimal correspondente. A função faz validação parcial em relação a se o argumento de entrada é um ID de célula H3 válido. Uma condição necessária, mas não suficiente, para um ID H3 válido é que seu valor esteja entre 0x08001fffffffffff e 0x08ff3b6db6db6db6. O comportamento da função é indefinido se o ID da célula de entrada não for um ID de célula válido.

Condições de erro

• Se o valor de h3CellIdExpr for menor 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

Funções relacionadas

• h3_stringtoh3 função