Connettersi a un cluster con psql - Azure Cosmos DB for PostgreSQL

  • Articolo

SI APPLICA A: Azure Cosmos DB for PostgreSQL (basato sull'estensione di database Citus per PostgreSQL)

Questa guida di avvio rapido illustra come usare la stringa di connessione psql in Azure Cloud Shell per connettersi a un cluster Azure Cosmos DB for PostgreSQL.

Prerequisiti

Connessione

Il cluster ha un database predefinito denominato citus. Per connettersi al database, usare una stringa di connessione e la password di amministratore.

  1. Nella pagina del cluster del portale di Azure selezionare la voce di menu Stringhe di connessione, quindi copiare la stringa di connessione psql.

    Screenshot that shows copying the psql connection string.

    La stringa psql è in formato psql "host=c-<cluster>.<uniqueID>.postgres.cosmos.azure.com port=5432 dbname=citus user=citus password={your_password} sslmode=require". Si noti che il nome host inizia con c., ad esempio c-mycluster.12345678901234.postgres.cosmos.azure.com. Questo prefisso indica il nodo coordinatore del cluster. Il valore dbname predefinito è citus e può essere modificato solo in fase di provisioning del cluster. Il valore user può essere qualsiasi ruolo Postgres valido nel cluster.

  2. Aprire Azure Cloud Shell selezionando l'icona Cloud Shell nella barra dei menu in alto.

    Screenshot that shows the Cloud Shell icon.

    Se richiesto, scegliere una sottoscrizione di Azure in cui archiviare i dati di Cloud Shell.

  3. Incollare la stringa di connessione psql nella shell.

  4. Nella stringa di connessione sostituire {your_password} con la password del cluster e quindi premere INVIO.

    Screenshot that shows running psql in the Cloud Shell.

    Quando psql si connette correttamente al database, viene visualizzato un nuovo prompt citus=> (o il nome personalizzato del database):

    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. Eseguire una query di test. Incollare il comando seguente nel prompt psql e quindi premere INVIO.

    SHOW server_version;

    Verrà visualizzato un risultato corrispondente alla versione di PostgreSQL selezionata durante la creazione del cluster. Ad esempio:

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

Passaggi successivi

Dopo aver eseguito la connessione al cluster, il passaggio successivo consiste nel creare tabelle e partizionarle per il ridimensionamento orizzontale.

Creare e distribuire le tabelle >