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
| 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è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_memetshared_buffers. -
Paramètres de délai d'expiration : Aurora SQL applique ses propres limites de durée de transaction, notamment
statement_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_levelet.synchronous_commit -
Paramètres de journalisation : Aurora DSQL gère la journalisation en interne, notamment
log_statementetclient_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.
Rubriques
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.