Конструктор на заявки

DocStore и SegmentedLog предоставят query(). DocStore може да използва вторични индекси; SegmentedLog прилага същите предикати върху поточно извличани записи.

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

Полезни крайни методи:

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

При DocStore две условия eq върху полета с индекси за равенство, които не са уникални, могат да използват автоматична комбинирана група. Единичното равенство, in и операторите за диапазон продължават да използват конфигурираните индекси на полетата си.

Оператори:

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

andWhere и orWhere използват обратни извиквания, защото and и or са запазени PHP ключови думи:

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

Последователните извиквания на where() се комбинират с AND; всеки клон orWhere() добавя алтернатива.

Как се изпълняват заявките

Всяко условие работи с всяка колекция; индексите променят само цената на изпълнението. При DocStore eq и in се разрешават чрез индекси за равенство, операторите за диапазон и prefix — чрез индекси за диапазон, а orderBy с limit върху поле с индекс за диапазон чете в реда на индекса. Всичко останало филтрира сканиране на записите. orderBy върху поле, което планировчикът не може да обслужи чрез индекс, сортира съвпадащите записи в PHP, затова при големи колекции го комбинирайте с индексни условия. count() използва броя на индексните записи в DocStore и броячи в паметта в SegmentedLog, когато филтърът е единично равенство.

cursor($id) ограничава резултатите до записи след идентификатора и се комбинира с page() за стабилно странично прелистване, подредено по идентификатор на запис. За обикновени поточни филтри без конструктора вижте Заявки.