$lookup (ربط المجموعات)

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

$lookup (ربط المجموعات)

يُجري $lookup ربطًا خارجيًا أيسر بين المجموعة الحالية ومجموعة أخرى، مرفقًا المستندات المطابقة كمصفوفة بكل نتيجة. وهو مكافئ LEFT JOIN في SQL، ويتيح لخطوط الأنابيب دمج البيانات عبر المجموعات دون استعلامات متعددة. لاحظ أنه يدعم مطابقة المساواة فقط — دون ربط بالنطاقات أو الشروط.

📝 الصيغة

{ $lookup: { from: <collection>, localField: <local-field>, foreignField: <foreign-field>, as: <output-array> } }

▶ مثال

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

// $lookup: ربط الطلبات بالعملاء
db.orders.aggregate([
  { $lookup: {
      from: "customers",
      localField: "cust_id",
      foreignField: "_id",
      as: "customer"
  } }
])

المخرجات：

{ "_id": 1, "cust_id": "A123", "customer": [{ "_id": "A123", "name": "Alice" }] }

📌 ملاحظات

• يجب أن تشير from إلى مجموعة في نفس قاعدة البيانات
• يجب أن تتطابق أسماء الحقول تمامًا وتتوافق الأنواع بين localField و foreignField
• عدم وجود مطابقة يعطي مصفوفة فارغة []، وليس null
• منذ 3.6، يدعم $lookup خط أنابيب داخلي (حقل pipeline) لربط أغنى؛ ومن 5.0 تزيل صيغة الاستعلام الفرعي المترابط المختصرة الحاجة إلى $expr

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

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

📚 دروس ذات صلة

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

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

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

من نحن