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:
- Nella pagina Panoramica della tua distribuzione, scorri verso il basso fino alla sezione Endpoint del servizio.
- 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.
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.
È 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.
| 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.
| 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.