مشاركة عبر

h3_boundaryaswkb وظيفه

  • مقالة

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

إرجاع الحد المضلع لخلية الإدخال H3 بتنسيق W كيلوبايت.

بناء الجملة

h3_boundaryaswkb ( h3CellIdExpr )

الوسيطات

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

المرتجعات

قيمة من النوع BINARY تمثل الحد المضلع لخلية الإدخال H3 بتنسيق W كيلوبايت.

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

حالات الخطأ

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

الأمثلة

-- Input a BIGINT representing a hexagonal cell.
> SELECT hex(h3_boundaryaswkb(599686042433355775))
  01030000000100000007000000E27B13AD907A5EC08998FEC9BBA24240300C97AA2E775EC0A2CC41764DAD4240159571711B7B5EC0DCE64CE2D3B64240255DE93F6A825EC08F5EC9C6C6B54240B4356B96C9855EC0546EAB0935AB42407ACFBCCBDC815EC0CBADA278B0A14240E27B13AD907A5EC08998FEC9BBA24240

-- Input a STRING representing a pentagonal cell.
> SELECT hex(h3_boundaryaswkb('8009fffffffffff'))
  01030000000100000006000000418DC418D4E324C0212965BB2A8C4F40DA750FCD3618164003D6996377DA4B4022DC574A2D153940770583D265334D4098617DCCCED43F40BE65106E843B5140677635CDCCD6D43F4DDB71B4DA535240418DC418D4E324C0212965BB2A8C4F40

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