oceanbase/seekdb

เขียน. ค้นหา. Fork. State Store สำหรับ AI Agents.

เข้ากันได้กับ MySQL · แบบฝังหรือเซิร์ฟเวอร์ · การค้นหาแบบไฮบริด Vector + Full-text · COW Sandbox

⚡ 1,523 QPS สำหรับการเขียนและค้นหาแบบสตรีมมิ่ง (10 เท่าของ Milvus, 3 เท่าของ Elasticsearch) 🌿 แซนด์บ็อกซ์ FORK/MERGE สำหรับการสำรวจของ Agent อย่างปลอดภัย 🔍 Vector + full-text + scalar ในการสอบถาม SQL เดียว 🐬 Full ACID, โปรโตคอล MySQL, ทำงานร่วมกับ LangChain/LlamaIndex/Dify

ภาษาอังกฤษ | 中文版 | 日本語

ลองใช้ใน 30 วินาที · เริ่มต้นใช้งานอย่างรวดเร็ว · ทำไมต้อง seekdb · ระบบนิเวศ · การมีส่วนร่วม

หากคุณพบว่า seekdb มีประโยชน์ โปรดพิจารณาให้ ดาว — มันช่วยให้ผู้อื่นค้นพบโปรเจกต์นี้ได้

⚡ ประสิทธิภาพโดยรวม

⏱️ ลองใช้ใน 30 วินาที

pip install -U pyseekdb   # pyseekdb is the Python SDK for seekdb

ไม่ต้องมีเซิร์ฟเวอร์ ไม่ต้องมีสคีมา ไม่ต้องตั้งค่าการฝังข้อมูล โหมดฝังตัวทำงานในกระบวนการ; สามารถเปลี่ยนไปใช้โหมดเซิร์ฟเวอร์ / OceanBase ได้ด้วยโค้ดเพียงบรรทัดเดียว ตัวอย่างเพิ่มเติม →

✨ ทำไมต้อง seekdb สำหรับ Agents?

🔥 การเขียนแบบสตรีมมิ่ง + การค้นหาพร้อมกัน โดยไม่มี P99 Spike

เวิร์คโหลดของ Agent คือการเขียนอย่างต่อเนื่อง + การอ่านในอีกไม่กี่มิลลิวินาทีต่อมา async index pipeline (Change Stream) ของ seekdb แยก DML ออกจากการสร้างดัชนี และ two-level HNSW (incremental + snapshot) ทำให้เวกเตอร์ที่เขียนใหม่สามารถค้นหาได้ทันที

เส้นทางการเขียนจะคอมมิตและส่งคืน โดยไม่ต้องรอ การสร้างดัชนี Change Stream pipeline จะใช้ redo log แบบอะซิงโครนัสและอัปเดต delta HNSW การสอบถามจะเข้าถึงทั้งดัชนี delta และ snapshot ด้วย read locks ที่ละเอียด — นี่คือเหตุผลที่ P99 ยังคงราบเรียบภายใต้การทำงานพร้อมกัน

ที่มา: src/share/change_stream/ · src/share/vector_index/

🌿 Copy-on-Write Sandboxes สำหรับการสำรวจของ Agent

FORK DATABASE จะสร้างสแนปช็อตของฐานข้อมูลทั้งหมดในไม่กี่วินาที — ไม่มีการคัดลอกข้อมูล Agent สามารถทดลองได้อย่างอิสระ (เขียน, สอบถาม, แม้กระทั่งทำให้ตารางเสียหาย); จากนั้น MERGE TABLE จะคอมมิตงานกลับ หรือ DROP DATABASE จะทิ้งงานนั้นไป COW ระดับเคอร์เนล ไม่ใช่การบันทึก/กู้คืนระดับแอปพลิเคชัน

-- Snapshot in seconds, no data copy
FORK DATABASE agent_state TO agent_sandbox_42;

-- Agent reads/writes freely on the sandbox...
USE agent_sandbox_42;
INSERT INTO memory (session_id, embedding, content) VALUES (...);

-- Accept the work back to mainline (strategies: FAIL / THEIRS / OURS)
MERGE TABLE agent_sandbox_42.memory INTO agent_state.memory STRATEGY THEIRS;
-- ...or throw it away:
DROP DATABASE agent_sandbox_42;

ที่มา: tools/deploy/mysql_test/test_suite/fork_table/

🔍 การค้นหาแบบไฮบริดใน SQL เดียว

Vector + full-text + scalar filter ถูกผลักเข้าไปในแผนการดำเนินการเดียว ไม่มีการรวมฝั่งไคลเอ็นต์แบบ N+1 ไม่ต้องมีโค้ดเชื่อมต่อเพื่อรวมผลลัพธ์

SELECT id, title, l2_distance(emb, '[0.12,0.34,...]') AS dist
FROM docs
WHERE MATCH(content) AGAINST('quarterly report')
  AND author_id = 42
  AND created_at > '2026-01-01'
ORDER BY dist APPROXIMATE LIMIT 10;

🐬 เข้ากันได้กับ MySQL, ACID, ฝังได้

