Partilhar via

Ligar-se a um cluster com psql - Azure Cosmos DB para PostgreSQL

  • Aplica-se a: ✅ 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.

Este guia de início rápido mostra como usar a cadeia de conexão psql no Azure Cloud Shell para se conectar a um cluster do Azure Cosmos DB para PostgreSQL.

Pré-requisitos

Conectar

Seu cluster tem um banco de dados padrão chamado citus. Para ligar à base de dados, utilize uma cadeia de ligação e a palavra-passe de administrador.

  1. 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.

    Captura de tela que mostra como copiar a cadeia de conexão psql.

    A cadeia de caracteres psql é do formato psql "host=c-<cluster>.<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-mycluster.12345678901234.postgres.cosmos.azure.com. Este prefixo assinala o nó coordenador do cluster. O padrão dbname é citus e pode ser alterado somente no momento do provisionamento do cluster. O user pode ser qualquer função válida do Postgres no seu cluster.

  2. Abra o Azure Cloud Shell selecionando o ícone do Cloud Shell na barra de menus superior.

    Captura de tela que mostra o ícone do Cloud Shell.

    Se solicitado, escolha uma assinatura do Azure na qual armazenar dados do Cloud Shell.

  3. Cole a sua cadeia de conexão psql na linha de comandos.

  4. Na cadeia de conexão, substitua {your_password} pela senha do cluster ou pelo token de ID do Microsoft Entra e pressione Enter.

    Captura de tela que mostra a execução do psql no Cloud Shell.

    Quando o psql se liga com sucesso ao banco de dados, vê-se um novo prompt citus=> (ou o nome personalizado do seu banco de dados):

    psql (14.2, server 14.5)
SSL connection (protocol: TLSv1.2, cipher: ECDHE-RSA-AES256-GCM-SHA384, bits: 256, compression: off)
Type "help" for help.

citus=>

  5. Execute uma consulta de teste. Cole o seguinte comando no prompt psql e pressione Enter.

    SHOW server_version;

    Você verá um resultado correspondente à versão do PostgreSQL selecionada durante a criação do cluster. Por exemplo:

     server_version
----------------
 14.5
(1 row)

Próximos passos

Agora que você se conectou ao cluster, a próxima etapa é criar tabelas e fragmentá-las para dimensionamento horizontal.

Criar e distribuir tabelas >

  • Last updated on