升级昇腾服务器芯片固件 Atlas 800 训练服务器（型号9000）支持昇腾服务器芯片固件升级。本章节以Atlas 800 训练服务器（型号9000）的A800-9000-npu-firmware_x.x.x.run包为例介绍升级固件的相关操作。 操作步骤 参照升级前准备准备软件包“A800-9000-npu-firmware_x.x.x.run”。 使用root账户登录Atlas 800 训练服务器（型号9000）所在服务器。 将“A800-9000-npu-firmware_x.x.x.run”上传至到Linux系统任意目录下，如/opt下。 进入软件包“A800-9000-npu-firmware_x.x.x.run”所在路径，如/opt下。 cd /opt 执行如下命令，更改“A800-9000-npu-firmware_x.x.x.run”软件包权限。 chmod u+x A800-9000-npu-firmware_x.x.x.run 执行./A800-9000-npu-firmware_x.x.x.run --check命令，校验run安装包的一致性和完整性。 执行升级命令完成升级操作。 升级过程支持一键式升级操作，可执行./A800-9000-npu-firmware_x.x.x.run --upgrade命令，完成升级。 出现以下类似回显，表示升级成功。 Firmware package install success! Reboot needed for installation/upgrade to take effect! 软件包名称中的“x.x.x”表示固件版本号。 安装过程中的日志信息输出在“/var/log/ascend_seclog/ascend_install.log”文件中，用户可以执行vim /var/log/ascend_seclog/ascend_install.log命令打开日志。 重启系统。 reboot 检查升级后的版本号。 在软件包安装路径下，执行以下命令查看所升级软件包版本是否正确。 cat version.info 软件包安装默认路径：“/usr/local/Ascend/firmware”。 父主题： 升级组件

升级前准备 升级前检查 升级操作前，请按照表1中序号顺序进行检查，并记录检查结果。 表1 升级前检查表 序号 项目 检查标准 1 检查软件版本 查询并记录当前系统中Atlas 800 训练服务器（型号9000）版本。 确认需要升级的版本。 2 检查系统状态 检查Atlas 800 训练服务器（型号9000）告警： 未出现告警，可直接升级。 出现告警时，请与技术支持确认告警情况，然后再决定下一步动作。 不同芯片的软件版本支持情况如表2所示。 表2 软件版本配套表 芯片名称 适配版本 昇腾服务器 A 20.0.0、20.1.0、20.2.0 昇腾服务器 B 20.0.0、20.1.0、20.2.0 昇腾服务器 Pro A 20.0.0、20.1.0、20.2.0 昇腾服务器 Pro B 20.2.0.SPC300 昇腾服务器 Premium A 20.2.0.SPC300 获取升级包 请通过下述方法获取升级包。 1. 登录A800-9000。 2. 打开目标版本“A800-9000 X.X.X”。 固件、驱动与CANN的配套关系，请查看CANN软件版本的《CANN 版本配套表》。 在指定版本页面下载对应升级包到客户端（本地PC）。获取的升级包如表3所示。 下文中所有x.x.x代表软件版本号。 A800-9000-npu-driver_x.x.x_linux-aarch64.run适配所有操作系统。 表3 升级包信息 硬件形态 host操作系统版本 host操作系统内核版本 驱动包名称 固件包名称 aarch_64+Atlas 800 训练服务器（型号9000） EulerOS 2.8 4.19.36-vhulk1907.1.0.h475 A800-9000-npu-driver_x.x.x_euleros2.8-aarch64.run A800-9000-npu-firmware_x.x.x.run CentOS7.6 4.14.0-115.el7a.0.1.aarch64 A800-9000-npu-driver_x.x.x_centos7.6-aarch64-.run Ubuntu18.04 4.15.0-45-generic 说明： 若内核版本和操作系统版本匹配失败，需先安装dkms，安装方法请参见驱动源码编译。 A800-9000-npu-driver_x.x.x_ubuntu18.04-aarch64.run CentOS8.2 4.18.X 说明： 支持升级到5.6.14。 A800-9000-npu-driver_x.x.x_linux-aarch64.run BC_Linux 7.6 4.19 A800-9000-npu-driver_x.x.x_centos7.6-aarch64-.run A800-9000-npu-driver_x.x.x_linux-aarch64.run kylinosv10SP1 说明： kylinosv10SP1在21.0.rc1及以上版本才支持。 4.19.90-17.ky10.aarch64 A800-9000-npu-driver_x.x.x_linux-aarch64.run BC_Linux 7.7 说明： BC_Linux 7.7在21.0.rc1及以上版本才支持。 4.19.25-203.e17.bclinux.aarch64 A800-9000-npu-driver_x.x.x_linux-aarch64.run 检查软件包完整性 为了防止软件包在传递过程或存储期间被恶意篡改，下载软件包时需下载对应的数字签名文件用于完整性验证。 在软件包下载之后，请参考《OpenPGP签名验证指南》，对从Support网站下载的软件包进行PGP数字签名校验。如果校验失败，请不要使用该软件包，先联系技术支持工程师解决。 使用软件包安装/升级之前，也需要按上述过程先验证软件包的数字签名，确保软件包未被篡改。 运营商客户请访问：http://support.huawei.com/carrier/digitalSignatureAction 企业客户请访问：https://support.huawei.com/enterprise/zh/tool/pgp-verify-TL1000000054 父主题： 升级

