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 PostgreSQL

Après qu'Amazon RDS a provisionné votre instance de base de données, vous pouvez utiliser n'importe quelle application cliente SQL standard pour vous connecter à l'instance. Avant de pouvoir vous connecter, l'instance de base de données doit être disponible et accessible. La méthode utilisée pour créer l'instance de base de données Amazon RDS détermine s'il est possible ou non de vous y connecter depuis l'extérieur du VPC :

Pour vérifier si votre instance de base de données est publique ou privée, utilisez l'onglet AWS Management Console pour afficher l'onglet Connectivité et sécurité de votre instance. Sous Security (Sécurité), vous pouvez trouver la valeur « Publicly accessible (Accessible publiquement) », avec No (Non) pour privé, Yes (Oui) pour public.

Pour en savoir plus sur les différentes configurations Amazon RDS et Amazon VPC, et comment elles affectent l'accessibilité, consultez Scénarios d'accès à un(e) instance de base de données d'un VPC.

Installation du client PSQL

Pour vous connecter à votre instance de base de données à partir d'une instance EC2, vous pouvez installer un client PostgreSQL sur l'instance EC2. Pour installer le client psql sur Amazon Linux 2023, exécutez la commande suivante :

sudo dnf install postgresql15

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

sudo amazon-linux-extras install postgresql14

Pour installer le client psql sur Ubuntu, exécutez la commande suivante :

sudo apt-get install -y postgresql14

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

Si l'instance de base de données est disponible et accessible, vous pouvez vous connecter en fournissant les informations suivantes à l'application cliente SQL :

Vous pouvez obtenir ces informations à l'aide de la AWS Management ConsoleAWS CLIdescribe-db-instancescommande ou de l'opération DescribeDBInstances de l'API Amazon RDS.

Voici deux façons de se connecter à une instance de base de données PostgreSQL. Le premier exemple utilise pgAdmin, célèbre outil open source d'administration et de développement pour PostgreSQL. Le second exemple utilise psql, utilitaire de ligne de commande qui fait partie d'une installation PostgreSQL.

Utilisation de pgAdmin pour se connecter à une instance de base de données RDS for PostgreSQL

Vous pouvez utiliser l'outil open source pgAdmin pour vous connecter à votre instance de base de données RDS for PostgreSQL. Vous pouvez télécharger et utiliser pgAdmin à partir de l'adresse http://www.pgadmin.org/ sans disposer d'une instance locale de PostgreSQL sur votre ordinateur client.

Utilisation de psql pour connecter votre RDS à votre instance de base de données PostgreSQL

Vous pouvez utiliser une instance locale de l'utilitaire de ligne de commande psql pour vous connecter à une instance de base de données RDS for PostgreSQL. Vous devez avoir installé PostgreSQL ou le client psql sur votre ordinateur client.

Vous pouvez télécharger le client PostgreSQL depuis le site Web de PostgreSQL. Pour installer psql, suivez les instructions spécifiques à votre version du système d'exploitation.

Pour vous connecter à votre instance de base de données RDS for PostgreSQL, vous devez fournir les informations sur l'hôte (DNS), les informations d'identification de l'accès et le nom de la base de données.

Utilisez l'un des formats suivants pour vous connecter à votre instance de base de données RDS for PostgreSQL. Lorsque vous vous connectez, vous êtes invité à entrer un mot de passe. Pour les tâches de traitement par lots ou les scripts, utilisez l'option --no-password. Cette option est définie pour l'ensemble de la session.

Si vous vous connectez à cette instance de base de données pour la première fois ou si vous n'avez pas encore créé de base de données pour cette instance RDS for PostgreSQL, vous pouvez vous connecter à la base de données postgres à l'aide du « nom d'utilisateur principal » et du mot de passe.

Pour Unix, utilisez le format suivant.

psql \
   --host=<DB instance endpoint> \
   --port=<port> \
   --username=<master username> \
   --password \
   --dbname=<database name> 

Pour Windows, utilisez le format suivant.

psql ^
   --host=<DB instance endpoint> ^
   --port=<port> ^
   --username=<master username> ^
   --password ^
   --dbname=<database name> 

Par exemple, la commande suivante se connecte à une base de données appelée mypgdb sur une instance de base de données PostgreSQL appelée mypostgresql à l'aide d'informations d'identification fictives.

psql --host=mypostgresql.c6c8mwvfdgv0.us-west-2.rds.amazonaws.com --port=5432 --username=awsuser --password --dbname=mypgdb 

Connexion à RDS pour PostgreSQL avec le pilote JDBC Amazon Web Services ()AWS

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 pilote communautaire pgjDBC.

Pour installer le pilote AWS JDBC, ajoutez le fichier .jar du pilote AWS JDBC (situé dans l'applicationCLASSPATH) et conservez les références au pilote communautaire correspondant. Mettez à jour le préfixe d'URL de connexion correspondant comme suit :

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). GitHub

Connexion à RDS pour PostgreSQL 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).

Résolution des problèmes de connexion à votre instance RDS for PostgreSQL

Erreur – IRRÉCUPÉRABLE : le nom de la base de données n'existe pas

Si vous recevez une erreur telle que FATAL: database name does not exist lorsque vous tentez de vous connecter, essayez d'utiliser le nom par défaut de la base de données postgres pour l'option --dbname.

Erreur – Impossible de se connecter au serveur : la connexion a expiré

Si vous ne parvenez pas à vous connecter à l'instance de base de données, l'erreur la plus courante est Could not connect to server: Connection timed out. Si vous recevez cette erreur, procédez comme suit :

Erreurs liées aux règles d'accès du groupe de sécurité

Le problème de connexion qui intervient le plus fréquemment concerne les règles d'accès du groupe de sécurité assigné à l'instance de base de données. Si vous avez utilisé le groupe de sécurité par défaut lorsque vous avez créé l'instance de base de données, ce groupe de sécurité ne dispose vraisemblablement pas de règles d'accès vous autorisant à accéder à l'instance.

Pour que la connexion s'établisse, le groupe de sécurité que vous avez assigné à l'instance de base de données à sa création doit autoriser l'accès à l'instance de base de données. Par exemple, si l'instance de base de données a été créée à l'intérieur d'un VPC, elle doit avoir un groupe de sécurité VPC qui autorise les connexions. Déterminez si l'instance de base de données a été créée à l'aide d'un groupe de sécurité qui interdit les connexions depuis l'appareil ou l'instance Amazon EC2 où l'application s'exécute.

Vous pouvez ajouter ou modifier une règle entrante dans le groupe de sécurité. La sélection de Mon IP comme Source permet d'accéder à l'instance de base de données à partir de l'adresse IP détectée dans votre navigateur. Pour plus d'informations, consultez Créer un groupe de sécurité qui autorise l'accès à votre instance de base de données dans votre VPC.

Sinon, si l'instance de base de données a été créée à l'extérieur d'un VPC, elle doit avoir un groupe de sécurité de bases de données qui autorise ces connexions.

Pour de plus amples informations sur les groupes de sécurité Amazon RDS, veuillez consulter Contrôle d'accès par groupe de sécurité.