Merge pull request #203526 from jonels-msft/hsc-replica-promote

Promote replica to R/W

Author: prmerger-automator[bot]

articles/postgresql/hyperscale/concepts-monitoring.md

@@ -6,7 +6,7 @@ author: jonels-msft
 ms.service: postgresql
 ms.subservice: hyperscale-citus
 ms.topic: conceptual
-ms.date: 06/22/2022
+ms.date: 09/27/2022
 ---
 
 # Monitor and tune Azure Database for PostgreSQL - Hyperscale (Citus)
@@ -60,6 +60,7 @@ These metrics are available for Hyperscale (Citus) nodes:
 |memory_percent|Memory percent|Percent|The percentage of memory in use.|
 |network_bytes_ingress|Network In|Bytes|Network In across active connections.|
 |network_bytes_egress|Network Out|Bytes|Network Out across active connections.|
+|replication_lag|Replication Lag|Seconds|How far read replica nodes are behind their counterparts in the primary cluster.|
 |storage_percent|Storage percentage|Percent|The percentage of storage used out of the server's maximum.|
 |storage_used|Storage used|Bytes|The amount of storage in use. The storage used by the service may include the database files, transaction logs, and the server logs.|
 

articles/postgresql/hyperscale/concepts-read-replicas.md

@@ -6,7 +6,7 @@ author: jonels-msft
 ms.service: postgresql
 ms.subservice: hyperscale-citus
 ms.topic: conceptual
-ms.date: 06/17/2022
+ms.date: 09/27/2022
 ---
 
 # Read replicas in Azure Database for PostgreSQL - Hyperscale (Citus)
@@ -85,6 +85,25 @@ psql -h c.myreplica.postgres.database.azure.com -U citus@myreplica -d postgres
 
 At the prompt, enter the password for the user account.
 
+## Replica promotion to independent server group
+
+You can promote a replica to an independent server group that is readable and
+writable. A promoted replica no longer receives updates from its original, and
+promotion can't be undone. Promoted replicas can have replicas of their own.
+
+There are two common scenarios for promoting a replica:
+
+1. **Disaster recovery.** If something goes wrong with the primary, or with an
+   entire region, you can open another server group for writes as an emergency
+   procedure.
+2. **Migrating to another region.** If you want to move to another region,
+   create a replica in the new region, wait for data to catch up, then promote
+   the replica.  To avoid potentially losing data during promotion, you may want
+   to disable writes to the original server group after the replica catches up.
+
+   You can see how far a replica has caught up using the `replication_lag`
+   metric. See [metrics](concepts-monitoring.md#metrics) for more information.
+
 ## Considerations
 
 This section summarizes considerations about the read replica feature.
@@ -110,7 +129,7 @@ upscale it on the primary.
 Firewall rules and parameter settings aren't inherited from the primary server
 to the replica when the replica is created or afterwards.
 
-### Cross-region replication (preview)
+### Cross-region replication
 
 Read replicas can be created in the region of the primary server group, or in
 any other [region supported by Hyperscale (Citus)](resources-regions.md). The

articles/postgresql/hyperscale/howto-read-replicas-portal.md

@@ -6,7 +6,7 @@ author: jonels-msft
 ms.service: postgresql
 ms.subservice: hyperscale-citus
 ms.topic: how-to
-ms.date: 06/17/2022
+ms.date: 09/27/2022
 ---
 
 # Create and manage read replicas in Azure Database for PostgreSQL - Hyperscale (Citus) from the Azure portal
@@ -37,7 +37,7 @@ To create a read replica, follow these steps:
 
 4. Enter a name for the read replica. 
 
-5. Select a value from the **Location (preview)** drop-down.
+5. Select a value from the **Location** drop-down.
 
 6. Select **OK** to confirm the creation of the replica.
 
@@ -66,6 +66,17 @@ steps:
 3. Enter the name of the primary server group to delete. Select **Delete** to
    confirm deletion of the primary server group.
 
+## Promote a replica to an independent server group
+
+To promote a server group replica, follow these steps:
+
+1. In the Azure portal, open the **Replication** page for your server group.
+
+2. Select the **Promote** icon for the desired replica.
+
+3. Select the checkbox indicating you understand the action is irreversible.
+
+4. Select **Promote** to confirm.
 
 ## Delete a replica
 

articles/postgresql/hyperscale/product-updates.md

@@ -7,7 +7,7 @@ ms.custom: mvc
 ms.service: postgresql
 ms.subservice: hyperscale-citus
 ms.topic: conceptual
-ms.date: 07/11/2022
+ms.date: 09/27/2022
 ---
 
 # Product updates for PostgreSQL - Hyperscale (Citus)
@@ -37,9 +37,6 @@ Here are the features currently available for preview:
   session and object audit logging via the standard PostgreSQL
   logging facility. It produces audit logs required to pass
   certain government, financial, or ISO certification audits.
-* **[Cross-region
-  replication](concepts-read-replicas.md#cross-region-replication-preview)**.
-  Create asynchronous read replicas for a server group in different regions.
 
 ## Contact us