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.

Accès à Aurora DSQL avec des clients compatibles avec PostgreSQL

Aurora DSQL utilise le protocole filaire PostgreSQL. Vous pouvez vous connecter à PostgreSQL à l'aide de divers outils et clients, AWS CloudShell tels que DBeaver psql et. DataGrip Le tableau suivant résume la façon dont Aurora DSQL mappe les paramètres de connexion PostgreSQL courants :

Lors de la connexion, Aurora DSQL nécessite un jeton d'authentification IAM signé à la place d'un mot de passe traditionnel. Ces jetons temporaires sont générés à l'aide de AWS la version 4 de Signature et ne sont utilisés que lors de l'établissement de la connexion. Une fois connectée, la session reste active jusqu'à ce qu'elle se termine ou que le client se déconnecte.

Si vous tentez d'ouvrir une nouvelle session avec un jeton expiré, la demande de connexion échoue et un nouveau jeton doit être généré. Pour de plus amples informations, veuillez consulter Création d’un jeton d’authentification dans Amazon Aurora DSQL .

Accédez à Aurora DSQL à l'aide de clients SQL

Aurora DSQL prend en charge plusieurs clients compatibles avec PostgreSQL pour la connexion à votre cluster. Les sections suivantes décrivent comment se connecter à l'aide de AWS CloudShell PostgreSQL ou de votre ligne de commande locale, ainsi que d'outils basés sur une interface graphique tels que et. DBeaver JetBrains DataGrip Chaque client a besoin d'un jeton d'authentification valide, comme décrit dans la section précédente.

AWS CloudShell À utiliser pour accéder à Aurora DSQL avec le terminal interactif PostgreSQL (psql)

Utilisez la procédure suivante pour accéder à Aurora DSQL avec le terminal interactif PostgreSQL depuis. AWS CloudShell Pour plus d'informations, reportez-vous à la section Qu'est-ce que c'est AWS CloudShell.

Utilisez la CLI locale pour accéder à Aurora DSQL avec le terminal interactif PostgreSQL (psql)

Utilisez psql une interface de l'utilitaire PostgreSQL basée sur un terminal pour saisir des requêtes de manière interactive, les envoyer à PostgreSQL et afficher les résultats des requêtes.

Téléchargez le programme d’installation de votre système d’exploitation depuis la page des téléchargements de PostgreSQL. Pour plus d'informationspsql, consultez la section Applications clientes PostgreSQL sur le site Web de PostgreSQL.

Si vous l'avez déjà AWS CLI installé, utilisez l'exemple suivant pour vous connecter à votre cluster.

# Aurora DSQL requires a valid IAM token as the password when connecting.  
# Aurora DSQL provides tools for this and here we're using Python.  
export PGPASSWORD=$(aws dsql generate-db-connect-admin-auth-token \
  --region us-east-1 \
  --expires-in 3600 \
  --hostname your_cluster_endpoint)  
  
# Aurora DSQL requires SSL and will reject your connection without it.  
export PGSSLMODE=require  
  
# Connect with psql, which automatically uses the values set in PGPASSWORD and PGSSLMODE.  
# Quiet mode suppresses unnecessary warnings and chatty responses but still outputs errors.  
psql --quiet \
  --username admin \
  --dbname postgres \
  --host your_cluster_endpoint

DBeaver À utiliser pour accéder à Aurora DSQL

DBeaver est un outil de base de données open source basé sur une interface graphique. Vous pouvez l’utiliser pour vous connecter à votre base de données et la gérer. Pour le télécharger DBeaver, consultez la page de téléchargement sur le site Web de la DBeaver communauté.

Utilisez la procédure suivante pour vous connecter à votre cluster à l'aide de DBeaver.

JetBrains DataGrip À utiliser pour accéder à Aurora DSQL

JetBrains DataGrip est un IDE multiplateforme permettant de travailler avec le SQL et les bases de données, y compris PostgreSQL. DataGrip inclut une interface graphique robuste avec un éditeur SQL intelligent. Pour le télécharger DataGrip, rendez-vous sur la page de téléchargement du JetBrainssite Web.

Résolution de problème

Expiration des informations d'authentification pour les clients SQL

Les sessions établies restent authentifiées pendant une heure maximum ou jusqu’à ce qu’une déconnexion explicite ou qu’un délai d’expiration côté client ait lieu. Si de nouvelles connexions doivent être établies, un nouveau jeton d'authentification doit être généré et fourni dans le champ Mot de passe de la connexion. Toute tentative d’ouverture d’une nouvelle session (par exemple, pour répertorier de nouvelles tables ou une nouvelle console SQL) entraîne une nouvelle tentative d’authentification. Si le jeton d’authentification configuré dans les paramètres de connexion n’est plus valide, cette nouvelle session échouera et toutes les sessions ouvertes précédemment deviendront invalides. Gardez cela à l'esprit lorsque vous choisissez la durée de votre jeton d'authentification IAM avec l'expires-inoption qui peut être définie sur 15 minutes par défaut et sur une valeur maximale de sept jours.

Consultez également la section Dépannage de la documentation d'Aurora DSQL.