AlloyDB Omni cross-data-center replication lets you create secondary database
clusters and instances from a primary database cluster to make the resources available in
different data centers, in the event of an outage in the primary data center. These
secondary database clusters function as copies of your primary database cluster resources.
Key concepts in this page include the following:
Primary database cluster. A read-write database cluster in a single data center.
Secondary database cluster. A read-only database cluster in a different data center than the primary,
that replicates from the primary database cluster asynchronously.
In the event of a failure of an AlloyDB Omni primary database cluster, you can
promote a secondary database cluster to a primary database cluster.
Benefits
The benefits of cross-data-center replication on AlloyDB Omni include the
following:
Disaster recovery. In the event the primary database cluster's data center becomes
unavailable, you can promote AlloyDB Omni resources in another data center
to serve requests.
Geographically distributed data. Distributing the data geographically brings
the data closer to you and decreases read latency.
Geographic load balancing. In the event of slow or overloaded connections
in one data center, you can route traffic to another data center.
Improved read performance. It makes AlloyDB Omni resources
available closer to your application's data center.
Switchover. You can perform a switchover for testing your disaster recovery setup or performing migration of your workload.
How to work with cross-data-center replication
Working with AlloyDB Omni cross-data-center replication involves the following tasks:
Promote a secondary database cluster.
You can read the data in a secondary database cluster but cannot write to it until you promote it to a primary database cluster.
There are two common scenarios for promoting your secondary database cluster to a primary database
cluster:
Data center migration. Perform a planned migration of the AlloyDB Omni
resources from their primary data center to another data center.
Disaster recovery. Rapidly activate the AlloyDB Omni resources
in a secondary data center in the event that the resources in the primary data center
become unavailable. Due to replication lag, some data loss might occur.
Promoting a secondary database cluster converts it to a standalone fully functional database cluster with read and write capabilities. The promoted database cluster no longer replicates the data from the primary database cluster it was formerly associated with.
Switchover.
Switchover lets you reverse the roles of your primary and secondary database cluster. You can perform a switchover for testing your disaster recovery setup or performing migration of your workload. When you complete the switchover, the direction of replication is reversed.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eAlloyDB Omni cross-data-center replication enables the creation of secondary, read-only database clusters in different data centers that mirror the primary database cluster, ensuring resource availability during primary data center outages.\u003c/p\u003e\n"],["\u003cp\u003eThe main benefits of cross-data-center replication include disaster recovery, geographically distributed data, geographic load balancing, and enhanced read performance by placing resources closer to the application's data center.\u003c/p\u003e\n"],["\u003cp\u003eSecondary database clusters can be promoted to primary in scenarios such as data center migration or disaster recovery, granting them full read and write capabilities, and can no longer replicate data.\u003c/p\u003e\n"],["\u003cp\u003eSwitchover allows for the reversal of roles between primary and secondary database clusters, useful for disaster recovery testing and workload migration.\u003c/p\u003e\n"]]],[],null,["# About cross-data-center replication\n\nSelect a documentation version: 15.7.1keyboard_arrow_down\n\n- [Current (16.8.0)](/alloydb/omni/current/docs/cross-data-center-replication/about-cross-data-center-replication)\n- [16.8.0](/alloydb/omni/16.8.0/docs/cross-data-center-replication/about-cross-data-center-replication)\n- [16.3.0](/alloydb/omni/16.3.0/docs/cross-data-center-replication/about-cross-data-center-replication)\n- [15.12.0](/alloydb/omni/15.12.0/docs/cross-data-center-replication/about-cross-data-center-replication)\n- [15.7.1](/alloydb/omni/15.7.1/docs/cross-data-center-replication/about-cross-data-center-replication)\n- [15.7.0](/alloydb/omni/15.7.0/docs/cross-data-center-replication/about-cross-data-center-replication)\n- [15.5.5](/alloydb/omni/15.5.5/docs/cross-data-center-replication/about-cross-data-center-replication)\n- [15.5.4](/alloydb/omni/15.5.4/docs/cross-data-center-replication/about-cross-data-center-replication)\n- [15.5.2](/alloydb/omni/15.5.2/docs/cross-data-center-replication/about-cross-data-center-replication)\n\n\u003cbr /\u003e\n\nThis page provides an overview of AlloyDB Omni cross-data-center replication.\n\n\u003cbr /\u003e\n\nAlloyDB Omni cross-data-center replication lets you create secondary database\nclusters and instances from a primary database cluster to make the resources available in\ndifferent data centers, in the event of an outage in the primary data center. These\nsecondary database clusters function as copies of your primary database cluster resources.\n\nKey concepts in this page include the following:\n\n- **Primary database cluster.** A read-write database cluster in a single data center.\n- **Secondary database cluster.** A read-only database cluster in a different data center than the primary, that replicates from the primary database cluster asynchronously. In the event of a failure of an AlloyDB Omni primary database cluster, you can promote a secondary database cluster to a primary database cluster.\n\nBenefits\n--------\n\nThe benefits of cross-data-center replication on AlloyDB Omni include the\nfollowing:\n\n- **Disaster recovery.** In the event the primary database cluster's data center becomes\n unavailable, you can promote AlloyDB Omni resources in another data center\n to serve requests.\n\n- **Geographically distributed data.** Distributing the data geographically brings\n the data closer to you and decreases read latency.\n\n- **Geographic load balancing.** In the event of slow or overloaded connections\n in one data center, you can route traffic to another data center.\n\n- **Improved read performance.** It makes AlloyDB Omni resources\n available closer to your application's data center.\n\n- **Switchover.** You can perform a switchover for testing your disaster recovery setup or performing migration of your workload.\n\nHow to work with cross-data-center replication\n----------------------------------------------\n\nWorking with AlloyDB Omni cross-data-center replication involves the following tasks:\n\n- [**Create a secondary database cluster.**](/alloydb/omni/15.7.1/docs/cross-data-center-replication/work-with-cross-data-center-replication#secondary-db-cluster-instance)\n A secondary database cluster is a continuously updated copy of your AlloyDB Omni\n primary cluster.\n\n- [**View a secondary database cluster.**](/alloydb/omni/15.7.1/docs/cross-data-center-replication/work-with-cross-data-center-replication#view-secondary-cluster)\n After you create a secondary database cluster, you can view its status and replication status.\n\n- [**Promote a secondary database cluster.**](/alloydb/omni/15.7.1/docs/cross-data-center-replication/work-with-cross-data-center-replication#promote-secondary-cluster)\n You can read the data in a secondary database cluster but cannot write to it until you promote it to a primary database cluster.\n\n There are two common scenarios for promoting your secondary database cluster to a primary database\n cluster:\n - **Data center migration.** Perform a planned migration of the AlloyDB Omni\n resources from their primary data center to another data center.\n\n - **Disaster recovery.** Rapidly activate the AlloyDB Omni resources\n in a secondary data center in the event that the resources in the primary data center\n become unavailable. Due to replication lag, some data loss might occur.\n\n Promoting a secondary database cluster converts it to a standalone fully functional database cluster with read and write capabilities. The promoted database cluster no longer replicates the data from the primary database cluster it was formerly associated with.\n- [**Switchover.**](/alloydb/omni/15.7.1/docs/cross-data-center-replication/work-with-cross-data-center-replication#switchover-secondary)\n Switchover lets you reverse the roles of your primary and secondary database cluster. You can perform a switchover for testing your disaster recovery setup or performing migration of your workload. When you complete the switchover, the direction of replication is reversed.\n\nWhat's next\n-----------\n\n- [Work with cross-data-center replication](/alloydb/omni/15.7.1/docs/cross-data-center-replication/work-with-cross-data-center-replication)"]]