apexbase 0.2.0

High-performance embedded database with Rust core and Python API

ApexBase

High-performance embedded database with Rust core and Python API

ApexBase 是一个基于 Rust 核心的高性能嵌入式数据库，提供简洁的 Python API。

✨ 特性

• 🚀 高性能 - Rust 核心，批量写入速度可达 97万+ ops/s
• 📦 单文件存储 - 自定义 .apex 文件格式，无需外部依赖
• 🔍 全文搜索 - 集成 NanoFTS，支持中文和模糊搜索
• 🐍 Python 友好 - 简洁的 API，支持 Pandas/Polars/PyArrow
• 💾 紧凑存储 - 相比传统方案节省约 45% 存储空间

📦 安装

# 从源码构建
cd ApexBase
maturin develop --release

# 安装可选依赖
pip install pandas pyarrow polars  # 数据框架支持

🚀 快速开始

from apexbase import ApexClient

# 创建客户端
client = ApexClient("./data")

# 存储数据
id = client.store({"name": "Alice", "age": 30, "city": "Beijing"})
ids = client.store([
    {"name": "Bob", "age": 25},
    {"name": "Charlie", "age": 35}
])

# 查询数据
results = client.query("age > 28")  # SQL 风格条件查询
record = client.retrieve(id)         # 按 ID 检索
all_data = client.retrieve_all()     # 获取所有记录

# 全文搜索
doc_ids = client.search_text("Alice")
records = client.search_and_retrieve("Beijing")

# 转换为 DataFrame
df = results.to_pandas()
pl_df = results.to_polars()

# 关闭连接
client.close()

📊 性能对比

操作	ApexBase (Rust)	传统方案	提升
批量写入 (10K)	17ms	57ms	3.3x
单条检索	0.01ms	0.4ms	40x
批量检索 (100)	0.08ms	1.1ms	14x
存储大小	2.1 MB	3.9 MB	1.8x 更小

📁 项目结构

ApexBase/
├── apexbase/                    # 主包目录
│   ├── src/                     # Rust 源代码
│   │   ├── storage/             # 存储引擎
│   │   ├── table/               # 表管理
│   │   ├── query/               # 查询执行器
│   │   ├── index/               # B-tree 索引
│   │   ├── cache/               # LRU 缓存
│   │   ├── data/                # 数据类型
│   │   └── python/              # PyO3 绑定
│   ├── python/                  # Python 包装层
│   │   └── apexbase/
│   │       └── __init__.py      # Python API
│   ├── Cargo.toml
│   └── pyproject.toml
├── Cargo.toml                   # 工作区配置
└── pyproject.toml               # 项目配置

🔧 API 参考

ApexClient

# 初始化
client = ApexClient(
    dirpath="./data",           # 数据目录
    drop_if_exists=False,       # 是否删除已存在的数据
    enable_fts=True,            # 启用全文搜索
    enable_search_cache=True,   # 启用搜索缓存
)

# 表操作
client.create_table("users")
client.use_table("users")
client.drop_table("users")
tables = client.list_tables()

# CRUD 操作
id = client.store({"key": "value"})
ids = client.store([{...}, {...}])
record = client.retrieve(id)
records = client.retrieve_many([1, 2, 3])
client.replace(id, {"new": "data"})
client.delete(id)
client.delete([1, 2, 3])

# 查询
results = client.query("age > 30")
results = client.query("name LIKE 'A%'")
count = client.count_rows()

# 全文搜索
ids = client.search_text("keyword")
ids = client.fuzzy_search_text("keywrd")  # 模糊搜索
records = client.search_and_retrieve("keyword")

# 数据框架集成
client.from_pandas(df)
client.from_polars(df)
results.to_pandas()
results.to_polars()

📄 License

Apache-2.0