FineBI對接Oracle實現配置服務

1. 概述

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

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

本文主要講解帆軟專案對接Oracle資料庫,儲存工程配置資訊:

  • 使用者可自行準備一個Oracle資料庫的表空間,並進行參數調優

  • 在部署新專案/專案部署好後,可將專案與該配置庫對接

2. 準備配置庫

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

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

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

2.1 資料庫版本

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

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

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

資料庫類型
資料庫版本說明
Oracle

Oracle單機:

10g(10.2)、10.2.0.1.0

需要手動上傳驅動

因此僅支援在專案部署好後對接

Oracle單機:

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 伺服器配置

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

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

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

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

CPU4核8核-
網速
50Mbps100Mbps

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

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

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

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

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

2.3 建立表空間

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

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

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

1)建立表空間和對應使用者

步驟
語句
語句範例

建立一個名叫「FANRUAN」的使用者,該使用者密碼為「123456」,使用者的預設表空間為「FINEDB」

CREATE USER "FANRUAN" IDENTIFIED BY "123456" ACCOUNT UNLOCK DEFAULT TABLESPACE "FINEDB"

注意事項

1)帳號

  • 建立使用者是推薦操作,而非必須。也可選擇直接建立表空間,並將其分配給已有的使用者

  • 如資料庫版本為Oracle12c,帳號必須以C##為前綴,否則無法正常使用

  • 由於資料庫模式一般選擇使用者同名模式,因此帳號稱建議僅包含數字、字母,不建議包含特殊字元

2)使用者密碼

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

3)表空間名稱

  • 只允許包含數字、字母、底線和「.」

2)授予權限

步驟
語句
語句範例為使用者「FANRUAN」分配表空間「FINEDB」的權限

GRANT "CONNECT","RESOURCE" TO "FANRUAN" ALTER USER "FANRUAN" QUOTA UNLIMITED ON "FINEDB"

注意事項使用者至少需要具備 create、delete、alter、update、select、insert、index 權限

2.4 準備配置庫資訊

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

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

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

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

資料庫的用戶名

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

2)如資料庫版本為Oracle12c,帳號必須以C##為前綴,否則無法正常使用

3)由於資料庫模式一般選擇使用者同名模式,因此帳號稱建議僅包含數字、字母,不建議包含特殊字元

密碼資料庫的用密碼

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

模式

即為所準備的資料的帳號稱

3. 專案接入配置庫

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

3.1 部署新專案時接入

在「部署新專案-專案設定」時,可接入自備的Oracle資料庫作為工程配置庫。

  • 此情況下,請確定資料庫表空間內容為空,不存在任何資料,否則無法成功對接。

  • 此情況下,只支援對接11g、12c版本的Oracle資料庫,不支援對接10g版本的Oracle資料庫

1)外接配置庫選擇「對接已有外接配置庫」。

2)在「外接配置庫」資訊填寫處:

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

  • 驅動:無需調整,選擇「oracle.jdbc.driver.OracleDriver」即可

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

3)選擇「模式」:

  • 正確填寫完上面的所有配置後,點選模式下拉框中的「點選連結資料庫」,系統將自動連結該資料庫並讀取模式

  • 優先選擇與資料庫使用者同名的模式

4)點選「測試連結」,提示「測試連結成功」,即代表可正常對接。

3.2 維運平台叢集管理接入

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

3.2.1 上傳驅動(可選)

  • 如對接11g、12c版本的Oracle資料庫,請直接跨越本節,驅動已直接內建在工程中。

  • 如對接10g版本的Oracle資料庫,請務必執行本節,否則無法成功對接。

1)前往Oracle官網,下載ojdbc14.jar:Oracle官網

2)參考文檔,將驅動上傳到專案中:驅動管理

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

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

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

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

3.2.3 配置外接配置庫

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

2)選擇資料庫類型:oracle

3)選擇驅動:

資料庫版本
說明
11g、12c無需調整,選擇「oracle.jdbc.driver.OracleDriver」即可
10g選擇驅動管理上傳ojdbc14.jar時設定的驅動名稱

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

5)選擇「模式」:

  • 正確填寫完上面的所有配置後,點選模式下拉框中的「點選連結資料庫」,系統將自動連結該資料庫並讀取模式

  • 優先選擇與資料庫使用者同名的模式

6)資料連結URL:支援手動編輯調整,支援多種寫法,按需選擇

類型
寫法
Oracle單機

jdbc:oracle:thin:@<host>:<port>:<SID>  

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)))

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

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

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

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

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

希望使用其他專案配置

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

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

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

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

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

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

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

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

1)copydb.properties檔案

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

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

2)停止所有應用

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

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

3)啟動所有應用

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

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

3.3 管理系統接入配置庫

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

3.3.1 上傳驅動(可選)

  • 如對接11g、12c版本的Oracle資料庫,請直接跨越本節,驅動已直接內建在工程中。

  • 如對接10g版本的Oracle資料庫,請務必執行本節,否則無法成功對接。

1)前往Oracle官網,下載ojdbc14.jar:Oracle官網

2)參考文檔,將驅動上傳到專案中:驅動管理

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

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

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

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

3.3.3 對接配置庫

1)管理者登入帆軟應用,點選「管理系統>管理系統>標準」。

2)找到「外接資料庫」,點選配置。

3)選擇資料庫類型:oracle

4)選擇驅動:

資料庫版本
說明
11g、12c無需調整,選擇「oracle.jdbc.driver.OracleDriver」即可
10g選擇驅動管理上傳ojdbc14.jar時設定的驅動名稱

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

6)選擇「模式」:

  • 正確填寫完上面的所有配置後,點選模式下拉框中的「點選連結資料庫」,系統將自動連結該資料庫並讀取模式

  • 優先選擇與資料庫使用者同名的模式

7)資料連結URL:支援手動編輯調整,支援多種寫法,按需選擇

類型
寫法
Oracle單機

jdbc:oracle:thin:@<host>:<port>:<SID>  

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)))

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

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

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

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

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

希望使用其他專案配置

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

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

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

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

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

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

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

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

1)copydb.properties檔案

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

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

2)停止所有應用

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

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

3)啟動所有應用

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

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

附件列表


主题: 部署整合
已经是第一篇
已经是最后一篇
  • 有帮助
  • 没帮助
  • 只是浏览
  • 圖片不清晰
  • 用語看不懂
  • 功能說明看不懂
  • 操作說明太簡單
  • 內容有錯誤
中文(繁體)

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

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

不再提示

10s後關閉

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

反馈已提交

网络繁忙