h3_h3tostring
وظيفه
ينطبق على: Databricks SQL Databricks Runtime 11.3 LTS وما فوق
تحويل معرف خلية الإدخال H3 إلى تمثيل السلسلة السداسية العشرية المكافئة له.
بناء الجملة
h3_h3tostring ( h3CellIdExpr )
الوسيطات
h3CellIdExpr
: تعبير BIGINT يمثل معرف خلية H3.
المرتجعات
قيمة من النوع STRING. النتيجة التي تم إرجاعها هي التمثيل السداسي العشري الكبير للإدخال BIGINT مع تجريد أي أصفار بادئة.
ترجع الدالة NULL إذا كان الإدخال NULL.
تحول الدالة BIGINT إلى السلسلة السداسية العشرية المقابلة لها.
تقوم الدالة بالتحقق الجزئي فيما إذا كانت وسيطة الإدخال هي معرف خلية H3 صالح. شرط ضروري، ولكن ليس كافيا لمعرف H3 صالح هو أن قيمته بين 0x08001fffffffffff
و 0x08ff3b6db6db6db6
.
سلوك الدالة غير معرف إذا لم يكن معرف خلية الإدخال معرف خلية صالحا.
حالات الخطأ
- إذا كانت قيمة
h3CellIdExpr
أصغر من أو أكبر من0x08001fffffffffff
0x08ff3b6db6db6db6
، ترجع الدالة H3_INVALID_CELL_ID.
الأمثلة
-- Simple example
> SELECT h3_h3tostring(599686042433355775)
85283473fffffff
-- Input is an invalid H3 cell ID.
> SELECT h3_h3tostring(0)
[H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID