使用 FineBI 系統時,一般先在測試環境系統上進行開發部署,確認無誤後再遷移到正式系統中。
FineBI支援將目錄、資料集、資料連結、儀表板等資源從測試系統增量遷移到正式系統。
FineBI 以插件形式提供資源遷移功能,支將目錄、資料集、資料連結、儀表板等資源從測試系統到正式系統的增量遷移。
插件安裝成功後,管理者登入FineBI系統,點選「管理系統>智慧維運>資源遷移」,分為「資源匯出」、「資源匯入」兩部分,如下圖所示:
資源匯出:將需要遷移到其他系統的資源從伺服器中匯出,以供後續遷移。
資源匯入:將需要遷移的資源在新系統中匯入,即遷移至新系統。
1)正式工程lic需包含「維運平台」功能點才可使用「資源遷移」功能 。
2)FineBI7.0 工程,僅支援匯入 FineBI7.0 工程的資源,不支援匯入 FineReport 工程的資源 。
3)請確定在資源遷移程式中,沒有其他人使用超級管理者帳號,否則部分執行請求可能被取消 。
4)不建議在個人 PC 端工程開發範本後,再以資源遷移的形式同步到公司工程 。
因為個人 PC 端沒有管理者維護,經常會因為 JAR 包不同步或資源以及配置不同步的問題導致資源遷移失敗,維運成本會很高 。
5)單次資源匯入內容不可超出2GB,否則在匯入資源時會報錯:out of memoryerror。請少量多次分配匯出和匯入資源 。
6)資源遷移功能支援超級管理者和次級管理者。超級管理者需為對應次級管理者開通「智慧維運」和「智慧維運>資源遷移」的使用權限 。
次管在進行「資源匯出」時不支援「同時匯出權限配置」 。
若在資源遷移匯入後發現部分目錄名稱顯示為空白,此問題是由於匯出資源時勾選了「同時匯出超連結跳轉範本」,導致部分目錄結構資訊丟失,進而在匯入後顯示為空名稱 。
FineBI 的資源遷移功能,依賴「資源遷移入口」插件。
請分別為資源遷出和遷入的工程,安裝並啟動「資源遷移入口」插件。
插件獲取:請聯絡帆軟技術支援獲取。技術支援聯絡方式:帆軟官方服務渠道使用説明
插件安裝方法參照: 插件管理
插件安裝成功後,在「管理系統>智慧維運」下方可出現「資源遷移」入口。
資源遷移功能,依賴「維運平台」功能點。
管理者分別登入資源遷出和遷入的工程,點選「管理系統>註冊管理>功能列表」。
請確定工程已註冊功能點中包含「維運平台」功能點。如不包含該功能點,請聯絡帆軟銷售增購。
注:對於未註冊工程,預設擁有該功能點,可跨越。
資源遷出和遷入的工程,必須保證主工程類型完全一致,即都必須是 FineBI 工程,不支援 FineReport 工程資源遷入 FineBI 工程。
資源遷出和遷入的工程,必須保證工程小版本號和 JAR 包時間完全一致,否則資源無法成功匯入。
1)管理者分別登入資源遷出和遷入的工程,查看「管理系統>註冊管理>版本資訊」頁面。
2)請確定兩個工程均包含 BI 模組,請確定兩個工程的小版本號和 JAR 包時間完全一致。
若版本不一致,可透過升級 FineBI 工程來確定版本一致。詳情請參見:FineBI 版本升級簡介
注:在資源匯入時,若上傳資源對應的工程和當前工程版本不一致,則無法上傳。
提示「無法匯入,即將匯入的資源需要的工程版本:XXX。當前工程版本:XXX。請確定工程版本一致!」
FineBI7.0 及以上版本預設對接了外接配置庫。資源遷出和遷入的工程,外接配置庫的字元集排序規則應當保持一致,均為「大小寫敏感」。否則在資源遷移後,構建表索引時,不同表 ID 可能被收信確認為同一張表,進而被錯誤改寫。
配置庫的字元集排序規則的查看和修改步驟,請自行查閱對應資料庫說明文檔。(例如 MySQL 類型,應當設定為 utf8mb3_bin,別稱 utf8_bin)
管理者登入 FineBI 系統後,進入「管理系統>智慧維運>資源遷移」,即可進行「資源匯出」。
選擇需要匯出的資源類型,選擇每種類型下需要匯出的具體內容,支援多選。支援匯出的各種資源如下表所示:
注:單次資源匯入內容不可超出2GB。因此請少量多次匯出資源。
支援匯出「目錄管理」中所有平台目錄
無法匯出首頁目錄
支援匯出「我的分析」中的所有主題及主題內表、組件、儀表板、分析文檔
支援匯出有管理權限的「使用者的分析」中的所有主題及主題內表、組件、儀表板、分析文檔
支援匯出「資料目錄」下的表、指標、維度、業務模型
同時匯出模型中心中對應指標、維度、業務模型
支援匯出「指標中心>模型管理」目錄中的模型檢視表、資源
支援匯出「指標中心>指標管理」目錄中的指標
支援匯出「指標中心>維度管理」目錄中的維度
支援匯出 FineBI 系統中的所有資料連結,包括基礎配置、進階配置
若資料連結需依賴第三方插件,目前只支援遷移 JSON 資料集,其他插件類型不適配,請勿匯出
權限匯出插件:權限匯出插件生成的伺服器資料集,不支援遷移,請勿匯出
第三方插件資料集:若伺服器資料集需依賴第三方插件,目前只支援 JSON 資料集,其他插件類型不適配,請勿匯出
比如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資料集及其所在的主題
說明:匯出C目錄時,匯出依賴資源:AB儀表板及其所在的主題
如匯入的工程中沒有依賴的資源,儘管可以成功匯入,但無法使用或預覽
例如主題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,則只匯出配置,檔案不匯出
若檔案資料集的資料集來源為檔案,檔案路徑包含參數,則檔案不匯出
樹資料集
若匯出樹資料集時,未匯出依賴的原資料集,則匯入時可正常匯入但無法使用
聯動資料集
若匯出聯動資料集時,未匯出依賴的原資料集,則匯入時可正常匯入但無法使用
例如我的分析中,建立了三個空資料夾,這些資料夾中都沒有任何主題資源,那麼匯入新工程時,不匯入這三個空資料夾,因為不存在業務意義
比如A資料集設定了定時更新,將A資料集從測試系統遷移到正式系統中,使用者可能需要將設定的定時更新也匯入。
因此在匯出時,支援選擇同時匯出一些資源。同時匯出配置,對匯出的全部資源類型生效。
可同時匯出的資源如下:
預設勾選該選項,且只對「目錄」類型的遷移資源生效
不勾選「同時匯出Finereport連結跳轉範本」:
僅匯出掛載在目錄中的儀表板,儀表板中跳轉的Finereport子範本不會同時匯出
勾選「同時匯出Finereport連結跳轉範本」:
匯出掛載在目錄中的儀表板時,儀表板中跳轉的Finereport子範本會同時匯出,子範本中若存在下級子範本,也同時匯出,以此類推
若匯出的資源、或匯出依賴的資源,存在「Excel資料集」。
勾選「原始Excel附件」,則會將原始Excel附件一起匯出,這樣在後續的匯入中不需要再重新上傳Excel檔案。
注:若匯出的資料表與正式系統相同位置的表名稱一樣,將改寫掉正式系統中的資料表,因此此處需確認好再進行匯出匯入操作。
若匯出的資源存在「儀表板」,可勾選「公共連結的設定項」,將儀表板的公共連結設定一起匯出。
勾選「公共連結的設定項」:
無論是改寫匯入還是新增匯入,按照匯入的儀表板的公共連結設定為準
不勾選「公共連結的設定項」:
改寫匯入時,原來儀表板設定的公共連結不被改寫
新增匯入時,匯入的儀表板預設不開啟公共連結
若匯出的資源、或匯出依賴的資料集,存在「定時更新任務」。
勾選「定時更新任務」,則會將資料集的定時更新任務一起匯出。定時更新任務匯出該資源項自身的更新任務,不匯出父節點上的更新任務。
勾選「定時更新任務」:
無論是改寫匯入還是新增匯入,按照匯入的資料集的定時更新任務為準。
不勾選「定時更新任務」:
改寫匯入時,原來資料集設定的更新任務不被改寫
新增匯入時,匯入的資料集不帶有更新任務
規則:
勾選「同時匯出權限配置」,可匯出資源的權限配置。
權限配置包括:使用權限(查看、編輯、授權等)、行列權限。
僅匯出該資源項自身設定的權限,不匯出由父節點繼承而來的權限。
資料夾、主題、儀表板、資料集等資源匯出權限時,均不匯出繼承而來的權限。
舉例:
資料夾X中有一個資料集A,資料夾和資料集上面都配置了使用權限。
僅匯出資料集A,勾選「同時匯出權限配置」。最終只匯出資料集A身上的權限,不匯出資料夾X上的權限。
同時匯出資料夾X和資料集A,勾選「同時匯出權限配置」。最終既匯出資料集A身上的權限,也匯出資料夾X上的權限。
注:非超管使用者支援進行資源遷移操作,但無法勾選「同時匯出權限配置」。
匯出後會生成 resources.zip 檔案,如下圖所示:
FineBI7.0工程,僅支援匯入FineBI7.0工程的資源,不支援匯入FineReport工程的資源。
如果匯入的資源中包含指標中心相關內容,必須在目標工程中進入一次模型,確定指標中心存在一個模型。
1)若資料連結需依賴第三方插件,目前只支援遷移 JSON 資料集和 Mysql8 資料連結,其他插件類型不適配,會匯入失敗。
2)權限匯出插件生成的伺服器資料集,不支援遷移,會匯入失敗。
3)資料連結遷移只遷移配置。驅動jar包、kerberos認證檔案、JNDI 配置檔案等都不會遷移,需要手動配置/放置。
請在進行資料連結遷移前,確認正式工程下是否提前安裝依賴的相關資料連結插件,否則將導致匯入失敗。
請在進行資料連結遷移前,確認正式工程下是否提前安裝依賴的相關資料連結驅動,否則將導致匯入的資料連結不可使用。
若匯出的目錄、我的分析、公共資料依賴資料連結,請確定同時選中相關資料連結資源進行匯出匯入。否則請在資源遷移匯入前,保證正式系統已建立好了資料連結,且該資料連結名需與測試系統一致,否則資源無法遷移成功。
若遷移的是伺服器資料集建立的儀表板,則在遷移前需要保證正式系統上建立好相同名稱的伺服器資料集。
伺服器資料集若依賴相關資料連結,請確認將相關資料連結匯入正式工程,否則匯入的伺服器資料集無法使用。
1)使用者
在資源匯入時,系統中必須有資源包的資源所有者。
比如測試系統中資料表的建立者是Anna,那麼在正式系統中也必須有一個使用者叫Anna。否則匯入時需要修改資源的所有者。
2)使用者類型
在資源遷移程式中,需要BI資料表的建立者的使用者類型保持一致。
比如測試系統中資料表建立者為「分析使用者」,那麼在正式系統中也需要將其新增到「分析使用者」中。
若範本中呼叫了自訂地圖,需要將地圖 json 檔案copy到正式工程下。
在%FineBI%/webroot/WEB-INF/assets/map/image路徑下,將需要遷移的 json 檔案copy到正式工程對應路徑下。
資源匯入前建議對測試系統和正式系統均進行 系統備份。
管理者登入 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。
勾選需要上傳的資源,點選「匯入」,點選「確定」。如下圖所示:
若匯入失敗,顯示失敗的原因(如:匯出工程和匯入工程中存在同名同路徑但是類型不同);若匯入成功,則資源即時生效。如下圖所示:
注:由於對應的環境配置不同 IP 埠號會改變,資源遷移後的儀表板公共連結需要重新進行連結分享。
若遷入的基礎表資源為「抽取資料」,匯入到新的系統中需要手動進行 資料更新 ,或者直接進行 全局更新 。
更新後才能看到匯入的資料表均正常顯示,如下圖所示:
注:若匯入資料表為 Excel 資料集或者以 Excel 資料集為基礎表製作的資料集,則必須進行資料夾更新或者全局更新。
若匯入的資料表為資料庫表或者 SQL 資料集,則可以對匯入的表進行單表更新。
滑鼠選中內容,快速回饋問題
滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。
不再提示
10s後關閉
反馈已提交
网络繁忙