Share via

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 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 az postgres flexible-server execute il comando . 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 az login il comando .
  • (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 Database di Azure per PostgreSQL'istanza del server flessibile

La prima cosa da creare è un'istanza del server flessibile Database di Azure per PostgreSQL gestita. In Azure Cloud Shell eseguire 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 --help l'argomento .

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 --file-path l'argomento . -f

az postgres flexible-server execute \
    -n <server-name> -u <username> -p "<password>" -d <database-name> \
    --file-path "<file-path>"

Esempio: preparare un test.sql file. È possibile usare lo script di test seguente con query semplici SELECT :

SELECT 1;
SELECT 2;
SELECT 3;

Salvare il contenuto nel test.sql file 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

Passaggi successivi

Gestire il server