updateUser (تحديث مستخدم)
آخر تحديث: 2026-10-09
updateUser (تحديث مستخدم)
يعدّل updateUser مستخدمًا موجودًا: يعيد تعيين كلمة المرور، أو يستبدل الأدوار، أو يحدّث customData. تتغير فقط الحقول الممرَّرة؛ أما الأدوار فتُستبدل بالكامل بالقائمة الجديدة. في mongosh استدعِ db.updateUser(user, { pwd, roles, customData }). يتطلب userAdmin أو root.
| الفئة | مصادقة المستخدم |
|---|---|
| إصدار MongoDB | 1.0+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
db.updateUser("<username>", { pwd: "<new password>" })
db.updateUser("<username>", { roles: [ { role: "readWrite", db: "shop" } ] })⚙️ المعلمات
| pwd | كلمة المرور الجديدة. |
|---|---|
| roles | قائمة أدوار جديدة، تحلّ محل الأدوار القديمة بالكامل. |
| customData | بيانات وصفية مخصَّصة اعتباطية. |
القيمة المرجعة：يُرجع { ok: 1 } عند النجاح
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// updateUser: إعادة تعيين كلمة المرور وتحديد الأدوار
use admin
db.updateUser('reader', {
pwd: 'newpass456',
roles: [ { role: 'read', db: 'shop' }, { role: 'read', db: 'analytics' } ]
})المخرجات：
{ ok: 1 }📌 ملاحظات
- تتحدث الحقول التي تمررها فقط
- roles تستبدل القائمة كاملة — الأدوار القديمة المحذوفة تضيع
- يتطلب userAdmin أو root
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qهل تستبدل updateUser الأدوار؟
Aنعم — تستبدل الأدوار القائمة كلها، فأدرج كل دور تريد الإبقاء عليه.
Qكيف أغيّر كلمة المرور فقط؟
Aمرّر pwd فقط؛ كل شيء آخر يبقى كما هو.
Qما الصلاحيات التي يحتاجها هذا؟
AuserAdmin على قاعدة البيانات، أو root.
