$setWindowFields (تعيين حقول النافذة)

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

$setWindowFields (تعيين حقول النافذة)

يُجري $setWindowFields حسابات النافذة — الرتب والمتوسطات المتحركة والمجاميع الجارية — عبر أقسام ويكتب النتائج إلى كل مستند. حدد حقول المخرجات بعوامل النافذة (مثل $rank و $denseRank أو المُراكمات) وترتيب sortBy ونطاق نافذة اختياري. فكّر في دوال النافذة في SQL.

📝 الصيغة

{ $setWindowFields: { partitionBy: <expression>, sortBy: { <field>: <1 or -1> }, output: { <field>: { <windowOperator>: ..., window: { documents: [...], range: [...] } } } } }

⚙️ المعلمات

القيمة المرجعة：تدفق مستندات مع إضافة حقول محسوبة بالنوافذ

▶ مثال

نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):

// $setWindowFields: المجموع الجاري لكل منطقة
db.sales.aggregate([
  { $setWindowFields: {
    partitionBy: '$region',
    sortBy: { date: 1 },
    output: {
      runningTotal: { $sum: '$amount', window: { documents: ['unbounded', 'current'] } }
    }
  } }
])

المخرجات：

// كل عملية بيع تكتسب مجموعًا جاريًا
{ "region": "EAST", "date": "2024-01-02", "amount": 30, "runningTotal": 30 }

📌 ملاحظات

• حقل مخرج واحد على الأقل مطلوب؛ يحرك sortBy وعوامل النافذة ترتيب الحساب
• تُعبَّر نطاقات النافذة عبر documents أو range
• دون partitionBy يكون التدفق كله قسمًا واحدًا

🏷️ وسوم ذات صلة

💡 حالات ذات صلة

📚 دروس ذات صلة

❓ الأسئلة الشائعة

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

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

من نحن