Compartilhar 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 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:

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. Captura de tela que mostra um exemplo de Experimente para o Azure Cloud Shell.
Acesse https://shell.azure.com ou selecione o botão Iniciar o Cloud Shell para abri-lo no navegador. Botão para iniciar o Azure Cloud Shell.
Selecione o botão Cloud Shell na barra de menus no canto superior direito 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 o comando.

  3. 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.

  4. 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

Próximas etapas