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

Importante

O Azure Cosmos DB para PostgreSQL não tem mais suporte para novos projetos. Não use este serviço para novos projetos. Em vez disso, use um destes dois serviços:

• Use o Azure Cosmos DB para NoSQL para obter uma solução de banco de dados distribuído projetada para cenários de alta escala com um SLA (contrato de nível de serviço) de disponibilidade de 99.999%, dimensionamento automático instantâneo e failover automático em várias regiões.

• Use a funcionalidade de Clusters Elásticos do Azure para PostgreSQL para PostgreSQL fragmentado, utilizando a extensão Citus de código aberto.

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

pgAdmin

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

1. Baixe e instale o pgAdmin.

2. Abra a aplicação 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. Está listado lá como nome do Coordenador. Será da forma, c-<clustername>.12345678901234.postgres.cosmos.azure.com.
   • Base de dados de manutenção: utilize o valor citus.
   • Nome de usuário: use o valor citus.
   • Senha: a senha de conexão ou o token de ID do Microsoft Entra. Para obter mais informações, consulte Opções de autenticação.
   • Guardar palavra-passe: ativar se desejar.

5. Na guia SSL, defina o modo SSL como Exigir.

   

6. Selecione Salvar para salvar e conectar-se ao banco de dados.

psql

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

1. Instale o psql. Ele está incluído em uma instalação do PostgreSQL ou disponível 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 de caracteres psql é do formato 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 um c-, por exemplo c-demo.12345678901234.postgres.cosmos.azure.com. Esse prefixo indica o nó coordenador do cluster. O padrão dbname e username são citus e não podem ser alterados.

3. Na cadeia de conexão copiada, substitua <your_password> pela senha de conexão ou pelo token de ID do Microsoft Entra. Para obter mais informações, consulte Opções de autenticação.

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

Próximos passos

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