Início Rápido: Criar um Banco de Dados do Azure para PostgreSQL – instância de servidor flexível usando a CLI do Azure
APLICA-SE A: 
Banco de Dados do Azure para PostgreSQL - Servidor Flexível
Esse início rápido mostra como usar os comandos da CLI do Azure no Azure Cloud Shell para criar uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL em cinco minutos. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
Iniciar o Azure Cloud Shell
O Azure Cloud Shell é um shell gratuito e interativo que poderá ser usado para executar as etapas deste artigo. Ele tem ferramentas do Azure 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 abrir o Cloud Shell em uma guia separada do navegador indo até https://shell.azure.com/bash. Selecione Copiar para copiar os blocos de código, cole-o no Cloud Shell e selecione Enter para executá-lo.
Caso prefira instalar e usar a CLI localmente, este início rápido exigirá a CLI do Azure versão 2.0 ou posterior. Execute az --version para encontrar a versão. Se você precisa instalar ou atualizar, consulte Instalar a CLI do Azure.
Pré-requisitos
Você precisará fazer logon em sua conta usando o comando az login. Observe a propriedade id na saída, que se refere à ID da Assinatura de sua conta do Azure.
az login
Selecione a assinatura específica em sua conta usando o comando az account set. Use o valor da id da saída de az login para usar como valor para o argumento subscription no comando. Se tiver várias assinaturas, escolha a que for adequada para cobrança do recurso. Para obter todas as suas assinaturas, use az account list.
az account set --subscription <subscription id>
Criar um servidor flexível
Crie um grupo de recursos do Azure usando o comando az group create e, em seguida, crie sua instância de servidor flexível do Banco de Dados do Azure para PostgreSQL dentro desse grupo de recursos. Você deve fornecer um nome exclusivo. O exemplo a seguir cria um grupo de recursos chamado myresourcegroup na localização eastus.
az group create --name myresourcegroup --location eastus
Crie uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL com o comandoaz postgres flexible-server create. Um servidor pode conter vários bancos de dados. O seguinte comando cria um servidor no grupo de recursos que você acabou de criar:
az postgres flexible-server create --name mydemoserver --resource-group myresourcegroup
Como o método de conectividade padrão é Acesso público (endereços IP permitidos), o comando solicitará que você confirme se deseja adicionar seu endereço IP e/ou todos os IPs (intervalo que abrange 0.0.0.0 a 255.255.255.255) à lista de endereços permitidos.
O servidor criado tem os seguintes atributos:
- O mesmo local que o grupo de recursos
- Nome de usuário e senha de administrador gerados automaticamente (que você deve salvar em um local seguro)
- Um banco de dados padrão chamado "flexibleserverdb"
- Padrões de serviço para as configurações de servidor restantes: camada de computação (Uso Geral), tamanho da computação/SKU (
Standard_D2s_v3– 2 vCore e 8 GB de RAM), período de retenção de backup (7 dias) e versão do PostgreSQL (13)
Observação
O método de conectividade não pode ser alterado após a criação do servidor. Por exemplo, se você selecionou Acesso privado (integração VNet) durante a criação, não poderá alterá-lo para Acesso público (endereços IP permitidos) após a criação. Recomendamos criar um servidor com acesso Privado para que seja possível acessar seu servidor com segurança usando a Integração VNet. Saiba mais sobre o acesso Privado no artigo sobre conceitos.
Caso queira alterar os padrões, consulte a referência da CLI do Azure referente a az postgres flexible-server create.
Observação
As ligações à Banco de Dados do Azure para PostgreSQL servidor flexível comunicam através da porta 5432. Se estiver tentando se conectar em uma rede corporativa, talvez o tráfego de saída pela porta 5432 não seja permitido. Nesse caso, não será possível se conectar ao servidor, a menos que o departamento de TI abra a porta 5432. Observe que se você habilitar o PgBouncer em sua instância do servidor flexível do Banco de Dados do Azure para PostgreSQL e quiser se conectar por meio dele, porque ele é executado na porta 6432, é essa porta que seu departamento de TI deve abrir para o tráfego de saída.
Obter informações de conexão
Para se conectar ao servidor, é preciso fornecer credenciais de acesso e informações do host.
az postgres flexible-server show --name mydemoserver --resource-group myresourcegroup
O resultado está no formato JSON. Anote o fullyQualifiedDomainName e o administratorLogin. Você deve ter salvo a senha na etapa anterior.
{
"administratorLogin": "myadmin",
"availabilityZone": "3",
"backup": {
"backupRetentionDays": 7,
"earliestRestoreDate": "2022-10-20T18:03:50.989428+00:00",
"geoRedundantBackup": "Disabled"
},
"earliestRestoreDate": null,
"fullyQualifiedDomainName": "mydemoserver.postgres.database.azure.com",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/mydemoserver",
"location": "eastus",
"name": "mydemoserver",
"network": {
"delegatedSubnetResourceId": null,
"privateDnsZoneArmResourceId": null,
"publicNetworkAccess": "Enabled"
},
"resourceGroup": "myresourcegroup",
"sku": {
"name": "Standard_D2s_v3",
"tier": "GeneralPurpose"
},
"state": "Ready",
"storage": {
"storageSizeGb": 128
},
"tags": null,
"type": "Microsoft.DBforPostgreSQL/flexibleServers",
"version": "13"
}
Conectar-se usando um cliente de linha de comando do PostgreSQL
Primeiro, instale a ferramenta de linha de comando psql.
Com o psql, conecte-se ao banco de dados “flexibleserverdb” usando o seguinte comando. Substitua os valores pelo nome de domínio e o nome de usuário gerados automaticamente.
psql -h mydemoserver.postgres.database.azure.com -U myadmin flexibleserverdb
Observação
Se você receber um erro The parameter PrivateDnsZoneArguments is required, and must be provided by customer, isso significa que pode estar executando uma versão mais antiga da CLI do Azure. Atualize a CLI do Azure e repita a operação.
Limpar os recursos
Se não precisar desses recursos para outro início rápido/tutorial, você poderá excluí-los ao fazer o seguinte comando:
az group delete --name myresourcegroup
Caso queira apenas excluir o servidor recém-criado, você poderá executar o comando az postgres flexible-server delete.
az postgres flexible-server delete --resource-group myresourcegroup --name mydemoserver