$comment (تعليق الاستعلام)
آخر تحديث: 2026-10-09
$comment (تعليق الاستعلام)
يُرفق $comment نصًا توضيحيًا بالاستعلام لتتمكن من تتبع مصدره في currentOp وسجل الاستعلامات البطيئة والمُنمِّج. `{ $comment: 'checkout-cart-query' }` أو بالتسلسل db.coll.find(...).comment('checkout'). لا يؤثر على النتائج ولا على اختيار الفهرس. استخدمه لوسم الاستعلامات من أجل تشخيص العمليات.
| الفئة | الإسقاط |
|---|---|
| إصدار MongoDB | 4.4+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
{ $comment: <comment string> }⚙️ المعلمات
| سلسلة تعليق | نص اعتباطي يظهر في التشخيصات. |
|---|
القيمة المرجعة：نتائج الاستعلام (غير متأثرة بالتعليق)
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// $comment: وسم الاستعلام للعمليات
db.orders.find(
{ status: 'pending' },
{ _id: 1 }
).comment('checkout-pending-orders')المخرجات：
// النتائج دون تغيير؛ يُسجَّل التعليق في التشخيصات📌 ملاحظات
- لا يغيّر النتائج ولا خطة التنفيذ
- مرئي في سجلات الاستعلامات البطيئة وcurrentOp وprofile
- تقبل خطوط أنابيب التجميع خيار comment أيضًا
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qهل يغيّر $comment نتائج الاستعلام؟
Aلا، إنه بيانات وصفية فقط ولا يؤثر على النتائج ولا على اختيار الفهرس.
Qأين يمكنني رؤية التعليق؟
Aفي currentOp وسجل الاستعلامات البطيئة (system.profile).
Qهل يمكن لاستعلامات التجميع حمل تعليقات؟
Aنعم، db.coll.aggregate([...], { comment: '...' }).
