Kaip veikia find užklausos ir projekcijos?

Question

Accepted Answer

**`find`** metodas grąžina dokumentus, atitinkančius filtrą; **projekcija** kontroliuoja, kurie laukai yra grąžinami. Kartu jie leidžia užklausti teisingo dokumentus ir suformuoti išvestį — tai yra pagrindinė duomenų nuskaitymo dalį.

## find — dokumentų užklausa

```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` grąžina **kursorių** (rodyklę į rezultatus), kurią galite naudoti grandinėje su `sort`, `limit`, `skip` ir kt. `findOne` grąžina vieną dokumentą tiesiogiai.

## Projekcija — pasirinkite, kurie laukai bus grąžinti

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

**Projekcija** (antrasis argumentas) kontroliuoja grąžinamų laukų sąrašą: `1` įtraukia, `0` neįtraukia. `_id` yra įtrauktas pagal numatytuosius nustatymus (neįtraukti su `_id: 0`). Paprastai negalite maišyti įtraukimų ir neįtraukimų (išskyrus `_id`).

## Kodėl projekcija svarbi: efektyvumas ir saugumas

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

## Projektuojami įdėti ir masyvo laukai

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

## Kodėl tai svarbu

`find` ir projekcija yra pagrindinės **duomenų nuskaitymo** MongoDB operacijos — tinkamų dokumentų paieška ir išvesties suformavimas yra nuolatiniai poreikiai, todėl jų supratimas yra labai svarbus.

Supratimas, kaip veikia `find` (grąžina atitinkančių dokumentų kursorių, naudojamą grandinėje su `sort`/`limit`/`skip` rūšiavimui ir puslapiavimui) ir `findOne` (vieną dokumentą), yra duomenų nuskaitymo pagrindas. **Projekcija** yra ypač svarbi dėl dviejų praktinių priežasčių: **efektyvumo** (grąžinant tik reikalingus laukus sumažiniate perduodamų duomenų kiekį — tai reikšminga didelių dokumentų ar rezultatų rinkinių atveju, gerinant našumą) ir ypač **saugumo** (neįtraukiant jautrių laukų, tokių kaip slaptažodžiai ar vidiniai duomenys, kad jie nepakliūtų į užklausos rezultatus — tai bendra ir svarbi praktika, pvz., visada neįtraukti slaptažodžio laukus grąžinant vartotojų duomenis, panašiai kaip naudojant atsakų modelius API).

Supratimas, kaip įtraukti (`1`) arba neįtraukti (`0`) laukus, kad `_id` yra įtrauktas pagal numatytuosius nustatymus, ir kaip projektuoti įdėtus/masyvo laukus, apima praktinį užklausos rezultatų suformavimą.

Kadangi duomenų nuskaitymas yra dažniausiai atliekama duomenų bazės operacija, ir kadangi `find` su projekcija yra tai, kaip efektyviai ir saugiai gauti tinkamus dokumentus su tinkamais laukais, supratimas apie find užklausas ir projekcijas — kursorius, grandinę rūšiavimui/puslapiavimui ir ypač projekciją efektyvumui bei saugumui (jautrių duomenų neįtraukimui) — yra svarbus, dažnai taikytas MongoDB žinojimas bet kokiam duomenų nuskaitymo kodui, kai saugumo aspektas dėl jautrių duomenų neįtraukimo yra ypač svarbi praktinė koncepcija.