Configuration de l'extension pglogical

Pour configurer l'extension pglogical sur votre instance de base de données RDS for PostgreSQL, vous ajoutez pglogical aux bibliothèques partagées sur le groupe de paramètres de base de données personnalisé pour votre instance de base de données RDS for PostgreSQL. Vous devez également définir la valeur du paramètre rds.logical_replication sur 1, pour activer le décodage logique. Enfin, vous créez l'extension dans la base de données. Vous pouvez utiliser le AWS Management Console ou AWS CLI pour ces tâches.

Vous devez disposer d'autorisations en tant que rôle rds_superuser pour effectuer ces tâches.

Les étapes suivantes supposent que votre instance de base de données RDS pour PostgreSQL est associé(e) à un groupe de paramètres de bases de données personnalisé. Pour plus d’informations sur la création d’un groupe de paramètres de cluster de bases de données, consultez Groupes de paramètres pour Amazon RDS.

Console

Pour configurer l'extension pglogical

1. Connectez-vous à la console Amazon RDS AWS Management Console et ouvrez-la à https://console.aws.amazon.com/rds/l'adresse.

2. Dans le panneau de navigation, choisissez l’instance de base de données RDS pour PostgreSQL.

3. Ouvrez l’onglet Configuration de Instance de base de données RDS pour PostgreSQL. Parmi les détails de l’instance, trouvez le lien Groupe de paramètres.

4. Cliquez sur le lien pour ouvrir les paramètres personnalisés associés à votre Instance de base de données RDS pour PostgreSQL.

5. Dans le champ de recherche Parameters (Paramètres), tapez shared_pre pour trouver le paramètre shared_preload_libraries.

6. Choisissez Edit parameters (Modifier les paramètres) pour accéder aux valeurs des propriétés.

7. Ajoutez pglogical à la liste dans le champ Values (Valeurs). Utilisez une virgule pour séparer les éléments de la liste de valeurs.

   

8. Recherchez le paramètre rds.logical_replication et définissez-le sur 1, pour activer la réplication logique.

9. Redémarrez l'instance de base de données RDS for PostgreSQL pour que vos modifications soient prises en compte.

10. Lorsque l'instance est disponible, vous pouvez utiliser psql (ou pgAdmin) pour vous connecter à l'instance de base de données RDS for PostgreSQL.

    psql --host=111122223333.aws-region.rds.amazonaws.com --port=5432 --username=postgres --password --dbname=labdb
    

11. Pour vérifier que pglogical est initialisé, exécutez la commande suivante.

    SHOW shared_preload_libraries;
    shared_preload_libraries 
    --------------------------
    rdsutils,pglogical
    (1 row) 

12. Vérifiez le paramètre qui active le décodage logique, comme suit.

    SHOW wal_level;
    wal_level
    -----------
     logical
    (1 row)

13. Créez l'extension, comme suit.

    CREATE EXTENSION pglogical;
    EXTENSION CREATED

14. Sélectionnez Enregistrer les modifications.

15. Ouvrez la console Amazon RDS à l'adresse https://console.aws.amazon.com/rds/.

16. Sélectionnez votre instance de base de données RDS for PostgreSQL dans la liste des bases de données, puis choisissez Reboot (Redémarrer) dans le menu Actions.

AWS CLI

Pour configurer l'extension pglogical

Pour configurer pglogical à l'aide de AWS CLI, vous devez appeler l'modify-db-parameter-groupopération pour modifier certains paramètres de votre groupe de paramètres personnalisé, comme indiqué dans la procédure suivante.

1. Utilisez la AWS CLI commande suivante pour ajouter des éléments pglogical au shared_preload_libraries paramètre.

   aws rds modify-db-parameter-group \
      --db-parameter-group-name custom-param-group-name \
      --parameters "ParameterName=shared_preload_libraries,ParameterValue=pglogical,ApplyMethod=pending-reboot" \
      --region aws-region

2. Utilisez la AWS CLI commande suivante pour définir sur rds.logical_replication 1 afin d'activer la fonctionnalité de décodage logique pour l'. Instance de base de données RDS pour PostgreSQL.

   aws rds modify-db-parameter-group \
      --db-parameter-group-name custom-param-group-name \
      --parameters "ParameterName=rds.logical_replication,ParameterValue=1,ApplyMethod=pending-reboot" \
      --region aws-region

3. Utilisez la AWS CLI commande suivante pour redémarrer l'instance d' RDS pour PostgreSQL afin que la bibliothèque pglogical soit initialisée.

   aws rds reboot-db-instance \
       --db-instance-identifier your-instance \
       --region aws-region

4. Lorsque l'instance est disponible, utilisez psql pour vous connecter à l'instance de base de données RDS for PostgreSQL.

   psql --host=111122223333.aws-region.rds.amazonaws.com --port=5432 --username=postgres --password --dbname=labdb
   

5. Créez l'extension, comme suit.

   CREATE EXTENSION pglogical;
   EXTENSION CREATED

6. Redémarrez l' RDS pour PostgreSQL à l'aide de la commande suivante. AWS CLI

   aws rds reboot-db-instance \
       --db-instance-identifier your-instance \
       --region aws-region