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

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

JSON_PATCH

تطبق JSON MergePatch (RFC-7396) على مستند JSON، فتعدله وفقًا للعمليات المحددة. تُستخدم هذه الدالة لإضافة العناصر أو تعديلها أو حذفها داخل كائنات JSON، لكنها تتعامل مع مصفوفات JSON كوحدات غير قابلة للتجزئة.

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


بناء الجملة​

SELECT JSON_PATCH(target_json, patch_json) FROM <multipartIdentifier>;

الوسيطات​

target_json
مستند JSON المراد تصحيحه.

patch_json
مستند JSON يصف التغييرات المراد تطبيقها وفقًا لخوارزمية MergePatch.

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

تعيد مستند JSON المعدل بعد تطبيق التصحيح.


أمثلة​

تصحيح MergePatch بسيط​

-- Example: Simple merge of new elements into the target JSON object
SELECT JSON_PATCH('{"a":1,"b":2}', '{"c":3,"d":4}') AS patched_json;

الإخراج: {"a":1,"b":2,"c":3,"d":4}

استبدال عنصر في مصفوفة​

-- Example: Replacing an array with a single value in the JSON object
SELECT JSON_PATCH('{"a":[1,2],"b":2}', '{"a":9}') AS patched_json;

الإخراج: {"a":9,"b":2}

إزالة عنصر باستخدام null​

-- Example: Removing an element by setting it to null
SELECT JSON_PATCH('{"a":1,"b":2}', '{"a":9,"b":null,"c":8}') AS patched_json;

الإخراج: {"a":9,"c":8}

تصحيح MergePatch متداخل​

-- Example: Nested merge patch updating sub-keys within a nested JSON object
SELECT JSON_PATCH('{"a":{"x":1,"y":2},"b":3}', '{"a":{"y":9},"c":8}') AS patched_json;

الإخراج: {"a":{"x":1,"y":9},"b":3,"c":8}

تتيح هذه الميزة إجراء تحديثات مرنة وديناميكية على بيانات JSON المخزنة في قاعدة بيانات، وهي مفيدة بشكل خاص للتطبيقات التي تتطلب تعديلات مشروطة على هياكل البيانات.