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

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

JSON_EACH

دالة ذات قيمة جدولية يتكون الجدول الذي تعيده من صف واحد لكل عنصر في المصفوفة أو عضو في الكائن.

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


تلميح

استخدم الجملة DESCRIBE لتحديد موقع أنواع البيانات array التي يمكن استخدامها مع الدالة json_each.

ملاحظة

تُنفذ الدالة json_each باستخدام الدالة json_array_elements_text إذا كنت تستخدم stackql مع واجهة SQL الخلفية postgres

بناء الجملة​

SELECT <alias>.<projectedField>, ... , json_each.value
FROM <multipartIdentifier> <alias>, JSON_EACH(json_array_or_object, json_path);

الوسيطات​

json_array_or_object
مصفوفة JSON أو كائن JSON.

json_path
مسار JSON إلى مصفوفة أو كائن موجود داخل json_array_or_object. راجع jsonpath.com.

إذا لم يوجد json_path في json_array_or_object، لا تعيد الدالة أي صفوف.

تطرح الدالة json_each() خطأ إذا لم تكن قيمة json_array_or_object بتنسيق JSON جيد التكوين.

القيمة المرجعة​

جدول يتكون من صف واحد لكل عنصر في المصفوفة أو عضو في الكائن.


أمثلة​

فك تداخل مصفوفة من السلاسل النصية إلى جدول مربوط بالحقول المرتبطة بها​

للتوضيح:

describe google.cloudresourcemanager.projects_iam_policies;

تعيد...

|-----------|--------|
| name | type |
|-----------|--------|
| condition | object |
|-----------|--------|
| members | array |
|-----------|--------|
| role | string |
|-----------|--------|

يستخدم استعلام stackql التالي الدالة json_each لفك تداخل المصفوفة members إلى جدول مربوط بالحقل role، وبالحقل condition اختياريًا.

select
iam.role,
SPLIT_PART(json_each.value, ':', 2) as member
from google.cloudresourcemanager.projects_iam_policies iam, json_each(members)
where projectsId = 'stackql';

سيعيد...

|--------------------------------------|-------------------------------------------------------|
| role | member |
|--------------------------------------|-------------------------------------------------------|
| roles/cloudbuild.builds.builder | 1234567890@cloudbuild.gserviceaccount.com |
|--------------------------------------|-------------------------------------------------------|
| roles/editor | 1234567890-compute@developer.gserviceaccount.com |
|--------------------------------------|-------------------------------------------------------|
| roles/editor | 1234567890@cloudservices.gserviceaccount.com |
|--------------------------------------|-------------------------------------------------------|
| roles/editor | stackql@appspot.gserviceaccount.com |
|--------------------------------------|-------------------------------------------------------|
| ... | ... |
|--------------------------------------|-------------------------------------------------------|

لمزيد من المعلومات، راجع https://www.sqlite.org/json1.html#jeach