Connexion à un cluster de bases de données Amazon Aurora - Amazon Aurora

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 à un cluster de bases de données Amazon Aurora

Vous pouvez vous connecter à un cluster de base de données Aurora à l'aide des mêmes outils que ceux que vous utilisez pour vous connecter à une SQL base de données My SQL ou Postgre. Vous spécifiez une chaîne de connexion avec n'importe quel script, utilitaire ou application qui se connecte à une SQL instance de base de données My SQL ou Postgre. Vous utilisez la même clé publique pour les connexions Secure Sockets Layer (SSL).

Dans la chaîne de connexion, vous utilisez généralement les informations sur le port et l'hôte depuis des points de terminaison spéciaux associés au cluster de base de données. Avec ces points de terminaison, vous pouvez utiliser les mêmes paramètres de connexion, peu importe le nombre d'instances de base de données dans le cluster. Pour les tâches spécialisées telles que le dépannage, vous pouvez utiliser les informations sur l'hôte et le port depuis une instance de base de données spécifique dans votre cluster de bases de données Aurora.

Note

Pour les clusters de bases de données Aurora Serverless, vous vous connectez au point de terminaison de base de données plutôt qu'à l'instance de base de données. Vous pouvez trouver le point de terminaison de base de données pour un cluster Aurora Serverless dans l'onglet Connectivité et sécurité de la AWS Management Console. Pour de plus amples informations, veuillez consulter Utilisation d'Amazon Aurora Serverless v1.

Quel que soit le moteur de base de données Aurora et les outils spécifiques que vous utilisez pour travailler avec le cluster ou l'instance, le point de terminaison doit être accessible. Un cluster de base de données Aurora ne peut être créé que dans un cloud privé virtuel (VPC) basé sur le VPC service Amazon. Cela signifie que vous accédez au point de terminaison de l'intérieur VPC ou de l'extérieur VPC en utilisant l'une des approches suivantes.

  • Accédez au cluster de base de données Aurora à l'intérieur du VPC — Activez l'accès au cluster de base de données Aurora via leVPC. Pour ce faire, modifiez les règles de trafic entrant sur le groupe de sécurité afin d'autoriser l'accès VPC à votre cluster de base de données Aurora spécifique. Pour en savoir plus, notamment comment configurer votre cluster VPC pour différents scénarios de cluster de base de données Aurora, consultez Amazon Virtual Private Cloud VPCs et Amazon Aurora.

  • Accédez au cluster de base de données Aurora en dehors de VPC — Pour accéder à un cluster de base de données Aurora depuis l'extérieur deVPC, utilisez l'adresse de point de terminaison publique du cluster de bases de données.

Pour de plus amples informations, veuillez consulter Dépannage des problèmes de connexion d'Aurora.

Connexion aux clusters de base de données Aurora avec les AWS pilotes

La AWS suite de pilotes a été conçue pour accélérer les temps de basculement et de basculement, ainsi que pour l'authentification avec AWS Secrets Manager, AWS Identity and Access Management (IAM) et Federated Identity. Les AWS pilotes s'appuient sur la surveillance de l'état du cluster de bases de données et sur la connaissance de la topologie du cluster pour déterminer le nouveau rédacteur. Cette approche réduit les temps de basculement et de basculement à un chiffre, contre des dizaines de secondes pour les pilotes open source.

Le tableau suivant répertorie les fonctionnalités prises en charge pour chacun des pilotes. À mesure que de nouvelles fonctionnalités de service sont introduites, l'objectif de la AWS suite de pilotes est de fournir un support intégré pour ces fonctionnalités de service.

Fonctionnalité AWS JDBCChauffeur AWS Pilote Python AWS ODBCDriver for My SQL
Assistance en cas de basculement Oui Oui Oui
Surveillance améliorée du basculement Oui Oui Oui
Séparation en lecture/écriture Oui Oui Non
Traqueur de connexion Aurora Oui Oui Non
Connexion aux métadonnées du pilote Oui N/A N/A
Télémétrie Oui Oui Non
Secrets Manager Oui Oui Oui
IAMauthentification Oui Oui Oui
Identité fédérée (AD FS) Oui Oui Non
Identité fédérée (Okta) Oui Non Non

