batchSize() (ضبط حجم جلب الدفعة)
آخر تحديث: 2026-10-09
batchSize() (ضبط حجم جلب الدفعة)
تضبط batchSize() عدد المستندات التي يسحبها المؤشر من الخادم لكل دفعة: `db.users.find().batchSize(100)`. تقايض جولات الطلب بالذاكرة: الدفعات الأكبر تعني طلبات أقل لكن ذاكرة أثقل لكل دفعة. عادةً يكفي الافتراضي؛ وضبط batchSize يساعد الإنتاجية على الروابط البطيئة أو مجموعات النتائج الضخمة.
| الفئة | المؤشر |
|---|---|
| إصدار MongoDB | 1.0+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
db.<collection>.find(<filter>).batchSize(<size>)⚙️ المعلمات
| عدد | عدد المستندات لكل دفعة؛ 0 يُعيد الافتراضي. |
|---|
القيمة المرجعة：المؤشر بعد تطبيق حجم الدفعة (قابل للتسلسل).
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// batchSize: جلب 50 لكل دفعة ومعالجتها أثناء التدفق
const cursor = db.users.find().batchSize(50)
cursor.forEach(doc => print(doc.name))المخرجات：
Alice
Bob
Cara📌 ملاحظات
- 0 تستعيد الافتراضي الخاص بالخادم
- الدفعات المفرطة تضخّم الذاكرة لكل نقل
- تقترن على الأفضل مع التدفق بـ forEach()
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qما batchSize التي ينبغي أن أستخدمها؟
Aالافتراضي عادةً كافٍ؛ زدها على الشبكات السريعة لجولات طلب أقل، واخفضها عندما تكون الذاكرة شحيحة.
Qكيف تختلف batchSize عن limit؟
Aتحدّ limit() إجمالي المستندات المُعادة؛ بينما تتحكم batchSize() فقط في حجم شريحة النقل مع بقاء الإجمالي كما هو.
Qماذا تعني batchSize(0)؟
A0 تستعيد حجم الدفعة الافتراضي للخادم.
