{"title":"FTS5 フルテキスト検索","slug":"fts5-search","category":"concepts","summary":"Synapse が SQLite FTS5 を使用してサブミリ秒のフルテキストメモリ検索を実現する仕組み。","audience":["human","llm"],"tags":["concept","search","fts5","fulltext"],"difficulty":"advanced","updated":"2026-06-27","word_count":269,"read_minutes":1,"lang":"ja","translated":true,"requested_lang":"ja","content_markdown":"\n# FTS5 フルテキスト検索\n\nSynapse は高速かつ柔軟なメモリ検索のために FTS5（Full-Text Search 5）を使用しています。本ページでは、その仕組みと効果的な使い方を説明します。\n\n## FTS5 とは？\n\nFTS5 はフルテキスト検索機能を提供する SQLite 拡張（PostgreSQL でも拡張経由で利用可能）です。以下をサポートします。\n\n- テキストコンテンツのインデックスによる高速キーワード検索\n- ブール演算子（AND、OR、NOT）\n- 引用符によるフレーズマッチング\n- `*` によるプレフィックスマッチング\n- 関連度による結果ランキング\n\nSynapse は全メモリコンテンツを FTS5 でインデックス化し、数千件のメモリにわたるサブミリ秒検索を可能にしています。\n\n## Synapse での FTS5 利用\n\n`POST /memory` 時の処理：\n\n1. メモリコンテンツが `memories` テーブルに保存\n2. コンテンツが FTS5 仮想テーブルにも挿入\n3. FTS5 が自動的にトークン化とインデックス化を実行\n\n`GET /memory/search?q=...` 時の処理：\n\n1. Synapse が FTS5 構文でクエリを解析\n2. FTS5 インデックスに対して `MATCH` を実行\n3. `mind_id` でフィルタ（テナント分離）\n4. ランク付けされた結果を返却\n\n## クエリ構文\n\n### 単純なキーワード検索\n\n```\n?q=docker\n```\n\n「docker」を含むメモリを返します。\n\n### 複数キーワード（暗黙の AND）\n\n```\n?q=docker+swarm\n?q=docker%20swarm\n```\n\n「docker」と「swarm」の両方を含むメモリを返します。\n\n### フレーズマッチング\n\n```\n?q=\"docker+swarm\"\n?q=%22docker%20swarm%22\n```\n\n完全なフレーズ「docker swarm」を含むメモリを返します。\n\n### プレフィックスマッチング\n\n```\n?q=docker*\n```\n\n「docker」で始まる単語（「dockers」「dockerfile」「dockerize」など）を含むメモリを返します。\n\n### ブール OR\n\n```\n?q=docker+OR+kubernetes\n```\n\n「docker」または「kubernetes」を含むメモリを返します。\n\n### ブール NOT\n\n```\n?q=docker+-swarm\n?q=docker+NOT+swarm\n```\n\n「docker」を含むが「swarm」を含まないメモリを返します。\n\n### グループ化\n\n```\n?q=(docker+OR+kubernetes)+-test\n```\n\n「docker」または「kubernetes」を含むが「test」を含まないメモリを返します。\n\n## 実践例\n\n### プロジェクトに関するメモリの検索\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=synapse+deployment\"\n```\n\n### 完全フレーズの検索\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=%22docker+swarm%22\"\n```\n\n### テストメモリの除外\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=production+-test\"\n```\n\n### 技術による検索\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## ランキング\n\nFTS5 は BM25 アルゴリズムで関連度により結果をランク付けします。考慮要素：\n\n- 用語頻度（用語の出現回数）\n- 逆文書頻度（まれな用語ほど上位）\n- 文書長（短い文書ほど上位）\n- カラムウェイト（title > content）\n\n結果はランク順（最も関連度の高いものが先頭）で返されます。\n\n## パフォーマンス\n\n| 操作 | レイテンシ |\n|-----------|---------|\n| 100 件のメモリ検索 | < 5ms |\n| 1,000 件のメモリ検索 | < 10ms |\n| 10,000 件のメモリ検索 | < 25ms |\n| 100,000 件のメモリ検索 | < 100ms |\n\nFTS5 は読み取り中心のワークロードに高度に最適化されています。\n\n## 制限事項\n\n### ステミング\n\nFTS5 はデフォルトでステミングを行いません。「running」と「run」は異なる用語として扱われます。\n\n**回避策：** プレフィックスマッチングを使用 — `?q=run*`\n\n### 誤字許容\n\nFTS5 はファジーマッチングをサポートしません。誤字があると結果が返りません。\n\n**回避策：** 概念マッチングにはセマンティック検索（`/memory/semantic-search`）を使用してください。\n\n### ストップワード\n\n一般的な単語（the、a、an、is）はインデックス化されますが、検索には有用でない場合があります。FTS5 はこれを自動的に処理します。\n\n## FTS5 とセマンティック検索の比較\n\n| 側面 | FTS5 | セマンティック検索 |\n|--------|------|-----------------|\n| 速度 | サブミリ秒 | 50〜100ms |\n| マッチング | 完全キーワード | 概念的 |\n| 誤字許容 | なし | 一部あり |\n| ステミング | なし | 暗黙的 |\n| 埋め込み必要 | 不要 | 必要 |\n| 最適な用途 | 特定の用語 | 概念 |\n\nキーワードが分かっている場合は FTS5 を使用してください。X が異なる表現で記述されている「X に関するメモリ」を探す場合はセマンティック検索を使用してください。\n\n## ベストプラクティス\n\n> [!TIP]\n> - **具体的な用語を使用** — 「container orchestration」より「docker swarm」が良い\n> - **フレーズを引用** — `\"docker swarm\"` でフレーズマッチを確実に\n> - **バリエーションにプレフィックス** — `deploy*` で「deploy」「deployment」「deploying」を捕捉\n> - **ノイズを除外** — `-test` でテストメモリをフィルタ\n> - **タグと組み合わせ** — `?q=docker&tag=production` で結果を絞り込み\n\n## 次のステップ\n\n- [Semantic Search](/docs/concepts/semantic-search)\n- [Memory API](/docs/api/memory)\n- [Memory Best Practices](/docs/guides/memory-best-practices)\n","content_html":"

FTS5 フルテキスト検索

\n

Synapse は高速かつ柔軟なメモリ検索のために FTS5（Full-Text Search 5）を使用しています。本ページでは、その仕組みと効果的な使い方を説明します。

\n

FTS5 とは？

\n

FTS5 はフルテキスト検索機能を提供する SQLite 拡張（PostgreSQL でも拡張経由で利用可能）です。以下をサポートします。

\n\n

Synapse は全メモリコンテンツを FTS5 でインデックス化し、数千件のメモリにわたるサブミリ秒検索を可能にしています。

\n

Synapse での FTS5 利用

\n

POST /memory 時の処理：

\n
    \n
  1. メモリコンテンツが memories テーブルに保存
    2. \n
  2. コンテンツが FTS5 仮想テーブルにも挿入
    3. \n
  3. FTS5 が自動的にトークン化とインデックス化を実行
    4. \n
\n

GET /memory/search?q=... 時の処理：

\n
    \n
  1. Synapse が FTS5 構文でクエリを解析
    2. \n
  2. FTS5 インデックスに対して MATCH を実行
    3. \n
  3. mind_id でフィルタ（テナント分離）
    4. \n
  4. ランク付けされた結果を返却
    5. \n
\n

クエリ構文

\n

単純なキーワード検索

\n
?q=docker

「docker」を含むメモリを返します。

\n

複数キーワード（暗黙の AND）

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

「docker」と「swarm」の両方を含むメモリを返します。

\n

フレーズマッチング

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

完全なフレーズ「docker swarm」を含むメモリを返します。

\n

プレフィックスマッチング

\n
?q=docker*

「docker」で始まる単語（「dockers」「dockerfile」「dockerize」など）を含むメモリを返します。

\n

ブール OR

\n
?q=docker+OR+kubernetes

「docker」または「kubernetes」を含むメモリを返します。

\n

ブール NOT

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

「docker」を含むが「swarm」を含まないメモリを返します。

\n

グループ化

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

「docker」または「kubernetes」を含むが「test」を含まないメモリを返します。

\n

実践例

\n

プロジェクトに関するメモリの検索

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

完全フレーズの検索

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

テストメモリの除外

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

技術による検索

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

ランキング

\n

FTS5 は BM25 アルゴリズムで関連度により結果をランク付けします。考慮要素：

\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
操作レイテンシ
100 件のメモリ検索< 5ms
1,000 件のメモリ検索< 10ms
10,000 件のメモリ検索< 25ms
100,000 件のメモリ検索< 100ms
\n

FTS5 は読み取り中心のワークロードに高度に最適化されています。

\n

制限事項

\n

ステミング

\n

FTS5 はデフォルトでステミングを行いません。「running」と「run」は異なる用語として扱われます。

\n

回避策： プレフィックスマッチングを使用 — ?q=run*

\n

誤字許容

\n

FTS5 はファジーマッチングをサポートしません。誤字があると結果が返りません。

\n

回避策： 概念マッチングにはセマンティック検索（/memory/semantic-search）を使用してください。

\n

ストップワード

\n

一般的な単語（the、a、an、is）はインデックス化されますが、検索には有用でない場合があります。FTS5 はこれを自動的に処理します。

\n

FTS5 とセマンティック検索の比較

\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
側面FTS5セマンティック検索
速度サブミリ秒50〜100ms
マッチング完全キーワード概念的
誤字許容なし一部あり
ステミングなし暗黙的
埋め込み必要不要必要
最適な用途特定の用語概念
\n

キーワードが分かっている場合は FTS5 を使用してください。X が異なる表現で記述されている「X に関するメモリ」を探す場合はセマンティック検索を使用してください。

\n

ベストプラクティス

\n

次のステップ

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