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

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

JSON_EXTRACT

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

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


تلميح

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

ملاحظة

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

بناء الجملة​

SELECT JSON_EXTRACT(json_array_or_object, json_path[, json_path1, .. json_pathN])
FROM <multipartIdentifier>;

الوسيطات​

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

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

إذا تم تقديم json_path واحد، فتعاد نتيجة عددية يطابق نوعها نوع بيانات المسار الذي تم حله.

إذا تم تقديم عدة وسيطات json_path، فستكون النتيجة مصفوفة مكونة من الكائنات التي تم حلها بواسطة المسارات المعنية.

يؤدي تحديد '$' للوسيطة json_path إلى إرجاع كائن JSON بالكامل المقابل للعمود الذي تمثله الوسيطة json_array_or_object.

ملاحظة: يمكنك استخدام أدوات مثل json-viewer لتطوير تعبيرات مسار JSON واختبارها

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

سلسلة نصية أو عدد صحيح أو كائن أو مصفوفة أو قيمة منطقية أو null، حسب json_array_or_object وjson_path المقدمة كإدخال.


أمثلة​

إرجاع كائنات الأقراص المرتبطة بكل مثيل Google Compute Engine​

SELECT name, json_extract(disks, '$') as disks
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';

إرجاع اسم الجهاز وحجم القرص الأول المرفق بكل مثيل Google Compute Engine​

SELECT name, json_extract(disks, '$[0].deviceName') as device_name,
json_extract(disks, '$[0].diskSizeGb') as disk_size
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';

إرجاع مستوى الشبكة لأول NIC مرفقة بكل مثيل Google Compute Engine​

SELECT name, json_extract(networkInterfaces, '$[0].accessConfigs[0].networkTier') as network_tier
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';

إرجاع قائمة النطاقات المرتبطة بأول حساب خدمة مرتبط بكل مثيل Google Compute Engine​

SELECT name, json_extract(serviceAccounts, '$[0].scopes') as scopes
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';
/* returns a list for each service account */

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