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

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

JSON_SET

تحدّث القيم الموجودة أو تدرج قيمًا جديدة في مستند JSON في المسارات المحددة.

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


بناء الجملة​

SELECT JSON_SET(json_column, path, value_to_set) FROM <multipartIdentifier>;

الوسيطات​

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

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

value_to_set
القيمة المراد تعيينها في المسار المحدد في مستند JSON.

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

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

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

أمثلة​

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

-- Example: Update the 'status' key's value to 'active' in a JSON object
SELECT JSON_SET('{"name":"ServiceOne","status":"pending","region":"US"}', '$.status', 'active') as updated_json;

-- Expected output:
-- |---------------------------------------------------------|
-- | updated_json |
-- |---------------------------------------------------------|
-- | {"name":"ServiceOne","status":"active","region":"US"} |
-- |---------------------------------------------------------|

يحدّث هذا الاستعلام المفتاح 'status' إلى 'active' في مستند JSON إذا كان المفتاح 'status' موجودًا. وإذا لم يكن 'status' موجودًا في المستند، فتتم إضافته بالقيمة 'active'.

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

-- Example: Add a new key 'lastChecked' with a date value to a JSON object
SELECT JSON_SET('{"name":"ServiceOne","status":"pending"}', '$.lastChecked', '2024-04-29') as updated_json;

/* expected output...
|-----------------------------------------------------------------------|
| updated_json |
|-----------------------------------------------------------------------|
| {"name":"ServiceOne","status":"pending","lastChecked":"2024-04-29"} |
|-----------------------------------------------------------------------|
*/

يضيف هذا الاستعلام مفتاحًا جديدًا 'lastChecked' بالقيمة '2024-04-29' إلى مستند JSON إذا لم يكن 'lastChecked' موجودًا بالفعل. وإذا كان موجودًا، فيتم تحديث القيمة الموجودة إلى '2024-04-29'.