Ottenere le stringhe di connessione

Ottenere le stringhe di connessione nell'interfaccia utente

Per connetterti a IBM Cloud® Databases for PostgreSQL, hai bisogno di alcuni utenti e stringhe di connessione. Le stringhe di connessione per l'installazione sono visualizzate nella pagina Overview, nel pannello Endpoints.

Pannello dei punti finali nella panoramica del cruscotto

Viene eseguito il provisioning di una distribuzione Databases for PostgreSQL con un utente amministratore e, dopo aver impostato la password amministratore, puoi utilizzarne le stringhe di connessione per collegarti alla tua distribuzione.

Ottenere le stringhe di connessione nella CLI

Prendi le stringhe di connessione dalla CLI.

ibmcloud cdb deployment-connections example-deployment -u <NEW_USERNAME> [--endpoint-type <ENDPOINT_TYPE>]

Le informazioni di connessione complete vengono restituite dal comando ibmcloud cdb deployment-connections con l'indicatore --all. Per richiamare tutte le informazioni di connessione per una distribuzione denominata "example-deployment", utilizzare il seguente comando.

ibmcloud cdb deployment-connections example-deployment -u <NEW_USERNAME> --all [--endpoint-type <ENDPOINT_TYPE>]

Se non specifichi un utente, i comandi deployment-connections restituiscono le informazioni per l'utente amministratore per impostazione predefinita. Se non si specifica un tipo di endpoint, la stringa di connessione restituisce l'endpoint pubblico per impostazione predefinita. Se la distribuzione dispone solo di un endpoint privato, è necessario specificare --endpoint-type private o i comandi restituiscono un errore. L'utente e il tipo di endpoint non sono applicati. Puoi utilizzare qualsiasi utente nella tua distribuzione con entrambi gli endpoint (se entrambi esistono nella tua distribuzione).

Per utilizzare i comandi CLI ibmcloud cdb, devi installare il plug-in Cloud Databases.

Ottenere le stringhe di connessione nell'API

Per richiamare le stringhe di connessione dall'API, utilizza l'endpoint /users/{userid}/connections. È necessario specificare nel percorso quale utente e quale tipo di endpoint (pubblico o privato) deve essere utilizzato nelle stringhe di connessione restituite. L'utente e il tipo di endpoint non sono applicati. Puoi utilizzare qualsiasi utente nella tua distribuzione con entrambi gli endpoint (se entrambi esistono nella tua distribuzione).

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

Ripartizione della stringa di connessione

La sezione PostgreSQL

La scheda "PostgreSQL" contiene informazioni adatte alle applicazioni che si collegano a PostgreSQL.

informazioni sulla connessione postgresql/URI
Nome campo	Indice	Descrizione
`Type`		Tipo di connessione: per PostgreSQL, è "URI"
`Scheme`		Schema per un URI: per PostgreSQL, è "postgresql"
`Path`		Percorso per un URI - per PostgreSQL, è il nome del database. Il valore predefinito è `ibmclouddb`.
`Authentication`	`Username`	Il nome utente utilizzato per la connessione.
`Authentication`	`Password`	Una password per l'utente - potrebbe essere mostrata come `$PASSWORD`
`Authentication`	`Method`	Come avviene l'autenticazione; l'autenticazione "diretta" è gestita dal driver.
`Hosts`	`0...`	Un nome di host e una porta a cui connettersi
`Composed`	`0...`	Un URI che combina Scheme, Authentication, Host e Path
`Certificate`	`Name`	Il nome assegnato per il certificato proprietario del servizio per la distribuzione del database
`Certificate`	Base64	Una versione codificata base64 del certificato.

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.

informazioni sulla connessione psql/cli
Nome campo	Indice	Descrizione
`Bin`		Il binario per creare una connessione; in questo caso è `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 chiavi/valori impostati come variabili d'ambiente.
`Arguments`	0...	Le informazioni che vengono passate come argomenti al comando, visualizzate nel campo Bin.
`Certificate`	Base64	Un certificato proprietario del servizio che viene utilizzato per confermare che un'applicazione si sta connettendo al server appropriato. Ha una codifica base64.
`Certificate`	Nome	Il nome assegnato per il certificato proprietario del servizio.
`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.