Migrate an ApsaraDB for MyBase instance to a different host within your dedicated cluster — in the same zone or across zones, depending on the instance edition.
Constraints and risks
Review the following before starting the migration.
Edition constraints
| Edition | Same-zone migration | Cross-zone migration |
|---|---|---|
| ApsaraDB MyBase for MySQL Master-replica Edition | Supported | Not supported |
| ApsaraDB MyBase for MySQL High-availability Edition | Supported | Supported |
| ApsaraDB MyBase for PostgreSQL | Supported | Supported |
Downtime
All migrations cause approximately 30 seconds of disconnection.
Cross-zone migration risks
If you migrate to a host in a different zone, be aware of the following:
The virtual IP address (VIP) of the instance changes. Use the endpoint — not the IP address — to connect your application to the instance.
If the client cache is full, data cannot be written to the cache until you clear it.
If a Data Transmission Service (DTS) task is running on the instance, restart the DTS task after migration completes.
Migrate an instance
Log in to the ApsaraDB for MyBase console.
In the upper-left corner, select a region.
In the left navigation pane, choose Instances > MySQL.
Find the instance to migrate, then choose More > Migrate in the Actions column.
In the panel that appears, configure the following parameters.
Parameter Description Destination Zone Select the target zone from the drop-down list. The list shows all zones where hosts in the dedicated cluster are deployed. Available only for ApsaraDB MyBase for MySQL High-availability Edition and ApsaraDB MyBase for PostgreSQL instances. vSwitch Select a vSwitch in the destination zone. If no options appear, click Create vSwitch to create one. Available only when migrating a primary instance to a host in a different zone. Destination Host Select a specific host to migrate to. If left blank, the instance is automatically placed on an available host in the specified zone. Optional. Migration Time Choose when to apply the migration: Immediate, Maintenance Window 02:00–06:00, or Specified Time. You can migrate a primary or secondary instance based on your business requirements. To migrate only a primary instance, configure parameters for the primary instance only.
Click OK.