反饋已提交

網絡繁忙

配置MySQL外接資料庫

1. 概述

1.1 版本

報表伺服器版本
功能變更
11.0-
11.0.3

1)首次配置外接資料庫時,支援自行選擇是否「遷移資料至要啟動的資料庫」

2)遷移外接資料庫的程式提示細化,方便使用者瞭解遷移進度

1.2 應用場景

帆軟應用中,管理者往往會在平台設定使用者、掛載目錄、分配權限、設定排程管理。這些配置,均儲存於配置庫中。

在正式環境下,使用者可準備一個MySQL資料庫,與帆軟應用對接,用於配置儲存。穩定的外部資料庫,可確定帆軟應用在高負載下的穩定運作。

2. 準備配置庫

使用者需要自行準備並部署MySQL資料庫和表空間

帆軟不提供相關資料和指導,僅對必要內容進行指明,請查閱資料庫官網獲取其他幫助。

如維運能力不足,推薦使用維運平台部署新專案時,勾選「部署MySQL8」即可,無需手動部署和調優。

2.1 資料庫版本

本文列出的是帆軟測試透過的環境。

  • 本文未提及的更低版本,一般預設不支援,或存在一些漏洞,不建議使用

  • 本文未提及的更高版本,使用者可自行測試驗證。如果出現問題,付費使用者可聯絡技術支援獲取幫助。技術支援聯絡方式:「服務平台>線上支援」

資料庫類型
資料庫版本
MySQL5

5.1.73、5.5.31、5.5.46、5.5.56、5.5.62

5.6.22、5.6.28、5.6.31、5.6.35、5.6.37、5.6.44

5.7.16、5.7.235.7.265.7.33

MySQL8

8.0.11、8.0.16、8.0.20、8.0.21、8.2

注:不支援 MySQL 8.0.19 版本資料庫作為外接庫,該版本存在可能導致外接庫當機的 bug,進而導致帆軟應用不可用,建議至少升級至 8.0.20 及以上版本

RDS MySQL全版本

2.2 伺服器配置

配置類型最低配置推薦配置注意事項
記憶體1GB
2GB

記憶體,是指分配給配置庫的記憶體,而非伺服器的所有記憶體

如有條件,建議配置庫獨佔一台伺服器

如條件不足,至少確定部署配置庫的伺服器中,不部署帆軟應用以外的任何內容,且確定分配給配置庫的記憶體足夠

CPU4核8核-
網速50Mbps100Mbps

配置庫和應用工程、其他組件建議在同一網段,避免網路波動等問題

配置庫和應用工程、其他組件之間需要網路暢通,互相埠可存取

finedb佔用空間1GB2GB佔用空間,請結合工程使用度進行調整

建議根據推薦配置,增大1~2倍,預留足夠空間

伺服器磁碟空間100GB200GB-
伺服器磁碟讀寫速度50MB/S100MB/S-

2.3 建立表空間

不同帆軟工程,不可共用同一個資料庫表空間作為配置庫,否則資料可能會出現錯亂。

因此建議在資料庫中建立一個表空間,用於儲存相關配置資料。

且該表空間內不建議存放其他任何資料,包括業務資料、日誌資料等。

標準建立表空間語句:CREATE DATABASE `finedb` DEFAULT CHARACTER SET utf8 COLLATE utf8_bin

配置
說明
表空間名稱

即語句中的finedb
只允許包含數字、字母、底線和「.」

字元集

推薦設定資料庫預設字元集為utf8mb3(別稱utf8)

  • 不支援 utf8mb4 編碼

