مشاركة عبر

h3_maxchild وظيفه

  • مقالة

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

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

بناء الجملة

h3_maxchild ( h3cellIdExpr, resolutionExpr )

الوسيطات

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

المرتجعات

قيمة من نفس نوع h3CellIdExpr التعبير، مطابقة لطفل القيمة القصوى لمعرف خلية الإدخال 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_maxchild(599686042433355775, 10)
  622204040416821247

-- Simple example taking a valid hexadecimal string as input.
> SELECT h3_maxchild('85283473fffffff', 10)
  8a2834736db7fff

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

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