View a markdown version of this page

Accès à Aurora DSQL avec des clients PostgreSQL-compatible - Amazon Aurora DSQL

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 PostgreSQL-compatible

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

PostgreSQL Aurora DSQL Remarques
Rôle (également connu sous le nom d’utilisateur ou de groupe) Rôle de base de données Aurora DSQL crée pour vous un rôle nommé admin. Lorsque vous créez des rôles de base de données personnalisés, vous devez utiliser le rôle admin pour les associer à des rôles IAM afin de vous authentifier lors de la connexion à votre cluster. Pour de plus amples informations, veuillez consulter Utilisation des rôles de base de données et de l’authentification IAM.
Hôte (également appelé nom d’hôte ou spécification d’hôte) Point de terminaison de cluster Les clusters à une seule région Aurora DSQL fournissent un point de terminaison géré unique et redirigent automatiquement le trafic en cas d’indisponibilité dans la région.
Port N/A — utilise la valeur par défaut 5432 Il s’agit de la valeur par défaut de PostgreSQL.
Base de données (dbname) utiliser postgres Aurora DSQL crée cette base de données pour vous lorsque vous créez le cluster.
Mode SSL Le protocole SSL est toujours activé côté serveur Dans Aurora DSQL, Aurora DSQL prend en charge le mode SSL require. Les connexions sans SSL sont rejetées par Aurora DSQL.
Mot de passe Jeton d’authentification Aurora DSQL nécessite des jetons d’authentification temporaires plutôt que des mots de passe de longue durée. Pour en savoir plus, veuillez consulter la section Création d’un jeton d’authentification dans Amazon Aurora DSQL.

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.

Paramètres de session pris en charge

Aurora DSQL optimise automatiquement le stockage, la gestion des connexions et le traitement des transactions afin de prendre en charge un ensemble ciblé de paramètres de session. Aurora DSQL accepte les paramètres répertoriés dans le tableau suivant. Les paramètres extérieurs à cet ensemble renvoient l'erreur suivante :

ERROR: setting configuration parameter "parameter_name" not supported

Aurora DSQL prend en charge les paramètres de session PostgreSQL suivants. Sauf indication contraire, vous pouvez les définir en utilisant ou SET en SET SESSION tant qu'options de chaîne de connexion. Vous pouvez également l'utiliser SET LOCAL pour définir n'importe lequel de ces paramètres pour la durée d'une transaction unique. Permet RESET de rétablir la valeur par défaut d'un paramètre.

Paramètres de session pris en charge
Paramètre Catégorie Description
application_name Identification du client Définit le nom de l'application indiqué dans les métadonnées de connexion. Utile pour identifier les connexions lors de la surveillance.
client_encoding Localisation Définit le codage des caractères côté client. La base de données est utilisée UTF-8 en interne.
datestyle Formatage de sortie Définit le format d'affichage des valeurs de date et d'heure (par exemple,ISO, MDY).
extra_float_digits Formatage de sortie Définit le nombre de chiffres affichés pour les valeurs à virgule flottante. Certains pilotes, tels que JDBC, utilisent ce paramètre.
intervalstyle Formatage de sortie Définit le format d’affichage des valeurs de type intervalle.
timezone Localisation Définit le fuseau horaire de la session. Aurora DSQL stocke toutes les dates et heures correspondant au fuseau horaire en interne en UTC. Ce paramètre contrôle la manière dont Aurora DSQL affiche les valeurs au client.
search_path Résolution du schéma Définit l'ordre de recherche du schéma pour les noms d'objets non qualifiés.
enable_bitmapscan Planificateur de requêtes Active ou désactive l'utilisation par le planificateur de requêtes des types de plan de numérisation bitmap.
enable_hashjoin Planificateur de requêtes Active ou désactive l'utilisation par le planificateur de requêtes des types de plans de jointure par hachage.
enable_indexonlyscan Planificateur de requêtes Active ou désactive l'utilisation par le planificateur de requêtes de types de plans de numérisation uniquement indexés.
enable_indexscan Planificateur de requêtes Active ou désactive l'utilisation par le planificateur de requêtes des types de plans d'analyse d'index.
enable_material Planificateur de requêtes Active ou désactive l'utilisation de la matérialisation par le planificateur de requêtes.
enable_mergejoin Planificateur de requêtes Active ou désactive l'utilisation par le planificateur de requêtes des types de plans de fusion et de jointure.
enable_nestloop Planificateur de requêtes Active ou désactive l'utilisation par le planificateur de requêtes de plans de jointure en boucle imbriquée.
enable_seqscan Planificateur de requêtes Active ou désactive l'utilisation par le planificateur de requêtes de types de plans de scan séquentiels.
disable_sync_create_index Aurora DSQL-specific Contrôle si l'CREATE INDEXexécution est asynchrone. La valeur par défaut eston, ce qui signifie qu'Aurora DSQL crée des index de manière asynchrone. Définissez ce paramètre sur off pour créer des index de manière synchrone sur des tables vides.
role Identité de session Définit le rôle actuel. Dans Aurora DSQL, vous ne pouvez définir ce paramètre qu'à l'SET LOCALintérieur d'un bloc de transactions.

Aurora DSQL gère automatiquement les aspects suivants de votre base de données. Vous n'avez donc pas besoin de configurer les paramètres de session PostgreSQL correspondants :

  • Paramètres de connexion et de réseau : Aurora SQL gère le cycle de vie des connexions et les paramètres TCP en interne, notamment tcp_keepalives_idletcp_keepalives_interval, et. tcp_keepalives_count

  • Paramètres de mémoire et de ressources : Aurora DSQL gère automatiquement l'allocation de mémoire, y compris work_mem etshared_buffers.

  • Paramètres de délai d'expiration : Aurora SQL applique ses propres limites de durée de transaction, notammentstatement_timeout, etlock_timeout. idle_in_transaction_session_timeout

  • Paramètres de réplication et de WAL : Aurora DSQL gère automatiquement la réplication via son architecture multirégionale intégrée, notamment wal_level et. synchronous_commit

  • Paramètres de journalisation : Aurora DSQL gère la journalisation en interne, notamment log_statement etclient_min_messages.

  • Paramètres de transaction — Aurora DSQL utilise un niveau d'REPEATABLE READisolation fixe pour toutes les transactions. Si votre pilote a besoin de spécifier un niveau d'isolation, utilisezBEGIN ISOLATION LEVEL REPEATABLE READ.

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

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

Résolution des problèmes

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 ouvrir 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.