Merge pull request #295373 from MicrosoftDocs/release-psqlflex-backup

Release psqlflex backup -> main -- 2/28 - 11:00AM IST (1:30 PM CST)

Author: Saisang

articles/backup/back-up-azure-database-postgresql-flex-backup-cli.md

@@ -1,17 +1,17 @@
 ---
-title: Manage Azure Backup for Azure PostgreSQL - Flexible servers
+title: Manage backups of Azure Database for PostgreSQL - Flexible Server using Azure portal
 description: Learn about managing backup for the Azure PostgreSQL - Flexible servers from the Azure portal.
 ms.topic: how-to
-ms.date: 03/21/2024
+ms.date: 02/28/2025
 author: jyothisuri
 ms.author: jsuri
 ms.service: azure-backup
 ms.custom: engagement-fy24, ignite-2024
 ---
 
-# Manage Azure Backup for Azure PostgreSQL - Flexible servers (preview)
+# Manage backups of Azure Database for PostgreSQL - Flexible Server using Azure portal
 
-This article explains how to manage backup for the Azure PostgreSQL - Flexible servers from the Azure portal.
+This article describes how to manage backup of Azure Database for PostgreSQL - Flexible Server using Azure portal.
 
 ## Change policy
 
@@ -178,6 +178,7 @@ To delete a PostgreSQL server backup instance, follow these steps:
 
 1. Select **Delete** to confirm and proceed with deleting backup instance.
 
-## Next steps
 
-[Backup vaults overview](backup-vault-overview.md)
+## Next step
+
+[Troubleshoot common errors for backup and restore operations for Azure Database for PostgreSQL - Flexible Server](backup-azure-database-postgresql-flex-troubleshoot.md).

articles/backup/back-up-azure-database-postgresql-flex-backup-powershell.md

@@ -2,15 +2,15 @@
 title: About Azure Database for PostgreSQL Flexible server backup
 description: An overview on Azure Database for PostgreSQL Flexible server backup
 ms.topic: overview
-ms.date: 09/09/2024
+ms.date: 02/28/2025
 ms.service: azure-backup
 ms.custom:
   - ignite-2024
 author: jyothisuri
 ms.author: jsuri
 ---
 
-# About Azure Database for PostgreSQL - Flexible server backup (preview)
+# About Azure Database for PostgreSQL - Flexible Server backup
 
 Azure Backup and Azure Database Services have come together to build an enterprise-class backup solution for Azure Database for PostgreSQL servers that retains backups for up to 10 years. The feature offers the following capabilities:
 
@@ -27,7 +27,7 @@ To perform the backup operation:
 1. Grant permissions to the backup vault MSI on the target ARM resource (PostgreSQL-Flexible server), establishing access, and control. 
 1. Configure backup policies, specify scheduling, retention, and other parameters. 
 
-Once the configuration is complete:
+Once the configuration is successful:
 
 1. The Backup service invokes the backup based on the policy schedules on the ARM API of PostgresFlex server, writing data to a secure blob-container with a SAS for enhanced security. 
 1. Backup runs independently preventing disruptions during long-running tasks. 
@@ -59,4 +59,4 @@ You incur charges for:
 
 ## Next steps
 
-[Azure Database for PostgreSQL -Flex backup](backup-azure-database-postgresql-flex.md).
+[Back up Azure Database for PostgreSQL - Flexible Server using Azure portal](tutorial-create-first-backup-azure-database-postgresql-flex.md).

articles/backup/backup-azure-database-postgresql-flex-manage.md

@@ -1,55 +1,51 @@
 ---
-title: Restore Azure Database for PostgreSQL - flexible server via Azure PowerShell
-description: Learn how to restore Azure Database for PostgreSQL - flexible server using Azure PowerShell.
+title: Restore Azure Database for PostgreSQL - Flexible Server using Azure PowerShell
+description: Learn how to restore Azure Database for PostgreSQL - Flexible Server using Azure PowerShell.
 ms.topic: how-to
