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 diesem Schnellstart wird gezeigt, wie Sie sich mit der Azure CLI über az postgres flexible-server connect mit einer Instanz von „Flexibler Azure Database for PostgreSQL-Server“ verbinden und mit dem Befehl az postgres flexible-server execute eine einzelne Abfrage oder SQL-Datei 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 mit einem aktiven Abonnement. Falls Sie noch kein Konto haben, können Sie eine kostenlose Testversion verwenden.
- Installieren Sie die neueste Version der Azure CLI.
- Melden Sie sich mit Azure CLI mit dem
az login-Befehl an. - (optional) Aktivieren Sie eine experimentelle 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 Instanz von Azure Database for PostgreSQL – Flexibler Server
Als Erstes erstellen Sie eine verwaltete Azure Database for PostgreSQL – Flexibler Server-Instanz. 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
Sie können die Verbindung mit der Datenbank aus Ihrer Entwicklungsumgebung mithilfe des Befehls az postgres flexible-server connect testen und überprüfen.
az postgres flexible-server connect \
-n <servername> -u <username> -p "<password>" -d <databasename>
Beispiel:
az postgres flexible-server connect \
-n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres
Es wird eine ähnliche Ausgabe angezeigt, wenn die Verbindung erfolgreich war.
Successfully connected to server372060240.
Wenn die Verbindung fehlgeschlagen ist, überprüfen Sie die folgenden Punkte:
- Überprüfen Sie, ob Benutzername und Kennwort des Serveradministrators korrekt sind.
- Überprüfen Sie, ob die Firewallregel für Ihren Clientcomputer konfiguriert wurde.
- Überprüfen Sie, ob Ihr Server mit privatem Zugriff in einem virtuellen Netzwerk konfiguriert ist. 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> \
--interactive
Beispiel:
az postgres flexible-server connect \
-n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres --interactive
Die psql-Shellbenutzeroberfläche wird wie folgt angezeigt:
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>
Ausführen einzelner Abfragen
Sie können mit az postgres flexible-server execute einzelne Abfragen für die Postgres-Datenbank ausführen.
az postgres flexible-server execute \
-n <servername> -u <username> -p "<password>" -d <databasename> \
-q <querytext> --output table
Beispiel:
az postgres flexible-server execute \
-n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
-q "SELECT 1" --output table
Sie erhalten eine Ausgabe wie diese hier:
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
Ausführen einer SQL-Datei
Sie können eine SQL-Datei mit dem Befehl az postgres flexible-server execute und 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: Vorbereiten einer test.sql-Datei. Sie können das folgende Testskript mit einfachen SELECT-Abfragen verwenden:
SELECT 1;
SELECT 2;
SELECT 3;
Speichern Sie den Inhalt in der test.sql-Datei im aktuellen Verzeichnis, und führen Sie den folgenden Befehl aus.
az postgres flexible-server execute \
-n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
-f "test.sql"
Sie erhalten eine Ausgabe wie diese hier:
Running sql file 'test.sql'...
Successfully executed the file.
Closed the connection to server372060240