切换

流程说明

注意事项

带地址切换：

• PolarDB-X 1.0实例版本需为5.3.8-15489913及以上。

• 1.0所有数据库的迁移必须在同一个迁移任务中。

• 带地址迁移只会修改连接地址，不会修改实例名，根据实例名配置的业务仍需手动进行调整（例如DMS、DTS、DataWorks等）。

• 带地址迁移要求源和目标端端口一致。

• 带地址迁移默认会修改两侧的私网主地址和公网主地址，不会修改只读地址，如有只读实例请单独处理。

• 切换域名后需等待业务侧DNS缓存失效才可连接至新数据库，一般需30秒至5分钟，可选择手动刷新业务服务器的DNS缓存加速失效。

普通切换（不带地址切换）：

• PolarDB-X 1.0实例版本需为5.3.8-15489913及以上。如版本不符合要求，请联系我们。

• 单击开始正向切换会禁写源库60分钟，请在60分钟内完成地址修改或采用其它禁写手段保持禁写。

• 为确保业务侧修改连接地址的完备性，建议您在修改地址前将对应写权限回收。防止漏改情况下，迁移两侧实例双写，导致数据不一致。

操作步骤

1. 在迁移任务详情页，单击左侧导航栏中的切换详情。

2. 等待正向同步延迟较小时，单击开始正向切换，将业务由1.0切换至2.0。

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

   • 若您选择带地址切换，后续操作步骤如下：

     1. 选中带地址切换并单击确定。系统会禁写源库60分钟并等待正向同步完成，即目标库与源库数据一致。数据一致后，系统会自动将PolarDB-X 2.0的连接地址修改为PolarDB-X 1.0的连接地址。

        说明

        此步骤耗时约2分钟。

     2. 连接地址修改完成后，待应用侧DNS缓存失效，您无需在应用程序端修改任何配置即可自动连接到PolarDB-X 2.0。

        说明

        此步骤耗时取决于业务侧DNS缓存失效时间，通常为2分钟内。您可以在应用侧手动刷新DNS缓存，加速地址修改生效。

     3. 持续观察源库，确认所有应用已自动连接至PolarDB-X 2.0后， 单击确定源库无业务连接，解除源库的禁写，启动用于回滚的反向同步链路。

        说明

        您可以使用show processlist命令查看IP，确定是否有来自业务侧的连接。

   • 若您选择不带地址切换，后续操作步骤如下：

     1. 选中不带地址切换并单击确定。系统会禁写源库60分钟并等待正向同步完成，即目标库与源库数据一致。

     2. 数据一致后，前端会提示“可以开启手动切换业务侧连接串”。此时修改业务侧连接串，将应用连接至PolarDB-X 2.0。

        说明

        如您在60分钟内无法完成修改业务连接串操作，可以自行用修改权限等方式确保源库在切换过程中保持禁写。

     3. 持续观察源库，确认所有应用已连接至目标PolarDB-X 2.0后， 单击确定源库无业务连接，解除源库的禁写，启动用于回滚的反向同步链路。

        说明

        您可以使用show processlist命令查看IP，确定是否有来自业务侧的连接。