-ms.date: 10/01/2024
+ms.date: 02/28/2025
 ms.service: azure-backup
 ms.custom: devx-track-azurepowershell, ignite-2024
 author: jyothisuri
 ms.author: jsuri
 ---
 
-# Restore Azure Database for PostgreSQL - flexible server using Azure PowerShell (preview)
+# Restore Azure Database for PostgreSQL - Flexible Server using Azure PowerShell
 
-This article explains how to restore **Azure Database for PostgreSQL - flexible server** to an Azure Database for PostgreSQL - flexible server backed-up by Azure Backup.
+This article describes how to restore Azure Database for PostgreSQL - Flexible Server using Azure PowerShell.
 
-In this article, you'll learn how to:
+>[!Note]
+>The Original Location Recovery (OLR) option isn't supported for PaaS databases. Instead, use the Alternate-Location Recovery (ALR) to restore from a recovery point and create a new database in the same or another Azure PostgreSQL – Flexible server, keeping both the source and restored databases.
 
-- Restore to create a new PostgreSQL - flexible server
-
-- Track the restore operation status
-
-We'll refer to an existing backup vault _TestBkpVault_ under the resource group _testBkpVaultRG_ in the examples.
+Let's use an existing Backup vault `TestBkpVault`, under the resource group `testBkpVaultRG` in the examples.
 
 ```azurepowershell-interactive
 $TestBkpVault = Get-AzDataProtectionBackupVault -VaultName TestBkpVault -ResourceGroupName "testBkpVaultRG"
 ```
 
-## Restore to create a new PostgreSQL database
+## Set up permissions for restore
 
-### Set up permissions
+Backup vault uses managed identity to access other Azure resources. To restore from backup, Backup vault’s managed identity requires a set of permissions on the Azure PostgreSQL – Flexible Server to which the database should be restored.
 
