Conectar-se a um cluster com psql - Azure Cosmos DB for PostgreSQL

APLICA-SE A: Azure Cosmos DB para PostgreSQL (alimentado pela extensão de banco de dados Citus para PostgreSQL)

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

• Uma conta do Azure com uma subscrição ativa. Se você não tiver uma, crie uma conta gratuitamente.
• Um cluster do Azure Cosmos DB para PostgreSQL. Para criar um cluster, consulte Criar um cluster no portal do Azure.

Ligar

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.

   

   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. Esse prefixo indica 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.

   

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

3. Cole sua cadeia de conexão psql no shell.

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

   

   Quando o psql se conecta com êxito ao banco de dados, você vê um novo citus=> prompt (ou o nome personalizado do 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 >