请求消息 请求参数 表2 参数说明 名称 参数类型 是否必选 说明 target_version String 是 目标版本。 URI样例 https://{Endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/3aa441c4c98a4b36b100a7e3e87d17cein03/major-version/inspection { "target_version": "14.9.0" }

Redis实例是否支持版本升级，如Redis 4.0升级到Redis 5.0？ 暂不支持直接升级。Redis不同版本的底层架构不一样，在创建Redis实例时，确定Redis版本后，不能修改，如Redis 4.0的实例不能升级到Redis 5.0。 如您的业务需要使用Redis高版本的功能特性，可重新创建高版本Redis实例，然后将原有Redis实例的数据迁移到高版本实例上。具体数据迁移操作，可参考数据迁移指南。 父主题： 扩容缩容与实例升级

实践概述 在实际业务中，考虑到机房故障问题，需要将服务部署在不同的可用区中以提高可用性。 但是，在不同可用区部署组件时每个组件都必须按需配置一遍，存在操作复杂、容易出错的问题。而且需要在组件创建完成后立即部署运行，并不支持创建后按需部署的需求。如果组件配置错误，会导致部署失败，需要删除后重新创建并部署。 使用ServiceStage的发布管理功能可以更好的实施组件迁移和搬迁： 基于ServiceStage发布管理的批量克隆发布单实现组件的跨可用区搬迁。 基于ServiceStage发布管理的批量升级发布单实现组件跨可用区的升级，并指定在不同可用区组件的升级顺序。 父主题： 使用ServiceStage基于发布管理实现组件跨可用区搬迁和顺序升级

通过DRS升级大版本 RDS for MySQL支持通过DRS将RDS for MySQL 5.6版本数据迁移到5.7版本。使用该方式进行大版本升级，需要提前准备好待迁移到的高版本数据库实例。 您可以在“实例管理”页面，单击目标实例名称，在页面右上角，单击“迁移数据库”，进入 数据复制服务 信息页面。 具体迁移操作，请参见《数据复制服务用户指南》的“入云迁移”内容。 表3 MySQL数据库版本信息 源数据库版本 目标数据库版本 迁移类型 RDS for MySQL/自建MySQL/其他云MySQL 5.5.x 5.6.x 5.7.x 8.0.x RDS for MySQL 5.6.x 5.7.x 8.0.x MySQL数据库版本升级 DRS仅支持从低版本迁移到高版本。

