一、概述
1
版本。
| 報表伺服器版本 | JAR 包版本 | 功能變更 |
|---|---|---|
| 10.0 | - | - |
| 10.0 | 2019-05-20 | 新增支援遷移資料庫資料 |
| 10.0.18 | - | 1）支援自動讀取資料庫模式，防止手動輸入出錯 2）遷移外接資料庫，且不勾選【遷移資料至要啟用的資料庫】時，自動檢查新老資料庫對應工程版本是否一緻 |
注：JAR 包版本低於 2019-05-20 時，使用者配置外接資料庫時僅能遷移資料，不可直接啟用新資料庫。
2
功能簡介。
報表系統配置外接資料庫後，遇到叢集環境或資料量較大情況時，可保證報表系統的穩定性。
使用者可在【初始化時】配置外接資料庫或在【平台中】配置 Oracle 版本的外接資料庫。
注：若配置了外接資料庫，請勿輕易修改外接資料庫的帳號和密碼，否則會導緻工程啟動失敗。
如需修改，請參照：修改外接資料庫帳號密碼。
二、資料庫配置
1
資料庫版本。
外接資料庫支援的型別及版本如下表所示。
| 資料庫型別 | 支援資料庫版本 |
|---|---|
| Oracle | 9i、10g、11g、12c |
2
硬體配置。
| 配置型別 | 最低配置 | 推薦配置 |
|---|---|---|
| 記憶體 | 1GB | 2GB |
| CPU | 4核 | 8核 |
| 網速 | 50Mbps | 100Mbps |
| 佔用空間 | 1GB | 2GB |
| 磁盤讀寫速度 | 50MB/s | 100MB/s |
注1：佔用空間需要結合使用度進行調整，可以根據webapps/webroot/WEB-INF/embed/finedb資料夾大小配置，並根據實際大小預估未來使用大小，增大1~2倍。
注2：推薦記憶體為預留給工程配置庫的記憶體。
注3：外接資料庫盡量和報表工程在同一網段，避免網路波動等問題。
3
建立資料庫。
建立賬戶：對於 Oracle 資料庫，配置前最好單獨建一個賬戶（建立一個表空間，並指定為該使用者預設表空間）。
建立使用者：【CREATE USER "FINEDB" IDENTIFIED BY "123456" ACCOUNT UNLOCK DEFAULT TABLESPACE "USERS"】。
授予權限：【GRANT "CONNECT","RESOURCE" TO "FINEDB"】
【ALTER USER "FINEDB" QUOTA UNLIMITED ON "USERS"】。建立資料庫：在 Oracle 中建立用於儲存遷移資料的 FineDB 資料庫。在後續外接資料庫配置時的資料庫名稱需要填入對應遷入儲存的資料庫名稱。
注1：由於 Oracle12c 版本的限制，建立使用者時，帳號必須以C##為前綴，否則無法正常使用。
注2：不同 FineReport 工程，不可共用同一個外接資料庫，否則資料可能會出現錯亂。
注3：在遷移 FineDB 資料庫時要求使用的表空間最好是空的。
4
更換驅動。
| 資料庫版本 | 更換驅動 |
|---|---|
| 10g、9i | FineReport 內建了ojdbc14.jar驅動包，無需更換 |
| 11g、12c | 1）從 Oracle 官網 下載ojdbc8.jar驅動包。 2）關閉報表工程。 3）删除工程webapps\webroot\WEB-INF\lib目錄下的ojdbc14.jar驅動包。 4）将驅動包上傳至工程webapps\webroot\WEB-INF\lib目錄下。 5）重啓報表工程。 |
三、方法一：初始化時配置外接資料庫
本方法適用於第一次登入數據決策系統時配置外接資料庫。
1
進入初始化介面。使用者可在第一次進入平台時配置外接資料庫，如下圖所示。
2
配置外接資料庫。
點選【配置資料庫】後，進入到外接資料庫配置介面，選擇資料庫型別為 Oracle，輸入實際資料庫相應的資訊即可。如下圖所示。
各設定項說明如下表所示。
| 設定項 | 說明 |
|---|---|
| 資料庫型別 | 選擇 oracle |
| 驅動 | 無需手動修改 |
| 資料庫名稱 | 第二章第3節建立的資料庫名稱 禁止與其他工程共用資料庫，建議建立資料庫 資料庫名稱僅允許包含數字、字母、底線和「.」 |
| 帳號/主機/密碼/埠 | 根據本地資料庫實際情況填寫 主機名稱僅允許包含數字、字母、底線、「-」和「.」 使用者需要具備 create、delete、alter、update、select、insert 權限 |
| 模式 | 1）10.0.18 及之後版本的報表工程，僅支援下拉選擇模式 正確填寫完上面幾項設定後，點選模式下拉框中的【點選連結資料庫】，系統將自動連結該資料庫並讀取模式，選擇即可（盡量選擇和資料庫使用者的名稱相同的模式） 注：若提示資料庫連結失敗，請檢查上面幾項設定。
2）10.0.18 之前版本的報表工程，僅支援手動輸入模式 模式的名稱和資料庫使用者的名稱相同（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
配置成功。
等待一段時間，提示【已成功啟用新資料庫】。如下圖所示。
注：請勿在遷移程式中重新整理頁面。
四、方法二：平台中配置外接資料庫
本方法適用於進入數據決策系統後，第一次配置外接資料庫。
1
進入平台。
管理者登入數據決策系統，點選【管理系統】→【系統管理】→【標準】→【外接資料庫】→【待配置】，如下圖所示。
2
配置外接資料庫。
輸入實際資料庫相應的資訊，配置外接資料庫。如下圖所示。
各設定項說明如下表所示。
| 設定項 | 說明 |
|---|---|
| 資料庫型別 | 選擇 oracle |
| 驅動 | 無需手動修改 |
| 資料庫名稱 | 第二章第3節建立的資料庫名稱 禁止與其他工程共用資料庫，建議建立資料庫 資料庫名稱僅允許包含數字、字母、底線和「.」 |
| 帳號/主機/密碼/埠 | 根據本地資料庫實際情況填寫 主機名稱僅允許包含數字、字母、底線、「-」和「.」 使用者需要具備 create、delete、alter、update、select、insert 權限 |
| 模式 | 1）10.0.18 及之後版本的報表工程，僅支援下拉選擇模式 正確填寫完上面幾項設定後，點選模式下拉框中的【點選連結資料庫】，系統將自動連結該資料庫並讀取模式，選擇即可（盡量選擇和資料庫使用者的名稱相同的模式） 注：若提示資料庫連結失敗，請檢查上面幾項設定。
2）10.0.18 之前版本的報表工程，僅支援手動輸入模式 模式的名稱和資料庫使用者的名稱相同（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
配置成功。
等待一段時間，會跳出彈窗提示：已成功啟用目標資料庫，點選【確定】即可。如下圖所示。
注1：請勿在遷移程式中重新整理頁面。
注2：資料庫配置成功後無需重啓。
五、方法三：平台二次遷移資料庫
本方法適用於系統已配置外接資料庫後，遷移至新的外接資料庫。
1
進入平台。
管理者登入數據決策系統，點選【管理系統】→【系統管理】→【標準】→【外接資料庫】→【已配置】，如圖1所示。
2
配置外接資料庫。
輸入實際資料庫相應的資訊，配置外接資料庫。如下圖所示。
各設定項說明如下表所示。
【遷移資料至要啟用的資料庫】按鈕說明：1）勾選【遷移資料至要啟用的資料庫】：切換資料庫時，原外接資料庫的資料會匯入到新資料庫，工程下不生成曆史資料備份檔案。若新資料庫中已存在平台資料，匯入資料前將清空原有平台資料。提示如圖2所示；2）不勾選【遷移資料至要啟用的資料庫】：若新外接資料庫為空，提示必須將當前資料遷移到目標資料庫。若新外接資料庫不為空，遷移前將自動備份原資料庫的配置資訊，在【webapps\webroot\WEB-INF\config】目錄下生成【db.properties.bak】檔案。如圖3所示。
10.0.18 及之後版本的報表工程，會自動檢查目標資料庫中資料對應的 JAR 包版本和當前工程的 JAR 包版本是否一緻。若不一緻，則跳出提示：【無法啟用！啟用新資料庫需要的工程版本：XXX。當前工程版本：XXX。請確定工程版本一緻！】；若 JAR 包版本一緻，則直接啟用新資料庫，遷移成功後，提示如圖4所示。
| 設定項 | 說明 |
|---|---|
| 資料庫型別 | 選擇 oracle |
| 驅動 | 無需手動修改 |
| 資料庫名稱 | 第二章第3節建立的資料庫名稱 禁止與其他工程共用資料庫，建議建立資料庫 資料庫名稱僅允許包含數字、字母、底線和「.」 |
| 帳號/主機/密碼/埠 | 根據本地資料庫實際情況填寫 主機名稱僅允許包含數字、字母、底線、「-」和「.」 使用者需要具備 create、delete、alter、update、select、insert 權限 |
| 模式 | 1）10.0.18 及之後版本的報表工程，僅支援下拉選擇模式 正確填寫完上面幾項設定後，點選模式下拉框中的【點選連結資料庫】，系統將自動連結該資料庫並讀取模式，選擇即可（盡量選擇和資料庫使用者的名稱相同的模式） 注：若提示資料庫連結失敗，請檢查上面幾項設定。
2）10.0.18 之前版本的報表工程，僅支援手動輸入模式 模式的名稱和資料庫使用者的名稱相同（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
遷移成功。
等待一段時間，會跳出彈窗提示：已成功切換至目標資料庫！新舊資料庫若存在資料差異可能影響系統運作，建議重啓工程以確定正常使用。
點選【確定】後，重啓報表工程，方遷移成功。如圖1、2所示。
注：請勿在遷移程式中重新整理頁面。
上一篇：B14-10 配置MySQL8外接資料庫
