Configurar parâmetros de servidor no Banco de Dados do Azure para MariaDB usando o PowerShell
Importante
O Banco de Dados do Azure para MariaDB está no caminho da aposentadoria. É altamente recomendável migrar 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, consulte O que está acontecendo com o Banco de Dados do Azure para MariaDB?.
Você pode listar, mostrar e atualizar parâmetros de configuração para um Banco de Dados do Azure para servidor MariaDB 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:
- O módulo Az PowerShell instalado localmente ou o Azure Cloud Shell no navegador
- Um Banco de Dados do Azure para servidor MariaDB
Importante
Enquanto o módulo Az.MariaDb PowerShell estiver em visualização, você deve instalá-lo separadamente do módulo Az PowerShell usando o seguinte comando: Install-Module -Name Az.MariaDb -AllowPrerelease.
Assim que o módulo Az.MariaDb 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. |  |
| Aceda a https://shell.azure.com ou selecione o botão Iniciar Cloud Shell para abrir o Cloud Shell no browser. |  |
| Selecione o botão Cloud Shell na barra de menus, na parte direita 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 comando.
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.
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 MariaDB
Para listar todos os parâmetros modificáveis em um servidor e seus valores, execute o Get-AzMariaDbConfiguration cmdlet.
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 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-AzMariaDbConfiguration 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-AzMariaDbConfiguration -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 MariaDB. Para atualizar a configuração, use o Update-AzMariaDbConfiguration cmdlet.
Para atualizar o parâmetro de configuração do servidor slow_query_log do servidor mydemoserver em grupo de recursos myresourcegroup.
Update-AzMariaDbConfiguration -Name slow_query_log -ResourceGroupName myresourcegroup -ServerName mydemoserver -Value On