{"title":"Tìm kiếm toàn văn FTS5","slug":"fts5-search","category":"concepts","summary":"Cách Synapse sử dụng SQLite FTS5 cho tìm kiếm bộ nhớ toàn văn dưới mili giây.","audience":["human","llm"],"tags":["concept","search","fts5","fulltext"],"difficulty":"advanced","updated":"2026-06-27","word_count":789,"read_minutes":4,"lang":"vi","translated":true,"requested_lang":"vi","content_markdown":"\n# Tìm kiếm toàn văn FTS5\n\nSynapse sử dụng FTS5 (Full-Text Search 5) cho tìm kiếm bộ nhớ nhanh, linh hoạt.\nTrang này giải thích cách nó hoạt động và cách sử dụng hiệu quả.\n\n## FTS5 là gì?\n\nFTS5 là một phần mở rộng SQLite (cũng có sẵn trong PostgreSQL qua các phần mở\nrộng) cung cấp khả năng tìm kiếm toàn văn. Nó:\n\n- Đánh chỉ mục nội dung văn bản để tìm kiếm từ khóa nhanh\n- Hỗ trợ toán tử boolean (AND, OR, NOT)\n- Hỗ trợ khớp cụm từ với dấu ngoặc kép\n- Hỗ trợ khớp tiền tố với `*`\n- Xếp hạng kết quả theo mức độ liên quan\n\nSynapse sử dụng FTS5 để đánh chỉ mục toàn bộ nội dung bộ nhớ, cho phép tìm\nkiếm dưới mili giây trên hàng nghìn bộ nhớ.\n\n## Cách Synapse sử dụng FTS5\n\nKhi bạn `POST /memory`:\n\n1. Nội dung bộ nhớ được lưu trong bảng `memories`\n2. Nội dung cũng được chèn vào bảng ảo FTS5\n3. FTS5 tự động tokenize và đánh chỉ mục nội dung\n\nKhi bạn `GET /memory/search?q=...`:\n\n1. Synapse phân tích truy vấn bằng cú pháp FTS5\n2. Thực thi `MATCH` đối với chỉ mục FTS5\n3. Lọc theo `mind_id` (cách ly tenant)\n4. Trả về kết quả được xếp hạng\n\n## Cú pháp truy vấn\n\n### Tìm kiếm từ khóa đơn giản\n\n```\n?q=docker\n```\n\nTrả về bộ nhớ chứa \"docker\".\n\n### Nhiều từ khóa (AND ngầm định)\n\n```\n?q=docker+swarm\n?q=docker%20swarm\n```\n\nTrả về bộ nhớ chứa CẢ \"docker\" VÀ \"swarm\".\n\n### Khớp cụm từ\n\n```\n?q=\"docker+swarm\"\n?q=%22docker%20swarm%22\n```\n\nTrả về bộ nhớ chứa cụm từ chính xác \"docker swarm\".\n\n### Khớp tiền tố\n\n```\n?q=docker*\n```\n\nTrả về bộ nhớ chứa các từ bắt đầu bằng \"docker\" (ví dụ \"dockers\", \"dockerfile\",\n\"dockerize\").\n\n### Boolean OR\n\n```\n?q=docker+OR+kubernetes\n```\n\nTrả về bộ nhớ chứa \"docker\" HOẶC \"kubernetes\".\n\n### Boolean NOT\n\n```\n?q=docker+-swarm\n?q=docker+NOT+swarm\n```\n\nTrả về bộ nhớ chứa \"docker\" nhưng KHÔNG chứa \"swarm\".\n\n### Nhóm\n\n```\n?q=(docker+OR+kubernetes)+-test\n```\n\nTrả về bộ nhớ chứa \"docker\" hoặc \"kubernetes\", nhưng không chứa \"test\".\n\n## Ví dụ thực tế\n\n### Tìm bộ nhớ về một dự án\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=synapse+deployment\"\n```\n\n### Tìm cụm từ chính xác\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=%22docker+swarm%22\"\n```\n\n### Loại trừ bộ nhớ kiểm thử\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=production+-test\"\n```\n\n### Tìm theo công nghệ\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## Xếp hạng\n\nFTS5 xếp hạng kết quả theo mức độ liên quan bằng thuật toán BM25. Các yếu tố:\n\n- Tần suất thuật ngữ (thuật ngữ xuất hiện bao nhiêu lần)\n- Tần suất tài liệu nghịch đảo (thuật ngữ hiếm xếp cao hơn)\n- Độ dài tài liệu (tài liệu ngắn hơn với thuật ngữ xếp cao hơn)\n- Trọng số cột (tiêu đề > nội dung)\n\nKết quả được trả về theo thứ tự xếp hạng (liên quan nhất trước).\n\n## Hiệu suất\n\n| Thao tác | Độ trễ |\n|-----------|---------|\n| Tìm 100 bộ nhớ | < 5ms |\n| Tìm 1.000 bộ nhớ | < 10ms |\n| Tìm 10.000 bộ nhớ | < 25ms |\n| Tìm 100.000 bộ nhớ | < 100ms |\n\nFTS5 được tối ưu cao cho khối lượng công việc nặng về đọc.\n\n## Giới hạn\n\n### Stemming\n\nFTS5 không làm stemming theo mặc định. \"running\" và \"run\" là các thuật ngữ\nkhác nhau.\n\n**Giải pháp:** Sử dụng khớp tiền tố: `?q=run*`\n\n### Dung sai lỗi chính tả\n\nFTS5 không hỗ trợ khớp mờ. Lỗi chính tả sẽ trả về không kết quả.\n\n**Giải pháp:** Sử dụng tìm kiếm ngữ nghĩa (`/memory/semantic-search`) cho khớp\nkhái niệm.\n\n### Từ dừng\n\nCác từ phổ biến (the, a, an, is) được đánh chỉ mục nhưng có thể không hữu ích\ncho tìm kiếm. FTS5 xử lý điều này tự động.\n\n## FTS5 so với Tìm kiếm ngữ nghĩa\n\n| Khía cạnh | FTS5 | Tìm kiếm ngữ nghĩa |\n|--------|------|-----------------|\n| Tốc độ | Dưới mili giây | 50-100ms |\n| Khớp | Từ khóa chính xác | Khái niệm |\n| Dung sai lỗi chính tả | Không | Một số |\n| Stemming | Không | Ngầm định |\n| Yêu cầu embeddings | Không | Có |\n| Tốt nhất cho | Thuật ngữ cụ thể | Khái niệm |\n\nSử dụng FTS5 khi bạn biết từ khóa. Sử dụng tìm kiếm ngữ nghĩa khi bạn muốn\n\"bộ nhớ về X\" khi X được mô tả khác đi.\n\n## Thực hành tốt nhất\n\n> [!TIP]\n> - **Sử dụng thuật ngữ cụ thể** — \"docker swarm\" tốt hơn \"container orchestration\"\n> - **Trích dẫn cụm từ** — `\"docker swarm\"` đảm bảo khớp cụm từ\n> - **Sử dụng tiền tố cho biến thể** — `deploy*` bắt được \"deploy\", \"deployment\", \"deploying\"\n> - **Loại trừ nhiễu** — `-test` lọc bỏ bộ nhớ kiểm thử\n> - **Kết hợp với tag** — `?q=docker&tag=production` thu hẹp kết quả\n\n## Bước tiếp theo\n\n- [Tìm kiếm ngữ nghĩa](/docs/concepts/semantic-search)\n- [Memory API](/docs/api/memory)\n- [Thực hành tốt nhất về bộ nhớ](/docs/guides/memory-best-practices)\n","content_html":"

Tìm kiếm toàn văn FTS5

\n

Synapse sử dụng FTS5 (Full-Text Search 5) cho tìm kiếm bộ nhớ nhanh, linh hoạt.\nTrang này giải thích cách nó hoạt động và cách sử dụng hiệu quả.

\n

FTS5 là gì?

\n

FTS5 là một phần mở rộng SQLite (cũng có sẵn trong PostgreSQL qua các phần mở\nrộng) cung cấp khả năng tìm kiếm toàn văn. Nó:

\n\n

Synapse sử dụng FTS5 để đánh chỉ mục toàn bộ nội dung bộ nhớ, cho phép tìm\nkiếm dưới mili giây trên hàng nghìn bộ nhớ.

\n

Cách Synapse sử dụng FTS5

\n

Khi bạn POST /memory:

\n
    \n
  1. Nội dung bộ nhớ được lưu trong bảng memories
    2. \n
  2. Nội dung cũng được chèn vào bảng ảo FTS5
    3. \n
  3. FTS5 tự động tokenize và đánh chỉ mục nội dung
    4. \n
\n

Khi bạn GET /memory/search?q=...:

\n
    \n
  1. Synapse phân tích truy vấn bằng cú pháp FTS5
    2. \n
  2. Thực thi MATCH đối với chỉ mục FTS5
    3. \n
  3. Lọc theo mind_id (cách ly tenant)
    4. \n
  4. Trả về kết quả được xếp hạng
    5. \n
\n

Cú pháp truy vấn

\n

Tìm kiếm từ khóa đơn giản

\n
?q=docker

Trả về bộ nhớ chứa "docker".

\n

Nhiều từ khóa (AND ngầm định)

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

Trả về bộ nhớ chứa CẢ "docker" VÀ "swarm".

\n

Khớp cụm từ

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

Trả về bộ nhớ chứa cụm từ chính xác "docker swarm".

\n

Khớp tiền tố

\n
?q=docker*

Trả về bộ nhớ chứa các từ bắt đầu bằng "docker" (ví dụ "dockers", "dockerfile",\n"dockerize").

\n

Boolean OR

\n
?q=docker+OR+kubernetes

Trả về bộ nhớ chứa "docker" HOẶC "kubernetes".

\n

Boolean NOT

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

Trả về bộ nhớ chứa "docker" nhưng KHÔNG chứa "swarm".

\n

Nhóm

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

Trả về bộ nhớ chứa "docker" hoặc "kubernetes", nhưng không chứa "test".

\n

Ví dụ thực tế

\n

Tìm bộ nhớ về một dự án

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

Tìm cụm từ chính xác

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

Loại trừ bộ nhớ kiểm thử

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

Tìm theo công nghệ

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

Xếp hạng

\n

FTS5 xếp hạng kết quả theo mức độ liên quan bằng thuật toán BM25. Các yếu tố:

\n\n

Kết quả được trả về theo thứ tự xếp hạng (liên quan nhất trước).

\n

Hiệu suất

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Thao tácĐộ trễ
Tìm 100 bộ nhớ< 5ms
Tìm 1.000 bộ nhớ< 10ms
Tìm 10.000 bộ nhớ< 25ms
Tìm 100.000 bộ nhớ< 100ms
\n

FTS5 được tối ưu cao cho khối lượng công việc nặng về đọc.

\n

Giới hạn

\n

Stemming

\n

FTS5 không làm stemming theo mặc định. "running" và "run" là các thuật ngữ\nkhác nhau.

\n

Giải pháp: Sử dụng khớp tiền tố: ?q=run*

\n

Dung sai lỗi chính tả

\n

FTS5 không hỗ trợ khớp mờ. Lỗi chính tả sẽ trả về không kết quả.

\n

Giải pháp: Sử dụng tìm kiếm ngữ nghĩa (/memory/semantic-search) cho khớp\nkhái niệm.

\n

Từ dừng

\n

Các từ phổ biến (the, a, an, is) được đánh chỉ mục nhưng có thể không hữu ích\ncho tìm kiếm. FTS5 xử lý điều này tự động.

\n

FTS5 so với Tìm kiếm ngữ nghĩa

\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
Khía cạnhFTS5Tìm kiếm ngữ nghĩa
Tốc độDưới mili giây50-100ms
KhớpTừ khóa chính xácKhái niệm
Dung sai lỗi chính tảKhôngMột số
StemmingKhôngNgầm định
Yêu cầu embeddingsKhôngCó
Tốt nhất choThuật ngữ cụ thểKhái niệm
\n

Sử dụng FTS5 khi bạn biết từ khóa. Sử dụng tìm kiếm ngữ nghĩa khi bạn muốn\n"bộ nhớ về X" khi X được mô tả khác đi.

\n

Thực hành tốt nhất

\n

Bước tiếp theo

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