Avvio rapido: Connettersi ed eseguire query usando l'interfaccia della riga di comando di Azure con il server flessibile di Database di Azure per PostgreSQL

Questa guida introduttiva illustra come connettersi a un server flessibile Database di Azure per PostgreSQL usando interfaccia della riga di comando di Azure con az postgres flexible-server connect. Viene inoltre illustrato come eseguire una singola query o un file SQL usando il az postgres flexible-server execute 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 ne hai uno, ottieni una versione di valutazione gratuita.
  • Installare la versione più recente dell'interfaccia della riga di comando di Azure.
  • Accedi usando la CLI di Azure con il comando az login.
  • (facoltativo) Attivare la persistenza di un parametro sperimentale usando 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 di Database di Azure per PostgreSQL

Creare prima di tutto un server flessibile Database di Azure per PostgreSQL gestito. In Azure Cloud Shell eseguire lo script seguente. Prendere nota del nome del server, del nome utente e della password generati da questo comando.

az postgres flexible-server create --public-access <your-ip-address>

Per personalizzare il comando, specificare altri argomenti. Vedere tutti gli argomenti per az postgres flexible-server create.

Visualizzare tutti gli argomenti

È possibile visualizzare tutti gli argomenti per questo comando usando 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 esito positivo, viene visualizzato un output simile.

Successfully connected to server372060240.

Se la connessione non riesce, controllare i punti seguenti:

  • Verificare che il nome utente e la password dell'amministratore del server siano corretti.
  • Assicurarsi di configurare la regola del firewall per il computer client.
  • Se il server è configurato con accesso privato usando la rete virtuale, assicurarsi che il computer 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

Viene visualizzata l'interfaccia della shell psql, simile all'output seguente:

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 query singole

Usare az postgres flexible-server execute per eseguire singole query su un database Postgres.

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

Nell'esempio seguente viene visualizzato un output:

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

Usare il comando az postgres flexible-server execute con l'argomento --file-path-f, per eseguire un file SQL.

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 test.sql file nella directory corrente. Eseguire quindi il comando seguente per eseguire il file.

az postgres flexible-server execute \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
    -f "test.sql"

Nell'esempio seguente viene visualizzato un output:

Running sql file 'test.sql'...
Successfully executed the file.
Closed the connection to server372060240

Contenuti correlati

  • Last updated on