動態限制資源匯入檔案大小,防止記憶體上限溢位
1)匯出「目錄」型別的資源時,可同時匯出以下依賴資源:
目錄儀表板所在主題的全部資源,包括資料集、組件、儀表板以及主題配置
目錄儀表板所在主題依賴的其他主題父表或公共資料的父表
2)新增「同時匯出Finereport連結跳轉範本」選項,支援將目錄跳轉的Finereport子範本一起匯出
使用 FineBI 系統時,一般先在測試環境系統上進行開發部署,確認無誤後再遷移到正式系統中。
FineBI支援將目錄、資料集、資料連結、儀表板等資源從測試系統增量遷移到正式系統。
FineBI 以插件形式提供資源遷移功能,支將目錄、資料集、資料連結、儀表板等資源從測試系統到正式系統的增量遷移。
插件安裝成功後,管理者登入FineBI系統,點選「管理系統>智慧維運>資源遷移」,分為「資源匯出」、「資源匯入」兩部分,如下圖所示:
資源匯出:將需要遷移到其他系統的資源從伺服器中匯出,以供後續遷移。
資源匯入:將需要遷移的資源在新系統中匯入,即遷移至新系統。
1)正式工程需購買「智慧維運」功能點才可使用「資源遷移」功能。
2)請確定在資源遷移過程中,沒有其他人使用超級管理者帳號,否則部分執行請求可能被取消。
3)不建議在個人 PC 端工程開發範本後,再以資源遷移的形式同步到公司工程。
因為個人 PC 端沒有管理者維護,經常會因為 JAR 包不同步或資源以及配置不同步的問題導致資源遷移失敗,維運成本會很高。
4)單次資源匯入內容不可超出2GB,否則在匯入資源時會報錯:out of memoryerror。請少量多次分配匯出和匯入資源。
FineBI6.0版本,資源遷移功能需要依賴「資源遷移」插件。
插件獲取請聯絡技術支援。技術支援聯絡方式:帆軟官方服務渠道使用説明
插件安裝方法參照:插件管理。
資源遷移之前,請確定資源匯入和匯出的 FineBI 工程使用的版本一致(包括 JAR 包時間)。
管理者可在「管理系統>註冊管理>版本資訊」下查看 JAR 包時間,如下圖所示:
若版本不一致,可透過升級來確定版本一致。
注:在資源匯入時,若上傳資源對應的工程和當前工程版本不一致,則無法上傳。
提示:無法匯入,即將匯入的資源需要的工程版本: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; #設定欄的校驗規則
如下圖所示:
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系統後,進入「管理系統>智慧維運>資源遷移」,選擇「資源匯出」。
選擇需要匯出的資源型別,選擇每種型別下需要匯出的具體內容,支援多選。如下圖所示:
可匯出的資源如下:
按層級結構展示,可選取最小粒度為儀表板
匯出儀表板時的資源包括:儀表板配置、ID、轉義名、所屬使用者、物理路徑(資料夾、主題)、平台發佈路徑、儀表板樣式(僅匯出儀表板當前使用的樣式)、儀表板水印(不包括全局水印)、分享狀態、協作狀態
注:並非系統下的所有儀表板/資料都會被匯出。如不發佈儀表板,則不存在於匯出的資源中。請務必先發佈儀表板再進行操作。
按層級結構展示,可選取最小粒度為資料集、組件、儀表板
匯出表時的資源包括:資料集配置、聯動關係、ID、轉義名、所屬使用者、物理路徑(資料夾、主題)、平台發佈路徑(資料夾)、設定的欄位分組、分享狀態、協作狀態
匯出組件時的資源包括:組件配置、ID、轉義名、所屬使用者、物理路徑(資料夾、主題)、協作狀態
匯出儀表板時的資源包括:儀表板配置、ID、轉義名、所屬使用者、物理路徑(資料夾、主題)、平台發佈路徑、分享狀態、協作狀態
注:匯出時,會根據使用者匯出其路徑,匯入時會匯入對應使用者的「我的分析」中。若不存在相關使用者,匯入時需要修改資源的所有者。
按層級結構展示,可選取最小粒度為資料集
匯出表時的資源包括:資料集配置、聯動關係、ID、轉義名、所屬使用者、物理路徑(資料夾、主題)、平台發佈路徑(資料夾)、設定的欄位分組
匯出資料夾時的資源包括:資料夾配置、ID、轉義名、所屬使用者、物理路徑(資料夾)
注1:匯出時,會將所有聯動關係都匯出,但是匯入時,若聯動的表不存在,則自動清除相關聯動。
注2:若匯出時,表處於申請發佈狀態,匯入時需要重新申請。
可選取FineBI系統中的資料連結
匯出資料連結時的資源包括:資料連結的所有配置(基礎配置、進階配置)
注:資料連結的密碼加密匯出,keytab 鍵路徑不支援匯出、遷移後需要手動輸入。
可選取FineBI系統中的伺服器資料集
支援匯出:SQL資料集、檔案資料集、樹資料集、JSON資料集、內建資料集、過程資料集、聯動資料集、儲存過程
檔案資料集
若檔案資料集的資料集來源為URL,則只匯出配置,檔案不匯出
若檔案資料集的資料集來源為檔案,檔案路徑包含參數,則檔案不匯出
樹資料集
若匯出樹資料集時,未匯出依賴的原資料集,則匯入時可正常匯入但無法使用
聯動資料集
若匯出聯動資料集時,未匯出依賴的原資料集,則匯入時可正常匯入但無法使用
權限匯出插件
權限匯出插件生成的伺服器資料集,不支援遷移,會匯入失敗
第三方插件資料集
若伺服器資料集需依賴第三方插件,目前只支援 JSON 資料集和 Mysql8 資料連結,其他插件型別不適配,會匯入失敗
比如A資料集基於B資料集建立,將A資料集從測試系統遷移到正式系統中,如需正常使用A資料集,需要將依賴的B資料集也匯入。
因此選擇的資源型別為「目錄、我的分析、公共資料」時,可選擇是否「匯出全部依賴資源」。如下圖所示:
該按鈕會匯出這三種資源型別裏的「資料集、組件、儀表板」依賴的資源。
該按鈕僅對當前資源型別生效,需要逐個設定。
可匯出的依賴資源如下:
規則:
可匯出資料集中直接使用的表
可匯出資料集在聯動/血緣路徑上經過的相關表。
舉例:
基於A資料集建立了B資料集,基於B資料集建立了C資料集
匯出C資料集時,依賴的資源為A資料集和B資料集
注意:
如果依賴的資源在「我的分析」中,根據使用者匯出其路徑,後續匯入時匯入對應使用者的「我的分析」中
可匯出組件中直接使用的資料集
可匯出組件中使用的表在聯動/血緣路徑上經過的相關資料集
基於A資料集建立了B資料集,基於B資料集建立了C資料集,基於C資料集建立了X組件
匯出X組件時,依賴的資源為A資料集、B資料集和C資料集
可匯出儀表板中所使用的組件
可匯出儀表板中直接使用的資料集
可匯出儀表板中使用的表在聯動路徑上經過的相關資料集
對於組件間的聯動、元件對組件的過濾,只匯出最短路徑中的相關資料集
資源型別為「目錄」時,可匯出目錄儀表板中組件跳轉的儀表板
注:6.0.12 及之後版本,資源型別為「目錄」時:
可匯出目錄儀表板所在主題的全部資源,包括資料集、組件、儀表板以及主題配置(主題內表的模型關係、計算欄位、跨表鑽取目錄等)
可匯出目錄儀表板所在主題依賴的其他主題父表或公共資料的父表
舉例1:
基於A資料集建立了B資料集,基於B資料集建立了C資料集,基於C資料集建立了D組件
基於X資料集建立了Y資料集,基於Y資料集建立了Z資料集,基於Z資料集建立了W過濾組件
基於D組件和W過濾組件建立了儀表板
匯出儀表板時,依賴的資源為D組件、A、B、C資料集、X、Y、Z資料集
舉例2:
基於公共資料中的A資料集建立了B資料集,基於B資料集建立了C組件
基於公共資料中的D資料集建立了E資料集,基於E資料集建立了F組件
在主題W內,基於C組件建立了儀表板X,基於F組件建立了儀表板Y
掛載儀表板X至目錄Z,匯出目錄Z時,依賴的資源為Y儀表板、C、F組件、A、B、D、E資料集
比如A資料集設定了定時更新,將A資料集從測試系統遷移到正式系統中,使用者可能需要將設定的定時更新也匯入。
因此在匯出時,支援選擇同時匯出「同時匯出Finereport連結跳轉範本」、「原始Excel附件」、「公共連結的設定項」、「定時更新任務」、「同時匯出權限配置」。如下圖所示:
同時匯出配置,對匯出的全部資源型別生效。
可同時匯出的資源如下:
預設勾選該選項,且只對「目錄」型別的遷移資源生效
不勾選「同時匯出Finereport連結跳轉範本」:
僅匯出掛載在目錄中的儀表板,儀表板中跳轉的Finereport子範本不會同時匯出
勾選「同時匯出Finereport連結跳轉範本」:
匯出掛載在目錄中的儀表板時,儀表板中跳轉的Finereport子範本會同時匯出,子範本中若存在下級子範本,也同時匯出,以此類推
若匯出的資源、或匯出依賴的資源,存在「Excel資料集」。
勾選「原始Excel附件」,則會將原始Excel附件一起匯出,這樣在後續的匯入中不需要再重新上傳Excel檔案。
注:若匯出的資料表與正式系統相同位置的表名稱一樣,將改寫掉正式系統中的資料表,因此此處需確認好再進行匯出匯入操作。
若匯出的資源存在「儀表板」,可勾選「公共連結的設定項」,將儀表板的公共連結設定一起匯出。
勾選「公共連結的設定項」:
無論是改寫匯入還是新增匯入,按照匯入的儀表板的公共連結設定為準
不勾選「公共連結的設定項」:
改寫匯入時,原來儀表板設定的公共連結不被改寫
新增匯入時,匯入的儀表板預設不開啟公共連結
若匯出的資源、或匯出依賴的資料集,存在「定時更新任務」。
勾選「定時更新任務」,則會將資料集的定時更新任務一起匯出。定時更新任務匯出該資源項自身的更新任務,不匯出上代節點上的更新任務。
勾選「定時更新任務」:
無論是改寫匯入還是新增匯入,按照匯入的資料集的定時更新任務為準。
不勾選「定時更新任務」:
改寫匯入時,原來資料集設定的更新任務不被改寫
新增匯入時,匯入的資料集不帶有更新任務
勾選「同時匯出權限設定」,可匯出資源的權限設定。
權限設定包括:使用權限(查看、編輯、授權等)、列欄權限。
僅匯出該資源項自身設定的權限,不匯出由上代節點繼承而來的權限。
資料夾、主題、儀表板、資料集等資源匯出權限時,均不匯出繼承而來的權限。
資料夾X中有一個資料集A,資料夾和資料集上面都配置了使用權限。
僅匯出資料集A,勾選「同時匯出權限設定」。最終只匯出資料集A身上的權限,不匯出資料夾X上的權限。
同時匯出資料夾X和資料集A,勾選「同時匯出權限設定」。最終既匯出資料集A身上的權限,也匯出資料夾X上的權限。
匯出後會生成 resources.zip 檔案,如下圖所示:
管理者登入 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後關閉
反馈已提交
网络繁忙