كيف تعمل استعلامات find والإسقاطات (Projections)؟

Question

Accepted Answer

طريقة **`find`** تسترجع المستندات التي تطابق مرشحًا؛ **الإسقاط** يتحكم في الحقول المرجعة. معًا يتيحان لك الاستعلام عن المستندات الصحيحة وتشكيل الإخراج — أساسي لقراءة البيانات بكفاءة.

## استعلام المستندات — find

```js
db.users.find();                          // all documents
db.users.find({ age: { $gt: 25 } });      // filter: matching documents (a CURSOR)
db.users.findOne({ email: "ann@x.com" }); // the FIRST matching document (or null)

// find returns a CURSOR you can chain methods on
db.users.find({ active: true })
  .sort({ name: 1 })                      // sort
  .limit(10)                              // limit
  .skip(20);                              // skip (pagination)
```

`find` يرجع **مؤشرًا** (مؤشر إلى النتائج) يمكنك ربطه مع `sort` و `limit` و `skip` وغيرها. `findOne` يرجع مستندًا واحدًا مباشرة.

## الإسقاط — اختيار الحقول المراد إرجاعها

```js
// projection: 1 = include, 0 = exclude
db.users.find({ active: true }, { name: 1, email: 1 });        // only name and email (+ _id)
db.users.find({}, { password: 0 });                           // everything EXCEPT password
db.users.find({}, { name: 1, _id: 0 });                       // name only, exclude _id
```

**الإسقاط** (الوسيط الثاني) يتحكم في الحقول المرجعة: `1` يتضمن، `0` يستبعد. `_id` يُتضمن بشكل افتراضي (استبعده باستخدام `_id: 0`). عادةً لا يمكنك الخلط بين التضمينات والاستبعادات (ما عدا `_id`).

## لماذا يهم الإسقاط: الكفاءة والأمان

```text
✓ EFFICIENCY — return only needed fields → less data transferred (especially for large
  documents or large result sets) → faster
✓ SECURITY — EXCLUDE sensitive fields (passwords, internal data) so they don't leak
  → e.g. always project out password fields when returning user data
```

## إسقاط الحقول المتداخلة والمصفوفات

```js
db.users.find({}, { "address.city": 1 });        // nested field (dot notation)
db.posts.find({}, { comments: { $slice: 5 } });   // first 5 array elements
```

## لماذا يهم

`find` والإسقاط أساسيان **لقراءة البيانات** في MongoDB — الاستعلام عن المستندات الصحيحة وتشكيل الإخراج احتياجات مستمرة، لذا فهم هذه المفاهيم معرفة أساسية ضرورية يوميًا.

معرفة كيفية عمل `find` (إرجاع مؤشر للمستندات المطابقة، قابل للربط مع `sort`/`limit`/`skip` للترتيب والعرض الصفحي) و `findOne` (مستند واحد) هو أساس قراءة البيانات. **الإسقاط** مهم بشكل خاص لسببين عمليين: **الكفاءة** (إرجاع الحقول التي تحتاجها فقط يقلل البيانات المنقولة — مهم للمستندات الكبيرة أو مجموعات النتائج، مما يحسن الأداء) و بالأخص **الأمان** (استبعاد الحقول الحساسة مثل كلمات المرور أو البيانات الداخلية بحيث لا تتسرب في نتائج الاستعلام — ممارسة شائعة ومهمة، مثلاً استبعاد حقول كلمات المرور دائمًا عند إرجاع بيانات المستخدم، مشابهة لاستخدام نماذج الاستجابة في الواجهات البرمجية).

فهم كيفية تضمين (`1`) أو استبعاد (`0`) الحقول، وأن `_id` يُتضمن بشكل افتراضي، وكيفية إسقاط الحقول المتداخلة والمصفوفات يغطي التشكيل العملي لنتائج الاستعلام.

نظرًا لأن قراءة البيانات هي أكثر عملية قاعدة بيانات شيوعًا، وحيث أن `find` مع الإسقاط هو كيفية استسترجاع المستندات الصحيحة بالحقول الصحيحة بكفاءة وأمان، فإن فهم استعلامات find والإسقاطات — نموذج المؤشر، الربط للترتيب/العرض الصفحي، وبالأخص الإسقاط للكفاءة والأمان (استبعاد البيانات الحساسة) — معرفة MongoDB أساسية وضرورية بتكرار، مطبقة بشكل متكرر لأي كود قراءة بيانات، مع كون جانب الأمان الخاص باستبعاد البيانات الحساسة اعتبارًا عمليًا مهمًا بشكل خاص.