$documents (مستندات حرفية)
آخر تحديث: 2026-10-09
$documents (مستندات حرفية)
يُرجع $documents مصفوفة معطاة من مستندات حرفية دون قراءة أي مجموعة — مدخل خط أنابيب حرفي. يجب أن يكون المرحلة الأولى، مفيدًا لبيانات الاختبار أو تشغيل التعبيرات على ثوابت. يمر كل مستند دون تغيير.
| الفئة | المراحل الأساسية |
|---|---|
| إصدار MongoDB | 5.2+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
{ $documents: [ { <doc1> }, { <doc2> }, ... ] }⚙️ المعلمات
| مصفوفة مستندات | قائمة المستندات الحرفية المراد إخراجها. |
|---|
القيمة المرجعة：تدفق مستندات حرفي
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// $documents: التحقق من التعبيرات على بيانات حرفية
db.aggregate([
{ $documents: [{ x: 1 }, { x: 2 }] },
{ $addFields: { y: { $add: ['$x', 1] } } }
])المخرجات：
{ "x": 1, "y": 2 }
{ "x": 2, "y": 3 }📌 ملاحظات
- يجب أن يكون المرحلة الأولى من خط الأنابيب
- لا يقرأ بيانات مجموعة — مدخل حرفي خالص
- رائع لاختبار التعبيرات وبناء بيانات مرجعية
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qهل يمكن أن يظهر $documents في منتصف خط الأنابيب؟
Aلا، يجب أن يأتي أولًا؛ تتبعه أي مراحل أخرى.
Qلما يُستخدم $documents؟
Aلبناء بيانات اختبار والتحقق من تعبيرات التجميع في mongosh دون مجموعة حقيقية.
Qما الفرق بين db.aggregate و db.coll.aggregate؟
Aيعمل db.aggregate دون مجموعة؛ يجب أن تكون مرحلته الأولى خاصة، مثل $documents أو $currentOp.
