Funkcja h3_h3tostring

  • Artykuł

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 11.3 LTS i nowsze

Konwertuje wejściowy identyfikator komórki H3 na równoważną reprezentację ciągu szesnastkowego.

Składnia

h3_h3tostring ( h3CellIdExpr )

Argumenty

  • h3CellIdExpr: wyrażenie BIGINT reprezentujące identyfikator komórki H3.

Zwraca

Wartość typu STRING. Zwrócony wynik jest szesnastkowa reprezentacja big-endian danych wejściowych BIGINT z dowolnymi wiodącymi zerami pozbawionymi.

Funkcja zwraca wartość NULL, jeśli dane wejściowe mają wartość NULL. Funkcja konwertuje ciąg BIGINT na odpowiadający mu ciąg szesnastkowy. Funkcja wykonuje częściową walidację dotyczącą tego, czy argument wejściowy jest prawidłowym identyfikatorem komórki H3. Wymagany, ale nie wystarczający warunek prawidłowego identyfikatora H3 jest taki, że jego wartość mieści się między 0x08001fffffffffff i 0x08ff3b6db6db6db6. Zachowanie funkcji jest niezdefiniowane, jeśli identyfikator komórki wejściowej nie jest prawidłowym identyfikatorem komórki.

Warunki błędu

  • Jeśli wartość wartości h3CellIdExpr jest mniejsza lub większa niż 0x08001fffffffffff0x08ff3b6db6db6db6, funkcja zwraca H3_INVALID_CELL_ID.

Przykłady

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