$addFields (إضافة حقول)

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

$addFields (إضافة حقول)

يضيف $addFields حقولًا جديدة إلى كل مستند أو يستبدل حقولًا موجودة فيه مع الإبقاء على كل الحقول الأخرى. وعلى خلاف $project — الذي يسقط الحقول غير المدرجة افتراضيًا — لا يزيد $addFields المستند إلا نموًّا. يمكن أن تكون القيم الجديدة أي تعبير تجميع، وغالبًا محسوبة من نتائج $lookup. منذ MongoDB 3.4 فهو مكافئ لـ $set.

📝 الصيغة

{ $addFields: { <newField>: <expression>, ... } }

⚙️ المعلمات

القيمة المرجعة：تدفق مستندات مع حقول مضافة أو مستبدَلة

▶ مثال

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

// $addFields: إضافة حقل total
db.sales.aggregate([
  { $addFields: { total: { $multiply: ['$price', '$qty'] } } }
])

المخرجات：

// كل الحقول الأصلية محفوظة، بالإضافة إلى total
{ "item": "Pen", "price": 50, "qty": 3, "total": 150 }

📌 ملاحظات

• $addFields لا يزيل الحقول الموجودة أبدًا
• المسارات النقطية مثل 'order.amount' تخاطب الحقول المضمنة
• داخل مرحلة واحدة لا يمكنك الرجوع إلى الحقول المعرّفة في نفس المرحلة

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

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

📚 دروس ذات صلة

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

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

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

من نحن