كيف يعمل JSONB ومتى يجب استخدامه؟

Question

Accepted Answer

**`JSONB`** هو نوع JSON الثنائي في PostgreSQL — يخزن بيانات JSON بتنسيق فعّال و**قابل للاستعلام والفهرسة**. يتيح لك تخزين بيانات مرنة وشبه منظمة في قاعدة بيانات علائقية، محسّناً الامتثال العلائقي بمرونة تشبه NoSQL. إنها من أقوى ميزات Postgres.

## JSONB مقابل JSON

```text
JSON  → stores the exact text (preserves whitespace/key order/duplicates), parsed each query
JSONB → stores a DECOMPOSED BINARY format → slightly slower to write, but MUCH faster
        to query, and supports INDEXING and rich operators
→ Use JSONB in almost all cases (JSON only if you need exact text preservation).
```

## تخزين والاستعلام عن JSONB

```sql
CREATE TABLE products (id SERIAL, attributes JSONB);
INSERT INTO products (attributes) VALUES
  ('{"color": "red", "size": "L", "tags": ["new", "sale"]}');

-- extract values
SELECT attributes->'color'   FROM products;   -- -> returns JSONB: "red"
SELECT attributes->>'color'  FROM products;   -- ->> returns TEXT: red
SELECT attributes#>>'{tags,0}' FROM products; -- nested path: first tag

-- query by content
SELECT * FROM products WHERE attributes->>'color' = 'red';
SELECT * FROM products WHERE attributes @> '{"color": "red"}';  -- containment
SELECT * FROM products WHERE attributes ? 'color';              -- key exists
```

المعاملات: `->` (الحصول على حقل JSONB)، `->>` (الحصول كنص)، `@>` (الاحتواء)، `?` (وجود المفتاح)، `#>>` (المسار المتداخل). تجعل هذه المعاملات JSONB قابلة للاستعلام بشكل غني — بخلاف تخزين JSON كنص عادي.

## فهرسة JSONB (المفتاح لتحسين الأداء)

```sql
-- a GIN index makes containment/key queries fast
CREATE INDEX idx_attrs ON products USING GIN (attributes);
-- now WHERE attributes @> '{"color": "red"}' uses the index

-- or index a specific extracted field
CREATE INDEX idx_color ON products ((attributes->>'color'));
```

## متى يتم استخدام JSONB (ومتى لا)

```text
✓ USE for: flexible/variable attributes, settings, API payloads, sparse fields,
  semi-structured data that varies per row, or rapidly-evolving schemas
✗ AVOID for: data that's well-structured and queried relationally → use normal columns
  (better constraints, types, and typically better performance for structured queries)
→ Mix both: structured data in columns, variable/flexible data in a JSONB column.
```

## لماذا يهم الأمر

JSONB هي إحدى أهم الميزات المميزة في PostgreSQL، وفهمها ذو قيمة عالية لأنها تتيح لك **تخزين والاستعلام بكفاءة عن البيانات شبه المنظمة داخل قاعدة بيانات علائقية** — محسّناً سلامة Postgres والمعاملات والقوة العلائقية مع مرونة متجر المستندات/NoSQL، وهي قدرة كبيرة للتطبيقات الحديثة.

الميزة الرئيسية على تخزين JSON كنص عادي (أو نوع `JSON`) هي أن **JSONB قابلة للاستعلام والفهرسة**: معاملات غنية (`->`, `->>`, `@>`, `?`) تتيح لك استخراج وتصفية محتوى JSON، و**فهارس GIN** (أو فهارس على الحقول المستخرجة) تجعل هذه الاستعلامات سريعة — لذا تحصل على مرونة متجر المستندات دون التضحية بأداء الاستعلام.

هذا يجعل JSONB مثالية للسمات المرنة أو المتغيرة والإعدادات وحمولات API والبيانات الندرة والمخططات المتطورة — احتياجات حديثة شائعة التي كانت ستتطلب قاعدة بيانات NoSQL أو تصاميم مخطط محرجة. فهم التمييز **JSONB مقابل JSON** (JSONB في معظم الحالات)، ومعاملات الاستعلام، **الفهرسة** (ضرورية لتحسين الأداء)، والمهم بشكل حاسم **متى يتم استخدام JSONB مقابل الأعمدة العادية** (JSONB للبيانات المرنة/المتغيرة/شبه المنظمة، الأعمدة العادية للبيانات المنظمة جيداً المستعلم عنها علائقياً — غالباً مزج كليهما) يعكس حكم تصميم ناضج.

نظراً لأن القدرة على التعامل مع البيانات المرنة وشبه المنظمة تصبح أكثر أهمية، وحيث يوفر JSONB هذا ضمن قاعدة بيانات علائقية قوية (غالباً ما تلغي الحاجة إلى متجر NoSQL منفصل)، فإن فهم JSONB — استعلاماتها وفهرستها والاستخدام المناسب لها — هو معرفة قيمة وذات صلة متكررة وهي السبب الرئيسي لشعبية PostgreSQL للتطبيقات الحديثة وعلامة مميزة للاستفادة الكاملة من قوة Postgres.