Kif jaħdmu l-queries u l-projections fl-find?

Question

Accepted Answer

Il-metodu **`find`** jirtrjeva dokumenti li jaqblu ma' filtru; **projection** jikkontrolla liema campos jiġu ritornati. Flimkien jippermettulek li twettaq query għad-dokumenti t-tajba u tiddefinixxi l-output — fundamentali għat-tqari tad-data b'mod effiċjenti.

## find — query dokumenti

```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` jirretorna **cursor** (pointer għar-riżultati) li tista' tikkatejna mal- `sort`, `limit`, `skip`, eċċ. `findOne` jirretorna dokument wieħed direttament.

## Projection — agħżel liema campos jiritornu

```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
```

**Projection** (it-tieni argument) jikkontrolla l-campos ritornati: `1` jinkludi, `0` jeskludu. `_id` huwa inklus b'default (eskludu bil- `_id: 0`). Ġeneralment ma tistax taħlit includes u excludes (ħlief għal `_id`).

## Għaliex projection ha tħassara: effiċjenza u sigurtà

```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
```

## Projecting nested u array fields

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

## Għaliex hu importanti

`find` u projection huma fundamentali għat-**tqari tad-data** f'MongoDB — query għad-dokumenti t-tajba u ddefinixxi l-output huma ħtiġiet kostanti, għalhekk il-fehim tagħhom hu essenzjali bħala għarifa ta' kuljum.

Il-fehim ta' kif jaħdem `find` (jirretorna cursor ta' dokumenti li jaqblu, chainable mal- `sort`/`limit`/`skip` għal ordnament u paginazzjoni) u `findOne` (dokument wieħed) hu l-fondazzjoni tat-tqari tad-data. **Projection** hu importanti ħafna għal żewġ raġunijiet prattiċi: **effiċjenza** (jirretorna biss il-campos li għandek bżonn inaqqas id-data trasferita — sinifikanti għad-dokumenti kbar jew settijiet ta' riżultati, ittejjeb il-prestazzjoni) u partikularment **sigurtà** (eskludi campos sensittivi bħal passwords jew data interna biex ma jitlaqgħu fir-riżultati tal-query — prattika komuni u importanti, eż. dejjem projektaw out il-passwords fields meta torni l-user data, simili għall-użu ta' response models f'APIs).

Il-fehim ta' kif tinkludi (`1`) jew teskludu (`0`) campos, li `_id` huwa inklus b'default, u kif tipprojetta nested/array fields jkopri l-formazzjoni prattika ta' riżultati tal-query.

Bħal li t-tqari tad-data hu l-operazzjoni database l-aktar komuni, u bħal li `find` b'projection hu kif irretorna b'mod effiċjenti u sigur id-dokumenti t-tajba bil-campos t-tajba, il-fehim ta' find queries u projections — il-cursor model, chaining għal sort/pagination, u partikularment projection għal effiċjenza u sigurtà (eskludi data sensittiva) — hu essenzjali, MongoDB knowledge applikat frekwentement għal kwalunkwe kodiċi ta' tqari tad-data, bil-aspett ta' sigurtà ta' projecting out campos sensittivi li hu considerazzjoni prattika importanti ħafna.