Plnění dat přes Seeders, Eager Loading with() a prevence problému N+1

Idempotentní Seeders a zabiják výkonu: Problém N+1 dotazů

Správa databázových dat zahrnuje dva klíčové koncepty: jak data spolehlivě do databáze dostat (Seeders) a jak je při čtení načítat tak, aby aplikace nezkolabovala pod tíhou stovek zbytečných SQL dotazů (Eager Loading).

V této lekci prozkoumáme kód našeho DatabaseSeeder a kontroléru CourseController.

1. Zlaté pravidlo Seederů: Vždy pište idempotentní kód

Při nasazení aplikace a v CI/CD pipelinách potřebujete spouštět seeder opakovaně bez obav, že databáze selže na chybě Integrity constraint violation: UNIQUE constraint failed.

Proto v našich seederech nepoužíváme CourseLesson::create([...]), ale metodu updateOrCreate():

$module = CourseModule::updateOrCreate(
    ['slug' => 'postgresql-migrace-a-eloquent-orm'], // Hledací kritérium
    [
        'number' => 6,
        'title' => '...',
        // ... Aktualizované atributy
    ]
);

Pokud modul se zadaným slug existuje, Eloquent jej pouze aktualizuje novými texty z kódu. Pokud neexistuje, vytvoří jej. Stejně tak u kvízových otázek nejprve provedeme $lesson->quizQuestions()->delete() a následně $lesson->quizQuestions()->createMany([...]). Seeder je tak 100% idempotentní – můžete jej spustit stokrát za sebou a výsledek bude vždy identický.

2. Noční můra vývojářů: N+1 Query Problem

Představte si, že v šabloně vypisujete přehled všech 10 modulů a u každého chcete zobrazit seznam jeho lekcí a u každé lekce počet kvízových otázek:

{{-- ❌ ŠPATNĚ: Typická N+1 past --}}
@foreach($modules as $module)
    <h2>{{ $module->title }}</h2>
    @foreach($module->lessons as $lesson)
        <p>{{ $lesson->title }} (otázek: {{ $lesson->quizQuestions->count() }})</p>
    @endforeach
@endforeach

Co se stane, pokud v controlleru načtete data prostým $modules = CourseModule::all();?

1. Spustí se 1 dotaz na načtení modulů: SELECT * FROM course_modules; (vrátí např. 10 řádků).
2. Při průchodu cyklem se pro každý modul spustí samostatný SQL dotaz: SELECT * FROM course_lessons WHERE course_module_id = 1; (10 dotazů).
3. Uvnitř pro každou z celkových 30 lekcí se spustí další dotaz: SELECT * FROM quiz_questions WHERE course_lesson_id = 1; (30 dotazů).

Výsledek? Pro zobrazení jedné jednoduché stránky odeslala aplikace do PostgreSQL 41 samostatných SQL dotazů! Při větším počtu dat se aplikace fatálně zpomalí kvůli síťové latenci spojení s databází.

3. Řešení: Eager Loading s metodou with()

Eloquent nabízí elegantní řešení zvané Eager Loading (dopředné načtení). Místo líného dotazování v cyklu (Lazy Loading) řekneme Eloquentu předem, jaké vazby budeme potřebovat.

Podívejte se do našeho souboru app/Http/Controllers/CourseController.php:

public function index(Request $request, StudentProgressService $progressService): View
{
    $modules = CourseModule::with(['lessons.quizQuestions'])
        ->orderBy('number')
        ->get();

    // ...
}

Díky tečkové notaci lessons.quizQuestions v metodě with() Eloquent provede přesně 3 SQL dotazy:

1. SELECT * FROM course_modules ORDER BY number;
2. SELECT * FROM course_lessons WHERE course_module_id IN (1, 2, 3, 4, 5, 6, 7, 8, 9, 10) ORDER BY number;
3. SELECT * FROM quiz_questions WHERE course_lesson_id IN (1, 2, 3, ..., 30) ORDER BY position;

Ať už máte v databázi 10 nebo 10 000 lekcí, počet SQL dotazů zůstává konstantní: přesně 3. Eloquent načtené objekty sám v paměti pospojuje do příslušných relačních kolekcí.