Initialisation de la capacité d'extension pgactive

Pour initialiser la capacité d'extension pgactive sur votre instance de base de données RDS for PostgreSQL, définissez la valeur du paramètre rds.enable_pgactive sur 1, puis créez l'extension dans la base de données. Les paramètres rds.logical_replication et track_commit_timestamp sont alors automatiquement activés et la valeur de wal_level est définie sur logical.

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

Vous pouvez utiliser la AWS Management Console ou l'interface AWS CLI pour créer les instances de base de données RDS for PostgreSQL nécessaires. Les étapes suivantes partent du principe que votre instance de base de données RDS for PostgreSQL est associée à un groupe de paramètres de base de données personnalisés. Pour obtenir des informations sur la création d'un groupe de paramètres de base de données personnalisé, consultez Groupes de paramètres pour Amazon RDS.

console

Pour initialiser la capacité d'extension pgactive

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

2. Dans le volet de navigation, sélectionnez votre instance de base de données RDS for PostgreSQL.

3. Ouvrez l'onglet Configuration pour votre instance de base de données RDS for PostgreSQL. Dans les détails de l'instance, recherchez le lien Groupe de paramètres d'instance de base de données.

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

5. Recherchez le paramètre rds.enable_pgactive et définissez-le sur 1 pour initialiser la fonctionnalité pgactive.

6. Sélectionnez Enregistrer les modifications.

7. Dans le panneau de navigation de la console Amazon RDS, sélectionnez Bases de données.

8. Sélectionnez votre instance de base de données RDS for PostgreSQL, puis choisissez Redémarrer dans le menu Actions.

9. Confirmez le redémarrage de l'instance de base de données pour que vos modifications prennent effet.

10. Une fois l'instance de base de données disponible, vous pouvez utiliser psql ou tout autre client PostgreSQL pour vous connecter à l'instance de base de données RDS for PostgreSQL.

    L'exemple suivant part du principe que votre instance de base de données RDS for PostgreSQL possède une base de données par défaut nommée postgres.

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

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

    postgres=>SELECT setting ~ 'pgactive' 
    FROM pg_catalog.pg_settings
    WHERE name = 'shared_preload_libraries';

    Si pgactive se trouve dans shared_preload_libraries, la commande précédente renvoie ceci :

    
    ?column? 
    ----------
     t

AWS CLI

Pour initialiser la capacité d'extension pgactive

Pour initialiser pgactive à l'aide de l'interface AWS CLI, appelez l'opération modify-db-parameter-group pour modifier certains paramètres dans votre groupe de paramètres personnalisés, comme indiqué dans la procédure suivante.

1. Utilisez la commande AWS CLI suivante pour définir rds.enable_pgactive sur 1 afin d'initialiser la fonctionnalité pgactive pour l'instance de base de données RDS pour PostgreSQL.

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

2. Utilisez la commande AWS CLI ci-dessous pour redémarrer l'instance de base de données RDS for PostgreSQL de sorte que la bibliothèque pgactive s'initialise.

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

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

   psql --host=mydb.111122223333.aws-region.rds.amazonaws.com --port=5432 --username=master user --password=PASSWORD --dbname=postgres
   

4. Pour vérifier que pgactive est initialisé, exécutez la commande suivante.

   postgres=>SELECT setting ~ 'pgactive' 
   FROM pg_catalog.pg_settings
   WHERE name = 'shared_preload_libraries';

   Si pgactive se trouve dans shared_preload_libraries, la commande précédente renvoie ceci :

   
   ?column? 
   ----------
    t