مشاركة عبر

h3_try_validate وظيفه

  • مقالة

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

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

بناء الجملة

h3_try_validate ( h3CellIdExpr )

الوسيطات

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

المرتجعات

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

ترجع الدالة NULL إذا كان الإدخال NULL. يمكن أن ترجع الدالة NULL للإدخلات غير الفارغة.

الأمثلة

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

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

-- Simple taking a long as input, that is not a valid H3 cell ID.
> SELECT h3_try_validate(599686042433355776)
  null