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. Se non è disponibile, ottenere una versione di valutazione gratuita.
  • Installare l'interfaccia della riga di comando di Azure più recente (2.20.0 o versione successiva)
  • Accedere con l'interfaccia della riga di comando di Azure con az login il comando
  • Attivare la persistenza dei parametri 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, del nome utente e della 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 -n <servername> -u <username> -p "<password>" -d <databasename>

Esempio:

az postgres flexible-server connect -n postgresdemoserver -u dbuser -p "dbpassword" -d postgres

Se la connessione ha avuto esito positivo, verrà visualizzato l'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`

Se la connessione non è riuscita, provare queste soluzioni:

  • Controllare se la porta 5432 è aperta nel computer client.
  • 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 è stato configurato con accesso privato nella rete virtuale, assicurarsi che il computer client si trovi 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>

Esempio:

az postgres flexible-server connect -n postgresdemoserver -u dbuser -p "dbpassword" -d flexibleserverdb --interactive

L'esperienza della shell psql verrà visualizzata come illustrato di seguito:

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
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`

Esempio:

az postgres flexible-server execute -n postgresdemoserver -u dbuser -p "dbpassword" -d flexibleserverdb -q "select * from table1;" --output table

Verrà visualizzato un output come illustrato di seguito:

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;'
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

Eseguire il file SQL

È possibile eseguire un file SQL con il comando 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:

az postgres flexible-server execute -n postgresdemoserver -u dbuser -p "dbpassword" -d flexibleserverdb -f "./test.sql"

Verrà visualizzato un output come illustrato di seguito:

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'...
Successfully executed the file.
Closed the connection to postgresdemoserver.

Passaggi successivi

Gestire il server