Merge pull request #274977 from AlicjaKucharczyk/main

cli update

Author: v-dirichards

articles/postgresql/flexible-server/connect-azure-cli.md

@@ -4,7 +4,7 @@ description: This quickstart provides several ways to connect with Azure CLI wit
 author: AlicjaKucharczyk
 ms.author: alkuchar
 ms.reviewer: maghan
-ms.date: 04/27/2024
+ms.date: 05/10/2024
 ms.service: postgresql
 ms.subservice: flexible-server
 ms.topic: quickstart
@@ -22,127 +22,145 @@ This quickstart demonstrates how to connect to an Azure Database for PostgreSQL
 
 
 ## Prerequisites
-- An Azure account. If you don't have one, [get a free trial](https://azure.microsoft.com/free/).
-- Install [Azure CLI](/cli/azure/install-azure-cli) latest version (2.20.0 or above)
-- Log in using Azure CLI with `az login` command 
-- Turn on parameter persistence with `az config param-persist on`. Parameter persistence will help you use local context without having to repeat numerous arguments like resource group or location.
+- An Azure account with an active subscription. If you don't have one, [get a free trial](https://azure.microsoft.com/free/).
+- Install [Azure CLI](/cli/azure/install-azure-cli) latest version.
+- Sign in using Azure CLI with `az login` command.
+- (optional) Turn on an experimental parameter persistence with `az config param-persist on`. Parameter persistence helps you use local context without having to repeat numerous arguments like resource group or location.
 
 ## Create Azure Database for PostgreSQL flexible server instance
 
