SuperAPI AI 工具集

cognee-migrations

通用与其它

查看项目

更新于 10-16 06:15

技能介绍

用途:处理 cognee 的数据库迁移,理解迁移何时自动运行,并用 cognee-cli 检查或修复迁移状态。cognee 有两条一起运行的迁移链:关系型 schema(Alembic,位于 cognee/alembic/,版本记录在 alembic_version 表)与图/向量数据链(位于 cognee/modules/migrations/,按数据集记录在 dataset_database.migration_revision,访问控制关闭时记在 global_database_version.global_migration_revision)。

自动运行:run_migrations() 先跑关系链再跑数据链,触发点为 API 服务启动(含 Docker entrypoint.sh)、SDK 或 CLI 进程首次写入(每个进程一次),以及手动 await cognee.run_migrations()。设 ENABLE_AUTO_MIGRATIONS=false 可关闭自动运行,需自行执行 cognee-cli upgrade。并发进程由迁移锁串行化(Postgres 咨询锁或 SQLite 文件锁)。

检查与修复:cognee-cli current 查看各库已stamp的版本与最近失败;cognee-cli history 查看数据链;cognee-cli upgrade 升到 head,可跟数据链 slug 或 --alembic 指定关系目标;cognee-cli downgrade 与 stamp 支持 --dataset、--force 等参数。某个数据集的数据迁移失败会阻止对该数据集的写入,服务器仍能启动。

跨系统数据搬运:COGX 是唯一可回导的导出格式,用 cognee.export(..., format="cogx") 与 cognee.remember(COGXArchiveSource(...)) 备份或复制数据集,push 可上传到 Cognee Cloud。限制:没有整体切换数据库后端的工具;禁止手改 frozen_schema.py 或手写 Alembic revision id,数据链条目不可重命名、删除或重排;含 include_permissions 的归档含密码哈希,应按秘密处理。