版本升级模式对比与影响范围-智能数据建设与治理 Dataphin-阿里云

版本升级说明

Dataphin版本升级分为停机升级（即老版本的停机升级流程）、半停机升级（即新版本的停机升级流程）和不停机升级，不同升级模式的差异点如下。详细升级步骤及说明请参见停机升级Dataphin、不停机升级Dataphin。

差异点	半停机升级	停机升级	不停机升级
主要升级步骤	选择版本及升级模式数据库备份、预升级、升级应用、数据更新校验升级结果	选择版本及升级模式终止任务下发、强制终止任务、停机、备份数据库、升级应用、重跑强制终止任务、数据更新校验升级结果	选择版本及升级模式升级（自动滚动升级应用）
是否可登录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的应用进行滚动升级。在升级期间，可能会出现少量请求失败的情况，重试后即可解决。