在使用數據決策系統時,往往會先使用測試環境系統進行部署開發,確定完全沒問題後再遷移至正式系統。
因此就需要從測試環境往正式環境增量遷移儀錶板、業務包等。
使用 FineBI 數據決策系統時,一般先在測試環境系統上進行開發部署,應答無誤後再遷移到正式系統中。
FineBI 支援將範本檔案和平台配置從測試系統增量遷移到正式系統。
超管登入數據決策系統,點選「管理系統」>「智慧維運」>「資源遷移」,分為「資源匯出」、「資源匯入」兩部分。
本文僅介紹遷移資源型別為「目錄」時的操作方法。
1)資源遷移功能僅超級管理者支援,即使給次級管理者分配了智慧維運的權限,也不能進行資源遷移。
2)正式工程需購買「智慧維運」功能點才可使用「資源遷移」功能。
3)請確定在資源遷移過程中,沒有其他人使用超級管理者帳號,否則部分執行請求可能被取消。
4)不建議在個人 PC 端工程開發範本後,再以資源遷移的形式同步到公司工程。
因為個人 PC 端沒有管理者維護,經常會因為 JAR 包不同步或資源以及配置不同步的問題導致資源遷移失敗,維運成本會很高。
資源遷移之前,請確定資源匯入和匯出的 FineBI 工程使用的版本一致。
管理者可在「管理系統」>「登入管理」>「版本資訊」下查看版本號,如下圖所示:
若版本不一致,可透過升級來確定版本一致,詳情參見:升級指南索引。
注:5.1.15 及之後版本的 BI 工程,在資源匯入時,若上傳資源對應的工程和當前工程版本不一致,則無法上傳。
提示:無法匯入,即將匯入的資源需要的工程版本:XXX。當前工程版本:XXX。請確定工程版本一致!
資源匯入前建議對測試系統和正式系統均進行 系統備份,如下圖所示:
注:備份遷移到的 MySQL 資料庫需要選擇 utf8_bin 的排序規則。
若系統配置了 配置外接資料庫 ,在資源遷移前,請確定正式系統和測試系統的「資料庫預設字元校驗規則」都為「大小寫敏感」。
以 Mysql 為例:
設定方式:若配置了外接資料庫,連結 FineDB 資料庫,開啟 FINE_CONF_ENTITY 表,設定字元校驗規則為 utf8_bin,輸入命令如下:
ALTER TABLE fine_conf_entity MODIFY id VARCHAR(255) CHARACTER SET utf8 COLLATE utf8_bin; #設定欄的預設校驗規則ALTER TABLE fine_conf_entity DEFAULT CHARACTER SET utf8 COLLATE utf8_bin; #設定表的校驗規則
如下圖所示:
若需要進行資料連結遷移,需要在資源遷移匯入前,保證正式系統已建立好了資料連結,且該資料連結名需與測試系統一致,否則資源無法遷移成功。
若遷移的是伺服器資料集建立的儀錶板,則在遷移前需要保證正式系統上建立好相同名稱的伺服器資料集。
在資源遷移過程中,需要儀錶板的建立者的使用者型別保持一致。
比如測試系統中儀錶板建立者為 BI 資料分析使用者,那麼在正式系統中也需要將其新增到 BI 資料分析使用者中。
若範本中呼叫了自訂地圖,需要將地圖 json 檔案copy到正式工程下。
在%FineBI%/webroot/WEB-INF/assets/map/image 路徑下,將需要遷移的 json 檔案copy到正式工程對應路徑下,如下圖所示:
管理者登入系統後,進入「管理系統」>「智慧維運」>「資源遷移」,選擇「資源匯出」,選擇需要匯出的目錄/儀錶板,如下圖所示:
可匯出的資源有:
儀錶板使用到的基礎表和自助資料集
儀錶板的配置、原始名、轉義名、所屬使用者、掛載目錄、是否公共連結、分享情況等
注:並非系統下的所有儀錶板/資料都會被匯出。如不掛出儀錶板,則不存在於匯出的資源中。請務必先 掛出儀錶板 再進行操作。
選擇目錄後,需要選擇依賴資源。如下圖所示:
比如將某儀錶板從測試系統遷移到正式系統中,使用者 alice有查看該儀錶板及業務包的使用權限,使用者 demo 沒有,因此需要先將其資源進行匯出。
此時會獲取該儀錶板所使用的資料表(包含基礎表和自助資料集)資源資訊。如下圖所示:
可選擇對應的資料表資源同時匯出。若正式系統已存在儀錶板需要的資料表資源,在此處可不選擇匯出。
儀錶板依賴資源支援匯出範圍有:
直接使用的分析表,基礎表
使用的分析表、基礎表和在聯動路徑上經過的相關表。組件間的聯動和元件對組件的過濾,匯出最短路徑中的相關表
若依賴的資源來自我的自助資料集,在匯出時也可以進行選擇。後續匯入時,也將匯入到對應使用者的我的自助資料集下
使用者可自行選擇是否匯出以下內容:
若儀錶板使用到 Excel 資料集製作,可勾選同時匯出原始excel附件,直接將原始Excel 附件與儀錶板資源一起匯出,這樣在後續的匯入中不需要再重新上傳 Excel 資料集,直接隨儀錶板匯入
注:若匯出的資料表原始名(即上圖資源中資料表括號內的名稱)與正式系統中一樣,將改寫掉正式系統中的資料表,因此此處需應答好再進行匯出匯入操作。
如不勾選,僅匯出掛載在目錄中的範本,範本中跳轉的子範本不會同時匯出,在「正式系統」中點選對應超連結會報錯。
如勾選該選項,匯出掛載在目錄中的範本時,範本中跳轉的子範本會同時匯出,子範本中若存在下級子範本,也同時匯出,以此類推。
匯出權限配置會匯出該儀表闆對應的權限配置,包含 目錄權限 及對應的 業務包權限 。在後續匯入後,該儀表闆對應的權限設定則不會發生變化。
匯出後會生成 resources.zip 檔案,如下圖所示:
超級管理者登入數據決策系統,選擇「管理系統」>「智慧維運」>「資源遷移」>「資源匯入」,如下圖所示:
注1:資源匯入前建議進行 系統備份,其中備份遷移到的 MySQL 資料庫需要選擇 utf8_bin 的排序規則。
注2:單次只允許上傳單個壓縮檔案。
系統會獲取匯入檔案所包含的資源,包含型別、平台路徑、物理資源、權限訊息及匯入方式。
型別包括首頁、目錄、BI範本、BI資料表、BI範本子範本、報表範本、報表範本子範本、上報標籤、連結
點選「詳情」可查看權限資訊
其中會提示是否有部門/角色/使用者在被匯入系統中的缺失情況
在匯入時,系統會對資源進行檢查,檢查是否與系統現有資源有衝突。
衝突檢驗以資源的原始名與其在平台中的路徑名為準。
分為直接匯入和改寫匯入
直接匯入:與系統中已有資源沒有衝突,預設選中。
改寫匯入:與系統中已有資源有衝突,預設不選中且高亮,點選按鈕可以查看到詳細說明
注:匯入資料表的表名和被匯入工程中原有的資料表表名不同,匯入後卻提示表衝突需要改寫匯入。此時需要判斷匯入前後資料表建立表時的表名是否相同。
例:資源匯出工程 1 中的表建立時名稱叫自助資料集 1 ,後來改成了表 A ;資源匯入的時候會跟被匯入工程中的自助資料集1衝突。
在匯入時,系統會對資源進行檢查,檢查是否與系統現有資源有衝突,衝突檢驗以資源的原始名為準。
平台路徑:路徑衝突
物理資源:路徑衝突
例:資源匯出時,表建立時名稱叫「分析表 1」 ,後來改成了「網際網絡分析渠道統計資料」 。資源匯入時,會跟被匯入工程中的「分析表 1」衝突。如下圖所示:
勾選需要上傳的資源,點選「匯入」,點選「確定」。如下圖所示:
若匯入失敗,顯示失敗的原因(如:匯出工程和匯入工程中存在同名同路徑但是型別不同);
若匯入成功,則資源即時生效。如下圖所示:
注:由於對應的環境配置不同 IP 埠號會改變,資源遷移後的儀錶板公共連結需要重新進行連結分享。
若遷入的基礎表資源為「抽取資料」,匯入到新的系統中需要先進行資料更新,才能正常查看對應的儀錶板。
在對應業務包下進行 資料更新 ,或者直接進行 全局更新 。更新後則能看到匯入的資料表均正常顯示,如下圖所示:
注1:2020-01-15 之前的版本,若儀錶板使用的是 Excel 資料,需要進入到資源使用的資料業務包中,在對應資料表下選擇更新 Excel,並將源資料的 Excel 表重新上傳並更新。
注2:若匯入資料表為 Excel 資料集或者以 Excel 資料集為基礎表製作的自助資料集,則必須進行業務包更新或者全局更新。
若匯入的資料表為資料庫表或者 SQL 資料集,則可以對匯入的表進行單表更新。
如不進行資料更新操作,預覽相關儀錶板時,會提示「當前組件用到的自助資料集異常,無法正常顯示」。