Si funksionojnë pyetjet find dhe projeksionet?

Question

Accepted Answer

Metoda **`find`** gjen dokumentet që përputhen me një filtër; **projeksioni** kontrollon cilat fusha kthehen. Së bashku, ato ju lejojnë të pyisni për dokumentet e duhur dhe të formësoni outputin — thelbësor për leximin e të dhënave në mënyrë efikase.

## find — pyetje dokumentesh

```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` kthen një **cursor** (një tregues për rezultate) që mund ta lidhni me `sort`, `limit`, `skip`, etj. `findOne` kthen një dokument të vetëm drejtpërdrejt.

## Projeksioni — zgjedhni cilat fusha të kthehen

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

**Projeksioni** (argumenti i dytë) kontrollon fushat e kthyera: `1` përfshin, `0` përjashton. `_id` përfshihet si parazgjedhje (përjashto me `_id: 0`). Përgjithësisht nuk mund të përzierni përfshirjet dhe përjashtimet (përveç për `_id`).

## Pse projeksioni ka rëndësi: efikasitet dhe siguri

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

## Projeksionet e fushave të mbivendosura dhe array

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

## Pse ka rëndësi

`find` dhe projeksioni janë thelbësor për **leximin e të dhënave** në MongoDB — pyetja për dokumentet e duhur dhe formësimi i outputit janë nevoja të vazhdueshme, ndaj kuptimi i tyre është njohuri thelbësore përditore.

Të ditur se si funksionon `find` (kthen një cursor dokumentesh që përputhen, që mund të lidhen me `sort`/`limit`/`skip` për renditje dhe paginim) dhe `findOne` (një dokument i vetëm) është themeli i leximit të të dhënave. **Projeksioni** është veçanërisht i rëndësishëm për dy arsye praktike: **efikasiteti** (kthimi vetëm i fushave që ju nevojiten zvogëlon të dhënat e transferuara — domethënës për dokumente të mëdha ose grupe rezultatesh, duke përmirësuar performancën) dhe veçanërisht **siguria** (përjashtimi i fushave të ndjeshme si fjalëkalime ose të dhëna të brendshme në mënyrë që ato të mos rrjedhin në rezultatet e pyetjeve — një praktikë e zakonshme, e rëndësishme, p.sh. përjashtimi i fushave të fjalëkalimit gjithmonë kur kthehen të dhënat e përdoruesit, ngjashëm me përdorimin e modeleve përgjegjeje në API).

Të kuptosh se si të përfshish (`1`) ose përjashtosh (`0`) fusha, që `_id` përfshihet si parazgjedhje, dhe se si të projektuash fusha të mbivendosura/array përfshin formësimin praktik të rezultateve të pyetjeve.

Meqenëse leximi i të dhënave është operacioni më i zakonshëm i bazës së të dhënave, dhe meqenëse `find` me projeksion është si ju në mënyrë efikase dhe të sigurt marrni dokumentet e duhura me fushat e duhura, kuptimi i pyetjeve find dhe projeksioneve — modeli i cursor, lidhja për sort/paginim, dhe veçanërisht projeksioni për efikasitet dhe siguri (përjashtimi i të dhënave të ndjeshme) — është njohuri thelbësore, e zbatuar shpesh në MongoDB për çdo kod leximi të dhënash, me aspektin e sigurisë të përjashtimit të fushave të ndjeshme që është konsiderim praktik veçanërisht i rëndësishëm.