您正在浏覽的是 FineBI 7.X 幫助文檔,點選跳轉至 FineBI 6.X 幫助文檔。

資源遷移

1. 概述

1.1 版本

FineBI 伺服器版本功能變動
7.0-

1.2 應用場景

使用 FineBI 系統時,一般先在測試環境系統上進行開發部署,確認無誤後再遷移到正式系統中。

FineBI支援將目錄、資料集、資料連結、儀表板等資源從測試系統增量遷移到正式系統。

1.3 功能簡介

FineBI 以插件形式提供資源遷移功能,支將目錄、資料集、資料連結、儀表板等資源從測試系統到正式系統的增量遷移。

插件安裝成功後,管理者登入FineBI系統,點選「管理系統>智慧維運>資源遷移」,分為「資源匯出」、「資源匯入」兩部分,如下圖所示:

  • 資源匯出:將需要遷移到其他系統的資源從伺服器中匯出,以供後續遷移。

  • 資源匯入:將需要遷移的資源在新系統中匯入,即遷移至新系統。

1.4 注意事項

1)正式工程lic需包含「維運平台」功能點才可使用「資源遷移」功能 。

2)FineBI7.0 工程,僅支援匯入 FineBI7.0 工程的資源,不支援匯入 FineReport 工程的資源 。

3)請確定在資源遷移程式中,沒有其他人使用超級管理者帳號,否則部分執行請求可能被取消 。

4)不建議在個人 PC 端工程開發範本後,再以資源遷移的形式同步到公司工程 。

      因為個人 PC 端沒有管理者維護,經常會因為 JAR 包不同步或資源以及配置不同步的問題導致資源遷移失敗,維運成本會很高 。

5)單次資源匯入內容不可超出2GB,否則在匯入資源時會報錯:out of memoryerror。請少量多次分配匯出和匯入資源 。

6)資源遷移功能支援超級管理者和次級管理者。超級管理者需為對應次級管理者開通「智慧維運」和「智慧維運>資源遷移」的使用權限 。

  • 次管在進行「資源匯出」時不支援「同時匯出權限配置」 。

  • 若在資源遷移匯入後發現部分目錄名稱顯示為空白,此問題是由於匯出資源時勾選了「同時匯出超連結跳轉範本」,導致部分目錄結構資訊丟失,進而在匯入後顯示為空名稱 。

2. 資源遷移前檢查

2.1 安裝資源遷移入口插件

FineBI 的資源遷移功能,依賴「資源遷移入口」插件。

請分別為資源遷出和遷入的工程,安裝並啟動「資源遷移入口」插件。

插件安裝成功後,在「管理系統>智慧維運」下方可出現「資源遷移」入口。


2.2 確認註冊維運平台功能點

資源遷移功能,依賴「維運平台」功能點。

管理者分別登入資源遷出和遷入的工程,點選「管理系統>註冊管理>功能列表」。

請確定工程已註冊功能點中包含「維運平台」功能點。如不包含該功能點,請聯絡帆軟銷售增購。

注:對於未註冊工程,預設擁有該功能點,可跨越。

2.3 確認FineBI工程版本

資源遷出和遷入的工程,必須保證主工程類型完全一致,即都必須是 FineBI 工程,不支援 FineReport 工程資源遷入 FineBI 工程。

資源遷出和遷入的工程,必須保證工程小版本號和 JAR 包時間完全一致,否則資源無法成功匯入。

1)管理者分別登入資源遷出和遷入的工程,查看「管理系統>註冊管理>版本資訊」頁面。

2)請確定兩個工程均包含 BI 模組,請確定兩個工程的小版本號和 JAR 包時間完全一致。

若版本不一致,可透過升級 FineBI 工程來確定版本一致。詳情請參見:FineBI 版本升級簡介


注:在資源匯入時,若上傳資源對應的工程和當前工程版本不一致,則無法上傳。

        提示「無法匯入,即將匯入的資源需要的工程版本:XXX。當前工程版本:XXX。請確定工程版本一致!」


2.4 確認外接配置庫字元集排序規則

FineBI7.0 及以上版本預設對接了外接配置庫。資源遷出和遷入的工程,外接配置庫的字元集排序規則應當保持一致,均為「大小寫敏感」。否則在資源遷移後,構建表索引時,不同表 ID 可能被收信確認為同一張表,進而被錯誤改寫。

