

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 Db2
<a name="USER_ConnectToDb2DBInstance"></a>

Après qu’Amazon RDS a provisionné votre instance de base de données Amazon RDS pour Db2, vous pouvez utiliser n’importe quelle application cliente SQL standard pour vous connecter à l’instance de base de données. Amazon RDS étant un service géré, vous ne pouvez pas vous connecter en tant que `SYSADM`, `SYSCTRL`, `SECADM` ou `SYSMAINT`.

Vous pouvez vous connecter à une instance de base de données qui exécute le moteur de base de données IBM Db2 en utilisant IBM Db2 CLP, IBM CLPPlus, DBeaver ou IBM Db2 Data Management Console. 

**Note**  
La connexion à une base de données Db2 peut échouer si votre instance de base de données RDS pour Db2 ne dispose pas de suffisamment de mémoire. Pour plus d’informations, consultez [Erreur de connexion de la base de données](db2-troubleshooting.md#db2-database-connection-error).

**Topics**
+ [Recherche du point de terminaison de votre instance de base de données Amazon RDS for Db2](db2-finding-instance-endpoint.md)
+ [Connexion à votre instance de base de données Amazon RDS for Db2 avec IBM Db2 CLP](db2-connecting-with-clp-client.md)
+ [Connexion à votre instance de base de données Amazon RDS for Db2 avec IBM CLPPlus](db2-connecting-with-ibm-clpplus-client.md)
+ [Connexion à votre instance de base de données Amazon RDS for Db2 avec DBeaver](db2-connecting-with-dbeaver.md)
+ [Connexion à votre instance de base de données Amazon RDS for Db2 avec IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md)
+ [Considérations relatives aux groupes de sécurité avec Amazon RDS for Db2](db2-security-groups-considerations.md)

# Recherche du point de terminaison de votre instance de base de données Amazon RDS for Db2
<a name="db2-finding-instance-endpoint"></a>

Chaque instance de base de données Amazon RDS possède un point de terminaison. Chaque point de terminaison possède le nom DNS et le numéro de port de l'instance de base de données. Pour connecter votre instance de base de données Amazon RDS for Db2 à l’aide d’une application cliente SQL, vous avez besoin du nom DNS et du numéro de port de votre instance de base de données.

Vous pouvez trouver le point de terminaison d'une instance de base de données en utilisant le AWS Management Console ou le AWS CLI.

## Console
<a name="db2-finding-instance-endpoint-console"></a>

**Recherche du point de terminaison d’une instance de base de données RDS for Db2**

1. Connectez-vous à la console Amazon RDS AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)l'adresse.

1.  Dans le coin supérieur droit de la console, choisissez celle de votre instance de base Région AWS de données.

1. Trouvez le numéro de port et le nom DNS pour votre instance de base de données RDS for Db2. 

   1. Choisissez **Bases de données** pour afficher une liste de vos instances de bases de données. 

   1. Choisissez le nom de l’instance de base de données RDS for Db2 pour afficher les détails de l’instance. 

   1. Dans l'onglet **Connectivity & security (Connectivité et sécurité)**, copiez le point de terminaison. Notez également le numéro du port. Vous avez besoin du point de terminaison et du numéro de port pour vous connecter à l'instance de base de données.   
