{"title":"FTS5 Full-Text Search","slug":"fts5-search","category":"concepts","summary":"วิธีที่ Synapse ใช้ SQLite FTS5 สำหรับการค้นหา memory แบบ full-text ในระดับ sub-millisecond","audience":["human","llm"],"tags":["concept","search","fts5","fulltext"],"difficulty":"advanced","updated":"2026-06-27","word_count":434,"read_minutes":2,"lang":"th","translated":true,"requested_lang":"th","content_markdown":"\n# FTS5 Full-Text Search\n\nSynapse ใช้ FTS5 (Full-Text Search 5) สำหรับการค้นหา memory ที่รวดเร็วและยืดหยุ่น เอกสารหน้านี้อธิบายวิธีการทำงานและวิธีใช้อย่างมีประสิทธิภาพ\n\n## FTS5 คืออะไร?\n\nFTS5 เป็น SQLite extension (มีใน PostgreSQL ผ่าน extension ด้วย) ที่ให้ความสามารถ full-text search โดย:\n\n- Index เนื้อหา text สำหรับ keyword search ที่รวดเร็ว\n- รองรับ boolean operator (AND, OR, NOT)\n- รองรับ phrase matching ด้วยเครื่องหมายคำพูด\n- รองรับ prefix matching ด้วย `*`\n- จัดอันดับผลลัพธ์ตามความเกี่ยวข้อง\n\nSynapse ใช้ FTS5 ในการ index เนื้อหา memory ทั้งหมด เปิดใช้งานการค้นหาในระดับ sub-millisecond ทั่ว memory หลายพันรายการ\n\n## วิธีที่ Synapse ใช้ FTS5\n\nเมื่อคุณ `POST /memory`:\n\n1. เนื้อหา memory ถูกเก็บในตาราง `memories`\n2. เนื้อหายังถูกแทรกลงใน FTS5 virtual table\n3. FTS5 แบ่งคำและ index เนื้อหาโดยอัตโนมัติ\n\nเมื่อคุณ `GET /memory/search?q=...`:\n\n1. Synapse แยกวิเคราะห์ query โดยใช้ไวยากรณ์ FTS5\n2. ปฏิบัติการ `MATCH` กับ FTS5 index\n3. กรองตาม `mind_id` (tenant isolation)\n4. ส่งกลับผลลัพธ์ที่จัดอันดับแล้ว\n\n## ไวยากรณ์ Query\n\n### ค้นหา keyword แบบง่าย\n\n```\n?q=docker\n```\n\nส่งกลับ memory ที่มี \"docker\"\n\n### หลาย keyword (AND โดยนัย)\n\n```\n?q=docker+swarm\n?q=docker%20swarm\n```\n\nส่งกลับ memory ที่มีทั้ง \"docker\" และ \"swarm\"\n\n### Phrase matching\n\n```\n?q=\"docker+swarm\"\n?q=%22docker%20swarm%22\n```\n\nส่งกลับ memory ที่มี phrase \"docker swarm\" ตรงตัว\n\n### Prefix matching\n\n```\n?q=docker*\n```\n\nส่งกลับ memory ที่มีคำขึ้นต้นด้วย \"docker\" (เช่น \"dockers\", \"dockerfile\", \"dockerize\")\n\n### Boolean OR\n\n```\n?q=docker+OR+kubernetes\n```\n\nส่งกลับ memory ที่มี \"docker\" หรือ \"kubernetes\"\n\n### Boolean NOT\n\n```\n?q=docker+-swarm\n?q=docker+NOT+swarm\n```\n\nส่งกลับ memory ที่มี \"docker\" แต่ไม่มี \"swarm\"\n\n### การจัดกลุ่ม\n\n```\n?q=(docker+OR+kubernetes)+-test\n```\n\nส่งกลับ memory ที่มี \"docker\" หรือ \"kubernetes\" แต่ไม่มี \"test\"\n\n## ตัวอย่างปฏิบัติ\n\n### ค้นหา memory เกี่ยวกับโปรเจกต์\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=synapse+deployment\"\n```\n\n### ค้นหา phrase ตรงตัว\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=%22docker+swarm%22\"\n```\n\n### แยก memory ทดสอบออก\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- ความถี่ของคำ (term ปรากฏบ่อยแค่ไหน)\n- Inverse document frequency (คำที่หายากอันดับสูงกว่า)\n- ความยาวเอกสาร (เอกสารสั้นที่มีคำนั้นอันดับสูงกว่า)\n- น้ำหนัก column (title > content)\n\nผลลัพธ์ส่งกลับตามลำดับอันดับ (เกี่ยวข้องที่สุดก่อน)\n\n## ประสิทธิภาพ\n\n| การดำเนินการ | Latency |\n|-----------|---------|\n| ค้นหา 100 memory | < 5ms |\n| ค้นหา 1,000 memory | < 10ms |\n| ค้นหา 10,000 memory | < 25ms |\n| ค้นหา 100,000 memory | < 100ms |\n\nFTS5 ถูกปรับให้เหมาะกับ workload ที่อ่านหนัก\n\n## ข้อจำกัด\n\n### Stemming\n\nFTS5 ไม่ทำ stemming โดยค่าเริ่มต้น \"running\" และ \"run\" เป็นคำต่างกัน\n\n**วิธีแก้:** ใช้ prefix matching: `?q=run*`\n\n### ความทนต่อการพิมพ์ผิด\n\nFTS5 ไม่รองรับ fuzzy matching พิมพ์ผิดจะไม่ส่งกลับผลลัพธ์\n\n**วิธีแก้:** ใช้ semantic search (`/memory/semantic-search`) สำหรับการจับคู่เชิงแนวคิด\n\n### Stop word\n\nคำทั่วไป (the, a, an, is) ถูก index แต่อาจไม่มีประโยชน์ต่อการค้นหา FTS5 จัดการสิ่งนี้โดยอัตโนมัติ\n\n## FTS5 vs Semantic Search\n\n| แง่มุม | FTS5 | Semantic Search |\n|--------|------|-----------------|\n| ความเร็ว | Sub-millisecond | 50-100ms |\n| การจับคู่ | Exact keyword | เชิงแนวคิด |\n| ทนพิมพ์ผิด | None | บางส่วน |\n| Stemming | None | โดยนัย |\n| ต้องการ embedding | ไม่ | ใช่ |\n| เหมาะกับ | คำเฉพาะ | แนวคิด |\n\nใช้ FTS5 เมื่อคุณรู้ keyword ใช้ semantic search เมื่อคุณต้องการ \"memory เกี่ยวกับ X\" โดยที่ X ถูกอธิบายต่างกัน\n\n## แนวทางปฏิบัติที่ดีที่สุด\n\n> [!TIP]\n> - **ใช้คำที่เฉพาะเจาะจง** — \"docker swarm\" ดีกว่า \"container orchestration\"\n> - **ใส่เครื่องหมายคำพูดรอบ phrase** — `\"docker swarm\"` รับประกัน phrase match\n> - **ใช้ prefix สำหรับรูปแปร** — `deploy*` จับ \"deploy\", \"deployment\", \"deploying\"\n> - **แยกสัญญาณรบกวน** — `-test` กรอง memory ทดสอบออก\n> - **รวมกับ tag** — `?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 Full-Text Search

\n

Synapse ใช้ FTS5 (Full-Text Search 5) สำหรับการค้นหา memory ที่รวดเร็วและยืดหยุ่น เอกสารหน้านี้อธิบายวิธีการทำงานและวิธีใช้อย่างมีประสิทธิภาพ

\n

FTS5 คืออะไร?

\n

FTS5 เป็น SQLite extension (มีใน PostgreSQL ผ่าน extension ด้วย) ที่ให้ความสามารถ full-text search โดย:

\n\n

Synapse ใช้ FTS5 ในการ index เนื้อหา memory ทั้งหมด เปิดใช้งานการค้นหาในระดับ sub-millisecond ทั่ว memory หลายพันรายการ

\n

วิธีที่ Synapse ใช้ FTS5

\n

เมื่อคุณ POST /memory:

\n
    \n
  1. เนื้อหา memory ถูกเก็บในตาราง memories
    2. \n
  2. เนื้อหายังถูกแทรกลงใน FTS5 virtual table
    3. \n
  3. FTS5 แบ่งคำและ index เนื้อหาโดยอัตโนมัติ
    4. \n
\n

เมื่อคุณ GET /memory/search?q=...:

\n
    \n
  1. Synapse แยกวิเคราะห์ query โดยใช้ไวยากรณ์ FTS5
    2. \n
  2. ปฏิบัติการ MATCH กับ FTS5 index
    3. \n
  3. กรองตาม mind_id (tenant isolation)
    4. \n
  4. ส่งกลับผลลัพธ์ที่จัดอันดับแล้ว
    5. \n
\n

ไวยากรณ์ Query

\n

ค้นหา keyword แบบง่าย

\n
?q=docker

ส่งกลับ memory ที่มี "docker"

\n

หลาย keyword (AND โดยนัย)

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

ส่งกลับ memory ที่มีทั้ง "docker" และ "swarm"

\n

Phrase matching

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

ส่งกลับ memory ที่มี phrase "docker swarm" ตรงตัว

\n

Prefix matching

\n
?q=docker*

ส่งกลับ memory ที่มีคำขึ้นต้นด้วย "docker" (เช่น "dockers", "dockerfile", "dockerize")

\n

Boolean OR

\n
?q=docker+OR+kubernetes

ส่งกลับ memory ที่มี "docker" หรือ "kubernetes"

\n

Boolean NOT

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

ส่งกลับ memory ที่มี "docker" แต่ไม่มี "swarm"

\n

การจัดกลุ่ม

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

ส่งกลับ memory ที่มี "docker" หรือ "kubernetes" แต่ไม่มี "test"

\n

ตัวอย่างปฏิบัติ

\n

ค้นหา memory เกี่ยวกับโปรเจกต์

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

ค้นหา phrase ตรงตัว

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

แยก memory ทดสอบออก

\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
การดำเนินการLatency
ค้นหา 100 memory< 5ms
ค้นหา 1,000 memory< 10ms
ค้นหา 10,000 memory< 25ms
ค้นหา 100,000 memory< 100ms
\n

FTS5 ถูกปรับให้เหมาะกับ workload ที่อ่านหนัก

\n

ข้อจำกัด

\n

Stemming

\n

FTS5 ไม่ทำ stemming โดยค่าเริ่มต้น "running" และ "run" เป็นคำต่างกัน

\n

วิธีแก้: ใช้ prefix matching: ?q=run*

\n

ความทนต่อการพิมพ์ผิด

\n

FTS5 ไม่รองรับ fuzzy matching พิมพ์ผิดจะไม่ส่งกลับผลลัพธ์

\n

วิธีแก้: ใช้ semantic search (/memory/semantic-search) สำหรับการจับคู่เชิงแนวคิด

\n

Stop word

\n

คำทั่วไป (the, a, an, is) ถูก index แต่อาจไม่มีประโยชน์ต่อการค้นหา FTS5 จัดการสิ่งนี้โดยอัตโนมัติ

\n

FTS5 vs Semantic Search

\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
แง่มุมFTS5Semantic Search
ความเร็วSub-millisecond50-100ms
การจับคู่Exact keywordเชิงแนวคิด
ทนพิมพ์ผิดNoneบางส่วน
StemmingNoneโดยนัย
ต้องการ embeddingไม่ใช่
เหมาะกับคำเฉพาะแนวคิด
\n

ใช้ FTS5 เมื่อคุณรู้ keyword ใช้ semantic search เมื่อคุณต้องการ "memory เกี่ยวกับ 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"]}