Avvio rapido: Eseguire la connessione e le query con l'interfaccia della riga di comando di Azure con Database PostgreSQL di Azure - Server flessibile
SI APPLICA A: 
Database di Azure per PostgreSQL - Server flessibile
Questa guida introduttiva illustra come connettersi a un'istanza del server flessibile di Database di Azure per PostgreSQL usando l'interfaccia della riga di comando di Azure con az postgres flexible-server connect ed eseguire una singola query o un file SQL con il comando az postgres flexible-server execute. Questo comando consente di testare la connettività al server di database ed eseguire query. È anche possibile eseguire più query usando la modalità interattiva.
Prerequisiti
- Un account Azure con una sottoscrizione attiva. Se non è disponibile, ottenere una versione di valutazione gratuita.
- Installare la versione più recente dell'interfaccia della riga di comando di Azure.
- Accedere usando l'interfaccia della riga di comando di Azure con il comando
az login. - (facoltativo) Attivare la persistenza di un parametro sperimentale con
az config param-persist on. La persistenza dei parametri consente di usare il contesto locale senza dover ripetere numerosi argomenti, ad esempio il gruppo di risorse o la posizione.
Creare un'istanza del server flessibile di Database di Azure per PostgreSQL
La prima cosa da creare è un'istanza del server flessibile di Database di Azure per PostgreSQL gestita. In Azure Cloud Shelleseguire lo script seguente e prendere nota del nome del server, **nome utente e password generati da questo comando.
az postgres flexible-server create --public-access <your-ip-address>
È possibile specificare altri argomenti per questo comando per personalizzarlo. Vedere tutti gli argomenti per az postgres flexible-server create.
Visualizzare tutti gli argomenti
È possibile visualizzare tutti gli argomenti per questo comando con l'argomento --help.
az postgres flexible-server connect --help
Testare la connessione al server di database
È possibile testare e convalidare la connessione al database dall'ambiente di sviluppo usando il comando az postgres flexible-server connect.
az postgres flexible-server connect \
-n <servername> -u <username> -p "<password>" -d <databasename>
Esempio:
az postgres flexible-server connect \
-n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres
Se la connessione ha avuto esito positivo, viene visualizzato un output simile.
Successfully connected to server372060240.
Se la connessione non è riuscita, controllare i punti seguenti:
- se il nome utente e la password dell'amministratore del server sono corretti
- se è stata configurata la regola del firewall per il computer client
- se il server è configurato con accesso privato con rete virtuale, assicurarsi che la macchina client si trova nella stessa rete virtuale.
Eseguire più query usando la modalità interattiva
È possibile eseguire più query usando la modalità interattiva. Per abilitare la modalità interattiva, eseguire il comando seguente.
az postgres flexible-server connect \
-n <servername> -u <username> -p "<password>" -d <databasename> \
--interactive
Esempio:
az postgres flexible-server connect \
-n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres --interactive
L'esperienza della shell psql viene visualizzata come illustrato di seguito:
Password for starchylapwing9:
Server: PostgreSQL 13.14
Version: 4.0.1
Home: http://pgcli.com
postgres> SELECT 1;
+----------+
| ?column? |
|----------|
| 1 |
+----------+
SELECT 1
Time: 0.167s
postgres>
Eseguire singole query
È possibile eseguire singole query sul database Postgres usando az postgres flexible-server execute.
az postgres flexible-server execute \
-n <servername> -u <username> -p "<password>" -d <databasename> \
-q <querytext> --output table
Esempio:
az postgres flexible-server execute \
-n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
-q "SELECT 1" --output table
Viene visualizzato un output come illustrato di seguito:
Successfully connected to server372060240.
Ran Database Query: 'SELECT 1'
Retrieving first 30 rows of query output, if applicable.
Closed the connection to server372060240
?column?
----------
1
Eseguire il file SQL
È possibile eseguire un file sql con il comando az postgres flexible-server execute usando l'argomento --file-path, -f.
az postgres flexible-server execute \
-n <server-name> -u <username> -p "<password>" -d <database-name> \
--file-path "<file-path>"
esempio: Preparare un file test.sql. È possibile usare lo script di test seguente con query SELECT semplici:
SELECT 1;
SELECT 2;
SELECT 3;
Salvare il contenuto nel file test.sql nella directory corrente ed eseguire usando il comando seguente.
az postgres flexible-server execute \
-n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
-f "test.sql"
Viene visualizzato un output come illustrato di seguito:
Running sql file 'test.sql'...
Successfully executed the file.
Closed the connection to server372060240