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.

# Configuration des paramètres de l’extension pgactive
<a name="Appendix.PostgreSQL.CommonDBATasks.pgactive.parameters"></a>

Vous pouvez utiliser la requête suivante pour afficher tous les paramètres associés à l'extension `pgactive`.

```
app=> SELECT * FROM pg_settings WHERE name LIKE 'pgactive.%';
```

Vous pouvez configurer l’extension `pgactive` à l’aide de différents paramètres. Ces paramètres peuvent être définis par le biais de l'interface CLI AWS Management Console ou de l'interface AWS CLI.

## Principaux paramètres de l’extension pgactive
<a name="Appendix.PostgreSQL.CommonDBATasks.pgactive.mainparams"></a>

Le tableau suivant fournit une référence pour les principaux paramètres de l’extension `pgactive` :


| Paramètre | Unit | Par défaut | Description | 
| --- | --- | --- | --- | 
| pgactive.conflict\$1logging\$1include\$1tuples | `boolean` | –  | Journalise les informations complètes du tuple pour l’extension `pgactive`.  Un redémarrage du serveur est nécessaire pour que les modifications prennent effet.  | 
| pgactive.log\$1conflicts\$1to\$1table | `boolean` | –  | Détermine si l’extension `pgactive` journalise les conflits détectés dans la table `pgactive.pgactive_conflict_history`. Pour plus d’informations, consultez Journalisation des conflits.  Un redémarrage du serveur est nécessaire pour que les modifications prennent effet.  | 
| pgactive.log\$1conflicts\$1to\$1logfile | `boolean` | –  | Détermine si l’extension `pgactive` journalise les conflits détectés dans le fichier journal PostgreSQL. Pour plus d’informations, consultez Journalisation des conflits.  Un redémarrage du serveur est nécessaire pour que les modifications prennent effet.  | 
| pgactive.synchronous\$1commit | `boolean` | off | Détermine le comportement de validation pour les applications de travail d’application pgactive. Lorsque cette option est désactivée (off), les applications de travail d’application effectuent des validations asynchrones, ce qui améliore le débit de PostgreSQL lors des opérations d’application, mais retarde les confirmations de relecture en amont. La paramétrer sur `off` est toujours sûr et n’entraîne pas de perte ni de saut de transaction. Ce paramètre affecte uniquement le calendrier des vidanges de disque sur le nœud en aval et le moment où les confirmations sont envoyées en amont. Le système retarde l’envoi des confirmations de relecture jusqu’à ce que les validations soient vidées sur le disque par le biais d’opérations indépendantes, telles que des points de contrôle ou des tâches périodiques. Toutefois, si l’amont a répertorié l’aval dans `synchronous_standby_names`, si vous définissez ce paramètre sur `off`, les validations synchrones en amont mettent plus de temps à signaler le succès au client. Dans ce cas, définissez le paramètre sur `on`.  Même lorsque ce paramètre est défini sur `on`, avec des nœuds répertoriés dans `synchronous_standby_names`, des conflits de réplication peuvent toujours se produire dans les configurations active-active. Cela est dû au fait que le système ne dispose pas de verrouillage entre nœuds ni de gestion globale des instantanés, ce qui permet à des transactions simultanées sur différents nœuds de modifier le même tuple. De plus, les transactions ne commencent la réplication qu’après avoir été validées sur le nœud en amont. L’activation de la validation synchrone ne transforme pas l’extension pgactive en un système toujours cohérent.  | 
| pgactive.temp\$1dump\$1directory | `string` | – | Définit le chemin de stockage temporaire requis pour les opérations de clonage de base de données lors de la configuration initiale. Ce répertoire doit être accessible en écriture par l’utilisateur postgres et disposer d’un espace de stockage suffisant pour contenir un vidage complet de la base de données. Le système utilise cet emplacement uniquement lors de la configuration initiale de la base de données avec des opérations de copie logique. Ce paramètre n’est pas utilisé par la `pgactive_init_copy command`. | 
| pgactive.max\$1ddl\$1lock\$1delay | `milliseconds` | `-1` | Spécifie le temps d’attente maximal pour le verrou DDL avant l’abandon forcé de transactions d’écriture simultanées. La valeur par défaut est `-1`, qui adopte la valeur définie dans `max_standby_streaming_delay`. Ce paramètre accepte les unités de temps. Par exemple, vous pouvez le définir sur 10 s pour 10 secondes. Pendant cette période d’attente, le système tente d’acquérir des verrous DDL en attendant que les transactions d’écriture en cours soient validées ou annulées. Pour plus d’informations, consultez Verrouillage DDL. | 
| pgactive.ddl\$1lock\$1timeout | `milliseconds` | `-1` | Spécifie le temps d’attente d’une tentative de verrouillage DDL pour obtenir le verrou. La valeur par défaut est `-1`, qui utilise la valeur spécifiée dans lock\$1timeout. Vous pouvez définir ce paramètre en utilisant des unités de temps telles que 10 s pour 10 secondes. Ce minuteur contrôle uniquement la période d’attente pour obtenir un verrou DDL. Une fois que le système obtient le verrou et commence l’opération DDL, le minuteur s’arrête. Ce paramètre ne limite pas la durée totale pendant laquelle un verrou DDL peut être maintenu ni le temps global de l’opération DDL. Pour contrôler la durée totale de l’opération, utilisez plutôt `statement_timeout`. Pour plus d’informations, consultez Verrouillage DDL. | 
| pgactive.debug\$1trace\$1ddl\$1locks\$1level | `boolean` | –  | Remplace le niveau de journalisation de débogage par défaut pour les opérations de verrouillage DDL dans l’extension `pgactive`. Lorsqu’il est configuré, ce paramètre entraîne l’émission de messages relatifs aux verrous DDL au niveau de débogage JOURNAL au lieu du niveau par défaut. Utilisez ce paramètre pour surveiller l’activité de verrouillage DDL sans activer les niveaux de journalisation détaillée `DEBUG1` ou `DEBUG2` sur l’ensemble du serveur.  Niveaux de journalisation disponibles, par ordre croissant de détail : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/Appendix.PostgreSQL.CommonDBATasks.pgactive.parameters.html) Pour plus d’informations sur les options de surveillance, consultez Surveillance des verrous DDL globaux.  Les modifications apportées à ce paramètre prennent effet lorsque vous rechargez la configuration. Vous n’avez pas besoin de redémarrer le serveur.   | 

