Configurar parâmetros de servidor no Banco de Dados do Azure para MySQL – Servidor Flexível por meio da CLI do Azure
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 Configurar parâmetros do servidor no Banco de Dados do Azure para MySQL - Servidor Flexível usando a CLI do Azure ou Configurar parâmetros do servidor no Banco de Dados do Azure para MySQL - Servidor Flexível usando o portal do Azure
Pré-requisitos
Para seguir este guia de instruções, você precisa:
- Início Rápido: Crie uma instância do Banco de Dados do Azure para MySQL - Servidor Flexível usando o CLI do Azure
- Utilitário de linha de comando do Azure CLI ou use o Azure Cloud Shell no navegador.
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.
Definir 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
Definir 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"
Definir o fuso horário do nível da 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.