![\[L’onglet Connectivité et sécurité d’une instance de base de données qui indique le point de terminaison et le port.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/db2-connectivity-security.png)

## AWS CLI
<a name="db2-finding-instance-endpoint-cli"></a>

Pour trouver le point de terminaison d’une instance de base de données RDS for Db2, exécutez la commande [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html). Dans l'exemple suivant, remplacez *database-1* par le nom de votre instance de base de données.

Pour Linux, macOS ou Unix :

```
aws rds describe-db-instances \
    --db-instance-identifier database-1 \
    --query 'DBInstances[].{DBInstanceIdentifier:DBInstanceIdentifier,DBName:DBName,Endpoint:Endpoint}' \
    --output json
```

Pour Windows :

```
aws rds describe-db-instances ^
    --db-instance-identifier database-1 ^
    --query 'DBInstances[].{DBInstanceIdentifier:DBInstanceIdentifier,DBName:DBName,Endpoint:Endpoint}' ^
    --output json
```

Le résultat produit lors de l’exécution de cette commande est semblable à l’exemple suivant. La ligne `Address` de la sortie contient le nom DNS. 

```
[
    {
        "DBInstanceIdentifier": "database-1",
        "DBName": "DB2DB",
        "Endpoint": {
            "Address": "database-1.123456789012.us-east-2.amazonaws.com",
            "Port": 50000,
            "HostedZoneId": "Z2OC4A7DETW6VH"
        }
    }
]
```

# Connexion à votre instance de base de données Amazon RDS for Db2 avec IBM Db2 CLP
<a name="db2-connecting-with-clp-client"></a><a name="db2-downloading-package"></a>

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
<a name="db2-connecting-ibm-clp-terms"></a>

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
<a name="db2-connecting-ibm-clp-install-client"></a>

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
<a name="db2-connecting-ibm-clp-connect-db-instance"></a>

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
<a name="db2-troubleshooting-connections-clp"></a>

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.

# Connexion à votre instance de base de données Amazon RDS for Db2 avec IBM CLPPlus
<a name="db2-connecting-with-ibm-clpplus-client"></a>

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
<a name="db2-connecting-ibm-clpplus-install-client"></a>

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
<a name="db2-connecting-ibm-clpplus-connect-db-instance"></a>

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
<a name="db2-connecting-ibm-clpplus-retrieve-clob-data"></a>

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
   ```

# Connexion à votre instance de base de données Amazon RDS for Db2 avec DBeaver
<a name="db2-connecting-with-dbeaver"></a>

Vous pouvez utiliser des outils tiers tels que DBeaver pour vous connecter aux instances de base de données Amazon RDS for Db2. Pour télécharger cet utilitaire, consultez [Communauté DBeaver](https://dbeaver.io/). 

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 DBeaver**

1. Démarrer **DBeaver**.

1. Choisissez l’icône **Nouvelle connexion** dans la barre d’outils, puis choisissez **Db2 for LUW**.  
![\[Menu qui répertorie les types de moteurs dans DBeaver.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/dbeaver-add-connection.png)

1. Dans la fenêtre **Connexion à un base de données**, fournissez les informations relatives à votre instance de base de données RDS for Db2.

   1.  Entrez les informations suivantes :
      + Pour **Hôte**, saisissez le nom DNS de l’instance de base de données.
      + Pour **Port**, saisissez le numéro de port de votre instance de base de données.
      + Pour **Base de données**, saisissez le nom de la base de données.
      + Pour **Nom d'utilisateur**, saisissez le nom de l'administrateur de base de données pour l'instance de base de données.
      + Pour **Mot de passe**, saisissez le mot de passe de l’administrateur de base de données pour l’instance de base de données.

   1. Sélectionnez **Enregistrer le mot de passe**.

   1. Choisissez **Paramètres du pilote**.   
![\[Fenêtre Connexion à une base de données contenant différents paramètres de connexion dans DBeaver.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/dbeaver-connect-database.png)

1. Dans la fenêtre **Modifier le pilote**, indiquez des propriétés de sécurité supplémentaires.

   1. Choisissez l’onglet **Propriétés du pilote**.

   1. Ajoutez deux **propriétés de l’utilisateur**.

      1. Ouvrez le menu contextuel (clic droit), puis choisissez **Ajouter une nouvelle propriété**.

      1. Dans **Nom de la propriété**, ajoutez **encryptionAlgorithm**, puis choisissez **OK**.

      1. La ligne **encryptionAlgorithm** étant sélectionnée, choisissez la colonne **Valeur** et ajoutez **2**.

      1. Ouvrez le menu contextuel (clic droit), puis choisissez **Ajouter une nouvelle propriété**.

      1. Pour **Nom de la propriété**, ajoutez **securityMechanism**, puis choisissez **OK**.

      1. La ligne **securityMechanism** étant sélectionnée, choisissez la colonne **Valeur** et ajoutez **7**.

   1. Choisissez **OK**.  
![\[Onglet Propriétés du pilote dans la fenêtre Modifier le pilote dans DBeaver.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/dbeaver-driver-properties-tab.png)

1. Dans la fenêtre **Connexion à une base de données**, sélectionnez **Tester la connexion**. Si aucun pilote DB2 JBDC n'est installé sur votre ordinateur, le pilote est automatiquement téléchargé.

1. Choisissez **OK**.

1. Choisissez **Finish** (Terminer).

1. Dans l’onglet **Navigation dans la base de données**, choisissez le nom de la base de données. Vous pouvez désormais explorer des objets.

Vous êtes maintenant prêt à exécuter des commandes SQL.

**Exécution des commandes SQL et affichage des résultats**

1. Dans le menu supérieur, choisissez **SQL**. Un panneau de script SQL s’ouvre.

1. Dans le panneau **Script**, entrez une commande SQL.

1. Pour exécuter la commande, cliquez sur le bouton **Exécuter la requête SQL**.

1. Dans le panneau de résultats SQL, consultez les résultats de vos requêtes SQL.  
![\[Fenêtre montrant comment exécuter une commande SQL et afficher les résultats dans DBeaver.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/dbeaver-sql-run-example.png)

# Connexion à votre instance de base de données Amazon RDS for Db2 avec IBM Db2 Data Management Console
<a name="db2-connecting-with-ibm-data-management-console"></a>

Vous pouvez vous connecter à votre instance de base de données Amazon RDS for Db2 avec IBM Db2 Data Management Console. IBM Db2 Data Management Console peut administrer et surveiller plusieurs instances de base de données RDS for Db2. 

**Note**  
Vous devez disposer d’une machine Amazon EC2 Linux ou Windows qui se trouve sur le même VPC et le même groupe de sécurité que votre instance de base de données RDS for Db2. Le VPC et le groupe de sécurité contrôlent la connexion à votre instance de base de données via le réseau interne. 

IBM Db2 Data Management Console nécessite une base de données de référentiel Db2 pour stocker les métadonnées et les mesures de performance, mais ne peut pas créer automatiquement une base de données de référentiel pour RDS for Db2. Au lieu de cela, vous devez d’abord créer une base de données de référentiel pour surveiller une ou plusieurs instances de base de données RDS for Db2. Vous pouvez ensuite installer IBM Db2 Data Management Console et vous connecter à votre instance de base de données RDS for Db2 avec IBM Db2 Data Management Console.

**Topics**
+ [Étape 1 : création d’une base de données de référentiel pour surveiller les instances de base de données](#db2-creating-repo-db-monitoring-dmc)
+ [Étape 2 : installation et configuration d’IBM Db2 Data Management Console](#db2-install-setup-dmc)
+ [Étape 3 : configuration de la base de données du référentiel et connexion aux instances de base de données RDS for Db2](#db2-connecting-db-instances-with-dmc)
+ [Utilisation de IBM Db2 Data Management Console](#db2-using-dmc)

## Étape 1 : création d’une base de données de référentiel pour surveiller les instances de base de données
<a name="db2-creating-repo-db-monitoring-dmc"></a>

Vous pouvez utiliser une instance de base de données RDS for Db2 existante correctement dimensionnée comme référentiel pour IBM Db2 Data Management Console afin surveiller d’autres instances de base de données RDS for Db2. Cependant, comme l’utilisateur administrateur n’a pas l’autorité `SYSCTRL` pour créer des groupes de mémoires tampons et des tablespaces, l’utilisation de la création de référentiel IBM Db2 Data Management Console pour créer une base de données de référentiel échoue. Au lieu de cela, vous devez créer une base de données de référentiel. Cette base de données de référentiel surveille vos instances de base de données RDS for Db2. 

Vous pouvez créer une base de données de référentiel de deux manières différentes. Vous pouvez créer une base de données RDS for Db2, puis créer manuellement un groupe de mémoires tampons, un tablespace utilisateur et un tablespace temporaire du système. Vous pouvez également créer une instance Amazon EC2 distincte pour héberger une base de données de référentiel IBM Db2 Data Management Console.

**Topics**
+ [Création manuelle d’un groupe de mémoires tampons, d’un tablespace utilisateur et d’un tablespace temporaire du système](#db2-manually-creating-dmc)
+ [Création d’une instance Amazon EC2 pour héberger un référentiel IBM Db2 Data Management Console](#db2-creating-ec2-dmc)

### Création manuelle d’un groupe de mémoires tampons, d’un tablespace utilisateur et d’un tablespace temporaire du système
<a name="db2-manually-creating-dmc"></a>

**Création d’un groupe de mémoires tampons, d’un tablespace utilisateur et d’un tablespace temporaire du système**

1. Connectez-vous à la base de données `rdsadmin`. Dans l'exemple suivant, remplacez *master\$1username* et *master\$1password* par vos propres informations.

   ```
   db2 connect to rdsadmin user master_username using master_password  
   ```

1. Créez un groupe de mémoires tampons pour IBM Db2 Data Management Console. Dans l'exemple suivant, remplacez *database\$1name* par le nom du référentiel que vous avez créé pour surveiller votre RDS IBM Db2 Data Management Console pour les instances de base de données DB2. 

   ```
   db2 "call rdsadmin.create_bufferpool('database_name', 
        'BP4CONSOLE', 1000, 'Y', 'Y', 32768)"
   ```

1. Créez un tablespace utilisateur pour IBM Db2 Data Management Console. Dans l'exemple suivant, remplacez *database\$1name* par le nom du référentiel que vous avez créé pour surveiller votre RDS IBM Db2 Data Management Console pour les instances de base de données DB2. 

   ```
   db2 "call rdsadmin.create_tablespace('database_name', 
        'TS4CONSOLE', 'BP4CONSOLE', 32768)"
   ```

1. Créez un tablespace temporaire du système pour IBM Db2 Data Management Console. Dans l'exemple suivant, remplacez *database\$1name* par le nom du référentiel que vous avez créé pour surveiller votre RDS IBM Db2 Data Management Console pour les instances de base de données DB2. 

   ```
   db2 "call rdsadmin.create_tablespace('database_name',
       'TS4CONSOLE_TEMP', 'BP4CONSOLE', 32768, 0, 0, 'S')"
   ```

Vous êtes maintenant prêt à installer IBM Db2 Data Management Console. Pour plus d’informations sur l’installation et la configuration, consultez [Étape 2 : installation et configuration d’IBM Db2 Data Management Console](#db2-install-setup-dmc).

### Création d’une instance Amazon EC2 pour héberger un référentiel IBM Db2 Data Management Console
<a name="db2-creating-ec2-dmc"></a>

Vous pouvez créer une instance Amazon Elastic Compute Cloud (Amazon EC2) distincte pour héberger un référentiel IBM Db2 Data Management Console. Pour plus d’informations sur la création d’une instance Amazon EC2, consultez [Didacticiel : démarrez avec les instances Amazon EC2 Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html) dans le *Guide de l’utilisateur Amazon EC2*.

## Étape 2 : installation et configuration d’IBM Db2 Data Management Console
<a name="db2-install-setup-dmc"></a>

Après avoir créé un groupe de mémoires tampons, un tablespace utilisateur et un tablespace temporaire du système, vous êtes prêt à procéder à l’installation et à la configuration d’IBM Db2 Data Management Console. 

**Important**  
Vous devez disposer d’une machine Amazon EC2 Linux ou Windows qui se trouve sur le même VPC et le même groupe de sécurité que votre instance de base de données RDS for Db2. Le VPC et le groupe de sécurité contrôlent la connexion à votre instance de base de données via le réseau interne. En outre, vous devez avoir [créé une base de données de référentiel](#db2-creating-repo-db-monitoring-dmc) pour IBM Db2 Data Management Console.

**Installation et configuration d’IBM Db2 Data Management Console.**

1. Téléchargez IBM Db2 Data Management Console à partir des [versions d’IBM Db2 Data Management Console 3.1x](https://www.ibm.com/support/pages/ibm-db2-data-management-console-version-31x-releases-new-features-and-enhancements) sur le site Web du support IBM.

1. Installer IBM Db2 Data Management Console.

1. Ouvrez IBM Db2 Data Management Console et utilisez l’adresse IP de votre machine Amazon EC2 et le numéro de port que vous avez utilisé pour la connexion HTTP ou HTTPS à votre instance Amazon EC2. Par exemples, utilisez `http://xx.xx.xx.xx:11080` ou `https://xx.xx.xx.xx.11081`. Remplacez `xx.xx.xx.xx` par l’adresse IP de votre machine Amazon EC2. `11080` et `11081` sont les ports par défaut pour les connexions HTTP et HTTPS.

