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 et affichage de la configuration du journal binaire
Les procédures stockées suivantes définissent et affichent les paramètres de configuration, tels que la conservation des fichiers journaux binaires.
**Topics**
+ [mysql.rds\$1set\$1configuration](#mysql_rds_set_configuration)
+ [mysql.rds\$1show\$1configuration](#mysql_rds_show_configuration)
## mysql.rds\$1set\$1configuration
Spécifie le nombre d’heures pendant lequel les journaux binaires doivent être conservés ou le nombre de secondes pendant lequel retarder la réplication.
### Syntaxe
```
CALL mysql.rds_set_configuration(name,value);
```
### Parameters
*name*
Nom du paramètre de configuration à définir.
*value*
Valeur du paramètre de configuration.
### Notes d’utilisation
La procédure `mysql.rds_set_configuration` prend en charge des paramètres de configuration suivants :
+ [nombre d’heures de conservation du journal binaire](#mysql_rds_set_configuration-usage-notes.binlog-retention-hours)
+ [retard à la source](#mysql_rds_set_configuration-usage-notes.source-delay)
+ [target delay](#mysql_rds_set_configuration-usage-notes.target-delay)
Les paramètres de configuration sont stockés de manière permanente et survivent à tout redémarrage ou basculement d’une instance de base de données.
#### nombre d’heures de conservation du journal binaire
Le paramètre `binlog retention hours` est utilisé pour spécifier le nombre d’heures de rétention des fichiers journaux binaires. Amazon RDS purge normalement un journal binaire dès que possible, mais il se peut que le journal binaire soit encore requis pour la réplication avec une base de données MySQL extérieure à RDS.
La valeur par défaut de `binlog retention hours` est `NULL`. Pour RDS pour MySQL, `NULL` signifie que les journaux binaires ne sont pas conservés (0 heure).
Pour spécifier le nombre d’heures pendant lesquelles conserver les journaux binaires sur une instance, utilisez la procédure stockée `mysql.rds_set_configuration` et spécifiez une période suffisamment longue pour que la réplication se produise, comme illustré dans l’exemple suivant.
`call mysql.rds_set_configuration('binlog retention hours', 24);`
**Note**
Vous ne pouvez pas utiliser la valeur `0` pour `binlog retention hours`.
Pour les instances de base de données MySQL, la valeur `binlog retention hours` maximale est 168 (7 jours).
Après avoir défini la période de rétention, surveillez l’utilisation du stockage de l’instance de base de données afin de garantir que les journaux binaires conservés n’utilisent pas un espace de stockage trop grand.
Pour les déploiements de cluster de bases de données multi-AZ, vous pouvez uniquement configurer la conservation des journaux binaires à partir de l’instance de base de données de l’enregistreur, et le paramètre est propagé à toutes les instances de base de données de lecteur de manière asynchrone. Si les journaux binaires du cluster de bases de données dépassent la moitié de l’espace de stockage local total, Amazon RDS déplace automatiquement les journaux périmés vers le volume EBS. Cependant, les journaux les plus récents restent stockés localement ; ils risquent donc d’être perdus en cas de défaillance nécessitant le remplacement de l’hôte ou lors d’une mise à l’échelle à la hausse ou à la baisse de la base de données.
#### retard à la source
Utilisez le paramètre `source delay` dans un réplica en lecture pour spécifier le nombre de secondes dont il faut retarder la réplication à partir du réplica en lecture vers son instance de base de données source. Amazon RDS réplique normalement les modifications dès que possible, mais vous pouvez souhaiter que certains environnement retardent la réplication. Par exemple, lorsque la réplication est retardée, vous pouvez restaurer par progression un réplica en lecture retardé au moment précédant un sinistre. Si une table est supprimée par mégarde, vous pouvez utiliser la réplication retardée pour la récupérer rapidement. La valeur par défaut de `target delay` est `0` (ne pas retarder la réplication).
Lorsque vous utilisez ce paramètre, il exécute [mysql.rds\$1set\$1source\$1delay](mysql-stored-proc-replicating.md#mysql_rds_set_source_delay) et applique la valeur d’entrée CHANGE primary TO MASTER\$1DELAY =. En cas de succès, la procédure enregistre le paramètre `source delay` dans la table `mysql.rds_configuration`.
Pour spécifier le nombre de secondes pendant lesquelles Amazon RDS retardera la réplication vers une instance de base de données source, utilisez la procédure `mysql.rds_set_configuration` stockée et spécifiez le nombre de secondes dont il faut retarder la réplication. Dans l’exemple suivant, la réplication est retardée d’au moins une heure (3 600 secondes).
`call mysql.rds_set_configuration('source delay', 3600);`
La procédure exécute ensuite `mysql.rds_set_source_delay(3600)`.
La limite du paramètre `source delay` est une journée (soit 86 400 secondes).
#### target delay
Utilisez le paramètre `target delay` pour spécifier le nombre de secondes dont il faut retarder la réplication entre une instance de base de données et tout réplica en lecture futur géré par RDS créé à partir de cette instance. Ce paramètre est ignoré pour les répliques de non-RDS-managed lecture. Amazon RDS réplique normalement les modifications dès que possible, mais vous pouvez souhaiter que certains environnement retardent la réplication. Par exemple, lorsque la réplication est retardée, vous pouvez restaurer par progression un réplica en lecture retardé au moment précédant un sinistre. Si une table est supprimée par mégarde, vous pouvez utiliser la réplication retardée pour la récupérer rapidement. La valeur par défaut de `target delay` est `0` (ne pas retarder la réplication).
Pour la reprise après sinistre, vous pouvez utiliser ce paramètre de configuration avec la procédure stockée [](mysql-stored-proc-replicating.md#mysql_rds_start_replication_until) ou [](mysql-stored-proc-gtid.md#mysql_rds_start_replication_until_gtid). Pour restaurer par progression les modifications dans un réplica en lecture retardé au moment précédant un sinistre, vous pouvez exécuter la procédure `mysql.rds_set_configuration` avec ce paramètre défini. Une fois que la procédure `mysql.rds_start_replication_until` ou `mysql.rds_start_replication_until_gtid` a arrêté la réplication, vous pouvez promouvoir le réplica en lecture pour qu’il devienne la nouvelle instance de base de données principale, en utilisant les instructions figurant dans [Promotion d'un réplica en lecture en instance de bases de données autonome](USER_ReadRepl.Promote.md).
Pour utiliser la procédure `mysql.rds_rds_start_replication_until_gtid`, la réplication basée sur des identifiants de transaction globaux (GTID) doit être activée. Pour ignorer une transaction basée sur des identifiants de transaction globaux spécifique qui est réputée pour entraîner des défaillances, vous pouvez utiliser la procédure stockée [](mysql-stored-proc-gtid.md#mysql_rds_skip_transaction_with_gtid). Pour plus d’informations sur la gestion d’une réplication basée sur des identifiants de transaction globaux, consultez [Utilisation de la réplication basée sur des identifiants de transaction globaux (GTID)](mysql-replication-gtid.md).
Pour spécifier le nombre de secondes pendant lesquelles Amazon RDS retardera la réplication vers un réplica en lecture, utilisez la procédure stockée `mysql.rds_set_configuration` et spécifiez le nombre de secondes dont il faut retarder la réplication. L’exemple suivant spécifie que la réplication est retardée d’au moins une heure (3 600 secondes).
`call mysql.rds_set_configuration('target delay', 3600);`
La limite du paramètre `target delay` est une journée (soit 86 400 secondes).
## mysql.rds\$1show\$1configuration
Nombre d’heures pendant lequel les journaux binaires sont conservés.
### Syntaxe
```
CALL mysql.rds_show_configuration;
```
### Notes d’utilisation
Pour vérifier le nombre d’heures pendant lequel Amazon RDS conserve les journaux binaires, utilisez la procédure stockée `mysql.rds_show_configuration`.
### Exemples
L’exemple suivant affiche la période de rétention :
```
call mysql.rds_show_configuration;
name value description
binlog retention hours 24 binlog retention hours specifies the duration in hours before binary logs are automatically deleted.
```