升级检查项及升级失败的修复建议 表1 升级检查项及修复建议 检查项 检查内容 修复建议 utf8mb3Check 检查字符集utf8mb3。 MySQL 5.7中，字符集utf8等同于utf8mb3, MySQL 8.0中，字符集utf8等同于utf8mb4, 请注意升级后如果使用utf8创建表格，相当于使用字符集utf8mb4。 用户无需处理该项检查。 removedSysVars 检查已移除的系统参数。 系统参数在MySQL 8.0中已删除。 该检查项不影响升级，用户无需处理。 sysVarsNewDefaults 检查系统参数默认值变化。 系统参数在MySQL 8.0中的默认值发生变化，如果您修改过该参数的值，升级后保留修改后的值，如果未修改过，将采用新的默认值。 该检查项不影响升级，用户无需处理。 zeroDatesCheck 检查使用了零日期、日期时间和时间戳。 MySQL 8.0.16及以后版本，将零值日期（例：“2024-00-00”）作为查询条件时，MySQL将该字符串转换为DATE，如果转换失败，该查询将报错。 该检查项不影响升级，但影响升级后的查询逻辑。用户无需处理global.sql_mode的报错，建议排查是否存在此类值，如果存在，修改为非零值。 enumSetElementLenghtCheck 检查ENUM/SET列元素长度。 元素长度大于255个字符，请修改到不超过255个字符。 reservedKeywordsCheck 检查保留字。 与MySQL 8.0中的保留字冲突，请修改名字。 mysqlDollarSignNameCheck 检查$符号。 数据库对象名包含“$”，请修改。 mysqlInvalid57NamesCheck 检查非法库名/表名/列名等。 包含非法名字，请修改。 groupByAscCheck 检查group by ASC/DESC语法。 MySQL 8.0移除了GROUP BY ASC/DESC语法，请修改数据库对象，可将ASC/DESC关键字从 GROUP BY子句中移除，并放置在适当的ORDER BY子句中。 checkTableOutput 通过"check table x for upgrade"检查表存在的问题。 根据检查结果中的“说明”进行修复。 engineMixupCheck 检查 InnoDB 识别了属于其他引擎的表的情况。 表格被 InnoDB引擎识别，但 SQL 层认为它们属于另一个引擎，请联系客服解决。 foreignKeyLengthCheck 检查外键约束名长度。 外键约束名长度不得超过64个字符，请修改。 nonNativePartitioningCheck 检查使用了非本地分区引擎的分区表的情况。 MySQL 8.0仅支持InnoDB 和 NDB作分区表引擎，请转换为InnoDB引擎，或删除其分区。 routinesSyntaxCheck 检查语法不兼容的情况。 存储过程、函数等数据库对象的定义包含了不兼容的语法，例如与MySQL8.0中的保留字冲突，请根据检查结果中的“说明”作修改。 maxdbFlagCheck 检查是否使用了过时的 MAXDB sql_mode标志。 MySQL 8.0删除了sql_mode中的MAXDB选项，请修改sql_mode参数，不使用MAXDB。 sqlModeFlagCheck 检查是否使用了过时的sql_mode标志。 MySQL 8.0删除了部分sql_mode标志，请根据检查结果中的“说明”，修改sql_mode参数。 removedSysLogVars 检查已移除的系统日志系统参数。 MySQL 8.0移除了部分系统日志系统参数，请知悉。 用户无需处理该项检查结果。 mysqlIndexTooLargeCheck 检查索引长度。 MySQL 5.7和MySQL 8.0都支持相同长度的索引，最大索引长度为767字节，在MySQL 8.0 utf8mb4编码下，最大支持191个字符；请修改索引长度至不超过191个字符。 circularDirectoryCheck 检查表空间数据文件路径使用循环目录。 目标版本不支持表空间在数据文件路径中包含循环目录引用（例如“/../”），请联系客服处理。 columnsWhichCannotHaveDefaultsCheck 检查列默认值。 BLOB、TEXT、GEOMETRY或JSON等类型的列不允许设置默认值，请通过ALTER TABLE语句删除默认值。 removedFunctionsCheck 检查已移除的函数。 目标版本删除了部分函数，请根据检查结果中的“说明”，修改相应数据库对象。 mysqlOrphanedRoutinesCheck 检查孤立的存储过程或函数等。 孤立的存储过程或函数等指其引用的数据库对象已不存在，无法运行，请删除。 mysqlEmptyDotTableSyntaxCheck 检查废弃的标识符。 请根据检查结果中的“说明”，修改对应数据库对象中的标识符。 mysqlSchemaCheck 检查表名冲突。 MySQL8.0新增部分表，请通过RENAME TABLE语句修改存在冲突的表名。 mysqlInvalidEngineForeignKeyCheck 检查外键约束指向其他引擎的表。 请通过ALTER TABLE语句修改引擎，或删除外键引用。 lowerCaseNameCheck 检查参数lower_case_table_names=1时，是否存在大写表名 参数lower_case_table_names=1时，如果存在大写表名，将导致升级失败；请先修改lower_case_table_names=0，通过RENAME TABLE语句将检查结果中的大写表名修改为小写，再将lower_case_table_names的值修改回1。 specVarInConfigFileCheck 检查配置文件中 sql_mode、loose_tls_version 是否有过时的值。 目标版本移除了部分sql_mode标志，MySQL8.0.28及其以上，loose_tls_version参数不支持TLSv1和TLSv1.1，请根据检查结果修改sql_mode或loose_tls_version参数的值。 reversedUserCheck 检查是否创建了创建 mysql.infoschema@localhost。 MySQL8.0内置mysql.infoschema@localhost账号，如MySQL5.7存在此账号，将导致升级失败，升级前请删除该账号。 schemaInconsistencyCheck 检查表文件移除或损坏导致的数据库结构不一致问题。 表文件.frm缺失，请联系客服处理。 geometryIndexCheck 检查空间坐标作为索引时是否为空间索引。 目标版本中，空间坐标作索引时必须为空间索引，请重建索引或删除索引。 danglingIndexCheck 检查是否存在空悬索引。 全文索引列删除导致FTS_DOC_ID空悬的表，需要进行 OPTIMIZE TABLE修复。 viewColumnCheck 检查视图列名长度。 目标版本中视图列名长度不可超过64个字符，请通过ALTER VIEW语句修改列名。 partitionedTablesInSharedTablespaceCheck 检查分区表是否在共享表空间。 目标版本不支持共享表空间，请通过ALTER TABLE语句将它们移动到独立表空间。 partitionsReferencedCheck 检查分区表是否被普通表通过外键引用。 分区表不可被普通表引用，请删除外键引用。 partitionsRangeDateCheck 检查按时间分区的分区表。 MySQL 8.0按时间分区时，时间列内容要求是标准的格式（例如：'YYYY-MM-DD hh:mm:ss' 或 'YY-MM-DD hh:mm:ss'），并修改相应表中时间数值为标准格式。 表2 升级失败的修复建议 问题描述 影响 修复建议 RDS for MySQL 5.7升级到8.0后，由于默认字符集变更，导致执行部分SQL时索引失效。 5.7默认使用UTF8mb3字符集，8.0默认使用UTF8mb4字符集。 5.7版本使用默认字符集建表，在升级过程中，字符集不会自动变更为8.0版本默认字符集，若用户在内核升级到8.0后建表，同时对两张字符集不同的表进行JOIN等操作，影响SQL执行时索引选择，最终导致SQL执行时间变长。 修改8.0的库、表、字段字符集、以及默认字符集，与5.7的字符集一致。 RDS for MySQL 5.7升级到8.0过程中，删除了全文索引，可能会导致升级失败。 可能会导致升级失败。 执行optimize table重建表；并排查空悬FTS_DOC_ID，详见表1。 RDS for MySQL 5.7升级到8.0过程中，由于含有分区表外键约束（通过参数foreign_key_check设置），导致升级失败。 导致升级失败。 移除该外键约束。 5.7版本中含有definer列为空的“mysql.events”表，会导致RDS for MySQL 5.7升级到8.0失败。 导致升级失败。 将definer列设置为非空。 RDS for MySQL 5.7升级到8.0过程中，Server层和InnoDB层列名大小写不匹配导致升级失败。 导致升级失败。 执行optimize table重建表。 RDS for MySQL 5.7升级到8.0过程中，索引中包含的字段在Server层和InnoDB层中大小写不一致导致升级失败。 导致升级失败。 执行optimize table重建表。 使用8.0不支持的“BTREE SPATIAL INDEX”，会导致RDS for MySQL 5.7升级到8.0失败。 导致升级失败。 删除“BTREE SPATIAL INDEX”索引。

