Início Rápido: Criar uma instância do cluster elástico no Banco de Dados do Azure para PostgreSQL

O Banco de Dados do Azure para PostgreSQL com cluster elástico é um serviço gerenciado que você usa para executar, gerenciar e dimensionar bancos de dados PostgreSQL altamente disponíveis na nuvem com capacidade horizontal de expansão. Este Início Rápido aborda como criar uma instância de cluster elástico usando o portal do Azure.

Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.

Entre no Portal do Azure

Abra o navegador da Web e acesse o portal. Insira suas credenciais para entrar no portal. A exibição padrão é o painel de serviço.

Criar um Banco de Dados do Azure para o servidor PostgreSQL

Um cluster elástico, como uma instância de servidor flexível, é criado com um conjunto configurado de recursos de computação e armazenamento. O cluster é criado em um grupo de recursos do Azure. As etapas descritas em Criar um Banco de Dados do Azure para PostgreSQL se aplicam igualmente a clusters elásticos. Esta seção descreve as alterações no processo.

Para criar uma instância do servidor flexível do Banco de Dados do Azure para PostgreSQL, realize as seguintes etapas:

1. Depois de preencher informações básicas, vá para a seção Configurar servidor.

   

2. Na seção Cluster, selecione a opção Cluster elástico.

   

3. Forneça a contagem de nós desejada e configure o tamanho da computação desejado.

   

4. Salve as alterações e verifique suas opções na página de configuração principal.

   

5. Selecione Revisar + criar para revisar suas seleções. Selecione Criar para provisionar o servidor. Essa operação pode levar alguns minutos.

6. Agora você pode monitorar o progresso da implantação. Depois que a implantação é feita, você pode selecionar Fixar no painel, que cria um bloco para esse servidor no seu painel do portal do Azure como um atalho para a página Visão geral do servidor. A opção Ir para recurso abre a página Visão geral do servidor.

   

   Por padrão, um banco de dados postgres é criado no servidor. O banco de dados postgres é um banco de dados padrão destinado a usuários, utilitários e aplicativos. (O outro banco de dados padrão é azure_maintenance. Sua função é separar os processos de serviço gerenciado das ações do usuário. Você não pode acessar este banco de dados.)

   Observação

   As conexões à instância do servidor flexível do Banco de Dados do Azure para PostgreSQL se comunicam pela porta 5432 e 6432 (PgBouncer). Quando você tenta se conectar de dentro de uma rede corporativa, o tráfego de saída pela porta 5432 e 6432 pode não ser permitido pelo firewall da rede. Nesse caso, você não poderá se conectar ao servidor, a menos que o departamento de TI abra as portas 5432 e 6432. Os clusters elásticos também usam as portas 7432 e 8432 (PgBouncer) para conexões com balanceamento de carga entre os nós do cluster e podem precisar ser incluídos na lista de permissões de maneira semelhante pelo departamento de TI.

Obter informações de conexão

Quando você cria sua instância de cluster elástico, um banco de dados padrão chamado postgres é criado. Para se conectar ao servidor de banco de dados, você precisa do nome do servidor completo e das credenciais de logon do administrador. Você anotou esses valores anteriormente no artigo de Início Rápido. Caso não tenha anotado, poderá encontrar facilmente o nome do servidor e as informações de logon na página Visão geral do servidor no portal.

Abra a página Visão geral do servidor. Anote o Nome do servidor e o Nome de logon do administrador do servidor. Focalize o cursor em cada campo e o símbolo de cópia será exibido à direita do texto. Selecione o símbolo de cópia, conforme necessário, para copiar os valores.

Conectar-se ao banco de dados do Azure para PostgreSQL usando psql

Há vários aplicativos que você pode usar para se conectar à sua instância do servidor flexível do Banco de Dados do Azure para PostgreSQL. Se o computador cliente tiver o PostgreSQL instalado, você poderá usar uma instância local do psql para se conectar a uma instância do servidor flexível do Banco de Dados do Azure para PostgreSQL. Usaremos agora o utilitário de linha de comando psql para nos conectarmos à instância do servidor flexível do Banco de Dados do Azure para PostgreSQL.

