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 Banco de Dados do Azure para servidor único 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 o servidor flexível MySQL, consulte O que está acontecendo com o Banco de Dados do Azure para Servidor Único MySQL?

É possível listar, exibir e atualizar os parâmetros de configuração de um servidor de Banco de Dados do Azure para MySQL usando o utilitário da linha de comando da CLI 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 os parâmetros de configuração de servidor para o Banco de Dados do Azure para MySQL

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

É possível listar os parâmetros de configuração do servidor mydemoserver.mysql.database.azure.com no grupo de recursos myresourcegroup.

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

Para obter a definição de cada um dos parâmetros listados, consulte a seção de referência do MySQL em Variáveis do Sistema do Servidor.

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

Para mostrar os detalhes sobre um parâmetro de configuração específico de um servidor, execute o comando az mysql server configuration show.

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

az mysql 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 determinados parâmetros de configuração, que atualiza o valor da configuração subjacente para o mecanismo do servidor MySQL. Para atualizar o valor de configuração execute o comando az mysql server configuration set.

Para atualizar o parâmetro de configuração de servidor slow_query_log do servidor mydemoserver.mysql.database.azure.com no 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 aplicará o valor padrão. No exemplo acima, ele teria a seguinte aparência:

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.

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.mysql.database.azure.com no grupo de recursos myresourcegroup para definir valores, como o 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;"

Trabalhar com o parâmetro de fuso horário

Preencher as tabelas de fuso horário

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

Observação

Se estiver executando o comando mysql.az_load_timezone do Workbench do MySQL, talvez seja necessário desativar primeiro o modo de atualização segura usando SET 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 de nível global pode ser configurado usando o comando az mysql server configuration set.

O comando a seguir atualiza o parâmetro de configuração do servidor de 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"

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 MySQL ou Workbench do MySQL. O exemplo abaixo configura o fuso horário para EUA/Pacífico.

SET time_zone = 'US/Pacific';

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

Próximas etapas