Konfigurieren von Serverparametern in Azure Database for MariaDB mit der Azure CLI

Wichtig

Azure Database for MariaDB wird demnächst eingestellt. Es wird dringend empfohlen, zu Azure Database for MySQL zu migrieren. Weitere Informationen zum Migrieren zur Azure-Datenbank für MySQL finden Sie unter Was geschieht mit Azure Database for MariaDB?.

Sie können Konfigurationsparameter für einen Azure Database for MariaDB-Server mithilfe der Azure-Befehlszeilenschnittstelle (Azure CLI) auflisten, anzeigen und aktualisieren. Auf Serverebene ist eine Teilmenge der Engine-Konfigurationen verfügbar und kann geändert werden.

Hinweis

Serverparameter können global auf Serverebene aktualisiert werden. Verwenden Sie dazu die Azure CLI, PowerShell oder das Azure-Portal.

Voraussetzungen

Zum Ausführen der Schritte in dieser Anleitung benötigen Sie Folgendes:

Auflisten der Serverkonfigurationsparameter für Azure Database for MariaDB

Führen Sie den Befehl az mariadb server configuration list aus, um alle änderbaren Parameter eines Servers mit ihren Werten aufzulisten.

Sie können die Serverkonfigurationsparameter für den Server mydemoserver.mariadb.database.azure.com in der Ressourcengruppe myresourcegroup auflisten.

az mariadb server configuration list --resource-group myresourcegroup --server mydemoserver

Die Definition der einzelnen aufgeführten Parameter finden Sie in der MariaDB-Referenz im Abschnitt Server System Variables.

Anzeigen von Details zu Serverkonfigurationsparametern

Um Details zu einem bestimmten Konfigurationsparameter für einen Server anzuzeigen, führen Sie den Befehl az mariadb server configuration show aus.

Dieses Beispiel zeigt Details des Serverkonfigurationsparameters slow_query_log für den Server mydemoserver.mariadb.database.azure.com in der Ressourcengruppe myresourcegroup.

az mariadb server configuration show --name slow_query_log --resource-group myresourcegroup --server mydemoserver

Ändern des Werts von Serverkonfigurationsparametern

Sie können den Wert eines bestimmten Serverkonfigurationsparameters ändern und dadurch den zugrunde liegenden Konfigurationswert für die MariaDB-Server-Engine aktualisieren. Um die Konfiguration zu aktualisieren, führen Sie den Befehl az mariadb server configuration set aus.

So aktualisieren Sie den Serverkonfigurationsparameter slow_query_log für den Server mydemoserver.mariadb.database.azure.com in der Ressourcengruppe myresourcegroup:

az mariadb server configuration set --name slow_query_log --resource-group myresourcegroup --server mydemoserver --value ON

Wenn Sie den Wert eines Konfigurationsparameters zurücksetzen möchten, lassen Sie den optionalen Parameter --value weg. Der Dienst wendet dann den Standardwert an. Im obigen Beispiel sieht dies so aus:

az mariadb server configuration set --name slow_query_log --resource-group myresourcegroup --server mydemoserver

Dieser Code setzt die Konfiguration slow_query_log auf den Standardwert OFF zurück.

Nicht aufgeführte Einstellungsparameter

Wenn der Serverparameter, den Sie aktualisieren möchten, nicht im Azure-Portal aufgeführt 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 Serverkonfigurationsparameter init_connect des Servers mydemoserver.mariadb.database.azure.com in der Ressourcengruppe myresourcegroup, um Werte wie den Zeichensatz festzulegen.

az mariadb server configuration set --name init_connect --resource-group myresourcegroup --server mydemoserver --value "SET character_set_client=utf8;SET character_set_database=utf8mb4;SET character_set_connection=latin1;SET character_set_results=latin1;"

Arbeiten mit dem Zeitzonenparameter

Auffüllen der Zeitzonentabellen

Die Zeitzonentabellen auf Ihrem Server können durch Aufrufen der gespeicherten Prozedur mysql.az_load_timezone über ein Tool wie die MariaDB-Befehlszeile oder MariaDB Workbench aufgefüllt werden.

Hinweis

Wenn Sie den Befehl mysql.az_load_timezone in MariaDB Workbench ausführen, müssen Sie unter Umständen zuerst den sicheren Aktualisierungsmodus mit SET SQL_SAFE_UPDATES=0; deaktivieren.

CALL mysql.az_load_timezone();

Wichtig

Sie sollten den Server neu starten, um sicherzustellen, dass die Zeitzonentabellen ordnungsgemäß aufgefüllt werden. Um den Server neu zu starten, verwenden Sie das Azure-Portal oder die Befehlszeilenschnittstelle.

Um die verfügbaren Zeitzonenwerte anzuzeigen, führen Sie den folgenden Befehl aus:

SELECT name FROM mysql.time_zone_name;

Festlegen der globalen Zeitzone

Die globale Zeitzone kann mithilfe des Befehls az mariadb server configuration set festgelegt werden.

Der folgende Befehl ändert den Serverkonfigurationsparameter time_zone für den Server mydemoserver.mariadb.database.azure.com in der Ressourcengruppe myresourcegroup in US/Pacific.

az mariadb server configuration set --name time_zone --resource-group myresourcegroup --server mydemoserver --value "US/Pacific"

Festlegen der Sitzungszeitzone

Die Sitzungszeitzone kann durch Ausführen des Befehls SET time_zone in einem Tool wie der MariaDB-Befehlszeile oder MariaDB 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 MariaDB-Dokumentation.

Nächste Schritte