Konfigurieren von Serverparametern in Azure Database for MySQL – Flexible Server über die Azure CLI
Sie können Parameter für eine Instanz von Azure Database for MySQL – flexibler Server mithilfe von Azure CLI, dem Azure-Befehlszeilenhilfsprogramm, auflisten, anzeigen und aktualisieren. Die Serverparameter werden beim Erstellen des Servers mit einem Standardwert und einem empfohlenen Wert konfiguriert.
In diesem Artikel wird beschrieben, wie Serverparameter mithilfe der Azure CLI aufgelistet, angezeigt und aktualisiert werden können.
Hinweis
Serverparameter können global auf Serverebene aktualisiert werden Nutzen Sie die Anleitungen unter Konfigurieren von Serverparametern in Azure Database for MySQL – flexibler Server über die Azure CLI oder Konfigurieren von Serverparametern in Azure Database for MySQL – flexibler Server über das Azure-Portal.
Voraussetzungen
Zum Ausführen der Schritte in dieser Anleitung benötigen Sie Folgendes:
- Schnellstart: Erstellen einer Instanz von Azure Database for MySQL – Flexibler Server mithilfe der Azure CLI
- Das Befehlszeilenprogramm Azure CLI oder Azure Cloud Shell im Browser
Auflisten von Serverparametern für eine Instanz von Azure Database for MySQL – flexibler Server
Führen Sie zum Auflisten aller Parameter und deren Werte in einer Instanz von Azure Database for MySQL – flexibler Server den Befehl az mysql flexible-server parameter list aus.
Sie können die Serverparameter für den Server mydemoserver.mysql.database.azure.com in der Ressourcengruppe myresourcegroup auflisten.
az mysql flexible-server parameter list --resource-group myresourcegroup --server-name mydemoserver
Die Definition der einzelnen aufgeführten Parameter finden Sie in der MySQL-Referenz im Abschnitt Server System Variables.
Anzeigen von Serverparameterdetails
Um Details zu einem bestimmten Parameter für eine Instanz von Azure Database for MySQL – flexibler Server anzuzeigen, führen Sie den Befehl az mysql flexible-server parameter show aus.
Dieses Beispiel zeigt Details des Serverparameters slow_query_log für den Server mydemoserver.mysql.database.azure.com in der Ressourcengruppe myresourcegroup.
az mysql flexible-server parameter show --name slow_query_log --resource-group myresourcegroup --server-name mydemoserver
Ändern eines Serverparameterwerts
Sie können auch den Wert des Parameters einer bestimmten Instanz von Azure Database for MySQL – flexibler Server ebenfalls ändern, wodurch der zugrundeliegende Konfigurationswert für das MySQL-Servermodul aktualisiert wird. Um den Serverparameter zu aktualisieren, verwenden Sie den Befehl az mysql flexible-server parameter set.
So aktualisieren Sie den Serverparameter slow_query_log für den Server mydemoserver.mysql.database.azure.com in der Ressourcengruppe myresourcegroup:
az mysql flexible-server parameter set --name slow_query_log --resource-group myresourcegroup --server-name mydemoserver --value ON
So aktualisieren Sie mehrere Serverparameter wie slow_query_log und audit_log_enabled des Servers mydemoserver.mysql.database.azure.com unter der Ressourcengruppe myresourcegroup.
az mysql flexible-server parameter set-batch -resource-group myresourcegroup --server-name mydemoserver --source "user-override" --args slow_query_log="ON" audit_log_enabled="ON"
Wenn Sie den Wert eines Parameters zurücksetzen möchten, lassen Sie den optionalen Parameter --value weg. Der Dienst übernimmt dann den Standardwert. Im obigen Beispiel sieht dies so aus:
az mysql flexible-server parameter set --name slow_query_log --resource-group myresourcegroup --server-name mydemoserver
Dieser Code setzt slow_query_log auf den Standardwert OFF zurück.
Nicht änderbare Serverparameter festlegen
Wenn der Parameter von Azure Database for MySQL – flexibler Server, den Sie aktualisieren möchten, nicht änderbar ist, können Sie den Parameter optional mithilfe von init_connect auf Verbindungsebene festlegen. Damit werden die Serverparameter für jeden Client, der mit dem Server verbinden wird, festgelegt.
Aktualisieren Sie den Serverparameter init_connect des Servers mydemoserver.mysql.database.azure.com in der Ressourcengruppe myresourcegroup, um Werte wie den Zeichensatz festzulegen.
az mysql flexible-server parameter set --name init_connect --resource-group myresourcegroup --server-name mydemoserver --value "SET character_set_client=utf8;SET character_set_database=utf8mb4;SET character_set_connection=latin1;SET character_set_results=latin1;"
Hinweis
init_connect kann zum Ändern von Parametern verwendet werden, für die auf Sitzungsebene keine SUPER-Berechtigungen erforderlich sind. Führen Sie zum Überprüfen, ob Sie den Parameter mit init_connect festlegen können, den Befehl set session parameter_name=YOUR_DESIRED_VALUE; aus. Falls ein Fehler der Art Zugriff verweigert; Sie benötigen SUPER-Berechtigungen angezeigt wird, ist das Festlegen des Parameters mit „init_connect“ nicht möglich.
Mit dem Zeitzonenparameter arbeiten
Globale Zeitzone festlegen
Die globale Zeitzone kann mithilfe des Befehls az mysql flexible-server parameter set festgelegt werden.
Der folgende Befehl ändert den Serverparameter time_zone für den Server mydemoserver.mysql.database.azure.com in der Ressourcengruppe myresourcegroup in US/Pacific.
az mysql flexible-server parameter set --name time_zone --resource-group myresourcegroup --server-name mydemoserver --value "US/Pacific"
Sitzungszeitzone festlegen
Die Sitzungszeitzone kann durch Ausführen des Befehls SET time_zone in einem Tool wie der MySQL-Befehlszeile oder MySQL Workbench festgelegt werden. Im folgenden Beispiel wird die Zeitzone auf US/Pacific festgelegt.
SET time_zone = 'US/Pacific';
Informationen zu Datums- und Uhrzeitfunktionen finden Sie in der MySQL-Dokumentation.
Hinweis
Um die Zeitzone auf Sitzungsebene zu ändern, muss der Serverparameter time_zone mindestens einmal global auf die erforderliche Zeitzone aktualisiert werden, um die Tabelle mysql.time_zone_name zu aktualisieren.