Personalizar os parâmetros de configuração do servidor para a Base de Dados do Azure para PostgreSQL – Servidor Único com 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á no caminho da desativação. É altamente recomendável que você atualize para o Banco de Dados do Azure para PostgreSQL - Servidor Flexível. Para obter mais informações sobre como migrar para o Banco de Dados do Azure para PostgreSQL - Servidor Flexível, consulte O que está acontecendo com o Banco de Dados do Azure para Servidor Único PostgreSQL?.
Você pode listar, mostrar e atualizar parâmetros de configuração para um servidor PostgreSQL do Azure usando a Interface de Linha de Comando (CLI do Azure). Um subconjunto de configurações de mecanismo é exposto no nível do servidor e pode ser modificado.
Pré-requisitos
Para percorrer este guia de instruções, você precisa:
- Criar um Banco de Dados do Azure para servidor PostgreSQL e banco de dados seguindo Criar um Banco de Dados do Azure para PostgreSQL
- Instale a interface de linha de comando da CLI do Azure em sua máquina ou use o Azure Cloud Shell no portal do Azure usando seu navegador.
Listar parâmetros de configuração do servidor para o Banco de Dados do Azure para o servidor PostgreSQL
Para listar todos os parâmetros modificáveis em um servidor e seus valores, execute o comando az postgres server configuration list .
Você pode listar os parâmetros de configuração do servidor para o servidor mydemoserver.postgres.database.azure.com em 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 mydemoserver.postgres.database.azure.com de servidor em 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ê 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 PostgreSQL. Para atualizar a configuração, use 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 em grupo de recursos myresourcegroup.
az postgres server configuration set --name log_min_messages --resource-group myresourcegroup --server mydemoserver --value INFO
Se quiser redefinir o valor de um parâmetro de configuração, basta optar por deixar de fora o parâmetro opcional --value
e o serviço aplica o valor padrão. No exemplo acima, seria como:
az postgres server configuration set --name log_min_messages --resource-group myresourcegroup --server mydemoserver
Este comando redefine a configuração log_min_messages para o valor padrão WARNING. Para obter mais informações sobre a configuração do servidor e os valores permitidos, consulte a documentação do PostgreSQL sobre Configuração do servidor.
Próximos passos
- Saiba como reiniciar um servidor
- Para configurar e acessar logs do servidor, consulte Logs do servidor no Banco de Dados do Azure para PostgreSQL