约束限制 有关内核版本详情，请参见内核版本说明。 对于主备实例，复制延迟大于300秒无法升级大版本。 实例中存在异常节点，无法升级大版本。 MySQL 5.7及之后版本不再支持Sequence Engine，升级前请确认。 目前RDS for MySQ L实例 最大可支持50万张表（系统表+数据表），大于50万张表时，会导致大版本升级失败。 云数据库RDS for MySQL暂不支持已开启事件定时器功能的实例升级大版本，若您想使用该功能，请先关闭事件定时器。具体操作请参考开启或关闭事件定时器。 升级到8.0版本后，主实例和只读实例会共用SQL限流规则，为避免主实例SQL限流规则对只读业务造成影响，请在升级前审视调整主实例SQL限流规则、以及主实例和只读实例的SQL限流开关。 以下场景不支持RDS for MySQL 5.7升级至8.0： 不支持已绑定DDM或已开通数据库代理的RDS for MySQL实例进行升级。 不支持单机、本地盘、集群版实例进行升级。 主实例下的只读实例带有SQL限流规则时，不支持升级，请在升级前删除只读的限流规则。

注意事项 下发RDS for MySQL 5.7升级至8.0前，需进行预检查，请注意以下内容： 预检查耗时与表数量相关，请您尽量在业务低峰期执行。 检查报告保留24小时，请及时下载。 “检查参数”项失败时，请根据检查详情中的检查项，对照表1进行修复，级别为error的检查项，必须修复才可升级，级别为warning的检查项，请知悉升级前后该内核特性的变化。 修复后需单击“重新检查”，获取新的检查结果。 只能从5.7的最新小版本升级到8.0的最新小版本。请先确认5.7版本已经是最新小版本，才能继续大版本升级。 大版本升级操作建议避开执行备份的时间窗。 升级大版本前建议先做一次全量备份。 升级数据库大版本过程将造成约10~120秒的业务中断，请确保您的应用有自动重连机制。请在业务低峰期执行该操作，在业务高峰期执行会导致升级时长变长。 升级主实例大版本时，如有只读实例，也会同步升级只读实例的大版本（不支持单独升级只读实例的大版本）。 升级大版本后，实例会升级到新的内核大版本，不支持降级。 请务必仔细对比升级前后版本差异，建议您新建一个RDS for MySQL 5.7或8.0版本实例进行语法测试，避免应用使用的低版本语法或特性在升级高版本后不支持。 建议您将原实例数据恢复到新实例上面，先使用新实例进行升级测试，确认各项功能正常后再升级原实例。 内核大版本升级期间，自动扩容不生效，需要确保实例预留了足够的空间支撑升级过程中的业务写入。 大版本升级定时任务需预准备，设置后不可取消。 升级大版本后，升级前的备份将不可用于新版本实例，时间点恢复功能将不能选择升级前的时间点。 大版本升级过程中禁止event的DDL操作，如create event、drop event和alter event。 大版本升级后，规格参数会恢复到升级版本的默认值，包括以下参数：threadpool_size、innodb_buffer_pool_size、innodb_io_capacity、innodb_io_capacity_max、innodb_buffer_pool_instances、back_log、max_connections。

