{"title":"FTS5-Volltextsuche","slug":"fts5-search","category":"concepts","summary":"Wie Synapse SQLite-FTS5 für sub-millisecond Volltext-Memory-Suche nutzt.","audience":["human","llm"],"tags":["concept","search","fts5","fulltext"],"difficulty":"advanced","updated":"2026-06-27","word_count":538,"read_minutes":3,"lang":"de","translated":true,"requested_lang":"de","content_markdown":"\n# FTS5-Volltextsuche\n\nSynapse verwendet FTS5 (Full-Text Search 5) für schnelle, flexible Memory-Suche.\nDiese Seite erklärt, wie es funktioniert und wie du es effektiv nutzt.\n\n## Was ist FTS5?\n\nFTS5 ist eine SQLite-Erweiterung (in PostgreSQL ebenfalls über Erweiterungen\nverfügbar), die Volltextsuche bietet. Sie:\n\n- Indiziert Textinhalte für schnelle Keyword-Suche\n- Unterstützt boolesche Operatoren (AND, OR, NOT)\n- Unterstützt Phrase-Matching mit Anführungszeichen\n- Unterstützt Präfix-Matching mit `*`\n- Bewertet Ergebnisse nach Relevanz\n\nSynapse nutzt FTS5, um alle Memory-Inhalte zu indizieren — das ermöglicht\nsub-millisecond Suche über Tausende von Memories.\n\n## Wie Synapse FTS5 nutzt\n\nWenn du `POST /memory` aufrufst:\n\n1. Memory-Inhalt wird in der `memories`-Tabelle gespeichert\n2. Inhalt wird zusätzlich in die FTS5-Virtual-Table eingefügt\n3. FTS5 tokenisiert und indiziert den Inhalt automatisch\n\nWenn du `GET /memory/search?q=...` aufrufst:\n\n1. Synapse parst die Anfrage mit FTS5-Syntax\n2. Führt ein `MATCH` gegen den FTS5-Index aus\n3. Filtert nach `mind_id` (Tenant-Isolation)\n4. Liefert bewertete Ergebnisse\n\n## Query-Syntax\n\n### Einfache Keyword-Suche\n\n```\n?q=docker\n```\n\nLiefert Memories, die „docker\" enthalten.\n\n### Mehrere Keywords (implizites AND)\n\n```\n?q=docker+swarm\n?q=docker%20swarm\n```\n\nLiefert Memories, die SOWOHL „docker\" ALS AUCH „swarm\" enthalten.\n\n### Phrase-Matching\n\n```\n?q=\"docker+swarm\"\n?q=%22docker%20swarm%22\n```\n\nLiefert Memories, die die exakte Phrase „docker swarm\" enthalten.\n\n### Präfix-Matching\n\n```\n?q=docker*\n```\n\nLiefert Memories mit Wörtern, die mit „docker\" beginnen (z. B. „dockers\",\n„dockerfile\", „dockerize\").\n\n### Boolesches OR\n\n```\n?q=docker+OR+kubernetes\n```\n\nLiefert Memories, die „docker\" ODER „kubernetes\" enthalten.\n\n### Boolesches NOT\n\n```\n?q=docker+-swarm\n?q=docker+NOT+swarm\n```\n\nLiefert Memories, die „docker\", aber NICHT „swarm\" enthalten.\n\n### Gruppierung\n\n```\n?q=(docker+OR+kubernetes)+-test\n```\n\nLiefert Memories mit „docker\" oder „kubernetes\", aber nicht „test\".\n\n## Praktische Beispiele\n\n### Memories zu einem Projekt finden\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=synapse+deployment\"\n```\n\n### Exakte Phrase finden\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=%22docker+swarm%22\"\n```\n\n### Test-Memories ausschließen\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=production+-test\"\n```\n\n### Nach Technologie suchen\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=(postgres+OR+sqlite)+-mysql\"\n```\n\n## Ranking\n\nFTS5 bewertet Ergebnisse nach Relevanz mit dem BM25-Algorithmus. Faktoren:\n\n- Term-Frequency (wie oft der Begriff vorkommt)\n- Inverse Document Frequency (seltenere Begriffe ranken höher)\n- Dokumentlänge (kürzere Docs mit dem Begriff ranken höher)\n- Spalten-Gewichtung (title > content)\n\nErgebnisse werden in Reihenfolge des Rankings zurückgegeben (relevanteste zuerst).\n\n## Performance\n\n| Operation | Latenz |\n|-----------|--------|\n| 100 Memories durchsuchen | < 5ms |\n| 1.000 Memories durchsuchen | < 10ms |\n| 10.000 Memories durchsuchen | < 25ms |\n| 100.000 Memories durchsuchen | < 100ms |\n\nFTS5 ist stark für lese-lastige Workloads optimiert.\n\n## Einschränkungen\n\n### Stemming\n\nFTS5 macht standardmäßig kein Stemming. „running\" und „run\" sind unterschiedliche\nBegriffe.\n\n**Workaround:** Präfix-Matching verwenden: `?q=run*`\n\n### Tippfehler-Toleranz\n\nFTS5 unterstützt kein Fuzzy-Matching. Ein Tippfehler liefert keine Ergebnisse.\n\n**Workaround:** Verwende semantische Suche (`/memory/semantic-search`) für\nkonzeptionelles Matching.\n\n### Stoppwörter\n\nHäufige Wörter (the, a, an, is) werden indiziert, sind aber für die Suche\nmeist nicht nützlich. FTS5 behandelt das automatisch.\n\n## FTS5 vs semantische Suche\n\n| Aspekt | FTS5 | Semantische Suche |\n|--------|------|-------------------|\n| Geschwindigkeit | Sub-millisecond | 50-100ms |\n| Matching | Exakte Keywords | Konzeptionell |\n| Tippfehler-Toleranz | Keine | Etwas |\n| Stemming | Keins | Implizit |\n| Benötigt Embeddings | Nein | Ja |\n| Optimal für | Spezifische Begriffe | Konzepte |\n\nVerwende FTS5, wenn du die Keywords kennst. Verwende semantische Suche, wenn du\n„Memories über X\" suchst und X anders beschrieben wird.\n\n## Best Practices\n\n> [!TIP]\n> - **Verwende spezifische Begriffe** — „docker swarm\" schlägt „container orchestration\"\n> - **Phrasen in Anführungszeichen** — `\"docker swarm\"` sichert Phrase-Match\n> - **Präfix für Variationen** — `deploy*` erfasst „deploy\", „deployment\", „deploying\"\n> - **Noise ausschließen** — `-test` filtert Test-Memories heraus\n> - **Mit Tags kombinieren** — `?q=docker&tag=production` schränkt Ergebnisse ein\n\n## Nächste Schritte\n\n- [Semantische Suche](/docs/concepts/semantic-search)\n- [Memory-API](/docs/api/memory)\n- [Memory-Best-Practices](/docs/guides/memory-best-practices)\n","content_html":"

FTS5-Volltextsuche

\n

Synapse verwendet FTS5 (Full-Text Search 5) für schnelle, flexible Memory-Suche.\nDiese Seite erklärt, wie es funktioniert und wie du es effektiv nutzt.

\n

Was ist FTS5?

\n

FTS5 ist eine SQLite-Erweiterung (in PostgreSQL ebenfalls über Erweiterungen\nverfügbar), die Volltextsuche bietet. Sie:

\n\n

Synapse nutzt FTS5, um alle Memory-Inhalte zu indizieren — das ermöglicht\nsub-millisecond Suche über Tausende von Memories.

\n

Wie Synapse FTS5 nutzt

\n

Wenn du POST /memory aufrufst:

\n
    \n
  1. Memory-Inhalt wird in der memories-Tabelle gespeichert
    2. \n
  2. Inhalt wird zusätzlich in die FTS5-Virtual-Table eingefügt
    3. \n
  3. FTS5 tokenisiert und indiziert den Inhalt automatisch
    4. \n
\n

Wenn du GET /memory/search?q=... aufrufst:

\n
    \n
  1. Synapse parst die Anfrage mit FTS5-Syntax
    2. \n
  2. Führt ein MATCH gegen den FTS5-Index aus
    3. \n
  3. Filtert nach mind_id (Tenant-Isolation)
    4. \n
  4. Liefert bewertete Ergebnisse
    5. \n
\n

Query-Syntax

\n

Einfache Keyword-Suche

\n
?q=docker

Liefert Memories, die „docker" enthalten.

\n

Mehrere Keywords (implizites AND)

\n
?q=docker+swarm\n?q=docker%20swarm

Liefert Memories, die SOWOHL „docker" ALS AUCH „swarm" enthalten.

\n

Phrase-Matching

\n
?q="docker+swarm"\n?q=%22docker%20swarm%22

Liefert Memories, die die exakte Phrase „docker swarm" enthalten.

\n

Präfix-Matching

\n
?q=docker*

Liefert Memories mit Wörtern, die mit „docker" beginnen (z. B. „dockers",\n„dockerfile", „dockerize").

