Schnellstart: Erstellen einer Azure-Datenbank für MySQL-Server mithilfe der Azure CLI

GILT FÜR:Azure Database for MySQL – Single Server

Wichtig

Azure Database for MySQL single server is on the retirement path. Es wird dringend empfohlen, ein Upgrade auf azure Database for MySQL flexiblen Server durchzuführen. Weitere Informationen zum Migrieren zu Azure Database for MySQL flexible Server finden Sie unter Was geschieht mit Azure Database for MySQL Single Server?

Tipp

Erwägen Sie die Verwendung des vereinfachten Befehls az mysql up der Azure-Befehlszeilenschnittstelle (derzeit in der Vorschauphase). Probieren Sie den Schnellstart aus.

In dieser Schnellstartanleitung erfahren Sie, wie Sie mit den Befehlen der Azure CLI in Azure Cloud Shell in fünf Minuten einen Azure Database for MySQL-Server erstellen.

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.

  • Für diesen Schnellstart ist mindestens Version 2.0 der Azure CLI erforderlich. Bei Verwendung von Azure Cloud Shell ist die aktuelle Version bereits installiert.

  • Wählen Sie mithilfe des Befehls az account set das Abonnement unter Ihrem Konto aus. Notieren Sie sich aus der Ausgabe von az login den Wert für id. Sie verwenden ihn im Befehl als Wert für das Argument subscription. 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 Servers für Azure-Datenbank für MySQL

Erstellen Sie mithilfe des Befehls az group create eine Azure-Ressourcengruppe und anschließend in dieser Ressourcengruppe Ihren MySQL-Server. Geben Sie daher einen eindeutigen Namen an. Im folgenden Beispiel wird eine Ressourcengruppe mit dem Namen myresourcegroup am Standort westus erstellt.

az group create --name myresourcegroup --location westus

Erstellen Sie mit dem Befehl az mysql server create einen Azure-Datenbank für MySQL-Server. Ein Server kann mehrere Datenbanken enthalten.

az mysql server create --resource-group myresourcegroup --name mydemoserver --location westus --admin-user myadmin --admin-password <server_admin_password> --sku-name GP_Gen5_2 

Hier sind die Details zu den obigen Argumenten aufgeführt:

Einstellung Beispielwert Beschreibung
name mydemoserver Geben Sie einen eindeutigen Namen für Ihren Azure Database for MySQL-Server ein. Der Servername darf nur Kleinbuchstaben, Zahlen und den Bindestrich (-) enthalten. Es muss zwischen drei und 63 Zeichen lang sein.
resource-group myresourcegroup Geben Sie den Namen der Azure-Ressourcengruppe an.
location westus Der Azure-Standort für den Server.
admin-user myadmin Der Benutzername für die Administratoranmeldung. Dieser darf nicht azure_superuser, admin, administrator, root, guest oder public lauten.
admin-password sicheres Kennwort Das Kennwort des Administratorbenutzers. Es muss zwischen acht und 128 Zeichen lang sein. Das Kennwort muss Zeichen aus drei der folgenden Kategorien enthalten: Englische Großbuchstaben, englische Kleinbuchstaben, Zahlen und nicht alphanumerische Zeichen.
sku-name GP_Gen5_2 Geben Sie den Namen des Tarifs und der Computekonfiguration ein. Folgt der Konvention „{Tarif} {Computegeneration} {virtuelle Kerne}“ in Kurzform. Weitere Informationen finden Sie unter Azure Database for MySQL – Tarife.

Wichtig

Konfigurieren einer Firewallregel auf Serverebene

Der neu erstellte Server ist standardmäßig durch Firewallregeln geschützt und nicht öffentlich zugänglich. Sie können die Firewallregel auf dem Server mithilfe des Befehls az mysql server firewall-rule create konfigurieren. Dadurch können Sie eine lokale Verbindung mit dem Server herstellen.

Das folgende Beispiel erstellt eine Firewallregel namens AllowMyIP, die Verbindungen über eine bestimmte IP-Adresse (192.168.0.1) zulässt. Ersetzen Sie die IP-Adresse, über die Sie eine Verbindung herstellen. Bei Bedarf können Sie einen Bereich von IP-Adressen verwenden. Wenn Sie nicht wissen, wie Sie Ihre IP-Adresse ermitteln, navigieren Sie zu https://whatismyipaddress.com/, um Ihre IP-Adresse abzurufen.

az mysql server firewall-rule create --resource-group myresourcegroup --server mydemoserver --name AllowMyIP --start-ip-address 192.168.0.1 --end-ip-address 192.168.0.1

Hinweis

Die Kommunikation für Verbindungen mit Azure-Datenbank für MySQL erfolgt über Port 3306. Wenn Sie versuchen, eine Verbindung über ein Unternehmensnetzwerk herzustellen, wird ausgehender Datenverkehr über Port 3306 unter Umständen nicht zugelassen. In diesem Fall können Sie nur dann eine Verbindung mit Ihrem Server herstellen, wenn Ihre IT-Abteilung Port 3306 öffnet.

Abrufen der Verbindungsinformationen

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

az mysql server show --resource-group myresourcegroup --name mydemoserver

Das Ergebnis liegt im JSON-Format vor. Notieren Sie sich die Werte für fullyQualifiedDomainName und administratorLogin.

{
  "administratorLogin": "myadmin",
  "earliestRestoreDate": null,
  "fullyQualifiedDomainName": "mydemoserver.mysql.database.azure.com",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.DBforMySQL/servers/mydemoserver",
  "location": "westus",
  "name": "mydemoserver",
  "resourceGroup": "myresourcegroup",
  "sku": {
    "capacity": 2,
    "family": "Gen5",
    "name": "GP_Gen5_2",
    "size": null,
    "tier": "GeneralPurpose"
  },
  "sslEnforcement": "Enabled",
  "storageProfile": {
    "backupRetentionDays": 7,
    "geoRedundantBackup": "Disabled",
    "storageMb": 5120
  },
  "tags": null,
  "type": "Microsoft.DBforMySQL/servers",
  "userVisibleState": "Ready",
  "version": "5.7"
}

Herstellen einer Verbindung mit dem Azure Database for MySQL-Server mithilfe des mysql-Befehlszeilenclients

Für die Verbindungsherstellung mit Ihrem Server können Sie das beliebte Clientbefehlszeilentool mysql.exe mit Azure Cloud Shell verwenden. Alternativ können Sie die mysql-Befehlszeile in Ihrer lokalen Umgebung nutzen.

 mysql -h mydemoserver.mysql.database.azure.com -u myadmin@mydemoserver -p

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 mysql server delete ausführen.

az mysql server delete --resource-group myresourcegroup --name mydemoserver

Nächste Schritte