单批发布方式升级组件版本配置 登录ServiceStage控制台。 选择以下任意方式进入组件“概览”页面： 在“应用管理”页面，单击组件所属应用名称，在“组件列表”单击待操作组件名称。 在“组件管理”页面，单击待操作组件名称。 单击页面右上角的“升级”。 选择“单批发布”。 单击“下一步”，参考下表设置组件版本配置信息，其中带“*”标志的参数为必填参数。 参数 说明 技术栈 固定为创建并部署组件时选择的技术栈。 *YAML模式 选择使用YAML配置来升级组件。 选择关闭：使用界面配置来升级组件。 选择开启：使用YAML配置来升级组件，从部署了待升级组件的CCE自动同步组件最新负载信息用于修改后升级组件。您也可以单击“导入YAML文件”，导入已经编辑好的待升级组件YAML配置文件。 说明： 使用YAML配置来升级组件，组件YAML配置文件中各参数的说明请参考Deployment。 *软件包/镜像 固定为创建并部署组件时选择的组件来源。 “YAML模式”选择关闭：选择“源码仓库”，参考仓库授权创建授权，设置代码来源；选择软件包或者镜像包，则固定为创建并部署组件时选择的软件包类型（Jar、War、Zip）或者镜像包类型。由您选择的技术栈类型决定，具体情况请参考表1。 “YAML模式”选择开启：选择“源码仓库”，参考仓库授权创建授权，设置代码来源；选择软件包，则固定为创建并部署组件时选择的软件包类型（Jar、War、Zip）。由您选择的技术栈类型决定，具体情况请参考表1。 *上传方式 “YAML模式”选择关闭：选择软件包或者镜像包，重新选择已上传的软件包/镜像包，上传方式请参考组件来源说明。 说明： 如果选择的是镜像包： 可重新自定义容器名称：长度为1到63个字符，可以包含小写英文字母、数字或中划线（-），并以小写英文字母开头，小写英文字母或数字结尾。 单击已选择的镜像包卡片右上角的，可修改镜像包来源。 “YAML模式”选择开启：选择软件包，重新选择已上传的软件包，上传方式请参考组件来源说明。 *编译命令 “YAML模式”选择关闭、组件来源是“源码仓库”、部署环境为Kubernetes类型且所选择的技术栈类型为Java、Tomcat、Node.js、Python、Php时支持设置“编译命令”。 使用默认命令或脚本：优先执行代码根目录下的build.sh，不存在则按照所选语言的通用方法编译，如Java语言的mvn clean package。 使用自定义命令：根据所选语言自定义编译命令，或修改build.sh文件后选择使用默认命令或脚本。 须知： 选择“使用自定义命令”时，请在echo、cat、debug命令中慎用敏感信息或者进行敏感信息加密，以免造成敏感信息泄露。 在项目子目录下执行编译命令，需先进入项目子目录，再执行其余脚本命令。例如： cd ./weather/ mvn clean package *Dockerfile地址 “YAML模式”选择关闭、组件来源是“源码仓库”、部署环境为Kubernetes类型且所选择的技术栈类型为Java、Tomcat、Node.js、Python、Php时支持设置“Dockerfile地址”。 “Dockerfile地址”即Dockerfile文件相对于项目的根目录（./）所在的目录，Dockerfile文件用于镜像构建。 如果未指定“Dockerfile地址”，默认查找项目根目录下的Dockerfile；如果项目根目录下也没有Dockerfile文件，则根据选定的运行环境自动生成Dockerfile。 *组件版本 组件版本号，支持自动生成和自定义版本号。 自动生成版本号：单击“自动生成”，默认以此时的时间戳来生成版本号，格式为yyyy.mmdd.hhmms，s取时间戳中秒数的个位值。例如：时间戳为2022.0803.104321，则版本号为2022.0803.10431。 自定义版本号：输入格式为A.B.C或者A.B.C.D，A、B、C、D为自然数。例如，1.0.0或者1.0.0.0。 须知： 自定义版本号需唯一，请勿与该组件的历史版本号重复，否则会导致本次部署记录覆盖掉相同版本的历史部署记录。 *容器名称 组件部署方式为容器部署且技术栈不是Docker时，您可以自定义容器名称。 容器名称要求为长度为1到63个字符的字符串，可以包含小写英文字母、数字和中划线（-），并以小写英文字母开头，小写英文字母或数字结尾。 资源 “YAML模式”选择关闭时可设置。 您可以根据需要自定义“CPU配额”和“内存配额”，设置组件运行可以使用的最大/最小CPU核数（Core）和内存数量（GiB），从而选择性地为每个组件的实例设定所需要的资源数量。 当您为组件实例指定了资源“申请”时，CCE就利用该信息决定将组件实例调度到哪个节点上；当您为组件实例指定了资源“限制”时，CCE就可以确保运行的组件实例占用的资源不会超出所设限制。CCE还会为组件实例预留所申请数量的系统资源。申请值和限制值的配置说明及建议，请参考资源限制指南。 如需修改，请勾选待修改项后输入新的配置值。不勾选表示不限制。 说明： 如果“上传方式”选择的组件来源为镜像包且启用了多容器部署时，请根据您的实际业务需要为各容器实例分别设置此参数。 JVM参数 “YAML模式”选择关闭、技术栈类型选择Java/Tomcat时可设置，用于配置Java代码运行时的内存参数大小。 输入JVM参数，如-Xms256m -Xmx1024m，多个参数以空格间隔，不填则为空。 Tomcat配置 “YAML模式”选择关闭、技术栈类型选择Tomcat时可设置，用于配置Tomcat请求路径、端口号等参数。 勾选“Tomcat配置”，弹出“Tomcat配置”对话框。 单击“使用示例模板”，根据业务要求编辑模板文件。 说明： Tomcat配置，使用默认server.xml配置，上下文路径是"/"，没有指定应用路径。 如需自定义应用路径，请参考定制Tomcat Context path。 单击“确定”。 云服务配置 组件部署方式为容器部署且“YAML模式”选择关闭时，请参考管理容器部署组件云服务配置，根据您的实际业务需要进行设置。 须知： 如果组件绑定了云数据库RDS，不支持删除，否则会导致升级失败。 容器配置 组件部署方式为容器部署且“YAML模式”选择关闭时，请参考管理容器部署组件容器配置，根据您的实际业务需要进行设置。 高级配置 “YAML模式”选择关闭时，请参考管理容器部署组件高级配置，根据您的实际业务需要进行设置。 *缩容时间窗 您可以设置一个缩容时间窗，用于在组件实例停止前保存重要数据。取值范围为0-9999秒，默认设置为30秒。 例如某应用有两个实例，执行缩容操作，缩容后只剩一个实例，则您仍然可以在设置的时间窗内对即将要停止的实例进行某些操作。 单击“升级”。 等待组件状态由“升级/回滚中”转换为“运行中”，表示已成功完成组件版本配置升级。

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 upgrade_type 是 String 实例升级类型，区分大小写。包括就地升级，灰度升级，热补丁升级三种，三种升级方式的异同，详见接口描述。 inplace：就地升级。 grey：灰度升级。 hotfix：热补丁升级。 upgrade_action 否 String 实例升级操作，区分大小写。 实例升级类型是就地升级时非必选。 灰度升级包括升级自动提交、升级待观察、提交升级和升级回退四种。 热补丁升级包括升级自动提交，升级回退两种。 upgradeAutoCommit：升级自动提交 。 upgrade：升级待观察。 commit：提交升级。 rollback：升级回退。 target_version 否 String 实例升级目标版本。 热补丁升级场景下支持传入多个热补丁版本。 upgrade_shard_num 否 Integer 分布式实例灰度升级分片数。分布式实例灰度升级，升级待观察必填。该值不能大于实例未升级分片总数。 upgrade_az 否 String 灰度升级，升级待观察AZ值，升级待观察时必填。可以支持多AZ一起升级，AZ之间以英文逗号分隔。不能填入不属于该实例的AZ值。

