pylibseekdb でローカルの seekdb を起動し、PyMySQL で SQL を実行します。Python 3.11 以降が必要です。

python3 -m pip install -U pylibseekdb pymysql

以下の例を example.py として保存します。connection_options() で接続引数を取得し、PyMySQL に渡します。コンテキストマネージャーにより、カーソルと SQL 接続を閉じてからランタイムハンドルを解放します：

from contextlib import closing

import pylibseekdb
import pymysql

with closing(pylibseekdb.open("./seekdb.db")) as db:
    options = db.connection_options()
    with pymysql.connect(
        database="test",
        autocommit=True,
        cursorclass=pymysql.cursors.DictCursor,
        **options,
    ) as connection:
        with connection.cursor() as cursor:
            cursor.execute("SELECT 1 AS value")
            print(cursor.fetchall())

実行すると [{'value': 1}] が出力されます：

python3 example.py

詳しい使い方 · 対応プラットフォームと環境要件

テキストのエンベディングやハイブリッド検索を備えた高水準の Collection API が必要な場合は、pyseekdb を参照してください。

@oceanbase/seekdb-node でローカルの seekdb を起動し、mysql2 で SQL を実行します。Node.js 22 以降が必要で、JavaScript と TypeScript の両方に対応しています。

npm install @oceanbase/seekdb-node mysql2

対応するネイティブランタイムが自動インストールされるよう、npm の optional dependencies を有効にしてください。このバインディングは独立したローカル seekdb プロセスを管理します。ランタイムハンドルを解放する前に SQL 接続を閉じてください。

以下の例を example.mjs として保存します（ES modules を使用し、TypeScript の型宣言も付属しています）：

import { seekdb } from "@oceanbase/seekdb-node";
import mysql from "mysql2/promise";

const db = await seekdb.open("./seekdb.db");
let connection;
try {
  const endpoint = db.connectionOptions();
  const location = endpoint.transport === "tcp"
    ? { host: endpoint.host, port: endpoint.port }
    : { socketPath: endpoint.transport === "unix_socket"
        ? endpoint.unixSocket : endpoint.namedPipe };
  connection = await mysql.createConnection({
    ...location,
    user: endpoint.user,
    password: "",
    database: "test",
  });
  const [rows] = await connection.query("SELECT 1 AS value");
  console.log(rows);
} finally {
  try {
    if (connection) await connection.end();
  } finally {
    db.close();
  }
}

実行すると [ { value: 1 } ] が出力されます：

node example.mjs

詳しい使い方と対応プラットフォーム

高水準の JavaScript Collection API が必要な場合は、seekdb-js を参照してください。

seekdb-go でローカルの seekdb を起動し、go-sql-driver/mysql で SQL を実行します。この例には Go 1.24 以降、CGO_ENABLED=1、C コンパイラーが必要です。

mkdir seekdb-go-example
cd seekdb-go-example
go mod init example.com/seekdb-demo

以下の例を main.go として保存します。ConnectionOptions が返す接続先を使用し、ランタイムハンドルを解放する前に SQL 接続を閉じます：

package main

import (
	"database/sql"
	"fmt"
	"log"
	"net"

	"github.com/go-sql-driver/mysql"
	seekdb "github.com/oceanbase/seekdb-go"
)

func main() {
	if err := run(); err != nil {
		log.Fatal(err)
	}
}

func run() error {
	db, err := seekdb.Open("./seekdb.db")
	if err != nil {
		return err
	}
	defer db.Close()

	endpoint, err := db.ConnectionOptions()
	if err != nil {
		return err
	}
	cfg := mysql.NewConfig()
	cfg.User, cfg.DBName = endpoint.User, "test"
	switch endpoint.Transport {
	case "unix_socket":
		cfg.Net, cfg.Addr = "unix", endpoint.UnixSocket
	case "tcp":
		cfg.Net, cfg.Addr = "tcp", net.JoinHostPort(endpoint.Host, fmt.Sprint(endpoint.Port))
	default:
		return fmt.Errorf("unsupported transport %q", endpoint.Transport)
	}
	connection, err := sql.Open("mysql", cfg.FormatDSN())
	if err != nil {
		return err
	}
	defer connection.Close()

	var value int
	if err := connection.QueryRow("SELECT 1 AS value").Scan(&value); err != nil {
		return err
	}
	fmt.Println(value)
	return nil
}

実行時に Go が依存関係を解決し、現在のプラットフォーム用のネイティブバンドルを取得します。結果は 1 です：

go run -mod=mod .

seekdb-go に対する通常の go get や go mod tidy は、全対応プラットフォームのバンドルも取得することがあります。

詳しい使い方 · 対応プラットフォームと環境要件

curl 一発で稼働中のデータベースが手に入ります — サインアップ不要、クレジットカード不要。

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

7 日間無料。詳細はこちら →

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

この Docker イメージの詳細はドキュメントを参照してください。

# 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 オフラインインストールと設定の詳細はデプロイメントドキュメントを参照してください。

エージェントの典型的なループ：観察を書き込み、ミリ秒後に関連コンテキストを検索、これを繰り返します。seekdb の非同期インデックスパイプラインが、持続的な並行負荷の下でも読み書き双方の高速性を維持します。

import pyseekdb

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

for step in agent.run():
    # 観察結果を永続化
    memory.upsert(ids=[step.id], documents=[step.observation])

    # 関連コンテキストを検索 — 書き込みの数ミリ秒後に、
    # インクリメンタル HNSW が即座に応答（バックグラウンドリビルド待ち不要）
    relevant = memory.query(query_texts=step.next_query, n_results=5)

    agent.act(relevant)

-- ベクトル列、全文インデックス、HNSW ベクトルインデックスを持つテーブル
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;

-- ハイブリッド検索：ベクトル類似度 + 全文マッチを 1 つのクエリで
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 サンドボックス — FORK DATABASE で安全に実験、MERGE で採用、DROP で即ロールバック
• ハイブリッド検索 — ベクトル + 全文 + リレーショナルを 1 本の SQL で
• MySQL プロトコル — LangChain、LlamaIndex、Dify がそのまま動作

パーソナルアシスタント · エンタープライズ自動化 · バーティカルエージェント · エージェントプラットフォーム

seekdb のハイブリッド検索 + マルチモデルエンジンは、従来型の AI ワークロードにも最適です：

• 📖 RAG とナレッジ検索 — ベクトル + 全文 + スカラーフィルター、多段階アクセス制御対応。エンタープライズ QA、カスタマーサポート、業界インサイト、個人ナレッジベース。
• 🔍 セマンティック検索 — エンベディングベースのテキスト、画像、マルチモーダル検索。商品検索、テキストから画像、画像から商品。
• 💻 AI 支援コーディング — セマンティックコード検索、マルチプロジェクト分離、タイムトラベルクエリ。IDE プラグインやコードエージェント向け。ローカル IDE、Web IDE、デザインからコードへ。
• ⬆️ エンタープライズアプリケーションインテリジェンス — レガシーシステム向けの MySQL 互換 AI レイヤー、行列ハイブリッドストレージ対応。ドキュメントインテリジェンス、ビジネスインサイト、金融システム。
• 📱 オンデバイス＆エッジ AI — リソース制約のあるデバイス向けの組み込み/マイクロサーバーモード。車載システム、AI 教育、コンパニオンロボット、ヘルスケアデバイス。