## Paramètres supplémentaires de l’extension pgactive
<a name="Appendix.PostgreSQL.CommonDBATasks.pgactive.addparams"></a>

Le tableau suivant présente les options de configuration internes moins fréquemment utilisées disponibles pour l’extension `pgactive`.


| Paramètre | Unit | Par défaut | Description | 
| --- | --- | --- | --- | 
| pgactive.debug\$1apply\$1delay | `integer` | – |  Définit un délai d’application (en millisecondes) pour les connexions configurées dont l’entrée `pgactive.pgactive_connections` ne comporte pas de délai d’application explicite. Ce délai est défini lors de la création ou de la jointure d’un nœud, et pgactive ne relit pas une transaction sur des nœuds pairs avant qu’au moins le nombre de millisecondes spécifié ne se soit écoulé depuis sa validation. Principalement utilisé pour simuler des réseaux à latence élevée dans des environnements de test afin de faciliter la création de conflits. Par exemple, avec un délai de 500 ms sur les nœuds A et B, vous disposez d’au moins 500 ms pour effectuer une insertion conflictuelle sur le nœud B après avoir inséré une valeur sur le nœud A.  Nécessite le rechargement du serveur ou le redémarrage des applications de travail d’application pour prendre effet.  | 
| pgactive.connectability\$1check\$1duration | `integer` | –  | Spécifie la durée (en secondes) pendant laquelle une application de travail de base de données tente d’établir des connexions en cas de tentative infructueuse. L’application de travail effectue une tentative de connexion par seconde jusqu’à ce qu’elle réussisse ou atteigne ce délai d’expiration. Ce paramètre est utile lorsque le moteur de base de données démarre avant que l’application de travail ne soit prête à établir des connexions. | 
| pgactive.skip\$1ddl\$1replication | `boolean` | `on` | Contrôle la manière dont les modifications DDL sont répliquées ou gérées dans Amazon RDS lorsque `pgactive` est activé. Lorsqu’il est défini sur `on`, le nœud traite les modifications DDL comme un nœud non pgactive. Les exigences suivantes s’appliquent lors de l’utilisation de ce paramètre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/Appendix.PostgreSQL.CommonDBATasks.pgactive.parameters.html) Vous pouvez modifier ce paramètre de deux manières avec les privilèges de super utilisateur : globalement, localement (au niveau de la session).  Une modification incorrecte de ce paramètre peut corrompre les configurations de réplication.  | 
| pgactive.do\$1not\$1replicate | `boolean` | – | Ce paramètre est réservé à une utilisation interne. Lorsque vous définissez ce paramètre dans une transaction, les modifications ne sont pas répliquées sur les autres nœuds du cluster de bases de données.   Une modification incorrecte de ce paramètre peut corrompre les configurations de réplication.  | 
| pgactive.discard\$1mismatched\$1row\$1attributes | `boolean` | –  | Ce paramètre est réservé à une utilisation par des spécialistes. Nous recommandons d’utiliser ce paramètre uniquement pour résoudre des problèmes de réplication spécifiques. Utilisez ce paramètre lorsque : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/Appendix.PostgreSQL.CommonDBATasks.pgactive.parameters.html) Ce paramètre remplace le message d’erreur suivant et permet la divergence de données afin de permettre la poursuite de la réplication : `cannot right-pad mismatched attributes; attno %u is missing in local table and remote row has non-null, non-dropped value for this attribute`  Une modification incorrecte de ce paramètre peut corrompre les configurations de réplication.   | 
| pgactive.debug\$1trace\$1replay | `boolean` | – | Lorsqu’il est défini sur `on`, il émet un message de journal pour chaque action à distance effectuée par les processus de travail d’application en aval. Les journaux incluent : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/Appendix.PostgreSQL.CommonDBATasks.pgactive.parameters.html) Les journaux capturent également les commandes DDL en file d’attente et les suppressions de tables.para> Par défaut, les journaux n’incluent pas le contenu des champs de ligne. Pour inclure des valeurs de ligne dans les journaux, vous devez effectuer une recompilation avec les indicateurs suivants activés : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/Appendix.PostgreSQL.CommonDBATasks.pgactive.parameters.html)  L’activation de ce paramètre de journalisation peut avoir un impact sur les performances. Nous vous recommandons de l’activer uniquement lorsque c’est nécessaire pour la résolution des problèmes. Les modifications apportées à ce paramètre prennent effet lorsque vous rechargez la configuration. Vous n’avez pas besoin de redémarrer le serveur.   | 
| pgactive.extra\$1apply\$1connection\$1options |  | – | Vous pouvez configurer les paramètres de connexion pour toutes les connexions de nœuds pairs avec des nœuds pgactive. Ces paramètres contrôlent les paramètres tels que les modes keepalives et SSL. Par défaut, pgactive utilise les paramètres de connexion suivants : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/Appendix.PostgreSQL.CommonDBATasks.pgactive.parameters.html) Pour remplacer les paramètres par défaut, utilisez la commande similaire suivante : pgactive.extra\$1apply\$1connection\$1options = 'keepalives=0' Les chaînes de connexion des nœuds individuels ont la priorité sur ces paramètres et sur les options de connexion intégrées de pgactive. Pour plus d’informations sur les formats de chaînes de connexion, consultez la rubrique relative aux [chaînes de connexion libpq](https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING). Nous vous recommandons de conserver les paramètres keepalive par défaut activés. Désactivez les paramètres keepalive uniquement si vous rencontrez des problèmes lors de transactions importantes effectuées sur des réseaux peu fiables.   Nous vous recommandons de conserver les paramètres keepalive par défaut activés. Désactivez les paramètres keepalive uniquement si vous rencontrez des problèmes lors de transactions importantes effectuées sur des réseaux peu fiables. Les modifications apportées à ce paramètre prennent effet lorsque vous rechargez la configuration. Vous n’avez pas besoin de redémarrer le serveur.  | 
| pgactive.init\$1node\$1parallel\$1jobs (int) |  | – | Spécifie le nombre de tâches parallèles que `pg_dump` et `pg_restore` peuvent utiliser lors des jointures de nœuds logiques avec la fonction `pgactive.pgactive_join_group`. Les modifications apportées à ce paramètre prennent effet lorsque vous rechargez la configuration. Vous n’avez pas besoin de redémarrer le serveur. | 
| pgactive.max\$1nodes | `int` | 4 |  Spécifie le nombre maximal de nœuds autorisés dans un groupe d’extensions pgactive. La valeur par défaut est de 4 nœuds. Vous devez prendre en considération ce qui suit lors de la définition de la valeur de ce paramètre : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/Appendix.PostgreSQL.CommonDBATasks.pgactive.parameters.html) Vous pouvez définir ce paramètre de deux manières : dans le fichier de configuration, à l’aide de la commande `ALTER SYSTEM SET` La valeur par défaut de ce paramètre est `4`, ce qui signifie qu’il peut y avoir un maximum de 4 nœuds autorisés dans le groupe d’extensions `pgactive` à tout moment.  La modification prend effet après le redémarrage du serveur.  | 
| pgactive.permit\$1node\$1identifier\$1getter\$1function\$1creation | `boolean` | – | Ce paramètre est réservé à une utilisation interne. Lorsqu’il est activé, l’extension `pgactive` permet de créer la fonction getter d’identifiant de nœud pgactive. |