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

  • Artículo

Importante

Azure Database for MariaDB está en proceso de retirada. Se recomienda encarecidamente migrar a Azure Database for MySQL. Para más información sobre la migración a Azure Database for MySQL, consulte ¿Qué ocurre con Azure Database for MariaDB?.

Puede enumerar, mostrar y actualizar los parámetros de configuración de un servidor de Azure Database for MariaDB con la CLI de Azure, la utilidad de la 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 MariaDB

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

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

az mariadb 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 MariaDB en Server System Variables (Variables de 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 mariadb server configuration show.

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

az mariadb 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, lo que actualizará el valor de configuración subyacente del motor del servidor de MariaDB. Para actualizar la configuración, use el comando az mariadb server configuration set.

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

az mariadb 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 mariadb 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.mariadb.database.azure.com en el grupo de recursos myresourcegroup para establecer valores como juego de caracteres.

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

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 MariaDB o MariaDB Workbench.

Nota:

Si ejecuta el comando mysql.az_load_timezone desde MariaDB 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 mariadb server configuration set.

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

az mariadb 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 MariaDB o MariaDB Workbench. En el ejemplo siguiente se establece la zona horaria en US/Pacific.

SET time_zone = 'US/Pacific';

Consulte en la documentación de MariaDB las Funciones de fecha y hora.

Pasos siguientes