升级步骤

前置检查：检查是否已创建PolarDB服务关联角色

在使用逻辑迁移（DTS数据同步）方式进行大版本升级前，请先检查是否已创建PolarDB服务关联角色，以及是否已授予DTS访问云资源的权限。

• 检查是否已创建PolarDB服务关键角色

  1. 使用阿里云账号（主账号）前往RAM控制台的身份管理>角色列表。

  2. 检查角色列表中，是否已存在名为AliyunServiceRoleForPolarDB的服务关联角色，如下：

     • 若存在，请跳过当前检查步骤。

     • 若不存在，则继续执行以下步骤。

  3. 单击创建角色，在打开的创建角色页面中，单击右上角的创建服务关联角色。

  4. 在打开的创建服务关联角色页面中，选择信任的云服务为AliyunServiceRoleForPolarDB，并单击创建服务关联角色以完成创建。

• 检查是否已授予DTS访问云资源的权限

  以下为您展示如何查看授权结果以及快速授权的方式。更多信息，请参见授予DTS访问云资源的权限。

  查看授权结果

  1. 使用阿里云账号（主账号）前往RAM控制台的身份管理>角色列表。

  2. 检查角色列表中，是否已存在名为AliyunDTSDefaultRole的角色，如下：

     1. 若不存在，请前往快速授权。

     2. 若存在，则继续执行以下步骤检查当前角色权限。

  3. 单击角色名称，查看AliyunDTSDefaultRole的详细信息。

     • 当角色AliyunDTSDefaultRole同时满足如下条件时，表示授权成功。

       • 权限管理中包含系统策略AliyunDTSRolePolicy。

         

       • 信任策略中包含dts.aliyuncs.com。

         

     • 当角色AliyunDTSDefaultRole不满足上述条件时，表示授权失败，需要重新授权。您可以删除角色AliyunDTSDefaultRole，重新授权。

  快速授权

  使用阿里云账号（主账号）访问AliyunDTSDefaultRole快捷授权页面，在访问控制快速授权页面中，单击确认授权。

  说明

  • 出现云资源访问授权成功！时，表示已完成授权。

  • 更多授权方式，请参见授予DTS访问云资源的权限。

步骤一：从PolarDB升级迁移

本操作将创建一个与源PolarDB集群数据相同的PolarDB集群，源集群的增量数据会实时同步到该PolarDB集群。

1. 登录PolarDB控制台，单击创建新集群。

2. 计费类型选择包年包月或按量付费。

   • 包年包月：在创建集群时支付计算节点的费用，而存储空间会根据实际数据量按小时计费，并从账户中按小时扣除。

   • 按量付费：无需预先支付费用，计算节点和存储空间（根据实际数据量）均按小时计费，并从账户中按小时扣除。

3. 根据实际使用场景，设置以下参数。

   说明

   以下表格中未详细介绍的参数， 请参考自定义购买。

   参数	说明
   地域	选择源PolarDB PostgreSQL版集群所在地域。
   创建方式	选择从PolarDB升级迁移。
   源PolarDB版本	选择源PolarDB PostgreSQL版集群的版本。
   源PolarDB集群	选择源PolarDB PostgreSQL版集群。
   数据库引擎	选择目标集群的数据库引擎版本。
   产品版本	选择目标集群的产品版本。
   CPU架构	选择目标集群的CPU架构。
   节点个数	建议与源集群的节点个数保持一致。
   当前选择规格	建议与源集群的节点规格保持一致。

4. 在右侧检查集群配置信息，设置购买时长（针对包年包月集群）、购买数量和是否自动续费（针对包年包月集群）。

5. 阅读并勾选服务协议。单击立即购买。针对包年包月集群，还需在支付页面，确认未支付订单信息和支付方式，单击订购。

   说明

   • 支付成功后，请等待10~15分钟创建集群，之后您就可以在集群列表中看到新创建的集群。

   • 当集群中的节点状态为创建中时，整个集群可能仍未创建完成，此时集群不可用。只有当集群状态为运行中时，集群才可以正常使用。

   • 请确认已选中正确的地域，否则无法看到您创建的集群。

6. 集群创建成功后，单击集群ID进入集群基本信息页。

7. 在基本信息页的PolarDB升级功能区域，确认目标PolarDB集群的复制延迟小于60秒即可进行操作。

   说明

   • 已存在DTS双向同步的集群无法进行大版本升级，可能会出现数据不一致问题。

   • 集群创建后，开始从源PolarDB集群同步数据，您需要在30天内完成迁移，超过30天将自动关闭升级功能。

   • 在PolarDB集群创建完成后，若迁移状态变为预检查失败，请根据错误信息中的提示进行处理。例如：

     • 源集群存在没有主键的表，同步数据后可能会导致目标数据库中出现重复数据。您可选择单击跳过当前校验或者给表加上主键之后继续迁移，放弃则单击放弃迁移。

     • 源集群中存在触发器，同步数据后可能会导致目标数据库中出现重复数据。请先删除源集群的触发器，再单击继续迁移，或者单击放弃迁移后手动去DTS控制台页面创建迁移任务。具体可参见源库存在触发器时如何配置同步或迁移作业。

步骤二：地址补齐（可选）

