核心功能
KameleonDB 是一款专为 AI Agent 设计的无模式(schema-less)关系型数据库,核心价值在于 "存储即设计" —— 无需预先定义完整 Schema,可随时根据业务发现动态添加字段,历史数据自动兼容。
核心用法流程:
1. 初始化:kameleondb admin init 快速部署(SQLite 零配置,或 PostgreSQL 生产环境)
2. 动态建表:schema create <Entity> 定义实体,字段支持 string/int/float/bool/datetime/json 及修饰符 required/unique/indexed
3. 演进式扩展:schema alter <Entity> --add/--drop/--rename 持续迭代,带 --reason 审计追踪
4. 数据操作:data insert/get/update/delete/list 标准 CRUD,支持 --from-file 批量导入
5. 关系管理:data link/unlink/get-linked 实现多对多关系,无需外键约束
6. SQL 查询:query run 直接执行 SQL,JSON 字段通过 data->>'field' 语法访问
7. 性能优化:查询自动提示 storage materialize 物化建议,加速大数据量场景
显著优势:
- 零迁移成本:Schema 变更即时生效,旧记录自动填充 null,软删除保留历史
- Agent 原生设计:
--json全局支持机器可读输出,Schema Context 辅助 LLM 生成准确 SQL - 审计完备:
admin changelog完整记录谁在何时因何修改了 Schema - 轻量部署:SQLite 单机运行,PostgreSQL 无缝升级,无额外基础设施依赖
局限与风险:
- 功能边界:非分布式数据库,无内置高可用/分片机制,TB 级数据需手动优化
- JSON 查询限制:复杂 JSON 路径查询依赖 PostgreSQL 特定语法,SQLite 性能受限
- 关系完整性:无级联删除/外键约束,需应用层维护引用一致性
- 安全风险:
--force强制删除字段不可逆,生产环境建议开启admin changelog监控
适用场景:Agent 记忆持久化、轻量级 CRM/项目管理、知识库构建、API 数据缓存、用户偏好存储。特别适合需求快速迭代、Schema 不确定的探索性项目。
不适合场景:金融级事务一致性要求、高并发写入(>1000 QPS)、复杂 OLAP 分析(建议导出至专用数仓)。