一、概述
1
版本。
| 報表伺服器版本 | JAR 包版本 | 功能變更 |
|---|---|---|
| 10.0 | - | - |
| 10.0 | 2018-12-27 | 新增【模式】設定項 |
| 10.0 | 2019-02-28 | 新增支援 SQL Server2017 版本 |
| 10.0 | 2019-05-20 | 新增支援遷移資料庫資料 |
| 10.0.18 | - | 1）支援自動讀取資料庫模式，防止手動輸入出錯 2）遷移外接資料庫，且不勾選「遷移資料至要啟用的資料庫」時，自動檢查新老資料庫對應工程版本是否一緻 |
注：JAR 包版本低於 2019-05-20 時，使用者配置外接資料庫時只能遷移資料，不可直接啟用新資料庫。
2
功能簡介。
報表系統配置外接資料庫後，遇到叢集環境或資料量較大情況時，可保證報表系統的穩定性。
使用者可在【初始化時】配置外接資料庫或在【平台中】配置 SQL Server 版本的外接資料庫。
注：若配置了外接資料庫，請勿輕易修改外接資料庫的帳號和密碼，否則會導緻工程啟動失敗。
如需修改，請參照：修改外接資料庫帳號密碼。
二、資料庫配置
1
資料庫版本。
外接資料庫支援的型別及版本如下表所示。
| 資料庫型別 | JAR 包版本 | 支援資料庫版本 |
|---|---|---|
| SQL Server | - | 2000、2005、2008、2012、2014、2016 |
| 2019-02-28 | 2017 |
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
建立資料庫。
建立一個資料庫，用於儲存平台相關資料。
標準建庫語句：【CREATE DATABASE finedb COLLATE Chinese_PRC_CS_AS】
SQL Server 資料庫的排序規則可選擇 Chinese_PRC_CS_AS（大小寫敏感）或 Chinese_PRC_CI_AS（大小寫不敏感），建議使用 Chinese_PRC_CS_AS（區分大小寫 ）。
選擇 Chinese_PRC_CS_AS ，將原封不動的把全部資料遷移過去。
選擇 Chinese_PRC_CI_AS ，遷移時如果報 fine_conf_entity 表違反了 PRIMARY KEY 約束之類的字樣，通常是工程有髒資料。
可執行下面SQL語句查看髒資料：【select lower(ID),COUNT(1) FROM FINE_CONF_ENTITY GROUP BY LOWER(ID) HAVING COUNT(1) >1】
注1：資料庫名不支援數字。
注2：不同 FineReport 工程，不可共用同一個外接資料庫，否則資料可能會出現錯亂。
三、方法一：初始化時配置外接資料庫
本方法適用於第一次登入數據決策系統時配置外接資料庫。
1
進入初始化介面。使用者可在第一次進入平台時配置外接資料庫，如下圖所示。
2
配置外接資料庫。
點選【配置資料庫】後，進入到外接資料庫配置介面，選擇資料庫型別為 SQL Server，輸入實際資料庫相應的資訊即可。如下圖所示。
各設定項說明如下表所示。
| 設定項 | 說明 |
|---|---|
| 資料庫型別 | 選擇 sqlserver |
| 驅動 | 無需修改，會自動配置 |
| 資料庫名稱 | 第二章第3節建立的資料庫名稱 禁止與其他工程共用資料庫，建議建立資料庫 資料庫名稱僅允許包含數字、字母、底線和「.」 |
| 帳號/主機/密碼/埠 | 根據本地資料庫實際情況填寫 主機名稱僅允許包含數字、字母、底線、「-」和「.」 使用者需要具備 create、delete、alter、update、select、insert 權限 |
| 模式 | 1）10.0.18 及之後版本的報表工程，僅支援下拉選擇模式 正確填寫完上面幾項設定後，點選模式下拉框中的「點選連結資料庫」，系統將自動連結該資料庫並讀取模式，選擇即可（盡量選擇和資料庫使用者的名稱相同的模式）
注：若提示資料庫連結失敗，請檢查上面幾項設定。 2）10.0.18 之前版本的報表工程，僅支援手動輸入模式 模式預設為 dbo 管理者可以用【SELECT * FROM sys.database_principals】尋找一下資料庫的模式，或者使用 Navicat 連結查看資料庫的模式。 |
3
配置成功。
等待一段時間，提示【已成功啟用新資料庫】。如下圖所示。
注：請勿在遷移程式中重新整理頁面。
四、方法二：平台中配置外接資料庫
本方法適用於進入數據決策系統後，第一次配置外接資料庫。
1
進入平台。
管理者登入數據決策系統，點選【管理系統】→【系統管理】→【標準】→【外接資料庫】→【待配置】，如下圖所示。
2
配置外接資料庫。
輸入實際資料庫相應的資訊，配置外接資料庫。如下圖所示。
各設定項說明如下表所示。
| 設定項 | 說明 |
|---|---|
| 資料庫型別 | 選擇 sqlserver |
| 驅動 | 無需修改，會自動配置 |
| 資料庫名稱 | 第二章第3節建立的資料庫名稱 禁止與其他工程共用資料庫，建議建立資料庫 資料庫名稱僅允許包含數字、字母、底線和「.」 |
| 帳號/主機/密碼/埠 | 根據本地資料庫實際情況填寫 主機名稱僅允許包含數字、字母、底線、「-」和「.」 使用者需要具備 create、delete、alter、update、select、insert 權限 |
| 模式 | 1）10.0.18 及之後版本的報表工程，僅支援下拉選擇模式 正確填寫完上面幾項設定後，點選模式下拉框中的「點選連結資料庫」，系統將自動連結該資料庫並讀取模式，選擇即可（盡量選擇和資料庫使用者的名稱相同的模式）
注：若提示資料庫連結失敗，請檢查上面幾項設定。 2）10.0.18 之前版本的報表工程，僅支援手動輸入模式 模式預設為 dbo 管理者可以用【SELECT * FROM sys.database_principals】尋找一下資料庫的模式，或者使用 Navicat 連結查看資料庫的模式。 |
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所示。
| 設定項 | 說明 |
|---|---|
| 資料庫型別 | 選擇 sqlserver |
| 驅動 | 無需修改，會自動配置 |
| 資料庫名稱 | 第二章第3節建立的資料庫名稱 禁止與其他工程共用資料庫，建議建立資料庫 資料庫名稱僅允許包含數字、字母、底線和「.」 |
| 帳號/主機/密碼/埠 | 根據本地資料庫實際情況填寫 主機名稱僅允許包含數字、字母、底線、「-」和「.」 使用者需要具備 create、delete、alter、update、select、insert 權限 |
| 模式 | 1）10.0.18 及之後版本的報表工程，僅支援下拉選擇模式 正確填寫完上面幾項設定後，點選模式下拉框中的「點選連結資料庫」，系統將自動連結該資料庫並讀取模式，選擇即可（盡量選擇和資料庫使用者的名稱相同的模式）
注：若提示資料庫連結失敗，請檢查上面幾項設定。 2）10.0.18 之前版本的報表工程，僅支援手動輸入模式 模式預設為 dbo 管理者可以用【SELECT * FROM sys.database_principals】尋找一下資料庫的模式，或者使用 Navicat 連結查看資料庫的模式。 |
3
遷移成功。
等待一段時間，會跳出彈窗提示：已成功切換至目標資料庫！新舊資料庫若存在資料差異可能影響系統運作，建議重啓工程以確定正常使用。
點選【確定】後，重啓報表工程，方遷移成功。如圖1、2所示。
注：請勿在遷移程式中重新整理頁面。
六、注意事項
外接 SQL Server 資料庫的時候，2018-12-27 之前的 JAR沒有模式(schema)的選項。
當升級 2018-12-27 及之後的 JAR 時，已配置的外接資料庫需要手動新增模式（schema）。
新增方法：修改【%FR_HOME%\webapps\webroot\WEB-INF\config\db.properties】檔案，手動新增模式。
若為 dbo 模式，【hibernate.default_schema=dbo】，如下圖所示。
上一篇：B14-11 配置Oracle外接資料庫