配置庫的字元集排序規則的查看和修改步驟,請自行查閱對應資料庫說明文檔。(例如 MySQL 類型,應當設定為 utf8mb3_bin,別稱 utf8_bin)


3. 資源匯出

管理者登入 FineBI 系統後,進入「管理系統>智慧維運>資源遷移」,即可進行「資源匯出」。


3.1 選擇匯出資源

選擇需要匯出的資源類型,選擇每種類型下需要匯出的具體內容,支援多選。支援匯出的各種資源如下表所示:

注:單次資源匯入內容不可超出2GB。因此請少量多次匯出資源。

資源類型
匯出內容說明
目錄

支援匯出「目錄管理」中所有平台目錄

無法匯出首頁目錄

我的分析

支援匯出「我的分析」中的所有主題及主題內表、組件、儀表板、分析文檔

支援匯出有管理權限的「使用者的分析」中的所有主題及主題內表、組件、儀表板、分析文檔

資料目錄

支援匯出「資料目錄」下的表、指標、維度、業務模型

同時匯出模型中心中對應指標、維度、業務模型

模型管理

支援匯出「指標中心>模型管理」目錄中的模型檢視表、資源

指標管理

支援匯出「指標中心>指標管理」目錄中的指標

維度管理

支援匯出「指標中心>維度管理」目錄中的維度

指標集支援匯出「指標中心>維度管理」目錄中的維度
資料連結

支援匯出 FineBI 系統中的所有資料連結,包括基礎配置、進階配置

若資料連結需依賴第三方插件,目前只支援遷移 JSON 資料集,其他插件類型不適配,請勿匯出

伺服器資料集支援匯出 FineBI 系統中的所有伺服器資料集:SQL資料集、檔案資料集、樹資料集、JSON資料集、內建資料集、程式資料集、聯動資料集、儲存程式
  • 權限匯出插件:權限匯出插件生成的伺服器資料集,不支援遷移,請勿匯出

  • 第三方插件資料集:若伺服器資料集需依賴第三方插件,目前只支援 JSON 資料集,其他插件類型不適配,請勿匯出

3.2 選擇匯出全部依賴資源

比如A資料集基於B資料集建立,將A資料集從測試系統遷移到正式系統中,如需正常使用A資料集,需要將依賴的B資料集也匯入。

因此匯出資源時,可選擇是否「匯出全部依賴資源」。該按鈕會匯出依賴的資源。該按鈕僅對當前資源類型生效,需要逐個設定。

規則
範例
匯出資源對應主題及主題內表、組件、儀表板、分析文檔

場景:目錄A中掛出了主題B的儀表板C

說明:匯出目錄A時,匯出依賴資源:主題B及主題B下的所有表、組件、儀表板、分析文檔

匯出主題中的資料依賴的「資料目錄」中的基礎表、分析表、指標、維度

場景:基於基礎表A,建立了主題B中的表

說明:匯出主題B時,匯出依賴資源:基礎表A

匯出以上資料資源在血緣路徑上經過的所有相關表、指標、維度、業務模型、主題

場景:基於A表建立了B表,基於B表建立了C業務模型,基於C業務模型建立了D指標

說明:匯出D指標時,匯出依賴資源:A表、B表、C業務模型

匯出以上資料資源在聯動路徑上經過的所有相關表、指標、維度、業務模型、主題

場景:AB表聯動,BC表聯動

說明:匯出C表時,匯出依賴資源:A表、B表

如果組件間存在聯動、元件對組件存在過濾,匯出最短路徑中的相關資料集

場景:

基於A資料集建立了B資料集,基於B資料集建立了C資料集,基於C資料集建立了D組件

基於X資料集建立了Y資料集,基於Y資料集建立了Z資料集,基於Z資料集建立了W過濾組件

D組件和W過濾組件組成了M儀表板,儀表板掛出到了N目錄

說明:匯出N目錄時,匯出依賴資源:D組件、M儀表板、W過濾組件、A、B、C資料集、X、Y、Z資料集及其所在的主題

資源類型為「目錄」時,如果目錄儀表板中存在 FineBI 儀表板超連結跳轉,同時匯出跳轉的儀表板所在主題場景:A儀表板中的超連結可跳轉到B儀表板,A儀表板掛出到了C目錄