\n

Boolesches OR

\n
?q=docker+OR+kubernetes

Liefert Memories, die „docker" ODER „kubernetes" enthalten.

\n

Boolesches NOT

\n
?q=docker+-swarm\n?q=docker+NOT+swarm

Liefert Memories, die „docker", aber NICHT „swarm" enthalten.

\n

Gruppierung

\n
?q=(docker+OR+kubernetes)+-test

Liefert Memories mit „docker" oder „kubernetes", aber nicht „test".

\n

Praktische Beispiele

\n

Memories zu einem Projekt finden

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/search?q=synapse+deployment"

Exakte Phrase finden

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/search?q=%22docker+swarm%22"

Test-Memories ausschließen

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/search?q=production+-test"

Nach Technologie suchen

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/search?q=(postgres+OR+sqlite)+-mysql"

Ranking

\n

FTS5 bewertet Ergebnisse nach Relevanz mit dem BM25-Algorithmus. Faktoren:

\n\n

Ergebnisse werden in Reihenfolge des Rankings zurückgegeben (relevanteste zuerst).

\n

Performance

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
OperationLatenz
100 Memories durchsuchen< 5ms
1.000 Memories durchsuchen< 10ms
10.000 Memories durchsuchen< 25ms
100.000 Memories durchsuchen< 100ms
\n

