تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.
JSON_ARRAY_LENGTH
تعيد عدد العناصر في مصفوفة JSON.
راجع أيضًا:
[SELECT] [DESCRIBE] [JSON_EXTRACT] [ أنواع البيانات ]
بناء الجملة
SELECT JSON_ARRAY_LENGTH(json_array_or_object [, json_path]) FROM <multipartIdentifier>;
الوسيطات
json_array_or_object
مصفوفة JSON أو كائن JSON.
إذا كانت قيمة json_array_or_object كائن JSON (وليست مصفوفة) ولم تحدد json_path، تعاد القيمة
0.
json_path
مسار JSON الاختياري إلى مصفوفة موجودة داخل كائن. راجع jsonpath.com.
إذا تم توفير json_path، تحدد الدالة
json_array_lengthموقع المسار داخل json_array_or_object وتعيد طول المصفوفة، أو0إذا كان json_path يشير إلى كائن (وليس مصفوفة). إذا تعذر العثور على json_path داخل json_array_or_object، تعاد القيمةNULL.
إذا لم تكن قيمة json_array_or_object بتنسيق JSON جيد التكوين، أو لم يكن json_path مسار JSON جيد التكوين، فإن الدالة تطرح خطأ.
القيمة المرجعة
تعيد قيمة من نوع عدد صحيح.
أمثلة
إرجاع عدد الأقراص المرفقة بمثيلات Google Compute Engine
SELECT name, json_array_length(disks) as num_disks
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';
إرجاع عدد واجهات الشبكة المرفقة بمثيلات Google Compute Engine
SELECT name, json_array_length(networkInterfaces) as num_nics
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';
إرجاع عدد قوائم ACL المرتبطة بحاويات Google Storage
SELECT name, json_array_length(acl) as num_acls
FROM google.storage.buckets
WHERE project = 'stackql';
إرجاع عدد النطاقات المرتبطة بحساب خدمة
SELECT name, json_array_length(serviceAccounts, '$[0].scopes') as num_scopes
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';
لمزيد من المعلومات، راجع https://www.sqlite.org/json1.html#jarraylen