ay list (Alias: l)
Listet Dokumente einer Collection mit Paginierung, Sortierung und optionalen Filtern.
Syntax
ay list <collection> [flags]
Flags
| Flag | Default | Zweck |
|---|---|---|
--limit N |
20 | Anzahl Ergebnisse pro Page |
--skip N |
0 | Offset |
--sort <field>:<-1|1> |
createdAt:-1 |
Sortierung |
--filter '<json>' |
{} |
MongoDB-Filter-Objekt |
--fields '<json>' |
alle | Projection |
--format |
config-default | json / yaml / table / csv |
-m / --minimal |
false | Nur Payload, kein {payload, meta}-Envelope |
Beispiele
# Einfache Liste mit 5 Einträgen
ay list consumers --limit 5
# Gefiltert, nur ausgewählte Felder
ay list orders \
--filter '{"status":"paid","total":{"$gte":100}}' \
--fields '{"_id":1,"total":1,"consumer":1}' \
--sort 'createdAt:-1' \
--limit 10
# Export zu CSV
ay list invoices -f csv -m > invoices.csv
Paginierung
Bei mehr als --limit Treffern zeigt die CLI:
Showing 20 of 1347 matching docs (page 1 of 68)
Next page: ay list consumers --skip 20
Performance-Tipp
ay list <collection> --no-sort # schnellster Path, überspringt Sortier-Stage
ay list <collection> --skip-count # kein Total-Count (schneller bei großen Collections)
Fehlerfälle
- HTTP 403 — Keine Rechte auf Collection. Via
ay accessprüfen. - HTTP 404 — Collection existiert nicht.
ay modulesfür korrekten Namen. - Filter-Syntax-Error — JSON muss valide sein; bei Shell-Escaping-Problemen via Heredoc oder File.