Condividi tramite

Avvio rapido: Eseguire la connessione e le query con l'interfaccia della riga di comando di Azure con Database PostgreSQL di Azure - Server flessibile

  • Articolo

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

Contenuto correlato