-Backup vault uses managed identity to access other Azure resources. To restore from backup, Backup vault’s managed identity requires a set of permissions on the storage account to which the server would be restored.
-
-To assign the relevant permissions for vault's system-assigned managed identity on the target storage account, see the [set of permissions needed to backup Azure PostgreSQL database](./backup-azure-database-postgresql-overview.md#set-of-permissions-needed-for-azure-postgresql-database-restore).
+To assign the relevant permissions for vault's system-assigned managed identity on the target PostgreSQL – Flexible Server, check the [set of permissions](backup-azure-database-postgresql-flex-overview.md#azure-backup-authentication-with-the-postgresql-server) needed to backup Azure PostgreSQL – Flexible Server database.
 
 To restore the recovery point as files to a storage account, the [Backup vault's system-assigned managed identity needs access on the target storage account](./restore-azure-database-postgresql.md#restore-permissions-on-the-target-storage-account).
 
-### Fetching the relevant recovery point
+## Fetch the relevant recovery point
 
-Fetch all instances using [Get-AzDataProtectionBackupInstance](/powershell/module/az.dataprotection/get-azdataprotectionbackupinstance) command and identify the relevant instance.
+Fetch all instances using [Get-AzDataProtectionBackupInstance](/powershell/module/az.dataprotection/get-azdataprotectionbackupinstance) cmdlet and identify the relevant instance.
 
 ```azurepowershell-interactive
 $AllInstances = Get-AzDataProtectionBackupInstance -ResourceGroupName "testBkpVaultRG" -VaultName $TestBkpVault.Name
+
 ```
 
-You can also use **Az.Resourcegraph** and the [Search-AzDataProtectionBackupInstanceInAzGraph](/powershell/module/az.dataprotection/search-azdataprotectionbackupinstanceinazgraph) command to search recovery points across instances in many vaults and subscriptions.
+You can also use `Az.Resourcegraph` and the [Search-AzDataProtectionBackupInstanceInAzGraph](/powershell/module/az.dataprotection/search-azdataprotectionbackupinstanceinazgraph) cmdlet to search recovery points across instances in many vaults and subscriptions.
 
 ```azurepowershell-interactive
 $AllInstances = Search-AzDataProtectionBackupInstanceInAzGraph -ResourceGroupName "testBkpVaultRG" -VaultName $TestBkpVault.Name -DatasourceType AzureDatabaseForPGFlexServer -ProtectionStatus ProtectionConfigured
 ```
 
-To filter the search criteria, use the PowerShell client search capabilities as shown below:
+To filter the search criteria, use the following PowerShell client search capabilities:
 
 ```azurepowershell-interactive
 Search-AzDataProtectionBackupInstanceInAzGraph -ResourceGroupName "testBkpVaultRG" -VaultName $TestBkpVault.Name -DatasourceType AzureDatabaseForPGFlexServer -ProtectionStatus ProtectionConfigured | Where-Object { $_.BackupInstanceName -match "testpgflex"}
@@ -61,64 +57,66 @@ Once the instance is identified, fetch the relevant recovery point.
 $rp = Get-AzDataProtectionRecoveryPoint -ResourceGroupName "testBkpVaultRG" -VaultName $TestBkpVault.Name -BackupInstanceName $AllInstances[2].BackupInstanceName
 ```
 
-### Prepare the restore request
+## Prepare the restore request
 
-You can restore the recovery point for a PostgreSQL – Flexible server database as files only.
+You can restore the recovery point for a PostgreSQL – Flexible Server database as files only.
 
-#### Restore as files
+### Restore as files
 
-Fetch the URI of the container, within the storage account to which permissions were assigned as detailed [above](#set-up-permissions). For example, a container named **testcontainerrestore** under a storage account **testossstorageaccount** with a different subscription.
+Fetch the Uniform Resource Identifier (URI) of the container, within the storage account to which permissions were assigned. For example, a container named `testcontainerrestore` under a storage account `testossstorageaccount` with a different subscription.
 
 ```azurepowershell-interactive
 $contURI = "https://testossstorageaccount.blob.core.windows.net/testcontainerrestore"
 ```
 
-Use the [Initialize-AzDataProtectionRestoreRequest](/powershell/module/az.dataprotection/initialize-azdataprotectionrestorerequest) command to prepare the restore request with all relevant details.
+Use the [Initialize-AzDataProtectionRestoreRequest](/powershell/module/az.dataprotection/initialize-azdataprotectionrestorerequest) cmdlet to prepare the restore request with all relevant details.
 
 ```azurepowershell-interactive
-$OssRestoreAsFilesReq = Initialize-AzDataProtectionRestoreRequest -DatasourceType AzureDatabaseForPGFlexServer -SourceDataStore VaultStore -RestoreLocation $TestBkpVault.Location -RestoreType RestoreAsFiles -RecoveryPoint $rps[0].Property.RecoveryPointId -TargetContainerURI $contURI -FileNamePrefix "testpgflex-westus_1628853549768" 
+$OssRestoreAsFilesReq = Initialize-AzDataProtectionRestoreRequest -DatasourceType AzureDatabaseForPGFlexServer -SourceDataStore VaultStore -RestoreLocation $TestBkpVault.Location -RestoreType RestoreAsFiles -RecoveryPoint $rps[0].Property.RecoveryPointId -TargetContainerURI $contURI -FileNamePrefix "empdb11_postgresql-westus_1628853549768"
 ```
 
-### Trigger the restore
+>[!Note]
+>After the restore to the target storage account is complete , you can use the pg_restore utility to restore an Azure Database for PostgreSQL – Flexible Server database from the target.
 
-Use the [Start-AzDataProtectionBackupInstanceRestore](/powershell/module/az.dataprotection/start-azdataprotectionbackupinstancerestore) command to trigger the restore with the request prepared above.
+To connect to an existing PostgreSQL – Flexible Server and an existing database, use the following cmdlet:
 
 ```azurepowershell-interactive
-Start-AzDataProtectionBackupInstanceRestore -BackupInstanceName $AllInstances[2].BackupInstanceName -ResourceGroupName "testBkpVaultRG" -VaultName $TestBkpVault.Name -Parameter $OssRestoreReq
+pg_restore -h <hostname> -U <username> -d <db name> -Fd -j <NUM> -C <dump directory>
 ```
 
-## Tracking job
+In this script:
 
-Track all the jobs using the [Get-AzDataProtectionJob](/powershell/module/az.dataprotection/get-azdataprotectionjob) command. You can list all jobs and fetch a particular job detail.
+- `-Fd`: The directory format.
+- `-j`: The number of jobs.
+- `-C`: Starts the output with a cmdlet to create the database itself and then reconnect to it.
 
-You can also use *Az.ResourceGraph* to track jobs across all Backup vaults. Use the [Search-AzDataProtectionJobInAzGraph](/powershell/module/az.dataprotection/search-azdataprotectionjobinazgraph) command to get the relevant job, which is across all backup vault.
+The following example shows how the syntax might appear:
 
 ```azurepowershell-interactive
-$job = Search-AzDataProtectionJobInAzGraph -Subscription $sub -ResourceGroupName "testBkpVaultRG" -Vault $TestBkpVault.Name -DatasourceType AzureDatabaseForPGFlexServer -Operation OnDemandBackup
+pg_restore -h <hostname> -U <username> -j <Num of parallel jobs> -Fd -C -d <databasename> sampledb_dir_format
 ```
 
-### Create PostgreSQL - flexible server from restored storage account
+If you have more than one database to restore, rerun the earlier cmdlet for each database.
+Also, by using multiple concurrent jobs `-j`, you can reduce the restore time of a large database on a **multi-vCore** target server. The number of jobs can be equal to or less than the number of `vCPUs` allocated for the target server.
 
-Post restoration completion to the target storage account, you can use **pg_restore** utility to restore an Azure Database for PostgreSQL – Flexible server database from the target. Use the following command to connect to an existing PostgreSQL – Flexible server and an existing database.
+## Trigger the restore
+
+To trigger the restore operation with the prepared request, use the [`Start-AzDataProtectionBackupInstanceRestore`](/powershell/module/az.dataprotection/start-azdataprotectionbackupinstancerestore) cmdlet 
 
 ```azurepowershell-interactive
-pg_restore -h <hostname> -U <username> -d <db name> -Fd -j <NUM> -C <dump directory>
+Start-AzDataProtectionBackupInstanceRestore -BackupInstanceName $AllInstances[2].BackupInstanceName -ResourceGroupName "testBkpVaultRG" -VaultName $TestBkpVault.Name -Parameter $OssRestoreReq
 ```
 
--Fd: The directory format.
--j: The number of jobs.
--C: Begin the output with a command to create the database itself and then reconnect to it.
+## Track jobs
+
+Track all jobs by using the [`Get-AzDataProtectionJob`](/powershell/module/az.dataprotection/get-azdataprotectionjob) cmdlet. You can list all jobs and fetch a particular job detail.
 
-Here's an example of how this syntax might appear:
+You can also use `Az.ResourceGraph` to track jobs across all Backup vaults. Use the [`Search-AzDataProtectionJobInAzGraph`](/powershell/module/az.dataprotection/search-azdataprotectionjobinazgraph) cmdlet to get the relevant job that is across all Backup vaults.
 
 ```azurepowershell-interactive
-pg_restore -h <hostname> -U <username> -j <Num of parallel jobs> -Fd -C -d <databasename> sampledb_dir_format
+$job = Search-AzDataProtectionJobInAzGraph -Subscription $sub -ResourceGroupName "testBkpVaultRG" -Vault $TestBkpVault.Name -DatasourceType AzureDatabaseForPGFlexServer -Operation OnDemandBackup
 ```
 
-If you have more than one database to restore, re-run the earlier command for each database.
-
-Also, by using multiple concurrent jobs -j, you can reduce the time it takes to restore a large database on a multi-vCore target server. The number of jobs can be equal to or less than the number of vCPUs that are allocated for the target server.
-
 ## Next steps
 
-- [Azure PostgreSQL - flexible server Backup](backup-azure-database-postgresql-flex-overview.md)
+[Troubleshoot common errors for backup and restore operations for Azure Database for PostgreSQL - Flexible Server](backup-azure-database-postgresql-flex-troubleshoot.md).

articles/backup/backup-azure-database-postgresql-flex-overview.md

@@ -2,45 +2,45 @@
 title: Azure Database for PostgreSQL- Flexible server support matrix
 description: Provides a summary of support settings and limitations of Azure Database for PostgreSQL- Flexible server backup.
 ms.topic: reference
-ms.date: 12/17/2024
+ms.date: 02/28/2025
 ms.custom: references_regions, ignite-2024
 ms.service: azure-backup
 author: jyothisuri
 ms.author: jsuri
 ---
 
-# Support matrix for Azure Database for PostgreSQL- Flexible server (preview)
+# Support matrix for Azure Database for PostgreSQL- Flexible Server
 
-You can use [Azure Backup](./backup-overview.md) to protect Azure Database for PostgreSQL- Flexible server. This article summarizes supported regions, scenarios, and the limitations.
+You can use [Azure Backup](./backup-overview.md) to protect Azure Database for PostgreSQL- Flexible Server. This article summarizes supported regions, scenarios, and the limitations.
 
 ## Supported regions
 
-Azure Database for PostgreSQL - Flexible server backup is now available in all public regions.
+Azure Database for PostgreSQL - Flexible server backup is generally available in the following regions: East Asia, Central India, Southeast Asia, UK South, and UK West. However, this feature is currently in preview for other regions.
 
 ## Support scenarios
 
-- PostgreSQL Flexible Server backup data can be recovered in user specified storage containers that can be used to rebuild the PostgreSQL flexible server. You can restore this data as a new PostgreSQL - flexible server with the database native tools.
+Consider the following support scenarios when you back up Azure Database for PostgreSQL – Flexible Server:
 
+- Vaulted backup restores are only available as **Restore to Files** in user specified storage containers. You can restore this data as a new PostgreSQL - flexible server with the database native tools.
 - Backups for the PostgreSQL server are supported when the Backup Vault is in the same or a different subscription as the database, provided they are within the same tenant and region. Restores are supported across regions (Azure Paired) and across subscriptions within the same tenant.
-
-- Recommended limit for the maximum server size is 4 TB.  
-
+- For vaulted backups, entire server is backed up with all databases. Backup of specific databases isn't supported.
+- Recommended limit for the maximum server size is **1 TB**. While backups can be attempted on server size exceeding 1 TB, which aren't officially supported, and the success of vaulted backups for such server can't be guaranteed.
 - PostgreSQL - Flexible servers encrypted by Customer Managed Key are supported.
-
-- Private endpoint-enabled Azure PostgreSQL flexible servers can be backed up by allowing trusted Microsoft services in the network settings.
-
-- Backups for PGSQLFlex will exclude databases owned by `azuresu` or `azure_pg_admin`, including the native `postgres` database. As a result, databases with these owners cannot be backed up or restored. 
-
+- Private endpoint-enabled Azure Database for PostgreSQL - Flexible servers can be backed up by allowing trusted Microsoft services in the network settings.
+- Backups for PostgreSQL Flexible servers exclude databases owned by `azuresu` or `azure_pg_admin`, including the native PostgreSQL database. So, databases with these owners can't be backed up or restored.
 
 ## Limitation
 
--  Currently, restoring backups directly to flexible server isn't supported.
+Azure Database for PostgreSQL – Flexible Server backups include the following limitations:
 
--  Currently, backing up individual databases isn't supported. You can only back up the entire server.
+- Vaulted backup doesn't support storage in archive tier.
+- Vaulted backup isn't supported on replicas; backup can be configured only on primary servers.
+- For restore operation, item level recovery (recovery of specific databases) isn't supported.
+- Weekly backups are supported for only one day in the week on which backup is initiated.
+- Vaulted backups don't support tables containing a row with **BYTEA length exceeding 500 MB**.
 
-- Only weekly backups are supported with option to opt for only one day in the week on which backup is initiated. 
 
 
 ## Next steps
 
-- [Back up Azure Database for PostgreSQL -flex server](backup-azure-database-postgresql-flex.md).
+- [Back up Azure Database for PostgreSQL -Flexible Server using Azure portal](tutorial-create-first-backup-azure-database-postgresql-flex.md).