排序規則推薦設定資料庫預設排序規則為utf8mb3_bin(別稱utf8_bin
  • 需要設定字元集排序規則為大小寫敏感

  • 不支援utf8_general_ci,因為它大小寫不敏感

2.4 準備配置庫資訊

請準備好表空間的相關資訊,用於接入專案作為配置庫。

設定項說明
資料庫名稱2.3節,在資料庫建立的表空間名稱

表空間名稱只允許包含數字、字母、底線和「.」

主機
資料庫所在伺服器的IP
資料庫佔用的伺服器埠
帳號

資料庫的用戶名

所準備的使用者需要具備 create、delete、alter、update、select、insert、index 權限,以滿足配置表架構調整、配置資訊調整等訴求

密碼資料庫的用戶密碼

配置庫對接成功後,請勿輕易修改所使用的資料庫帳號和密碼,否則會導致工程啟動失敗

3. 專案接入配置庫

支援在以下情況下接入MySQL配置庫,請根據情況自行選擇即可。

3.1 維運平台叢集管理接入

在維運平台的「叢集管理」中,可為專案接入自備的MySQL資料庫作為配置庫。

3.2.1 確定維運平台版本

本文以最新版維運平台的操作步驟提供指導,請確定當前維運平台版本至少在V2.31.0及以上

  • 對於不遷移配置資料的專案,V2.30.0及以下版本的維運平台不支援自動對專案進行重啟操作。

  • 對於多應用專案,V2.29.0及以下版本的維運平台,需要確定接入/遷移配置服務時僅存活一個應用節點。

詳情請參見:外網升級維運平台 、内网升级运维平台

3.2.2 配置外接配置庫

1)管理者登入維運平台,選中指定專案。點選「維護>叢集管理」,對「外接配置庫」進行配置。

2)輸入相關資訊

  • 資料庫類型:選擇「mysql」

  • 驅動:無需調整,選擇「com.mysql.jdbc.Driver」即可

  • 資料庫名稱、主機、埠、帳號、密碼:填寫第二章準備的配置庫資訊即可

  • 資料連結URL:一般無需手動修改,會由其他配置和預設參數共同組成

3)選擇是否「遷移資料至要啟動的資料庫」

情況新配置庫情況
希望使用當前專案原有配置

1)必須勾選「遷移資料至要啟動的資料庫」

2)專案與該配置庫對接成功後,會將工程原有配置資料,遷移到該表空間中

3)無論準備的新配置庫表空間中是否有資料,均會被清空,無法找回

希望使用其他專案配置

(例如將正式環境配置,copy一份給測試環境使用)

1)自行將準備的配置資料上傳到新配置庫表空間中

必須確定所準備的資料,對應的專案 JAR 包版本和當前專案的 JAR 包版本完全一致,否則無法使用

2)不勾選「遷移資料至要啟動的資料庫」

3)專案與該新配置庫對接成功後,會使用表空間中的資料,作為專案的配置

4)專案原有配置庫的對接資訊,會備份到工程config目錄下的db.properties.bak檔案中

5)未遷移配置資料到新配置庫時,工程中會存在部分歷史配置快取,必須在配置庫切換成功後重啟工程,來清理快取配置

4)點選「啟動資料庫」。

3.2.3 重啟專案(未勾選「遷移資料至要啟動的資料庫」)

如果在上一步未勾選「遷移資料至要啟動的資料庫」,配置庫切換完成後,工程中會存在部分歷史配置快取。

因此如未勾選「遷移資料至要啟動的資料庫」,必須在配置庫切換成功後重啟工程,來清理快取配置。

  • 維運平台部署的專案:切換配置庫成功後,維運平台會自動重啟專案。

  • 非維運平台部署的專案:請在切換配置庫成功後,手動重啟專案。詳情請參見: 關閉或重啟FineBI工程

3.3 管理系統接入配置庫

在帆軟應用的「管理系統>管理系統>標準」中,可接入自備的資料庫作為配置庫。

注:請確定啟動帆軟應用的使用者,有工程檔案的讀寫權限,否則無法正確接入。

3.3.1 確定單應用存活(多應用服務工程須完成,單應用服務工程無需)

對於多應用專案,需要確定接入/遷移配置服務時僅存活一個應用節點。

管理者登入維運平台,選中指定專案。點選「維護>組件管理」。檢查是否有多個「bi-web/fr/fdl」容器存活。

如果有,請點選容器的「停止」按鈕,確定將其他「bi-web/fr/fdl」容器關停至「exited」狀態,僅保留一個容器存活。

注:如為非維運平台部署的專案,請參考「 關閉或重啟FineBI工程」文檔,關閉叢集下的其他「bi/fr/fdl」應用,僅保留單個應用存活。

