管理平台應用-配置Oracle外接資料庫

1

版本。

注：JAR 包版本低於 2019-05-20 時，使用者配置外接資料庫時僅能遷移資料，不可直接啟用新資料庫。

2

功能簡介。

1. 報表系統配置外接資料庫後，遇到叢集環境或資料量較大情況時，可保證報表系統的穩定性。

2. 使用者可在【初始化時】配置外接資料庫或在【平台中】配置 Oracle 版本的外接資料庫。

注：若配置了外接資料庫，請勿輕易修改外接資料庫的帳號和密碼，否則會導緻工程啟動失敗。

      如需修改，請參照：修改外接資料庫帳號密碼。

1

資料庫版本。

1. 外接資料庫支援的型別及版本如下表所示。

2

硬體配置。

注1：佔用空間需要結合使用度進行調整，可以根據webapps/webroot/WEB-INF/embed/finedb資料夾大小配置，並根據實際大小預估未來使用大小，增大1~2倍。

注2：推薦記憶體為預留給工程配置庫的記憶體。

注3：外接資料庫盡量和報表工程在同一網段，避免網路波動等問題。

3

建立資料庫。

1. 建立賬戶：對於 Oracle 資料庫，配置前最好單獨建一個賬戶（建立一個表空間，並指定為該使用者預設表空間）。

2. 建立使用者：【CREATE USER "FINEDB" IDENTIFIED BY "123456" ACCOUNT UNLOCK DEFAULT TABLESPACE "USERS"】。

3. 授予權限：【GRANT "CONNECT","RESOURCE" TO "FINEDB"】
   【ALTER USER "FINEDB" QUOTA UNLIMITED ON "USERS"】。

4. 建立資料庫：在 Oracle 中建立用於儲存遷移資料的 FineDB 資料庫。在後續外接資料庫配置時的資料庫名稱需要填入對應遷入儲存的資料庫名稱。

注1：由於 Oracle12c 版本的限制，建立使用者時，帳號必須以C##為前綴，否則無法正常使用。

注2：不同 FineReport 工程，不可共用同一個外接資料庫，否則資料可能會出現錯亂。

注3：在遷移 FineDB 資料庫時要求使用的表空間最好是空的。

4

更換驅動。

1

外接資料庫配置入口。

1. 外接資料庫的配置入口，有三種形式：

2. 超級管理者第一次登入數據決策系統時，即可為系統配置外接資料庫。如下圖1所示。

3. 對於使用內建資料庫的系統，管理者登入數據決策系統，點選【管理系統】→【系統管理】→【標準】→【外接資料庫】→【待配置】，可為系統第一次配置外接資料庫。如下圖2所示。

4. 對於已啟用外接資料庫的系統，管理者登入數據決策系統，點選【管理系統】→【系統管理】→【標準】→【外接資料庫】→【已配置】，可為系統遷移至新的外接資料庫。如下圖3所示。

2

配置外接資料庫。

1. 進入到外接資料庫配置介面後，選擇資料庫型別，輸入實際資料庫相應的資訊即可。如下圖所示。

3

設定項。

1. 各設定項說明如下表所示。

設定項	說明
資料庫型別	選擇 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> 2）Oracle 叢集 寫法一：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

遷移資料至要啟用的資料庫。

1. 使用者可根據自身需求選擇是否勾選【遷移資料至要啟用的資料庫】按鈕。具體如下：

2. 勾選【遷移資料至要啟用的資料庫】，新外接資料庫為空：點選【啟用新資料庫】後，會將原 finedb 資料庫的平台資料遷移到新外接資料庫中。

3. 勾選【遷移資料至要啟用的資料庫】，新外接資料庫中已存在平台資料：①點選【啟用新資料庫】後，跳出提示【該資料庫已存在平台資料，匯入資料前將情況原有平台資料，應答連結該資料庫？】。②點選【確定】將清空原有平台資料，將原 finedb 資料庫的平台資料遷移到新外接資料庫中。

4. 不勾選【遷移資料至要啟用的資料庫】，新外接資料庫為空：①點選【啟用新資料庫】後，跳出提示【目標資料庫為新資料庫，將當前資料遷移至目標資料庫後方能使用】。②點選【確定】，將原 finedb 資料庫的平台資料遷移到新外接資料庫中。

5. 不勾選【遷移資料至要啟用的資料庫】，新外接資料庫中已存在平台資料：①點選【啟用新資料庫】後，工程會自動檢查目標資料庫中資料對應的 JAR 包版本和當前工程的 JAR 包版本是否一緻。②若不一緻，則跳出提示【無法啟用！啟用新資料庫需要的工程版本：XXX。當前工程版本：XXX。請確定工程版本一緻！】。無法進行外接資料庫配置。

6. 若 JAR 包版本一緻，且原 finedb 資料庫為內建資料庫，則直接啟用新外接資料庫。

7. 若 JAR 包版本一緻，且原 finedb 資料庫為外接資料庫，遷移前將自動備份原資料庫的配置資訊，在【webapps\webroot\WEB-INF\config目錄下生成db.properties.bak】檔案，並直接啟用新外接資料庫。如下圖所示。

5

遷移成功。

1. 等待一段時間，遷移成功後，根據遷移時的情況，可能會跳出不同的彈窗提示。

2. 新外接資料庫，使用了原 finedb 資料庫的資料：則提示【已成功啟用目標資料庫】。點選【確定】即可，遷移成功。如下圖1所示：

3. 新外接資料庫，使用了該資料庫中原有的資料，且原 finedb 資料庫為內建資料庫：則提示【已成功切換至目標資料庫！新舊資料庫若存在資料差異可能影響系統運作，建議重啓工程以確定正常使用】。點選【確定】後，重啓報表工程，方遷移成功。如下圖2所示。

4. 新外接資料庫，使用了該資料庫中原有的資料，且原 finedb 資料庫為外接資料庫。則跳出兩個提示：已成功切換至目標資料庫！新舊資料庫若存在資料差異可能影響系統運作，建議重啓工程以確定正常使用。原資料庫配置已備份至config資料夾下，如有需要可以使用備份檔案還原資料庫配置。點選【確定】後，重啓報表工程，方遷移成功。如下圖3所示。

注：請勿在遷移過程中重新整理頁面。