1. 概述编辑
1.1 版本
| 报表服务器版本 | JAR 包版本 | 功能变更 |
|---|---|---|
| 10.0 | - | - |
| 10.0 | 2019-05-20 | 新增支持迁移数据库数据 |
注：JAR 包版本低于 2019-05-20 时，用户配置外接数据库时只能迁移数据，不可直接启用新数据库。
1.2 功能简介
报表系统配置外接数据库后，遇到集群环境或数据量较大情况时，可保证报表系统的稳定性。
用户可在「初始化时」配置外接数据库或在「平台中」配置 Oracle 版本的外接数据库。
2. 数据库配置编辑
2.1 数据库版本
外接数据库支持的类型及版本如下表所示：
| 数据库类型 | 支持数据库版本 |
|---|---|
| Oracle | 10g、11g、12c、9i |
2.2 硬件配置估算
| 用户数量 | 权限复杂度 | 推荐大小( 具体情况需考虑其他配置复杂度及访问量 ) |
|---|---|---|
| 1~100 | 简单 | 25M |
| 中等 | 50M | |
| 100~2000 | 简单 | 40M |
| 中等 | 85M | |
| 复杂 | 150M | |
| 2000~30000 | 简单 | 130M |
| 中等 | 250M | |
| 复杂 | 500M |
2.3 新建数据库
2.3.1 新建账户
对于 Oracle 数据库，配置前最好单独建一个账户（新建一个表空间，并指定为该用户默认表空间）。
例如用 system 用户登录 Oracle，添加用户 finedb：
create tablespace finedb datafile '/u01/oraDatafile/finedb01.dbf' size 50M autoextend on next 64M maxsize unlimited extent management local;
create user finedb identified by fr123 default tablespace finedb;
并对该用户进行赋权限：
grant connect,resource to finedb;
grant create sequence to finedb;
grant create table to finedb;
grant unlimited tablespace to finedb;
grant create procedure to finedb;
grant create view to finedb;
grant create Trigger to finedb
2.3.2 新建数据库
在 Oracle 中新建用于存储迁移数据的 FineDB 数据库。在后续外接数据库配置时的数据库名称需要填入对应迁入存储的数据库名称。
注1：不同 FineReport 工程，不可共用同一个外接数据库，否则数据可能会出现错乱。
注2：在迁移 FineDB 数据库时要求使用的表空间最好是空的。
3. 方法一：初始化时配置外接数据库编辑
本方法适用于第一次登录数据决策系统时配置外接数据库。
3.1 进入初始化界面
用户可在第一次进入平台时配置外接数据库，如下图所示：
3.2 配置外接数据库
点击「配置数据库」后，进入到外接数据库配置界面，输入实际数据库相应的信息即可。如下图所示：
各设置项说明如下表所示：
| 设置项 | 说明 |
|---|---|
| 数据库类型 | 选择 oracle |
| 驱动 | 无需修改，会自动配置 |
| 数据库名称 | 2.3 节新建的数据库名称 禁止与其他工程共用数据库，建议新建数据库 数据库名称只允许包含数字、字母、下划线和「.」 |
| 用户名/主机/密码/端口 | 根据本地数据库实际情况填写 主机名称只允许包含数字、字母、下划线、「-」和「.」 用户需要具备 create、delete、alter、update、select、insert 权限，建议有最高 root 权限 |
| 模式 | 模式的名字和数据库用户的名字相同（Oracle 的用户名和模式推荐大写） |
| URL | 数据库连接 URL 支持三种写法： 1）Oracle单机 jdbc:oracle:thin:@<host>:<port>:<SID> 写法一：jdbc:oracle:thin:@//<host>:<port>/<service_name> 写法二：jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=x.x.x.1)(PORT=1521))(ADDRESS=(PROTOCOL=TCP)(HOST=x.x.x.2)(PORT=1521)))(LOAD_BALANCE=yes)(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=xxrac))) 注：10.0.11 版本之后的工程，支持集群写法二。 |
3.3 配置成功
等待一段时间，提示已成功启用新数据库。如下图所示：
注：请勿在迁移过程中刷新页面。
4. 方法二：平台中配置外接数据库编辑
本方法适用于进入数据决策系统后，第一次配置外接数据库。
4.1 进入平台
管理员登录数据决策系统，点击「管理系统>系统管理>常规>外接数据库>待配置」，如下图所示：
4.2 配置外接数据库
输入实际数据库相应的信息，配置外接数据库。如下图所示：
各设置项说明如下表所示：
| 设置项 | 说明 |
|---|---|
| 数据库类型 | 选择 oracle |
| 驱动 | 无需修改，会自动配置 |
| 数据库名称 | 2.3 节新建的数据库名称 禁止与其他工程共用数据库，建议新建数据库 数据库名称只允许包含数字、字母、下划线和「.」 |
| 用户名/主机/密码/端口 | 根据本地数据库实际情况填写 主机名称只允许包含数字、字母、下划线、「-」和「.」 用户需要具备 create、delete、alter、update、select、insert 权限，建议有最高 root 权限 |
| 模式 | 模式的名字和数据库用户的名字相同（Oracle 的用户名和模式推荐大写） |
| URL | 数据库连接 URL 支持三种写法： 1）Oracle单机 jdbc:oracle:thin:@<host>:<port>:<SID> 写法一：jdbc:oracle:thin:@//<host>:<port>/<service_name> 写法二：jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=x.x.x.1)(PORT=1521))(ADDRESS=(PROTOCOL=TCP)(HOST=x.x.x.2)(PORT=1521)))(LOAD_BALANCE=yes)(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=xxrac))) 注：10.0.11 版本之后的工程，支持集群写法二。 |
4.3 配置成功
等待一段时间，会跳出弹窗提示：已成功启用目标数据库，点击「确定」即可。如下图所示：
注1：请勿在迁移过程中刷新页面。
注2：数据库配置成功后无需重启。
5. 方法三：平台二次迁移数据库编辑
本方法适用于系统已配置外接数据库后，迁移至新的数据库。
5.1 进入平台
管理员登录数据决策系统，点击「管理系统>系统管理>常规>外接数据库>已配置」，如下图所示：
5.2 配置外接数据库
输入实际数据库相应的信息，配置外接数据库。如下图所示：
各设置项说明如下表所示：
| 设置项 | 说明 |
|---|---|
| 数据库类型 | 选择 oracle |
| 驱动 | 无需修改，会自动配置 |
| 数据库名称 | 2.3 节新建的数据库名称 禁止与其他工程共用数据库，建议新建数据库 数据库名称只允许包含数字、字母、下划线和「.」 |
| 用户名/主机/密码/端口 | 根据本地数据库实际情况填写 主机名称只允许包含数字、字母、下划线、「-」和「.」 用户需要具备 create、delete、alter、update、select、insert 权限，建议有最高 root 权限 |
| 模式 | 模式的名字和数据库用户的名字相同（Oracle 的用户名和模式推荐大写） |
| URL | 数据库连接 URL 支持三种写法： 1）Oracle单机 jdbc:oracle:thin:@<host>:<port>:<SID> 写法一：jdbc:oracle:thin:@//<host>:<port>/<service_name> 写法二：jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=x.x.x.1)(PORT=1521))(ADDRESS=(PROTOCOL=TCP)(HOST=x.x.x.2)(PORT=1521)))(LOAD_BALANCE=yes)(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=xxrac))) 注：10.0.11 版本之后的工程，支持集群写法二。 |
「迁移数据至要启用的数据库」按钮说明：
1）勾选「迁移数据至要启用的数据库」
切换数据库时，原外接数据库的数据会导入到新数据库，工程下不生成历史数据备份文件。
若新数据库中已存在平台数据，导入数据前将清空原有平台数据。提示如下图所示：
2）不勾选「迁移数据至要启用的数据库」
若新外接数据库为空，提示必须将当前数据迁移到目标数据库。
若新外接数据库不为空
迁移前将自动备份原数据库的配置信息，在webapps\webroot\WEB-INF\config目录下生成db.properties.bak文件。如下图所示：
直接启用新数据库，迁移成功后，提示如下图所示：
5.3 迁移成功
等待一段时间，会跳出弹窗提示：已成功切换至目标数据库！新旧数据库若存在数据差异可能影响系统运行，建议重启工程以确保正常使用。
点击「确定」后，重启报表工程，方迁移成功。如下图所示：
注：请勿在迁移过程中刷新页面。
提示：
