Funkcja h3_stringtoh3

Dotyczy: Databricks SQL Databricks Runtime 11.3 LTS i nowsze

Konwertuje ciąg wejściowy, który ma być ciągiem szesnastkowym reprezentującym komórkę H3, na odpowiadającą reprezentację BIGINT komórki H3.

Składnia

h3_stringtoh3 ( h3CellIdExpr )

Argumenty

• h3CellIdStringExpr: poprawnie sformułowane wyrażenie ciągu szesnastkowego reprezentujące prawidłowy identyfikator komórki H3.

Zwraca

Wartość typu BIGINT. Zwracana wartość to reprezentacja BIGINT wejściowego ciągu szesnastkowego.

Funkcja zwraca wartość NULL, jeśli dane wejściowe mają wartość NULL. Funkcja konwertuje ciąg szesnastkowy na odpowiadający mu numer BIGINT. 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 nie można przekonwertować wartości h3CellIdStringExpr na BIGINT lub jeśli wartość odpowiada wartości BIGINT, która jest mniejsza lub większa niż 0x08001fffffffffff0x08ff3b6db6db6db6, funkcja zwraca H3_INVALID_CELL_ID.

Przykłady

-- Simple example
> SELECT h3_stringtoh3('85283473fffffff');
  599686042433355775

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

Funkcje pokrewne

• h3_h3tostring funkcja