Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Connexion à votre instance de base de données Amazon RDS for Db2 avec IBM CLPPlus
Vous pouvez utiliser un utilitaire, par exemple IBM CLPPlus, pour vous connecter à une instance de base de données Amazon RDS for Db2. Cet utilitaire fait partie de IBM Data Server Runtime Client. Pour télécharger le client** **depuis IBM Fix Central, consultez [Packages client serveur de données IBM version 11.5 Mod 8 Fix Pack 0](https://www.ibm.com/support/pages/node/6830885) dans Support IBM.
**Important**
Nous vous recommandons d’exécuter IBM CLPPlus sur un système d’exploitation prenant en charge les interfaces utilisateur graphiques telles que macOS, Windows ou Linux avec Desktop. Si vous exécutez Linux sans périphériques, utilisez le commutateur **-nw** avec les commandes CLPPlus.
**Topics**
+ [Installation du client](#db2-connecting-ibm-clpplus-install-client)
+ [Connexion à une instance de base de données](#db2-connecting-ibm-clpplus-connect-db-instance)
+ [Récupération de données CLOB à partir de procédures stockées DB2](#db2-connecting-ibm-clpplus-retrieve-clob-data)
## Installation du client
Après avoir téléchargé le package pour Linux, installez le client.
**Note**
Pour installer le client sur AIX ou Windows, suivez la même procédure, mais modifiez les commandes de votre système d’exploitation.
**Installation du client sur Linux**
1. Exécutez **`./db2_install`**.
1. Courez **`clientInstallDir/instance/db2icrt -s client`*instance\$1name***. Remplacez *instance\$1name* par un utilisateur de système d'exploitation valide activéLinux. Sous Linux, le nom de l’instance de base de données Db2 est lié au nom d’utilisateur du système d’exploitation.
Cette commande crée un répertoire **`sqllib`** dans le répertoire de base de l’utilisateur désigné sur Linux.
## Connexion à une instance de base de données
Pour vous connecter à votre instance de base de données RDS for Db2, vous avez besoin de son nom DNS et de son numéro de port. Pour savoir comment les trouver, consultez [Recherche du point de terminaison](db2-finding-instance-endpoint.md). Vous devez également connaître le nom de la base de données, le nom d’utilisateur principal et le mot de passe principal que vous avez définis lors de la création de votre instance de base de données RDS for Db2. Pour savoir comment les trouver, consultez [Création d’une instance de base de données](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).
**Se connecter à une instance de base de données RDS for Db2 avec IBM CLPPlus**
1. Vérifiez la syntaxe de la commande. Dans l'exemple suivant, remplacez *clientDir* par l'emplacement où le client est installé.
```
cd clientDir/bin
./clpplus -h
```
1. Configurez votre serveur Db2. Dans l'exemple suivant, remplacez*dsn\$1name*,, et *port* par le nom DSN *database\$1name**endpoint*, le nom de la base de données, le point de terminaison et le port de votre instance de base de données RDS pour DB2. Pour de plus amples informations, veuillez consulter [Recherche du point de terminaison de votre instance de base de données Amazon RDS for Db2](db2-finding-instance-endpoint.md).
```
db2cli writecfg add -dsn dsn_name -database database_name -host endpoint -port port -parameter "Authentication=SERVER_ENCRYPT"
```
1. Connectez-vous à une instance de base de données RDS for Db2. Dans l'exemple suivant, remplacez *master\$1username* et *dsn\$1name* par le nom d'utilisateur principal et le nom DSN.
```
./clpplus -nw master_username@dsn_name
```
1. Une fenêtre Java Shell s’ouvre. Entrez le mot de passe principal pour votre instance de base de données RDS for Db2.
**Note**
Si aucune fenêtre Java Shell ne s’ouvre pas, exécuté `./clpplus -nw` pour utiliser la même fenêtre de ligne de commande.
```
Enter password: *********
```
Une connexion est établie et produit une sortie similaire à ce qui suit :
```
Database Connection Information :
---------------------------------
Hostname = database-1.abcdefghij.us-east-1.rds.amazonaws.com
Database server = DB2/LINUXX8664 SQL110590
SQL authorization ID = admin
Local database alias = DB2DB
Port = 50000
```
1. Exécutez des requêtes et visionnez les résultats. L’exemple suivant montre une instruction SQL qui sélectionne la base de données que vous avez créée.
```
SQL > select current server from sysibm.dual;
```
Le résultat produit lors de l’exécution de cette commande est semblable à l’exemple suivant :
```
1
--------------------
DB2DB
SQL>
```
## Récupération de données CLOB à partir de procédures stockées DB2
Les procédures stockées telles que rdsadmin.db2pd\$1command renvoient les résultats sous forme de colonnes CLOB, qui prennent en charge jusqu'à 2 Go de données. Cependant, le DB2 CLP limite la sortie CLOB à 8 Ko (8192 octets), tronquant ainsi toutes les données au-delà de ce seuil. Pour récupérer la sortie complète, utilisez plutôt CLPPLUS.
1. Obtenir l'ID de tâche (task\$1id)
```
db2 "select task_id, task_type, database_name, lifecycle, varchar(bson_to_json(task_input_params), 500) as task_params,
cast(task_output as varchar(500)) as task_output, CREATED_AT, LAST_UPDATED_AT from table(rdsadmin.get_task_status(null,null,null))"
```
1. Exécuter la commande CLPPLUS
Après avoir obtenu le task\$1id, exécutez la commande suivante à partir de l'invite Unix (remplacez TASK\$1ID par l'identifiant numérique réel de la tâche) :
```
$ (echo "select task_output from table(rdsadmin.get_task_status(task_id,null,null));" ; echo "disconnect;" ; echo "exit;") | clpplus -nw -silent masteruser/MasterUserPassword@hostname:port_num/rdsadmin
```