All Products
Search

This Product

    PolarDB:Switch between primary and secondary instances

    Document Center

    PolarDB:Switch between primary and secondary instances

    Last Updated:Jan 29, 2026

    This topic describes how to switch between primary and secondary instances in a Global Database Network (GDN).

    Applicability

    The GDN service is enabled and a secondary instance is added. For more information, see Enable the GDN service.

    Procedure

    Find the target GDN.

    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 the Upgrade to Primary Instance button in the Actions column.

      Note

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

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

      image.png

      Note

      In multi-master mode, DDL synchronization is one-way, from the primary instance to the secondary instance. When the roles of the instances are switched, the direction of DDL synchronization is also reversed.