Miten find-kyselyt ja projektiot toimivat?

Question

Accepted Answer

**`find`**-metodi hakee dokumentteja, jotka vastaavat suodatinta; **projektio** hallitsee, mitkä kentät palautetaan. Yhdessä ne mahdollistavat oikeiden dokumenttien hakemisen ja tulosmuodon muodostamisen — perusasiat tiedon tehokkaalle lukemiselle.

## find — dokumenttien hakeminen

```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` palauttaa **kursorin** (osoittimen tuloksiin), jonka kanssa voit ketjuttaa `sort`, `limit`, `skip` jne. `findOne` palauttaa yhden dokumentin suoraan.

## Projektio — valitse palautettavat kentät

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

**Projektio** (toinen argumentti) hallitsee palautettavia kenttiä: `1` sisällyttää, `0` poissulkee. `_id` sisällytetään oletuksena (poissulkeminen `_id: 0` avulla). Yleensä et voi sekoittaa sisällytyksiä ja poissulkemisia (paitsi `_id`-kentälle).

## Miksi projektio on tärkeää: tehokkuus ja turvallisuus

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

## Sisäkkäisten ja array-kenttien projektio

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

## Miksi se on tärkeää

`find` ja projektio ovat perusasioita **tiedon lukemiselle** MongoDBssa — oikeiden dokumenttien hakeminen ja tulosmuodon muodostaminen ovat vakiovaatimuksia, joten niiden ymmärtäminen on olennaista päivittäistä tietoa.

Ymmärtäminen siitä, miten `find` toimii (palauttaa kursorin vastaaville dokumenteille, ketjutettavissa `sort`/`limit`/`skip`-toiminnoilla lajittelua ja sivutusta varten) ja `findOne` (yksittäinen dokumentti) on tiedon lukemisen perusta. **Projektio** on erityisen tärkeä kahdesta käytännön syystä: **tehokkuus** (vain tarvittavien kenttien palauttaminen vähentää siirtää dataa — merkittävää suurille dokumenteille tai tulosjoukkoille, parantaa suorituskykyä) ja erityisesti **turvallisuus** (herkkien kenttien, kuten salasanojen tai sisäisten tietojen, poissulkeminen, jotta ne eivät vuoda kyselyjen tuloksissa — yleinen, tärkeä käytäntö, esim. aina salasanakentät projisoimatta kun palautetaan käyttäjätietoja, samanlaista kuin vastemallit API:issa).

Ymmärrys siitä, miten kenttien sisällyttäminen (`1`) tai poissulkeminen (`0`), että `_id` sisällytetään oletuksena, ja miten sisäkkäisten/array-kenttien projektio toimii, kattaa kyselytulosten käytännön muodostamisen.

Koska tiedon lukeminen on yleisin tietokantaoperaatio, ja koska `find` projektion kanssa on tapa, jolla haet tehokkaasti ja turvallisesti oikeat dokumentit oikeilla kentillä, ymmärtäminen find-kyselyistä ja projektiosta — kursori-malli, ketjutus lajittelua ja sivutusta varten, ja erityisesti projektio tehokkuuden ja turvallisuuden kannalta (herkkien tietojen poissulkeminen) — on olennaista, usein sovellettavaa MongoDB-tietoa mille tahansa tiedon lukemiseen käytettävälle koodille, ja turvallisuuden näkökulma herkkien kenttien projisoimatta jättämisestä on erityisen tärkeä käytännön näkökohta.