Configurer les paramètres de serveur dans Azure Database pour MySQL – Serveur flexible à l’aide d’Azure CLI
Vous pouvez répertorier, afficher et mettre à jour les paramètres d’une instance de serveur flexible Azure Database pour MySQL à l’aide d’Azure CLI, l’utilitaire de ligne de commande Azure. Les paramètres de serveur sont configurés avec la valeur par défaut et la valeur recommandée lors de la création du serveur.
Cet article explique comment répertorier, afficher et mettre à jour les paramètres du serveur à l’aide d’Azure CLI.
Remarque
Les paramètres de serveur peuvent être mis à jour globalement au niveau du serveur, utilisez Configurer des paramètres de serveur dans Azure Database pour MySQL : serveur flexible à l’aide d'Azure CLI ou Configurer des paramètres de serveur dans Azure Database pour MySQL : serveur flexible à l’aide du portail Azure
Prérequis
Pour parcourir ce guide pratique, vous avez besoin des éléments suivants :
- Démarrage rapide : créer une instance d'Azure Database pour MySQL : serveur flexible à l’aide d'Azure CLI
- L’utilitaire en ligne de commande Azure CLI ou Azure Cloud Shell dans le navigateur.
Répertoriez les paramètres du serveur pour une instance de serveur flexible Azure Database pour MySQL
Pour répertorier tous les paramètres d’une instance de serveur flexible Azure Database pour MySQL et leurs valeurs, exécutez la commande az mysql flexible-server parameter list.
Vous pouvez répertorier les paramètres de serveur pour le serveur mydemoserver.mysql.database.azure.com du groupe de ressources myresourcegroup.
az mysql flexible-server parameter list --resource-group myresourcegroup --server-name 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).
Afficher les détails des paramètres du serveur
Pour afficher les détails d’un paramètre particulier pour une instance de serveur flexible Azure Database pour MySQL, exécutez la commande az mysql flexible-server parameter show.
Cet exemple affiche les détails du paramètre de serveur slow_query_log pour le serveur mydemoserver.mysql.database.azure.com du groupe de ressources myresourcegroup.
az mysql flexible-server parameter show --name slow_query_log --resource-group myresourcegroup --server-name mydemoserver
Modifier une valeur de paramètre de serveur
Vous pouvez également modifier la valeur d’un certain paramètre d’instance de serveur flexible Azure Database pour MySQL, ce qui met à jour la valeur de configuration sous-jacente du moteur de serveur MySQL. Pour mettre à jour le paramètre de serveur, utilisez la commande az mysql flexible-server parameter set.
Pour mettre à jour le paramètre de serveur slow_query_log du serveur mydemoserver.mysql.database.azure.com du groupe de ressources myresourcegroup.
az mysql flexible-server parameter set --name slow_query_log --resource-group myresourcegroup --server-name mydemoserver --value ON
Pour mettre à jour plusieurs paramètres de serveur comme slow_query_log et audit_log_enabled du serveur mydemoserver.mysql.database.azure.com du groupe de ressources 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"
Si vous souhaitez réinitialiser la valeur d’un paramètre, 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 flexible-server parameter set --name slow_query_log --resource-group myresourcegroup --server-name mydemoserver
Ce code réinitialise le paramètre slow_query_log à la valeur par défaut OFF.
Ensemble de paramètres de serveur non modifiables
Si le paramètre du serveur flexible Azure Database pour MySQL que vous souhaitez mettre à jour n’est pas modifiable, vous pouvez éventuellement définir le paramètre au niveau de la connexion à l’aide de init_connect. Cela définit les paramètres de serveur pour chaque client qui se connecte.
Mettez à jour le paramètre de serveur init_connect du serveur mydemoserver.mysql.database.azure.com dans le groupe de ressources myresourcegroup pour définir les valeurs comme jeu de caractères.
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;"
Notes
init_connect peut être utilisé pour modifier des paramètres qui ne nécessitent pas de privilèges de super utilisateur (SUPER) au niveau de la session. Pour vérifier si vous pouvez définir le paramètre avec init_connect, exécutez la commande set session parameter_name=YOUR_DESIRED_VALUE; et, si vous obtenez une erreur Accès refusé. Vous devez avoir des privilèges SUPER, cela indique que vous n’êtes pas autorisé à définir le paramètre avec « init_connect ».
Utiliser avec le paramètre de fuseau horaire
Définir le fuseau horaire global
Le fuseau horaire global peut être défini à l’aide de la commande az mysql flexible-server parameter set.
La commande suivante met à jour le paramètre de serveur time_zone du serveur mydemoserver.mysql.database.azure.com dans le groupe de ressources myresourcegroup sur US/Pacific.
az mysql flexible-server parameter set --name time_zone --resource-group myresourcegroup --server-name mydemoserver --value "US/Pacific"
Définir le 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.
Notes
Pour modifier le fuseau horaire au niveau de la session, le paramètre de serveur time_zone doit être mis à jour globalement vers le fuseau horaire requis au moins une fois, afin de mettre à jour la table mysql.time_zone_name.