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