Schnellstart: Herstellen einer Verbindung und Ausführen von Abfragen mithilfe der Azure CLI mit Azure Database for PostgreSQL – Flexibler Server

In dieser Schnellstartanleitung erfahren Sie, wie Sie mithilfe der Azure CLI mit az postgres flexible-server connect eine Verbindung mit einem Azure Database for PostgreSQL Flexible Server herstellen. Außerdem wird gezeigt, wie sie eine einzelne Abfrage oder SQL-Datei mithilfe des az postgres flexible-server execute Befehls ausführen. Mit diesem Befehl können Sie die Konnektivität mit Ihrem Datenbankserver testen und Abfragen ausführen. Sie können auch mehrere Abfragen mithilfe des interaktiven Modus 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 von Azure CLI.
  • Melden Sie sich mit azure CLI mit dem az login Befehl an.
  • (optional) Aktivieren Sie eine experimentelle Parameterpersistenz mithilfe von 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 Die PostgreSQL-Instanz

Erstellen Sie zunächst einen verwalteten Azure Database for PostgreSQL flexiblen Server. Führen Sie in Azure Cloud Shell das folgende Skript aus. Notieren Sie sich den Servernamen, den Benutzernamen und das Kennwort , das aus diesem Befehl generiert wurde.

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

Um den Befehl anzupassen, stellen Sie weitere Argumente bereit. 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 mithilfe des --help Arguments anzeigen.

az postgres flexible-server connect --help

Testen der Verbindung des Datenbankservers

Sie können die Verbindung mit der Datenbank aus Ihrer Entwicklungsumgebung testen und überprüfen, indem Sie den Befehl "az postgres flexible-server connect" verwenden.

az postgres flexible-server connect \
    -n <servername> -u <username> -p "<password>" -d <databasename>

Example:

az postgres flexible-server connect \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres

Es wird eine ähnliche Ausgabe angezeigt, wenn die Verbindung erfolgreich ist.

Successfully connected to server372060240.

Wenn die Verbindung fehlschlägt, überprüfen Sie die folgenden Punkte:

  • Stellen Sie sicher, dass der Benutzername und das Kennwort des Serveradministrators korrekt sind.
  • Stellen Sie sicher, dass Sie die Firewallregel für Ihren Clientcomputer konfiguriert haben.
  • Wenn Ihr Server mit privatem Zugriff über virtuelle Netzwerke konfiguriert ist, stellen Sie sicher, dass sich Ihr Clientcomputer im selben 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

Example:

az postgres flexible-server connect \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres --interactive

Die psql-Shell-Erfahrung wird ähnlich wie die folgende Ausgabe 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

Verwenden Sie az postgres flexible-server execute, um einzelne Abfragen gegen eine Postgres-Datenbank auszuführen.

az postgres flexible-server execute \
    -n <servername> -u <username> -p "<password>" -d <databasename> \
    -q <querytext> --output table

Example:

az postgres flexible-server execute \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
    -q "SELECT 1" --output table

Sie sehen eine Ausgabe wie im folgenden Beispiel:

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

Verwenden Sie den Befehl "az postgres flexible-server execute " mit dem --file-path Argument, -fum eine SQL-Datei auszufü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. Führen Sie dann den folgenden Befehl aus, um die Datei auszuführen.

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

Eine Ausgabe wird wie im folgenden Beispiel gezeigt angezeigt:

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

Verwandte Inhalte

  • Last updated on