Schnellstart: Verbinden und Abfragen mit der Azure CLI mit Azure Database for PostgreSQL – Flexible Server
GILT FÜR:
Azure Database for PostgreSQL – Flexible Server
In dieser Schnellstartanleitung wird veranschaulicht, wie Sie eine Verbindung mit einer flexiblen Azure-Serverinstanz mit Azure CLI herstellen az postgres flexible-server connect und eine einzelne Abfrage oder SQL-Datei mit az postgres flexible-server execute Befehl ausführen. Mit diesem Befehl können Sie die Konnektivität mit dem Datenbankserver testen und Abfragen ausführen. Sie können mithilfe des interaktiven Modus auch mehrere Abfragen ausführen.
Voraussetzungen
- Ein Azure-Konto. Falls Sie noch kein Konto haben, können Sie eine kostenlose Testversion verwenden.
- Installieren der aktuellen Version der Azure CLI (mindestens 2.20.0)
- Anmelden unter Verwendung der Azure CLI mit dem Befehl
az login - Aktivieren der Parameterpersistenz mit
az config param-persist on. Mithilfe von Parameterpersistenz können Sie den lokalen Kontext verwenden, ohne zahlreiche Argumente wie Ressourcengruppe oder Speicherort wiederholen zu müssen.
Erstellen einer Azure-Datenbank für flexible Serverinstanz von PostgreSQL
Als Erstes erstellen Sie eine verwaltete Azure-Datenbank für flexible Serverinstanz von PostgreSQL. Führen Sie in Azure Cloud Shell das folgende Skript aus, und notieren Sie sich den Servernamen, den Benutzernamen und das Kennwort, die mit diesem Befehl generiert werden.
az postgres flexible-server create --public-access <your-ip-address>
Sie können zur Anpassung weitere Argumente für diesen Befehl angeben. Sehen Sie sich alle Argumente für az postgres flexible-server create an.
Anzeigen aller Argumente
Sie können alle Argumente für diesen Befehl mit dem Argument --help anzeigen.
az postgres flexible-server connect --help
Testen der Verbindung des Datenbankservers
Mit dem folgenden Befehl können Sie die Verbindung mit der Datenbank aus Ihrer Entwicklungsumgebung testen und überprüfen:
az postgres flexible-server connect -n <servername> -u <username> -p "<password>" -d <databasename>
Beispiel:
az postgres flexible-server connect -n postgresdemoserver -u dbuser -p "dbpassword" -d postgres
Die Ausgabe wird angezeigt, wenn die Verbindung erfolgreich hergestellt wurde.
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`
Konnte die Verbindung nicht hergestellt werden, versuchen Sie Folgendes:
- Überprüfen Sie, ob Port 5432 auf dem Clientcomputer geöffnet ist.
- Überprüfen Sie, ob Benutzername und Kennwort des Serveradministrators korrekt sind.
- Überprüfen Sie, ob die Firewallregel für Ihren Clientcomputer konfiguriert wurde.
- Wenn Sie Ihren Server mit privatem Zugriff in einem virtuellen Netzwerk konfiguriert haben, vergewissern Sie sich, dass sich Ihr Clientcomputer im gleichen virtuellen Netzwerk befindet.
Ausführen mehrerer Abfragen mithilfe des interaktiven Modus
Sie können mehrere Abfragen mithilfe des interaktiven Modus ausführen. Führen Sie zum Aktivieren des interaktiven Modus den folgenden Befehl aus:
az postgres flexible-server connect -n <servername> -u <username> -p "<password>" -d <databasename>
Beispiel:
az postgres flexible-server connect -n postgresdemoserver -u dbuser -p "dbpassword" -d flexibleserverdb --interactive
Die psql-Shellbenutzeroberfläche wird wie folgt angezeigt:
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`
Beispiel:
az postgres flexible-server execute -n postgresdemoserver -u dbuser -p "dbpassword" -d flexibleserverdb -q "select * from table1;" --output table
Die folgende Ausgabe sollte angezeigt werden:
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
Ausführen einer SQL-Datei
Sie können eine SQL-Datei mit dem Befehl mit dem --file-path-Argument -f ausführen.
az postgres flexible-server execute -n <server-name> -u <username> -p "<password>" -d <database-name> --file-path "<file-path>"
Beispiel:
az postgres flexible-server execute -n postgresdemoserver -u dbuser -p "dbpassword" -d flexibleserverdb -f "./test.sql"
Die folgende Ausgabe sollte angezeigt werden:
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.