Guia de início rápido: use o comando az postgres up para criar um Banco de Dados do Azure para PostgreSQL - Servidor Único
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?.
A Base de Dados do Azure para o PostgreSQL é um serviço gerido que lhe permite executar, gerir e dimensionar as bases de dados de alta disponibilidade do PostgreSQL na cloud. A CLI do Azure é utilizada para criar e gerir recursos do Azure a partir da linha de comandos ou em scripts. Este guia de início rápido mostra como usar o comando az postgres up para criar um Banco de Dados do Azure para o servidor PostgreSQL usando a CLI do Azure. Além de criar o servidor, o az postgres up
comando cria um banco de dados de exemplo, um usuário raiz no banco de dados, abre o firewall para serviços do Azure e cria regras de firewall padrão para o computador cliente. Esses padrões ajudam a agilizar o processo de desenvolvimento.
Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.
Criar um servidor da Base de Dados do Azure para PostgreSQL
Pré-requisitos
Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.
Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.
Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.
Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.
Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.
Iniciar o Azure Cloud Shell
O Azure Cloud Shell é um shell interativo gratuito que pode utilizar para executar os passos 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. Também pode iniciar o Cloud Shell num separador do browser separado ao aceder a https://shell.azure.com.
Quando o Cloud Shell abrir, verifique se o Bash está selecionado para o 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-o no Cloud Shell e pressione Enter para executá-lo.
Iniciar sessão no Azure
O Cloud Shell é autenticado automaticamente na conta inicial com a qual entrou conectado. Use o script a seguir para entrar usando uma assinatura diferente, substituindo <Subscription ID>
pela sua ID de Assinatura do Azure. Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
Para obter mais informações, consulte definir assinatura ativa ou fazer login interativamente
Instale a extensão db-up . Se um erro for retornado, verifique se você instalou a versão mais recente da CLI do Azure. Consulte Instalar a CLI do Azure.
az extension add --name db-up
Crie um Banco de Dados do Azure para o servidor PostgreSQL usando o seguinte comando:
az postgres up
O servidor é criado com os seguintes valores padrão (a menos que você os substitua manualmente):
Definição | Valor predefinido | Descrição |
---|---|---|
server-name | Sistema gerado | Um nome exclusivo que identifique a sua Base de Dados do Azure para o servidor PostgreSQL. |
resource-group | Sistema gerado | Um novo grupo de recursos do Azure. |
sku-name | GP_Gen5_2 | O nome de SKU. Segue a convenção {pricing tier}_{compute generation}_{vCores} em taquigrafia. O padrão é um servidor Gen5 de uso geral com 2 vCores. Consulte a nossa página de preços para obter mais informações sobre os níveis. |
backup-retention | 7 | Por quanto tempo um backup é mantido. A unidade é dias. |
geo-redundant-backup | Desativado | Se as cópias de segurança georredundantes devem estar ativadas para este servidor ou não. |
localização | westus2 | A localização do Azure para o servidor. |
ssl-enforcement | Desativado | Se o TLS/SSL deve ser habilitado ou não para este servidor. |
storage-size | 5120 | A capacidade de armazenamento do servidor (a unidade é megabytes). |
versão | 10 | A versão principal do PostgreSQL. |
admin-user | Sistema gerado | O nome de usuário do administrador. |
admin-password | Sistema gerado | A palavra-passe do utilizador administrador. |
Nota
Para obter mais informações sobre o az postgres up
comando e seus parâmetros adicionais, consulte a documentação da CLI do Azure.
Uma vez que o servidor é criado, ele vem com as seguintes configurações:
- Uma regra de firewall chamada "devbox" é criada. A CLI do Azure tenta detetar o endereço IP da máquina a partir da qual o
az postgres up
comando é executado e permite esse endereço IP. - "Permitir acesso aos serviços do Azure" está definido como ATIVADO. Essa configuração configura o firewall do servidor para aceitar conexões de todos os recursos do Azure, incluindo recursos que não estão em sua assinatura.
- Um banco de dados vazio chamado "sampledb" é criado
- Um novo usuário chamado "root" com privilégios para "sampledb" é criado
Nota
O Banco de Dados do Azure para PostgreSQL se comunica pela porta 5432. Ao ligar a partir de uma rede empresarial, o tráfego de saída através da porta 5432 poderá não ser permitido pela firewall da rede. Faça com que seu departamento de TI abra a porta 5432 para se conectar ao seu servidor.
Obter as informações da ligação
Depois que o az postgres up
comando for concluído, uma lista de cadeias de conexão para linguagens de programação populares será retornada para você. Essas cadeias de conexão são pré-configuradas com os atributos específicos do seu recém-criado Banco de Dados do Azure para servidor PostgreSQL.
Você pode usar o comando az postgres show-connection-string para listar essas cadeias de conexão novamente.
Clean up resources (Limpar recursos)
Limpe todos os recursos criados no início rápido usando o comando a seguir. Este comando exclui o Banco de Dados do Azure para o servidor PostgreSQL e o grupo de recursos.
az postgres down --delete-group
Se você gostaria apenas de excluir o servidor recém-criado, você pode executar o comando az postgres down .
az postgres down