Configurer une base de données PostgreSQL Amazon RDS

La page suivante explique comment configurer la CDC pour une base de données Amazon RDS pour PostgreSQL.

Créer un groupe de paramètres

1. Lancez votre tableau de bord Amazon RDS.

2. Dans le panneau de navigation, cliquez sur Groupes de paramètres, puis sur Créer un groupe de paramètres. La page Créer un groupe de paramètres s'affiche.

3. Sélectionnez la famille de base de données qui correspond à votre base de données, saisissez un nom et une description pour le groupe de paramètres, puis cliquez sur Créer.

4. Cochez la case à gauche du groupe de paramètres que vous venez de créer, puis cliquez sur Modifier sous Actions associées au groupe de paramètres.

5. Définissez le paramètre suivant pour votre groupe.

   Paramètres	Valeur
   logical_replication	1

6. Cliquez sur Save Changes (Enregistrer les modifications).

   Pour PostgreSQL 13 et versions ultérieures, nous vous recommandons également de définir le paramètre max_slot_wal_keep_size dans le fichier postgresql.conf afin de limiter l'espace de stockage utilisé par les emplacements de réplication. Pour en savoir plus, consultez Utiliser les fichiers journaux WAL de la base de données PostgreSQL.

Configurer la base de données source

1. Lancez votre tableau de bord Amazon RDS.

2. Dans le panneau de navigation, cliquez sur Bases de données.

3. Sélectionnez votre source, puis cliquez sur Modifier.

4. Accédez à la section Configuration supplémentaire.

5. Sélectionnez le groupe de paramètres que vous avez créé.

6. Cliquez sur Continuer.

7. Sous Planification des modifications, sélectionnez Appliquer immédiatement.

   Comme vous avez modifié votre source, vous devez attendre que les modifications apportées à votre groupe de paramètres soient appliquées avant de continuer.

Vérifier que le groupe de paramètres est attribué à l'instance de base de données

1. Lancez votre tableau de bord Amazon RDS.

2. Dans le panneau de navigation, cliquez sur Bases de données, puis sélectionnez votre instance de base de données.

3. Cliquez sur l'onglet Configurations.

4. Vérifiez que le groupe de paramètres que vous avez créé s'affiche et que son état correspond à pending-reboot (redémarrage en attente).

5. Redémarrez votre instance de base de données pour terminer la configuration. Pour redémarrer l'instance :

   1. Dans le panneau de navigation, cliquez sur Instances.
   2. Sélectionnez votre instance de base de données.
   3. Dans le menu Actions associées à l'instance, sélectionnez Redémarrer.
   Une fois votre instance de base de données redémarrée, son état passe à in-sync (en cours de synchronisation).

Créer une publication et un emplacement de réplication

1. Créez une publication. Nous vous recommandons de créer une publication uniquement pour les tables que vous souhaitez répliquer. Cela permet à Datastream de lire uniquement les données pertinentes, et de réduire la charge sur la base de données et Datastream:

   CREATE PUBLICATION PUBLICATION_NAME
   FOR TABLE SCHEMA1.TABLE1, SCHEMA2.TABLE2;

   Remplacez les éléments suivants :

   • PUBLICATION_NAME: nom de votre publication. Vous devrez fournir ce nom lorsque vous créerez un flux dans l'assistant de création de flux Datastream.
   • SCHEMA: nom du schéma contenant la table.
   • TABLE: nom de la table que vous souhaitez répliquer.

   Vous pouvez créer une publication pour toutes les tables d'un schéma. Cette approche vous permet de répliquer les modifications apportées aux tables de la liste de schémas spécifiée, y compris aux tables que vous créerez par la suite:

   CREATE PUBLICATION PUBLICATION_NAME
   FOR TABLES IN SCHEMA1, SCHEMA2;

   Vous pouvez également créer une publication pour toutes les tables de votre base de données. Notez que cette approche augmente la charge sur la base de données source et sur Datastream:

   CREATE PUBLICATION PUBLICATION_NAME FOR ALL TABLES;
   

2. Créez un emplacement de réplication en saisissant la commande PostgreSQL suivante:

   SELECT PG_CREATE_LOGICAL_REPLICATION_SLOT('REPLICATION_SLOT_NAME', 'pgoutput'); 

   Remplacez les éléments suivants :

   • REPLICATION_SLOT_NAME: nom de votre emplacement de réplication. Vous devrez fournir ce nom lorsque vous créerez un flux dans l'assistant de création de flux Datastream.
   L'emplacement de réplication doit être unique pour chaque flux en cours de réplication à partir de cette base de données.

Créer un utilisateur Datastream

1. Pour créer un utilisateur Datastream, saisissez la commande PostgreSQL suivante :

   CREATE USER USER_NAME WITH ENCRYPTED PASSWORD 'USER_PASSWORD';
   

   Remplacez les éléments suivants :

   • USER_NAME: nom de l'utilisateur Datastream que vous souhaitez créer.
   • USER_PASSWORD: mot de passe de connexion de l'utilisateur Datastream que vous souhaitez créer.

2. Accordez les droits suivants à l'utilisateur que vous avez créé :

   GRANT RDS_REPLICATION TO USER_NAME;
   GRANT SELECT ON ALL TABLES IN SCHEMA SCHEMA_NAME TO USER_NAME;
   GRANT USAGE ON SCHEMA SCHEMA_NAME TO USER;
   ALTER DEFAULT PRIVILEGES IN SCHEMA SCHEMA_NAME
     GRANT SELECT ON TABLES TO USER_NAME;
   

   Remplacez les éléments suivants :

   • USER_NAME: utilisateur auquel vous souhaitez accorder les droits
   • SCHEMA_NAME: nom du schéma auquel vous souhaitez accorder les droits.