Guia de início rápido: criar um Banco de Dados do Azure para PostgreSQL - instância flexível do Servidor usando a CLI do Azure
APLICA-SE A:
Banco de Dados do Azure para PostgreSQL - Servidor Flexível
Este guia de 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 não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.
Iniciar o Azure Cloud Shell
O Azure Cloud Shell é um shell interativo gratuito que você pode usar para executar as etapas neste artigo. Tem as ferramentas comuns do Azure pré-instaladas e configuradas para utilização com a 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 acessando .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.
Se você preferir instalar e usar a CLI localmente, este início rápido requer a CLI do Azure versão 2.0 ou posterior. Executar az --version para localizar a versão. Se precisar de instalar ou atualizar, veja Install Azure CLI (Instalar o Azure CLI).
Pré-requisitos
Você precisa fazer login na sua conta usando o comando az login . Observe a propriedade id na saída, que se refere à ID de Assinatura da sua conta do Azure.
az login
Selecione a assinatura específica em sua conta usando o comando az account set . Use o valor id da saída az login para usar como o valor para o argumento de assinatura no comando. Se tiver várias subscrições, escolha a subscrição adequada na qual o recurso deve ser cobrado. Para obter toda a sua assinatura, use a lista de contas az.
az account set --subscription <subscription id>
Criar um servidor flexível
Crie um grupo de recursos do Azure usando o az group create comando e, em seguida, crie sua instância de servidor flexível do Banco de Dados do Azure para PostgreSQL dentro desse grupo de recursos. Deverá indicar um nome exclusivo. O exemplo seguinte cria um grupo de recursos com o nome 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 az postgres flexible-server create comando. Cada servidor pode conter várias bases de dados. O comando a seguir 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 abrangendo 0.0.0.0 a 255.255.255.255) à lista de endereços permitidos.
O servidor criado tem os seguintes atributos:
- O mesmo local do seu 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 configurações de servidor restantes: camada de computação (uso geral), tamanho de computação/SKU (
Standard_D2s_v3- 2 vCore, 8 GB de RAM), período de retenção de backup (7 dias) e versão PostgreSQL (13)
Nota
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. É altamente recomendável criar um servidor com acesso privado para acessar seu servidor com segurança usando a integração VNet. Saiba mais sobre Acesso privado no artigo de conceitos.
Se você quiser alterar qualquer padrão, consulte a referência da CLI do Azure para az postgres flexible-server create.
Nota
As conexões com o Banco de Dados do Azure para servidor flexível PostgreSQL se comunicam pela porta 5432. Se você tentar se conectar de dentro de uma rede corporativa, o tráfego de saída pela porta 5432 pode não ser permitido. Se esse for o caso, você não poderá 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 as informações da ligação
Para ligar ao seu servidor, terá de fornecer credenciais de acesso e informações de anfitrião.
az postgres flexible-server show --name mydemoserver --resource-group myresourcegroup
O resultado está no formato JSON. Aponte 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 o cliente de linha de comando PostgreSQL
Primeiro, instale a ferramenta de linha de comando psql .
Com psql, conecte-se ao banco de dados "flexibleserverdb" usando o seguinte comando. Substitua valores pelo nome de domínio e nome de usuário gerados automaticamente.
psql -h mydemoserver.postgres.database.azure.com -U myadmin flexibleserverdb
Nota
Se você receber um erro The parameter PrivateDnsZoneArguments is required, and must be provided by customer, isso significa que você pode estar executando uma versão mais antiga da CLI do Azure. Atualize a CLI do Azure e tente novamente a operação.
Clean up resources (Limpar recursos)
Se não precisa destes recursos para outro início rápido/tutorial, pode eliminá-los ao executar o seguinte comando:
az group delete --name myresourcegroup
Se você gostaria apenas de excluir apenas o servidor recém-criado, você pode executar o az postgres flexible-server delete comando.
az postgres flexible-server delete --resource-group myresourcegroup --name mydemoserver