hsql是FineBI内置的数据库，但由于hsql不能多线程访问、数据量大后不稳定等原因，导致碰到集群或者数据量比较大时，必须要迁移才能保证系统的稳定性。

而迁移是建立在已有旧数据的基础上，旧数据的迁移过程又存在不可预知的问题，因此在开始使用系统时就优先让用户选择外置数据库进行迁移。

注：1. 若想迁移后再改回原来的内置数据库，可参考外接数据库如何回迁内置数据库； 2. 不推荐在迁移过程中刷新页面；

数据迁移目前只支持Mysql、Oracle和SqlServer三种数据库类型，具体支持版本如下：

注：从2018-12-27开始支持DB2。此处若迁移至MySQL数据库，需要数据引擎为InnoDB，详细可参考MySQL数据库迁移失败.

首次访问决策平台时，首先进入初始化设置，除了第一步的账号设置外，多出第二步数据库设置的选项，如下所示：

注：在已完成外接数据库设置的情况下进行管理员重置时，只需要进行账号设置。

账号设置完成后，进入数据库配置，分为：内置数据库和外接数据库，这里选择“配置外接数据库”，如下：

注：内置数据库适用于本地试用产品功能，而外接数据库适用于平台的正式使用。

进入到配置界面，如下所示：

输入数据库相应的信息，这里以mysql为例，本地新建finedb数据库，设置默认字符集排序规则为utf_bin（mysql数据库需要设置排序规则为utf8_bin），如下图：

注：其他数据库oracle、db2的注意事项查看章节五。

点击“启用新数据库”按钮，连接并导入数据，如下图：

成功启用新数据库后，直接点击“登录”按钮，跳转到登录页面，如下：

根据上面的步骤，完成了外接数据库配置，则进入平台系统，选择管理系统>系统管理-常规，可看到外接数据库为“已配置”状态，如下图：

注：若未在初始化时配置外接数据库，则此处显示“待配置”状态，点击可进行配置。

点击“已配置”按钮，查看连接配置详细信息，也可以修改配置，再启用新数据库，如下：

若数据库已配置完成，修改并启用新数据库时提示：“该数据库已存在平台数据，导入数据前将清空原有平台数据，确认连接该数据库”，如下：

若未配置外接数据库进行迁移，在管理系统>智能检测-服务器配置检测中，会有相应的问题建议，点击“外接数据库配置”进行设置，如下：

若未配置外接数据库进行迁移，在正式注册后，给管理员发送系统消息，提醒其迁移，如下图：

查看系统消息详情，点击“处理”，即可进入到外接数据库配置，如下：

平台外接的数据库，mysql需要设置字符集排序规则（大小写敏感），MySQL中存在多种格式的utf8编码的排序规则，其中最常见的两种如下：

字符集排序规则	含义	示例
utf8_bin	将字符串中的每一个字符用二进制数据存储，区分大小写	Alex和alex被认为是两个不同的值
utf8_general_ci	ci为case insensitive的缩写，即大小写不敏感，为utf8默认编码	Alex和alex被认为是相同的值

推荐在迁移之前在mysql中新建数据库时，就设置好utf8_bin，如下图：

但是如果一开始数据库没有设置utf8_bin已经迁移过去了之后，那么有两张表fine_conf_entity、 fine_conf_classname需要修改为utf8_bin，下面已fine_conf_entity为例：

1）查询当前的字符集排序规则 

show full columns from fine_conf_entity

2）设置字符集排序规则为utf8_bin 

     设置列的默认校验规则 

ALTER TABLE fine_conf_entity MODIFY id VARCHAR(255) CHARACTER SET utf8 COLLATE utf8_bin; 

    设置表的校验规则 

ALTER TABLE fine_conf_entity DEFAULT CHARACTER SET utf8 COLLATE utf8_bin; 

3）查看是否修改成功 

5.2 迁移到oracle的注意事项

对于oracle数据库，迁移前最好单独建一个账户（新建一个表空间，并指定为该用户默认表空间）。
例如用system用户登录Oracle，添加用户data_migration：

create user data_migration identified by data_migration;

并对该用户进行赋权限：

grant connect,resource to data_migration; grant create any sequence to data_migration; grant create any table to data_migration; grant delete any table to data_migration; grant insert any table to data_migration; grant select any table to data_migration; grant unlimited tablespace to data_migration; grant execute any procedure to data_migration; grant update any table to data_migration; grant create any view to data_migration; grant create any Trigger to data_migration;

注：在迁移finedb数据库时要求使用的表空间最好是空的。

模式是一系列逻辑数据结构或者对象的集合。一个数据库用户（普通）拥有一个模式，模式的名字和数据库用户的名字相同。每个用户有一个单独的模式，用户创建的对象放在自己的模式中，这个对象叫做模式对象。

因为迁移定时任务需要用到临时表，所以需要确保数据库有临时表空间，同时由于DB2的PAGESIZE大小限定了可放到表空间的表的行长度和列数。所以在迁移之前需要确保数据库PAGESIZE足够大，基于以上原因，需要一些数据库操作来保证迁移顺利完成。

1）查询当前database的表空间极其PAGESIZE，9.7以下版本PAGESIZE需要大于等于8K(8192)，其余版本默认4K(4096)即可

2）如果没有符合条件的数据库，需要创建指定PAGESIZE大小的数据库

3）创建临时表空间(自定义路径)

4）DB2日志空间配置 

如果finedb数据量过大，而日志空间又不足，很可能在迁移过程中出错（SQLCODE=-964, SQLSTATE=57011），所以需要确保日志空间足够

查看日志配置， 参考配置如下 

 修改日志文件大小：

修改主日志文件个数：

修改辅助日志文件个数：

参考文档： https://www-01.ibm.com/support/docview.wss?uid=swg21295503

1）案例一：配置外接数据库mysql报错

2）案例二：配置外接数据库oracle报错oracle could not execute statement

解决方案：

模式填thin就会报错，改成用户名。

3）案例三：配置外接数据库mysql报错

报错 ERROR SqlExceptionHelper: Table 'shaxiang.ht_fine_output_platform_msg' doesn't exist ，ht_fine_output_platform_msg表不存在，但是我们导入完成的表并没有ht开头的表。考虑是否可能是临时表之类的，看到下一个报错

WARN Helper: unable to drop temporary id table after use [Statement violates GTID consistency: CREATE TEMPORARY TABLE and DROP TEMPORARY TABLE can only be executed outside transactional context.  

These statements are also not allowed in a function or trigger because functions and triggers are also considered to be multi-statement transactions.]

使用后无法删除临时id表[语句违反GTID一致性：创建临时表和删除临时表只能在事务上下文之外执行。

在函数或触发器中也不允许使用这些语句，因为函数和触发器也被认为是多语句事务。

GTID开启后限制了CREATE TEMPORARY TABLE and DROP TEMPORARY TABLE这些系统认为不安全的事务

解决方案：

去mysql配置文件关闭这个GTID配置参数 

enforce-gtid-consistency=OFF