请求示例 就地升级。 PUT https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/instances/cc6fd964d93f4003851dfc29d57d30a5in14/db-upgrade { "upgrade_type" : "inplace", "target_version": "xxx" } 热补丁升级 实例热补丁升级。 PUT https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/instances/cc6fd964d93f4003851dfc29d57d30a5in14/db-upgrade { "upgrade_type" : "hotfix", "target_version" : "xxxx,xxxx,xxxx", "upgrade_action" : "upgradeAutoCommit" } 实例热补丁升级回退。 PUT https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/instances/cc6fd964d93f4003851dfc29d57d30a5in14/db-upgrade { "upgrade_type": "hotfix", "target_version": "xxxx,xxxx,xxxx", "upgrade_action": "rollback" } 灰度升级 实例灰度升级并采用升级自动提交升级方式升级。 PUT https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/instances/cc6fd964d93f4003851dfc29d57d30a5in14/db-upgrade { "upgrade_type" : "grey", "target_version": "xxx", "upgrade_action" : "upgradeAutoCommit" } 实例灰度升级并采用升级待观察方式升级。 PUT https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/instances/cc6fd964d93f4003851dfc29d57d30a5in14/db-upgrade { "upgrade_type" : "grey", "target_version": "xxx", "upgrade_action" : "upgrade", "upgrade_shard_num" : 1, } 实例灰度升级并采用升级待观察方式升级，当实例处于升级待观察状态中，可进行升级回退，会回退全部已升级的分片，实例恢复正常后回退成功。 PUT https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/instances/cc6fd964d93f4003851dfc29d57d30a5in14/db-upgrade { "upgrade_type" : "grey", "target_version": "xxx", "upgrade_action" : "rollback" } 实例灰度升级并采用升级待观察方式升级，当实例处于升级待观察状态中，且全部分片都升级完成后，可进行升级提交。实例恢复正常后升级完成。 PUT https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/instances/cc6fd964d93f4003851dfc29d57d30a5in14/db-upgrade { "upgrade_type" : "grey", "target_version": "xxx", "upgrade_action" : "commit" } 主备版实例灰度升级并采用升级待观察方式升级传参。 PUT https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/instances/cc6fd964d93f4003851dfc29d57d30a5in14/db-upgrade { "upgrade_type" : "grey", "upgrade_action" : "upgrade", "target_version": "xxx", "upgrade_az" : "az1,az2" }