สร้างขึ้นบนเอนจิน SQL ของ OceanBase ที่ได้รับการพิสูจน์แล้ว ทำงานเป็นไลบรารีแบบฝัง, เซิร์ฟเวอร์โหนดเดียว, หรือในคลัสเตอร์แบบกระจายของ OceanBase Full ACID, การเขียนแบบเรียลไทม์ และระบบนิเวศ MySQL ทั้งหมดพร้อมใช้งานทันที

🎬 เริ่มต้นใช้งานอย่างรวดเร็ว

การติดตั้ง

เลือกแพลตฟอร์มของคุณ:

เพียงแค่ curl ครั้งเดียว ก็ได้ฐานข้อมูลที่ทำงานอยู่ — ไม่ต้องลงทะเบียน ไม่ต้องใช้บัตรเครดิต

curl -X POST https://d0.seekdb.ai/api/v1/instances

ฟรี 7 วัน เรียนรู้เพิ่มเติม →

pip install -U pyseekdb

docker run -d \
  --name seekdb \
  -p 2881:2881 \
  -p 2886:2886 \
  -v ./data:/var/lib/oceanbase \
  oceanbase/seekdb:latest

โปรดดู เอกสาร ของ Docker image นี้สำหรับรายละเอียด

# Linux (ติดตั้งในบรรทัดเดียว อาจต้องใช้ sudo)
curl -fsSL https://obportal.s3.ap-southeast-1.amazonaws.com/download-center/opensource/seekdb/seekdb_install.sh | bash

# macOS (Homebrew)
brew tap oceanbase/seekdb
brew install seekdb

ดู เอกสารการติดตั้ง สำหรับการติดตั้งแบบออฟไลน์ DEB/RPM และรายละเอียดการกำหนดค่า

📝 ตัวอย่างเพิ่มเติม

สำหรับคำแนะนำการใช้งาน Python SDK แบบเต็ม — โหมดการเชื่อมต่อ, ฟังก์ชันการฝังข้อมูล, ตัวกรองเมตาดาต้า — ดู คู่มือผู้ใช้ pyseekdb

Repository: oceanbase/seekdb ส่วนที่ 2/2

ลูปของเอเจนต์ตามแบบฉบับ: เขียนข้อมูลที่สังเกตได้, ดึงบริบทที่เกี่ยวข้อง ไม่กี่มิลลิวินาทีต่อมา, ทำซ้ำไปเรื่อยๆ ไพพ์ไลน์ดัชนีแบบอะซิงโครนัสของ seekdb ช่วยให้ ทั้งสองส่วนทำงานได้อย่างรวดเร็วภายใต้การทำงานพร้อมกันอย่างต่อเนื่อง

import pyseekdb

client = pyseekdb.Client(path="./agent_state.db")
memory = client.get_or_create_collection(name="episodic")

for step in agent.run():
    # Persist the observation
    memory.upsert(ids=[step.id], documents=[step.observation])

    # Retrieve relevant context — milliseconds after the write,
    # served by the incremental HNSW (no waiting on a background rebuild)
    relevant = memory.query(query_texts=step.next_query, n_results=5)

    agent.act(relevant)

-- Table with vector column, full-text index, and HNSW vector index
CREATE TABLE articles (
  id        INT PRIMARY KEY,
  title     TEXT,
  content   TEXT,
  embedding VECTOR(384),
  FULLTEXT INDEX idx_fts (content) WITH PARSER ik,
  VECTOR   INDEX idx_vec (embedding) WITH (DISTANCE=l2, TYPE=hnsw, LIB=vsag)
) ORGANIZATION = HEAP;

-- Hybrid search: vector similarity + full-text match in one query
SELECT id, title,
       l2_distance(embedding, '[0.12, 0.34, ...]') AS dist
FROM articles
WHERE MATCH(content) AGAINST('quarterly report')
ORDER BY dist APPROXIMATE
LIMIT 10;

นักพัฒนา Python สามารถเข้าถึงสิ่งนี้ได้ผ่าน SQLAlchemy หรือไดรเวอร์ MySQL ใดๆ

📚 กรณีการใช้งาน

เอเจนต์ต้องการที่เก็บสถานะที่รองรับการเขียนหน่วยความจำอย่างต่อเนื่อง, การดึงข้อมูลในอีกไม่กี่มิลลิวินาทีต่อมา, การแตกสาขาเพื่อการสำรวจ, และการย้อนกลับเมื่อ เกิดข้อผิดพลาด seekdb ถูกสร้างขึ้นมาเพื่อสิ่งนี้โดยเฉพาะ:

• พื้นที่เก็บข้อมูลที่เหมาะกับการสตรีม — เขียนหน่วยความจำ, คิวรีได้ในมิลลิวินาทีถัดไป
• COW sandboxes — FORK DATABASE สำหรับการทดลองอย่างปลอดภัย, MERGE เพื่อยอมรับ, DROP เพื่อย้อนกลับ
• การดึงข้อมูลแบบไฮบริด — เวกเตอร์ + ข้อความเต็ม + เชิงสัมพันธ์ใน SQL เดียว
• โปรโตคอล MySQL — ทำงานร่วมกับ LangChain, LlamaIndex, Dify ได้ทันที