說明:匯出C目錄時,匯出依賴資源:AB儀表板及其所在的主題


3.3 注意事項

注意事項
說明
不匯出依賴資源的風險

如匯入的工程中沒有依賴的資源,儘管可以成功匯入,但無法使用或預覽

例如主題A的資料來源為資料目錄中的基礎表B,匯入的工程資料目錄中不存在基礎表B,則匯入後主題A的資料標紅無法查看

匯出的資源所有者

資源匯入時會優先匯入到資源原所有者名下。如匯入的工程中無資源的所有者,在匯入時可以指定所有者

例如A工程中主題所有者為eoco,B工程中存在使用者eoco,則匯入B工程時eoco即為該主題所有者

例如A工程中主題所有者為eoco,B工程中不存在使用者eoco,則匯入B工程時可指定其他使用者作為主題所有者

匯出的資源轉義名

如匯入時同路徑下的資源的轉義名重名,則自動對其轉義名重新命名為「原轉義名1」,以確定資源不會被改寫

注意,此處說的是轉義名而非資源名稱。同名資源在匯入時可自行選擇匯入方式

匯出的資源發佈狀態

如匯出時,資源處於申請發佈狀態,匯入後需要重新申請,不保留「申請」/「取消申請」的狀態

匯出的資源分享和協作狀態

匯出時不會同步匯出資源的「分享狀態」和「協作狀態」

匯出的資源聯動關係匯出表時,同時匯出表的聯動關係。但僅當聯動雙方同時存在於匯入的工程,才能同時匯入聯動關係。

例如AB兩表關聯,匯出A表且不匯出依賴資源,匯入時只匯入A表且工程中不存在B表,則不匯入AB的聯動關係

例如AB兩表關聯,匯出A表且不匯出依賴資源,匯入時只匯入A表但工程中存在B表,則匯入AB的聯動關係

匯出的資料連結

資料連結的密碼加密匯出

資料連結中如使用了 Kerberos 認證,.keytab 金鑰表檔案及路徑不支援匯出,遷移後需要手動輸入

匯出的伺服器資料集
  • 檔案資料集

若檔案資料集的資料集來源為URL,則只匯出配置,檔案不匯出

若檔案資料集的資料集來源為檔案,檔案路徑包含參數,則檔案不匯出

  • 樹資料集

若匯出樹資料集時,未匯出依賴的原資料集,則匯入時可正常匯入但無法使用

  • 聯動資料集

若匯出聯動資料集時,未匯出依賴的原資料集,則匯入時可正常匯入但無法使用

不支援匯入空目錄對於目錄、我的分析、資料目錄、指標中心,不支援匯入空檔案夾,必須包含有效資源

例如我的分析中,建立了三個空資料夾,這些資料夾中都沒有任何主題資源,那麼匯入新工程時,不匯入這三個空資料夾,因為不存在業務意義

3.4 選擇同時匯出的資源

比如A資料集設定了定時更新,將A資料集從測試系統遷移到正式系統中,使用者可能需要將設定的定時更新也匯入。

因此在匯出時,支援選擇同時匯出一些資源。同時匯出配置,對匯出的全部資源類型生效。

可同時匯出的資源如下:

同時匯出的資源
說明
同時匯出Finereport連結跳轉範本

預設勾選該選項,且只對「目錄」類型的遷移資源生效

  • 不勾選「同時匯出Finereport連結跳轉範本」:

僅匯出掛載在目錄中的儀表板,儀表板中跳轉的Finereport子範本不會同時匯出

  • 勾選「同時匯出Finereport連結跳轉範本」:

匯出掛載在目錄中的儀表板時,儀表板中跳轉的Finereport子範本會同時匯出,子範本中若存在下級子範本,也同時匯出,以此類推

原始Excel附件

若匯出的資源、或匯出依賴的資源,存在「Excel資料集」。

勾選「原始Excel附件」,則會將原始Excel附件一起匯出,這樣在後續的匯入中不需要再重新上傳Excel檔案。

注:若匯出的資料表與正式系統相同位置的表名稱一樣,將改寫掉正式系統中的資料表,因此此處需確認好再進行匯出匯入操作。

公共連結的設定項

若匯出的資源存在「儀表板」,可勾選「公共連結的設定項」,將儀表板的公共連結設定一起匯出。

  • 勾選「公共連結的設定項」:

