إنتقل إلى المحتوى الرئيسي
صفحة مترجمة

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.

JSON_ARRAY_LENGTH

تعيد عدد العناصر في مصفوفة JSON.

راجع أيضًا:
[SELECT] [DESCRIBE] [JSON_EXTRACT] [ أنواع البيانات ]


تلميح

استخدم الجملة DESCRIBE لتحديد موقع أنواع البيانات array أو object التي يمكن استخدامها مع دوال JSON في StackQL. استخدم الدالة JSON_TYPE لتحديد أنواع بيانات الكائنات المتداخلة أو عناصر المصفوفات.

بناء الجملة​

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