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

Importante

Azure Cosmos DB per PostgreSQL si trova in un percorso di ritiro e non è più consigliato per i nuovi progetti. Usare invece uno dei due servizi seguenti:

• Per i carichi di lavoro PostgreSQL : utilizzare la funzionalità Cluster Elastici di Azure Database per PostgreSQL per sfruttare le capacità di scalabilità orizzontale e distribuita e le funzionalità di PostgreSQL fornite dall'estensione open source Citus. Per indicazioni sulla migrazione, vedere migrare ad Database di Azure per PostgreSQL con Elastic Cluster.

• Per i carichi di lavoro NoSQL, utilizzare Azure Cosmos DB per NoSQL per una soluzione di database distribuita che include un accordo sul livello di servizio (SLA) del 99,999% di disponibilità, la scalabilità automatica istantanea e il failover automatico in più aree.

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

• Un account Azure con una sottoscrizione attiva. Se non ne hai uno, crea gratuitamente un account.
• Un cluster Azure Cosmos DB for PostgreSQL. Per creare un cluster, vedere Creare un cluster nel portale di Azure.

Connect

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.

   

   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.

   

   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 di Microsoft Entra ID, quindi premere Immetti.

   

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