مشاركة عبر

h3_tochildren وظيفه

  • مقالة

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

إرجاع صفيف خلايا H3 التابعة لخلية الإدخال H3 بدقة محددة.

بناء الجملة

h3_tochildren ( h3cellIdExpr, resolutionExpr )

الوسيطات

  • h3CellIdExpr: تعبير BIGINT أو تعبير سلسلة سداسي عشري يمثل معرف خلية H3.
  • resolutionExpr: تعبير INT، من المتوقع أن تكون قيمته بين h3_resolution(h3CellIdExpr) و 15 شاملة، يحدد دقة معرفات الخلايا H3 التابعة.

المرتجعات

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

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

حالات الخطأ

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

الأمثلة

-- Simple example taking a long as input.
> SELECT h3_tochildren(599686042433355775, 6)
  [604189641121202175,604189641255419903,604189641389637631,604189641523855359,604189641658073087,604189641792290815,604189641926508543]

-- Simple example taking a hexadecimal string as input.
> SELECT h3_tochildren('85283473fffffff', 6)
  [862834707ffffff,86283470fffffff,862834717ffffff,86283471fffffff,862834727ffffff,86283472fffffff,862834737ffffff]

-- First input is an invalid H3 cell ID.
> SELECT h3_tochildren(0, 15)
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID

-- Second input is an invalid resolution value.
> SELECT h3_tochildren('85283473fffffff', 0)
  [H3_INVALID_RESOLUTION_VALUE] H3 resolution 0 must be between 5 and 15, inclusive