تدمج 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] أعلى ثلاثة أسماء في كل مجموعة.