Merge pull request #230316 from MikeRayMSFT/20230310-add-postgres-features

Update features for PostgreSQL

Author: denrea

articles/azure-arc/data/backup-restore-postgresql.md

@@ -1,47 +1,41 @@
 ---
-title: Backup and restore for Azure Database for PostgreSQL server
-description: Explains how to back up and restore for Azure Database for PostgreSQL servers
+title: Automated backup for Azure Arc-enabled PostgreSQL server
+description: Explains how to configure backups for Azure Arc-enabled PostgreSQL server
 services: azure-arc
 ms.service: azure-arc
 ms.subservice: azure-arc-data-postgresql
 author: dhanmm
 ms.author: dhmahaja
 ms.reviewer: mikeray
-ms.date: 11/03/2021
+ms.date: 03/12/2023
 ms.topic: how-to
 ---
 
-# Back up and restore Azure Arc-enabled PostgreSQL servers
+# Automated backup Azure Arc-enabled PostgreSQL servers
 
-Automated backups can be enabled by including the `--storage-class-backups` argument when creating an Azure Arc-enabled PostgreSQL server. Specify the retention period for backups with the `--retention-days` parameter, when creating or updating an Arc-enabled PostgreSQL server. The retention period can be between 0 and 35 days. If backups are enabled but no retention period is specified, the default is seven days.
+To enable automated backups, include the `--storage-class-backups` argument when you create an Azure Arc-enabled PostgreSQL server. Specify the retention period for backups with the `--retention-days` parameter. Use this parameter when you create or update an Arc-enabled PostgreSQL server. The retention period can be between 0 and 35 days. If backups are enabled but no retention period is specified, the default is seven days.
 
-Restoring an Azure Arc-enable PostgreSQL server creates a new server by copying the configuration of the existing server (for example resource requests/limits, extensions etc.). Configurations that could cause conflicts (for example primary endpoint port) aren't copied. The storage configuration for the new resource can be defined by passing `--storage-class*` and `--volume-size-*` parameters to the `restore` command.
+Additionally, if you set the retention period to zero, then automated backups are disabled. 
 
-Restore an Azure Arc-enabled PostgreSQL server to a new server with the `restore` command:
-```azurecli
-az postgres server-arc restore -n <destination-server-name> --source-server <source-server-name> --k8s-namespace <namespace> --use-k8s
-```
+[!INCLUDE [azure-arc-data-preview](../../../includes/azure-arc-data-preview.md)]
 
-## Examples:
+## Create server with automated backup
 
-Create a new Arc-enabled PostgreSQL server `pg02` by restoring `pg01` using the latest backups:
-```azurecli
-az postgres server-arc restore -n pg02 --source-server pg01 --k8s-namespace arc --use-k8s
-```
+Create an Azure Arc-enabled PostgreSQL server with automated backups: 
 
-Create a new Arc-enabled PostgreSQL server `pg02` by restoring `pg01` using the latest backups, defining new storage requirements for pg02:
 ```azurecli
-az postgres server-arc restore -n pg02 --source-server pg01 --k8s-namespace arc --storage-class-data azurefile-csi-premium --volume-size-data 10Gi --storage-class-logs azurefile-csi-premium --volume-size-logs 2Gi--use-k8s --storage-class-backups azurefile-csi-premium --volume-size-backups 15Gi
+az postgres server-arc create -n <name> -k <namespace> --storage-class-backups <storage-class> --retention-days <number of days> --use-k8s 
 ```
 
-Create a new Arc-enabled PostgreSQL server `pg02` by restoring `pg01` to its state at `2023-02-01T00:00:00Z`:
-```azurecli
-az postgres server-arc restore -n pg02 --source-server pg01 --k8s-namespace arc -t 2023-02-01T00:00:00Z --use-k8s
-```
+## Update a server to set retention period
+
+Update the backup retention period for an Azure Arc-enabled PostgreSQL server: 
 
-For details about all the parameters available for restore review the output of the command:
 ```azurecli
-az postgres server-arc restore --help
+az postgres server-arc update -n pg01 -k test --retention-days <number of days> --use-k8s 
 ```
 
-- Read about [scaling up or down (increasing/decreasing memory/vcores)](scale-up-down-postgresql-server-using-cli.md) your server.
+## Next steps
+
+- [Restore Azure Arc-enabled PostgreSQL servers](restore-postgresql.md)
+- [Scaling up or down (increasing/decreasing memory/vcores)](scale-up-down-postgresql-server-using-cli.md) your server.

articles/azure-arc/data/configure-security-postgresql.md

