Menu

string_agg وarray_agg في PostgreSQL (بديل GROUP_CONCAT)

تدمج string_agg قيم المجموعة في نص واحد، وتجمعها array_agg في مصفوفة. الترتيب وDISTINCT وFILTER والتعامل مع NULL والأخطاء الشائعة.

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

تدمج string_agg(expression, separator) قيم كل مجموعة في نص واحد، وتجمعها array_agg(expression) في مصفوفة. ضع ORDER BY داخل الاستدعاء لتتحكم في الترتيب: string_agg(name, ', ' ORDER BY name).

يعيد IT ‏Bo, Kim, Li و{6100,4800,3900}، ويعيد Sales ‏Ana, Raj و{5000,4200}. والدالتان دالتا تجميع عاديتان مثل count وsum: تعملان لكل مجموعة مع GROUP BY، وعلى الجدول كله دونه.

ترتيب القيم

دون ORDER BY داخل دالة التجميع، تأتي القيم بأي ترتيب تصل به الصفوف، وقد يتغير من تشغيل إلى آخر. وORDER BY في نهاية الاستعلام يرتّب صفوف النتيجة، لا القيم داخل كل نص. ويأتي ORDER BY الداخلي بعد آخر وسيط، دون فاصلة:

string_agg(name, ', ' ORDER BY hired_on DESC)
array_agg(name ORDER BY score DESC, name)

حذف التكرارات باستخدام DISTINCT

اشترت Ada قلمًا مرتين، لكن DISTINCT يسرده مرة واحدة: book, pen. ومع DISTINCT لا يستطيع ORDER BY استخدام إلا القيمة المجمّعة، والترتيب بعمود آخر يفشل بالخطأ "in an aggregate with DISTINCT, ORDER BY expressions must appear in argument list".

كيف يتصرف NULL والمجموعات الفارغة

تتخطى string_agg قيم NULL وتعيد Bo, Li، بينما تحتفظ بها array_agg: ‏{Bo,Li,NULL}. ولإسقاط NULL من array_agg أضف FILTER (WHERE name IS NOT NULL).

على صفر من الصفوف تعيد الدالتان NULL، لا نصًا فارغًا ولا مصفوفة فارغة. غلّفهما حين تتوقع الشيفرة المستدعية قيمة: COALESCE(string_agg(...), '') أو COALESCE(array_agg(...), '{}').

تجميع بعض الصفوف فقط باستخدام FILTER

يحصر FILTER (WHERE ...) دالة تجميع واحدة في الصفوف المطابقة، بينما يرى باقي الاستعلام الصفوف كلها:

في IT ثلاثة أشخاص والقائمة Bo, Li، وفي Sales شخصان والقائمة Ana.

إرفاق قائمة بكل صف من جدول آخر

لعرض كل عميل مع قائمة منتجاته، اجمع في استعلام فرعي، فلا يحتاج الاستعلام الخارجي إلى GROUP BY:

SELECT c.id, c.name, c.email,
       (SELECT string_agg(o.product, ', ' ORDER BY o.product)
        FROM orders o
        WHERE o.customer_id = c.id) AS products
FROM customers c;

يبقى العملاء الذين ليست لديهم طلبات في النتيجة، وقيمة products لهم NULL. أما الربط مع GROUP BY فلا يحتفظ بهم إلا إذا كان LEFT JOIN.

أخطاء شائعة وأشكال أخرى

  • الأرقام: تأخذ string_agg نصًا، فيفشل string_agg(id, ',') بالخطأ "function string_agg(integer, unknown) does not exist". حوّل القيمة: string_agg(id::text, ',').
  • أول N في كل مجموعة: اقتطع المصفوفة المرتّبة: (array_agg(name ORDER BY salary DESC))[1:2].
  • مخرجات JSON: تجمع json_agg وjsonb_agg الصفوف في مصفوفة JSON، وتبني jsonb_object_agg(key, value) كائنًا، راجع JSONB.
  • لديك مصفوفة أصلًا: تدمج array_to_string(arr, ', ') مصفوفة موجودة، وتعيدها unnest إلى صفوف (المصفوفات).
  • صيغة النافذة: تعمل الدالتان كدوال نوافذ أيضًا، مثل string_agg(name, ', ') OVER (PARTITION BY dept) لعرض القائمة كاملة في كل صف.

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

ما مقابل GROUP_CONCAT في PostgreSQL؟

string_agg(column, ','). وعلى عكس GROUP_CONCAT في MySQL، الفاصل إلزامي، والترتيب يُكتب داخل الاستدعاء: string_agg(name, ', ' ORDER BY name).

كيف أستخدم string_agg مع الأرقام؟

حوّل القيمة إلى نص: string_agg(id::text, ','). لا تقبل string_agg إلا النصوص (أو bytea)، فيفشل الوسيط العددي بالخطأ "function string_agg(integer, unknown) does not exist".

هل لـ string_agg حد للطول؟

لا يوجد حد خاص بها، فالنتيجة قيمة text عادية تتسع حتى 1 GB. يقتطع GROUP_CONCAT في MySQL النص عند group_concat_max_len، أما PostgreSQL فلا يقتطع.

كيف أحصل على أول N قيم باستخدام array_agg؟

رتّب داخل دالة التجميع واقتطع النتيجة: يعيد (array_agg(name ORDER BY score DESC))[1:3] أعلى ثلاثة أسماء في كل مجموعة.

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

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

ابدأ الآن