مشاركة عبر

h3_validate وظيفه

  • مقالة

ينطبق على:وضع علامة Databricks SQL وضع علامة Databricks Runtime 11.3 LTS وما فوق

ترجع قيمة الإدخال، من النوع BIGINT أو STRING، إذا كانت تتوافق مع معرف خلية H3 صالح، أو تصدر خطأ بخلاف ذلك. في حالة إدخال STRING، يتم اقتطاع أي أصفار بادئة.

بناء الجملة

h3_validate ( h3CellIdExpr )

الوسيطات

  • h3CellIdExpr: تعبير BIGINT أو تعبير STRING من المتوقع أن يمثل معرف خلية H3 صالحا.

المرتجعات

قيمة من نفس نوع h3CellIdExpr التعبير، و مساوية لقيمة تعبير الإدخال h3CellIdExpr . في حالة إدخال STRING، يتم اقتطاع أي أصفار بادئة.

ترجع الدالة NULL إذا كان الإدخال NULL.

حالات الخطأ

الأمثلة

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