Constructor de consultas

DocStore y SegmentedLog exponen query(). DocStore puede usar índices secundarios; SegmentedLog aplica los mismos predicados a los registros transmitidos.

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

Métodos terminales útiles:

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

En DocStore, dos condiciones eq sobre campos indexados por igualdad no únicos pueden usar una cesta compuesta automática. La igualdad individual, in y los operadores de rango siguen usando los índices configurados para cada campo.

Operadores:

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

andWhere y orWhere usan funciones de devolución de llamada porque and y or son palabras clave reservadas de PHP:

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

Las llamadas encadenadas a where() se combinan con AND; cada rama de orWhere() añade una alternativa.

Cómo se ejecuta cada operación

Todas las condiciones funcionan en todas las colecciones; los índices solo cambian el coste. En DocStore, eq y in se resuelven mediante índices de igualdad; los operadores de rango y prefix se resuelven mediante índices de rango; y orderBy con limit sobre un campo con índice de rango lee en el orden del índice. Todo lo demás filtra un recorrido de registros. orderBy sobre un campo que el planificador no puede atender con un índice ordena los registros coincidentes en PHP, así que, en colecciones grandes, combínelo con condiciones indexadas. count() usa el número de entradas del índice en DocStore y los contadores en memoria en SegmentedLog cuando el filtro es una única igualdad.

cursor($id) restringe los resultados a los registros posteriores al identificador, y se combina con page() para una paginación estable ordenada por identificador de registro. Para filtros de transmisión sencillos sin el constructor, consulte Consultas.