Partager via

Configurer les paramètres de serveur dans Azure Database pour MariaDB à l’aide de l’interface de ligne de commande Azure

  • Article

Important

Azure Database for MariaDB est en voie de mise hors service. Nous vous recommandons vivement de migrer vers Azure Database pour MySQL. Pour plus d’informations sur la migration vers Azure Database pour MySQL, consultez Qu’est-ce qui se passe dans Azure Database for MariaDB ?.

Vous pouvez répertorier, afficher et mettre à jour les paramètres de configuration d’un serveur Azure Database pour MariaDB à l’aide d’Azure CLI, l’utilitaire en ligne de commande Azure. Un sous-ensemble de configurations de moteur est exposé au niveau du serveur et peut être modifié.

Notes

Les paramètres serveur peuvent être mis à jour globalement au niveau du serveur à partir d’Azure CLI, de PowerShell ou du portail Azure.

Prérequis

Pour parcourir ce guide pratique, vous avez besoin des éléments suivants :

Répertorier les paramètres de configuration de serveur pour Azure Database pour MariaDB

Pour répertorier tous les paramètres modifiables sur un serveur, ainsi que leurs valeurs, exécutez la commande az mariadb server configuration list.

Vous pouvez répertorier les paramètres de configuration du serveur mydemoserver.mariadb.database.azure.com du groupe de ressources myresourcegroup.

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

Pour obtenir la définition de chacun des paramètres répertoriés, consultez la section de référence MariaDB dans Server System Variables (Variables système du serveur).

Affichage des détails des paramètres de configuration du serveur

Pour afficher les détails d’un paramètre de configuration particulier pour un serveur, exécutez la commande az mariadb server configuration show.

Cet exemple affiche les détails du paramètre de configuration de serveur slow_query_log pour le serveur mydemoserver.mariadb.database.azure.com du groupe de ressources myresourcegroup.

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

Modifier une valeur de paramètre de configuration de serveur

Vous pouvez également modifier la valeur d’un paramètre de configuration de serveur, ce qui a pour effet de mettre à jour la valeur de configuration sous-jacente du moteur du serveur MariaDB. Pour mettre à jour la configuration, exécutez la commande az mariadb server configuration set.

Pour mettre à jour le paramètre de configuration de serveur slow_query_log pour le serveur mydemoserver.mariadb.database.azure.com du groupe de ressources myresourcegroup.

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

Si vous souhaitez réinitialiser la valeur d’un paramètre de configuration, omettez le paramètre --value facultatif. Le service applique alors la valeur par défaut. Pour l’exemple ci-dessus, on aurait ce qui suit :

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

Ce code réinitialise la configuration slow_query_log sur la valeur par défaut OFF.

Configurer les paramètres non listés

Si le paramètre de serveur que vous souhaitez mettre à jour n’est pas listé dans le portail Azure, vous pouvez éventuellement définir le paramètre au niveau de la connexion avec init_connect. Cela définit les paramètres de serveur pour chaque client qui se connecte.

Mettez à jour le paramètre init_connect de configuration du serveur du serveur mydemoserver.mariadb.database.azure.com sous le groupe de ressources myresourcegroup pour définir les valeurs comme le jeu de caractères.

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;"

Utilisation avec le paramètre de fuseau horaire

Remplissage des tables de fuseaux horaires

Les tables de fuseaux horaires sur votre serveur peuvent être remplies en appelant la procédure stockée mysql.az_load_timezone à partir d’un outil tel que la ligne de commande MariaDB ou MariaDB Workbench.

Remarque

Si vous exécutez la commande mysql.az_load_timezone à partir de MariaDB Workbench, vous devrez peut-être d’abord désactiver le mode de mise à jour sécurisée à l’aide de SET SQL_SAFE_UPDATES=0;.

CALL mysql.az_load_timezone();

Important

Vous devez redémarrer le serveur pour vous assurer que les tables des fuseaux horaires sont correctement remplies. Pour redémarrer le serveur, utilisez le Portail Azure ou CLI.

Pour afficher les valeurs de fuseau horaire disponibles, exécutez la commande suivante :

SELECT name FROM mysql.time_zone_name;

Définition du fuseau horaire global

Le fuseau horaire global peut être défini à l’aide de la commande az mariadb server configuration set.

La commande suivante met à jour le paramètre de configuration de serveur time_zone du serveur mydemoserver.mariadb.database.azure.com dans le groupe de ressources myresourcegroup sur US/Pacific.

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

Définition du fuseau horaire de la session

Le fuseau horaire de la session peut être défini en exécutant la commande SET time_zone à partir d’un outil tel que la ligne de commande MariaDB ou MariaDB Workbench. L’exemple ci-dessous définit le fuseau horaire US/Pacific.

SET time_zone = 'US/Pacific';

Reportez-vous à la documentation de MariaDB relative aux fonction de date et heure.

Étapes suivantes