مشاركة عبر

h3_ispentagon وظيفه

  • مقالة

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

إرجاع true إذا كان الإدخال BIGINT أو سلسلة سداسية عشرية يتوافق مع خلية H3 البنتاغونية أم لا.

بناء الجملة

h3_ispentagon ( h3CellIdExpr )

الوسيطات

  • h3CellIdExpr: تعبير BIGINT أو تعبير سلسلة سداسي عشري يمثل معرف خلية H3.

المرتجعات

قيمة منطقية تشير إلى ما إذا كان الإدخال BIGINT أو سلسلة سداسية عشرية يتوافق مع خلية H3 البنتاغونية.

ترجع الدالة NULL إذا كان الإدخال NULL. تقوم الدالة بالتحقق الجزئي فيما إذا كانت وسيطة الإدخال هي معرف خلية H3 صالح. شرط ضروري، ولكن ليس كافيا لمعرف H3 صالح هو أن قيمته بين 0x08001fffffffffff و 0x08ff3b6db6db6db6. سلوك الدالة غير معرف إذا لم يكن معرف خلية الإدخال معرف خلية صالحا.

حالات الخطأ

  • إذا كانت h3CellIdExpr سلسلة لا يمكن تحويلها إلى BIGINT أو تتوافق مع قيمة BIGINT أصغر من 0x08001fffffffffff أو أكبر من 0x08ff3b6db6db6db6، ترجع الدالة H3_INVALID_CELL_ID.

الأمثلة

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

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

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