All Products
Search
Document Center

PolarDB:Switch between primary and secondary instances

Last Updated:Mar 28, 2026

Promote a secondary instance to primary in a Global Database Network (GDN).

Prerequisites

Before you begin, make sure you have:

Promote a secondary instance to primary

  1. Log on to the PolarDB for X-Engine console. In the navigation pane on the left, click GDN.

  2. On the GDN list page, find the target Secondary Instance and click Upgrade to Primary Instance in the Actions column.

    Note

    Alternatively, click the target GDN ID to open the GDN details page, then find the Secondary Instance and click Upgrade to Primary Instance in the Actions column.

  3. In the Upgrade to Primary Instance dialog box, select a switchover method and click OK.

    image.png

After the switchover

If your GDN uses multi-master mode, DDL synchronization runs one-way from the primary instance to the secondary instance. After the switchover, this direction reverses — the new primary pushes DDL changes to the secondary instance. Review any applications or pipelines that depend on this sync direction.