aYOUne

ay search

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 — primitive Listenanzeige
  • aggregate — komplexe Pipelines
  • export — größere Datenmengen exportieren