🍃 مرجع دوال MongoDB بالعربي

find()

جلب عدّة مستندات

find() ترجع مؤشّرًا (cursor) على كل المستندات المطابقة لفلتر معيّن، أو كل المستندات إذا كان الفلتر فارغًا.

findOne()

جلب مستند واحد

findOne() ترجع أوّل مستند مطابق للفلتر مباشرة (كائن واحد)، لا cursor.

countDocuments()

عدّ المستندات المطابقة

countDocuments() ترجع العدد الدقيق للمستندات المطابقة لفلتر، عبر تنفيذ فعلي بدل الاعتماد على بيانات وصفية مخزَّنة.

distinct()

القيم الفريدة لحقل

distinct() ترجع مصفوفة بالقيم الفريدة (بدون تكرار) لحقل معيّن عبر المستندات المطابقة.

insertOne()

إدراج مستند واحد

insertOne() تضيف مستندًا واحدًا لمجموعة، وترجع _id المُنشأ تلقائيًّا إن لم تحدّده.

updateOne()

تحديث مستند واحد

updateOne() تعدّل أوّل مستند مطابق للفلتر، باستخدام معاملات تحديث مثل $set و$inc.

findOneAndUpdate()

تحديث وإرجاع المستند بعملية واحدة

findOneAndUpdate() تحدّث مستندًا وترجع نسخته (قبل أو بعد التعديل) بعملية ذرّية واحدة.

deleteOne()

حذف مستند واحد

deleteOne() تحذف أوّل مستند مطابق للفلتر فقط.

bulkWrite()

تنفيذ عدّة عمليات كتابة دفعة واحدة

bulkWrite() تنفّذ مزيجًا من عمليات insertOne وupdateOne وdeleteOne (وغيرها) في طلب واحد، بدل طلب منفصل لكل عملية.

aggregate()

تشغيل خط تجميع (Pipeline)

aggregate() تنفّذ سلسلة مراحل معالجة (pipeline) على المستندات، لبناء تقارير وتحويلات معقّدة داخل قاعدة البيانات.

createIndex()

إنشاء فهرس

createIndex() تبني فهرسًا على حقل أو أكثر لتسريع الاستعلامات التي تصفّي أو ترتّب حسبه.

explain()

تحليل خطّة تنفيذ الاستعلام

explain() ترجع تفاصيل عن كيفية تنفيذ MongoDB لاستعلام معيّن فعليًّا — هل استخدم فهرسًا أم فحص كل المستندات.