Compartilhar via

Configurar parâmetros de servidor no Banco de Dados do Azure para MySQL – Servidor Flexível por meio da CLI do Azure

  • Artigo

APLICA-SE A: Banco de Dados do Azure para MySQL – Servidor flexível

Você pode listar, mostrar e atualizar os parâmetros de uma instância de servidor flexível do Banco de Dados do Azure para MySQL usando a CLI do Azure, o utilitário de linha de comando do Azure. Os parâmetros de servidor são configurados com o valor padrão e recomendado quando você cria o servidor.

Este artigo descreve como listar, mostrar e atualizar parâmetros de servidor usando o CLI do Azure.

Observação

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

Pré-requisitos

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

Listar os parâmetros de servidor para uma instância de servidor flexível do Banco de Dados do Azure para MySQL

Para listar todos os parâmetros em uma instância de servidor flexível do Banco de Dados do Azure para MySQL e seus valores, execute o comando az mysql flexible-server parameter list.

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

az mysql flexible-server parameter list --resource-group myresourcegroup --server-name 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 servidor

Para mostrar detalhes sobre um parâmetro específico para uma instância de servidor flexível do Banco de Dados do Azure para MySQL, execute o comando az mysql flexible-server parameter show.

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

az mysql flexible-server parameter show --name slow_query_log --resource-group myresourcegroup --server-name mydemoserver

Modificar um valor de parâmetro de servidor

Você também pode modificar o valor de um determinado parâmetro de instância de servidor flexível do Banco de Dados do Azure para MySQL, que atualiza o valor de configuração subjacente para o mecanismo de servidor do MySQL. Para atualizar o parâmetro de servidor, use o comando az mysql flexível-server parameter set.

Para atualizar o parâmetro de servidor slow_query_log do servidor mydemoserver.mysql.database.azure.com no grupo de recursos myresourcegroup.

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

Para atualizar vários parâmetros de servidor, como slow_query_log e audit_log_enabled do servidor mydemoserver.mysql.database.azure.com em myresourcegroup do grupo de recursos.

az mysql flexible-server parameter set-batch -resource-group myresourcegroup --server-name mydemoserver --source "user-override" --args slow_query_log="ON" audit_log_enabled="ON"

Se você quiser redefinir o valor de um parâmetro, 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 flexible-server parameter set --name slow_query_log --resource-group myresourcegroup --server-name mydemoserver

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

Definindo parâmetros de servidor não modificáveis

Se o parâmetro de servidor flexível do Banco de Dados do Azure para MySQL que você quer atualizar não for modificável, você tem a opção de 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 init_connect do servidor mydemoserver.mysql.database.azure.com em grupo de recursos myresourcegroup para definir valores como conjunto de caracteres.

az mysql flexible-server parameter set --name init_connect --resource-group myresourcegroup --server-name mydemoserver --value "SET character_set_client=utf8;SET character_set_database=utf8mb4;SET character_set_connection=latin1;SET character_set_results=latin1;"

Observação

init_connect pode ser usado para mudar parâmetros que não exigem privilégio(s) SUPER no nível da sessão. Para verificar se você pode definir o parâmetro usando init_connect, execute o comando set session parameter_name=YOUR_DESIRED_VALUE; e, se ele apresentar o erro Acesso negado, você precisa de privilégios SUPER, não será possível definir o parâmetro usando "init_connect".

Trabalhar com o parâmetro de fuso horário

Configurar o fuso horário de nível global

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

O comando a seguir atualiza o parâmetro de servidor time_zone do servidor mydemoserver.mysql.database.azure.com em grupo de recursos myresourcegroup para US/Pacific.

az mysql flexible-server parameter set --name time_zone --resource-group myresourcegroup --server-name 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.

Observação

Para alterar o fuso horário no nível da sessão, o parâmetro do servidor time_zone precisa ser atualizado globalmente de acordo com o fuso horário necessário pelo menos uma vez, a fim de atualizar a tabela mysql.time_zone_name.

Próximas etapas