Menu

JSONB في PostgreSQL: المعاملات والاستعلامات والفهارس

خزّن JSON واستعلم عنه في PostgreSQL باستخدام jsonb: المعاملان -> و->>، والاحتواء بـ @>، والتحديث بـ jsonb_set، وتحويل المصفوفات إلى صفوف، وفهارس GIN، والفرق بين json وjsonb.

تحتوي هذه الصفحة على محررات قابلة للتشغيل. حرّر، شغّل، وشاهد النتيجة فوراً.

jsonb هو نوع العمود الثنائي لـ JSON في PostgreSQL. اقرأ الحقول بـ -> (يعيد jsonb) و->> (يعيد text)، وابحث عن الصفوف بمعامل الاحتواء @>، وغيّر الحقول بـ jsonb_set أو ||. ويجعل فهرس GIN هذه الاستعلامات سريعة.

يطابق الطلبان 1 و3. يعيد data->'customer' الكائن المتداخل كـ jsonb، ويستخرج ->>'name' الاسم كنص، ويحوّل ->> مع التحويل الصريح المجموع إلى رقم.

استخراج القيم من JSONB

المعامليعيدمثال
-> مفتاح أو فهرسjsonbdata->'customer'، data->'tags'->0
->> مفتاح أو فهرسtextdata->>'status'
#> مسارjsonbdata#>'{customer,city}'
#>> مسارtextdata#>>'{customer,city}'
[...] subscript ‏(PostgreSQL 14+)jsonbdata['customer']['city']

تبدأ فهارس المصفوفات من 0، والفهرس السالب يعدّ من النهاية (-> -1 هو العنصر الأخير). والمفتاح الناقص يعطي NULL في SQL لا خطأ، لذا تكون مدينة الطلب 3 أعلاه NULL.

استخدم ->> للمقارنة بنص أو للتحويل: data->>'status' = 'paid'، واستخدم -> لمتابعة التنقل. ومن الأخطاء الشائعة كتابة data->'status' = 'paid': يقرأ PostgreSQL القيمة 'paid' على أنها JSON، والكلمة غير المقتبسة ليست JSON صالحًا، فيفشل الاستعلام بالخطأ "invalid input syntax for type json".

البحث عن الصفوف بمحتوى JSON

يختبر @> ما إذا كانت القيمة اليسرى تحتوي على اليمنى. ويعمل على أي عمق وداخل المصفوفات، ويدعمه فهرس GIN:

لدى المنتجين 1 و2 المقاس M وسعر، ووحده المنتج 2 يتجاوز سعره 30. معاملات البحث:

  • @> يحتوي، و<@ محتوًى في.
  • ? المفتاح (أو النص في المصفوفة) موجود، و?| أي من المفاتيح موجود، و?& كلها موجودة.
  • @? و@@ تشغّلان استعلام JSON path ‏(PostgreSQL 12+)، للمقارنات داخل المستند.

تحديث الحقول داخل JSONB

يعيد PostgreSQL كتابة القيمة كاملة عند كل تحديث، لكن هذه الدوال تتيح لك وصف التغيير وحده:

  • تستبدل jsonb_set(target, path, new_value) قيمة واحدة عند مسار.
  • يحذف - مفتاحًا، ويحذف #- مسارًا متداخلًا مثل '{notify,sms}'.
  • يضيف || مفاتيح المستوى الأعلى أو يستبدلها.

ومنذ PostgreSQL 14 يمكنك أيضًا الإسناد عبر subscript: SET prefs['notify']['email'] = 'false'.

فخّان:

  • تعيد jsonb_set ‏NULL حين تكون القيمة الجديدة NULL في SQL، فيمسح UPDATE العمود كله. مرّر COALESCE(to_jsonb(x), 'null')، أو استخدم jsonb_set_lax ‏(PostgreSQL 13+) التي تخزّن null في JSON افتراضيًا.
  • تضيف jsonb_set المفتاح الأخير الناقص، لا الآباء الناقصين: ضبط '{a,b}' على {} يتركه دون تغيير. أما الإسناد عبر subscript فينشئهم.

تحويل مصفوفات JSON إلى صفوف

تعيد jsonb_array_elements صفًا لكل عنصر في المصفوفة، وتحوّل jsonb_to_recordset مصفوفة كائنات إلى أعمدة ذات أنواع. ومنذ PostgreSQL 17 تؤدي JSON_TABLE القياسية الأمرين في مكان واحد:

