Menu

المصفوفات في PostgreSQL: ‏ANY والاحتواء (@>) وunnest

أعمدة المصفوفات في PostgreSQL: تعريفها، والفهرسة من 1، والتحقق من احتواء المصفوفة على قيمة بـ ANY و@> و&&، وunnest، ودوال المصفوفات التي تحتاجها.

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

يمكن لأي نوع في PostgreSQL أن يكون مصفوفة. عرّف العمود بـ text[] أو int[]، واكتب القيم بالشكل '{a,b}' أو ARRAY['a', 'b']، واقرأ العناصر بـ tags[1] (تبدأ الفهارس من 1). وللتحقق من أن مصفوفة تحتوي على قيمة استخدم 'value' = ANY(tags) أو tags @> ARRAY['value'].

يحمل المنشوران 1 و2 الوسم sql. tags[1] هو العنصر الأول، وcardinality تعدّ العناصر. والصيغتان الحرفيتان تخزّنان القيمة نفسها، وARRAY[...] أسهل حين تأتي العناصر من تعبيرات أو تحتوي على فواصل.

التحقق من احتواء مصفوفة على قيمة

أربعة معاملات تغطي الانتماء:

الاختبارالمعنىtrue لـ '{sql,json}'
'sql' = ANY(tags)قيمة واحدة موجودة في المصفوفةنعم
tags @> '{sql,json}'المصفوفة تحتوي على كل هذه القيمنعم
tags <@ '{sql,json,go}'كل عنصر موجود في هذه القائمةنعم
tags && '{go,json}'تشترك المصفوفتان في عنصر واحد على الأقلنعم

وحده المنشور 1 يحمل الوسمين. ويشترك المنشوران 2 و3 في عنصر مع {go,json}. والمنشور 3 هو الوحيد الذي يكون فيه no_go ‏false. وALL هو مقابل ANY: يجب أن تتحقق المقارنة لكل عنصر.

يتبع = ANY قواعد NULL في SQL. فإذا لم تُوجد القيمة وكانت المصفوفة تحتوي على NULL، تكون النتيجة NULL لا false. لذا قد يُسقط WHERE NOT ('x' = ANY(tags)) صفوفًا كنت تتوقعها. أما @> و&& فيعيدان true أو false.

يجعل فهرس GIN المعاملات @> و<@ و&& و= سريعة على الجداول الكبيرة. لكنه لا يساعد = ANY(column)، فللبحث المفهرس اكتب tags @> ARRAY['sql']:

CREATE INDEX posts_tags_idx ON posts USING gin (tags);

تحويل مصفوفة إلى صفوف باستخدام unnest

تعيد unnest صفًا لكل عنصر، فتستطيع العدّ أو الربط أو التصفية بحسب العناصر المنفردة:

يظهر sql في منشورين، وبقية الوسوم في منشور واحد لكل منها. أضف WITH ORDINALITY (unnest(tags) WITH ORDINALITY AS t(tag, pos)) لتحصل أيضًا على موضع كل عنصر. ولجمع الصفوف في مصفوفة من جديد استخدم array_agg (راجع string_agg وarray_agg).

إضافة العناصر وحذفها وتغييرها

يعيد هذا {1,2,3} و{1,2,3,4} و{2,3} و{1,9,3} و2 و{20,30} وa, b, c. وفي UPDATE تغيّر الدوال نفسها مصفوفة مخزّنة: SET tags = array_append(tags, 'new') أو SET tags = array_remove(tags, 'old'). تحذف array_remove كل نسخ القيمة، وتقسم string_to_array('a,b,c', ',') نصًا إلى مصفوفة.

معرفة طول المصفوفة

تعيد cardinality(tags) عدد العناصر، و0 للمصفوفة الفارغة. وتعيد array_length(tags, 1) طول البُعد 1، وNULL للمصفوفة الفارغة. لذا لا يطابق WHERE array_length(tags, 1) = 0 أبدًا. اختبر المصفوفة الفارغة بـ cardinality(tags) = 0 أو tags = '{}'.

يمكن أن تكون للمصفوفات في PostgreSQL أكثر من بُعد (int[][])، لكن يجب أن تكون المصفوفات الفرعية كلها بالطول نفسه، والحجم المعلن (int[3]) لا يُفرض. وللبيانات المتداخلة أو غير المنتظمة يكون JSONB أنسب عادةً.

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

هل تبدأ المصفوفات في PostgreSQL من 0 أم من 1؟

من 1 افتراضيًا: tags[1] هو العنصر الأول. والفهرس الذي يتجاوز النهاية يعيد NULL بدل رفع خطأ.

ما الفرق بين IN و= ANY في PostgreSQL؟

يأخذ x IN (1, 2, 3) قائمة مكتوبة في الاستعلام، ويأخذ x = ANY(array) قيمة مصفوفة واحدة. يناسب ANY شيفرة التطبيق، لأنك تمرر معامل مصفوفة واحدًا (WHERE id = ANY($1)) بدل بناء قائمة من العناصر النائبة.

هل أستخدم عمود مصفوفة أم جدولًا منفصلًا؟

تناسب المصفوفة قائمة قصيرة تقرؤها وتكتبها مع صفها، مثل الوسوم. وحين تحتاج العناصر إلى أعمدة خاصة بها أو مفاتيح أجنبية، أو تُحدَّث واحدًا واحدًا، يكون الجدول المنفصل بصف لكل عنصر أسهل في الاستعلام والتقييد.

كيف أتحقق من أن مصفوفة فارغة في PostgreSQL؟

استخدم cardinality(arr) = 0 أو arr = '{}'. لا يطابق array_length(arr, 1) = 0 أبدًا، لأن array_length تعيد NULL للمصفوفة الفارغة.

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

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

ابدأ الآن