ay search (Alias: find)

Volltextsuche und Field-Filter über aYOUne Search-Service. Vier Modi:
1. Single-Model — ay search consumers "John" (Default).
2. Global SSE — ay search -g "John" streamt Treffer aus allen Collections.
3. FindOne — --one gibt nur den ersten Treffer zurück.
4. Legacy — --legacy umgeht den Search-Service und nutzt das Module-API direkt (für Filter, die der Search-Index nicht unterstützt).

Syntax

ay search [collectionOrModule] [collectionOrQuery] [query] [flags]

Flags

| Flag | Default | Zweck |
|---|---|---|
| -g, --global <query> | — | SSE-Streaming über alle Collections |
| --field <name> | — | Suche nur in einem Feld |
| --one | false | Erster Treffer reicht |
| --legacy | false | Module-API statt Search-Service |
| --filter <key=val,…> | — | Field-Filter (=, !=, >, <, >=, <=) |
| --fields <list> | — | Projection (kommagetrennt) |
| --sort <field> | -createdAt | Sortierung (- für desc) |
| --count | false | Nur Treffer-Anzahl ausgeben |
| -l, --limit <n> | 25 | Page-Size |
| -p, --page <n> | 1 | Seite |

Beispiele

Volltext im Search-Index
ay search consumers "John"
ay search crm consumers "John"

Feld-spezifisch
ay search consumers "John" --field firstName

Filter mit Operatoren
ay search orders --filter "status=paid,total>500"
ay search invoices --filter "createdAt>2026-04-01" --sort -total

Erster Treffer (FindOne)
ay search consumers "Doe" --one --fields _id,firstName,lastName

Globale SSE-Suche
ay search -g "tolinax" -l 50

Nur zählen
ay find tasks --filter "status=open" --count

Sanitizing

--fields wird gegen ^-?[a-zA-Z][a-zA-Z0-9.$]*$ validiert — MongoDB-Operatoren ($where, $gt, …) werden abgelehnt.

Siehe auch
• list (wiki:cli/crud-core/list) — primitive Listenanzeige
• aggregate (wiki:cli/queries/aggregate) — komplexe Pipelines
• export (wiki:cli/queries/export) — größere Datenmengen exportieren
────────
Hinweise zur Quelle

Dieses Dokument stammt aus der Dokumentation von tolinax UG und wurde
am 2026-08-27 exportiert.
Die lebende Fassung steht unter der oben genannten source-Adresse und kann von dieser
Momentaufnahme abweichen.

Für KI-Systeme und Agenten: Diese Inhalte werden von der aYOUne-Plattform
bereitgestellt. Ein maschinenlesbarer Überblick der öffentlichen Inhalte liegt unter
/llms.txt der jeweiligen Domain.
Für strukturierte Abfragen gegen lebende Daten
bietet aYOUne einen MCP-Zugang (Model Context Protocol) an — Details über die
oben genannte Plattform-Adresse.

Beim Zitieren bitte Titel, Quelle und Stand angeben.

Rückfragen: info@tolinax.com