1. (Facultatif) Si vous souhaitez utiliser le port 80 ou 443 sur votre instance Amazon EC2, vous pouvez utiliser Apache httpd ou un serveur HTTP Nginx pour rediriger le port IBM Db2 Data Management Console vers le port 80 ou 443. Pour plus d’informations, consultez [Projet de serveur HTTP Apache](https://httpd.apache.org) et [le site Web nginx](https://nginx.org/en/).

   Pour autoriser la connexion à IBM Db2 Data Management Console, vous devez modifier les règles de trafic entrant dans votre groupe de sécurité. Si vous utilisez un proxy, modifiez le TCP/IP port 80 ou 443 pour rediriger vers les IBM Db2 Data Management Console ports. Si vous n'utilisez pas de proxy, remplacez le TCP/IP port 80 ou 443 par les ports par défaut 11080 (HTTP) ou 11081 (HTTPS).

Vous êtes maintenant prêt à vous connecter à IBM Db2 Data Management Console pour configurer la base de données du référentiel et pour vous connecter à vos instances de base de données RDS for Db2. Pour plus d’informations, consultez [Configuration de la base de données du référentiel et connexion aux instances de base de données](#db2-connecting-db-instances-with-dmc).

## Étape 3 : configuration de la base de données du référentiel et connexion aux instances de base de données RDS for Db2
<a name="db2-connecting-db-instances-with-dmc"></a>

Lorsque vous vous connectez à la base de données du référentiel pour la première fois, IBM Db2 Data Management Console configure automatiquement le référentiel. Une fois la base de données du référentiel configurée, vous pouvez ajouter des connexions de base de données à IBM Db2 Data Management Console. 

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). Si vous vous connectez via Internet, autorisez le trafic vers le port de base de données. Pour plus d’informations, consultez [Création d’une instance de base de données](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).

**Se connecter à des instances de base de données RDS for Db2 avec IBM Db2 Data Management Console**

1. Connectez-vous à IBM Db2 Data Management Console à l’aide des informations d’identification que vous avez définies lors de l’installation.

1. Configurez le référentiel. 

   1. Dans la section **Connexion et base de données**, entrez les informations suivantes pour votre instance de base de données RDS for Db2 : 
      + Pour **Hôte**, saisissez le nom DNS de l’instance de base de données.
      + Pour **Port**, saisissez le numéro de port de votre instance de base de données.
      + Pour **Base de données**, saisissez le nom de la base de données.  
![\[La section Connexion et base de données d’IBM Db2 Data Management Console avec les champs Hôte, Port et Base de données.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/ibm-dmc-connection-database.png)

   1. Dans la section **Sécurité et informations d’identification**, entrez les informations suivantes pour votre instance de base de données RDS for Db2 :
      + Pour **Type de sécurité**, choisissez **Utilisateur et mot de passe chiffrés**.
      + Pour **Nom d'utilisateur**, saisissez le nom de l'administrateur de base de données pour l'instance de base de données.
      + Pour **Mot de passe**, saisissez le mot de passe de l’administrateur de base de données pour l’instance de base de données.

   1. Choisissez **Test connection** (Tester la connexion).
**Note**  
Si la connexion échoue, vérifiez que le port de base de données est ouvert conformément aux règles entrantes de votre groupe de sécurité. Pour plus d’informations, consultez [Considérations relatives aux groupes de sécurité avec Amazon RDS for Db2](db2-security-groups-considerations.md).

      Si vous n’avez pas [créé manuellement un groupe de mémoires tampons, un tablespace utilisateur et un tablespace temporaire système](#db2-manually-creating-dmc) dans RDS for Db2, le message d’erreur suivant peut s’afficher :   
![\[Message d’erreur indiquant que vous n’êtes pas autorisé à effectuer des opérations.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/ibm-dmc-error-message.png)

      Assurez-vous d’avoir créé une table de mémoires tampons, un tablespace et des objets pour un référentiel IBM Db2 Data Management Console afin de surveiller votre instance de base de données RDS for Db2. Vous pouvez également utiliser une instance de base de données Amazon EC2 Db2 pour héberger un référentiel IBM Db2 Data Management Console afin de surveiller votre instance de base de données RDS for Db2. Pour plus d’informations, consultez [Étape 1 : création d’une base de données de référentiel pour surveiller les instances de base de données](#db2-creating-repo-db-monitoring-dmc).

   1. Après avoir testé votre connexion avec succès, choisissez **Suivant**.  
![\[La section Sécurité et informations d’identification d’IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/ibm-dmc-security-credential.png)

   Si IBM Db2 Data Management Console trouve le groupe de mémoires tampons, le tablespace utilisateur et le tablespace temporaire du système dans l’instance de base de données RDS for Db2, IBM Db2 Data Management Console configure alors automatiquement la base de données du référentiel. Si vous utilisez votre instance Db2 sur votre instance Amazon EC2 comme base de données de référentiel, IBM Db2 Data Management Console crée alors automatiquement le groupe de mémoires tampons et d’autres objets.

1. Dans la fenêtre **Définir l’activation du moniteur d’événements statistiques**, cliquez sur **Suivant**. 

1. (Facultatif) Ajoutez une nouvelle connexion. Si vous souhaitez utiliser une autre instance de base de données RDS for Db2 à des fins d’administration et de surveillance, ajoutez une connexion à une instance de base de données RDS for Db2 hors référentiel.

   1. Dans la section **Connexion et base de données**, entrez les informations suivantes pour l’instance de base de données RDS for Db2 à utiliser pour l’administration et la surveillance :
      + Dans **Nom de la connexion**, saisissez l’identifiant de base de données Db2. 
      + Pour **Hôte**, saisissez le nom DNS de l’instance de base de données.
      + Pour **Port**, saisissez le numéro de port de votre instance de base de données.
      + Pour **Base de données**, saisissez le nom de la base de données.  
![\[Section Connexion et base de données pour une nouvelle connexion dans IBM Db2 Data Management Console avec les champs Hôte, Port et Base de données.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/ibm-dmc-new-connection-database.png)

   1. Dans la section **Sécurité et informations d’identification****,** sélectionnez **Activer la collecte des données de surveillance**.

   1. Entrez les informations suivantes pour votre instance de base de données RDS for Db2 : 
      + Pour **Nom d'utilisateur**, saisissez le nom de l'administrateur de base de données pour l'instance de base de données.
      + Pour **Mot de passe**, saisissez le mot de passe de l’administrateur de base de données pour l’instance de base de données.

   1. Choisissez **Test connection** (Tester la connexion).

   1. Après avoir testé votre connexion avec succès, choisissez **Enregistrer**.  
![\[Section Sécurité et informations d’identification pour une nouvelle connexion dans IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/ibm-dmc-new-security-credential.png)

   Une fois la connexion ajoutée, une fenêtre similaire à la suivante s’affiche. Cette fenêtre indique que votre base de données a été correctement configurée.  
![\[Fenêtre indiquant que votre base de données a été correctement configurée dans IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/ibm-dmc-configuration-success.png)

1. Choisissez **Accéder aux bases de données**. Une fenêtre de base de données similaire à la suivante s’affiche. Cette fenêtre est un tableau de bord qui affiche les métriques, les statuts et les connexions.  
![\[Fenêtre d’aperçu des bases de données dans IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/ibm-dmc-database-view.png)

Vous pouvez maintenant commencer à utiliser IBM Db2 Data Management Console.

## Utilisation de IBM Db2 Data Management Console
<a name="db2-using-dmc"></a>

Vous pouvez utiliser IBM Db2 Data Management Console pour effectuer les types de tâches suivants :
+ Gérer plusieurs instances de base de données RDS for Db2.
+ Exécutez des commandes SQL.
+ Explorer, créer ou modifier des données et des objets de base de données.
+ Créer des instructions `EXPLAIN PLAN` dans SQL.
+ Régler les requêtes.

**Exécution des commandes SQL et affichage des résultats**

1. Dans la barre de navigation de gauche, choisissez **SQL**.

1. Entrez une commande SQL.

1. Choisissez **Tout exécuter**.

1. Pour afficher les résultats, choisissez l’onglet **Résultats**.

![\[Fenêtre Base de données montrant comment exécuter une commande SQL et afficher les résultats dans IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/ibm-dmc-sql-run-example.png)


# Considérations relatives aux groupes de sécurité avec Amazon RDS for Db2
<a name="db2-security-groups-considerations"></a>

Pour vous connecter à votre instance de base de données Amazon RDS for Db2, celle-ci doit être associée à un groupe de sécurité contenant les adresses IP et la configuration réseau nécessaires. Votre instance de base de données RDS for Db2 peut utiliser le groupe de sécurité par défaut. Si vous assignez un groupe de sécurité non configuré par défaut lors de la création de l’instance de base de données RDS for Db2, le pare-feu empêche les connexions. Pour obtenir des informations sur la création d'un groupe de sécurité, consultez [Contrôle d’accès par groupe de sécurité](Overview.RDSSecurityGroups.md).

Une fois le groupe de sécurité créé, vous devez modifier votre instance de base de données pour l'associer au groupe de sécurité. Pour plus d'informations, consultez [Modification d'une instance de base de données Amazon RDS](Overview.DBInstance.Modifying.md). 

Vous pouvez améliorer la sécurité en utilisant SSL pour chiffrer les connexions à votre instance de base de données. Pour de plus amples informations, veuillez consulter [Utilisation SSL/TLS avec une instance de base de données Amazon RDS pour DB2](Db2.Concepts.SSL.md).