Condividi tramite


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

SI APPLICA A: Azure Cosmos DB for PostgreSQL (con tecnologia basata su 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 che mostra la copia del stringa di connessione psql.

    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 che mostra l'icona di Cloud Shell.

    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 o il token ID di Microsoft Entra e quindi premere INVIO.

    Screenshot che mostra l'esecuzione di psql in 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.