PolarDB大版本升级支持带地址切换，您可保留数据库原连接地址，无需应用程序修改任何连接配置即可切换至新的PolarDB。需要注意，仅当源PolarDB和目标PolarDB集群同时存在的连接地址才支持相互切换，默认情况下目标端仅创建私网主地址和私网集群地址，如果源端包含2个以上的连接地址，您需在切换前在目标端创建好对应的连接地址，否则不会切换。关于如何为PolarDB集群创建连接地址，请参见查看或申请连接地址。

步骤三：升级切换

目标PolarDB集群的复制延迟小于60秒时，即可进行升级切换操作。

1. 在基本信息页面的PolarDB升级功能区域，单击迁移切换。

   说明

   • 一般情况下，升级在5分钟之内即可完成。

   • 该操作将交换源PolarDB集群和目标PolarDB集群的读写状态，即将源PolarDB集群修改为只读，将目标PolarDB集群修改为可读可写。同时，DTS会更换数据复制方向，即将目标PolarDB集群的新增数据同步到源PolarDB集群。

2. 在对话框中，选择带地址切换（应用程序不用改连接配置）或不带地址切换（应用程序需要改为新的PolarDB连接配置）。

   • 若您选择带地址切换（应用程序不用改连接配置），操作步骤如下：

     1. 选中带地址切换（应用程序不用改连接配置）。系统会自动交换源PolarDB和目标PolarDB上的连接地址，您无需在应用程序端修改任何配置即可自动连接到目标PolarDB集群。

        重要

        选择带地址切换（应用程序不用改连接配置）前，请务必阅读带地址切换注意事项。

     2. 单击确定。

   • 若您选择不带地址切换（应用程序需要改为新的PolarDB连接配置），操作步骤如下：

     1. 勾选不带地址切换（应用程序需要改为新的PolarDB连接配置）。

     2. 单击确定。

     3. 刷新页面，当目标PolarDB读写状态显示为读写后，尽快修改应用中的数据库连接地址。

步骤四：完成迁移

完成步骤一：从PolarDB升级迁移后，您需要在30天内完成升级操作。

1. 在基本信息页面的PolarDB升级功能区域，单击完成迁移。

2. 在完成迁移对话框中，可以选择是否设置目标实例的wal_level为默认值replica，并单击确定。

   说明

   • 选择切换wal_level参数设置为默认值replica，会带来少量的写入性能提升。但重置wal_level参数，PolarDB集群会自动重启使新配置生效。

   • 单击确定后，系统将在2分钟之内中断同步关系，升级状态将显示为关闭同步。

   • 如果您选择了切换wal_level，PolarDB集群会自动重启使新配置生效。

   • 如果不再需要源PolarDB集群，可以选择释放源PolarDB集群。

附录：查看数据同步任务详情

在使用逻辑迁移（DTS数据同步）方式进行大版本升级的过程中，若遇到迁移报错（如预检查失败）或者其他异常状态（如复制延迟异常高）时，您可以前往对应的DTS数据同步任务的详情页，查看数据同步任务的具体信息。

1. 在基本信息页面的PolarDB升级功能中，单击DTS数据同步任务的任务名称，进入DTS控制台数据同步列表。

2. 找到对应的数据同步任务，您可查看预检查失败详情、查看同步任务详情、查看同步任务日志等。

3. （可选）迁移过程中，若需要调整同步任务的同步对象（如源集群有新增库时，需要将新增库也纳入同步对象），您可单击修改同步对象重新配置。

附录：迁移回滚

在完成迁移前，如果您发现数据存在异常等问题，可以进行回滚操作，快速恢复至迁移前的状态（源集群为可读可写，目标集群为只读，同时会将目标集群的数据同步到源集群）。

1. 在基本信息页面的PolarDB升级功能区域，单击迁移回滚。

2. 在对话框中，选择带地址回切（应用程序不用改连接配置）或不带地址回切（应用程序需要改为源实例连接配置）。

   • 若您选择带地址回切（应用程序不用改连接配置），操作步骤如下：

     1. 选中带地址回切（应用程序不用改连接配置），系统会自动交换源集群和目标集群上的连接地址，您无需在应用程序端修改任何配置即可自动回切到源集群。

     2. 单击确定。此时源集群为可读可写，目标集群为只读，同时会将目标集群的数据同步到源集群。

   • 若您选择不带地址回切（应用程序需要改为源实例连接配置），操作步骤如下：

     1. 选中不带地址回切（应用程序需要改为源实例连接配置），在迁移切换完成后，您需要尽快修改应用程序端的数据库连接地址。

     2. 单击确定。此时源集群为可读可写，目标集群为只读，同时会将目标集群的数据同步到源集群。

     3. 刷新页面，当源RDS读写状态显示为读写后，请尽快修改应用里的数据库连接地址为源集群连接地址。

附录：取消迁移

若您在大版本升级过程中，因业务等原因不想进行大版本升级时，可进行取消迁移操作。快速恢复至迁移前的状态，即会切断源集群到目标集群的同步链路，源集群和目标集群不再关联。

1. 在基本信息页面的PolarDB升级功能区域，单击取消迁移。

2. 在取消迁移页面的对话框中，您可以选择是否设置目标实例的wal_level为默认值replica，并单击确定。

   

常见问题