بيع من A-1 ثلاث قطع ومن B-2 قطعة واحدة. وفي الاتجاه المعاكس، تبني jsonb_build_object('id', id, 'name', name) كائنًا من الأعمدة، وتجمع jsonb_agg الصفوف في مصفوفة (راجع string_agg وarray_agg).

فهرسة JSONB باستخدام GIN

يخدم فهرس GIN على العمود كله المعاملات @> و? و?| و?& و@? و@@:

CREATE INDEX orders_data_idx ON orders USING gin (data);

-- smaller and faster, but only for @>, @? and @@
CREATE INDEX orders_data_path_idx ON orders USING gin (data jsonb_path_ops);

-- one field compared with = or a range: a B-tree on the expression
CREATE INDEX orders_status_idx ON orders ((data->>'status'));

اكتب الاستعلام بالصيغة التي يدعمها الفهرس. يستطيع WHERE data @> '{"status": "paid"}' استخدام فهرس GIN، أما WHERE data->>'status' = 'paid' فلا يستطيع، ويحتاج إلى فهرس التعبير. واختبار النطاق مثل (data->>'total')::numeric > 50 يحتاج إلى فهرس على ذلك التعبير بالضبط.

JSON مقابل JSONB

jsonjsonb
يُخزَّن كـنص المدخلصيغة ثنائية محلَّلة
المسافات وترتيب المفاتيح والمفاتيح المكررةتُحفظتُحذف، ويفوز آخر مكرر
الكتابةأسرع قليلًا (تحقق فقط)يُحلَّل عند الإدخال
القراءة والاستعلاميُعاد تحليله عند كل وصولسريع
@> و? وفهارس GINلانعم

يعيد json النص دون تغيير، بينما يحتفظ jsonb بـ "a": 3 فقط ويعيد ترتيب المفاتيح. استخدم jsonb إلا إذا كان عليك إعادة النص الأصلي بايتًا ببايت، مثل حمولة webhook مخزّنة. واحتفظ بالحقول الموجودة في كل صف، أو التي تحتاج إلى مفتاح أجنبي، في أعمدة عادية. ويسرد مرجع دوال JSON الرسمي كل المعاملات والدوال.

الأسئلة الشائعة

ما الفرق بين -> و->> في PostgreSQL؟

يعيد -> القيمة كـ jsonb، فتستطيع متابعة التنقل (data->'customer'->'city'). ويعيدها ->> كـ text، وهذا ما تقارنه بنص أو تحوّله إلى رقم: (data->>'total')::numeric.

كيف أتحقق من أن مصفوفة JSONB تحتوي على قيمة؟

استخدم الاحتواء: data->'tags' @> '["gift"]'، أو data @> '{"tags": ["gift"]}' لتختبر من أعلى المستند. ولمصفوفة نصوص يعمل أيضًا data->'tags' ? 'gift'. ويسرّع فهرس GIN على data الصيغة الثانية.

هل يحافظ JSONB على ترتيب المفاتيح؟

لا. يخزّن jsonb المفاتيح بترتيبه الخاص، ويحذف المسافات، ولا يحتفظ إلا بآخر المفاتيح المكررة. وإن احتجت إلى استعادة النص الأصلي كما هو بالضبط، فاستخدم النوع json.

كيف أتحقق من وجود مفتاح في JSONB؟

يكون data ? 'key' صحيحًا حين يحتوي الكائن في المستوى الأعلى على ذلك المفتاح، حتى لو كانت قيمته null في JSON. ويأخذ ?| مصفوفة ويكون صحيحًا إن وُجد أي مفتاح منها، و?& إن وُجدت كلها.

هل يمكن إضافة مفتاح أجنبي أو قيد NOT NULL على حقل داخل JSONB؟

ليس مباشرة. يستطيع قيد CHECK اختبار حقل (CHECK (data ? 'email'))، لكن المفاتيح الأجنبية تحتاج إلى عمود حقيقي. والحقول الموجودة في كل صف والتي تشير إليها جداول أخرى مكانها الأعمدة العادية.

رسم توضيحي للغات البرمجة في Coddy

تعلّم البرمجة مع Coddy

ابدأ الآن