Schnellstart: Erstellen eines Azure Database for PostgreSQL-Servers mithilfe der Azure CLI
GILT FÜR:
Azure Database for PostgreSQL – Single Server
Wichtig
Azure Database for PostgreSQL – Single Server wird eingestellt. Es wird dringend empfohlen, ein Upgrade auf Azure Database for PostgreSQL – Flexible Server auszuführen. Weitere Informationen zum Migrieren zu Azure Database for PostgreSQL – Flexible Server finden Sie unter Was geschieht mit Azure Database for PostgreSQL – Single Server?
In dieser Schnellstartanleitung erfahren Sie, wie Sie mit den Befehlen der Azure CLI in Azure Cloud Shell in fünf Minuten einen einzelnen Azure Database for PostgreSQL-Server erstellen.
Tipp
Erwägen Sie die Verwendung eines vereinfachten az postgres up-Azure CLI-Befehls. Probieren Sie den Schnellstart aus.
Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein kostenloses Azure-Konto, bevor Sie beginnen.
Voraussetzungen
Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter Schnellstart für Bash in Azure Cloud Shell.
Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.
Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.
Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden von Erweiterungen mit der Azure CLI.
Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.
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 einem separaten Browsertab starten, indem Sie zu https://shell.azure.com navigieren.
Überprüfen Sie nach dem Öffnen von Cloud Shell, ob Bash für Ihre Umgebung ausgewählt ist. In den folgenden Sitzungen wird die Azure CLI in einer Bash-Umgebung verwendet. Wählen Sie Kopieren aus, um die Codeblöcke zu kopieren. Fügen Sie sie in Cloud Shell ein, und drücken Sie die EINGABETASTE, um sie auszuführen.
Anmelden bei Azure
Cloud Shell wird automatisch unter dem Konto authentifiziert, mit dem die Anmeldung anfänglich erfolgt ist. Verwenden Sie das folgende Skript, um sich mit einem anderen Abonnement anzumelden, und ersetzen Sie <Subscription ID> durch Ihre Azure-Abonnement-ID. Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein kostenloses Azure-Konto, bevor Sie beginnen.
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
Weitere Informationen finden Sie unter Festlegen des aktiven Abonnements oder unter Interaktives Anmelden.
Festlegen von Parameterwerten
Mit den folgenden Werten werden in nachfolgenden Befehlen die Datenbank und die erforderlichen Ressourcen erstellt. Servernamen müssen innerhalb von Azure global eindeutig sein, damit die Funktion „$RANDOM“ zum Erstellen des Servernamens verwendet werden kann.
Ändern Sie den Standort entsprechend Ihrer Umgebung. Ersetzen Sie 0.0.0.0 durch den IP-Adressbereich, der Ihrer spezifischen Umgebung entspricht. Verwenden Sie die öffentliche IP-Adresse Ihres Computers, um den Zugriff auf den Server nur auf Ihre IP-Adresse zu beschränken.
# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="msdocs-postgresql-rg-$randomIdentifier"
tag="create-postgresql-server-and-firewall-rule"
server="msdocs-postgresql-server-$randomIdentifier"
sku="GP_Gen5_2"
login="azureuser"
password="Pa$$w0rD-$randomIdentifier"
# Specify appropriate IP address values for your environment
# to limit / allow access to the PostgreSQL server
startIp=0.0.0.0
endIp=0.0.0.0
echo "Using resource group $resourceGroup with login: $login, password: $password..."
Erstellen einer Ressourcengruppe
Erstellen Sie mithilfe des Befehls az group create eine Ressourcengruppe. Eine Azure-Ressourcengruppe ist ein logischer Container, in dem Azure-Ressourcen bereitgestellt und verwaltet werden. Im folgenden Beispiel wird eine Ressourcengruppe mit dem Namen myResourceGroup am Standort eastus erstellt:
# Create a resource group
echo "Creating $resourceGroup in $location..."
az group create --name $resourceGroup --location "$location" --tags $tag
Erstellen eines Servers
Erstellen Sie mit dem Befehl az postgresql server create einen Server.
# Create a PostgreSQL server in the resource group
# Name of a server maps to DNS name and is thus required to be globally unique in Azure.
echo "Creating $server in $location..."
az postgres server create --name $server --resource-group $resourceGroup --location "$location" --admin-user $login --admin-password $password --sku-name $sku
Hinweis
- Der Servername darf nur Kleinbuchstaben, Zahlen und den Bindestrich (-) enthalten. Er muss zwischen 3 und 63 Zeichen aufweisen. Weitere Informationen finden Sie unter Benennungsregeln und -einschränkungen für Azure-Ressourcen.
- Der Benutzername des Administrators darf nicht azure_superuser, admin, administrator, root, guest oder public lauten.
- Das Kennwort muss zwischen 8 und 128 Zeichen aus drei der folgenden Kategorien enthalten: englische Großbuchstaben, englische Kleinbuchstaben, Zahlen und nicht alphanumerische Zeichen.
- Informationen zu SKUs finden Sie unter Azure Database for PostgreSQL – Preise.
Wichtig
- Die Standardversion von PostgreSQL auf dem Server lautet 9.6. Informationen zu allen unterstützten Versionen finden Sie unter Unterstützte PostgreSQL-Hauptversionen.
- SSL ist standardmäßig auf dem Server aktiviert. Weitere Informationen zu SSL finden Sie unter Konfigurieren der TLS-Konnektivität in Azure Database for PostgreSQL (Einzelserver).
Konfigurieren einer serverbasierten Firewallregel
Erstellen Sie eine Firewallregel mit dem Befehl az postgres server firewall-rule create, damit Ihre lokale Umgebung Zugriff zum Herstellen einer Verbindung mit dem Server erhält.
# Configure a firewall rule for the server
echo "Configuring a firewall rule for $server for the IP address range of $startIp to $endIp"
az postgres server firewall-rule create --resource-group $resourceGroup --server $server --name AllowIps --start-ip-address $startIp --end-ip-address $endIp
Tipp
Wenn Sie Ihre IP-Adresse nicht kennen, rufen Sie sie unter WhatIsMyIPAddress.com ab.
Hinweis
Stellen Sie sicher, dass die Firewall des Netzwerks Port 5432 zulässt, um Konnektivitätsprobleme zu vermeiden. Azure Database for PostgreSQL-Server nutzen diesen Port.
Auflisten serverbasierter Firewallregeln
Führen Sie zum Auflisten der vorhandenen Serverfirewallregeln den az postgres server firewall-rule list-Befehl aus.
# List firewall rules for the server
echo "List of server-based firewall rules for $server"
az postgres server firewall-rule list --resource-group $resourceGroup --server-name $server
# You may use the switch `--output table` for a more readable table format as the output.
Die Ausgabe listet die Firewallregeln (sofern vorhanden) standardmäßig im JSON-Format auf. Sie können mit dem Switch --output table ein besser lesbares Tabellenformat als die Ausgabe erzeugen.
Abrufen der Verbindungsinformationen
Geben Sie zum Herstellen einer Verbindung mit dem Server Hostinformationen und Anmeldeinformationen für den Zugriff an.
az postgres server show --resource-group $resourceGroup --name $server
Notieren Sie sich die Werte für administratorLogin und fullyQualifiedDomainName.
Herstellen einer Verbindung mit dem Azure Database for PostgreSQL-Server mithilfe von psql
Der psql-Client wird häufig zum Herstellen einer Verbindung mit PostgreSQL-Servern verwendet. Sie können mithilfe von psql und Azure Cloud Shell eine Verbindung mit Ihrem Server herstellen. Sie können auch psql in Ihrer lokalen Umgebung verwenden, sofern verfügbar. Mit einem neuen PostgreSQL-Server wird automatisch eine leere Datenbank (postgres) erstellt. Sie können diese Datenbank verwenden, um eine Verbindung mit psql herzustellen, wie im folgenden Code gezeigt.
psql --host=<server_name>.postgres.database.azure.com --port=5432 --username=<admin_user>@<server_name> --dbname=postgres
Tipp
Wenn Sie lieber einen URL-Pfad zum Herstellen einer Verbindung mit Postgres verwenden, codiert die URL das @-Zeichen im Benutzernamen mit %40. Die Verbindungszeichenfolge für psql sieht beispielsweise so aus:
psql postgresql://<admin_user>%40<server_name>@<server_name>.postgres.database.azure.com:5432/postgres
Bereinigen von Ressourcen
Verwenden Sie den folgenden Befehl, um die Ressourcengruppe und alle zugehörigen Ressourcen mit dem Befehl az group delete zu entfernen, es sei denn, Sie benötigen diese Ressourcen weiterhin. Bei einigen dieser Ressourcen kann das Erstellen wie auch das Löschen eine Weile dauern.
az group delete --name $resourceGroup