Configurer les paramètres de serveur dans Azure Database pour MySQL avec l’interface de ligne de commande Azure

  • Article

S’APPLIQUE À : Azure Database pour MySQL - Serveur unique

Important

Azure Database pour MySQL serveur unique se trouve sur le chemin de mise hors service. Nous vous recommandons vivement de procéder à la mise à niveau vers Azure Database pour MySQL serveur flexible. Pour plus d’informations sur la migration vers Azure Database pour MySQL serveur flexible, consultez Ce qui se passe pour Azure Database pour MySQL serveur unique ?

Vous pouvez répertorier, afficher et mettre à jour les paramètres de configuration d’un serveur Azure Database pour MySQL à 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 de 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 MySQL

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

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

az mysql 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 MySQL 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 mysql server configuration show.

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

az mysql 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 MySQL. Pour mettre à jour la configuration, exécutez la commande az mysql server configuration set.

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

az mysql 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 mysql 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 de configuration de serveur init_connect du serveur mydemoserver.mysql.database.azure.com du groupe de ressources myresourcegroup pour définir des valeurs comme jeu de caractères.

az mysql 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 MySQL ou MySQL Workbench.

Notes

Si vous exécutez la commande mysql.az_load_timezone à partir de MySQL 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 mysql server configuration set.

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

az mysql 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 MySQL ou MySQL Workbench. L’exemple ci-dessous définit le fuseau horaire US/Pacific.

SET time_zone = 'US/Pacific';

Reportez-vous à la documentation de MySQL sur les fonction de date et heure.

Étapes suivantes