Query Builder

DocStore dan SegmentedLog menyediakan query(). DocStore dapat menggunakan indeks sekunder; SegmentedLog menerapkan predikat yang sama pada catatan yang dialirkan.

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

Metode terminal yang berguna:

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

Pada DocStore, dua kondisi eq pada kolom berindeks kesetaraan non-unik dapat menggunakan bucket gabungan otomatis. Kesetaraan tunggal, in, dan operator rentang tetap menggunakan indeks kolom yang dikonfigurasi.

Operator:

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

andWhere dan orWhere menggunakan callback karena and dan or adalah kata kunci PHP yang dicadangkan:

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

Pemanggilan where() berantai digabungkan dengan AND; setiap cabang orWhere() menambahkan alternatif.

Cara kerja eksekusi

Setiap kondisi berfungsi pada setiap koleksi; indeks hanya mengubah biayanya. Pada DocStore, eq dan in menggunakan indeks kesetaraan, operator rentang dan prefix menggunakan indeks rentang, dan orderBy dengan limit pada kolom berindeks rentang membaca sesuai urutan indeks. Selebihnya memfilter pemindaian catatan. orderBy pada kolom yang tidak dapat dilayani planner dengan indeks akan mengurutkan catatan yang cocok di PHP, jadi untuk koleksi besar, padukan dengan kondisi berindeks. count() menggunakan jumlah entri indeks pada DocStore dan penghitung dalam memori pada SegmentedLog jika filternya berupa satu kesetaraan.

cursor($id) membatasi hasil ke catatan setelah ID tersebut, dan dapat digabungkan dengan page() untuk paginasi stabil yang diurutkan berdasarkan ID catatan. Untuk filter streaming biasa tanpa builder, lihat Kueri.