Langchain-Chatchat 版本升级后如何用 chatchat kb --import-db 从备份恢复 info.db 数据

Langchain-Chatchat 版本升级后如何用 chatchat kb --import-db 从备份恢复 info.db 数据【免费下载链接】Langchain-ChatchatLangchain-Chatchat原Langchain-ChatGLM基于 Langchain 与 ChatGLM, Qwen 与 Llama 等语言模型的 RAG 与 Agent 应用 | Langchain-Chatchat (formerly langchain-ChatGLM), local knowledge based LLM (like ChatGLM, Qwen and Llama) RAG and Agent app with langchain项目地址: https://gitcode.com/GitHub_Trending/la/Langchain-Chatchat升级 Langchain-Chatchat 到新版本后知识库元数据库info.db的表结构可能发生变化旧库不能直接沿用。但如果你的知识库和向量库内容本身没有改动、不需要重新向量化项目提供了chatchat kb --import-db命令从旧版本备份的 SQLite 数据库即备份下来的info.db把数据导入当前版本的info.db。本文只覆盖这一场景——版本升级导致info.db结构变化、但无需重建向量库时的数据恢复操作。--import-db 的适用条件与边界--import-db对应的实现是 import_from_db其文档说明如下在知识库与向量库无变化的情况下从备份数据库中导入数据到 info.db。适用于版本升级时info.db 结构变化但无需重新向量化的情况。请确保两边数据库表名一致需要导入的字段名一致。当前仅支持 sqlite。据此使用它需要同时满足备份文件是一个SQLite数据库也就是旧版本的info.db文件拷贝其他数据库类型不受支持备份库与当前版本的数据库模型表名一致、待导入的字段名一致知识库与向量库无变化向量数据不需要重建。info.db的默认位置由 settings.py 定义位于数据根目录CHATCHAT_ROOT下的data/knowledge_base/info.db也可通过DB_ROOT_PATH/SQLALCHEMY_DATABASE_URI配置项指向其他路径README.md 给出了自定义路径的示例配置。备份时拷贝的就是这个文件。注意一条边界如果你的DEFAULT_VS_TYPE向量库类型或DEFAULT_EMBEDDING_MODEL嵌入模型发生了变化或向量库尚未填充属于重建向量库的场景应使用chatchat kb -r--recreate-vs而不是--import-db。准备停止服务并备份旧版 info.db导入前有两个来自文档的明确要求执行导入时应确保没有其他操作正在访问目标数据库以避免数据冲突见 migrate.md 中import_from_db的注意事项所以先停掉正在运行的 chatchat 服务升级前先备份重要数据。README.md 中关于 0.3.x 的提示写明“0.3.x 结构改变很大……记得提前备份重要数据!”Docker 迁移文档 docs/install/README_docker.md 也要求在迁移前先备份好数据。具体做法把旧版本的info.db文件拷贝到一个安全位置这个拷贝文件就是后面--import-db要传入的备份路径。执行导入命令chatchat kb子命令由 cli.py 注册main.add_command(kb_main, kb)各选项定义在 init_database.py。基本命令chatchat kb --import-db 备份文件路径备份文件路径替换为上面备份下来的旧版info.db文件路径例如chatchat kb --import-db ./data/knowledge_base/info.db.bak如果担心新版本中部分表还不存在可以组合--create-tables选项。它的 help 说明是 “create empty tables if not existed”先看下表是否存在不存在则创建已存在的表不会被修改chatchat kb --create-tables --import-db ./data/knowledge_base/info.db.bakchatchat kb的其他选项-r、-u、-i、--prune-db等与本次恢复任务无关不要与--import-db混用。验证导入结果文档没有给出一段固定的成功日志可以依据import_from_db的实际输出行为来判断对每个在备份库中存在、且对应当前数据库模型的表终端会打印processing table: {表名}随后逐行打印导入的数据代码中通过pprint输出每一行成功完成时函数返回True如果无法读取备份数据库或过程中遇到其他错误会打印无法读取备份数据库{sqlite_path}。错误信息{e}并返回False以上输出行为见 migrate.md 中“输出示例”与源码 migrate.pychatchat kb的父进程在子任务结束后打印总计用时...见 init_database.py。如果终端出现无法读取备份数据库错误行说明本次导入失败需要检查备份文件路径是否正确、文件是否为可读的 SQLite 文件。执行过程中按 CtrlC 会终止子进程代码中捕获KeyboardInterrupt后调用p.terminate()此时不要当作完成应重新执行。确认数据导入无误后按项目文档的启动方式执行chatchat start -a重新启动服务即可。限制与注意事项仅支持 SQLite备份库必须是 SQLite 文件不支持其他数据库import_from_db文档说明“当前仅支持 sqlite”。字段按当前模型过滤导入时每一行会按当前数据库模型定义的列名过滤备份中不在当前模型列内的字段不会被写入见 migrate.py 中data {k: row[k] for k in row.keys() if k in model.columns}的过滤逻辑。所以备份库与当前模型表名、字段名不一致时缺失或不匹配的字段不会导入。不存在的表会被跳过备份库中没有的表直接跳过不报错。不涉及向量数据该命令只恢复info.db中的元数据不清除、不重建任何向量库。向量库类型或嵌入模型变化时请改用chatchat kb -r。--create-tables不修改已有表它只创建尚不存在的表不会更新或修改现有表结构见 migrate.md 中create_tables的注意事项。相关文档与源码路径markdown_docs/server/knowledge_base/migrate.mdimport_from_db、create_tables、folder2db等迁移函数的完整说明libs/chatchat-server/chatchat/server/knowledge_base/migrate.py导入实现libs/chatchat-server/chatchat/init_database.pychatchat kb的 CLI 选项定义libs/chatchat-server/chatchat/settings.pyinfo.db默认路径配置【免费下载链接】Langchain-ChatchatLangchain-Chatchat原Langchain-ChatGLM基于 Langchain 与 ChatGLM, Qwen 与 Llama 等语言模型的 RAG 与 Agent 应用 | Langchain-Chatchat (formerly langchain-ChatGLM), local knowledge based LLM (like ChatGLM, Qwen and Llama) RAG and Agent app with langchain项目地址: https://gitcode.com/GitHub_Trending/la/Langchain-Chatchat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考