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
Rubriques
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
-
Exécutez
./db2_install -f sysreqet choisissezyespour accepter la licence. -
Choisissez l’emplacement où installer le client.
-
Exécutez
clientInstallDir/instance/db2icrt -s clientinstance_name. Remplacezinstance_namepar 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
sqllibdans 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
-
Connectez-vous avec le nom d’utilisateur que vous avez spécifié lors de l’installation du client IBM Db2 CLP.
-
Cataloguez votre instance de base de données RDS for Db2. Dans l’exemple suivant, remplacez
node_name,dns_nameetportpar 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 nodenode_nameremotedns_nameserverportExemple
db2 catalog TCPIP node remnode remote database-1.123456789012.us-east-1.amazonaws.com server 50000 -
Cataloguez la base de données
rdsadminet votre base de données. Cela vous permettra de vous connecter à la base de donnéesrdsadminpour 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_nameetdatabase_namepar 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 [ asdatabase_alias] at nodenode_nameauthentication server_encrypt db2 catalog databasedatabase_name[ asdatabase_alias] at nodenode_nameauthentication server_encryptExemple
db2 catalog database rdsadmin at node remnode authentication server_encrypt db2 catalog database testdb as rdsdb2 at node remnode authentication server_encrypt -
Connectez-vous à votre base de données RDS for Db2. Dans l’exemple suivant, remplacez
node_name,master_usernameetmaster_passwordpar 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 tords_database_aliasusermaster_usernameusingmaster_passwordLe 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 -
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
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
-
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.
-
Connectez-vous au serveur Db2. Dans l’exemple suivant, remplacez
database_namepar le nom de votre serveur Db2. Remplacezmaster_usernameetmaster_passwordpar vos informations. Cet utilisateur dispose d’une autoritéDBADM.db2 connect todatabase_nameusermaster_usernameusingmaster_password -
Exécuter la commande
bindpour lier les packages.-
Accédez au répertoire où se trouvent les fichiers de liaison sur l’ordinateur client.
-
Exécutez la commande
bindpour 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 àpublicl’autorisation d’exécuter le package. -
sqlerror continue: indique que le processusbindcontinue même si des erreurs se produisent.
Pour plus d’informations sur la commande
bind, consultez Commande BINDdans la documentation IBM Db2. -
-
-
Vérifiez que la liaison a réussi en interrogeant la vue du catalogue
syscat.packageou en vérifiant le message renvoyé après la commandebind.
Pour plus d’informations, consultez Liste des noms de fichiers et de packages DB2 v11.5