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 遷移成功
等待一段時間，會跳出彈窗提示：已成功切換至目标數據庫！新舊數據庫若存在數據差異可能影響系統運行，建議重啓沖刺以确保正常使用。
點擊「确定」後，重啓報表工程，方遷移成功。如下圖所示：
注：請勿在遷移過程中刷新頁面。
提示：
