تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.
JSON_EXTRACT
تعيد قيمة واحدة أو أكثر من كائن أو مصفوفة JSON جيدة التكوين.
راجع أيضًا:
[SELECT] [DESCRIBE] [JSON_ARRAY_LENGTH] [ أنواع البيانات ]
تُنفذ الدالة 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