Personalizar parâmetros de configuração de servidor do Banco de Dados do Azure para PostgreSQL – Servidor único usando a CLI do Azure
APLICA-SE A: Banco de Dados do Azure para PostgreSQL – Servidor Único
Importante
O Banco de Dados do Azure para PostgreSQL – Servidor Único está prestes a ser desativado. Recomendamos fortemente que você faça um upgrade para o Banco de Dados do Azure para PostgreSQL com Servidor Flexível. Para obter mais informações sobre a migração para o Banco de Dados do Azure para PostgreSQL com Servidor Flexível, confira O que está acontecendo com o Banco de Dados do Azure para PostgreSQL com Servidor Único?
Você pode listar, exibir e atualizar os parâmetros de configuração de um servidor PostgreSQL do Azure usando a CLI (Interface de Linha de Comando) do Azure. Um subconjunto de configurações de mecanismo é exposto no nível do servidor e pode ser modificado.
Pré-requisitos
Para seguir este guia de instruções, você precisa:
- Criar um banco de dados e um servidor de Banco de Dados do Azure para PostgreSQL seguindo Criar um Banco de Dados do Azure para o servidor PostgreSQL
- Instalar a interface de linha de comando da CLI do Azure no computador ou usar o Azure Cloud Shell no portal do Azure usando seu navegador.
Listar os parâmetros de configuração de servidor para o bando de dados do Azure para servidor PostgreSQL
Para listar todos os parâmetros modificáveis em um servidor e seus valores, execute o comando az postgres server configuration list.
É possível listar os parâmetros de configuração do servidor mydemoserver.postgres.database.azure.com no grupo de recursos myresourcegroup.
az postgres server configuration list --resource-group myresourcegroup --server mydemoserver
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 comando az postgres server configuration show.
Este exemplo mostra detalhes do parâmetro de configuração do servidor log_min_messages para o servidor mydemoserver.postgres.database.azure.com no grupo de recursos myresourcegroup.
az postgres server configuration show --name log_min_messages --resource-group myresourcegroup --server mydemoserver
Modificar o valor do parâmetro de configuração do servidor
Você pode modificar o valor de determinados parâmetros de configuração, que atualiza o valor da configuração subjacente para o mecanismo do servidor PostgreSQL. Para atualizar o valor de configuração, execute o comando az postgres server configuration set.
Para atualizar o parâmetro de configuração do servidor log_min_messages do servidor mydemoserver.postgres.database.azure.com no grupo de recursos myresourcegroup.
az postgres server configuration set --name log_min_messages --resource-group myresourcegroup --server mydemoserver --value INFO
Se você quiser redefinir o valor de um parâmetro de configuração, basta simplesmente optar por deixar o parâmetro opcional --value
e o serviço aplicará o valor padrão. No exemplo acima, ele teria a seguinte aparência:
az postgres server configuration set --name log_min_messages --resource-group myresourcegroup --server mydemoserver
Esse comando redefine a configuração log_min_messages para o valor padrão AVISO. Para obter mais informações sobre a configuração do servidor e os valores permitidos, veja a documentação do PostgreSQL em Configuração do Servidor.
Próximas etapas
- Saiba como reiniciar um servidor
- Para configurar e acessar os logs de servidor, confira Logs de servidor no Banco de Dados do Azure para PostgreSQL