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

Un'istanza di Databases for PostgreSQL viene configurata con un utente amministratore e, dopo aver impostato la password di amministratore, è possibile utilizzare le relative stringhe di connessione per connettersi all'istanza.

Ottenere le stringhe di connessione nella CLI

Ottenere 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 di “ ibmcloud cdb ”, è necessario 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 relative alle applicazioni che si connettono 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 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" viene 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.
`Certificate`	`Name`	Il nome assegnato al certificato proprietario del servizio per l'implementazione del database.
`Certificate`	Base64	Una versione del certificato codificata in formato " base64 ".

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 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 visualizzato nel campo "Bin".
`Certificate`	Base64	Un certificato proprietario del servizio utilizzato per confermare che un'applicazione si stia connettendo al server corretto. Ha una codifica base64.
`Certificate`	Nome	Il nome assegnato al 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.