Querybuilder

DocStore en SegmentedLog bieden query(). DocStore kan secundaire indexen gebruiken; SegmentedLog past dezelfde predicaten toe op gestreamde records.

$records = $docs
    ->query()
    ->where('kind')->eq('page')
    ->where('status')->in(['draft', 'published'])
    ->where('publishedAt')->between($from, $until)
    ->orderBy('publishedAt', 'desc')
    ->limit(50)
    ->get();

Handige terminalmethoden:

$docs->query()->where('slug')->eq('home')->first();
$docs->query()->where('kind')->eq('page')->count();
$docs->query()->cursor($lastId)->page(100)->get();
$docs->query()->where('slug')->eq('home')->explain();

Op DocStore kunnen twee eq-voorwaarden op velden met een niet-unieke gelijkheidsindex een automatische samengestelde bucket gebruiken. Enkelvoudige gelijkheid, in en bereikoperatoren blijven hun geconfigureerde veldindexen gebruiken.

Operatoren:

• eq, neq
• in, notIn
• gt, gte, lt, lte, between
• exists, missing
• prefix
• andWhere, orWhere
• orderBy, limit, cursor, page

andWhere en orWhere gebruiken callbacks omdat and en or gereserveerde PHP-trefwoorden zijn:

$docs->query()
    ->where('kind')->eq('page')
    ->orWhere(fn ($q) => $q->where('kind')->eq('post')->where('featured')->eq(true))
    ->get();

Aaneengeschakelde aanroepen van where() worden gecombineerd met AND; elke orWhere()-vertakking voegt een alternatief toe.

Hoe bewerkingen worden uitgevoerd

Elke voorwaarde werkt op elke collectie; indexen veranderen alleen de kosten. Op DocStore worden eq en in afgehandeld met gelijkheidsindexen, de bereikoperatoren en prefix met bereikindexen, en leest orderBy met limit op een veld met een bereikindex in indexvolgorde. Al het overige wordt toegepast op een recordscan. orderBy op een veld waarvoor de planner geen index kan gebruiken, sorteert de overeenkomende records in PHP. Combineer deze bewerking daarom in grote collecties met geïndexeerde voorwaarden. count() gebruikt het aantal indexvermeldingen op DocStore en tellers in het geheugen op SegmentedLog wanneer het filter één gelijkheidsvoorwaarde bevat.

cursor($id) beperkt resultaten tot records na de ID en kan worden gecombineerd met page() voor stabiele paginering op record-ID. Zie Queries voor gewone streamingfilters zonder de builder.