Pour plus d'informations sur les AWS pilotes, consultez le pilote de langue correspondant à votre cluster de SQL base de données Aurora My SQL ou Aurora Postgre.

Connexion à un cluster Amazon Aurora My SQL DB

Pour vous authentifier auprès de votre cluster Aurora My SQL DB, vous pouvez utiliser l'authentification par nom SQL d'utilisateur et mot de passe ou l'authentification par base de données AWS Identity and Access Management (IAM). Pour plus d'informations sur l'utilisation de l'authentification par mon nom SQL d'utilisateur et mon mot de passe, consultez la section Contrôle d'accès et gestion de compte dans la SQL documentation Ma documentation. Pour plus d'informations sur l'utilisation IAM de l'authentification de base de données, consultezAuthentification de base de données IAM.

Lorsque vous êtes connecté à votre cluster de base de données Amazon Aurora compatible avec My SQL 8.0, vous pouvez exécuter des SQL commandes compatibles avec My SQL version 8.0. La version minimale compatible est My SQL 8.0.23. Pour plus d'informations sur SQL la syntaxe My SQL 8.0, consultez le manuel de référence My SQL 8.0. Pour plus d'informations sur les limitations applicables à la SQL version 3 d'Aurora My, consultezComparaison entre Aurora My SQL version 3 et My SQL 8.0 Community Edition.

Lorsque vous êtes connecté à votre cluster de base de données Amazon Aurora compatible avec My SQL 5.7, vous pouvez exécuter des SQL commandes compatibles avec My SQL version 5.7. Pour plus d'informations sur SQL la syntaxe My SQL 5.7, consultez le manuel de référence My SQL 5.7. Pour plus d'informations sur les limitations applicables à Aurora My SQL 5.7, consultezAurora MySQL version 2 compatible avec MySQL 5.7.

Note

Pour un guide utile et détaillé sur la connexion à un cluster Amazon Aurora My SQL DB, vous pouvez consulter le manuel de gestion des connexions Aurora.

Dans la vue détaillée de votre cluster de base de données, vous pouvez trouver le point de terminaison du cluster, que vous pouvez utiliser dans votre chaîne de SQL connexion Ma. Le point de terminaison se compose du nom de domaine et du port de votre cluster de base de données. Par exemple, si la valeur d'un point de terminaison estmycluster.cluster-123456789012.us-east-1.rds.amazonaws.com:3306, vous devez spécifier les valeurs suivantes dans une chaîne Ma SQL connexion :

  • Pour un hôte ou nom d'hôte, spécifiez mycluster.cluster-123456789012.us-east-1.rds.amazonaws.com

  • Pour le port, spécifiez 3306 ou la valeur de port que vous avez utilisée lors de la création du cluster de base de données

Le point de terminaison du cluster vous connecte à l'instance principale du cluster de base de données. Vous pouvez effectuer des opérations de lecture et d'écriture à l'aide du point de terminaison du cluster. Votre cluster de bases de données peut aussi avoir jusqu'à 15 réplicas Aurora qui prennent en charge l'accès en lecture seule aux données de votre cluster de bases de données. L'instance principale et chaque réplica Aurora possèdent un point de terminaison unique, qui est indépendant du point de terminaison du cluster et vous permet de vous connecter directement à une instance de base de données spécifique du cluster. Le point de terminaison du cluster pointe toujours vers l'instance principale. Si l'instance principale échoue et est remplacée, le point de terminaison du cluster pointe vers la nouvelle instance principale.

Pour afficher le point de terminaison du cluster (point de terminaison du rédacteur), choisissez Databases sur la RDS console Amazon et choisissez le nom du cluster de base de données pour afficher les détails du cluster de base de données.

Aurora My SQL Writer Endpoint.

Utilitaires de connexion pour Aurora My SQL

Vous trouverez ci-après certains des utilitaires de connexion que vous pouvez utiliser :

Connexion à Aurora My à l'SQLaide de l'SQLutilitaire My

