Configure server parameters in Azure Database for MySQL using the Azure CLI
APPLIES TO: Azure Database for MySQL - Single Server
Tábhachtach
Azure Database for MySQL single server is on the retirement path. We strongly recommend that you upgrade to Azure Database for MySQL flexible server. For more information about migrating to Azure Database for MySQL flexible server, see What's happening to Azure Database for MySQL Single Server?
You can list, show, and update configuration parameters for an Azure Database for MySQL server by using Azure CLI, the Azure command-line utility. A subset of engine configurations is exposed at the server-level and can be modified.
Nóta
Server parameters can be updated globally at the server-level, use the Azure CLI, PowerShell, or Azure portal
To step through this how-to guide, you need:
- An Azure Database for MySQL server
- Azure CLI command-line utility or use the Azure Cloud Shell in the browser.
To list all modifiable parameters in a server and their values, run the az mysql server configuration list command.
You can list the server configuration parameters for the server mydemoserver.mysql.database.azure.com under resource group myresourcegroup.
az mysql server configuration list --resource-group myresourcegroup --server mydemoserver
For the definition of each of the listed parameters, see the MySQL reference section on Server System Variables.
To show details about a particular configuration parameter for a server, run the az mysql server configuration show command.
This example shows details of the slow_query_log server configuration parameter for server mydemoserver.mysql.database.azure.com under resource group myresourcegroup.
az mysql server configuration show --name slow_query_log --resource-group myresourcegroup --server mydemoserver
You can also modify the value of a certain server configuration parameter, which updates the underlying configuration value for the MySQL server engine. To update the configuration, use the az mysql server configuration set command.
To update the slow_query_log server configuration parameter of server mydemoserver.mysql.database.azure.com under resource group myresourcegroup.
az mysql server configuration set --name slow_query_log --resource-group myresourcegroup --server mydemoserver --value ON
If you want to reset the value of a configuration parameter, omit the optional --value
parameter, and the service applies the default value. For the example above, it would look like:
az mysql server configuration set --name slow_query_log --resource-group myresourcegroup --server mydemoserver
This code resets the slow_query_log configuration to the default value OFF.
If the server parameter you want to update is not listed in the Azure portal, you can optionally set the parameter at the connection level using init_connect
. This sets the server parameters for each client connecting to the server.
Update the init_connect server configuration parameter of server mydemoserver.mysql.database.azure.com under resource group myresourcegroup to set values such as character set.
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;"
The time zone tables on your server can be populated by calling the mysql.az_load_timezone
stored procedure from a tool like the MySQL command line or MySQL Workbench.
Nóta
If you are running the mysql.az_load_timezone
command from MySQL Workbench, you may need to turn off safe update mode first using SET SQL_SAFE_UPDATES=0;
.
CALL mysql.az_load_timezone();
Tábhachtach
You should restart the server to ensure the time zone tables are properly populated. To restart the server, use the Azure portal or CLI.
To view available time zone values, run the following command:
SELECT name FROM mysql.time_zone_name;
The global level time zone can be set using the az mysql server configuration set command.
The following command updates the time_zone server configuration parameter of server mydemoserver.mysql.database.azure.com under resource group myresourcegroup to US/Pacific.
az mysql server configuration set --name time_zone --resource-group myresourcegroup --server mydemoserver --value "US/Pacific"
The session level time zone can be set by running the SET time_zone
command from a tool like the MySQL command line or MySQL Workbench. The example below sets the time zone to the US/Pacific time zone.
SET time_zone = 'US/Pacific';
Refer to the MySQL documentation for Date and Time Functions.
- How to configure server parameters in Azure portal