المرجع

آخر تحديث: 2026-10-09

المرجع

قائمة أبجدية بـ 311 عنصرًا من MongoDB مع شرح الاستخدام.

#
$eq	يقوم $eq باختيار المستندات التي تكون قيمة حقلها مساوية لقيمة محددة. وهو أكثر مسندات المطاب...
$ne	يقوم $ne باختيار المستندات التي لا تساوي قيمة حقلها قيمة محددة — وهو نفي $eq. فالعبارة `{ ...
$in	يقوم $in باختيار المستندات التي تساوي قيمة حقلها أي قيمة من مصفوفة معينة — وهو اختصار مناس...
$set	يقوم $set بتعيين (أو استبدال) قيمة حقل واحد أو أكثر في مستند. ينشئ الحقل إذا لم يكن موجودً...
$inc	يقوم $inc بزيادة (أو إنقاص) حقل رقمي بمقدار محدد، وينشئ الحقل بالمقدار إذا لم يكن موجودًا....
$gt	يقوم $gt باختيار المستندات التي تكون قيمة حقلها أكبر من قيمة محددة بشكل صارم. فالعبارة `{ ...
$gte	يقوم $gte باختيار المستندات التي تكون قيمة حقلها أكبر من قيمة محددة أو تساويها. فالعبارة `...
$lt	يقوم $lt باختيار المستندات التي تكون قيمة حقلها أصغر من قيمة محددة بشكل صارم. فالعبارة `{ ...
$lte	يقوم $lte باختيار المستندات التي تكون قيمة حقلها أصغر من قيمة محددة أو تساويها. فالعبارة `...
$nin	يقوم $nin باختيار المستندات التي لا تساوي قيمة حقلها أي قيمة من المصفوفة المعطاة — وهو نفي...
$and	يجمع $and عدة مسندات استعلام؛ ويجب أن يحقق المستند جميعها. `{ $and: [ { price: { $gt: 10 }...
$or	يجمع $or مسندات الاستعلام؛ يطابق المستند إذا حقق أيًا منها. `{ $or: [ { price: { $lt: 5 } ...
$not	ينفي $not تعبير عامل، فيرجع المستندات التي تفشل في الشرط الداخلي. فالعبارة `{ price: { $no...
$nor	يجمع $nor المسندات؛ يطابق المستند فقط عندما لا يتحقق أي منها. فالعبارة `{ $nor: [ { price:...
$exists	يقوم $exists بتصفية المستندات بناءً على وجود حقل. فالعبارة `{ $exists: true }` تطابق المست...
$type	يطابق $type المستندات التي تكون قيمة حقلها من نوع BSON معين. فالعبارة `{ age: { $type: 'in...
$regex	يطابق $regex الحقول النصية باستخدام تعبير نمطي. فالعبارة `{ name: { $regex: '^A' } }` تطاب...
$jsonSchema	يتحقق $jsonSchema من بنية المستند وفق معيار مسودة JSON Schema، ويمكن استخدامه كمسند استعلا...
$expr	يتيح $expr لمسندات الاستعلام استخدام تعبيرات التجميع — لمقارنة حقول متعددة من المستند نفسه...
$text	يُجري $text بحثًا نصيًا كاملًا على الحقول المغطاة بفهرس نصي. `{ $text: { $search: 'coffee ...
$where	يقيّم $where تعبير جافاسكربت كمسند استعلام. `{ $where: 'this.credits == this.debits' }`. ي...
$mod	يطابق $mod المستندات التي يترك فيها قسمة قيمة الحقل على مقسوم باقيًا محددًا. فالعبارة `{ q...
$all	يطابق $all المستندات التي يحتوي حقل مصفوفتها على كل عنصر من المصفوفة المعطاة. فالعبارة `{ ...
$elemMatch	يطابق $elemMatch المستندات التي يحقق فيها عنصر مصفوفة واحد على الأقل جميع الشروط المعطاة. ...
$size	يطابق $size المستندات التي يكون طول حقل مصفوفتها مساويًا للطول المعطى بالضبط. فالعبارة `{ ...
$geoWithin	يجد $geoWithin المستندات التي يقع موقعها داخل شكل هندسي معين: $box (مستطيل)، $polygon (مضل...
$geoIntersects	يجد $geoIntersects المستندات التي يتقاطع شكلها الهندسي GeoJSON مع الشكل المعطى. `{ loc: { ...
$near	يُرجع $near المستندات الجغرافية مرتبة حسب المسافة من نقطة، تصاعديًا. `{ loc: { $near: { $g...
$nearSphere	يُرجع $nearSphere المستندات الجغرافية مرتبة حسب المسافة الكروية (الدائرة العظمى). `{ loc: ...
$bitsAllSet	يطابق $bitsAllSet المستندات التي تكون فيها كل البتات في المواضع المعطاة مضبوطة على 1. فالع...
$bitsAllClear	يطابق $bitsAllClear المستندات التي تكون فيها كل البتات في المواضع المعطاة 0. فالعبارة `{ f...
$bitsAnySet	يطابق $bitsAnySet المستندات التي تكون فيها بتة واحدة على الأقل من البتات في المواضع المعطا...
$bitsAnyClear	يطابق $bitsAnyClear المستندات التي تكون فيها بتة واحدة على الأقل من البتات في المواضع المع...
$meta	يعرض $meta بيانات وصفية من بحث $text، وأكثرها شيوعًا درجة الملاءمة textScore. `{ score: { ...
$slice	يُرجع $slice في الإسقاط جزءًا من حقل مصفوفة دون تعديل المستند. فالعبارة `{ tags: { $slice:...
$natural	يُرجع $natural المستندات بترتيب التخزين الفيزيائي في المجموعة. `{ $natural: 1 }` للترتيب ا...
$comment	يُرفق $comment نصًا توضيحيًا بالاستعلام لتتمكن من تتبع مصدره في currentOp وسجل الاستعلامات...
$currentDate	يعيّن $currentDate حقلًا على الوقت الحالي ككائن Date أو Timestamp. فالعبارة `{ $currentDat...
$min	يكتب $min القيمة المعطاة فقط عندما تكون أصغر من قيمة الحقل الحالية، ويترك الحقل دون مساس ب...
$max	يكتب $max القيمة المعطاة فقط عندما تكون أكبر من قيمة الحقل الحالية. `{ $max: { highScore: ...
$mul	يضرب $mul قيمة حقل بالمعامل المعطى. فالعبارة `{ $mul: { price: 0.9 } }` تطبق خصمًا 10%؛ و`...
$rename	يعيد $rename تسمية حقل. `{ $rename: { 'oldName': 'newName' } }`، مع مسارات نقطية للحقول ال...
$setOnInsert	يعيّن $setOnInsert قيم الحقول فقط عندما يُدرج upsert مستندًا جديدًا؛ ويُتجاهل عندما يُطابق...
$unset	يزيل $unset الحقل المحدد من مستند. `{ $unset: { age: '' } }` — القيمة عنصر نائب، وغالبًا س...
$addToSet	يضيف $addToSet قيمة إلى مصفوفة فقط إذا لم تكن موجودة بالفعل، محافظًا على خلوّ المصفوفة من ...
$pop	يزيل $pop العنصر الأول (-1) أو الأخير (1) من مصفوفة. فالعبارة `{ $pop: { queue: -1 } }` تز...
$pull	يزيل $pull من مصفوفة كل عنصر يساوي قيمة أو يحقق شرطًا. فالعبارة `{ $pull: { tags: 'spam' }...
$push	يلحق $push عنصرًا أو أكثر بنهاية مصفوفة. `{ $push: { items: 'pen' } }`؛ ولعدة قيم دفعة واح...
$pullAll	يزيل $pullAll من مصفوفة كل عنصر يساوي أي قيمة في القائمة المعطاة. `{ $pullAll: { tags: ['s...
$bit	يُجري $bit عمليات بتّية على الحقول الصحيحة: AND وOR وXOR. فالعبارة `{ $bit: { flags: { and...
$position	يعيّن $position المكان الذي يُدرج فيه $push العناصر. فالعبارة `{ $push: { items: { $each: ...
$[]	$[] هو العامل الموضعي الذي يحدّث كل عنصر من عناصر المصفوفة. فالعبارة `{ $set: { 'grades.$[...
$[]	$[identifier] هو العامل الموضعي الذي يحدّث، مع arrayFilters، عناصر المصفوفة المطابقة لشرط ...
$each	يزوّد $each $push و $addToSet بقيم متعددة. `{ $push: { tags: { $each: ['a', 'b', 'c'] } } ...
$slice	يحدّ $slice كمعدِّل تحديث طول مصفوفة بعد $push. فالعبارة `{ $push: { log: { $each: [msg], ...
$sort	يرتب $sort كمعدِّل تحديث عناصر المصفوفة بعد $push. فالعبارة `{ $push: { scores: { $each: [...
$match	يصفّي $match المستندات بشرط استعلام، ممررًا المطابقة منها فقط إلى المراحل اللاحقة. وهو الم...
$group	يجمع $group المستندات حسب مفتاح محدد (_id) ويطبق تعبيرات المُراكم ($sum/$avg/$max...) لكل ...
$lookup	يُجري $lookup ربطًا خارجيًا أيسر بين المجموعة الحالية ومجموعة أخرى، مرفقًا المستندات المطا...
$sum	$sum مُراكم يحسب مجموع حقل محدد عبر مجموعة (أو عدًّا عند إعطاء الحرفية 1). يُستخدم داخل $g...
$project	$project هو مرحلة الإسقاط: يختار الحقول أو يستبعدها أو يحسب حقولًا جديدة، معينًا كل مستند ...
$unwind	يفكك $unwind حقل مصفوفة، مصدرًا مستندًا واحدًا لكل عنصر مع نسخ كل الحقول الأخرى. استخدمه ل...
$sort	يرتب $sort مستندات خط الأنابيب حسب حقول محددة: 1 تصاعدي، -1 تنازلي، مع دعم الفرز متعدد الح...
$limit	يبتور $limit خط الأنابيب إلى أول N مستندات بالترتيب الحالي، مغيرًا العدد فقط لا المحتوى. م...
$skip	يسقط $skip أول N مستندات بترتيب خط الأنابيب الحالي ويمرر الباقي دون تغيير. يُقرن عادةً بـ ...
$count	يُرجع $count مستندًا واحدًا بشكل { field: N } يحمل عدد المستندات المتبقية في خط الأنابيب. ...
$addFields	يضيف $addFields حقولًا جديدة إلى كل مستند أو يستبدل حقولًا موجودة فيه مع الإبقاء على كل ال...
$set	$set اسم مستعار لـ $addFields: يضيف أو يستبدل حقولًا على كل مستند مع الإبقاء على كل شيء آخ...
$replaceRoot	يستبدل $replaceRoot المستند بالكامل بمستند مضمّن محدد، ويُستخدم عادة لرفع كائن متداخل مثل ...
$replaceWith	$replaceWith مثل $replaceRoot لكنه يتحمل نتائج null أو المفقودة، مُبقيًا المستند الأصلي بد...
$sample	يختار $sample عشوائيًا عددًا محددًا من المستندات — مفيد لتحليل العينات وبيانات الاختبار أو...
$documents	يُرجع $documents مصفوفة معطاة من مستندات حرفية دون قراءة أي مجموعة — مدخل خط أنابيب حرفي. ...
$sortByCount	$sortByCount اختصار لـ $group مع $sort: يجمع حسب قيمة تعبير، ويعد المستندات لكل مجموعة، وي...
$unset	يزيل $unset الحقول المحددة من المستندات، مُبقيًا كل شيء آخر. وهو اختصار لـ { $project: { f...
$bucket	يجمع $bucket المستندات في مجموعات محددة بمصفوفة حدود تصاعدية، مصدرًا مستندًا واحدًا { _id:...
$bucketAuto	يوزع $bucketAuto المستندات على عدد محدد من المجموعات بأعداد متساوية تقريبًا، محسوبًا الحدو...
$densify	يولّد $densify مستندات عند قيم حقول وسيطة مفقودة، عادة لاستيفاء السلاسل الزمنية — سد الفجو...
$setWindowFields	يُجري $setWindowFields حسابات النافذة — الرتب والمتوسطات المتحركة والمجاميع الجارية — عبر ...
$facet	يشغّل $facet عدة خطوط أنابيب فرعية بالتوازي داخل مرحلة واحدة، كلٌّ منها يعالج نفس مستندات ...
$geoNear	يصدر $geoNear مستندات مرتبة حسب القرب الجغرافي ويجب أن يكون المرحلة الأولى من خط الأنابيب،...
$graphLookup	يُجري $graphLookup عمليات بحث متكررة على مجموعة، محاكيًا اجتياز الرسوم البيانية: بدءًا من ...
$merge	يكتب $merge نتائج خط الأنابيب إلى مجموعة هدف (ربما في قاعدة بيانات أو عنقود آخر)، محدّثًا ...
$out	يكتب $out نتائج خط الأنابيب إلى مجموعة مسماة، مستبدلًا كل محتواها السابق؛ تُنشأ الهدف تلقا...
$unionWith	يدمج $unionWith النتائج المتراكمة لخط الأنابيب مع مستندات من مجموعة أخرى (أو نفسها)، مع مع...
$redact	يصفّي $redact على مستوى الحقل باستخدام بيانات صلاحية مخزنة في المستندات، مع المتغيرات النظ...
$collStats	يُرجع $collStats إحصائيات تخزين للمجموعة — عدد المستندات وحجم البيانات ومعلومات الفهرس وتف...
$indexStats	يُرجع $indexStats إحصائيات استخدام لكل فهرس — الاسم وعدد الوصول والمرات الفائتة ووقت آخر ا...
$avg	$avg مُراكم يحسب متوسط حقل عبر مجموعة في $group، أو متوسط عناصر المصفوفة في $project. يتجا...
$max	$max مُراكم يُرجع القيمة القصوى لحقل عبر مجموعة في $group، أو أقصى عنصر مصفوفة في $project...
$min	$min مُراكم يُرجع القيمة الدنيا لحقل عبر مجموعة في $group، أو أصغر عنصر مصفوفة في $project...
$push	$push مُراكم يلحق نتيجة تعبير كل مستند بمصفوفة أثناء $group، بترتيب الإدخال (غير مضمون الا...
$addToSet	$addToSet مُراكم يضيف نتيجة تعبير كل مستند إلى مصفوفة أثناء $group، مع إزالة التكرار تلقائ...
$first	$first مُراكم يُرجع حقلًا من أول مستند في مجموعة. يعتمد على ترتيب الإدخال، لذا يهم $sort ق...
$last	$last مُراكم يُرجع حقلًا من آخر مستند في مجموعة — متناظر مع $first ومعتمد على الترتيب بنفس...
$stdDevPop	$stdDevPop مُراكم يحسب الانحراف المعياري للمجتمع لحقل عبر مجموعة، قاسمًا على N لا N-1. است...
$stdDevSamp	$stdDevSamp مُراكم يحسب الانحراف المعياري للعينة لحقل عبر مجموعة، قاسمًا على N-1. استخدمه ...
$top	$top مُراكم يُرجع أعلى مستند في مجموعة وفق ترتيب فرز محدد — المستند بأكمله، لا حقلًا واحدً...
$topN	$topN مُراكم يُرجع N مستندات أعلى (أو قيم تعبير) لكل مجموعة وفق ترتيب فرز محدد، متاح منذ M...
$bottom	$bottom مُراكم يُرجع أدنى مستند في مجموعة وفق ترتيب فرز محدد — المستند بأكمله — متاح منذ M...
$bottomN	$bottomN مُراكم يُرجع N مستندات أدنى (أو قيم تعبير) لكل مجموعة وفق ترتيب فرز محدد، متاح من...
$count	$count مُراكم يعد المستندات داخل $group، متاح منذ MongoDB 5.0. إنه المكافئ الأوضح لـ { $su...
$firstN	$firstN مُراكم يُرجع مصفوفة قيم حقل من أول N مستندات لمجموعة (بترتيب الإدخال)، متاح منذ Mo...
$lastN	$lastN مُراكم يُرجع مصفوفة قيم حقل من آخر N مستندات لمجموعة (بترتيب الإدخال)، متاح منذ Mon...
$maxN	$maxN مُراكم يُرجع مصفوفة أكبر N قيم مميزة لحقل في مجموعة، متاح منذ MongoDB 5.2. لا حاجة ل...
$minN	$minN مُراكم يُرجع مصفوفة أصغر N قيم مميزة لحقل في مجموعة، متاح منذ MongoDB 5.2 — متناظرًا...
$accumulator	يعرّف $accumulator منطق مُراكم مخصص باستدعاءات جافاسكربت — init وaccumulate وmerge وfinali...
$median	$median مُراكم يُرجع وسيط حقل رقمي داخل مجموعة، متاح منذ MongoDB 7.0. الوسيط هو القيمة الو...
$percentile	$percentile مُراكم يُرجع قيمًا عند مئينات معطاة (من 0 إلى 100) لحقل داخل مجموعة، متاح منذ ...
$concatArrays	يدمج $concatArrays عدة مصفوفات في واحدة دون إزالة التكرار. كتعبير مصفوفة فهو شائع في $proj...
$setUnion	يُرجع $setUnion اتحاد مصفوفتين أو أكثر، مع إزالة التكرار ودون ترتيب عناصر مضمون. كتعبير مج...
$concat	يقوم $concat بدمج سلسلتين أو أكثر (أو تعبيرات تُقيَّم إلى سلاسل نصية) في سلسلة واحدة. وهو ...
$toUpper	يحوّل $toUpper سلسلة نصية إلى أحرف كبيرة. وهو أبسط عامل تحويل للنصوص، ويُستخدم غالبًا لتوح...
$dateToString	يُنسّق $dateToString تاريخًا إلى سلسلة نصية باستخدام نمط تنسيق — وهي الطريقة القياسية لإخر...
$add	ينفذ $add عملية الجمع داخل تعبيرات التجميع. يجمع أرقامًا متعددة، أو يضيف عددًا من الميلي ث...
$subtract	ينفذ $subtract عملية الطرح في تعبيرات التجميع، وهو النظير المقابل لـ $add. يأخذ وسيطتين با...
$multiply	يحسب $multiply حاصل ضرب عدة قيم رقمية في تعبيرات التجميع. تُمرَّر الوسائط كمصفوفة تحتوي عن...
$divide	ينفذ $divide عملية القسمة في تعبيرات التجميع بوسيطتين: المقسوم والمقسوم عليه. يُستخدم غالب...
$mod	يُرجع $mod باقي قسمة قيمتين في تعبيرات التجميع. يأخذ وسيطتين — المقسوم والمقسوم عليه — ويُ...
$abs	يُرجع $abs القيمة المطلقة لتعبير رقمي واحد. يُستخدم غالبًا لحساب المسافات أو الانحرافات أو...
$ceil	يُرجع $ceil أصغر عدد صحيح أكبر من أو يساوي عددًا معينًا — أي التقريب للأعلى. يُستخدم في حس...
$floor	يُرجع $floor أكبر عدد صحيح أقل من أو يساوي عددًا معينًا — أي التقريب للأسفل. يُستخدم لتقري...
$ln	يُرجع $ln اللوغاريتم الطبيعي (الأساس e) لعدد. يُستخدم في حسابات معدلات النمو وتمهيد البيان...
$log	يُرجع $log لوغاريتم عدد بأساس محدد. يأخذ وسيطتين: القيمة والأساس. على خلاف $ln و $log10 و ...
$log10	يُرجع $log10 اللوغاريتم ذا الأساس 10 لعدد. يُستخدم لفحوصات رُتب المقدار وحسابات الديسبل وض...
$log2	يُرجع $log2 اللوغاريتم ذا الأساس 2 لعدد، ويُستخدم في السياقات الحاسوبية مثل عمق البحث الثن...
$pow	يرفع $pow عددًا إلى قوة. يأخذ وسيطتين — الأساس والأس — ويُرجع الأساس مرفوعًا إلى الأس. يُس...
$sqrt	يُرجع $sqrt الجذر التربيعي لتعبير رقمي واحد. يُستخدم في الهندسة وحسابات الانحراف المعياري ...
$exp	يُرجع $exp العدد e مرفوعًا إلى القوة المعطاة، أي الدالة الأسية e أس x، حيث تساوي e تقريبًا...
$round	يقرّب $round عددًا، اختياريًا إلى خانة عشرية محددة. يأخذ القيمة ووسيطة مكان اختيارية: 0 أو...
$trunc	يقتطع $trunc الجزء الكسري من عدد نحو الصفر، مع إمكانية الاحتفاظ بعدد محدد من الخانات العشر...
$sign	يُرجع $sign إشارة عدد: 1 للأعداد الموجبة و -1 للأعداد السالبة و 0 للصفر. يُستخدم لعد الفئا...
$sin	يُرجع $sin جيب قيمة معبَّر عنها بالراديان. يُستخدم في معالجة الإشارات الدورية وتحويلات الإ...
$cos	يُرجع $cos جيب التمام لقيمة معبَّر عنها بالراديان. يُستخدم في الإسقاط المتجهي وتحليل أشكال...
$tan	يُرجع $tan ظل قيمة معبَّر عنها بالراديان. يُستخدم في حسابات الميل وتحويل التدرجات وقياس ال...
$asin	يُرجع $asin قوس الجيب لعدد، مع التعبير عن النتيجة بالراديان. يجب أن يقع الإدخال بين -1 و 1...
$acos	يُرجع $acos قوس جيب التمام لعدد، مع النتيجة بالراديان والإدخال محصورًا بين -1 و 1. يُستخدم...
$atan	يُرجع $atan قوس الظل لعدد بالراديان، ويقبل أي إدخال حقيقي. يُستخدم لتحويل الميلات إلى زواي...
$atan2	يُرجع $atan2 زاوية الاتجاه بالراديان من إحداثي y وإحداثي x، مع أخذ الوسيطات بالترتيب [y, x...
$degreesToRadians	يحوّل $degreesToRadians الدرجات إلى راديان بضربها في π/180. وبما أن العوامل المثلثية $sin ...
$radiansToDegrees	يحوّل $radiansToDegrees الراديان إلى درجات بضربها في 180/π. إن العوامل المثلثية العكسية $a...
$bitAnd	ينفذ $bitAnd عملية AND المنطقية على مستوى البت على الأعداد الصحيحة. متاح منذ MongoDB 6.3، ...
$bitOr	ينفذ $bitOr عملية OR المنطقية على مستوى البت على الأعداد الصحيحة. متاح منذ MongoDB 6.3، وي...
$bitXor	ينفذ $bitXor عملية XOR المنطقية على مستوى البت على الأعداد الصحيحة. متاح منذ MongoDB 6.3، ...
$bitNot	ينفذ $bitNot عملية NOT المنطقية على مستوى البت (المتممة الثنائية) على عدد صحيح واحد — وهو ...
$dateAdd	يضيف $dateAdd مقدارًا محددًا من وحدة زمنية إلى تاريخ ويعيد التاريخ الجديد — وهو العامل الم...
$dateSubtract	يطرح $dateSubtract مقدارًا محددًا من وحدة زمنية من تاريخ ويعيد التاريخ الجديد — وهو الوجه ...
$dateFromParts	يبني $dateFromParts تاريخًا من أجزاء رقمية مثل السنة والشهر واليوم والساعة والدقيقة والثان...
$dateToParts	يقسم $dateToParts تاريخًا إلى مستند يحتوي السنة والشهر واليوم والساعة والدقيقة والثانية وا...
$dateDiff	يحسب $dateDiff الفرق بين تاريخين بوحدة معينة كعدد صحيح — مثالي للأعمار، مدة الاشتراكات، أو...
$dateTrunc	يقتطع $dateTrunc تاريخًا إلى بداية وحدة معينة ويعيد التاريخ الجديد — مثالي لمحاذاة الطوابع...
$dateFromString	يحلل $dateFromString سلسلة نصية إلى تاريخ باستخدام تنسيق معين — وهو عكس $dateToString، ومف...
$dayOfMonth	يُرجع $dayOfMonth يوم الشهر لتاريخ ما (1 إلى 31) — تعبير شائع لإحصاءات مستوى اليوم. يقبل ت...
$dayOfWeek	يُرجع $dayOfWeek يوم الأسبوع لتاريخ ما كعدد صحيح: 1 هو الأحد و 7 هو السبت — بما يطابق Date...
$dayOfYear	يُرجع $dayOfYear يوم السنة لتاريخ ما (1 إلى 366) — مفيد لتقدم السنة، التحليلات الموسمية، أ...
$isoDayOfWeek	يُرجع $isoDayOfWeek رقم يوم الأسبوع وفق ISO 8601: 1 هو الاثنين و 7 هو الأحد — على عكس $day...
$isoWeek	يُرجع $isoWeek رقم أسبوع ISO 8601 لتاريخ ما (1 إلى 53). تبدأ أسابيع ISO يوم الاثنين، والأس...
$isoWeekYear	يُرجع $isoWeekYear السنة التي ينتمي إليها أسبوع ISO لتاريخ ما، ويُستخدم مع $isoWeek. لأن أ...
$millisecond	يُرجع $millisecond جزء الميلي ثانية من تاريخ ما (0 إلى 999) — مستخرج وقت دقيق. نادرًا ما ي...
$minute	يُرجع $minute جزء الدقيقة من تاريخ ما (0 إلى 59) — شائع لإحصاءات حركة المرور بدقة الدقيقة،...
$month	يُرجع $month شهر تاريخ ما (1 إلى 12) — أحد أكثر التعبيرات استخدامًا للتقارير الشهرية. اقرن...
$second	يُرجع $second جزء الثانية من تاريخ ما (0 إلى 59) — مفيد لتسميات مستوى الثانية أو فحوصات ال...
$week	يُرجع $week رقم الأسبوع لتاريخ ما بالنمط الأمريكي (0 إلى 53): تبدأ الأسابيع يوم الأحد، ويب...
$year	يُرجع $year السنة الكاملة لتاريخ ما (مثل 2026) — أكثر مستخرجي التواريخ أساسية. غالبًا يدمج...
$hour	يُرجع $hour جزء الساعة من تاريخ ما (0 إلى 23) — شائع لتحليل حركة المرور بالساعات، نوافذ ال...
$split	يقسم $split سلسلة نصية إلى مصفوفة من سلاسل فرعية حسب محدد — أداة أساسية للنصوص المشابهة لـ...
$strcasecmp	يقارن $strcasecmp سلسلتين دون حساسية لحالة الأحرف ويُرجع -1 أو 0 أو 1 — مفيد للفرز، التجمي...
$substr	يستخرج $substr سلسلة فرعية تبدأ من موضع معين بطول معين. منذ MongoDB 3.4 أصبح $substr اسمًا...
$substrBytes	يستخرج $substrBytes سلسلة فرعية بمواضع بايت UTF-8؛ إذ يعدّ كل من start و length بالبايتات....
$substrCP	يستخرج $substrCP سلسلة فرعية معدًّا المواضع بنقاط رموز يونيكود (تقريبًا الأحرف). إنه آمن ت...
$regexFind	ينفذ $regexFind بحثًا بتعبير نمطي متوافق مع بيرل على سلسلة نصية ويُرجع أول تطابق كمستند (ب...
$regexFindAll	ينفذ $regexFindAll بحثًا بتعبير نمطي على سلسلة نصية ويُرجع كل تطابق كمصفوفة؛ لكل عنصر حقول...
$regexMatch	يختبر $regexMatch ما إذا كانت سلسلة نصية تطابق تعبيرًا نمطيًا ويُرجع true أو false — أخف ع...
$regexReplace	يطابق $regexReplace نصًا بتعبير نمطي ويستبدله بسلسلة معينة — أداة متقدمة لتنظيف النصوص في ...
$indexOfBytes	يُرجع $indexOfBytes فهرس بايت UTF-8 لأول ظهور لسلسلة فرعية، أو -1 عند عدم العثور. يحدّان s...
$indexOfCP	يُرجع $indexOfCP فهرس نقطة الرمز (الحرف) لأول ظهور لسلسلة فرعية، أو -1 عند عدم العثور. يعد...
$trim	يزيل $trim الفراغات (المسافات، الجداول، الأسطر الجديدة) من طرفي سلسلة نصية، أو يقصّ مجموعة...
$ltrim	يقصّ $ltrim الفراغات، أو الأحرف في مجموعة chars المعطاة، من يسار (بداية) سلسلة نصية — البد...
$rtrim	يقصّ $rtrim الفراغات، أو الأحرف في مجموعة chars المعطاة، من يمين (نهاية) سلسلة نصية — البد...
$toLower	يحوّل $toLower سلسلة نصية إلى أحرف صغيرة — عامل تطبيع أساسي. يُستخدم لتوحيد صيغ التخزين، ب...
$strLenBytes	يُرجع $strLenBytes طول سلسلة نصية ببايتات UTF-8 — أداة أساسية لتقدير التخزين وحدود أحجام ا...
$strLenCP	يُرجع $strLenCP عدد نقاط رموز يونيكود في سلسلة نصية — أساسًا عدد الأحرف الذي يدركه الناس. ...
$replaceOne	يستبدل $replaceOne أول ظهور لسلسلة فرعية في سلسلة نصية ببديل معين — مفيد لإصلاح الأخطاء ال...
$replaceAll	يستبدل $replaceAll كل ظهور لسلسلة فرعية بسلسلة معينة — مثالي لتنظيف البيانات الجماعي أو تو...
$binarySize	يُرجع $binarySize حجم البيانات الثنائية بالبايتات (BinData)؛ ومع سلسلة نصية يُرجع طول بايت...
$arrayElemAt	يُرجع $arrayElemAt العنصر الموجود في موضع فهرس معين داخل مصفوفة. وهو العامل الأساسي للوصول...
$concatArrays	يدمج $concatArrays مصفوفتين أو أكثر في مصفوفة جديدة واحدة. يُستخدم غالبًا لدمج قوائم الوسو...
$filter	يمشي $filter عبر مصفوفة، ويحتفظ بالعناصر التي تحقق شرطًا، ويُرجع مصفوفة جديدة. وهو العامل ...
$indexOfArray	يُرجع $indexOfArray فهرس أول ظهور لقيمة في مصفوفة، أو -1 عند غيابها. تشمل الاستخدامات النم...
$isArray	يُرجع $isArray قيمة منطقية تشير إلى ما إذا كان التعبير يُقيَّم إلى مصفوفة. يُستخدم كثيرًا ...
$map	يتكرر $map عبر مصفوفة، ويمرر كل عنصر عبر تعبير in، ويجمع النتائج في مصفوفة جديدة بنفس الطو...
$size	يُرجع $size عدد عناصر مصفوفة كعدد صحيح غير سالب. وهو عامل بيانات المصفوفات الوصفية الأكثر ...
$slice	يستخرج $slice جزءًا من مصفوفة. يدعم صيغتين: الصيغة ذات الوسيطتين تأخذ أول n عنصرًا (أو آخر...
$reduce	يطوي $reduce مصفوفة إلى قيمة واحدة — المعادل التجميعي لدالة الاختزال (reduce/fold). يأخذ i...
$reverseArray	يعكس $reverseArray ترتيب عناصر مصفوفة ويُرجع مصفوفة جديدة. تشمل الاستخدامات النموذجية قلب ...
$sortArray	يفرز $sortArray العناصر داخل مصفوفة، وهو جديد في MongoDB 5.2. تستخدم مصفوفات القيم القياسي...
$objectToArray	يحوّل $objectToArray مستندًا إلى مصفوفة أزواج مفتاح-قيمة، كل عنصر بصيغة { k: 'fieldName', ...
$arrayToObject	يحوّل $arrayToObject مصفوفة أزواج مفتاح-قيمة إلى مستند، وهو عكس $objectToArray. يقبل المدخ...
$range	ينتج $range تسلسلًا من الأعداد الصحيحة من قيمة بداية حتى (دون شمول) قيمة نهاية، بخطوة اختي...
$zip	يدمج $zip مصفوفات عدة حسب الموضع في مجموعات، تحوي كل مجموعة العنصر الموجود في نفس الفهرس م...
$allElementsTrue	يُرجع $allElementsTrue true فقط إذا كان كل عنصر في مصفوفة صادقًا. المصفوفة الفارغة تُرجع t...
$anyElementTrue	يُرجع $anyElementTrue true عندما يكون عنصر واحد على الأقل في مصفوفة صادقًا. المصفوفة الفار...
$setDifference	يُرجع $setDifference العناصر الموجودة في المصفوفة الأولى والغائبة عن الثانية، مع إزالة الت...
$setEquals	يتحقق $setEquals من تساوي مصفوفتين أو أكثر كمجموعات، متجاهلًا الترتيب والتكرارات. الاستخدا...
$setIntersection	يُرجع $setIntersection العناصر الموجودة في كل مصفوفة مدخل، مع إزالة التكرارات. الاستخدامات...
$setIsSubset	يتحقق $setIsSubset مما إذا كان كل عنصر من المصفوفة الأولى يظهر أيضًا في الثانية — أي ما إذ...
$setUnion	يدمج $setUnion كل مصفوفات المدخل ويزيل تكرارات العناصر، مُرجعًا الاتحاد. الاستخدامات النمو...
$cond	ينفذ $cond المنطق الشرطي الثلاثي إذا-ثم-وإلا، وهو عامل التفرع الأساسي في تعبيرات التجميع. ...
$ifNull	يُرجع $ifNull قيمة بديلة عندما يُقيَّم تعبير إلى null أو يكون حقل مفقودًا — العامل الأكثر ...
$switch	يقيّم $switch عدة فروع case بالترتيب ويُرجع نتيجة then لأول فرع صادق، مثل عبارة switch في ...
$convert	يحوّل $convert قيمة إلى نوع BSON مستهدف وهو نقطة الدخول الرئيسية لتحويلات الأنواع. يقبل ال...
$toBool	يحوّل $toBool قيمة إلى قيمة منطقية. الرقم 0 يصبح false وأي رقم غير صفري يصبح true؛ والسلسل...
$toDate	يحوّل $toDate قيمة إلى تاريخ BSON. يمرر التواريخ كما هي، ويعامل الأرقام كطوابع ميلي ثانية،...
$toDecimal	يحوّل $toDecimal قيمة إلى Decimal128، النوع العشري عالي الدقة للمال والحسابات الحساسة للدق...
$toDouble	يحوّل $toDouble قيمة إلى double من BSON. يقبل الأرقام والسلاسل الرقمية والقيم المنطقية وال...
$toInt	يحوّل $toInt قيمة إلى عدد صحيح موقع 32-بت (int من BSON). يقبل الأرقام والسلاسل الرقمية وال...
$toLong	يحوّل $toLong قيمة إلى عدد صحيح موقع 64-بت (long من BSON)، بنطاق أوسع بكثير من int — مثالي...
$toObjectId	يحوّل $toObjectId سلسلة سداسية عشرية من 24 حرفًا إلى ObjectId، التحويل الأكثر شيوعًا لعملي...
$toString	يحوّل $toString قيمة إلى سلسلة نصية. تتحول الأرقام والتواريخ والقيم المنطقية والكائنات Obj...
$cmp	يقارن $cmp قيمتين ويُرجع -1 أو 0 أو 1 للأصغر أو المتساوي أو الأكبر. وهو عامل المقارنة بصيغ...
$eq	$eq هو مقارنة المساواة بصيغة التعبير، يأخذ وسيطتين ويُرجع قيمة منطقية. يعمل في سياقات التع...
$gt	$gt هو مقارنة الأكبر من بصيغة التعبير. يأخذ وسيطتين ويُرجع true عندما تكون الأولى أكبر من ...
$gte	$gte هو مقارنة الأكبر من أو المساواة بصيغة التعبير. يأخذ وسيطتين ويُرجع true عندما تكون ال...
$lt	$lt هو مقارنة الأصغر من بصيغة التعبير. يأخذ وسيطتين ويُرجع true عندما تكون الأولى أصغر من ...
$lte	$lte هو مقارنة الأصغر من أو المساواة بصيغة التعبير. يأخذ وسيطتين ويُرجع true عندما تكون ال...
$ne	$ne هو مقارنة عدم المساواة بصيغة التعبير. يأخذ وسيطتين ويُرجع true عندما تختلفان. يُستخدم ...
$literal	يُرجع $literal قيمة دون تحليلها كتعبير. يُستخدم عندما يجب أن تبقى سلسلة تبدأ بـ $ نصًا عاد...
$let	يعرّف $let متغيرات محلية داخل تعبيرات التجميع لاستخدامها في تعبير in، متجنبًا التقييم المت...
$getField	يجلب $getField حقلًا باسمه الحرفي من مستند، دون تحليل الاسم كمسار حقل حتى لو بدأ بـ $ أو ا...
$setField	يضيف $setField أو يحدّث حقلًا مسمى في مستند ويُرجع مستندًا جديدًا دون تعديل المدخل. الصياغ...
A
aggregate()	تشغّل aggregate() خط أنابيب متعدد المراحل يجمع المستندات ويحسبها ويعيد تشكيلها، مثل `db.us...
allowDiskUse()	تسمح allowDiskUse() لمؤشر بالتفريغ إلى القرص للعمليات الحاجزة مثل sort() التي تطلب ذاكرة ك...
Array	يحمل Array قائمة مرتبة من أي قيم BSON (بما فيها المصفوفات والمستندات المتداخلة). المطابقة ...
B
bulkWrite()	تنفّذ bulkWrite() عدة عمليات كتابة من أنواع مختلطة في استدعاء واحد: insertOne و updateOne ...
batchSize()	تضبط batchSize() عدد المستندات التي يسحبها المؤشر من الخادم لكل دفعة: `db.users.find().bat...
Boolean	يحمل Boolean قيمة true أو false — مثالي للأعلام والمبدلات (isActive, isDeleted). استعلم بم...
Binary	يخزّن Binary الصور والملفات والبيانات المشفرة والمعرّفات UUID — أكثر ضغطًا من سلاسل Base64...
C
countDocuments()	تعدّ countDocuments() المستندات المطابقة لمرشح، مثل `db.users.countDocuments({ age: { $gte...
createIndex()	تُنشئ createIndex() فهرسًا واحدًا لتسريع الاستعلامات، مثل `db.users.createIndex({ age: 1 }...
createIndexes()	تُنشئ createIndexes() عدة فهارس في استدعاء واحد، مثل `db.users.createIndexes([{ key: { age...
count()	تعدّ count() المستندات التي سيعيدها المؤشر الحالي: `db.users.find({ age: { $gt: 20 } }).co...
collation()	تضبط collation() قواعد مقارنة السلاسل لاستعلام: `db.users.find({ name: 'alice' }).collatio...
close()	تُغلق close() مؤشرًا مبكرًا وتحرر موارد الخادم: `db.users.find().close()`. استدعها عند عدم...
currentOp	يسرد currentOp العمليات الجارية حاليًا، لتشخيص الاستعلامات البطيئة والأعمال طويلة التشغيل ...
collMod	يضبط collMod إعدادات مجموعة موجودة: انتهاء فهرس TTL (expireAfterSeconds)، ومدقّق المخطط، و...
createIndexes	يبني createIndexes فهارس على مجموعة — أحادية الحقل ومركّبة وفريدة وTTL ونصية وجيومكانية. ف...
createUser	ينشئ createUser مستخدم قاعدة بيانات بأدوار؛ في mongosh استخدم db.createUser({ user, pwd, r...
D
deleteOne()	تحذف deleteOne() أول مستند يطابق مرشحًا؛ وإذا طابق عدة مستندات، يُحذف الأول بالترتيب الطبي...
deleteMany()	تحذف deleteMany() كل مستند يطابق مرشحًا وتُعيد deletedCount. وهي أداة العمل للتنظيف الجماع...
distinct()	تُعيد distinct() كل قيمة فريدة لحقل معين في المجموعة، مثل `db.users.distinct('address.city...
dropIndex()	تحذف dropIndex() فهرسًا محددًا، وتقبل اسمه أو مفاتيحه، مثل `db.users.dropIndex('age_1')`. ...
dropIndexes()	تحذف dropIndexes() فهرسًا واحدًا أو أكثر، مثل `db.users.dropIndexes()` الذي يحذف كل فهرس غ...
drop()	تحذف drop() مجموعة بأكملها — كل المستندات والفهارس والبيانات الوصفية، مثل `db.users.drop()...
Date	Date هو نوع التاريخ والوقت في MongoDB، يُخزَّن داخليًا كعدد مللي ثانية من 64 بتًا منذ بداي...
Decimal128	Decimal128 هو نوع العشري عالي الدقة في MongoDB، المبني على معيار النقطة العائمة العشرية IE...
Double	Double هو النوع الرقمي الافتراضي في MongoDB: رقم فاصلة عائمة IEEE 754 من 64 بتًا، نحو ±1.8...
dropUser	يحذف dropUser مستخدمًا من قاعدة البيانات. لا يمكن للمستخدم المصادقة بعدها فورًا، والعملية ...
dbStats	يُعيد dbStats إحصائيات قاعدة البيانات الحالية — عدد المجموعات وعدد المستندات وحجم البيانات...
E
estimatedDocumentCount()	تقدّر estimatedDocumentCount() العدد الكلي للمستندات من البيانات الوصفية للمجموعة، مثل `db...
explain()	تكشف explain() خطة تنفيذ الاستعلام: `db.users.find({ age: { $gt: 20 } }).explain('executio...
F
find()	تستعلم find() عن مستندات مطابقة لشرط وتُعيد مؤشرًا (Cursor). وهي أبسط طرق القراءة: الوسيط ...
findOneAndUpdate()	تحدّث findOneAndUpdate() أول مستند يطابق مرشحًا وتُعيد المستند نفسه — قبل أو بعد التحديث، ...
findOneAndDelete()	تحذف findOneAndDelete() أول مستند يطابق مرشحًا وتُعيد المستند المحذوف نفسه، مثل `db.users....
findOneAndReplace()	تستبدل findOneAndReplace() أول مستند يطابق مرشحًا بمستند بديل وتُعيد المستند قبل أو بعد ال...
findOne()	تُعيد findOne() أول مستند يطابق مرشحًا مباشرةً كمستند وليس كمؤشر، مثل `db.users.findOne({ ...
forEach()	تشغّل forEach() استدعاءً رجعيًا على كل مستند في مؤشر، مثل `db.users.find().forEach(functio...
find	find هو أمر الاستعلام في MongoDB. تستخدم mongosh عادةً المساعدة db.collection.find(filter,...
G
getIndexes()	تُعيد getIndexes() كل فهارس مجموعة، مثل `db.users.getIndexes()`. يعرض كل إدخال اسم الفهرس ...
grantRolesToUser	يضيف grantRolesToUser أدوارًا إلى مستخدم موجود — إضافةً تدريجية تُبقي كل الأدوار الحالية (...
H
hasNext()	تُبلّغ hasNext() عما إذا كان المؤشر ما زال يحوي مستندًا تاليًا: `while (db.users.find().ha...
hint()	تفرض hint() على استعلام استخدام فهرس محدد: `db.users.find({ age: { $gt: 20 } }).hint({ age...
I
insertOne()	تدرج طريقة insertOne() مستندًا واحدًا داخل مجموعة. إذا لم يكن المستند يحوي حقل _id، تولّد ...
insertMany()	تُدرج insertMany() مستندات متعددة في استدعاء واحد، مثل `db.users.insertMany([{ name: 'A' }...
indexStats()	تُبلّغ indexStats() إحصائيات استخدام كل فهرس، مثل `db.users.indexStats()` — أعداد الوصول و...
Int32	Int32 عدد صحيح موقّع من 32 بتًا، يتراوح من -2147483648 إلى 2147483647. في mongosh يكون الر...
insert	insert هو أمر الإدراج منخفض المستوى، تلفّه عادةً db.collection.insertOne()/insertMany() في...
J
JavaScript	يخزّن نوع JavaScript كود JS في مستند، يُنفَّذ على الخادم عبر `$where` (يُشغَّل لكل مستند)....
L
limit()	تحدّ limit() عدد المستندات التي تُعيدها find(): `db.users.find({ age: { $gt: 20 } }).limit...
Long	Long عدد صحيح موقّع من 64 بتًا (نوع BSON int64)، تقريبًا ±9.2×10^18، ويُنشأ بـ `Long(42)` ...
logout	ينهي logout جلسة المصادقة للاتصال الحالي، مسجّلًا خروج المستخدم؛ في mongosh استدعِ db.logo...
listCollections	يسرد listCollections مجموعات قاعدة البيانات مع خياراتها (المدقّق وقواعد المقارنة وTTL وغير...
M
map()	تطبّق map() تحويلًا على كل مستند في مؤشر وتُعيد النتائج كمصفوفة، مثل `db.users.find().map(...
maxTimeMS()	تحدّ maxTimeMS() المدة القصوى لتشغيل عملية مؤشر، بالمللي ثانية: `db.users.find().maxTimeMS...
MinKey	MinKey نوع BSON خاص أصغر من كل قيمة أخرى، عكس MaxKey. يخدم تصميم مفتاح التجزئة (دفع البيان...
MaxKey	MaxKey نوع BSON خاص أكبر من كل قيمة أخرى، وهو مقابل MinKey. يخدم تصميم مفتاح التجزئة (دفع ...
N
next()	تُعيد next() المستند التالي في مؤشر وتتقدّم به: `db.users.find().next()`. استدعاؤها بعد نف...
noCursorTimeout()	تعطّل noCursorTimeout() مهلة الخمول الخاصة بالمؤشر على الخادم: `db.users.find().noCursorTi...
Null	Null تعني أن الحقل يحمل قيمة فارغة، وهو مختلف عن الحقل المفقود. استعلام مثل `{ field: null...
O
ObjectId	ObjectId هو نوع _id الافتراضي في MongoDB — معرّف فريد من 12 بايت: طابع زمني من 4 بايتات + ...
Object (Document)	Object مستند فرعي متداخل. تعشّش MongoDB بعمق غير محدود للنماذج ذات الوصف الذاتي. اقترب من ...
P
ping	يتحقق ping من أن خادم MongoDB قابل للوصول ويستجيب، معيدًا { ok: 1 } عند النجاح. وهو أبسط أ...
profile	يبدّل profile مراقب الأداء (Database Profiler): المستوى 0 إيقاف، و1 يسجّل العمليات البطيئة...
R
replaceOne()	تستبدل replaceOne() أول مستند يطابق مرشحًا بمستند جديد كليًا. على عكس updateOne() التي تست...
renameCollection()	تعيد renameCollection() تسمية مجموعة، مثل `db.users.renameCollection('members')`. تنجو الب...
Regular Expression	Regular Expression نوع BSON لمطابقة الأنماط في الاستعلامات، يكافئ `{ field: /pattern/ }`. ...
runCommand()	تنفّذ db.runCommand() أي أمر قاعدة بيانات في mongosh — نقطة الدخول العامة للأوامر منخفضة ا...
renameCollection	تعيد renameCollection تسمية مجموعة داخل قاعدة بيانات أو عبرها، ويجب تشغيلها على قاعدة بيان...
revokeRolesFromUser	يزيل revokeRolesFromUser الأدوار المدرجة من مستخدم مع الإبقاء على البقية. يسري السحب فورًا...
S
stats()	تُعيد stats() إحصائيات المجموعة، مثل `db.users.stats()` — عدد المستندات، وحجم المجموعة، وح...
skip()	تتجاهل skip() أول N مستندات من مؤشر: `db.users.find().sort({ age: 1 }).skip(10)`. تتآزر مع...
sort()	ترتّب sort() نتائج المؤشر وفق حقول معطاة: `db.users.find().sort({ age: 1, name: -1 })`. ال...
size()	تُعيد size() عدد المستندات في مؤشر: `db.users.find().size()`. دلالاتها تطابق count() في مع...
String	String هو أكثر أنواع الحقول شيوعًا في MongoDB، ويحمل نص UTF-8. طابقه تمامًا بـ `$eq` أو با...
T
toArray()	تجلب toArray() كل ما يشير إليه مؤشر بنمط find() وتُعيده كمصفوفة جافاسكريبت: `db.users.find...
tailable()	تعلّم tailable() مؤشرًا بأنه مؤشر ذيل (tailable)، مثل `db.logs.find().tailable()`. بدلًا م...
tryNext()	تحاول tryNext() إعادة المستند التالي من مؤشر، معيِّنةً null بدلًا من رفع خطأ عند النهاية: ...
Timestamp	Timestamp نوع داخلي في MongoDB: قيمة من 64 بتًا تتكون من ثانية يونكس من 4 بايتات مع زيادة ...
U
updateOne()	تحدّث updateOne() أول مستند يطابق مرشحًا. إذا طابقت عدة مستندات، فلن يُحدَّث إلا الأول (با...
updateMany()	تحدّث updateMany() كل مستند يطابق مرشحًا، مثل `db.users.updateMany({ age: { $lt: 18 } }, {...
updateUser	يعدّل updateUser مستخدمًا موجودًا: يعيد تعيين كلمة المرور، أو يستبدل الأدوار، أو يحدّث cus...
V
validate()	تفحص validate() السلامة البنيوية لمجموعة، مثل `db.users.validate({ full: true })`. تفحص مس...
W
watch()	تراقب watch() مجموعة بحثًا عن التغييرات وتُعيد تدفق تغييرات (Change Stream)، مثل `db.users...

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

من نحن