Configurar os parâmetros do servidor no Banco de Dados do Azure para MariaDB usando a CLI do Azure

  • Artigo

Importante

O Banco de Dados do Azure para MariaDB está a caminho da desativação. É altamente recomendável que você migre para o Banco de Dados do Azure para MySQL. Para obter mais informações sobre como migrar para o Banco de Dados do Azure para MySQL, consulte O que está acontecendo com o Banco de Dados do Azure para MariaDB?.

Você pode listar, mostrar e atualizar os parâmetros de configuração de um Banco de Dados do Azure para MariaDB usando a CLI do Azure, o utilitário de linha de comando do Azure. Um subconjunto de configurações de mecanismo é exposto no nível do servidor e pode ser modificado.

Observação

Os parâmetros do servidor podem ser atualizados globalmente no nível do servidor. Use a CLI do Azure, o PowerShellou o portal do Azure.

Pré-requisitos

Para seguir este guia de instruções, você precisa:

Listar parâmetros de configuração do servidor para o Banco de Dados do Azure para MariaDB

Para listar todos os parâmetros modificáveis em um servidor e seus valores, execute o comando az mariadb server configuration list.

Você pode listar os parâmetros de configuração do servidor para o servidor mydemoserver.mariadb.database.azure.com sob o grupo de recursos myresourcegroup.

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

Para a definição de cada um dos parâmetros listados, consulte a seção de referência do MariaDB em Server System Variables.

Mostrar detalhes do parâmetro de configuração do servidor

Para mostrar detalhes sobre um parâmetro de configuração específico para um servidor, execute o comando show da configuração do servidor az mariadb.

Este exemplo mostra detalhes do parâmetro de configuração de servidor slow_query_log para o servidor mydemoserver.mariadb.database.azure.com no grupo de recursos myresourcegroup.

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

Modificar um valor do parâmetro de configuração do servidor

Você também pode modificar o valor de um determinado parâmetro de configuração do servidor, que atualiza o valor de configuração subjacente para o mecanismo do servidor MariaDB. Para atualizar a configuração, use o comando az mariadb server configuration set.

Para atualizar o parâmetro de configuração de servidor slow_query_log do servidor mydemoserver.mariadb.database.azure.com no grupo de recursos myresourcegroup.

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

Se você quiser redefinir o valor de um parâmetro de configuração, omita o parâmetro opcional --value e o serviço aplicará o valor padrão. No exemplo acima, ele teria a seguinte aparência:

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

Esse código redefine a configuração slow_query_log para o valor padrão OFF.

Configurar parâmetros não listados

Se o parâmetro de servidor que você deseja atualizar não estiver listado no portal do Azure, você poderá, opcionalmente, definir o parâmetro no nível de conexão usando init_connect. Isto define os parâmetros de servidor para cada cliente que se conecta ao servidor.

Atualize o parâmetro de configuração do servidor init_connect do servidor mydemoserver.mariadb.database.azure.com no grupo de recursos myresourcegroup para definir valores, como o conjunto 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;"

Trabalhar com o parâmetro de fuso horário

Preencher as tabelas de fuso horário

As tabelas de fuso horário no seu servidor podem ser preenchidas chamando o procedimento armazenado mysql.az_load_timezone de uma ferramenta como a linha de comando do MariaDB ou o MariaDB Workbench.

Observação

Se você estiver executando o comando da mysql.az_load_timezoneMariaDB Workbench, pode ser necessário desativar primeiro o modo de atualização segura usandoSET SQL_SAFE_UPDATES=0;.

CALL mysql.az_load_timezone();

Importante

Você deve reiniciar o servidor para garantir que as tabelas de fuso horário sejam populadas corretamente. Para reiniciar o servidor, use a CLI ou o Portal do Azure.

Para exibir os valores de fuso horário disponíveis, execute o comando a seguir:

SELECT name FROM mysql.time_zone_name;

Configurar o fuso horário de nível global

O fuso horário do nível global pode ser definido usando o comando az mariadb server configuration set.

O comando a seguir atualiza o parâmetro de configuração do servidor de time_zone do servidor mydemoserver.mariadb.database.azure.com no grupo de recursos myresourcegroup para EUA/Pacífico.

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

Configurar o fuso horário do nível de sessão

O fuso horário do nível de sessão pode ser configurado executando o comando SET time_zone a partir de uma ferramenta como a linha de comando do MariaDB ou o MariaDB Workbench. O exemplo abaixo configura o fuso horário para EUA/Pacífico.

SET time_zone = 'US/Pacific';

Consulte a documentação do MariaDB para Funções de data e hora.

Próximas etapas