مشاركة عبر

h3_minchild وظيفه

  • مقالة

ترجع هذه الدالة التابعة للقيمة الدنيا لخلية الإدخال H3 بدقة محددة.

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

بناء الجملة

h3_minchild ( 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_minchild(599686042433355775, 10)
  622204039496499199

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

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

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