Ligar a um cluster com psql – Azure Cosmos DB para PostgreSQL

  • Artigo

APLICA-SE A: Azure Cosmos DB para PostgreSQL (com tecnologia da extensão da base de dados Citus para PostgreSQL)

Este início rápido mostra como utilizar a cadeia de ligação psql no Azure Cloud Shell ligar a um cluster do Azure Cosmos DB para PostgreSQL.

Pré-requisitos

Ligar

O cluster tem uma base de dados predefinida chamada citus. Para ligar à base de dados, utilize uma cadeia de ligação e a palavra-passe de administrador.

  1. Na portal do Azure, na página do cluster, selecione o item de menu Cadeias de ligação e, em seguida, copie a cadeia de ligação psql.

    Captura de ecrã que mostra a cópia da cadeia de ligação psql.

    A cadeia psql é do formulário psql "host=c-<cluster>.<uniqueID>.postgres.cosmos.azure.com port=5432 dbname=citus user=citus password={your_password} sslmode=require". Repare que o nome do anfitrião começa com um c., por exemplo c-mycluster.12345678901234.postgres.cosmos.azure.com. Este prefixo indica o nó de coordenação do cluster. A predefinição dbname é citus e só pode ser alterada no momento do aprovisionamento do cluster. Pode user ser qualquer função do Postgres válida no cluster.

  2. Abra o Azure Cloud Shell ao selecionar o ícone Cloud Shell na barra de menus superior.

    Captura de ecrã a mostrar o ícone Cloud Shell.

    Se lhe for pedido, escolha uma subscrição do Azure na qual armazenar Cloud Shell dados.

  3. Cole a cadeia de ligação psql na shell.

  4. Na cadeia de ligação, substitua pela {your_password} palavra-passe do cluster e, em seguida, prima Enter.

    Captura de ecrã a mostrar a execução do psql no Cloud Shell.

    Quando o psql se ligar com êxito à base de dados, verá um novo citus=> pedido (ou o nome personalizado da base 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 na linha de comandos psql e, em seguida, prima Enter.

    SHOW server_version;

    Deverá ver um resultado que corresponde à versão do PostgreSQL que selecionou durante a criação do cluster. Por exemplo:

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

Passos seguintes

Agora que se ligou ao cluster, o próximo passo é criar tabelas e fragmentá-las para dimensionamento horizontal.

Criar e distribuir tabelas >