runCommand() (تنفيذ أمر)
آخر تحديث: 2026-10-09
runCommand() (تنفيذ أمر)
تنفّذ db.runCommand() أي أمر قاعدة بيانات في mongosh — نقطة الدخول العامة للأوامر منخفضة المستوى دون مساعدات مخصصة (serverStatus, collStats, currentOp). أغلب الأوامر لها طرق مساعدة (مثل db.collection.stats())، لكن runCommand تمنح تحكمًا كاملًا.
| الفئة | أوامر الإدارة |
|---|---|
| إصدار MongoDB | 1.0+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
db.runCommand({ <command>: <args>, ... })⚙️ المعلمات
| اسم الأمر | الحقل الأول في مستند الأمر؛ قيمته هي كائن الوسيطات. |
|---|
القيمة المرجعة：مستند نتيجة الأمر مع ok (1 نجاح، 0 فشل) بالإضافة إلى حقول خاصة بالأمر
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// runCommand: إحصاءات قاعدة البيانات
db.runCommand({ dbStats: 1 })
// إحصاءات المجموعة
db.runCommand({ collStats: "orders" })المخرجات：
{
db: "shop",
collections: 5,
objects: 1200,
dataSize: 48213,
ok: 1
}📌 ملاحظات
- الحقل الأول هو اسم الأمر وقيمته هي الوسيط
- ok: 1 تعني نجاحًا؛ ok: 0 فشلًا (errmsg يحمل السبب)
- أغلب الأوامر لها مساعدات — فضّلها لقابلية القراءة
- الصلاحيات غير الكافية تولّد أخطاء غير مصرّح بها
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qكيف ترتبط runCommand وطرق المساعدة؟
Aالمساعدات مثل db.stats() تستدعي runCommand داخليًا، ملفّفة الوسائط وتحليل النتيجة. runCommand هي نقطة الدخول العامة الأساس.
Qكيف أرى مخرجات مساعدة أمر؟
Aأضف $help: 1 إلى الوسائط، مثل db.runCommand({ serverStatus: 1, $help: 1 }).
Qلماذا تتطلب بعض الأوامر adminCommand؟
Aالأوامر بنطاق الإدارة (renameCollection, setParameter, ...) تقع على قاعدة بيانات admin وتتطلب db.adminCommand.
