Udostępnij za pośrednictwem

Funkcja h3_validate

  • 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ść wejściową typu BIGINT lub STRING, jeśli odpowiada prawidłowemu identyfikatorowi komórki H3 lub generuje błąd w przeciwnym razie. W przypadku danych wejściowych STRING wszystkie zera wiodące są przycinane.

Składnia

h3_validate ( h3CellIdExpr )

Argumenty

  • h3CellIdExpr: wyrażenie BIGINT lub wyrażenie STRING, które ma reprezentować prawidłowy identyfikator komórki H3.

Zwraca

Wartość tego samego typu co typ h3CellIdExpr wyrażenia i równa wartości wyrażenia wejściowego h3CellIdExpr . W przypadku danych wejściowych STRING wszystkie zera wiodące są przycinane.

Funkcja zwraca wartość NULL, jeśli dane wejściowe mają wartość NULL.

Warunki błędu

  • Jeśli h3CellIdExpr nie jest prawidłowym identyfikatorem komórki H3, funkcja zwraca H3_INVALID_CELL_ID.

Przykłady

-- Simple example taking a long as input.
> SELECT h3_validate(590112357393367039)
  590112357393367039

-- Simple example taking a hexadecimal string as input.
> SELECT h3_validate('85283473fffffff')
  85283473fffffff

-- Example taking a long as input that is not a valid H3 cell ID.
> SELECT h3_validate(599686042433355776)
  [H3_INVALID_CELL_ID] 599686042433355776 is not a valid H3 cell ID

-- Example where the input is an invalid hexadecimal string.
> SELECT h3_validate('I am not an H3 cell id')
  [H3_INVALID_CELL_ID] 'I am not an H3 cell id' is not a valid H3 cell ID