Schnellstartanleitung: Erstellen einer Azure Database for PostgreSQL – Flexible Server-Instanz mit der Azure CLI

GILT FÜR: Azure Database for PostgreSQL – Flexibler Server

In diesem Schnellstart erfahren Sie, wie Sie mit den Befehlen der Azure CLI in Azure Cloud Shell in fünf Minuten eine Azure Database for PostgreSQL Flexible Server-Instanz erstellen können. Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Starten von Azure Cloud Shell

Azure Cloud Shell ist eine kostenlose interaktive Shell, mit der Sie die Schritte in diesem Artikel durchführen können. Sie verfügt über allgemeine vorinstallierte Tools und ist für die Verwendung mit Ihrem Konto konfiguriert.

Wählen Sie zum Öffnen von Cloud Shell oben rechts in einem Codeblock einfach die Option Ausprobieren. Sie können Cloud Shell auch auf einer separaten Browserregisterkarte öffnen, indem Sie zu https://shell.azure.com/bash navigieren. Wählen Sie Kopieren aus, um die Codeblöcke zu kopieren. Fügen Sie die Blöcke anschließend in Cloud Shell ein, und wählen Sie Eingabe, um sie auszuführen.

Wenn Sie es vorziehen, die CLI lokal zu installieren und zu verwenden, müssen Sie für diesen Schnellstart mindestens Version 2.0 der Azure CLI verwenden. Führen Sie az --version aus, um die Version zu ermitteln. Informationen zum Durchführen einer Installation oder eines Upgrades finden Sie bei Bedarf unter Installieren der Azure CLI.

Voraussetzungen

Sie müssen sich mithilfe des Befehls az login bei Ihrem Konto anmelden. Beachten Sie die Eigenschaft ID in der Ausgabe, die auf die Abonnement-ID für Ihr Azure-Konto verweist.

az login

Wählen Sie mithilfe des Befehls az account set das Abonnement unter Ihrem Konto aus. Verwenden Sie aus der Ausgabe von az login den Wert für ID, um ihn im Befehl als Wert für das Argument subscription zu verwenden. Wenn Sie über mehrere Abonnements verfügen, wählen Sie das entsprechende Abonnement aus, in dem die Ressource fakturiert sein sollte. Verwenden Sie az account list, um alle Abonnements abzurufen.

az account set --subscription <subscription id>

Erstellen eines flexiblen Servers

Erstellen Sie eine Azure-Ressourcengruppe mithilfe des Befehls az group create und erstellen Sie dann Ihre Azure Database for PostgreSQL - Flexible Server in dieser Ressourcengruppe. Geben Sie daher einen eindeutigen Namen an. Im folgenden Beispiel wird eine Ressourcengruppe mit dem Namen myresourcegroup am Standort eastus erstellt.

az group create --name myresourcegroup --location eastus

Erstellen Sie eine Azure Database for PostgreSQL - Flexible Serverinstanz mit dem Befehl az postgres flexible-server create. Ein Server kann mehrere Datenbanken enthalten. Mit dem folgenden Befehl wird ein Server in der Ressourcengruppe erstellt, die Sie gerade erstellt haben:

az postgres flexible-server create --name mydemoserver --resource-group myresourcegroup

Da die Standardkonnektivitätsmethode Öffentlicher Zugriff (zulässige IP-Adressen) ist, werden Sie durch den Befehl aufgefordert, zu bestätigen, ob Sie Ihre IP-Adresse und/oder alle IP-Adressen (Bereich von 0.0.0.0 bis 255.255.255.255) zur Liste der zulässigen Adressen hinzufügen möchten.

Der erstellte Server weist die folgenden Attribute auf:

  • Derselbe Speicherort wie Ihre Ressourcengruppe
  • Automatisch generierter Administratorbenutzername und automatisch generiertes Administratorkennwort (das Sie an einem sicheren Ort speichern sollten)
  • Eine Standarddatenbank mit dem Namen „flexibleserverdb“
  • Die Dienststandardwerte für verbleibende Serverkonfigurationen lauten wie folgt: Computetarif (Universell), Computegröße/SKU (Standard_D2s_v3, zwei virtuelle Kerne, 8 GB RAM), Aufbewahrungszeitraum für Sicherungen (sieben Tage) und PostgreSQL-Version (13).

Hinweis