ผู้ช่วยส่วนตัว · ระบบอัตโนมัติสำหรับองค์กร · เอเจนต์เฉพาะทาง · แพลตฟอร์มเอเจนต์

seekdb ที่มีการดึงข้อมูลแบบไฮบริด + เอ็นจิ้นหลายโมเดลยังเหมาะกับเวิร์กโหลด AI แบบคลาสสิก:

• 📖 RAG & การดึงความรู้ — เวกเตอร์ + ข้อความเต็ม + ตัวกรองสเกลาร์พร้อมการควบคุมการเข้าถึงหลายระดับ การประกันคุณภาพสำหรับองค์กร, การสนับสนุนลูกค้า, ข้อมูลเชิงลึกในอุตสาหกรรม, ฐานความรู้ส่วนบุคคล
• 🔍 การค้นหาเชิงความหมาย — การค้นหาตามการฝังข้อมูลในข้อความ, รูปภาพ และรูปแบบอื่นๆ การค้นหาสินค้า, ข้อความเป็นรูปภาพ, รูปภาพเป็นสินค้า
• 💻 การเขียนโค้ดที่ช่วยโดย AI — การค้นหาโค้ดเชิงความหมาย, การแยกโปรเจกต์หลายโปรเจกต์, การคิวรีแบบย้อนเวลาสำหรับปลั๊กอิน IDE และเอเจนต์โค้ด IDE ในเครื่อง, web IDEs, การออกแบบเป็นเว็บ
• ⬆️ ระบบอัจฉริยะสำหรับแอปพลิเคชันองค์กร — เลเยอร์ AI ที่เข้ากันได้กับ MySQL สำหรับระบบเดิม, พร้อมที่เก็บข้อมูลแบบไฮบริดแถว/คอลัมน์ ระบบอัจฉริยะเอกสาร, ข้อมูลเชิงลึกทางธุรกิจ, ระบบการเงิน
• 📱 AI บนอุปกรณ์ & Edge — โหมดฝังตัว / ไมโครเซิร์ฟเวอร์สำหรับอุปกรณ์ที่มีทรัพยากรจำกัด ระบบในยานพาหนะ, การศึกษา AI, หุ่นยนต์เพื่อนร่วมทาง, อุปกรณ์ดูแลสุขภาพ

🌟 ระบบนิเวศ & การผสานรวม

+ Camel-AI · DB-GPT · FastGPT · Firecrawl · Spring-AI-Alibaba · Cloudflare Workers AI · Jina AI · Ragas · Instructor · Baseten — ดู คู่มือผู้ใช้ สำหรับรายการทั้งหมด

🌐 ขั้นตอนถัดไป & ชุมชน

• 📖 อ่านเอกสาร → — Quickstart, การอ้างอิง API, คู่มือการผสานรวม
• 📝 บล็อกเปิดตัว → — สถาปัตยกรรมเบื้องหลัง QPS ที่เร็วกว่า Milvus 10.7 เท่า
• 🐛 เปิดประเด็น → — รายงานข้อบกพร่อง, ขอคุณสมบัติ
• 🤝 ร่วมสนับสนุน → — ช่วยสร้างที่เก็บสถานะยุคเอเจนต์

🛠️ การพัฒนา

สร้างจากซอร์สโค้ด

ก่อนที่จะสร้าง โปรดติดตั้งชุดเครื่องมือและส่วนประกอบที่จำเป็นสำหรับระบบปฏิบัติการของคุณ ดู ติดตั้ง Toolchain สำหรับคำแนะนำโดยละเอียด

# Clone the repository
git clone https://github.com/oceanbase/seekdb.git
cd seekdb
bash build.sh debug --init --make
mkdir -p ~/seekdb/bin
cp build_debug/src/observer/seekdb ~/seekdb/bin
cd ~/seekdb
./bin/seekdb

ในตัวอย่างนี้ ไดเรกทอรีการทำงานคือ $HOME/seekdb โปรดใช้ไดเรกทอรีใหม่สำหรับการทดสอบ โปรดดู คู่มือนักพัฒนา สำหรับคำแนะนำโดยละเอียด

การร่วมสนับสนุน

เรายินดีรับการร่วมสนับสนุน! ดู คู่มือการร่วมสนับสนุน ของเราเพื่อเริ่มต้น

📈 ประวัติ Star

หาก seekdb มีประโยชน์สำหรับคุณ การกด Star ช่วยให้ผู้อื่นค้นพบได้ ⭐

📄 ใบอนุญาต

seekdb สร้างโดยทีม OceanBase — ซึ่งเป็นเอ็นจิ้นฐานข้อมูลเดียวกันที่ใช้งานจริงใน Alipay, Taobao, DiDi, Xiaomi และอื่นๆ เป็นโอเพนซอร์สเต็มรูปแบบภายใต้ Apache License, Version 2.0