Obtention de chaînes de connexion
Génération 2
Récupération des chaînes de connexion dans l'interface utilisateur
Suivez ces étapes pour récupérer les chaînes de connexion de votre instance d' IBM Cloud® Databases for PostgreSQL:
- Sur la page « Aperçu » de votre déploiement, faites défiler vers le bas jusqu'à la section « Points de terminaison du service ».
- La section « Points de terminaison du service » affiche des onglets correspondant aux méthodes de connexion disponibles :
- PostgreSQL – Affiche la chaîne de connexion, les noms d'hôte, les ports, le nom de la base de données, la source d'authentification et le jeu de répliques de votre déploiement.
- CLI – Fournit des informations détaillées sur la connexion à l'aide de l'interface CLI d' IBM.
Databases for PostgreSQL Les déploiements n'incluent plus par défaut le fichier « admin user ». Vous devez plutôt créer un utilisateur doté du rôle « Manager », « Writer » ou « Reader » à l'aide de l'interface de gestion des identifiants
du service IBM Cloud®, que ce soit via l'interface utilisateur ou la ligne de commande. Vous disposez ainsi d'un nom d'utilisateur (ibm_...), d'un mot de passe et d'une chaîne de connexion qui peuvent être utilisés pour vous connecter à votre
déploiement.
Récupération des chaînes de connexion dans l'interface de ligne de commande
Vous pouvez également trouver ce point de terminaison dans l'onglet « CLI » des points de terminaison du service.
Vous pouvez également récupérer les chaînes de connexion à l'aide de la commande « Connection » du plug-in CLI d' Cloud Databases.
La commande est similaire à celle-ci :
ibmcloud resource service-instance <INSTANCE_NAME_OR_CRN>
Pour plus d'informations, consultez la section « Options de la commande Connections ».
Databases for PostgreSQL Les déploiements n'incluent plus d'utilisateur administrateur par défaut. Au lieu de cela, les clients créent un utilisateur doté du rôle « Manager », « Writer » ou « Reader » à l'aide de l'interface de gestion des identifiants
du service IBM Cloud®, via l'interface utilisateur ou la ligne de commande. Vous disposez ainsi d'un nom d'utilisateur (ibm_...), d'un mot de passe et d'une chaîne de connexion qui peuvent être utilisés pour vous connecter à votre déploiement.
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 de votre déploiement avec le point de terminaison privé, qui constitue l'option de connexion désignée.
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 récupérer les chaînes de connexion des utilisateurs à partir de l'API Cloud Databases, utilisez le point de terminaison « Connections ». Pour créer les chaînes de connexion, veillez à ce que le chemin d'accès inclue l'utilisateur et le type de point de terminaison spécifiques à utiliser. La loi sur la
protection des personnes handicapées ( user ) ne fait l'objet d'aucune restriction ni d'aucune mesure coercitive. Vous avez la possibilité d'utiliser n'importe quel utilisateur disponible dans votre déploiement.
La commande API se présente comme suit :
curl -X GET 'https://resource-controller.cloud.ibm.com/v2/resource_instances/{id}' -H "Authorization: Bearer <IAM token>""
N'oubliez pas de remplacer {region}, {id}, {userid} et {endpoint_type} par les valeurs appropriées.
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 destinées aux applications qui établissent des connexions avec PostgreSQL.
| Nom de zone | Index | Description |
|---|---|---|
Type |
Type de connexion : pour PostgreSQL,, il s'agit de « URI ». | |
Scheme |
Schéma d'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 de l'utilisateur : il 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... |
Une URI combinant le schéma, l'authentification, l'hôte et le chemin d'accès. |
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.
| Nom de zone | Index | Description |
|---|---|---|
Bin |
Le fichier binaire permettant d'établir une connexion; dans ce cas précis, 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. |
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.