URI PUT https://{Endpoint}/v3.1/{project_id}/instances/{instance_id}/db-upgrade 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 instance_id 是 String 实例ID，严格匹配UUID规则。

功能介绍 GaussDB 实例版本升级。包括就地升级，灰度升级，热补丁升级三种升级方式。 就地升级 就地升级需要停止业务进行，会一次性升级集群中所有节点。就地升级需要暂停业务30分钟来升级。 灰度升级 每个主DN或者CN组件升级就有一次10秒业务中断。升级过程均是先管理面，再数据面，由备到主的升级方式。灰度升级支持升级自动提交和升级待观察两种操作方式。 升级自动提交：所有节点进程一起升级，在升级过程中有大概10秒的业务中断，不阻塞其他业务操作。 升级待观察：升级待观察，将数据库升级过程细分为升级，提交两个阶段。 升级阶段可以根据部署方式细分为按分片或者按AZ的滚动升级。 分布式实例：根据分片数滚动升级。 主备版实例：根据AZ数进行滚动升级。 提交阶段可以对升级完成后的实例进行业务测试，根据需要可以选择提交升级或者升级回退。 提交升级：在升级完成进入提交阶段时，业务测试正常后提交升级，完成本次升级流程。 升级回退：在升级完成进入提交阶段时，可以根据需要回退本次升级，回退到升级前的版本。 热补丁升级 升级自动提交：热补丁自动升级并提交，中间无业务中断。 升级回退：热补丁回退，无业务中断时间。 调用接口前，您需要了解API 认证鉴权。 调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

