Connexion à une instance de base de données exécutant le moteur de base de données MariaDB - 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 à une instance de base de données exécutant le moteur de base de données MariaDB

Une fois qu'Amazon RDS a provisionné votre instance de base de données, vous pouvez utiliser n'importe quelle application cliente MariaDB standard pour vous connecter à l'instance. Dans la chaîne de connexion, vous spécifiez l'adresse DNS (système de noms de domaine) du point de terminaison de l'instance de base de données en tant que paramètre hôte. Vous spécifiez également le numéro de port du point de terminaison de l'instance de base de données en tant que paramètre de port.

Vous pouvez vous connecter à une instance de base de données Amazon RDS pour MariaDB à l'aide d'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 Client de ligne de commande mysql dans la documentation MariaDB. Heidi est une application basée sur l'interface utilisateur graphique que vous pouvez utiliser pour la connexion. Pour en savoir plus, consultez la page Télécharger HeidiSQL. 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.

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

Pour se connecter à une instance de base de données depuis l'extérieur d'un VPC (Virtual Private Cloud) basé sur Amazon VPC, l'instance de base de données doit être accessible publiquement. En outre, 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 satisfaites. Pour plus d'informations, consultez Impossible de se connecter à l'instance de base de données Amazon RDS.

Vous pouvez utiliser le chiffrement SSL sur les connexions à une instance de base de données MariaDB. Pour plus d'informations, consultez Utilisation de SSL/TLS avec une instance de base de données MariaDB.

Recherche des informations de connexion pour une instance de base de données MariaDB

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 MariaDB. 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 describe-db-instancescommandeAWS Management Console, the AWS Command Line Interface (AWS CLI) ou l'opération DescribeDBInstances de l'API Amazon RDS pour répertorier ses détails.

Pour rechercher les informations de connexion d'une instance de base de données dans la AWS Management Console
  1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon RDS à l'adresse https://console.aws.amazon.com/rds/.

  2. Dans le volet de navigation, choisissez Databases (Bases de données) pour afficher la liste de vos instances de base de données.

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

  4. 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
  5. Si vous devez rechercher le nom d'utilisateur principal, choisissez l'onglet Configuration et affichez la valeur Master username (Identifiant principal.

Pour rechercher les informations de connexion d'une instance de base de données MariaDB à l'aide de, appelez AWS CLI la commande. describe-db-instances Dans l'appel, recherchez l'ID d'instance de base de données, le point de terminaison, le port et l'identifiant principal.

Pour LinuxmacOS, ou Unix :

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

Dans Windows :

aws rds describe-db-instances ^ --filters "Name=engine,Values=mariadb" ^ --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" ] ]

Pour rechercher les informations de connexion d'une instance de base de données à l'aide de l'API Amazon RDS, appelez l'opération DescribedBInstances. 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.

Connexion à partir du client de ligne de commande MySQL (non chiffrée)

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 à partir du client de ligne de commande MySQL avec SSL/TLS (chiffrée).

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. Vous êtes alors connecté à une base de données sur une instance de base de données MariaDB. Remplacez <endpoint> par le nom DNS (point de terminaison) de votre instance de base de données et <mymasteruser> par le nom d'utilisateur principal que vous avez utilisé. Indiquez le mot de passe principal que vous avez utilisé lorsque vous êtes invité à entrer un mot de passe.

mysql -h <endpoint> -P 3306 -u <mymasteruser> -p

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

Welcome to the MariaDB monitor. Commands end with ; or \g. Your MariaDB connection id is 31 Server version: 10.6.10-MariaDB-log Source distribution Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. MariaDB [(none)]>

Dépannage des connexions à votre instance de base de données MariaDB

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 MariaDB s'exécute. L'instance de base de données doit avoir un groupe de sécurité VPC qui autorise les connexions. Pour plus d'informations, consultez Amazon VPC et Amazon RDS.

    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 de plus amples informations sur les problèmes de connexion, veuillez consulter Impossible de se connecter à l'instance de base de données Amazon RDS.