renameCollection (إعادة تسمية مجموعة)
آخر تحديث: 2026-10-09
renameCollection (إعادة تسمية مجموعة)
تعيد renameCollection تسمية مجموعة داخل قاعدة بيانات أو عبرها، ويجب تشغيلها على قاعدة بيانات admin (db.adminCommand). تنقل إعادة التسمية المجموعة مع فهارسها وبياناتها الوصفية؛ وتُحجَب الكتابة عليها لفترة وجيزة. dropTarget: true يستبدل هدفًا موجودًا (خطير — تُحذف البيانات).
| الفئة | أوامر الإدارة |
|---|---|
| إصدار MongoDB | 1.0+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
db.adminCommand({
renameCollection: "<db>.<collection>",
to: "<db>.<new name>",
dropTarget: false
})⚙️ المعلمات
| renameCollection | المجموعة المصدر بصيغة db.collection. |
|---|---|
| to | الهدف بصيغة db.collection. |
| dropTarget | اضبط true لاستبدال هدف موجود؛ استخدمه بحذر. |
القيمة المرجعة：يُرجع { ok: 1 } عند النجاح
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// renameCollection: إعادة تسمية مجموعة
db.adminCommand({
renameCollection: 'shop.orders_2025',
to: 'shop.orders'
})المخرجات：
{ ok: 1 }📌 ملاحظات
- يجب تشغيله على قاعدة بيانات admin بأسماء مؤهلة بالكامل
- dropTarget: true يحذف الهدف — تعامل معه بحذر
- تتوقف الكتابة إلى المجموعة لفترة وجيزة أثناء إعادة التسمية
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qهل يمكن أن تنقل renameCollection مجموعات عبر قواعد البيانات؟
Aنعم — أهّل الاسمين كـ db.collection.
Qهل تفقد إعادة التسمية البيانات؟
Aلا، ما لم يستبدل dropTarget: true هدفًا موجودًا.
Qهل تنجو الفهارس من إعادة التسمية؟
Aنعم — تنتقل الفهارس مع البيانات.
