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

  • Artigo

APLICA-SE A: Banco de Dados do Azure para MySQL - Servidor Único

Importante

O servidor único do Banco de Dados do Azure para MySQL está no caminho de desativação. É altamente recomendável que você atualize para o Banco de Dados do Azure para o servidor flexível MySQL. Para obter mais informações sobre como migrar para o Banco de Dados do Azure para servidor flexível MySQL, consulte O que está acontecendo com o Banco de Dados do Azure para Servidor Único MySQL?

Você pode listar, mostrar e atualizar parâmetros de configuração para um Banco de Dados do Azure para servidor MySQL 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.

Nota

Os parâmetros do servidor podem ser atualizados globalmente no nível do servidor, usar a CLI do Azure, o PowerShell ou o portal do Azure

Pré-requisitos

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

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

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

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

az mysql 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 MySQL em Variáveis de sistema do servidor.

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 az mysql server configuration show .

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

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

Modificar um valor de 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 de servidor MySQL. Para atualizar a configuração, use o comando az mysql server configuration set .

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

az mysql 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 aplica o valor padrão. Para o exemplo acima, seria como:

az mysql 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.

Definição de parâmetros não listados

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

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

Trabalhando com o parâmetro de fuso horário

Preenchendo as tabelas de fuso horário

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

Nota

Se você estiver executando o comando do MySQL Workbench, talvez seja necessário desativar o modo de atualização segura primeiro usando SET SQL_SAFE_UPDATES=0;o mysql.az_load_timezone .

CALL mysql.az_load_timezone();

Importante

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

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

SELECT name FROM mysql.time_zone_name;

Definindo o fuso horário de nível global

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

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

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

Definindo o fuso horário do nível da sessão

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

SET time_zone = 'US/Pacific';

Consulte a documentação do MySQL para funções de data e hora.

Próximos passos