Configuración de parámetros del servidor en Azure Database for MySQL mediante la CLI de Azure

  • Artículo

SE APLICA A: Azure Database for MySQL: Servidor único

Importante

El servidor único de Azure Database for MySQL está en la ruta de retirada. Se recomienda encarecidamente actualizar al servidor flexible de Azure Database for MySQL. Para más información sobre la migración al servidor flexible de Azure Database for MySQL, consulte ¿Qué ocurre con Azure Database for MySQL con servidor único?

Puede enumerar, mostrar y actualizar los parámetros de configuración de un servidor de Azure Database for MySQL con la CLI de Azure, la utilidad de línea de comandos de Azure. En el nivel del servidor, se expone y se puede modificar un subconjunto de las opciones de configuración del motor.

Nota

Los parámetros del servidor se pueden actualizar globalmente en el servidor; use la CLI de Azure, PowerShell o Azure Portal.

Requisitos previos

Para seguir esta guía, necesitará:

Lista de los parámetros de configuración del servidor de Azure Database for MySQL

Para obtener una lista de todos los parámetros modificables en un servidor y sus valores, ejecute el comando az mysql server configuration list.

Puede enumerar los parámetros de configuración del servidor mydemoserver.mysql.database.azure.com en el grupo de recursos myresourcegroup.

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

Para ver la definición de cada uno de los parámetros enumerados, consulte la sección de referencia de MySQL en Server System Variables (Variables del sistema del servidor).

Presentación de los detalles de los parámetros de configuración del servidor

Para mostrar los detalles de un parámetro de configuración específico de un servidor, ejecute el comando az mysql server configuration show.

Este ejemplo muestra detalles del parámetro de configuración del servidor slow_query_log para el servidor mydemoserver.mysql.database.azure.com en el grupo de recursos myresourcegroup.

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

Modificación de un valor de los parámetros de configuración del servidor

También puede modificar el valor de un determinado parámetro de configuración del servidor; esta acción actualizará el valor de configuración subyacente del motor del servidor de MySQL. Para actualizar la configuración, use el comando az mysql server configuration set.

Para actualizar el parámetro de configuración del servidor slow_query_log del servidor mydemoserver.mysql.database.azure.com en el grupo de recursos myresourcegroup.

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

Si desea restablecer el valor de un parámetro de configuración, omita el parámetro opcional --value y el servicio aplicará el valor predeterminado. Para el ejemplo anterior, sería:

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

Este código restablece la configuración de slow_query_log al valor predeterminado APAGADO.

Ajustar parámetros que no aparecen en la lista

Si el parámetro de servidor que desea actualizar no aparece en Azure Portal, también puede establecer el parámetro en el nivel de conexión mediante init_connect. De este modo, se establecen los parámetros del servidor para cada cliente con conexión al servidor.

Actualice el parámetro de configuración del servidor init_connect del servidor mydemoserver.mysql.database.azure.com en el grupo de recursos myresourcegroup para establecer valores como el juego de caracteres.

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

Trabajo con el parámetro de zona horaria

Relleno de las tablas de la zona horaria

Las tablas de la zona horaria del servidor se pueden rellenar mediante una llamada al procedimiento almacenado mysql.az_load_timezone desde una herramienta como la línea de comandos de MySQL o MySQL Workbench.

Nota

Si ejecuta el comando mysql.az_load_timezone de MySQL Workbench, es posible que primero tenga que desactivar el modo de actualización segura mediante SET SQL_SAFE_UPDATES=0;.

CALL mysql.az_load_timezone();

Importante

Debe reiniciar el servidor para asegurarse de que las tablas de zona horaria se rellenen correctamente. Para reiniciar el servidor, use Azure Portal o la CLI.

Para ver los valores de zonas horarias disponibles, ejecute el comando siguiente:

SELECT name FROM mysql.time_zone_name;

Establecimiento de la zona horaria de nivel global

La zona horaria de nivel global se puede establecer mediante el comando az mysql server configuration set.

El siguiente comando actualiza el parámetro de configuración time_zone del servidor mydemoserver.mysql.database.azure.com en el grupo de recursos myresourcegroup a US/Pacific.

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

Establecimiento de la zona horaria de nivel de sesión

La zona horaria de nivel de sesión se puede establecer mediante la ejecución del comando SET time_zone desde una herramienta como la línea de comandos de MySQL o MySQL Workbench. En el ejemplo siguiente se establece la zona horaria en US/Pacific.

SET time_zone = 'US/Pacific';

Consulte Date and Time Functions (Funciones de fecha y hora) en la documentación de MySQL.

Pasos siguientes