Utilisez la procédure suivante. Cela suppose que vous avez configuré votre cluster de base de données dans un sous-réseau privé de votreVPC. Vous vous connectez à l'aide d'une EC2 instance Amazon que vous avez configurée conformément aux didacticiels présentés dansDidacticiel : Créer un serveur web et une cluster de base de données Amazon Aurora.

Note

Cette procédure n'exige pas d'installer le serveur Web dans le didacticiel, mais elle exige d'installer MariaDB 10.5.

Pour vous connecter à un cluster de bases de données à l'aide de l'SQLutilitaire My
  1. Connectez-vous à l'EC2instance que vous utilisez pour vous connecter à votre cluster de base de données.

    Vous devez visualiser des résultats similaires à ce qui suit.

    Last login: Thu Jun 23 13:32:52 2022 from xxx.xxx.xxx.xxx __| __|_ ) _| ( / Amazon Linux 2 AMI ___|\___|___| https://aws.amazon.com/amazon-linux-2/ [ec2-user@ip-10-0-xxx.xxx ~]$
  2. Saisissez la commande suivante dans l'invite de commande pour vous connecter à l'instance de base de données principale de votre cluster de bases de données.

    Pour le -h paramètre, remplacez le DNS nom du point de terminaison par votre instance principale. Pour le paramètre -u, remplacez l'ID d'utilisateur d'un compte d'utilisateur de base de données.

    mysql -h primary-instance-endpoint.AWS_account.AWS_Region.rds.amazonaws.com -P 3306 -u database_user -p

    Par exemple :

    mysql -h my-aurora-cluster-instance.c1xy5example.123456789012.eu-central-1.rds.amazonaws.com -P 3306 -u admin -p
  3. Saisissez le mot de passe de l'utilisateur de la base de données.

    Vous devez visualiser des résultats similaires à ce qui suit.

    Welcome to the MariaDB monitor. Commands end with ; or \g. Your MySQL connection id is 1770 Server version: 8.0.23 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. MySQL [(none)]>
  4. Entrez vos SQL commandes.

Connexion à Aurora My SQL avec le JDBC pilote Amazon Web Services (AWS)

Le JDBC pilote Amazon Web Services (AWS) est conçu comme un JDBC wrapper avancé. Ce wrapper complète et étend les fonctionnalités d'un JDBC pilote existant pour aider les applications à tirer parti des fonctionnalités des bases de données en cluster telles qu'Aurora My. SQL Le pilote est compatible directement avec le pilote communautaire My SQL Connector/J et le pilote communautaire MariaDB Connector/J.

Pour installer le AWS JDBC pilote, ajoutez le fichier .jar du AWS JDBC pilote (situé dans l'applicationCLASSPATH) et conservez les références au pilote communautaire correspondant. Mettez à jour le URL préfixe 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 AWS JDBC pilote et des instructions complètes pour son utilisation, consultez le GitHub référentiel de JDBC pilotes Amazon Web Services (AWS).

Note

La version 3.0.3 de l'utilitaire MariaDB Connector/J ne prend plus en charge les clusters de base de données Aurora. Nous vous recommandons donc vivement de passer au pilote. AWS JDBC

Connexion à Aurora My à l'SQLaide du pilote Python Amazon Web Services (AWS)

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 supérieures de Python. Vous pouvez installer le aws-advanced-python-wrapper package à l'aide de la pip commande, 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).

Connexion à Aurora My SQL avec le ODBC pilote Amazon Web Services (AWS) pour My SQL

The AWS ODBC Driver for My SQL est un pilote client conçu pour la haute disponibilité d'Aurora MySQL. Le pilote peut coexister avec le pilote My SQL Connector/le ODBC pilote et est compatible avec les mêmes flux de travail.

Pour plus d'informations sur le AWS ODBC Driver for My SQL et des instructions complètes pour son installation et son utilisation, consultez le ODBCpilote Amazon Web Services (AWS) pour My SQL GitHub repository.

Connexion à Aurora My SQL en utilisant SSL

Vous pouvez utiliser le SSL chiffrement sur les connexions à une instance de base de SQL données Aurora My. Pour plus d’informations, veuillez consulter TLSconnexions aux clusters Aurora My SQL DB.

Pour vous connecter en utilisantSSL, utilisez l'SQLutilitaire My comme décrit dans la procédure suivante. Si vous utilisez l'authentification IAM de base de données, vous devez utiliser une SSL connexion. Pour plus d’informations, veuillez consulter Authentification de base de données IAM.

Note

Pour vous connecter au point de terminaison du cluster à l'aide deSSL, votre utilitaire de connexion client doit prendre en charge les noms alternatifs de sujet (SAN). Si votre utilitaire de connexion client ne le prend pas en chargeSAN, vous pouvez vous connecter directement aux instances de votre cluster de base de données Aurora. Pour plus d'informations sur les points de terminaison Aurora, consultez Connexions aux terminaux Amazon Aurora.

Pour vous connecter à un cluster de bases de données à SSL l'aide de l'SQLutilitaire My

  1. Téléchargez la clé publique du certificat de RDS signature Amazon.

    Pour plus d'informations sur le téléchargement de certificats, veuillez consulter Utilisation TLS deSSL/pour chiffrer une connexion à une de clusters.

  2. Tapez la commande suivante à une invite de commande pour vous connecter à l'instance principale d'un cluster de base de données à SSL l'aide de l'SQLutilitaire My. Pour le -h paramètre, remplacez le DNS nom du point de terminaison par votre instance principale. Pour le paramètre -u, remplacez l'ID d'utilisateur d'un compte d'utilisateur de base de données. Remplacez le --ssl-ca paramètre par le nom du fichier de SSL certificat comme il convient. Entrez le mot de passe de l'utilisateur maître quand vous y êtes invité.

    mysql -h mycluster-primary.123456789012.us-east-1.rds.amazonaws.com -u admin_user -p --ssl-ca=[full path]global-bundle.pem --ssl-verify-server-cert

Vous devez visualiser des résultats similaires à ce qui suit.

Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 350 Server version: 8.0.26-log MySQL Community Server (GPL) Type 'help;' or '\h' for help. Type '\c' to clear the buffer. mysql>

Pour obtenir des instructions générales sur la création de chaînes de SQL connexion RDS pour My et la recherche de la clé publique pour SSL les connexions, voir Connexion à une instance de base de données exécutant le moteur My SQL database.

Connexion à un cluster de SQL base de données Amazon Aurora Postgre

Vous pouvez vous connecter à une instance de base de données dans votre cluster de SQL base de données Amazon Aurora Postgre à l'aide des mêmes outils que ceux que vous utilisez pour vous connecter à une base de données PostgreSQL. Dans ce cadre, vous utilisez la même clé publique pour les connexions Secure Sockets Layer (SSL). Vous pouvez utiliser les informations de point de terminaison et de port de l'instance principale ou des répliques Aurora de votre cluster de SQL base de données Aurora Postgre dans la chaîne de connexion de tout script, utilitaire ou application qui se connecte à une instance de base de données PostgreSQL. Dans la chaîne de connexion, spécifiez l'DNSadresse de l'instance principale ou du point de terminaison Aurora Replica comme paramètre d'hôte. Spécifiez le numéro de port du point de terminaison comme paramètre de port.

Lorsque vous êtes connecté à une instance de base de données dans votre cluster de SQL base de données Amazon Aurora Postgre, vous pouvez exécuter n'importe quelle SQL commande compatible avec SQL Postgre.

Dans la vue détaillée de votre cluster de SQL base de données Aurora Postgre, vous trouverez le nom, l'état, le type et le numéro de port du point de terminaison du cluster. Vous utilisez le point de terminaison et le numéro de port dans votre chaîne de SQL connexion Postgre. Par exemple, si la valeur d'un point de terminaison estmycluster.cluster-123456789012.us-east-1.rds.amazonaws.com, vous devez spécifier les valeurs suivantes dans une chaîne de SQL connexion Postgre :

  • Pour un hôte ou nom d'hôte, spécifiez mycluster.cluster-123456789012.us-east-1.rds.amazonaws.com

  • Pour le port, spécifiez 5432 ou la valeur de port que vous avez utilisée lors de la création du cluster de base de données

Le point de terminaison du cluster vous connecte à l'instance principale du cluster de base de données. Vous pouvez effectuer des opérations de lecture et d'écriture à l'aide du point de terminaison du cluster. Votre cluster de bases de données peut aussi avoir jusqu'à 15 réplicas Aurora qui prennent en charge l'accès en lecture seule aux données de votre cluster de bases de données. Chaque instance de base de données du cluster Aurora (c'est-à-dire, l'instance principale et chaque réplica Aurora) possède un point de terminaison unique qui est indépendant du point de terminaison du cluster. Ce point de terminaison unique vous permet de vous connecter directement à une instance de base de données spécifique dans le cluster. Le point de terminaison du cluster pointe toujours vers l'instance principale. Si l'instance principale échoue et est remplacée, le point de terminaison du cluster pointe vers la nouvelle instance principale.

Pour afficher le point de terminaison du cluster (point de terminaison du rédacteur), choisissez Databases sur la RDS console Amazon et choisissez le nom du cluster de base de données pour afficher les détails du cluster de base de données.

Point de terminaison Aurora Postgrer SQL Writer.

Utilitaires de connexion pour Aurora Postgre SQL

Vous trouverez ci-après certains des utilitaires de connexion que vous pouvez utiliser :

Connexion à Aurora Postgre SQL avec le pilote Amazon Web Services (AWS) JDBC

Le JDBC pilote Amazon Web Services (AWS) est conçu comme un JDBC wrapper avancé. Ce wrapper complète et étend les fonctionnalités d'un JDBC pilote existant pour aider les applications à tirer parti des fonctionnalités des bases de données en cluster telles qu'Aurora Postgre. SQL Le pilote est compatible directement avec le JDBC pilote Community PG.

Pour installer le AWS JDBC pilote, ajoutez le fichier .jar du AWS JDBC pilote (situé dans l'applicationCLASSPATH) et conservez les références au pilote de la JDBC communauté pg. Mettez à jour le URL préfixe de connexion de jdbc:postgresql:// à. jdbc:aws-wrapper:postgresql://

Pour plus d'informations sur le AWS JDBC pilote et des instructions complètes pour son utilisation, consultez le GitHub référentiel de JDBC pilotes Amazon Web Services (AWS).

Connexion à Aurora Postgre SQL avec le pilote Python Amazon Web Services (AWS)

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 supérieures de Python. Vous pouvez installer le aws-advanced-python-wrapper package à l'aide de la pip commande, 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).

Dépannage des problèmes de connexion d'Aurora

Les causes les plus courantes d'échec de connexion à un nouveau cluster de bases de données Aurora sont les suivantes :

  • Groupe de sécurité dans le VPC n'autorise pas l'accès — VPC Vous devez autoriser les connexions depuis votre appareil ou depuis une EC2 instance Amazon en configurant correctement le groupe de sécurité dans leVPC. Pour résoudre ce problème, modifiez les règles entrantes VPC de votre groupe de sécurité afin d'autoriser les connexions. Pour obtenir un exemple, veuillez consulter Tutoriel : créer un VPC à utiliser avec un(e) cluster de base de données (IPv4 uniquement).

  • Port bloqué par les règles de pare-feu – Vérifiez la valeur du port configuré pour votre cluster de bases de données Aurora. Si une règle de pare-feu bloque ce port, vous pouvez recréer l'instance à l'aide d'un autre port.

  • IAMConfiguration incomplète ou incorrecte : si vous avez créé votre instance de base de données Aurora pour utiliser IAM l'authentification basée sur l'authentification, assurez-vous qu'elle est correctement configurée. Pour de plus amples informations, veuillez consulter Authentification de base de données IAM.

Pour de plus amples informations sur la résolution des problèmes de connexion de base de données Aurora, consultez Impossible de se connecter à l'RDSinstance de base de données Amazon.