$bucket (المجموعات)

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

$bucket (المجموعات)

يجمع $bucket المستندات في مجموعات محددة بمصفوفة حدود تصاعدية، مصدرًا مستندًا واحدًا { _id: lowerBound, count: N } لكل مجموعة، مع مُراكمات مخرجات اختيارية. المستندات خارج كل الحدود تسقط في المجموعة الافتراضية. مثالي للمدرجات التكرارية وإحصائيات النطاق.

📝 الصيغة

{ $bucket: { groupBy: <expression>, boundaries: [ <lowerBound>, ... ], default: <value>, output: { <field>: <accumulator> } } }

⚙️ المعلمات

القيمة المرجعة：مستند واحد { _id, count, ... } لكل حاوية (bucket)

▶ مثال

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

// $bucket: تقسيم الدرجات إلى نطاقات، بمتوسط لكل مجموعة
db.scores.aggregate([
  { $bucket: {
    groupBy: '$score',
    boundaries: [0, 60, 80, 100],
    default: 'other',
    output: { avg: { $avg: '$score' } }
  } }
])

المخرجات：

{ "_id": 0, "count": 12, "avg": 35.5 }
{ "_id": 60, "count": 20, "avg": 71.2 }

📌 ملاحظات

• يجب أن تكون boundaries تصاعدية مع قيمتين على الأقل
• النطاقات نصف مفتوحة: تقع القيم في [boundaries[i], boundaries[i+1])
• المستندات خارج النطاق تذهب إلى default، أو تُسقط إذا حُذف

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

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

📚 دروس ذات صلة

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

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

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

من نحن