{"title":"FTS5 fulltextssökning","slug":"fts5-search","category":"concepts","summary":"Hur Synapse använder SQLite FTS5 för fulltextssökning av minnen under en millisekund.","audience":["human","llm"],"tags":["concept","search","fts5","fulltext"],"difficulty":"advanced","updated":"2026-06-27","word_count":549,"read_minutes":3,"lang":"sv","translated":true,"requested_lang":"sv","content_markdown":"\n# FTS5 fulltextssökning\n\nSynapse använder FTS5 (Full-Text Search 5) för snabb, flexibel minnessökning.\nDen här sidan förklarar hur det fungerar och hur man använder det effektivt.\n\n## Vad är FTS5?\n\nFTS5 är ett SQLite-tillägg (även tillgängligt i PostgreSQL via tillägg) som\ntillhandahåller fulltextssökningsfunktionalitet. Det:\n\n- Indexerar textinnehåll för snabb nyckelordssökning\n- Stöder booleska operatorer (AND, OR, NOT)\n- Stöder frasmatchning med citattecken\n- Stöder prefixmatchning med `*`\n- Rankar resultat efter relevans\n\nSynapse använder FTS5 för att indexera allt minnesinnehåll, vilket möjliggör\nsökning under en millisekund över tusentals minnen.\n\n## Hur Synapse använder FTS5\n\nNär ni gör `POST /memory`:\n\n1. Minnesinnehåll lagras i `memories`-tabellen\n2. Innehåll infogas också i FTS5 virtuell tabell\n3. FTS5 tokeniserar och indexerar innehållet automatiskt\n\nNär ni gör `GET /memory/search?q=...`:\n\n1. Synapse tolkar frågan med FTS5-syntax\n2. Kör en `MATCH` mot FTS5-indexet\n3. Filtrerar efter `mind_id` (klientisolation)\n4. Returnerar rankade resultat\n\n## Frågesyntax\n\n### Enkel nyckelordssökning\n\n```\n?q=docker\n```\n\nReturnerar minnen som innehåller \"docker\".\n\n### Flera nyckelord (implicit AND)\n\n```\n?q=docker+swarm\n?q=docker%20swarm\n```\n\nReturnerar minnen som innehåller BÅDE \"docker\" OCH \"swarm\".\n\n### Frasmatchning\n\n```\n?q=\"docker+swarm\"\n?q=%22docker%20swarm%22\n```\n\nReturnerar minnen som innehåller den exakta frasen \"docker swarm\".\n\n### Prefixmatchning\n\n```\n?q=docker*\n```\n\nReturnerar minnen som innehåller ord som börjar med \"docker\" (t.ex. \"dockers\",\n\"dockerfile\", \"dockerize\").\n\n### Boolesk OR\n\n```\n?q=docker+OR+kubernetes\n```\n\nReturnerar minnen som innehåller \"docker\" ELLER \"kubernetes\".\n\n### Boolesk NOT\n\n```\n?q=docker+-swarm\n?q=docker+NOT+swarm\n```\n\nReturnerar minnen som innehåller \"docker\" men INTE \"swarm\".\n\n### Gruppering\n\n```\n?q=(docker+OR+kubernetes)+-test\n```\n\nReturnerar minnen som innehåller \"docker\" eller \"kubernetes\", men inte \"test\".\n\n## Praktiska exempel\n\n### Hitta minnen om ett projekt\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=synapse+deployment\"\n```\n\n### Hitta exakt fras\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=%22docker+swarm%22\"\n```\n\n### Uteslut testminnen\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=production+-test\"\n```\n\n### Hitta efter teknik\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## Rankning\n\nFTS5 rankar resultat efter relevans med BM25-algoritmen. Faktorer:\n\n- Termfrekvens (hur ofta termen förekommer)\n- Inverse document frequency (sällsynta termer rankas högre)\n- Dokumentlängd (kortare dokument med termen rankas högre)\n- Kolumnvikt (title > content)\n\nResultat returneras i rankningsordning (mest relevant först).\n\n## Prestanda\n\n| Åtgärd | Latens |\n|-----------|---------|\n| Sök 100 minnen | < 5 ms |\n| Sök 1 000 minnen | < 10 ms |\n| Sök 10 000 minnen | < 25 ms |\n| Sök 100 000 minnen | < 100 ms |\n\nFTS5 är högt optimerat för läsintensiva arbetsbelastningar.\n\n## Begränsningar\n\n### Stamning\n\nFTS5 gör inte stamning som standard. \"running\" och \"run\" är olika termer.\n\n**Lösning:** Använd prefixmatchning: `?q=run*`\n\n### Tolerans mot felstavning\n\nFTS5 stöder inte oskarp matchning. En felstavning returnerar inga resultat.\n\n**Lösning:** Använd semantisk sökning (`/memory/semantic-search`) för\nbegreppsmatchning.\n\n### Stopword\n\nVanliga ord (the, a, an, is) indexeras men kanske inte är användbara för\nsökning. FTS5 hanterar detta automatiskt.\n\n## FTS5 vs semantisk sökning\n\n| Aspekt | FTS5 | Semantisk sökning |\n|--------|------|-----------------|\n| Hastighet | Under en millisekund | 50–100 ms |\n| Matchning | Exakta nyckelord | Begreppslig |\n| Tolerans mot felstavning | Ingen | Någon |\n| Stamning | Ingen | Implicit |\n| Kräver inbäddningar | Nej | Ja |\n| Bäst för | Specifika termer | Begrepp |\n\nAnvänd FTS5 när ni känner till nyckelorden. Använd semantisk sökning när ni\nvill ha \"minnen om X\" där X beskrivs på ett annat sätt.\n\n## Bästa praxis\n\n> [!TIP]\n> - **Använd specifika termer** — \"docker swarm\" slår \"container orchestration\"\n> - **Citera fraser** — `\"docker swarm\"` säkerställer frasmatchning\n> - **Använd prefix för variationer** — `deploy*` fångar \"deploy\", \"deployment\", \"deploying\"\n> - **Uteslut brus** — `-test` filtrerar bort testminnen\n> - **Kombinera med taggar** — `?q=docker&tag=production` snävar in resultatet\n\n## Nästa steg\n\n- [Semantisk sökning](/docs/concepts/semantic-search)\n- [Memory API](/docs/api/memory)\n- [Minnesbästa praxis](/docs/guides/memory-best-practices)\n","content_html":"

FTS5 fulltextssökning

\n

Synapse använder FTS5 (Full-Text Search 5) för snabb, flexibel minnessökning.\nDen här sidan förklarar hur det fungerar och hur man använder det effektivt.

\n

Vad är FTS5?

\n

FTS5 är ett SQLite-tillägg (även tillgängligt i PostgreSQL via tillägg) som\ntillhandahåller fulltextssökningsfunktionalitet. Det:

\n\n

Synapse använder FTS5 för att indexera allt minnesinnehåll, vilket möjliggör\nsökning under en millisekund över tusentals minnen.

\n

Hur Synapse använder FTS5

\n

När ni gör POST /memory:

\n
    \n
  1. Minnesinnehåll lagras i memories-tabellen
    2. \n
  2. Innehåll infogas också i FTS5 virtuell tabell
    3. \n
  3. FTS5 tokeniserar och indexerar innehållet automatiskt
    4. \n
\n

När ni gör GET /memory/search?q=...:

\n
    \n
  1. Synapse tolkar frågan med FTS5-syntax
    2. \n
  2. Kör en MATCH mot FTS5-indexet
    3. \n
  3. Filtrerar efter mind_id (klientisolation)
    4. \n
  4. Returnerar rankade resultat
    5. \n
\n

Frågesyntax

\n

Enkel nyckelordssökning

\n
?q=docker

Returnerar minnen som innehåller "docker".

\n

Flera nyckelord (implicit AND)

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

Returnerar minnen som innehåller BÅDE "docker" OCH "swarm".

\n

Frasmatchning

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

Returnerar minnen som innehåller den exakta frasen "docker swarm".

\n

Prefixmatchning

\n
?q=docker*

Returnerar minnen som innehåller ord som börjar med "docker" (t.ex. "dockers",\n"dockerfile", "dockerize").

\n

Boolesk OR

\n
?q=docker+OR+kubernetes

Returnerar minnen som innehåller "docker" ELLER "kubernetes".

\n

Boolesk NOT

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

Returnerar minnen som innehåller "docker" men INTE "swarm".

\n

Gruppering

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

Returnerar minnen som innehåller "docker" eller "kubernetes", men inte "test".

\n

Praktiska exempel

\n

Hitta minnen om ett projekt

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

Hitta exakt fras

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

Uteslut testminnen

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

Hitta efter teknik

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

Rankning

\n

FTS5 rankar resultat efter relevans med BM25-algoritmen. Faktorer:

\n\n

Resultat returneras i rankningsordning (mest relevant först).

\n

Prestanda

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ÅtgärdLatens
Sök 100 minnen< 5 ms
Sök 1 000 minnen< 10 ms
Sök 10 000 minnen< 25 ms
Sök 100 000 minnen< 100 ms
\n

FTS5 är högt optimerat för läsintensiva arbetsbelastningar.

\n

Begränsningar

\n

Stamning

\n

FTS5 gör inte stamning som standard. "running" och "run" är olika termer.

\n

Lösning: Använd prefixmatchning: ?q=run*

\n

Tolerans mot felstavning

\n

FTS5 stöder inte oskarp matchning. En felstavning returnerar inga resultat.

\n

Lösning: Använd semantisk sökning (/memory/semantic-search) för\nbegreppsmatchning.

\n

Stopword

\n

Vanliga ord (the, a, an, is) indexeras men kanske inte är användbara för\nsökning. FTS5 hanterar detta automatiskt.

\n

FTS5 vs semantisk sökning

\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
AspektFTS5Semantisk sökning
HastighetUnder en millisekund50–100 ms
MatchningExakta nyckelordBegreppslig
Tolerans mot felstavningIngenNågon
StamningIngenImplicit
Kräver inbäddningarNejJa
Bäst förSpecifika termerBegrepp
\n

Använd FTS5 när ni känner till nyckelorden. Använd semantisk sökning när ni\nvill ha "minnen om X" där X beskrivs på ett annat sätt.

\n

Bästa praxis

\n

Nästa steg

\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"]}