Schnellstart: Erstellen eines Azure Database for MySQL-Servers mit PowerShell
GILT FÜR:
Azure Database for MySQL – Single Server
Wichtig
Azure Database for MySQL Single Server wird eingestellt. Es wird dringend empfohlen, ein Upgrade auf Azure Database for MySQL Flexible Server auszuführen. Weitere Informationen zum Migrieren zu Azure Database for MySQL Flexible Server finden Sie unter Was geschieht mit Azure Database for MySQL Single Server?
In dieser Schnellstartanleitung wird die Verwendung von PowerShell zum Erstellen eines Azure Database for MySQL-Servers in einer Azure-Ressourcengruppe beschrieben. Sie können PowerShell verwenden, um Azure-Ressourcen interaktiv oder in Skripts zu erstellen und zu verwalten.
Voraussetzungen
Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.
Falls Sie PowerShell lokal verwenden möchten, müssen Sie für diesen Artikel das Az PowerShell-Modul installieren und mit dem Cmdlet Connect-AzAccount eine Verbindung mit Ihrem Azure-Konto herstellen. Weitere Informationen zum Installieren des Az PowerShell-Moduls finden Sie unter Installieren von Azure PowerShell.
Wichtig
Solange nur eine Vorschauversion des PowerShell-Moduls „Az.MySql“ verfügbar ist, müssen Sie es separat über das AZ PowerShell-Modul installieren. Verwenden Sie dazu den folgenden Befehl: Install-Module -Name Az.MySql -AllowPrerelease.
Sobald das PowerShell-Modul „Az.MySql“ allgemein verfügbar ist, wird es in die zukünftigen Releases des Az PowerShell-Moduls integriert und in Azure Cloud Shell nativ zur Verfügung gestellt.
Falls Sie den Dienst „Azure Database for MySQL“ zum ersten Mal verwenden, müssen Sie den Ressourcenanbieter Microsoft.DBforMySQL registrieren.
Register-AzResourceProvider -ProviderNamespace Microsoft.DBforMySQL
Azure Cloud Shell
Azure hostet Azure Cloud Shell, eine interaktive Shell-Umgebung, die Sie über Ihren Browser nutzen können. Sie können entweder Bash oder PowerShell mit Cloud Shell verwenden, um mit Azure-Diensten zu arbeiten. Sie können die vorinstallierten Befehle von Cloud Shell verwenden, um den Code in diesem Artikel auszuführen, ohne etwas in Ihrer lokalen Umgebung installieren zu müssen.
Starten von Azure Cloud Shell:
| Option | Beispiel/Link |
|---|---|
| Wählen Sie rechts oben in einem Code- oder Befehlsblock die Option Ausprobieren aus. Durch die Auswahl von Ausprobieren wird der Code oder Befehl nicht automatisch in Cloud Shell kopiert. |  |
| Rufen Sie https://shell.azure.com auf, oder klicken Sie auf die Schaltfläche Cloud Shell starten, um Cloud Shell im Browser zu öffnen. |  |
| Wählen Sie im Azure-Portal rechts oben im Menü die Schaltfläche Cloud Shell aus. |  |
So verwenden Sie Azure Cloud Shell:
Starten Sie Cloud Shell.
Wählen Sie die Schaltfläche Kopieren für einen Codeblock (oder Befehlsblock) aus, um den Code oder Befehl zu kopieren.
Fügen Sie den Code oder Befehl mit STRG+UMSCHALT+V unter Windows und Linux oder CMD+UMSCHALT+V unter macOS in die Cloud Shell-Sitzung ein.
Drücken Sie die EINGABETASTE, um den Code oder Befehl auszuführen.
Wenn Sie über mehrere Azure-Abonnements verfügen, müssen Sie das entsprechende Abonnement auswählen, in dem die Ressourcen fakturiert werden sollen. Wählen Sie mit dem Cmdlet Set-AzContext eine bestimmte Abonnement-ID aus.
Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
Erstellen einer Ressourcengruppe
Erstellen Sie mit dem Cmdlet New-AzResourceGroup eine Azure-Ressourcengruppe. Eine Ressourcengruppe ist ein logischer Container, in dem Azure-Ressourcen als Gruppe bereitgestellt und verwaltet werden.
Im folgenden Beispiel wird eine Ressourcengruppe mit dem Namen myresourcegroup in der Region USA, Westen erstellt.
New-AzResourceGroup -Name myresourcegroup -Location westus
Erstellen eines Servers für Azure-Datenbank für MySQL
Erstellen Sie mit dem Cmdlet New-AzMySqlServer einen Azure Database for MySQL-Server. Ein Server kann mehrere Datenbanken verwalten. In der Regel wird für jedes Projekt oder jeden Benutzer eine separate Datenbank verwendet.
Die folgende Tabelle enthält eine Liste mit den häufig verwendeten Parametern und Beispielwerten für das Cmdlet New-AzMySqlServer.
| Einstellung | Beispielwert | Beschreibung |
|---|---|---|
| Name | mydemoserver | Wählen Sie einen für Azure global eindeutigen Namen aus, mit dem Ihr Azure Database for MySQL-Server identifiziert wird. Der Servername darf nur Buchstaben, Zahlen und den Bindestrich (-) enthalten. Beim Erstellungsvorgang werden alle angegebenen Großbuchstaben automatisch in Kleinbuchstaben konvertiert. Es muss zwischen drei und 63 Zeichen lang sein. |
| ResourceGroupName | myresourcegroup | Geben Sie den Namen der Azure-Ressourcengruppe an. |
| Sku | GP_Gen5_2 | Der Name der SKU. Folgt der Konvention Tarif_Computegeneration_virtuelle Kerne in Kurzform. Weitere Informationen zum SKU-Parameter finden Sie in den Informationen, die auf diese Tabelle folgen. |
| BackupRetentionDay | 7 | Gibt die Aufbewahrungsdauer für eine Sicherung an. Die Einheit ist Tage. Der Bereich umfasst 7 bis 35. |
| GeoRedundantBackup | Aktiviert | Gibt an, ob georedundante Sicherungen für diesen Server aktiviert werden sollen. Dieser Wert kann für Server mit dem Tarif „Basic“ nicht aktiviert und nach der Erstellung des Servers nicht mehr geändert werden. Zulässige Werte: „Aktiviert“, „Deaktiviert“ |
| Standort | westus | Die Azure-Region für den Server. |
| SslEnforcement | Aktiviert | Gibt an, ob SSL für diesen Server aktiviert werden soll. Zulässige Werte: „Aktiviert“, „Deaktiviert“ |
| StorageInMb | 51.200 | Die Speicherkapazität des Servers (Einheit: MB). Für „Valid StorageInMb“ gilt ein Mindestwert von 5.120 MB, der in Schritten von jeweils 1.024 MB erhöht werden kann. Weitere Informationen zu Grenzwerten für die Speichergröße finden Sie unter Azure Database for MySQL – Tarife. |
| Version | 5.7 | Die MySQL-Hauptversion. |
| AdministratorUserName | myadmin | Der Benutzername für die Administratoranmeldung. Dieser darf nicht azure_superuser, admin, administrator, root, guest oder public lauten. |
| AdministratorLoginPassword | <securestring> |
Das Kennwort des Administratorbenutzers in Form einer sicheren Zeichenfolge. 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. |
Für den Parameterwert Sku wird das Format Tarif_Computegeneration_virtuelle Kerne verwendet. Dies ist in den folgenden Beispielen dargestellt.
-Sku B_Gen5_1ist „Basic“, „Gen 5“ und „1 virtueller Kern“ zugeordnet. Bei dieser Option handelt es sich um die kleinste verfügbare SKU.-Sku GP_Gen5_32ist „Universell“, „Gen 5“ und „32 V-Kerne“ zugeordnet.-Sku MO_Gen5_2ist „Arbeitsspeicheroptimiert“, „Gen 5“ und „2 V-Kerne“ zugeordnet.
Informationen zu den gültigen Werten für Sku nach Region und für Tarife finden Sie unter Azure Database for MySQL – Tarife.
Im folgenden Beispiel wird ein MySQL-Server in der Region USA, Westen mit dem Namen mydemoserver in der Ressourcengruppe myresourcegroup erstellt. Der Benutzername für den Serveradministrator lautet myadmin. Es handelt sich um einen Gen 5-Server im Tarif „Universell“ mit zwei virtuellen Kernen und Aktivierung von georedundanten Sicherungen. Notieren Sie sich das Kennwort, das in der ersten Zeile des Beispiels verwendet wird, da dies das Kennwort für das Administratorkonto des MySQL-Servers ist.
Tipp
Ein Servername wird einem DNS-Namen zugeordnet und muss in Azure global eindeutig sein.
$Password = Read-Host -Prompt 'Please enter your password' -AsSecureString
New-AzMySqlServer -Name mydemoserver -ResourceGroupName myresourcegroup -Sku GP_Gen5_2 -GeoRedundantBackup Enabled -Location westus -AdministratorUsername myadmin -AdministratorLoginPassword $Password
Ziehen Sie die Verwendung des Tarifs „Basic“ in Betracht, wenn eine geringe Compute- und E/A-Leistung für Ihre Workload ausreichend ist.
Wichtig
Server, die unter dem Tarif „Basic“ erstellt wurden, können später nicht auf „Universell“ oder „Arbeitsspeicheroptimiert“ skaliert und nicht georepliziert werden.
Konfigurieren einer Firewallregel
Erstellen Sie eine Firewallregel auf der Ebene des Azure Database for MySQL-Servers, indem Sie das Cmdlet New-AzMySqlFirewallRule verwenden. Eine Firewallregel auf Serverebene ermöglicht es einer externen Anwendung, z. B. dem Befehlszeilentool mysql oder MySQL Workbench, über die Firewall des Diensts „Azure Database for MySQL“ eine Verbindung mit Ihrem Server herzustellen.
Im folgenden Beispiel wird eine Firewallregel mit dem Namen AllowMyIP erstellt, die Verbindungen über eine bestimmte IP-Adresse (192.168.0.1) zulässt. Geben Sie gemäß dem Standort, von dem aus Sie eine Verbindung herstellen, eine IP-Adresse oder einen Bereich mit IP-Adressen an.
New-AzMySqlFirewallRule -Name AllowMyIP -ResourceGroupName myresourcegroup -ServerName mydemoserver -StartIPAddress 192.168.0.1 -EndIPAddress 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 Szenario können Sie nur dann eine Verbindung mit dem Server herstellen, wenn Ihre IT-Abteilung Port 3306 öffnet.
Konfigurieren der SSL-Einstellungen
Standardmäßig werden SSL-Verbindungen zwischen Ihrem Server und Clientanwendungen erzwungen. Mit dieser Standardeinstellung wird die Sicherheit von Daten während des Betriebs gewährleistet, indem der Datenstrom über das Internet verschlüsselt wird. Für diesen Schnellstart deaktivieren Sie SSL-Verbindungen für Ihren Server. Weitere Informationen finden Sie unter Konfigurieren von SSL-Verbindungen in der Anwendung für eine sichere Verbindung mit Azure-Datenbank für MySQL.
Warnung
Das Deaktivieren von SSL ist für Produktionsserver aber nicht zu empfehlen.
Im folgenden Beispiel wird SSL auf Ihrem Azure Database for MySQL-Server deaktiviert.
Update-AzMySqlServer -Name mydemoserver -ResourceGroupName myresourcegroup -SslEnforcement Disabled
Abrufen der Verbindungsinformationen
Zum Herstellen einer Verbindung zum Server müssen Sie Hostinformationen und Anmeldeinformationen für den Zugriff angeben. Verwenden Sie das folgende Beispiel, um die Verbindungsinformationen zu ermitteln. Notieren Sie sich die Werte für FullyQualifiedDomainName und AdministratorLogin.
Get-AzMySqlServer -Name mydemoserver -ResourceGroupName myresourcegroup |
Select-Object -Property FullyQualifiedDomainName, AdministratorLogin
FullyQualifiedDomainName AdministratorLogin
------------------------ ------------------
mydemoserver.mysql.database.azure.com myadmin
Herstellen einer Verbindung mit dem Server mit dem Befehlszeilentool „mysql“
Stellen Sie mit dem Befehlszeilentool mysql eine Verbindung mit Ihrem Server her. Informationen zum Herunterladen und Installieren des Befehlszeilentools finden Sie unter MySQL Community Downloads. Sie können auch auf eine vorinstallierte Version des Befehlszeilentools mysql in Azure Cloud Shell zugreifen, indem Sie in einem Codebeispiel dieses Artikels die Schaltfläche Jetzt ausprobieren auswählen. Weitere Möglichkeiten zum Zugreifen auf Azure Cloud Shell sind das Auswählen der Schaltfläche >_ auf der Symbolleiste oben rechts im Azure-Portal oder das Navigieren zu shell.azure.com.
Stellen Sie mit dem Befehlszeilentool
mysqleine Verbindung mit dem Server her.mysql -h mydemoserver.mysql.database.azure.com -u myadmin@mydemoserver -pZeigen Sie den Serverstatus an.
mysql> statusC:\Users\>mysql -h mydemoserver.mysql.database.azure.com -u myadmin@mydemoserver -p Enter password: ************* Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 65512 Server version: 5.6.42.0 MySQL Community Server (GPL) Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. mysql> status -------------- mysql Ver 14.14 Distrib 5.7.29, for Win64 (x86_64) Connection id: 65512 Current database: Current user: myadmin@myipaddress SSL: Not in use Using delimiter: ; Server version: 5.6.42.0 MySQL Community Server (GPL) Protocol version: 10 Connection: mydemoserver.mysql.database.azure.com via TCP/IP Server characterset: latin1 Db characterset: latin1 Client characterset: utf8 Conn. characterset: utf8 TCP port: 3306 Uptime: 1 hour 2 min 12 sec Threads: 7 Questions: 952 Slow queries: 0 Opens: 66 Flush tables: 3 Open tables: 16 Queries per second avg: 0.255 -------------- mysql>
Zusätzliche Befehle finden Sie unter MySQL 5.7-Referenzhandbuch – Kapitel 4.5.1.
Herstellen einer Verbindung mit dem Server unter Verwendung von MySQL Workbench
Starten Sie die Anwendung MySQL Workbench auf dem Clientcomputer. Informationen zum Herunterladen und Installieren von MySQL Workbench finden Sie unter Download MySQL Workbench.
Geben Sie im Dialogfeld Setup New Connection (Neue Verbindung einrichten) auf der Registerkarte Parameter folgende Informationen ein:
Einstellung Empfohlener Wert Beschreibung Verbindungsname Eigene Verbindung Geben Sie eine Bezeichnung für diese Verbindung an. Verbindungsmethode Standard (TCP/IP) Verwenden Sie das TCP/IP-Protokoll zum Herstellen einer Verbindung mit Azure Database for MySQL Hostname mydemoserver.mysql.database.azure.comDer zuvor notierte Servername. Port 3306 Der Standardport für MySQL. Username myadmin@mydemoserver Der zuvor notierte Benutzername für den Serveradministrator. Kennwort ************* Verwenden Sie das Kennwort des Administratorkontos, das Sie zuvor konfiguriert haben. Klicken Sie auf die Schaltfläche Verbindung testen, um zu testen, ob die Parameter richtig konfiguriert sind.
Wählen Sie die Verbindung aus, die für die Verbindungsherstellung mit dem Server verwendet werden soll.
Bereinigen von Ressourcen
Wenn Sie die in dieser Schnellstartanleitung erstellten Ressourcen nicht für eine andere Schnellstartanleitung oder ein anderes Tutorial benötigen, können Sie sie löschen, indem Sie das folgende Beispiel ausführen.
Achtung
Im folgenden Beispiel werden die angegebene Ressourcengruppe und alle darin enthaltenen Ressourcen gelöscht. Falls in der angegebenen Ressourcengruppe Ressourcen enthalten sind, die nicht zum Umfang dieser Schnellstartanleitung gehören, werden sie ebenfalls gelöscht.
Remove-AzResourceGroup -Name myresourcegroup
Verwenden Sie das Cmdlet Remove-AzMySqlServer, um nur den in dieser Schnellstartanleitung erstellten Server ohne die Ressourcengruppe zu löschen.
Remove-AzMySqlServer -Name mydemoserver -ResourceGroupName myresourcegroup