Connettersi a un cluster in Azure Cosmos DB for PostgreSQL

Importante

Azure Cosmos DB per PostgreSQL non è più supportato per i nuovi progetti. Non usare questo servizio per i nuovi progetti. Usare invece uno dei due servizi seguenti:

• Usare Azure Cosmos DB per NoSQL per una soluzione di database distribuita progettata per scenari su alta scala con un accordo sul livello di servizio (SLA) di disponibilità del 99.999%, scalabilità automatica istantanea e failover automatico in più regioni.

• Usare la funzionalità Cluster elastici di Database di Azure per PostgreSQL per PostgreSQL partizionato usando l'estensione Citus open source.

Scegliere uno dei client di database seguenti per informazioni su come configurarlo per connettersi a un cluster Azure Cosmos DB per PostgreSQL.

pgAdmin

pgAdmin è una piattaforma di amministrazione e sviluppo open source molto diffusa e ricca di funzionalità per PostgreSQL.

1. Scaricare e installare pgAdmin.

2. Aprire l'applicazione pgAdmin nel computer client. Nel dashboard selezionare Aggiungi nuovo server.

   

3. Scegliere un nome nella scheda Generale. Qualsiasi nome funzionerà.

   

4. Immettere i dettagli di connessione nella scheda Connessione.

   

   Personalizzare i campi seguenti:

   • Nome host/indirizzo: ottenere questo valore dalla pagina Panoramica del cluster nel portale di Azure. Viene elencato come Nome coordinatore. Sarà nel formato c-<clustername>.12345678901234.postgres.cosmos.azure.com.
   • Database di manutenzione: usare il valore citus.
   • Nome utente: usare il valore citus.
   • Password: password di connessione o token ID Microsoft Entra. Per ulteriori informazioni consultare Opzioni di autenticazione.
   • Salva password: abilitare, se necessario.

5. Nella scheda SSL impostare la modalità SSL su Richiedi.

   

6. Selezionare Salva per salvare e connettersi al database.

psql

L'utilità psql è un front-end basato su terminale per PostgreSQL. Consente di digitare le query in modo interattivo, inviarle a PostgreSQL e visualizzarne i risultati.

1. Installare psql. È incluso in un'installazione di PostgreSQL o disponibile separatamente nelle gestioni pacchetti per diversi sistemi operativi.

2. 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-<clustername>.<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-demo.12345678901234.postgres.cosmos.azure.com. Questo prefisso indica il nodo coordinatore del cluster. I valori predefiniti dbname e username sono citus e non possono essere modificati.

3. Nella stringa di connessione copiata sostituire <your_password> con la password di connessione o il token ID di Microsoft Entra. Per ulteriori informazioni consultare Opzioni di autenticazione.

4. In un prompt del terminale locale incollare la stringa di connessione psql e quindi premere INVIO.

Passaggi successivi

• Risolvere i problemi di connessione.
• Verificare i certificati TLS nelle connessioni.
• Ora che è possibile connettersi al database, vedere come creare app scalabili.