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 Db2 CLP
Vous pouvez utiliser un utilitaire de ligne de commande, par exemple IBM Db2 CLP, pour vous connecter aux instances 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.
**Topics**
+ [Terminologie](#db2-connecting-ibm-clp-terms)
+ [Installation du client](#db2-connecting-ibm-clp-install-client)
+ [Connexion à une instance de base de données](#db2-connecting-ibm-clp-connect-db-instance)
+ [Résolution des problèmes de connexion à votre instance de base de données RDS for Db2](#db2-troubleshooting-connections-clp)
## Terminologie
Les termes suivants expliquent les commandes utilisées lors de la [connexion à votre instance de base de données RDS for Db2](#db2-connecting-ibm-clp-connect-db-instance).
**catalog tcpip node**
Cette commande enregistre un nœud de base de données distante auprès d’un client Db2 local, ce qui rend le nœud accessible à l’application cliente. Pour cataloguer un nœud, vous devez fournir des informations telles que le nom d’hôte, le numéro de port et le protocole de communication du serveur. Le nœud catalogué représente ensuite un serveur cible sur lequel résident une ou plusieurs bases de données distantes. Pour plus d’informations, consultez [Commande CATALOG TCPIP/TCPIP4/TCPIP6 NODE](https://www.ibm.com/docs/en/db2/11.5?topic=commands-catalog-tcpip-node) dans la documentation IBM Db2.
**catalog database**
Cette commande enregistre une base de données distante auprès d’un client Db2 local, ce qui rend la base de données accessible à l’application cliente. Pour cataloguer une base de données, vous devez fournir des informations telles que l’alias de la base de données, le nœud sur lequel elle réside et le type d’authentification nécessaire pour se connecter à la base de données. Pour plus d’informations, consultez [Commande CATALOG DATABASE](https://www.ibm.com/docs/en/db2/11.5?topic=commands-catalog-database) dans la documentation IBM Db2.
## Installation du client
Après le [downloading the package for Linux](#db2-downloading-package), installez le client en utilisant les privilèges racines ou administrateur.
**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 -f sysreq`** et choisissez **`yes`** pour accepter la licence.
1. Choisissez l’emplacement où installer le client.
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 Db2 CLP**
1. Connectez-vous avec le nom d’utilisateur que vous avez spécifié lors de l’installation du client IBM Db2 CLP.
1. Cataloguez votre instance de base de données RDS for Db2. Dans l'exemple suivant, remplacez *node\$1name**dns\$1name*, et *port* par le nom du nœud dans le catalogue local, le nom DNS de votre instance de base de données et le numéro de port.
```
1. db2 catalog TCPIP node node_name remote dns_name server port
```
**Exemple**
```
db2 catalog TCPIP node remnode remote database-1.123456789012.us-east-1.amazonaws.com server 50000
```
1. Cataloguez la base de données `rdsadmin` et votre base de données. Cela vous permettra de vous connecter à la base de données `rdsadmin` pour effectuer certaines tâches administratives à l’aide des procédures stockées Amazon RDS. Pour de plus amples informations, veuillez consulter [Administration de votre instance de base de données RDS for Db2](db2-administering-db-instance.md).
Dans l'exemple suivant, remplacez *database\$1alias**node\$1name*, et par *database\$1name* des alias pour cette base de données, le nom du nœud défini à l'étape précédente et le nom de votre base de données. `server_encrypt`chiffre votre nom d'utilisateur et votre mot de passe sur le réseau.
```
db2 catalog database rdsadmin [ as database_alias ] at node node_name authentication server_encrypt
db2 catalog database database_name [ as database_alias ] at node node_name authentication server_encrypt
```
**Exemple**
```
db2 catalog database rdsadmin at node remnode authentication server_encrypt
db2 catalog database testdb as rdsdb2 at node remnode authentication server_encrypt
```
1. Connectez-vous à votre base de données RDS for Db2. Dans l'exemple suivant, remplacez *rds\$1database\$1alias**master\$1username*, et *master\$1password* par le nom de votre base de données, le nom d'utilisateur principal et le mot de passe principal de votre instance de base de données RDS pour DB2.
```
db2 connect to rds_database_alias user master_username using master_password
```
Le résultat produit lors de l’exécution de cette commande est semblable à l’exemple suivant :
```
Database Connection Information
Database server = DB2/LINUXX8664 11.5.9.0
SQL authorization ID = ADMIN
Local database alias = TESTDB
```
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.
```
db2 "select current server from sysibm.dual"
```
Le résultat produit lors de l’exécution de cette commande est semblable à l’exemple suivant :
```
1
------------------
TESTDB
1 record(s) selected.
```
## Résolution des problèmes de connexion à votre instance de base de données RDS for Db2
Si le message d’erreur `NULLID` suivant s’affiche, cela indique généralement que les versions de votre client et du serveur RDS for Db2 ne correspondent pas. Pour les versions du client Db2 prises en charge, consultez [Combinaisons de clients, de pilotes et de niveaux de serveur prises en charge](https://www.ibm.com/docs/en/db2/11.5?topic=communications-supported-combinations-clients-drivers-server-levels) dans la documentation IBM Db2.
```
db2 "select * from syscat.tables"
SQL0805N Package "NULLID.SQLC2O29 0X4141414141454A69" was not found.
SQLSTATE=51002
```
Après avoir reçu cette erreur, vous devez lier les packages de votre ancien client Db2 à une version de serveur Db2 prise en charge par RDS for Db2.
**Liaison des packages d’un ancien client Db2 à un serveur Db2 plus récent**
1. Localisez les fichiers de liaison sur la machine cliente. Généralement, ces fichiers se trouvent dans le répertoire **bnd** du chemin d’installation du client Db2 et portent l’extension **.bnd**.
1. Connectez-vous au serveur Db2. Dans l'exemple suivant, remplacez *database\$1name* par le nom de votre serveur DB2. Remplacez *master\$1username* et *master\$1password* par vos informations. Cet utilisateur dispose d’une autorité `DBADM`.
```
db2 connect to database_name user master_username using master_password
```
1. Exécuter la commande `bind` pour lier les packages.
1. Accédez au répertoire où se trouvent les fichiers de liaison sur l’ordinateur client.
1. Exécutez la commande `bind` pour chaque fichier.
Les options suivantes sont requises :
+ `blocking all` : lie tous les packages du fichier de liaison dans une seule demande de base de données.
+ `grant public` : octroie à `public` l’autorisation d’exécuter le package.
+ `sqlerror continue` : indique que le processus `bind` continue même si des erreurs se produisent.
Pour plus d’informations sur la commande `bind`, consultez [Commande BIND](https://www.ibm.com/docs/en/db2/11.5?topic=commands-bind) dans la documentation IBM Db2.
1. Vérifiez que la liaison a réussi en interrogeant la vue du catalogue `syscat.package` ou en vérifiant le message renvoyé après la commande `bind`.
Pour plus d'informations, consultez la [DB2 version 11.5 de la liste des noms de fichiers et de packages dans](https://www.ibm.com/support/pages/node/6190455) SupportIBM.