Menu

الفهارس في PostgreSQL: ‏CREATE INDEX وأنواعها وأمثلة

يبني CREATE INDEX فهرس B-tree افتراضيًا ليجد PostgreSQL الصفوف دون قراءة الجدول كله. وتغطي الأنواع الأخرى (GIN وGiST وBRIN وhash) ‏JSONB والمصفوفات والبحث النصي الكامل والنطاقات والجداول الضخمة.

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

يبني CREATE INDEX name ON table (column); فهرسًا يتيح لـ PostgreSQL إيجاد الصفوف المطابقة دون قراءة الجدول كله. النوع الافتراضي B-tree، ويخدم = و< و> وBETWEEN وIN وIS NULL وORDER BY. واختر نوعًا آخر بـ USING: ‏gin أو gist أو spgist أو brin أو hash.

السطر الأول في الخطة هو Index Scan using users_email_idx on users: يبحث PostgreSQL عن القيمة في الفهرس ولا يقرأ إلا الصف المطابق. احذف سطر CREATE INDEX وشغّل الاستعلام مجددًا لترى Seq Scan on users، الذي يقرأ الصفوف الـ 10,000 كلها.

على جدول من بضع عشرات من الصفوف، يختار المخطِّط غالبًا المسح التسلسلي حتى مع وجود فهرس: قراءة صفحات قليلة أرخص. تشرح EXPLAIN ANALYZE كيف تقرأ هذه الخطط.

اختيار نوع الفهرس

النوعاستخدمه لـ
B-tree (الافتراضي)المساواة، والنطاقات، والترتيب، وLIKE 'prefix%' (مع الترتيب C أو text_pattern_ops)
GINالقيم المكوّنة من أجزاء كثيرة: jsonb (@>، ?)، والمصفوفات (@>، &&)، وtsvector للبحث النصي الكامل
GiSTالهندسة، والنطاقات (&&، التداخل)، والبحث النصي الكامل، وأقرب جار ORDER BY ... <->
SP-GiSTبيانات تنقسم إلى مناطق غير متداخلة: النقاط، وعناوين IP، وبادئات النصوص
BRINالجداول الضخمة التي تتبع قيمها الترتيب الفعلي، مثل created_at في جدول لا يُضاف إليه إلا في النهاية
Hashالمساواة فقط، وB-tree يؤدي العمل نفسه وأكثر، لذا نادرًا ما يُختار

يجعل فهرس GIN على عمود jsonb استعلامات الاحتواء تستخدم الفهرس:

تُظهر الخطة Bitmap Index Scan على فهرس GIN، يغذّي Bitmap Heap Scan الذي يقرأ الصفوف المطابقة. تشرح صفحة JSONB معاملاته.

فهرسة عدة أعمدة

يرتّب فهرس B-tree متعدد الأعمدة بحسب العمود الأول، ثم بحسب الثاني داخل كل قيمة من الأول. ويخدم الاستعلامات التي تصفّي بالعمود الأول، أو بالأول وما يليه. أما التصفية بالعمود الثاني وحده فلا تستفيد منه كثيرًا، لذا ضع أولًا العمود الذي تصفّي به دائمًا بـ =.

CREATE INDEX orders_customer_created_idx ON orders (customer_id, created_at);

-- served well by the index above
SELECT * FROM orders WHERE customer_id = 7 AND created_at > '2026-01-01';
SELECT * FROM orders WHERE customer_id = 7 ORDER BY created_at DESC LIMIT 10;

يخزّن INCLUDE ‏(PostgreSQL 11+) أعمدة إضافية في الفهرس دون الترتيب بحسبها: CREATE INDEX ON orders (customer_id) INCLUDE (total);. فيمكن الإجابة عن استعلام لا يقرأ إلا هذه الأعمدة من الفهرس وحده، وهو Index Only Scan.

الفهارس الفريدة والجزئية: فرض قاعدة على بعض الصفوف

يرفض CREATE UNIQUE INDEX القيم المكررة. ويضيف الفهرس الجزئي WHERE فلا يفهرس إلا الصفوف المطابقة له. وهو أصغر، ويمكن أن يجعل قاعدة التفرّد تنطبق على مجموعة فرعية من الصفوف:

يُقبل الصفّان لأن واحدًا منهما فقط غير محذوف. وأي صف حيّ ثالث بالبريد نفسه يفشل بالخطأ duplicate key value violates unique constraint "accounts_email_live". ولا يستخدم الاستعلام الفهرس الجزئي إلا حين يستلزم WHERE فيه شرط الفهرس، وهنا WHERE NOT deleted.

فهرسة تعبير

يستطيع الفهرس تخزين نتيجة تعبير. ويجب أن يكرر الاستعلام التعبير نفسه ليستخدمه، فالفهرس على email لا يساعد WHERE lower(email) = ...:

تستخدم الخطة users_email_lower_idx لأن WHERE يكرر lower(email) بالضبط. ويجب أن يكون التعبير immutable، لذا تُرفض now() أو أي دالة تعتمد على إعداد.

عرض الفهارس وبناؤها وحذفها على قاعدة بيانات عاملة

يسرد pg_indexes كل فهرس مع الجملة التي تعيد إنشاءه:

أنشأ المفتاح الأساسي وقيد UNIQUE فهرسيهما الخاصين: users_pkey وusers_email_key. وفي psql يعرض \d users القائمة نفسها تحت أعمدة الجدول.

على جدول يستقبل عمليات كتابة، ابنِ الفهارس واحذفها مع CONCURRENTLY حتى لا تُحجب الكتابة. ولا يمكن تشغيل هذه الصيغ داخل كتلة معاملة. والبناء المتزامن الفاشل يترك فهرسًا INVALID يجب حذفه وإنشاؤه من جديد:

CREATE INDEX CONCURRENTLY orders_status_idx ON orders (status);
DROP INDEX CONCURRENTLY orders_status_idx;
REINDEX INDEX CONCURRENTLY orders_status_idx;  -- rebuild a bloated index

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

هل ينشئ PostgreSQL الفهارس تلقائيًا؟

فقط لقيود PRIMARY KEY وUNIQUE والاستبعاد (exclusion). لا يحصل عمود المفتاح الأجنبي على فهرس، فأضفه بنفسك حين تربط عليه أو تحذف صفوفًا من الجدول المشار إليه.

لماذا لا يستخدم PostgreSQL الفهرس الذي أنشأته؟

أسباب شائعة: الجدول صغير فقراءته كاملًا أرخص، أو يعيد الاستعلام نسبة كبيرة من الصفوف، أو يغلّف WHERE العمود بدالة أو تحويل غير موجود في الفهرس، أو الإحصاءات قديمة (نفّذ ANALYZE). ويُظهر EXPLAIN الخطة التي اختيرت.

كم فهرسًا يُعدّ أكثر من اللازم؟

لا يوجد رقم ثابت. كل فهرس يسرّع بعض القراءات ويبطئ كل INSERT ومعظم UPDATE على الجدول، ويشغل مساحة على القرص. ويُظهر pg_stat_user_indexes.idx_scan عدد مرات استخدام كل فهرس، فتستطيع حذف ما يبقى عند الصفر.

هل يقفل CREATE INDEX الجدول؟

يحجب CREATE INDEX العادي ‏INSERT وUPDATE وDELETE على الجدول حتى ينتهي، لكن القراءة تستمر. أما CREATE INDEX CONCURRENTLY فيسمح بالكتابة أثناء البناء، ويستغرق وقتًا أطول، ولا يمكن تشغيله داخل كتلة معاملة.

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

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

ابدأ الآن