Mikä on kyselyrakentaja ja miten se liittyy Eloquentiin?

Question

Accepted Answer

Laravelin **Query Builder** on sujuva, ketjutettava liittymä tietokantakyselyjen rakentamiseen ja suorittamiseen ilman raakaSQL:n kirjoittamista. **Eloquent on rakennettu Query Builderin päälle** — Eloquent-mallit käyttävät sitä taustalla, ja Eloquent-kyselyt voivat käyttää kaikkia Query Builderin metodeja.

## Query Builder (tietokantatasoinen, DB-fassadin kautta)

```php
use Illuminate\Support\Facades\DB;

DB::table('users')
    ->where('active', true)
    ->where('age', '>', 18)
    ->orderBy('name')
    ->limit(10)
    ->get();                          // returns generic objects (not models)

DB::table('users')->where('id', 1)->update(['name' => 'X']);
DB::table('users')->insert(['name' => 'Ann']);
```

Query Builder toimii suoraan taulukoiden kanssa (palauttaa tavallisia objekteja, ei Eloquent-malleja). Se on ketjutettava ja **käyttää automaattisesti parametrisidontaa** — ehkäisten SQL-injektiot.

## Eloquent käyttää samoja sujuvia metodeja

```php
// Eloquent queries support ALL Query Builder methods (it's built on top)
User::where('active', true)
    ->where('age', '>', 18)
    ->orderBy('name')
    ->get();                          // returns User MODELS (with relationships, etc.)
```

Kun ketjutat metodeja Eloquent-mallissa, käytät Query Builderia taustalla — mutta saat takaisin **malleja** (suhteilla, aksessoreilla ja metodeilla) tavallisten objektien sijaan.

## Edistyneet kyselyt (molemmat tukevat näitä)

```php
DB::table('orders')
    ->join('users', 'orders.user_id', '=', 'users.id')   // joins
    ->select('orders.*', 'users.name')
    ->where('orders.total', '>', 100)
    ->groupBy('users.id')
    ->havingRaw('SUM(orders.total) > 1000')
    ->get();

User::where('role', 'admin')
    ->orWhere('role', 'editor')
    ->whereIn('status', ['active', 'pending'])
    ->get();
```

Molemmat tukevat liitoksia, aggregaatteja, alikyselyitä ja monimutkaisia ehtoja.

## Milloin käyttää kumpaa

```text
Eloquent (Model::...) → the default — get models with relationships/accessors/methods.
                        Best for most application logic.
Query Builder (DB::table) → when you want lightweight queries without model overhead,
                            complex reporting/aggregations, or to avoid loading models.
```

## Miksi se on tärkeää

Query Builderin ja sen suhteen Eloquentiin ymmärtäminen on tärkeää tehokkaan tietokannan käsittelyn kannalta Laravelissa ja oikean työkalun valitsemisen kannalta jokaisessa tilanteessa.

Avainajatus on, että **Eloquent on rakennettu Query Builderiin** — joten sujuvat, ketjutettavat metodit, joita käytät Eloquent-malleissa (`where`, `orderBy`, `join` jne.), ovat Query Builderin metodeja, mikä tarkoittaa, että toisen oppiminen opettaa sinulle molemmat.

Query Builder tarjoaa puhtaan, SQL-injektiota turvallisen (automaattisen parametrisidonnan kautta) tavan kyselyiden rakentamiseen ilman raakaSQL:n kirjoittamista, ja Eloquent lisää mallin toiminnallisuuden (suhteet, aksesorit, metodit) sen päälle.

Tietäminen **milloin käyttää kumpaa** on käytännön taito: **Eloquent** useimpaan sovelluksen logiikkaan (saat rikkaita mallin objekteja suhteilla ja käyttäytymisellä), ja **Query Builder suoraan** (`DB::table`) kevyisiin kyselyihin ilman mallin ylikuormitusta, monimutkaiseen raportointiin/aggregaatioihin tai kun et tarvitse täysiä malleja — jotka voivat olla tehokkaampia tietyissä tapauksissa.

Molemmat käsittelevät turvallisesti monimutkaisia kyselyitä (liitokset, aggregaatit, alikyselyt) samalla sujuvalla ohjelmointirajapinnalla.

Query Builderin ymmärtäminen, kuinka Eloquent rakentuu sen päälle, jaettu turvallinen parametrisidonta (SQL-injektiot estetään) ja valinta niiden välillä on tärkeää tietoa tehokkaan ja turvallisen tietokannan käsittelyn kirjoittamiseen Laravelissa, koska tietokantakäyttö on keskeistä useimpiin sovelluksiin ja sopivan tason valitseminen (mallirikkaasti Eloquent vs. kevyt Query Builder) vaikuttaa sekä selkeyteen että suorituskykyyn.