Configurar os parâmetros do servidor no Banco de Dados do Azure para MariaDB usando o PowerShell
Importante
O Banco de Dados do Azure para MariaDB está a caminho da desativação. Recomendamos fortemente que você migre para o Banco de Dados do Azure para MySQL. Para obter mais informações sobre como migrar para o Banco de Dados do Azure para MySQL, confira O que está acontecendo com o Banco de Dados do Azure para MariaDB?.
Você pode listar, exibir e atualizar os parâmetros de configuração de um servidor do Banco de Dados do Azure para MariaDB 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 Banco de Dados do Azure para MariaDB
Importante
Embora o módulo Az.MariaDb do PowerShell esteja em versão prévia, você precisará instalá-lo separadamente por meio do módulo do Az PowerShell usando o seguinte comando: Install-Module -Name Az.MariaDb -AllowPrerelease.
Depois que o módulo Az.MariaDb do PowerShell estiver em disponibilidade geral, ele passará a fazer parte das versões futuras do módulo do Az PowerShell e ficará 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 comando.
Listar parâmetros de configuração do servidor para o Banco de Dados do Azure para MariaDB
Para listar todos os parâmetros modificáveis em um servidor e seus valores, execute o cmdlet Get-AzMariaDbConfiguration.
O exemplo a seguir lista os parâmetros de configuração do servidor para o servidor mydemoserver no grupo de recursos myresourcegroup.
Get-AzMariaDbConfiguration -ResourceGroupName myresourcegroup -ServerName mydemoserver
Para a definição de cada um dos parâmetros listados, consulte a seção de referência do MariaDB em Server System Variables.
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-AzMariaDbConfiguration 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-AzMariaDbConfiguration -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 um determinado parâmetro de configuração do servidor, que atualiza o valor de configuração subjacente para o mecanismo do servidor MariaDB. Para atualizar a configuração, use o cmdlet Update-AzMariaDbConfiguration.
Para atualizar o parâmetro de configuração de servidor slow_query_log do servidor mydemoserver no grupo de recursos myresourcegroup.
Update-AzMariaDbConfiguration -Name slow_query_log -ResourceGroupName myresourcegroup -ServerName mydemoserver -Value On