$project (الإسقاط)

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

$project (الإسقاط)

$project هو مرحلة الإسقاط: يختار الحقول أو يستبعدها أو يحسب حقولًا جديدة، معينًا كل مستند بشكلًا جديدًا. وعلى خلاف $addFields، يخرج افتراضيًا _id والحقول المدرجة صراحةً فقط: 1 يتضمن، 0 يستبعد، والتعبير ينشئ حقلًا جديدًا. استخدمه لتقليص المستندات أو إعادة تسمية الحقول أو تسطيح الكائنات المضمنة. لا يمكن خلط الإدراج والاستبعاد (باستثناء _id).

📝 الصيغة

{ $project: { <field>: <1 or 0 or expression>, ... } }

⚙️ المعلمات

القيمة المرجعة：تدفق مستندات مُسقَط

▶ مثال

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

// $project: إبقاء name وحساب total
db.orders.aggregate([
  { $project: { _id: 0, name: 1, total: { $multiply: ['$price', '$qty'] } } }
])

المخرجات：

// كل مستند أصبح يحتوي الآن name وtotal فقط
{ "name": "Pen", "total": 150 }
{ "name": "Book", "total": 30 }

📌 ملاحظات

• $project قائمة بيضاء: الحقول غير المدرجة تُسقط
• لا يمكن خلط الإدراج والاستبعاد (باستثناء _id)
• المسارات النقطية مثل 'detail.price' تعيد تسمية الحقول المضمنة أو تسطّحها

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

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

📚 دروس ذات صلة

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

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

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

من نحن