Ottenere le stringhe di connessione

Gen 2

Ottenere le stringhe di connessione nell'interfaccia utente

Segui questi passaggi per recuperare le stringhe di connessione della tua istanza di IBM Cloud® Databases for PostgreSQL:

  1. Nella pagina Panoramica della tua distribuzione, scorri verso il basso fino alla sezione Endpoint del servizio.
  2. La sezione " Endpoint di servizio " mostra le schede relative ai metodi di connessione disponibili:
  • PostgreSQL – Mostra la stringa di connessione, i nomi host, le porte, il nome del database, la fonte di autenticazione e il set di repliche della tua distribuzione.
  • CLI – Fornisce informazioni dettagliate su come effettuare la connessione tramite l'interfaccia CLI di IBM.

Architettura
Ottenere le stringhe di connessione - Endpoint dei servizi PostgreSQL scheda

Databases for PostgreSQL Le distribuzioni non includono più l' admin user predefinito. È invece necessario creare un utente con il ruolo "Manager", "Writer" o "Reader" utilizzando l'interfaccia delle credenziali del servizio IBM Cloud®, tramite l'interfaccia utente o la CLI. Qui vengono forniti un nome utente (ibm_...), una password e una stringa di connessione che possono essere utilizzati per connettersi alla propria distribuzione.

Ottenere le stringhe di connessione nella CLI

È inoltre possibile trovare l'endpoint nella scheda CLI degli endpoint del servizio.

Architettura
: Ottenere le stringhe di connessione - Scheda CLI degli endpoint di servizio

È inoltre possibile recuperare le stringhe di connessione utilizzando il comando "Connection" del plug-in CLI di Cloud Databases.

Il comando è il seguente:

ibmcloud resource service-instance <INSTANCE_NAME_OR_CRN>

Per ulteriori informazioni, consultare le opzioni del comando "Connessioni ".

Databases for PostgreSQL Le installazioni non includono più un utente amministratore predefinito. I clienti creano invece un utente con il ruolo "Manager", "Writer" o "Reader" utilizzando l'interfaccia delle credenziali del servizio IBM Cloud®, tramite interfaccia utente o CLI. Qui vengono forniti un nome utente (ibm_...), una password e una stringa di connessione che possono essere utilizzati per connettersi alla propria distribuzione. Se la tua distribuzione dispone solo di un endpoint privato, devi specificare --endpoint-type private, altrimenti i comandi restituiranno un errore. Il tipo di utente e di endpoint non è obbligatorio. È possibile utilizzare qualsiasi utente presente nella propria distribuzione con l'endpoint privato, che rappresenta l'opzione di connessione designata.

Per utilizzare i comandi CLI di “ ibmcloud cdb ”, è necessario installare il plug-in “ Cloud Databases ”.

Ottenere le stringhe di connessione nell'API

Per recuperare le stringhe di connessione degli utenti dall'API Cloud Databases, utilizzare l'endpoint Connections. Per creare le stringhe di connessione, assicurarsi che il percorso includa l'utente specifico e il tipo di endpoint da utilizzare. La legge " user " non è soggetta ad alcuna restrizione né viene applicata. Hai la possibilità di utilizzare qualsiasi utente disponibile nella tua implementazione.

Il comando API è il seguente:

curl -X GET 'https://resource-controller.cloud.ibm.com/v2/resource_instances/{id}' -H "Authorization: Bearer <IAM token>""

Ricordati di sostituire {region}, {id}, {userid} e {endpoint_type} con i valori corretti.

Ottenere le stringhe di connessione nell'API

Per recuperare le stringhe di connessione dell'utente dall'API, utilizzare l'/users/{userid}/connections endpoint. È necessario specificare nel percorso quale utente e quale tipo di endpoint (pubblico o privato) devono essere utilizzati nelle stringhe di connessione restituite. Il tipo di utente e di endpoint non è obbligatorio. È possibile utilizzare qualsiasi utente presente nella propria distribuzione con entrambi gli endpoint (se entrambi sono presenti nella propria distribuzione).

curl -X GET -H "Authorization: Bearer $APIKEY" 'https://api.{region}.databases.cloud.ibm.com/v4/ibm/deployments/{id}/users/{userid}/connections/{endpoint_type}'

Analisi della stringa di connessione

La sezione " PostgreSQL "

La scheda " "PostgreSQL" " contiene informazioni relative alle applicazioni che si connettono a PostgreSQL.

PostgreSQL/URI informazioni sulla connessione
Nome campo Indice Descrizione
Type Tipo di connessione: per PostgreSQL, è "URI".
Scheme Schema per un URI: per PostgreSQL, è "postgresql".
Path Percorso di un URI: nel caso di PostgreSQL,, corrisponde al nome del database. Il valore predefinito è ibmclouddb.
Authentication Username Il nome utente che utilizzi per collegarti.
Authentication Password Una password per l'utente - potrebbe essere visualizzata come $PASSWORD.
Authentication Method Come avviene l'autenticazione; l'autenticazione "diretta" è gestita dal driver.
Hosts 0... Un nome host e una porta a cui connettersi.
Composed 0... Un URI che combina Scheme, Autenticazione, Host e Percorso.
  • 0... indica una o più di queste voci in un array.

La sezione CLI

La sezione "CLI" contiene le informazioni adatte per la connessione con psql.

PostgreSQL/cli informazioni sulla connessione
Nome campo Indice Descrizione
Bin Il file binario per stabilire una connessione; in questo caso si tratta di psql.
Composed Un comando formattato per stabilire una connessione alla tua distribuzione. Il comando combina l'eseguibile Bin, le impostazioni della variabile Environment e utilizza Arguments come parametri della riga di comando.
Environment Un elenco di coppie chiave/valore che hai impostato come variabili d'ambiente.
Arguments 0... Le informazioni che vengono passate come argomenti al comando indicato nel campo "Bin".
Type Il tipo di pacchetto che utilizza queste informazioni di connessione; in questo caso cli.
  • 0... indica che in un array potrebbero essere presenti una o più di queste voci.