Kyselyrakennin

DocStore ja SegmentedLog tarjoavat käyttöön query(). DocStore voi käyttää toissijaisia indeksejä; SegmentedLog soveltaa samoja ehtoja virtaaviin tietueisiin.

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

Hyödyllisiä päätetason menetelmiä:

$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();

Kohteessa DocStore kaksi eq-ehtoa ei-yksikäsitteisillä yhtäsuuruusindeksoiduilla kentillä voi käyttää automaattista yhdistelmäkoria. Yksittäinen yhtäsuuruusehto, in ja välioperaattorit käyttävät edelleen niille määritettyjä kenttäindeksejä.

Operaattorit:

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

andWhere ja orWhere käyttävät takaisinkutsuja, koska and ja or ovat varattuja PHP-avainsanoja:

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

Ketjutetut where()-kutsut yhdistyvät AND-operaatiolla; kukin orWhere()-haara lisää vaihtoehdon.

Suoritustapa

Jokainen ehto toimii kaikissa kokoelmissa; indeksit vaikuttavat vain suorituksen kustannuksiin. Kohteessa DocStore eq ja in ratkaistaan yhtäsuuruusindeksien avulla, välioperaattorit ja prefix väli-indeksien avulla, ja orderBy yhdessä ehdon limit kanssa lukee väli-indeksoitua kenttää indeksijärjestyksessä. Kaikki muu suodatetaan tietueiden läpikäynnillä. Jos suunnittelija ei voi palvella kenttää indeksistä, orderBy lajittelee osuvat tietueet muistissa arvossa PHP; suurissa kokoelmissa yhdistä se siksi indeksoituihin ehtoihin. count() käyttää indeksimerkintöjen määriä kohteessa DocStore ja muistissa olevia laskureita kohteessa SegmentedLog, kun suodatin on yksittäinen yhtäsuuruusehto.

cursor($id) rajaa tulokset tietuetunnuksen jälkeisiin tietueisiin. Yhdessä toiminnon page() kanssa se mahdollistaa vakaan sivutuksen tietuetunnuksen mukaan järjestettynä. Tavalliset virtaavat suodattimet ilman rakenninta kuvataan kohdassa Kyselyt.