Obtention de chaînes de connexion

Obtenir les chaînes de connexion dans l'interface utilisateur

Pour vous connecter à IBM Cloud® Databases for PostgreSQL, vous avez besoin d'utilisateurs et de chaînes de connexion. Les chaînes de connexion de votre déploiement sont affichées sur la page Vue d'ensemble, dans le panneau Points de terminaison.

Panneau des points de terminaison dans la vue d'ensemble du tableau de bord

Un déploiement Databases for PostgreSQL est mis à disposition avec un nom d'administrateur, et après avoir défini le mot de passe d'administrateur, vous pouvez utiliser ses chaînes de connexion pour vous connecter à votre déploiement.

Obtenir des chaînes de connexion dans le CLI

Saisissez les chaînes de connexion à partir de l'interface de ligne de commande.

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

Les informations de connexion complètes sont renvoyées par la commande ibmcloud cdb deployment-connections exécutée avec l'option --all. Pour extraire toutes les informations de connexion pour un déploiement nommé "example-deployment", utilisez la commande suivante :

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

Si vous ne spécifiez pas d'utilisateur, les commandes deployment-connections renvoient des informations pour l'administrateur par défaut. Si vous ne spécifiez pas de type de noeud final, la chaîne de connexion renvoie le noeud final public par défaut. Si votre déploiement ne comporte qu'un noeud final privé, vous devez spécifier --endpoint-type private sinon la commande renvoie une erreur. L'utilisateur et le type de noeud final ne sont pas imposés. Vous pouvez utiliser n'importe quel utilisateur sur votre déploiement avec l'un ou l'autre des noeuds finaux (si les deux existent sur votre déploiement).

Pour utiliser les commandes ibmcloud cdb de l'interface CLI, vous devez installer le plug-in Cloud Databases.

Obtenir des chaînes de connexion dans l'API

Pour extraire les chaînes de connexion d'un utilisateur à partir de l'API, utilisez le noeud final /users/{userid}/connections. Vous devez spécifier dans le chemin d'accès l'utilisateur et le type de point d'accès (public ou privé) à utiliser dans les chaînes de connexion renvoyées. L'utilisateur et le type de noeud final ne sont pas imposés. Vous pouvez utiliser n'importe quel utilisateur sur votre déploiement avec l'un ou l'autre des noeuds finaux (si les deux existent sur votre déploiement).

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

Décomposition de chaîne de connexion

Section PostgreSQL

L'onglet "PostgreSQL" contient des informations adaptées aux applications qui établissent des connexions avec PostgreSQL.

informations sur la connexion postgresql/URI
Nom de zone	Index	Description
`Type`		Type de connexion. Pour PostgreSQL, il s'agit de "URI. "
`Scheme`		Schéma pour un URI. Pour PostgreSQL, il s'agit de "postgresql. "
`Path`		Chemin pour un URI. Pour PostgreSQL, il s'agit du nom de la base de données. La valeur par défaut est `ibmclouddb`.
`Authentication`	`Username`	Nom d'utilisateur que vous utilisez pour vous connecter.
`Authentication`	`Password`	Mot de passe pour l'utilisateur - peut s'afficher sous la forme `$PASSWORD`
`Authentication`	`Method`	Méthode d'authentification. L'authentification "directe" est gérée par le pilote.
`Hosts`	`0...`	Nom d'hôte et port auxquels se connecter.
`Composed`	`0...`	URI combinant le schéma, l'authentification, l'hôte et le chemin
`Certificate`	`Name`	Nom attribué au certificat propriétaire du service pour le déploiement de la base de données
`Certificate`	Base64	Version codée en base64 du certificat.

0... indique une ou plusieurs de ces entrées dans un tableau.

Section CLI

La section "CLI" contient des informations adaptées à la connexion avec psql.

informations sur la connexion psql/cli
Nom de zone	Index	Description
`Bin`		Le binaire pour créer une connexion; dans ce cas, il s'agit de `psql`.
`Composed`		Commande formatée pour établir une connexion à votre déploiement. La commande combine l'exécutable `Bin`, les paramètres de la variable `Environment` et utilise `Arguments` comme paramètres de ligne de commande.
`Environment`		Liste de clés/valeurs que vous définissez en tant que variables d'environnement.
`Arguments`	0...	Informations qui sont transmises en tant qu'arguments à la commande affichée dans la zone Bin.
`Certificate`	Base64	Certificat propriétaire de service utilisé pour confirmer qu'une application se connecte au serveur approprié. Il est encodé en base64.
`Certificate`	Nom	Nom attribué au certificat propriétaire du service.
`Type`		Type de package qui utilise ces informations de connexion ; en l'occurrence, `cli`.

0... indique qu'il peut y avoir une ou plusieurs de ces entrées dans un tableau.