$match (تصفية المستندات)

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

$match (تصفية المستندات)

يصفّي $match المستندات بشرط استعلام، ممررًا المطابقة منها فقط إلى المراحل اللاحقة. وهو المكافئ التجميعي لمسند استعلام find(). ضع $match في أقرب موضع ممكن — يمكنه استخدام الفهارس ويقلل عدد المستندات الداخلة إلى المراحل اللاحقة، مما يجعله القاعدة رقم 1 لأداء التجميع.

📝 الصيغة

{ $match: { <query> } }

⚙️ المعلمات

القيمة المرجعة：تدفق مستندات مُرشَّح (للمرحلة التالية)

▶ مثال

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

// $match: الطلبات ذات الحالة A فقط
db.orders.aggregate([
  { $match: { status: "A" } },
  { $group: { _id: "$cust_id", total: { $sum: "$amount" } } }
])

المخرجات：

// يُرجع الإجمالي لكل عميل
{ "_id": "A123", "total": 250 }
{ "_id": "B456", "total": 130 }

📌 ملاحظات

• ضع $match أولًا للاستفادة من الفهارس
• لا يمكن استخدام $where أو $text داخل $match ($text يجب أن يكون المرحلة الأولى)
• تتوقف تحسينات الفهرس بعد مرحلة $match

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

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

📚 دروس ذات صلة

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

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

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

من نحن