Obtention de chaînes de connexion

Pour vous connecter à IBM Cloud® Databases for MySQL, vous avez besoin d'utilisateurs et de chaînes de connexion. Les chaînes de connexion de votre déploiement s'affichent dans le panneau Vue d'ensemble de, dans le panneau Noeuds finaux.

Panneau des points de terminaison dans le tableau de bord Aperçu*Panneau des
de terminaison dans le tableau de bord

Un déploiement Databases for MySQL est doté d'un utilisateur admin et, après avoir défini le mot de passe admin, utilise ses chaînes de connexion pour se connecter à votre déploiement.

CLI
Vous pouvez également récupérer des chaînes de connexion à partir de l'interface de ligne de commande.

ibmcloud cdb deployment-connections example-deployment -u <newusername> [--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 <newusername> --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.

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 le noeud final utilisateur (public ou privé) 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

La section MySQL

La section « » contient des informations correspondant aux applications qui font des connexions à mysql.

informations sur la connexion mysql/URI
Nom de zone Index Description
Type Type de connexion - pour MySQL,, il s'agit de "URI".
Scheme Schéma d'un URI - pour MySQL,, il s'agit de "mysql".
Path Chemin pour un URI- Pour MySQL, 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 Le mot de passe de l'utilisateur - peut être affiché 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 Scheme, Authentication, Host et Path.
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 qu'il peut y avoir une ou plusieurs de ces entrées dans un tableau.

Section CLI

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

informations sur la connexion mysql/cli
Nom de zone Index Description
Bin Le binaire recommandé pour créer une connexion ; dans ce cas, il s'agit de mysql.
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.