Conectar-se a um cluster no Azure Cosmos DB for PostgreSQL

APLICA-SE AO: Azure Cosmos DB for PostgreSQL (da plataforma da extensão de dados Citus para PostgreSQL)

Escolha um dos seguintes clientes de banco de dados para ver como configurá-lo para se conectar a um cluster do Azure Cosmos DB for PostgreSQL.

pgAdmin

pgAdmin é uma plataforma de administração e desenvolvimento de código aberto popular e repleta de recursos para PostgreSQL.

1. Baixe e instale o pgAdmin.

2. Abra o aplicativo pgAdmin no computador cliente. No Painel, selecione Adicionar Novo Servidor.

   

3. Escolha um Nome na guia Geral. Qualquer nome funcionará.

   

4. Insira os detalhes da conexão na guia Conexão.

   

   Personalize os seguintes campos:

   • Nome/endereço do host: obtenha esse valor na página Visão geral do cluster no portal do Azure. Ele está listado como Nome do coordenador. Ela estará no formato c-<clustername>.12345678901234.postgres.cosmos.azure.com.
   • Banco de dados de manutenção: use o valor citus.
   • Nome de usuário: use o valor citus.
   • Password: a senha de conexão ou o token do Microsoft Entra ID. Para mais informações, consulte opções de autenticação.
   • Salvar senha: habilite esta opção se desejar.

5. Na guia SSL, defina o modo SSL como Obrigatório.

   

6. Selecione Salvar para salvar as configurações e conectar-se ao banco de dados.

psql

O utilitário psql é um front-end baseado em terminal para o PostgreSQL. Ele permite que você digite consultas de maneira interativa, emita-as para o PostgreSQL e veja os resultados da consulta.

1. Instale o psql. Ele é incluído com uma instalação do PostgreSQL ou disponibilizado separadamente em gerenciadores de pacotes para vários sistemas operacionais.

2. No portal do Azure, na página do cluster, selecione o item de menu Cadeias de Conexão e copie a cadeia de conexão psql.

   

   A cadeia psql tem a forma de psql "host=c-<clustername>.<uniqueID>.postgres.cosmos.azure.com port=5432 dbname=citus user=citus password=<your_password> sslmode=require". Observe que o nome do host começa com c-, por exemplo, c-demo.12345678901234.postgres.cosmos.azure.com. Esse prefixo indica o nó coordenador do cluster. O padrão de dbname e username é citus, e não pode ser alterado.

3. Na cadeia de conexão que você copiou, substitua <your_password> por sua senha de conexão ou seu token do Microsoft Entra ID. Para mais informações, consulte opções de autenticação.

4. Em um prompt do terminal local, cole a cadeia de conexão do psql e depois pressione Enter.

Próximas etapas

• Solucionar problemas de conexão.
• Verifique os certificados TLS nas suas conexões.
• Agora que você consegue se conectar ao banco de dados, saiba como criar aplicativos escalonáveis.