Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este script da CLI de exemplo lista todos os parâmetros de configuração disponíveis e seus valores permitidos para o servidor flexível do Banco de Dados do Azure para PostgreSQL e define log_retention_days como um valor diferente do padrão.
Se você ainda não tiver uma conta do Azure, crie uma conta gratuita antes de começar.
Pré-requisitos
Utilize o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Introdução ao Azure Cloud Shell.
Se você preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se você estiver executando no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira Como executar a CLI do Azure em um contêiner do Docker.
Se você estiver usando uma instalação local, entre na CLI do Azure usando o comando az login . Para concluir o processo de autenticação, siga as etapas exibidas em seu terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.
Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar e gerenciar extensões com a CLI do Azure.
Execute o comando az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute az upgrade.
Exemplo de script
Lançar o Azure Cloud Shell
O Azure Cloud Shell é um shell gratuito e interativo que poderá ser usado para executar as etapas deste artigo. Ele possui ferramentas comuns do Azure pré-instaladas e configuradas para usar com sua conta.
Para abrir o Cloud Shell, basta selecionar Experimentar no canto superior direito de um bloco de código. Você também pode iniciar o Cloud Shell em uma guia separada do navegador indo até https://shell.azure.com.
Quando o Cloud Shell for aberto, verifique se o Bash está selecionado para seu ambiente. As sessões subsequentes usarão a CLI do Azure em um ambiente Bash. Selecione Copiar para copiar os blocos de código, cole-os no Cloud Shell e pressione Enter para executá-los.
Entrar no Azure
O Cloud Shell é autenticado automaticamente na conta inicial usada para entrar. Use o seguinte script para entrar com outra assinatura, substituindo subscriptionId pela ID de sua assinatura do Azure.
Se você ainda não tiver uma conta do Azure, crie uma conta gratuita antes de começar.
subscription="subscriptionId" # Set Azure subscription ID here
az account set -s $subscription # ...or use 'az login'
Para saber mais, confira definir assinatura ativa ou fazer logon de forma interativa.
Executar o script
# List and update configurations of an Azure Database for PostgreSQL server
# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="msdocs-postgresql-rg-$randomIdentifier"
tag="change-server-cofigurations-postgresql"
server="msdocs-postgresql-server-$randomIdentifier"
sku="GP_Gen5_2"
login="azureuser"
password="Pa$$w0rD-$randomIdentifier"
echo "Using resource group $resourceGroup with login: $login, password: $password..."
# Create a resource group
echo "Creating $resourceGroup in $location..."
az group create --name $resourceGroup --location "$location" --tags $tag
# Create a PostgreSQL server in the resource group
# Name of a server maps to DNS name and is thus required to be globally unique in Azure.
echo "Creating $server in $location..."
az postgres server create --name $server --resource-group $resourceGroup --location "$location" --admin-user $login --admin-password $password --sku-name $sku
# Display all available configurations with valid values of an Azure Database for PostgreSQL server
az postgres server configuration list --resource-group $resourceGroup --server-name $server
# Set value of **log_retention_days**
echo "Setting value of the log_retention_days setting on $server"
az postgres server configuration set --resource-group $resourceGroup --server-name $server --name log_retention_days --value 7
# Check the value of **log_retention_days**
echo "Checking the value of the log_retention_days setting on $server"
az postgres server configuration show --resource-group $resourceGroup --server-name $server --name log_retention_days
Limpeza da implantação
Use o comando a seguir para remover o grupo de recursos e todos os recursos associados a ele usando o comando az group delete, a menos que você necessite desses recursos com frequência. A criação e a exclusão de alguns desses recursos podem demorar um pouco.
az group delete --name $resourceGroup
Exemplo de referência
Esse script usa os comandos descritos na tabela abaixo:
| Command | Notes |
|---|---|
| az group create | Cria um grupo de recursos no qual todos os recursos são armazenados. |
| Execute o comando az postgres server create para criar um servidor PostgreSQL. | Cria uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL que hospeda os bancos de dados. |
| az postgres server configuration list | Liste as configurações de uma instância do servidor flexível do Banco de Dados do Azure para PostgreSQL. |
| az postgres server configuration set | Atualize a configuração de uma instância do servidor flexível do Banco de Dados do Azure para PostgreSQL. |
| az postgres server configuration show - Exibe as configurações do servidor PostgreSQL. | Mostre a configuração de uma instância do servidor flexível do Banco de Dados do Azure para PostgreSQL. |
| O comando az group delete é usado para excluir um grupo no Azure. | Exclui um grupo de recursos, incluindo todos os recursos aninhados. |