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 pour votre déploiement s'affichent sur la page Aperçu, 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 les chaînes de connexion dans l'interface de ligne de commande (CLI)

Récupérer les chaînes de connexion depuis l'interface de ligne de commande(CLI).

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.

Récupération 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 préciser dans le chemin d'accès quel utilisateur et quel type de point de terminaison (public ou privé) doivent être utilisés 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 se connectent à PostgreSQL.

Informations de connexion PostgreSQL/URI
Nom de zone	Index	Description
`Type`		Type de connexion : pour PostgreSQL, il s'agit de URI.
`Scheme`		Schéma d'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 de 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...`	Un URI combinant le schéma, l'authentification, l'hôte et le chemin d'accès.
`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 utiles pour se connecter à psql.

informations sur la connexion psql/cli
Nom de zone	Index	Description
`Bin`		Le fichier binaire permettant d'établir 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 du 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.