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