aggregate() (خط أنابيب التجميع)

آخر تحديث: 2026-10-09

aggregate() (خط أنابيب التجميع)

تشغّل aggregate() خط أنابيب متعدد المراحل يجمع المستندات ويحسبها ويعيد تشكيلها، مثل `db.users.aggregate([{ $group: { _id: '$city', total: { $sum: 1 } } }])`. تحوّل المراحل مثل $match و $group و $sort و $project البيانات بالتتابع. وهي أقوى بكثير من find()، والخيار الأول للتقارير والجداول المحورية. يعمل خط الأنابيب على الخادم ويُعيد مؤشرًا (أو نتائج مباشرة).

📝 الصيغة

db.<collection>.aggregate(<pipeline>, { allowDiskUse: <bool> })

⚙️ المعلمات

القيمة المرجعة：مؤشر على نتائج التجميع؛ فارغ عندما يكتب ‏$out/$merge إلى مجموعة.

▶ مثال

نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):

// aggregate: عدّ المستخدمين مجمّعين حسب المدينة
const result = db.users.aggregate([
  { $group: { _id: '$address.city', total: { $sum: 1 } } },
  { $sort: { total: -1 } }
])
result.toArray()

المخرجات：

[
  { _id: 'Beijing', total: 12 },
  { _id: 'Shanghai', total: 8 }
]

📌 ملاحظات

• ترتيب المراحل مهم — ضع $match مبكرًا للتصفية في أقرب وقت ممكن
• تبلغ المراحل حد الذاكرة الافتراضي 100 ميجابايت؛ تجاوزه بـ allowDiskUse: true
• أشر إلى الحقول الأصلية داخل _id الخاص بـ $group ببادئة $، مثل '$age'

🏷️ وسوم ذات صلة

💡 حالات ذات صلة

📚 دروس ذات صلة

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

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

من نحن