-The first thing to create is a managed Azure Database for PostgreSQL flexible server instance. In [Azure Cloud Shell](https://shell.azure.com/), run the following script and make a note of the **server name**, **username** and  **password** generated from this command.
+The first thing to create is a managed Azure Database for PostgreSQL flexible server instance. In [Azure Cloud Shell](https://shell.azure.com/), run the following script and make a note of the **server name**, **username, and  **password** generated from this command.
 
-```azurecli
+```azurecli-interactive
 az postgres flexible-server create --public-access <your-ip-address>
 ```
 You can provide more arguments for this command to customize it. See all arguments for [az postgres flexible-server create](/cli/azure/postgres/flexible-server#az-postgres-flexible-server-create).
 
 ## View all the arguments
 You can view all the arguments for this command with `--help` argument. 
 
-```azurecli
+```azurecli-interactive
 az postgres flexible-server connect --help
 ```
 
 ## Test database server connection
-You can test and validate the connection to the database from your development environment using the command.
+You can test and validate the connection to the database from your development environment using the [az postgres flexible-server connect](/cli/azure/postgres/flexible-server#az-postgres-flexible-server-connect) command.
 
-```azurecli
-az postgres flexible-server connect -n <servername> -u <username> -p "<password>" -d <databasename>
+```azurecli-interactive
+az postgres flexible-server connect \
+    -n <servername> -u <username> -p "<password>" -d <databasename>
 ```
 **Example:** 
-```azurecli
-az postgres flexible-server connect -n postgresdemoserver -u dbuser -p "dbpassword" -d postgres
+```azurecli-interactive
+az postgres flexible-server connect \
+    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres
 ```
-You'll see the output if the connection was successful.
+You see similar output if the connection was successful.
+
 ```output
-Command group 'postgres flexible-server' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
-Successfully connected to postgresdemoserver.
-Local context is turned on. Its information is saved in working directory C:\mydir. You can run `az local-context off` to turn it off.
-Your preference of  are now saved to local context. To learn more, type in `az local-context --help`
+Successfully connected to server372060240.
 ```
 
-If the connection failed, try these solutions:
-- Check if port 5432 is open on your client machine.
+If the connection failed, check the following points:
 - if your server administrator user name and password are correct
-- if you have configured firewall rule for your client machine
-- if you've configured your server with private access in virtual networking, make sure your client machine is in the same virtual network.
+- if you configured firewall rule for your client machine
+- if your server is configured with private access with virtual networking, make sure your client machine is in the same virtual network.
 
 ## Run multiple queries using interactive mode
-You can run multiple queries using the **interactive** mode. To enable interactive mode, run the following command
+You can run multiple queries using the **interactive** mode. To enable interactive mode, run the following command.
 
-```azurecli
-az postgres flexible-server connect -n <servername> -u <username> -p "<password>" -d <databasename>
+```azurecli-interactive
+az postgres flexible-server connect \
+    -n <servername> -u <username> -p "<password>" -d <databasename> \
+    --interactive
 ```
 
 **Example:**
 
-```azurecli
-az postgres flexible-server connect -n postgresdemoserver -u dbuser -p "dbpassword" -d flexibleserverdb --interactive
+```azurecli-interactive
+az postgres flexible-server connect \
+    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres --interactive
 ```
 
-You'll see the **psql** shell experience as shown below:
+You see the **psql** shell experience as shown here:
 
-```bash
-Command group 'postgres flexible-server' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
-Password for earthyTurtle7:
-Server: PostgreSQL 12.5
-Version: 3.0.0
-Chat: https://gitter.im/dbcli/pgcli
+```output
+Password for starchylapwing9:
+Server: PostgreSQL 13.14
+Version: 4.0.1
 Home: http://pgcli.com
-postgres> create database pollsdb;
-CREATE DATABASE
-Time: 0.308s
-postgres> exit
-Goodbye!
-Local context is turned on. Its information is saved in working directory C:\sunitha. You can run `az local-context off` to turn it off.
-Your preference of  are now saved to local context. To learn more, type in `az local-context --help`
+postgres> SELECT 1;
++----------+
+| ?column? |
+|----------|
+| 1        |
++----------+
+SELECT 1
+Time: 0.167s
+postgres>
+```
+
+## Execute single queries
+You can run single queries against Postgres database using [az postgres flexible-server execute](/cli/azure/postgres/flexible-server#az-postgres-flexible-server-execute).
+
+```azurecli-interactive
+az postgres flexible-server execute \
+    -n <servername> -u <username> -p "<password>" -d <databasename> \
+    -q <querytext> --output table
 ```
 
 **Example:** 
-```azurecli
-az postgres flexible-server execute -n postgresdemoserver -u dbuser -p "dbpassword" -d flexibleserverdb -q "select * from table1;" --output table
+```azurecli-interactive
+az postgres flexible-server execute \
+    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
+    -q "SELECT 1" --output table
 ```
 
-You'll see an output as shown below:
+You see an output as shown here:
 
 ```output
-Command group 'postgres flexible-server' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
-Successfully connected to postgresdemoserver.
-Ran Database Query: 'select * from table1;'
+Successfully connected to server372060240.
+Ran Database Query: 'SELECT 1'
 Retrieving first 30 rows of query output, if applicable.
-Closed the connection postgresdemoserver.
-Local context is turned on. Its information is saved in working directory C:\mydir. You can run `az local-context off` to turn it off.
-Your preference of  are now saved to local context. To learn more, type in `az local-context --help`
-Txt    Val
------  -----
-test   200
-test   200
-test   200
-test   200
-test   200
-test   200
-test   200
+Closed the connection to server372060240
+?column?
+----------
+1
 ```
 
 ## Run SQL File
-You can execute a sql file with the command using `--file-path` argument, `-f`.
+You can execute a sql file with the [az postgres flexible-server execute](/cli/azure/postgres/flexible-server#az-postgres-flexible-server-execute) command using `--file-path` argument, `-f`.
 
-```azurecli
-az postgres flexible-server execute -n <server-name> -u <username> -p "<password>" -d <database-name> --file-path "<file-path>"
+```azurecli-interactive
+az postgres flexible-server execute \
+    -n <server-name> -u <username> -p "<password>" -d <database-name> \
+    --file-path "<file-path>"
 ```
 
 **Example:** 
-```azurecli
-az postgres flexible-server execute -n postgresdemoserver -u dbuser -p "dbpassword" -d flexibleserverdb -f "./test.sql"
+Prepare a `test.sql` file. You can use the following test script with simple `SELECT` queries:
+
+```sql
+SELECT 1;
+SELECT 2;
+SELECT 3;
+```
+
+Save the content to the `test.sql` file in the current directory and execute using following command.
+
+
+```azurecli-interactive
+az postgres flexible-server execute \
+    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
+    -f "test.sql"
 ```
 
-You'll see an output as shown below:
+You see an output as shown here:
 
 ```output
-Command group 'postgres flexible-server' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
-Running sql file '.\test.sql'...
+Running sql file 'test.sql'...
 Successfully executed the file.
-Closed the connection to postgresdemoserver.
+Closed the connection to server372060240
 ```
 
 ## Next Steps