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