1. Execute o comando psql a seguir para se conectar a uma instância do servidor flexível do Banco de Dados do Azure para PostgreSQL.

   psql --host=<servername> --port=<port> --username=<user> --dbname=<dbname>
   

   Por exemplo, o comando a seguir se conecta ao banco de dados padrão chamado postgres na sua instância do servidor flexível do Banco de Dados do Azure para PostgreSQL mydemoserver.postgres.database.azure.com usando as credenciais de acesso. Insira o <server_admin_password> que você escolheu quando uma senha foi solicitada a você.

   psql --host=mydemoserver-pg.postgres.database.azure.com --port=5432 --username=myadmin --dbname=postgres
   

   Para se conectar a um nó aleatório no cluster, use a porta 7432.

   psql --host=mydemoserver-pg.postgres.database.azure.com --port=7432 --username=myadmin --dbname=postgres
   

   Depois que você se conectar, o utilitário psql exibirá um prompt do postgres no qual você digitará os comandos do sql. Na saída da conexão inicial, um aviso pode aparecer porque o psql que você está usando pode ser uma versão diferente da versão da instância de servidor flexível do Banco de Dados do Azure para PostgreSQL.

   Exemplo de saída psql:

   psql (12.3 (Ubuntu 12.3-1.pgdg18.04+1), server 13.2)
   WARNING: psql major version 12, server major version 13.
         Some psql features might not work.
   SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
   Type "help" for help.
   

   Dica

   Se o firewall não estiver configurado para permitir o endereço IP do seu cliente, ocorrerá o seguinte erro:

   psql: FATAL: nenhuma entrada pg_hba.conf para o host <IP address>, usuário "myadmin", banco de dados "postgres", SSL em FATAL: a conexão SSL é obrigatória. Especifique as opções de SSL e tente novamente.

   Confirme se o IP do seu cliente é permitido nas regras de firewall.

2. Crie um esquema em branco chamado "mypgsqlschema" no prompt digitando o seguinte comando:

   CREATE SCHEMA mypgsqlschema;
   

3. No prompt, execute o seguinte comando para distribuir o esquema mypgsqlschema:

   SELECT citus_schema_distribute('mypgsqlschema');
   

4. Digite \q e selecione a tecla ENTER para sair do psql.

Você se conectou ao cluster elástico por meio do psql, criou um esquema em branco e o configurou para ser distribuído.

Limpar os recursos

Limpe os recursos criados no Guia de início rápido usando uma das duas maneiras. Você pode excluir o grupo de recursos do Azure, que inclui todos os recursos do grupo. Se desejar manter os outros recursos intactos, exclua apenas o recurso de servidor.

Dica

Outros Guias de Início Rápido na coleção aproveitam este Guia de Início Rápido. Se você pretende continuar trabalhando com Guias de início rápido, não limpe os recursos criados neste Guia de início rápido. Caso contrário, siga estas etapas para excluir os recursos que foram criados por este Guia de início rápido no portal.

Para excluir o grupo de recursos inteiro, incluindo o servidor recém-criado:

1. Localize o grupo de recursos no portal. No menu à esquerda, selecione Grupos de recursos. Em seguida, selecione o nome do grupo de recursos no qual você criou o recurso banco de dados do Azure para PostgreSQL.

2. Na página do grupo de recursos, selecione Excluir. Para confirmar a exclusão, insira o nome do grupo de recursos na caixa de texto. Selecione Excluir.

Para excluir apenas o servidor recém-criado:

1. Localize o servidor no portal, caso você não esteja com ele aberto. No menu à esquerda, selecione Todos os recursos. Em seguida, procure o servidor que você criou.

2. Na página Visão Geral, selecione Excluir.

   

3. Confirme o nome do servidor que deseja excluir e veja embaixo do nome dele os bancos de dados que são afetados. Insira o nome do servidor na caixa de texto e selecione Excluir.

Conteúdo relacionado

• Crie um banco de dados multilocatário com clusters elásticos.