注意事项 割接模式下，大版本升级完成后，若发现业务不兼容，需要回退。请联系客服为您解除原实例只读状态后，您可继续使用原实例。 升级完成后新增的数据，原实例不会进行自动同步。 大版本升级完成后，会新建一个实例，原有实例依然保留并计费，在业务稳定后您可以选择释放原有实例。 大版本升级后，原实例的审计日志、错误日志、慢日志仍保留在原实例，新实例只能查看该实例后续生成的日志记录。 只读实例无法进行大版本升级。若当前实例存在只读实例，大版本升级完成后，只读实例不会同步升级，需要重新创建，请参见创建只读实例。 若当前实例存在灾备实例，大版本升级完成后，灾备实例不会同步升级，灾备关系会断开，需要使用同版本实例重新搭建灾备关系。 大版本升级会有以下影响： 使用割接方式升级，升级过程中，原实例会设置为只读，并造成业务分钟级闪断，请在业务低峰期进行升级。使用不割接方式升级时，没有任何影响。 只读设置通过参数“default_transaction_read_only”控制，请检查业务中是否存在修改参数“default_transaction_read_only”的情况，如果存在，则会导致在割接期间实例插入的数据在升级完成后丢失。 大版本升级完成后，参数有以下变化： 原实例中修改的参数，自动同步修改到新版本；没有修改的参数将使用新版本默认参数值。 如果原实例使用了新版本不支持的参数，新版本会自动删除。 如果原实例中参数取值不在新版本对应参数的合法区间，新版本中使用参数模板默认值。 大版本升级不会升级插件版本，参考支持的插件列表，若新版本支持更高版本的插件，您可使用命令ALTER EXTENSION extension_name UPDATE TO 'new_version';更新插件，或者卸载并重新安装最新版本插件。 当数据库进行大版本升级时，部分已安装的插件会导致升级任务失败，请先卸载相关插件后再进行大版本升级。 不支持大版本升级的插件包括：postgis