Partilhar via


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 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 o PowerShell. 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 ao nível do servidor ao utilizar a CLI do Azure, o PowerShell ou o portal do Azure.

Pré-requisitos

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

Importante

Enquanto o módulo Az.MySql PowerShell estiver em visualização, você deve instalá-lo separadamente do módulo Az PowerShell usando o seguinte comando: Install-Module -Name Az.MySql -AllowPrerelease. Assim que o módulo Az.MySql PowerShell estiver disponível em geral, ele se tornará parte de futuras versões do módulo Az PowerShell e estará disponível nativamente no Azure Cloud Shell.

Se você optar por usar o PowerShell localmente, conecte-se à sua conta do Azure usando o cmdlet Connect-AzAccount .

Azure Cloud Shell

O Azure aloja o Azure Cloud Shell, um ambiente de shell interativo que pode utilizar através do seu browser. Pode utilizar o Bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. Você pode usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo, sem precisar instalar nada em seu ambiente local.

Para iniciar o Azure Cloud Shell:

Opção Exemplo/Ligação
Selecione Experimentar no canto superior direito de um código ou bloco de comandos. Selecionar Experimentar não copia automaticamente o código ou comando para o Cloud Shell. Captura de tela que mostra um exemplo de Try It for Azure Cloud Shell.
Aceda a https://shell.azure.com ou selecione o botão Iniciar Cloud Shell para abrir o Cloud Shell no browser. Botão para iniciar o Azure Cloud Shell.
Selecione o botão Cloud Shell na barra de menus, na parte direita do portal do Azure. Captura de tela que mostra o botão Cloud Shell no portal do Azure

Para usar o Azure Cloud Shell:

  1. Inicie o Cloud Shell.

  2. Selecione o botão Copiar em um bloco de código (ou bloco de comando) para copiar o código ou comando.

  3. Cole o código ou comando na sessão do Cloud Shell selecionando Ctrl+Shift+V no Windows e Linux ou selecionando Cmd+Shift+V no macOS.

  4. Selecione Enter para executar o código ou comando.

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 Get-AzMySqlConfiguration cmdlet.

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 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 Get-AzMySqlConfiguration cmdlet e especifique o parâmetro Name .

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

Get-AzMySqlConfiguration -Name slow_query_log -ResourceGroupName myresourcegroup -ServerName 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 Update-AzMySqlConfiguration cmdlet.

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

Update-AzMySqlConfiguration -Name slow_query_log -ResourceGroupName myresourcegroup -ServerName mydemoserver -Value On

Próximos passos