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

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

JSON_INSERT

تدرج القيم الجديدة في مستند JSON في المسارات المحددة دون الكتابة فوق القيم الموجودة.

راجع أيضًا:
[SELECT] [JSON_EXTRACT] [JSON_SET] [JSON_REPLACE]


بناء الجملة​

SELECT JSON_INSERT(json_column, path, new_value) FROM <multipartIdentifier>;

الوسيطات​

json_column
عمود JSON أو التعبير المراد تعديله.

path
تعبير مسار JSON الذي يجب إدراج القيمة الجديدة فيه. إذا كان المسار موجودًا بالفعل، فلا يتم استبدال القيمة الأصلية في ذلك المسار.

new_value
القيمة المراد إدراجها في المسار المحدد في مستند JSON.

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

تعيد مستند JSON بعد إدراج القيمة الجديدة إذا لم يكن المسار المحدد موجودًا بالفعل؛ وإلا فيعاد مستند JSON دون تغيير.

السلوك إذا كان المفتاح موجودًا
الدالةالكتابة فوق القيمة إذا كانت موجودة؟الإنشاء إذا لم تكن موجودة؟
json_insert()لانعم
json_replace()نعملا
json_set()نعمنعم

أمثلة​

إدراج زوج مفتاح وقيمة جديد في كائن JSON​

-- Example: Insert a new 'region' key with the value 'Europe' into a JSON object
SELECT JSON_INSERT('{"name":"ResourceOne","type":"Storage"}', '$.region', 'Europe') as updated_object;

/* expected output...
|-----------------------------------------------------------|
| updated_object |
|-----------------------------------------------------------|
| {"name":"ResourceOne","type":"Storage","region":"Europe"} |
|-----------------------------------------------------------|
*/

يدرج هذا الاستعلام مفتاحًا جديدًا اسمه 'region' بالقيمة 'Europe' في مستند JSON إذا لم يكن المفتاح 'region' موجودًا بالفعل. إذا كان 'region' مفتاحًا موجودًا بالفعل في المستند، فيعاد المستند الأصلي دون تغييرات.