Conas a oibríonn cuardaigh find agus teilgean ar bharr oscailt?

Question

Accepted Answer

Tugann an modh **`find`** na doiciméid ar ais a mheaitseálann scagaire; rialálann **teilgean** (projection) na réimsí a bheidh ar ais. Le chéile, tugann siad deis duit cuardach a dhéanamh ar an doiciméid cheart agus an t-aschur a chruthú — bunúsach do dhéanamh léamh sonraí go héifeachtúil.

## find — doiciméid a chuardach

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

Tugann `find` **imearóir** ar ais (pointeoir chuig torthaí) agus is féidir leat `sort`, `limit`, `skip`, etc. a cheangal leis. Tugann `findOne` doiciméad amháin ar ais go díreach.

## Teilgean — an réimsí atá le tabhairt ar ais a roghnú

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

Rialálann **teilgean** (an dara argóint) na réimsí ar ais a bheidh ann: tugann `1` isteach, `0` a dhíchuimhnítear. Áirítear `_id` ar bhealach réamhshocraithe (dícheal ar an deis `_id: 0`). De ghnáth ní féidir leat a mheascadh isteach agus a dhíchuimhnítear (ach amháin do `_id`).

## Cén fáth a bhfuil teilgean tábhachtach: éifeachtúlacht agus slándáil

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

## Réimsí neadaithe agus eagraithe a theilgean

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

## Cén fáth a bhfuil sé tábhachtach

Tá `find` agus teilgean bunúsach do **léamh sonraí** i MongoDB — is riachtanas leanúnach cuardach ar an doiciméid cheart agus an t-aschur a chruthú, mar sin tá tuiscint ar a bhfuil acu riachtanach eolais gach lá.

Tá a fhios agat conas a oibríonn `find` (ag tabhairt imearóir ar ais de dhocimeidí a oiriúnann, ag fagáil ar a bhfuil `sort`/`limit`/`skip` ag ceangal dó don ordú agus don leathanú) agus `findOne` (doiciméad amháin) ar bhealach an bhunáis do léamh sonraí. Tá **teilgean** an-tábhachtach do dhá bhríonna phraiticiúla: **éifeachtúlacht** (ag tabhairt ar ais díreach na réimsí a theastaíonn uait, laghdaíonn sé na sonraí aistrithe — ábhar suntasach do dhocimeidí móra nó tacairgí ar an scála, ag feabhas a dhéanamh ar dheis) agus go háirithe **slándáil** (ag foluain réimsí íogair cosúil le pasfhocal nó sonraí inmheánach ionas nach n-imeoidh siad i dtorthaí an chuardaigh — cleachtas coitianta, tábhachtach, m.sh. a bheith ag foluain i gcónaí réimsí pasfhocal nuair a bheidh úsáideoir sonraí ar ais, cosúil le húsáid a bhaint as tógla freagartha in APIanna).

Tá tuiscint ar conas a áirítear (`1`) nó a fhulaingíonn (`0`) réimsí, go bhfuil `_id` ar bhealach réamhshocraithe, agus conas a dhéantar réimsí neadaithe/eagraithe a theilgean ar an ngréine don cruthú praicticiúil ar thorthaí an chuardaigh.

Ó tharla gur is é an léamh sonraí an oibríochtaí bunaidh bunachar sonraí is coitianta, agus ó bhárr go bhfuil `find` le teilgean an dóigh ar thuig tú go héifeachtúil agus ar an slán an doiciméid cheart a fhuascailt ar na réimsí cheart, tuiscint ar chuardaigh find agus teilgean — an tsamhail imearóra, ceangal don sort/paging, agus go háirithe teilgean d'éifeachtúlacht agus do shlándáil (foluain sonraí íogair) — is riachtanas, eolas MongoDB a chuirtear i bhfeidhm go minic do ghile ar bith ag léamh sonraí-cód, agus an ghné shlándála ar dheis réimsí íogair a bheith foluain a bheith cúrsaí praicticiúla an-tábhachtach.