

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 MySQL
<a name="USER_ConnectToInstance"></a>

 Avant de vous connecter à une instance de base de données qui exécute le moteur de base de données MySQL, vous devez créer une instance de base de données. Pour plus d'informations, consultez [Création d'une instance de base de données Amazon RDS](USER_CreateDBInstance.md). Après qu'Amazon RDS a provisionné votre instance de base de données, vous pouvez utiliser n'importe quelle application cliente MySQL standard pour vous connecter à l'instance. Dans la chaîne de connexion, vous spécifiez l'adresse DNS du point de terminaison de l'instance de base de données comme paramètre de l'hôte, et le numéro de port du point de terminaison de l'instance de base de données comme paramètre du port. 

Pour vous authentifier sur votre instance de base de données RDS, vous pouvez utiliser l'une des méthodes d'authentification pour MySQL et l'authentification de base de données Gestion des identités et des accès AWS (IAM).
+ Pour en savoir plus sur l'authentification sur MySQL à l'aide de l'une des méthodes d'authentification pour MySQL, consultez [ Méthode d'authentification](https://dev.mysql.com/doc/internals/en/authentication-method.html) dans la documentation MySQL.
+ Pour en savoir plus sur l'authentification sur MySQL à l'aide de l'authentification de base de données IAM, consultez [Authentification de base de données IAMpour MariaDB, MySQL et PostgreSQL](UsingWithRDS.IAMDBAuth.md).

Vous pouvez vous connecter à une instance de base de données MySQL en utilisant des outils tels que le client de ligne de commande MySQL. Pour plus d'informations sur l'utilisation du client de ligne de commande MySQL, consultez [mysql - Le client de ligne de commande MySQL](https://dev.mysql.com/doc/refman/8.0/en/mysql.html) dans la documentation MySQL. MySQL Workbench est une application basée sur l'interface utilisateur graphique que vous pouvez utiliser pour la connexion. Pour plus d'informations, consultez la page [Download MySQL Workbench](http://dev.mysql.com/downloads/workbench/). Pour plus d'informations sur l'installation de MySQL (y compris le client de ligne de commande MySQL), consultez [Installation et mise à niveau de MySQL](https://dev.mysql.com/doc/refman/8.0/en/installing.html). 

Pour se connecter à une instance de base de données hors de son Amazon VPC, l'instance de base de données doit être accessible au public, l'accès doit être accordé en utilisant les règles entrantes du groupe de sécurité de l'instance de base de données et d'autres exigences doivent être respectées. Pour plus d’informations, consultez [Impossible de se connecter à l’instance de base de données Amazon RDS](CHAP_Troubleshooting.md#CHAP_Troubleshooting.Connecting).

Vous pouvez utiliser le chiffrement Secure Sockets Layer (SSL) ou Transport Layer Security (TLS) pour les connexions à une instance de base de données MySQL. Pour plus d’informations, consultez [Prise en charge de SSL/TLS pour les instances de base de données MySQL sur Amazon RDS](MySQL.Concepts.SSLSupport.md). Si vous utilisez l'authentification de base de données Gestion des identités et des accès AWS (IAM), veillez à utiliser une connexion SSL/TLS. Pour plus d’informations, consultez [Authentification de base de données IAMpour MariaDB, MySQL et PostgreSQL](UsingWithRDS.IAMDBAuth.md). 

Vous pouvez également vous connecter à une instance de base de données à partir d'un serveur Web. Pour plus d'informations, consultez [Didacticiel : Créer un serveur web et une instance de base de données Amazon RDS](TUT_WebAppWithRDS.md).

**Note**  
Pour plus d’informations sur la connexion à une instance de base de données MariaDB, consultez [Connexion à votre instance de base de données MariaDB](USER_ConnectToMariaDBInstance.md).

Pour rechercher et vous connecter à une instance de base de données RDS for MySQL, consultez les rubriques suivantes.

**Topics**
+ [Recherche des informations de connexion pour une instance de base de données RDS for MySQL](USER_ConnectToInstance.EndpointAndPort.md)
+ [Installation du client de ligne de commande MySQL](mysql-install-cli.md)
+ [Connexion à partir du client de ligne de commande MySQL (non chiffrée)](USER_ConnectToInstance.CLI.md)
+ [Connexion depuis MySQL Workbench](USER_ConnectToInstance.MySQLWorkbench.md)
+ [Connexion à RDS pour MySQL avec le pilote AWS JDBC, le pilote AWS Python et le pilote AWS ODBC pour MySQL](MySQL.Connecting.Drivers.md)
+ [Dépannage des connexions à votre instance de base de données MySQL](USER_ConnectToInstance.Troubleshooting.md)

# Recherche des informations de connexion pour une instance de base de données RDS for MySQL
<a name="USER_ConnectToInstance.EndpointAndPort"></a>

Les informations de connexion d’une instance de base de données incluent son point de terminaison, son port et un utilisateur de base de données valide, tel que l’utilisateur principal. Par exemple, supposons qu'une valeur de point de terminaison soit `mydb.123456789012.us-east-1.rds.amazonaws.com`. Dans ce cas, la valeur du port est `3306`, et l'utilisateur de base de données est `admin`. Compte tenu de ces informations, vous spécifiez les valeurs suivantes dans une chaîne de connexion :
+ Pour un hôte, un nom d'hôte ou un nom DNS, spécifiez `mydb.123456789012.us-east-1.rds.amazonaws.com`.
+ Pour un port, spécifiez `3306`.
+ Pour l'utilisateur, spécifiez `admin`.

Pour vous connecter à une instance de base de données, utilisez n'importe quel client pour le moteur de base de données MySQL. Par exemple, vous pourriez utiliser le client de ligne de commande MySQL ou MySQL Workbench.

Pour trouver les informations de connexion d'une instance de base de données, vous pouvez utiliser la AWS Management Console AWS CLI [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html)commande ou l'DBInstancesopération Amazon RDS API [Describe](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html) pour répertorier ses détails. 

## Console
<a name="USER_ConnectToInstance.EndpointAndPort.Console"></a>

**Pour trouver les informations de connexion d'une instance de base de données dans AWS Management Console**

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 panneau de navigation, choisissez **Bases de données** pour afficher la liste de vos instances de base de données.

1. Choisissez le nom de l'instance de base de données MySQL pour afficher ses détails.

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.   
![\[Point de terminaison et port d’une instance de base de données dans la console Amazon RDS.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/endpoint-port.png)

1. Si vous devez rechercher le nom d’utilisateur principal, choisissez l’onglet **Configuration** et affichez la valeur **Master username (Identifiant principal**.

## AWS CLI
<a name="USER_ConnectToInstance.EndpointAndPort.CLI"></a>

Pour trouver les informations de connexion d'une instance de base de données MySQL à l'aide de AWS CLI, exécutez la [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html)commande. Dans l’appel, recherchez l’ID d’instance de base de données, le point de terminaison, le port et l’identifiant principal.

Pour Linux, macOS ou Unix :

```
aws rds describe-db-instances \
  --filters "Name=engine,Values=mysql" \
  --query "*[].[DBInstanceIdentifier,Endpoint.Address,Endpoint.Port,MasterUsername]"
```

Pour Windows :

```
aws rds describe-db-instances ^
  --filters "Name=engine,Values=mysql" ^
  --query "*[].[DBInstanceIdentifier,Endpoint.Address,Endpoint.Port,MasterUsername]"
```

Votre sortie doit ressembler à ce qui suit.

```
[
    [
        "mydb1",
        "mydb1.123456789012.us-east-1.rds.amazonaws.com",
        3306,
        "admin"
    ],
    [
        "mydb2",
        "mydb2.123456789012.us-east-1.rds.amazonaws.com",
        3306,
        "admin"
    ]
]
```

## API RDS
<a name="USER_ConnectToInstance.EndpointAndPort.API"></a>

Pour trouver les informations de connexion d'une instance de base de données à l'aide de l'API Amazon RDS, appelez l'DBInstancesopération [Describe](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html). Dans la sortie, recherchez les valeurs de l’adresse du point de terminaison, du port du point de terminaison et du nom d’utilisateur principal. 

# Installation du client de ligne de commande MySQL
<a name="mysql-install-cli"></a>

La plupart des distributions Linux incluent le client MariaDB au lieu du client MySQL Oracle. Pour installer le client de ligne de commande MySQL sur Amazon Linux 2023, exécutez la commande suivante :

```
sudo dnf install mariadb105
```

Pour installer le client de ligne de commande MySQL sur Amazon Linux 2, exécutez la commande suivante :

```
sudo yum install mariadb
```

Pour installer le client de ligne de commande MySQL sur la plupart des distributions Linux basées sur DEB, exécutez la commande suivante :

```
apt-get install mariadb-client
```

Pour vérifier la version de votre client de ligne de commande MySQL, exécutez la commande suivante :

```
mysql --version
```

Pour lire la documentation MySQL pour votre version de client actuelle, exécutez la commande suivante :

```
man mysql
```

# Connexion à partir du client de ligne de commande MySQL (non chiffrée)
<a name="USER_ConnectToInstance.CLI"></a>

**Important**  
N’utilisez une connexion MySQL non chiffrée que quand le client et le serveur sont dans le même VPC et que le réseau est approuvé. Pour plus d’informations sur l’utilisation de connexions chiffrées, consultez [Connexion à votre instance de base de données MySQL sur Amazon RDS SSL/TLS depuis le client de ligne de commande MySQL (crypté)](USER_ConnectToInstanceSSL.CLI.md).

Pour vous connecter à une instance de base de données à l'aide du client de ligne de commande MySQL, entrez la commande suivante à l'invite de commandes d'un ordinateur client. Pour le paramètre -h, remplacez le nom DNS (point de terminaison) de votre instance de base de données. Pour le paramètre -P, remplacez le port pour votre instance de base de données. Pour le paramètre -u, remplacez le nom d'utilisateur d'un utilisateur de base de données valide, par exemple l'utilisateur principal. Entrez le mot de passe de l'utilisateur principal quand vous y êtes invité. 

```
mysql -h mysql–instance1.123456789012.us-east-1.rds.amazonaws.com -P 3306 -u mymasteruser -p
```

Après avoir entré le mot de passe pour l’utilisateur, le résultat suivant devrait normalement s’afficher.

```
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 9738
Server version: 8.0.28 Source distribution

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql>
```

# Connexion depuis MySQL Workbench
<a name="USER_ConnectToInstance.MySQLWorkbench"></a>

**Pour se connecter depuis MySQL Workbench**

1. Téléchargez et installez MySQL Workbench depuis [Télécharger MySQL Workbench](http://dev.mysql.com/downloads/workbench/).

1. Ouvrez MySQL Workbench.  
![\[L’écran de bienvenue dans MySQL Workbench.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/mysql-workbench-main.png)

1. Dans **Base de données**, choisissez **Gérer les connexions**.

1. Dans la fenêtre **Gérer les connexions du serveur**, choisissez **Nouveau**.

1. Dans la fenêtre **Se connecter à la base de données**, entrez les informations suivantes :
   + **Connexion stockée** – Entrez un nom pour la connexion, par exemple **MyDB**.
   + **Nom d'hôte** – Entrez le point de terminaison de l'instance de base de données.
   + **Port** – Entrez le port utilisé par l'instance de base de données.
   + **Nom d'utilisateur** – Entrez le nom d'utilisateur d'un utilisateur de base de données valide, par exemple l'utilisateur principal.
   + **Mot de passe** – Facultatif. Choisissez **Stocker dans le coffre**, puis entrez et enregistrez le mot de passe de l'utilisateur.

   La fenêtre ressemble à ce qui suit :  
![\[La fenêtre Gérer les connexions de serveur dans MySQL Workbench.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/mysql-workbench-connect.png)

   Vous pouvez utiliser les fonctionnalités de MySQL Workbench pour personnaliser les connexions. Par exemple, vous pouvez utiliser l'onglet **SSL** pour configurer les connexions SSL/TLS. Pour plus d’informations sur l’utilisation de MySQL Workbench, consultez le manuel [MySQL Workbench](https://dev.mysql.com/doc/workbench/en/). Pour plus d'informations sur le chiffrement des connexions client aux instances de base de données MySQL avec SSL/TLS, consultez [Chiffrement des connexions client avec les instances SSL/TLS de base de données MySQL sur Amazon RDS](mysql-ssl-connections.md).

1. Facultatif. Vous pouvez choisir **Tester la connexion** pour vous assurer que la connexion à l'instance de base de données est réussie.

1. Choisissez **Fermer**.

1. Dans **Base de données**, choisissez **Se connecter à la base de données**.

1. Dans **Connexion stockée**, choisissez votre connexion.

1. Choisissez **OK**.

# Connexion à RDS pour MySQL avec le pilote AWS JDBC, le pilote AWS Python et le pilote AWS ODBC pour MySQL
<a name="MySQL.Connecting.Drivers"></a>

Connectez-vous aux instances de base de données RDS pour MySQL à l'aide du pilote AWS JDBC, du pilote AWS Python et du AWS pilote ODBC pour MySQL. Pour plus d’informations, consultez les rubriques suivantes.

**Topics**
+ [Connexion à RDS for MySQL avec le pilote JDBC Amazon Web Services (AWS)](#MySQL.Connecting.JDBCDriver)
+ [Connexion à RDS for MySQL avec le pilote Python Amazon Web Services (AWS)](#MySQL.Connecting.PythonDriver)
+ [Connexion à RDS for MySQL avec le pilote ODBC Amazon Web Services (AWS) pour MySQL](#USER_ConnectToInstance.ODBCDriverMySQL)

## Connexion à RDS for MySQL avec le pilote JDBC Amazon Web Services (AWS)
<a name="MySQL.Connecting.JDBCDriver"></a>

Le pilote JDBC Amazon Web Services (AWS) est conçu comme un wrapper JDBC avancé. Ce wrapper complète et étend les fonctionnalités d’un pilote JDBC existant. Le pilote est compatible directement avec le Connector/J pilote MySQL communautaire et le pilote communautaire MariaDB Connector/J .

Pour installer le pilote AWS JDBC, ajoutez le fichier .jar du pilote AWS JDBC (situé dans l'application`CLASSPATH`) et conservez les références au pilote communautaire correspondant. Mettez à jour le préfixe d’URL de connexion correspondant comme suit :
+ `jdbc:mysql://` sur `jdbc:aws-wrapper:mysql://`
+ `jdbc:mariadb://` sur `jdbc:aws-wrapper:mariadb://`

Pour plus d'informations sur le pilote AWS JDBC et des instructions complètes pour son utilisation, consultez le référentiel de pilotes [JDBC Amazon Web Services (AWS)](https://github.com/awslabs/aws-advanced-jdbc-wrapper). GitHub 

## Connexion à RDS for MySQL avec le pilote Python Amazon Web Services (AWS)
<a name="MySQL.Connecting.PythonDriver"></a>

Le pilote Python Amazon Web Services (AWS) est conçu comme un wrapper Python avancé. Ce wrapper complète et étend les fonctionnalités du pilote open source Psycopg. Le pilote AWS Python prend en charge les versions 3.8 et ultérieures de Python. Vous pouvez installer le package `aws-advanced-python-wrapper` à l’aide de la commande `pip`, en même temps que les packages `psycopg` open source.

Pour plus d'informations sur le pilote AWS Python et des instructions complètes pour son utilisation, consultez le [ GitHub référentiel de pilotes Python Amazon Web Services (AWS)](https://github.com/awslabs/aws-advanced-python-wrapper).

## Connexion à RDS for MySQL avec le pilote ODBC Amazon Web Services (AWS) pour MySQL
<a name="USER_ConnectToInstance.ODBCDriverMySQL"></a>

Le pilote AWS ODBC pour MySQL est un pilote client conçu pour la haute disponibilité de RDS pour MySQL. Le pilote peut coexister avec le Connector/ODBC pilote MySQL et est compatible avec les mêmes flux de travail.

Pour plus d'informations sur le pilote AWS ODBC pour MySQL et des instructions complètes pour son installation et son utilisation, consultez le référentiel du [pilote ODBC pour MySQL GitHub d'Amazon Web Services (AWS)](https://github.com/aws/aws-mysql-odbc).

# Dépannage des connexions à votre instance de base de données MySQL
<a name="USER_ConnectToInstance.Troubleshooting"></a>

Les deux causes les plus courantes d'échec de connexion à une nouvelle instance de base de données sont :
+ L'instance de base de données a été créée grâce à un groupe de sécurité qui interdit les connexions depuis l'appareil ou l'instance Amazon EC2 où l'application ou l'utilitaire MySQL s'exécute. L'instance de base de données doit avoir un groupe de sécurité VPC qui autorise les connexions. Pour de plus amples informations, veuillez consulter [Amazon VPC et Amazon RDS](USER_VPC.md).

  Vous pouvez ajouter ou modifier une règle entrante dans le groupe de sécurité. Pour **Source**, choisissez **Mon IP**. Cela autorise à accéder à l'instance de base de données à partir de l'adresse IP détectée dans votre navigateur.
+ L'instance de base de données a été créée à l'aide du port par défaut 3306, et votre entreprise dispose de règles de pare-feu bloquant les connexions à ce port depuis les appareils de votre réseau d'entreprise. Pour corriger le problème, recréez l'instance avec un port différent.

Pour plus d’informations sur les problèmes de connexion, consultez [Impossible de se connecter à l’instance de base de données Amazon RDS](CHAP_Troubleshooting.md#CHAP_Troubleshooting.Connecting).