Configurar parâmetros de servidor no Banco de Dados do Azure para MySQL usando o PowerShell
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 da desativação. É altamente recomendável que você atualize para o servidor flexível do Banco de Dados do Azure para MySQL. Para obter mais informações sobre a migração para o servidor flexível do Banco de Dados do Azure para MySQL, confira O que está acontecendo com o Servidor Único do Banco de Dados do Azure para MySQL?
Você pode listar, mostrar e atualizar parâmetros de configuração de um servidor do Banco de Dados do Azure para MySQL usando o PowerShell. 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 concluir este guia de instruções, você precisa:
- Do módulo AZ do PowerShell instalado localmente ou do Azure Cloud Shell no navegador
- De um servidor do Banco de Dados do Azure para MySQL
Importante
Enquanto o módulo Az.MySql PowerShell está em versão prévia, você deve instalá-lo separadamente do módulo Az PowerShell usando o seguinte comando: Install-Module -Name Az.MySql -AllowPrerelease.
Depois que o módulo Az.MySql PowerShell estiver em disponibilidade geral, ele passará a fazer parte das versões futuras do módulo do Az PowerShell e estará disponível nativamente no Azure Cloud Shell.
Ao optar por usar o PowerShell no local, conecte-se à sua conta do Azure usando o cmdlet Connect-AzAccount.
Azure Cloud Shell
O Azure hospeda o Azure Cloud Shell, um ambiente de shell interativo que pode ser usado por meio do navegador. É possível usar o bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. É possível usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo, sem precisar instalar nada no seu ambiente local.
Para iniciar o Azure Cloud Shell:
| Opção | Exemplo/Link |
|---|---|
| Selecione Experimentar no canto superior direito de um bloco de código ou de comando. Selecionar Experimentar não copia automaticamente o código nem o comando para o Cloud Shell. |  |
| Acesse https://shell.azure.com ou selecione o botão Iniciar o Cloud Shell para abri-lo no navegador. |  |
| Selecione o botão Cloud Shell na barra de menus no canto superior direito do portal do Azure. |  |
Para usar o Azure Cloud Shell:
Inicie o Cloud Shell.
Selecione o botão Copiar em um bloco de código (ou bloco de comando) para copiar o código ou o comando.
Cole o código ou comando na sessão do Cloud Shell selecionando Ctrl+Shift+V no Windows e no Linux, ou selecionando Cmd+Shift+V no macOS.
Pressione Enter para executar o código ou o comando.
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 cmdlet Get-AzMySqlConfiguration.
O exemplo a seguir lista os parâmetros de configuração do servidor para o servidor mydemoserver no grupo de recursos myresourcegroup.
Get-AzMySqlConfiguration -ResourceGroupName myresourcegroup -ServerName 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 detalhes sobre um parâmetro de configuração específico para um servidor, execute o cmdlet Get-AzMySqlConfiguration e especifique o parâmetro Nome.
Este exemplo mostra detalhes do parâmetro de configuração de servidor slow_query_log para o servidor mydemoserver no grupo de recursos myresourcegroup.
Get-AzMySqlConfiguration -Name slow_query_log -ResourceGroupName myresourcegroup -ServerName 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 a configuração, use o cmdlet Update-AzMySqlConfiguration.
Para atualizar o parâmetro de configuração de servidor slow_query_log do servidor mydemoserver no grupo de recursos myresourcegroup.
Update-AzMySqlConfiguration -Name slow_query_log -ResourceGroupName myresourcegroup -ServerName mydemoserver -Value On