無論是改寫匯入還是新增匯入,按照匯入的儀表板的公共連結設定為準

  • 不勾選「公共連結的設定項」:

改寫匯入時,原來儀表板設定的公共連結不被改寫

新增匯入時,匯入的儀表板預設不開啟公共連結

定時更新任務

若匯出的資源、或匯出依賴的資料集,存在「定時更新任務」。

勾選「定時更新任務」,則會將資料集的定時更新任務一起匯出。定時更新任務匯出該資源項自身的更新任務,不匯出父節點上的更新任務。

  • 勾選「定時更新任務」:

無論是改寫匯入還是新增匯入,按照匯入的資料集的定時更新任務為準。

  • 不勾選「定時更新任務」:

改寫匯入時,原來資料集設定的更新任務不被改寫

新增匯入時,匯入的資料集不帶有更新任務

同時匯出權限配置

規則:

勾選「同時匯出權限配置」,可匯出資源的權限配置。

權限配置包括:使用權限(查看、編輯、授權等)、行列權限。

僅匯出該資源項自身設定的權限,不匯出由父節點繼承而來的權限。

資料夾、主題、儀表板、資料集等資源匯出權限時,均不匯出繼承而來的權限。

舉例:

資料夾X中有一個資料集A,資料夾和資料集上面都配置了使用權限。

  • 僅匯出資料集A,勾選「同時匯出權限配置」。最終只匯出資料集A身上的權限,不匯出資料夾X上的權限。

  • 同時匯出資料夾X和資料集A,勾選「同時匯出權限配置」。最終既匯出資料集A身上的權限,也匯出資料夾X上的權限。

注:非超管使用者支援進行資源遷移操作,但無法勾選「同時匯出權限配置」。

3.5 匯出的檔案

匯出後會生成 resources.zip 檔案,如下圖所示:


4. 資源匯入前準備

4.1 匯入前須知

FineBI7.0工程,僅支援匯入FineBI7.0工程的資源,不支援匯入FineReport工程的資源。

4.2 確認建立了模型

如果匯入的資源中包含指標中心相關內容,必須在目標工程中進入一次模型,確定指標中心存在一個模型。


4.3 確認插件和驅動

1)若資料連結需依賴第三方插件,目前只支援遷移 JSON 資料集和 Mysql8 資料連結,其他插件類型不適配,會匯入失敗。

2)權限匯出插件生成的伺服器資料集,不支援遷移,會匯入失敗。

3)資料連結遷移只遷移配置。驅動jar包、kerberos認證檔案、JNDI 配置檔案等都不會遷移,需要手動配置/放置。

  • 請在進行資料連結遷移前,確認正式工程下是否提前安裝依賴的相關資料連結插件,否則將導致匯入失敗。

  • 請在進行資料連結遷移前,確認正式工程下是否提前安裝依賴的相關資料連結驅動,否則將導致匯入的資料連結不可使用。

4.4 確認資料連結

  • 若匯出的目錄、我的分析、公共資料依賴資料連結,請確定同時選中相關資料連結資源進行匯出匯入。否則請在資源遷移匯入前,保證正式系統已建立好了資料連結,且該資料連結名需與測試系統一致,否則資源無法遷移成功。

  • 若遷移的是伺服器資料集建立的儀表板,則在遷移前需要保證正式系統上建立好相同名稱的伺服器資料集。

  • 伺服器資料集若依賴相關資料連結,請確認將相關資料連結匯入正式工程,否則匯入的伺服器資料集無法使用。

4.5 確認使用者

1)使用者

在資源匯入時,系統中必須有資源包的資源所有者。

比如測試系統中資料表的建立者是Anna,那麼在正式系統中也必須有一個使用者叫Anna。否則匯入時需要修改資源的所有者。

2)使用者類型

在資源遷移程式中,需要BI資料表的建立者的使用者類型保持一致。

比如測試系統中資料表建立者為「分析使用者」,那麼在正式系統中也需要將其新增到「分析使用者」中。

4.6 遷移自訂地圖

若範本中呼叫了自訂地圖,需要將地圖 json 檔案copy到正式工程下。

在%FineBI%/webroot/WEB-INF/assets/map/image路徑下,將需要遷移的 json 檔案copy到正式工程對應路徑下。

4.7 系統備份

資源匯入前建議對測試系統和正式系統均進行 系統備份。

