Connexion à votre instance de base de données RDS pour 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 RDS pour DB2 avec IBM Db2 CLP

Vous pouvez utiliser un utilitaire de ligne de commande tel que IBM Db2 CLP pour vous connecter à Amazon RDS pour les instances de base de données DB2. Cet utilitaire fait partie deIBM Data Server Runtime Client. Pour télécharger le client depuisIBM Fix Central, voir IBMData Server Client Packages version 11.5 Mod 8 Fix Pack 0 dans IBM Support.

Terminologie

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

nœud TCP/IP du catalogue

Cette commande enregistre un nœud de base de données distant 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 CATALOG TCPIP/TCPIP4/TCPIP6 NODEla section commande dans la IBM Db2 documentation.

base de données de catalogues

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 CATALOG DATABASEla section commande dans la IBM Db2 documentation.

Installation du client

Ensuitedownloading the package for Linux, installez le client en utilisant les privilèges root ou administrateur.

Note

Pour installer le client sur AIX ouWindows, suivez la même procédure mais modifiez les commandes de votre système d'exploitation.

Pour installer le client sur Linux
  1. Exécutez ./db2_install -f sysreqet choisissez yesd'accepter la licence.

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

  3. Exécutez clientInstallDir/instance/db2icrt -s clientinstance_name. Remplacez instance_name par un utilisateur de système d'exploitation valide activé. Linux DansLinux, 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 sqllibrépertoire dans le répertoire personnel de l'utilisateur désigné leLinux.

Connexion à une instance de base de données

Pour vous connecter à votre instance de base de données RDS pour DB2, vous avez besoin de son nom DNS et de son numéro de port. Pour plus d'informations sur leur recherche, consultezRecherche du point de terminaison. Vous devez également connaître le nom de 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 pour DB2. Pour plus d'informations sur leur recherche, consultezCréation d'une instance de base de données.

Pour vous connecter à une instance de base de données RDS pour DB2 avec IBM Db2 CLP
  1. Connectez-vous avec le nom d'utilisateur que vous avez spécifié lors de l'installation du IBM Db2 CLP client.

  2. Cataloguez votre instance de base de données RDS pour 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 rdsadmin base de données et votre base de données. Cela vous permettra de vous connecter à la rdsadmin base de données 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 pour 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 pour DB2. Dans l'exemple suivant, remplacez rds_database_alias, 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 pour DB2.

    db2 connect to rds_database_alias user master_username using master_password

    Cette commande produit une sortie similaire à 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 visualisez 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"

    Cette commande produit une sortie similaire à l'exemple suivant :

    1 ------------------ TESTDB 1 record(s) selected.

Résolution des problèmes de connexion à votre instance de base de données RDS pour DB2

Si le message NULLID d'erreur suivant s'affiche, cela indique généralement que les versions de votre client et de RDS pour le serveur DB2 ne correspondent pas. Pour les versions du client DB2 prises en charge, consultez la section Combinaisons prises en charge de clients, de pilotes et de niveaux de serveur dans la IBM Db2 documentation.

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 pour DB2.

Pour lier des packages d'un ancien client DB2 à un serveur DB2 plus récent
  1. Localisez les fichiers de liaison sur l'ordinateur client. Ces fichiers se trouvent généralement 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 a DBADM autorité.

    db2 connect to database_name user master_username using master_password
  3. Exécutez la bind commande 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 bind commande 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— Autorise public l'exécution du package.

      • sqlerror continue— Spécifie que le bind processus continue même en cas d'erreur.

      Pour plus d'informations sur la bind commande, voir BINDcommande dans la IBM Db2 documentation.

  4. Vérifiez que la liaison a réussi en interrogeant la vue du syscat.package catalogue ou en vérifiant le message renvoyé après la bind commande.

Pour plus d'informations, consultez la liste des noms de fichiers et de packages de DB2 v11.5 dans Support. IBM