FTS5 ist stark für lese-lastige Workloads optimiert.

\n

Einschränkungen

\n

Stemming

\n

FTS5 macht standardmäßig kein Stemming. „running" und „run" sind unterschiedliche\nBegriffe.

\n

Workaround: Präfix-Matching verwenden: ?q=run*

\n

Tippfehler-Toleranz

\n

FTS5 unterstützt kein Fuzzy-Matching. Ein Tippfehler liefert keine Ergebnisse.

\n

Workaround: Verwende semantische Suche (/memory/semantic-search) für\nkonzeptionelles Matching.

\n

Stoppwörter

\n

Häufige Wörter (the, a, an, is) werden indiziert, sind aber für die Suche\nmeist nicht nützlich. FTS5 behandelt das automatisch.

\n

FTS5 vs semantische Suche

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
AspektFTS5Semantische Suche
GeschwindigkeitSub-millisecond50-100ms
MatchingExakte KeywordsKonzeptionell
Tippfehler-ToleranzKeineEtwas
StemmingKeinsImplizit
Benötigt EmbeddingsNeinJa
Optimal fürSpezifische BegriffeKonzepte
\n

Verwende FTS5, wenn du die Keywords kennst. Verwende semantische Suche, wenn du\n„Memories über X" suchst und X anders beschrieben wird.

\n

Best Practices

\n

Nächste Schritte

\n\n","urls":{"html":"/docs/concepts/fts5-search","text":"/docs/concepts/fts5-search?format=text","json":"/docs/concepts/fts5-search?format=json","llm":"/docs/concepts/fts5-search?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}