@@ -169,6 +169,10 @@ To configure roles and users in your Azure Arc-enabled PostgreSQL server, use th
 
 For audit scenarios please configure your server group to use the `pgaudit` extensions of Postgres. For more details about `pgaudit` see [`pgAudit` GitHub project](https://github.com/pgaudit/pgaudit/blob/master/README.md). To enable the `pgaudit` extension in your server group read [Use PostgreSQL extensions](using-extensions-in-postgresql-server.md).
 
+## Use SSL connection
+
+SSL is required for client connections. In connection string, the SSL mode parameter should not be disabled. [Form connection strings](get-connection-endpoints-and-connection-strings-postgresql-server.md#form-connection-strings).
+
 ## Next steps
 - See [`pgcrypto` extension](https://www.postgresql.org/docs/current/pgcrypto.html)
 - See [Use PostgreSQL extensions](using-extensions-in-postgresql-server.md)

articles/azure-arc/data/deploy-active-directory-postgresql-server-cli.md

@@ -28,6 +28,8 @@ Before you proceed, install the following tools:
 
 To know more further details about how to set up OU and AD account, go to [Deploy Azure Arc-enabled data services in Active Directory authentication - prerequisites](active-directory-prerequisites.md)
 
+> [!IMPORTANT]
+> When using Active Directory, the default account must be named "postgres" in order for connections to succeed.
 
 ## Deploy and update Active Directory integrated Azure Arc-enabled PostgreSQL server
 

articles/azure-arc/data/get-connection-endpoints-and-connection-strings-postgresql-server.md

@@ -64,6 +64,7 @@ Use these end points to:
 - Access the Grafana and Kibana dashboards from your browser
 
 For example, you can use the end point named _PostgreSQL Instance_ to connect with psql to your server group:
+
 ```console
 psql postgresql://postgres:[email protected]:5432
 psql (10.14 (Ubuntu 10.14-0ubuntu0.18.04.1), server 12.4 (Ubuntu 12.4-1.pgdg16.04+1))
@@ -80,6 +81,7 @@ postgres=#
 
 
 ## From CLI with kubectl
+
 ```console
 kubectl get postgresqls/<server name> -n <namespace name>
 ```
@@ -100,6 +102,9 @@ postgres01   Ready   3/3          12.345.567.89:5432   9d
 
 Use the connections string examples below for your server group. Copy, paste, and customize them as needed:
 
+> [!IMPORTANT]
+> SSL is required for client connections. In connection string, the SSL mode parameter should not be disabled. For more information, review [https://www.postgresql.org/docs/14/runtime-config-connection.html](https://www.postgresql.org/docs/14/runtime-config-connection.html).
+
 ### ADO.NET
 
 ```ado.net

articles/azure-arc/data/restore-postgresql.md

@@ -0,0 +1,61 @@
+---
+title: Restore Azure Arc-enabled PostgreSQL server
+description: Explains how to restore Arc-enabled PostgreSQL server. You can restore to a point-in-time or restore a whole server.
+services: azure-arc
+ms.service: azure-arc
+ms.subservice: azure-arc-data-postgresql
+author: dhanmm
+ms.author: dhmahaja
+ms.reviewer: mikeray
+ms.date: 03/13/2023
+ms.topic: how-to
+---
+
+# Restore Azure Arc-enabled PostgreSQL servers
+
+Restoring an Azure Arc-enable PostgreSQL server creates a new server by copying the configuration of the existing server (for example resource requests/limits, extensions etc.). Configurations that could cause conflicts (for example primary endpoint port) aren't copied. The storage configuration for the new resource can be defined by passing `--storage-class*` and `--volume-size-*` parameters to the `restore` command.
+
+[!INCLUDE [azure-arc-data-preview](../../../includes/azure-arc-data-preview.md)]
+
+Restore an Azure Arc-enabled PostgreSQL server to a new server with the `restore` command:
+
+```azurecli
+az postgres server-arc restore -n <destination-server-name> --source-server <source-server-name> --k8s-namespace <namespace> --use-k8s
+```
+
+## Examples
+
+### Restore using latest backups
+
+Create a new Arc-enabled PostgreSQL server `pg02` by restoring `pg01` using the latest backups:
+
+```azurecli
+az postgres server-arc restore -n pg02 --source-server pg01 --k8s-namespace arc --use-k8s
+```
+
+### Restore using latest backup and modify the storage requirement
+
+Create a new Arc-enabled PostgreSQL server `pg02` by restoring `pg01` using the latest backups, defining new storage requirements for pg02:
+
+```azurecli
+az postgres server-arc restore -n pg02 --source-server pg01 --k8s-namespace arc --storage-class-data azurefile-csi-premium --volume-size-data 10Gi --storage-class-logs azurefile-csi-premium --volume-size-logs 2Gi--use-k8s --storage-class-backups azurefile-csi-premium --volume-size-backups 15Gi
+```
+
+### Restore to a specific point in time
+
+Create a new Arc-enabled PostgreSQL server `pg02` by restoring `pg01` to its state at `2023-02-01T00:00:00Z`:
+```azurecli
+az postgres server-arc restore -n pg02 --source-server pg01 --k8s-namespace arc -t 2023-02-01T00:00:00Z --use-k8s
+```
+
+## Help
+
+For details about all the parameters available for restore review the output of the command:
+```azurecli
+az postgres server-arc restore --help
+```
+
+## Next steps
+
+- [Configure automated backup - Azure Arc-enabled PostgreSQL servers](backup-restore-postgresql.md)
+- [Scaling up or down (increasing/decreasing memory/vcores)](scale-up-down-postgresql-server-using-cli.md) your server.

articles/azure-arc/data/toc.yml

@@ -258,8 +258,10 @@ items:
               items:
                 - name: Deploy PostgresSQL server - CLI
                   href: deploy-active-directory-postgresql-server-cli.md
-            - name: Back up and restore
+            - name: Automated backup and restore
               href: backup-restore-postgresql.md
+            - name: Restore
+              href: restore-postgresql.md
             - name: Change PostgreSQL port
               href: change-postgresql-port.md
             - name: Configure and scale