页面历史

1、注意源环境知识库表名、列名 与目标环境知识库表名、列名大小写的策略是否一致。

尤其是目标环境为达梦数据库

2、注意源环境知识库与目标环境知识库的表数据大小写策略是否一致。

若源环境知识库表数据区分大小写，则在使用过程中可能在知识库中产生数据一样只是大小写不一样的数据。比如在源环境中可以创建2个用户，名称分别为Zhangsan、zhangsan，这两个用户由于知识库表数据区分大小写，因此数据库会认为是两条不一样的数据，是可以正常保存的。

此时若目标环境表数据并不区分大小写，则将源环境知识库恢复到目标环境 或将源环境的“用户管理“模块”导入到目标环境时，目标环境的知识库会认为 Zhangsan、zhangsan是同一条数据，而用户名称字段刚好是主键，因此就会出现主键冲突。系统抛错违反唯一约束。

解决方案有以下两种：
1）修改目标环境知识库为表数据大小写敏感。具体修改方式可参考数据库工具文档。

2）修改备份文件/导出文件中对应表的xml，使用编辑器打开xml文件，将其中一条记录如zhangsan，统一修改为其他数据如zhangsan1。保存xml文件之后重新恢复/导入。
注：但此种方案并不适用于所有场景，如果主键冲突的数据是通过数据源的数据库管理添加到smartbi中的表名、字段名等，是无法通过此种方式处理的。

...

概述

在进行两个服务器间的知识库迁移之前，遵循以下关键注意事项并提前做好检查与准备，可有效避免迁移过程中的错误，节省时间与人力成本。

Image Added

一、备份“目标环境”的知识库

迁移操作会覆盖目标环境的知识库。因此，在迁移前，请务必备份目标环境的知识库。后续若需恢复目标环境，可通过备份文件进行操作。
备份知识库功能请参考：备份知识库

二、核对源环境与目标环境知识库库信息

典型案例

某项目源环境为 MySQL（表数据大小写敏感），目标环境为达梦 8（表数据大小写不敏感）。源环境备份恢复到目标环境时失败，提示 “违反表 [t_parameter] 唯一性约束条件”。

经排查，源环境中某数据源创建了 ProName 和 proname 两个参数，生成的 ID 分别为 PARAM. 数据源名称.ProName 和 PARAM. 数据源名称.proname。因源环境区分大小写，两者可正常保存。但在达梦 8（不区分大小写）中，系统识别两者主键相同，产生冲突。​
在本案例中，解决方案有如下两种：

​

1 推荐：修改目标环境知识库为表数据大小写敏感，再重新恢复知识库。

2.不推荐 ​：在备份文件 backup.zip 中找到 t_parameter 表对应的 xml 文件，使用文本编辑器打开，搜索并修改参数的 ID 和名称（如将 “proname” 改为 “proname2”）。即通过修改xml的方式，将参数proname的ID和名称修改为 PARAM.数据源名称.proname2 和 proname2。将修改后的文件覆盖原 xml 文件后重新恢复。

但此方法存在风险：修改过程易出错；无法保证关联的其他表同步修改；且对于业务数据库中同名但大小写不同的表或字段，无法处理，如业务数据库为 Mysql区分大小写，存在表 Orders 和表 order，当出现本案例中的问题时，无法直接修改表的名称为其他名称，这种修改方式会导致表名不正确。

三、选择合适的备份 / 恢复工具

若源与目标环境知识库的数据库类型不同（如源为 MySQL，目标为 Oracle），不建议使用数据库工具进行备份和迁移，因其语法差异较大。推荐使用 Smartbi 系统中的备份与恢复知识库功能。具体操作可参考：备份知识库、恢复知识库

四、处理备份时的系统检查问题

在“备份知识库”时，系统会自动进行系统检查，该步骤是为了提前发现当前环境知识库存在的问题，如表是否存在主键丢失等情况。

Image Added

若提示出现以下问题，建议先对当前环境进行修复后，再重新备份知识库。

Image Added

五、目标环境为达梦数据库的特殊注意事项

若目标环境知识库为达梦数据库，则除了上述事项外，当源环境知识库为MySQL、Oracle、SQL Server、PostgreSQL时，需将达梦数据库的兼容模式设置为对应模式。

可通过以下语句查询达梦数据库的兼容模式
SELECT * FROM V$PARAMETER WHERE NAME = 'COMPATIBLE_MODE';

Image Added

修改达梦数据库兼容模式方法，请通过网络或 AI 搜索获取。