版本升級 - Dataphin

版本升級說明

Dataphin版本升級分為停機升級（即老版本的停機升級流程）、半停機升級（即新版本的停機升級流程）和不停機升級，不同升級模式的差異點如下。詳細升級步驟及說明請參見停機升級Dataphin、不停機升級Dataphin。

差異點	半停機升級	停機升級	不停機升級
主要升級步驟	選擇版本及升級模式 Database Backup、預升級、升級應用、資料更新校正升級結果	選擇版本及升級模式終止任務下發、強制終止任務、停機、備份資料庫、升級應用、重跑強制終止任務、資料更新校正升級結果	選擇版本及升級模式升級（自動滾動升級應用）
是否可登入Dataphin	是（升級應用完成後可登入Dataphin）	否	是

版本升級的影響範圍

停機升級、半停機升級和不停機升級所造成的影響範圍不同，具體影響範圍如下。

半停機升級

升級期間不可登入Dataphin，不影響正在啟動並執行離線任務、即時任務和資料服務API的調用，僅在升級應用階段需要停止任務的下發。

離線任務功能	半停機升級影響
正在啟動並執行任務執行個體	可正常運行，無影響。
即將下發的任務執行個體	在升級應用之外的階段可正常下發，僅在升級應用階段不可下發。
離線任務執行個體監控	整個升級階段，警示無法正常工作。升級結束後，警示即可恢複正常，停機期間的警示事件將會補充發送（如果配置的警示規則為運行逾時，可能會因為升級期間任務狀態無法統計，導致任務最終運行成功，但由於時間長度增加，仍會觸發警示）。
離線任務營運（修改資源群組、啟停任務、查看日誌等）	Dataphin無法登入，不支援。

停機升級

升級期間不可登入Dataphin，需要終止正在啟動並執行離線任務和新任務的下發，不影響正在啟動並執行即時任務和資料服務API的調用，具體影響如下。

功能	功能點	停機升級的影響
資料服務	資料服務API調用	直連資料來源、服務單元API、組合API（不引用邏輯表API時）、註冊API可正常調用；邏輯表API、Dataphin資料來源及引用了邏輯表API的組合API在停機期間不支援正常調用。在Dataphin升級的升級應用階段（即升級資料服務應用階段），有少量的請求失效（不停機升級在升級期間也存在少量請求失效的情況）。僅支援生產環境的API調用，不支援預發環境（開發環境）的API調用。
	調用認證及許可權校正	利用緩衝進行API調用的認證及鑒權。應用的認證依然有效，即對應用的AccessKey/AccessKey Secret的認證在停機期間生效。若調用方傳入的AccessKey/AccessKey Secret有誤，則無法通過認證。 API層級的鑒權依然有效，但API欄位層級的鑒權預設5分鐘失效，即若應用申請了API中某些欄位的許可權，則在欄位層級許可權校正失效期間，所有欄位均可訪問。若系統升級跨天，且API許可權到期時間在停機期間，則許可權到期後無法正常失效，Dataphin應用系統復原後許可權才可失效。
	API開發	無法登入，不支援修改、發布及查看API。
	API營運	無法登入，不支援查看API運行情況。
	API警示	無法對API進行限流和警示。
即時任務（包含即時整合和即時研發）	即時任務執行個體運行	可正常運行，無影響。
	即時任務執行個體監控	在升級的停機階段到應用恢複期間，警示無法正常工作；應用升級成功後（無需等到Dataphin頁面訪問恢複），警示即可恢複正常，停機期間的警示事件將被忽略。
	即時任務營運（修改資源群組、啟停任務、查看日誌等）	無法登入Dataphin，不支援即時任務營運。

不停機升級

不停機升級將對Dataphin的應用進行滾動升級。在升級期間，可能會出現少量請求失敗的情況，重試後即可解決。