Funkcja h3_ischildof

  • Artykuł

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

Zwraca wartość true, jeśli pierwsza komórka H3 jest taka sama jak lub element podrzędny drugiej komórki H3.

Składnia

h3_ischildof ( h3CellId1Expr, h3cellId2Expr )

Argumenty

  • h3CellId1Expr: wyrażenie BIGINT lub wyrażenie szesnastkowe STRING reprezentujące identyfikator komórki H3.
  • h3CellId2Expr: wyrażenie BIGINT lub wyrażenie szesnastkowe STRING reprezentujące identyfikator komórki H3.

Zwraca

Wartość typu BOOLEAN wskazująca, czy pierwsza komórka H3 jest taka sama jak lub element podrzędny drugiej komórki H3.

Funkcja zwraca wartość NULL, jeśli którykolwiek z danych wejściowych ma wartość NULL. Funkcja wykonuje częściową walidację dotyczącą tego, czy którykolwiek z dwóch argumentów wejściowych 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 którykolwiek z dwóch identyfikatorów komórek wejściowych nie jest prawidłowym identyfikatorem komórki.

Warunki błędu

  • Jeśli h3CellId1Expr lub h3CellId2Expr jest ciągiem, którego nie można przekonwertować na BIGINT lub odpowiada wartości BIGINT mniejszej lub większej niż 0x08001fffffffffff0x08ff3b6db6db6db6, funkcja zwraca H3_INVALID_CELL_ID.

Przykłady

-- Simple example taking two longs as input.
> SELECT h3_ischildof(608693241318998015, 599686042433355775)
  true

-- Simple example taking two strings as input.
> SELECT h3_ischildof('88283471b9fffff', '85283473fffffff')
  true

-- Simple example taking a long integer and a string as input.
> SELECT h3_ischildof(580260664489017343, '85283473fffffff')
  false

-- First input is an invalid H3 cell ID.
> SELECT h3_ischildof(0, 599686042433355775)
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID

-- Second input is an invalid H3 cell ID.
> SELECT h3_ischildof(608693241318998015, 'xyz')
  [H3_INVALID_CELL_ID] 'xyz' is not a valid H3 cell ID