Generatore di query

DocStore e SegmentedLog espongono query(). DocStore può usare indici secondari; SegmentedLog applica gli stessi predicati ai record trasmessi in streaming.

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

Metodi terminali utili:

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

Su DocStore, due condizioni eq su campi indicizzati per uguaglianza non univoci possono usare un bucket composto automatico. Le condizioni di uguaglianza singole, in e gli operatori per intervallo continuano a usare gli indici configurati per i campi.

Operatori:

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

andWhere e orWhere usano callback perché and e or sono parole chiave riservate PHP:

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

Le chiamate concatenate a where() si combinano con AND; ogni ramo orWhere() aggiunge un'alternativa.

Modalità di esecuzione

Ogni condizione funziona su ogni raccolta; gli indici cambiano solo il costo. Su DocStore, eq e in vengono risolti tramite indici di uguaglianza, gli operatori per intervallo e prefix tramite indici per intervallo, mentre orderBy con limit su un campo indicizzato per intervallo legge seguendo l'ordine dell'indice. Tutto il resto filtra una scansione dei record. orderBy su un campo che il pianificatore non può servire tramite un indice ordina i record corrispondenti in PHP; perciò, sulle raccolte grandi, abbinatelo a condizioni indicizzate. count() usa il numero di voci dell'indice su DocStore e i contatori in memoria su SegmentedLog quando il filtro è una singola uguaglianza.

cursor($id) limita i risultati ai record successivi all'ID, e si combina con page() per una paginazione stabile ordinata per ID del record. Per filtri in streaming semplici senza il generatore, consultate Query.