3.3.2 配置外接配置庫

1)管理者登入帆軟應用,點選「管理系統>管理系統>標準」。找到「外接資料庫」,點選配置。

2)輸入相關資訊

  • 資料庫類型:選擇「mysql」

  • 驅動:無需調整,選擇「com.mysql.jdbc.Driver」即可

  • 資料庫名稱、主機、埠、帳號、密碼:填寫第二章準備的配置庫資訊即可

  • 資料連結URL:先由其他配置和預設參數共同組成,在末尾加上相關參數&useSSL=false&serverTimezone=Asia/Shanghai&zeroDateTimeBehavior=CONVERT_TO_NULL

3)選擇是否「遷移資料至要啟動的資料庫」

情況新配置庫情況
希望使用當前專案原有配置

1)必須勾選「遷移資料至要啟動的資料庫」

2)專案與該配置庫對接成功後,會將工程原有配置資料,遷移到該表空間中

3)無論準備的新配置庫表空間中是否有資料,均會被清空,無法找回

希望使用其他專案配置

(例如將正式環境配置,copy一份給測試環境使用)

1)自行將準備的配置資料上傳到新配置庫表空間中

必須確定所準備的資料,對應的專案 JAR 包版本和當前專案的 JAR 包版本完全一致,否則無法使用

2)不勾選「遷移資料至要啟動的資料庫」

3)專案與該新配置庫對接成功後,會使用表空間中的資料,作為專案的配置

4)專案原有配置庫的對接資訊,會備份到工程config目錄下的db.properties.bak檔案中

5)未遷移配置資料到新配置庫時,工程中會存在部分歷史配置快取,必須在配置庫切換成功後重啟工程,來清理快取配置

4)點選「啟動資料庫」,提示「遷移成功」,即代表可正常對接。

3.3.3 確定多應用配置同步(多應用服務工程須完成,單應用服務工程無需)

1)copydb.properties檔案

前往唯一存活的「bi-web/fr/fdl」容器所在伺服器,複製該組件外掛目錄/config資料夾中的db.properties檔案。

逐一貼上到其他「bi-web/fr/fdl」容器所在伺服器的組件外掛目錄/config資料夾中。

注:如為非維運平台部署的專案,請將唯一存活的「bi/fr/fdl」應用目錄/webroot/WEB-INF/embed資料夾中的db.properties檔案,逐一copy到其他「bi/fr/fdl」應用目錄/webroot/WEB-INF/embed資料夾中

2)停止所有應用

管理者登入維運平台,選中指定專案,點選「維護>組件管理」

請對「bi-web/fr/fdl」組件進行一鍵「停止」,確定所有「bi-web/fr/fdl」容器關停至「exited」狀態。

注:如為非維運平台部署的專案,請參考「 關閉或重啟FineBI工程」文檔,關閉剩餘唯一存活的「bi/fr/fdl」應用。

3)啟動所有應用

管理者登入維運平台,選中指定專案,點選「維護>組件管理」。

請對「bi-web/fr/fdl」組件進行一鍵「啟動」,確定所有「bi-web/fr/fdl」容器啟動至「running」狀態。

注:如為非維運平台部署的專案,請參考「 關閉或重啟FineBI工程」文檔,逐一重啟叢集下的所有「bi/fr/fdl」應用。

附件列表


主題: 數據決策系統
已經是第一篇
已經是最後一篇
  • 有幫助
  • 沒幫助
  • 只是瀏覽
  • 圖片不清晰
  • 用語看不懂
  • 功能說明看不懂
  • 操作說明太簡單
  • 內容有錯誤
中文(繁體)

滑鼠選中內容,快速回饋問題

滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

不再提示

10s後關閉

獲取幫助
線上支援
獲取專業技術支援,快速幫助您解決問題
工作日9:00-12:00,13:30-17:30在线
頁面反饋
針對當前網頁的建議、問題反饋
售前咨詢
業務咨詢
電話:0933-790886或 0989-092892
郵箱:taiwan@fanruan.com
頁面反饋
*問題分類
不能為空
問題描述
0/1000
不能為空

反馈已提交

网络繁忙