Die Konnektivitätsmethode kann nicht geändert werden, nachdem der Server erstellt wurde. Wenn Sie z. B. während der Erstellung Privater Zugriff (VNet Integration) ausgewählt haben, können Sie nach der Erstellung nicht zu Öffentlicher Zugriff (zulässige IP-Adressen) wechseln. Es wird dringend empfohlen, einen Server mit privatem Zugriff zu erstellen, um mithilfe der VNET-Integration sicher auf den Server zugreifen zu können. Weitere Informationen zum privaten Zugriff finden Sie im Artikel zu Konzepten.

Wenn Sie die Standardwerte ändern möchten, finden Sie Hinweise in den Azure CLI-Referenzunterlagen zu az postgres flexible-server create.

Hinweis

Die Kommunikation für Verbindungen mit Azure Database for PostgreSQL - Flexible Server erfolgt über Port 5432. Wenn Sie versuchen, eine Verbindung über ein Unternehmensnetzwerk herzustellen, wird ausgehender Datenverkehr über Port 5432 unter Umständen nicht zugelassen. In diesem Fall können Sie nur dann eine Verbindung mit Ihrem Server herstellen, wenn Ihre IT-Abteilung Port 5432 öffnet. Beachten Sie, dass, wenn Sie PgBouncer auf Ihrer Instanz von Azure Database for PostgreSQL Flexible Server aktivieren und eine Verbindung damit herstellen möchten, weil es auf Port 6432 ausgeführt wird, dass Ihre IT-Abteilung den Port für ausgehenden Datenverkehr öffnen muss.

Abrufen der Verbindungsinformationen

Zum Herstellen einer Verbindung zum Server müssen Sie Hostinformationen und Anmeldeinformationen für den Zugriff angeben.

az postgres flexible-server show --name mydemoserver --resource-group myresourcegroup

Das Ergebnis liegt im JSON-Format vor. Notieren Sie sich die Werte für fullyQualifiedDomainName und administratorLogin. Sie sollten das Kennwort im vorherigen Schritt gespeichert haben.

{
  "administratorLogin": "myadmin",
  "availabilityZone": "3",
  "backup": {
    "backupRetentionDays": 7,
    "earliestRestoreDate": "2022-10-20T18:03:50.989428+00:00",
    "geoRedundantBackup": "Disabled"
  },
  "earliestRestoreDate": null,
  "fullyQualifiedDomainName": "mydemoserver.postgres.database.azure.com",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/mydemoserver",
  "location": "eastus",
  "name": "mydemoserver",
  "network": {
    "delegatedSubnetResourceId": null,
    "privateDnsZoneArmResourceId": null,
    "publicNetworkAccess": "Enabled"
  },
  "resourceGroup": "myresourcegroup",
  "sku": {
    "name": "Standard_D2s_v3",
    "tier": "GeneralPurpose"
  },
  "state": "Ready",
  "storage": {
    "storageSizeGb": 128
  },
  "tags": null,
  "type": "Microsoft.DBforPostgreSQL/flexibleServers",
  "version": "13"
}

Herstellen einer Verbindung über den PostgreSQL-Befehlszeilenclient

Installieren Sie zunächst das Befehlszeilentool psql.

Stellen Sie mit psql mithilfe des folgenden Befehls eine Verbindung mit der Datenbank „flexibleserverdb“ her. Ersetzen Sie Werte durch den automatisch generierten Domänennamen und Benutzernamen.

psql -h mydemoserver.postgres.database.azure.com -U myadmin flexibleserverdb

Hinweis

Wenn Sie einen Fehler wie The parameter PrivateDnsZoneArguments is required, and must be provided by customer erhalten, bedeutet dies, dass Sie möglicherweise eine ältere Version der Azure-Befehlszeilenschnittstelle ausführen. Führen Sie ein Upgrade der Azure-Befehlszeilenschnittstelle durch, und wiederholen Sie den Vorgang.

Bereinigen von Ressourcen

Wenn Sie diese Ressourcen nicht für einen anderen Schnellstart bzw. ein anderes Tutorial benötigen, können Sie sie mit dem folgenden Befehl löschen:

az group delete --name myresourcegroup

Wenn Sie nur den neu erstellten Server löschen möchten, können Sie den Befehl az postgres flexible-server delete ausführen.

az postgres flexible-server delete --resource-group myresourcegroup --name mydemoserver

Nächste Schritte