1. 概述
1.1 版本
| FineBI 版本 | JAR 包版本 | 功能變動 |
|---|---|---|
| 5.1.5 | 2020-09-02 | |
| 5.1.6 | 2020-09-30 |
|
| 5.1.12 | 2021-04-27 |
|
| 5.1.15 | - | 新增智慧查殺功能，自動中斷更新異常的更新任務 |
1.2 應用場景
使用抽取資料則需要進行 資料更新 以保證資料的可用性。
查看正在更新的任務和已經更新完成的任務，並看到這些任務具體的更新資訊和報錯資訊。
在一個統一的頁面對分散設定的定時更新任務進行查看和管理。
對於正在進行的更新任務，所有使用者可以看到它的更新進度，有管理權限的使用者可以在不需要的時候停止該更新任務。
1.3 功能簡介
FineBI 提供了監視更新情況、停止更新任務和設定定時更新的功能。
2. 查看更新情況（運作監視）
登入 FineBI ，選擇資料準備>更新任務管理，如下圖所示：
2.1 查看更新任務
進入資料更新「運作監視」介面，可以看到已經結束或者正在更新的任務，如下圖所示：
擁有資料權限不同的使用者，可以看到的更新任務是不同的，與他們所擁有的資料權限相關。
正在更新的任務（更新狀態顯示為進度條），可以被所有使用者看到，可以被有「管理權限」的使用者看到並查看詳情。
所有已結束的任務（更新狀態顯示為已結束），可以被所有有「管理權限」的使用者看到並查看詳情。
展示更新內容如下所示：
| 顯示內容 | 說明 |
|---|---|
任務名稱 | 「單表更新」預設為：表名+單表更新 「業務包更新」預設為：業務包名+業務包更新 「全局定時更新」預設為：全局更新任務 注：任務名稱可重複。 |
| 任務開始時間、任務結束時間 | 更新開始和結束的時間 |
| 更新狀態 | 已結束、正在更新中顯示為進度條 |
| 觸發方式 | 手動、定時 |
| 觸發人 | 其中設定為 定時更新 任務觸發角色為 system |
| 基礎表更新 | 更新成功的數目 / 共需更新數目 |
| 自助資料集更新 | 更新成功的數目 / 共需更新數目 |
| 聯動更新 | 更新成功的數目 / 共需更新數目 |
2.2 搜尋更新任務
注：搜尋框中更新狀態預設全選。
點選下拉，輸入需要搜尋的「更新任務名稱、任務時間、觸發方式、觸發人、更新狀態、運作結果」等資訊，點選「搜尋」，如下圖所示：
2.3 查看任務詳情
點選「詳情 」，如下圖所示：
展示「更新報錯資訊、基礎表更新情況、自助資料集更新情況、聯動資訊更新情況」，如下圖所示：
2.3.1 查看更新報錯原因
若更新狀態為失敗，點選「更新失敗」按鈕，可顯示更新失敗的原因，如下圖所示：
更新報錯原因提示如下所示：
| 報錯型別 | 报错原因提示 |
|---|---|
| 資料集生成錯誤 | 資料集欄位可用性出現問題，問題欄位已經標記為紅色，建議重新編輯本資料集後再次更新。被依賴的資料集發生更改有可能會引發該錯誤 |
| 無法正確獲取資料，請檢查該資料集的配置或資料庫配置是否正常 | |
| 資料集的父表 [X] 由於異常更新失敗，故該資料集無法正常更新 | |
增量更新相關語句均為空，請檢查該資料集的增量更新配置情況 注：若沒有填寫增量更新語句，不允許進行更新 | |
| 該基礎表已經進行過行列轉換或者自循環列操作，無法進行增量更新，請全量更新該基礎表 | |
| 伺服器資料集無法執行增量更新，請配置為全量更新，並取消增量更新配置 | |
| 資料庫連結失敗 | 我們無法連結到包含該資料集的資料連結，請檢查資料連結可用性 |
| 聯動生成錯誤 | 聯動生成錯誤 - 業務包名/表名[欄位名] 與 業務包名/表名[欄位名] 的聯動生成失敗，聯動欄位[欄位名]資料重複 |
2.3.2 定位更新失敗的資料表
對於更新失敗的資料表，除了可以查看報錯原因，還可以查看錶的存放位置。
若更新失敗的表為基礎表，還可以查看該表影響的自助資料集。
数据表更新失败，则会标红，点击更新失败的表，选择「查看该表数据」，会跳转到该数据表所在的业务包下，如下图所示：
點選標紅的表，選擇「查看該表影響的自助資料集」，自助資料集更新任務詳情會跳轉到該表更新失敗影響的自助資料集，如下圖所示：
點選傳回，則回到顯示所有自助資料集的更新情況，如下圖所示：
3. 停止更新
3.1 手動停止更新
只有有管理權限（詳情請參見：資料權限 2.3節）的使用者可以停止正在更新的任務。點選「詳情」，如下圖所示：
| 設定停止更新時資料表狀態 | 提示 | 可使用的資料 | |
|---|---|---|---|
| 點選停止更新時已完成更新 | 停止更新時已更新成功的表/聯動 | 無報錯 | 更新後的資料 |
| 停止更新時已更新失敗的表/聯動 | 提示停止更新前具體失敗的原因 | 上次更新成功的資料 | |
| 點選停止更新時未完成更新 | 更新任務被中斷，不再執行 | 上次更新成功的資料 | |
3.2 智慧中斷更新
在更新過程中，有可能會因為使用者網路、環境不穩定而出現更新異常，導致更新卡住，無法成功更新。
對於這種情況，FineBI 為使用者提供了「智慧中斷」功能，當某個基礎表更新異常時， FineBI 會自動殺掉該基礎表的更新，並且不影響同一個更新任務中的其他基礎表更新。
智慧中斷更新功能是針對基礎表更新的功能，判斷基礎表是否更新異常；
基礎表最長更新時間為 12 小時，若 12 小時後某張基礎表還沒更新完成，則會強制終止該基礎表的更新；
智慧中斷會檢查是否有誤中斷，不會誤傷更新正常的基礎表。
若使用者不需要 FineBI 智慧中斷更新任務，可將 SystemOptimizationConfig.openUpdateIntelligentKill 的參數值改為 false，更改參數的操作方法詳情請參見：FINE_CONF_ENTITY視覺化配置
4. 管理定時更新任務
4.1 定時更新任務
「更新任務管理」頁面下方，是「BI資料定時更新任務」。如下圖所示：
一個使用者，可以查看並管理他有管理權限（詳情請參見：資料權限 2.3節）的任務。
4.2 搜尋定時更新任務
點選下拉，輸入需要搜尋的「更新任務名稱、運作時間、更新型別、運作狀態」等資訊，點選「搜尋」，如下圖所示：
介面顯示對應搜尋條件的搜尋結果。
4.3 管理定時更新
可在此介面設定和調整更新任務，如下所示：
| 圖示 | 作用 |
|---|---|
| 、 | 啟用、暫停該定時更新任務 |
| 忽略配置的更新任務觸發時間，立即執行一次該定時更新任務 注：若沒有填寫增量更新語句，不允許立即執行增量更新 |
| 修改任務。進入一個與新增任務一樣的頁面的第一步，其中所有填充項均為之前配置的各項任務參數。最終儲存才生效 |
| 刪除該定時更新任務 |
| 结果通知 | 詳情參見：定時更新 2.2節 |
4.3.1 編輯定時更新
注：可編輯的定時更新任務必須是已經在「資料準備>業務包/資料表>更新資訊」下新增過後的。
點選，
調整定時更新設定資訊，設定定時更新「觸發時間」、「執行頻率」、「結束時間」以及「通知結果」，點選「確定」，詳情參見：定時更新，如下圖所示：
注：「單表定時更新」可設定全量更新或者增量更新。
此處定時更新不支援設定的內容：
| 定時更新不支援設定內容 |
|---|
| 業務包是否跟隨全局更新而更新 |
| 單表在業務包更新時如何跟隨更新 |
| 增量增加語句 |
| 增量刪除語句 |
5. 注意事項
更新資訊儲存詳情參見：平台日誌
修改 SQL 資料集的 SQL 語句後，不能直接進行增量更新，必須先執行一次全量更新，才能進行增量更新。
新新增的 DB 表、SQL 資料集，不能直接進行增量更新，必須先執行一次全量更新，才能進行增量更新。