chainlesschain 数据库迁移技能
描述
管理数据库 Schema 演进：检查当前结构、生成迁移脚本、检测代码与数据库的漂移、优化索引、生成测试数据。支持 SQLite 和 PostgreSQL。
使用方法
/db-migration [操作] [选项]
操作
Schema 检查
/db-migration --inspect
分析当前数据库结构:
- 表列表及列信息
- 主键和外键关系
- 索引和约束
- 数据量统计
生成迁移脚本
/db-migration --generate "描述变更内容"
从自然语言描述生成 SQL 迁移:
- UP 脚本（应用变更）
- DOWN 脚本（回滚变更）
- 数据安全检查（避免数据丢失）
- 向后兼容性验证
漂移检测
/db-migration --drift
对比代码中的 Schema 定义与实际数据库:
- 缺失的表/列
- 类型不匹配
- 索引差异
- 修复建议
索引优化
/db-migration --optimize-indexes
分析查询模式建议索引优化:
- 缺失索引（频繁查询但无索引）
- 冗余索引（重复或未使用）
- 复合索引建议
- EXPLAIN ANALYZE 输出分析
生成种子数据
/db-migration --seed <table_name>
为表生成测试数据:
- 符合约束的随机数据
- 外键关系维护
- 可配置数量
支持的数据库
| 数据库 | Schema 来源 | 说明 |
|---|---|---|
| SQLite | database.js, *.db | ChainlessChain 主数据库 |
| PostgreSQL | Spring Boot entities, DDL | 后端服务数据库 |
输出格式
迁移脚本
-- Migration: 004_add_tags_to_notes
-- Created: 2026-02-16
-- Description: Add tags column to notes table
-- UP
ALTER TABLE notes ADD COLUMN tags TEXT DEFAULT '[]';
CREATE INDEX idx_notes_tags ON notes(tags);
-- DOWN
DROP INDEX IF EXISTS idx_notes_tags;
ALTER TABLE notes DROP COLUMN tags;
示例
检查 Schema:
/db-migration --inspect
生成迁移:
/db-migration --generate "add embedding_model column to embedding_cache"
检测漂移:
/db-migration --drift