5. 資源匯入

5.1 上傳檔案

管理者登入 FineBI 系統,選擇「管理系統>智慧維運>資源遷移>資源匯入」,點選「上傳檔案」,如下圖所示:

注1:資源匯入前建議進行 備份還原,其中備份遷移到的 MySQL 資料庫需要選擇 utf8_bin 的排序規則。

注2:單次只允許上傳單個壓縮檔案。

注3:單次資源匯入內容不可超出2GB,否則在匯入資源時會報錯:out of memoryerror。請少量多次分配匯出和匯入資源。


上傳檔案時,系統會自動獲取當前可用的閒置記憶體大小,當上傳檔案大小 <(當前可用的閒置記憶體大小-256MB)時,允許上傳檔案,當上傳的檔案大小 >(當前可用的閒置記憶體大小-256MB)時,觸發限制,報錯「當前剩餘記憶體 xxxMB,檔案大小 xxxMB,為防止記憶體上限溢位,不允許上傳」,如下圖所示:

上傳檔案成功後,系統會獲取匯入檔案所包含的資源,包含資源類型、資源名稱、資源所有者、資源路徑、匯入方式和資源資訊對比。

設定
說明
資源類型

類型包括:目錄、伺服器資料集、資料連結、儀表板、組件、資料集

資源名稱

資源名稱為各種資源的名稱

資源所有者

資源類型為「目錄、伺服器資料集、資料連結」時,資源所有者為空

資源類型為「儀表板、組件、資料集」時,資源所有者即資源的建立者

資源的建立者

路徑

資源類型為「目錄、伺服器資料集、資料連結」時,路徑為空

資源類型為「儀表板、組件、資料集」時,路徑為資源在公共資料/使用者的分析下的存放路徑

匯入方式

在匯入時,系統會對資源進行檢查,檢查是否與系統現有資源有衝突

根據衝突類型分配不同的匯入方式,分為:新增匯入、改寫匯入和不允許匯入

  • 新增匯入:與系統中已有資源的資源ID、資源類型不完全相同,可直接匯入。

    注:若ID相同、類型相同的資源處在回收站中,也算作新增匯入。

  • 改寫匯入:與系統中已有資源的資源ID、資源類型、資源所有者完全相同,匯入後會對系統中已有資源進行改寫。

  • 不允許匯入:與系統中已有資源的資源ID、資源類型完全相同,但系統中不存在該資源所有者,暫時無法匯入系統,需要修改資源所有者才可以匯入。

資源資訊對比

當匯入方式為「改寫匯入」時,點選每一項後面的黃色按鈕,可查看匯入的資源資訊與原有的資源資訊對比,查看是否一致。

如下圖所示:

注1:在匯入資源時,若該路徑下存在轉義名相同的資源,會自動對匯入的資源的轉義名進行修改,變為「轉義名1」。

注2:不支援空資料夾匯入。

注3:資源不允許匯入時,資源所有者顯示為「未知使用者」,可點選修改資源所有者為系統中的其他使用者,點選「確定」生效。

  • 如果資源是公共資料中的資料集,修改資源所有者僅會改變該資源的所有者使用者ID。

  • 如果資源是我的分析中的主題,修改資源所有者,會將該主題的路徑調整為對應使用者的分析下的路徑,並重新整理使用者ID。

5.2 匯入檔案

勾選需要上傳的資源,點選「匯入」,點選「確定」。如下圖所示:

若匯入失敗,顯示失敗的原因(如:匯出工程和匯入工程中存在同名同路徑但是類型不同);若匯入成功,則資源即時生效。如下圖所示:

注:由於對應的環境配置不同 IP 埠號會改變,資源遷移後的儀表板公共連結需要重新進行連結分享。

5.3 資料更新

若遷入的基礎表資源為「抽取資料」,匯入到新的系統中需要手動進行 資料更新 ,或者直接進行 全局更新 。

更新後才能看到匯入的資料表均正常顯示,如下圖所示:

注:若匯入資料表為 Excel 資料集或者以 Excel 資料集為基礎表製作的資料集,則必須進行資料夾更新或者全局更新。

       若匯入的資料表為資料庫表或者 SQL 資料集,則可以對匯入的表進行單表更新。

附件列表


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

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

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

不再提示

10s後關閉

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

反馈已提交

网络繁忙