Connexion à votre instance de base de données Amazon RDS for Db2 avec IBM Db2 CLP - Amazon Relational Database Service

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 dans Support IBM.

Terminologie

Les termes suivants expliquent les commandes utilisées lors de la connexion à votre instance de base de données RDS for Db2.

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 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 dans la documentation IBM Db2.

Installation du client

Après le downloading the package for Linux, 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.

  2. Choisissez l’emplacement où installer le client.

  3. Exécutez clientInstallDir/instance/db2icrt -s client instance_name. Remplacez instance_name par un utilisateur de système d’exploitation valide sur 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. 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.

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.

  2. Cataloguez votre instance de base de données RDS for Db2. Dans l’exemple suivant, remplacez node_name, dns_name 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.

    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
  3. 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 plus d’informations, consultez Administration de votre instance de base de données RDS for Db2.

    Dans l’exemple suivant, remplacez database_alias, node_name et database_name par 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_encryptchiffre 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
  4. Connectez-vous à votre base de données RDS for Db2. Dans l’exemple suivant, remplacez node_name, master_username et master_password 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 for 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
  5. 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 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.

  2. Connectez-vous au serveur Db2. Dans l’exemple suivant, remplacez database_name par le nom de votre serveur Db2. Remplacez master_username et master_password par vos informations. Cet utilisateur dispose d’une autorité DBADM.

    db2 connect to database_name user master_username using master_password
  3. 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.

    2. 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 dans la documentation IBM Db2.

  4. 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 Liste des noms de fichiers et de packages DB2 v11.5 dans Support IBM.