maxTimeMS() (ضبط حد الوقت)
آخر تحديث: 2026-10-09
maxTimeMS() (ضبط حد الوقت)
تحدّ maxTimeMS() المدة القصوى لتشغيل عملية مؤشر، بالمللي ثانية: `db.users.find().maxTimeMS(5000)`. بعد تجاوز الحد، يُجهض الخادم العملية ويرفع خطأً — حارس ضد الاستعلامات البطيئة التي تحتكر الموارد. وهو مهلة صارمة على الخادم، تختلف عن مهلات المقبس على جانب المشغّل.
| الفئة | المؤشر |
|---|---|
| إصدار MongoDB | 1.0+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
db.<collection>.find(<filter>).maxTimeMS(<ms>)⚙️ المعلمات
| الميلي ثانية | أقصى وقت للتنفيذ بالمللي ثانية. |
|---|
القيمة المرجعة：المؤشر بعد تطبيق الحد الزمني (قابل للتسلسل).
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// maxTimeMS: تحديد الاستعلام بـ 5 ثوانٍ
const result = db.users.find()
.maxTimeMS(5000)
.toArray()
result.lengthالمخرجات：
1000📌 ملاحظات
- يُجهض الخادم العملية ويرفع خطأً عند انتهاء المهلة
- الوحدة مللي ثانية — 5000 تعني خمس ثوانٍ
- تنطبق على التجميعات وكتابات نمط findAndModify أيضًا
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qماذا يحدث عند تجاوز maxTimeMS؟
Aيقتل الخادم العملية ويرفع خطأ مهلة — التقطه بـ try/catch.
Qما الوحدة التي تستخدمها maxTimeMS؟
Aالمللي ثانية. maxTimeMS(1000) تعني ثانية واحدة على الأكثر.
Qهل maxTimeMS مثل مهلة المشغّل؟
Aلا — maxTimeMS حد صارم على جانب الخادم يقتل العملية؛ مهلة المشغّل توقف انتظار العميل فقط.
