Utilisation de la réplication logique PostgreSQL avec les clusters de bases de données multi-AZ - Amazon Relational Database Service

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.

Utilisation de la réplication logique PostgreSQL avec les clusters de bases de données multi-AZ

En utilisant la réplication logique PostgreSQL avec votre cluster de bases de données multi-AZ, vous pouvez répliquer et synchroniser des tables individuelles plutôt que l'ensemble de l'instance de base de données. La réplication logique s'appuie sur un modèle publier et s'abonner pour répliquer les modifications depuis la source vers un ou plusieurs destinataires. Elle s'appuie sur les enregistrements de modification depuis le journal d'écriture anticipée (WAL) de PostgreSQL. Pour de plus amples informations, veuillez consulter Réplication logique pour Amazon RDS for PostgreSQL.

Lorsque vous créez un nouvel emplacement de réplication logique sur l'instance de base de données d'enregistreur d'un cluster de bases de données multi-AZ, l'emplacement est copié de manière asynchrone sur chaque instance de base de données de lecteur dans le cluster. Les emplacements sur les instances de base de données de lecteur sont synchronisés en continu avec ceux figurant sur l'instance de base de données d'enregistreur.

La réplication logique est prise en charge pour les clusters de bases de données multi-AZ exécutant RDS for PostgreSQL version 14.8-R2 ou ultérieure, et version 15.3-R2 ou ultérieure.

Note

Outre la fonctionnalité de réplication logique PostgreSQL native, les clusters de bases de données multi-AZ exécutant RDS for PostgreSQL prennent également en charge l'extension pglogical.

Pour plus d'informations sur la réplication logique PostgreSQL, consultez Réplication logique (langue française non garantie) dans la documentation PostgreSQL.

Prérequis

Pour configurer la réplication logique PostgreSQL pour les clusters de bases de données multi-AZ, vous devez remplir les conditions préalables suivantes.

Configuration de la réplication logique

Pour configurer la réplication logique pour un cluster de bases de données multi-AZ, vous devez activer des paramètres spécifiques dans le groupe de paramètres de cluster de bases de données associé, puis créer des emplacements de réplication logique.

Note

À partir de la version 16 de PostgreSQL, vous pouvez utiliser les instances de base de données de lecture du cluster de base de données multi-AZ pour la réplication logique.

Pour configurer la réplication logique pour un cluster de bases de données multi-AZ RDS for PostgreSQL
  1. Ouvrez le groupe de paramètres de cluster de bases de données personnalisé associé à votre cluster de bases de données multi-AZ RDS for PostgreSQL.

  2. Dans le champ de recherche Paramètres, localisez le paramètre statique rds.logical_replication et définissez sa valeur sur 1. Cette modification de paramètre peut augmenter la génération WAL. Vous devez donc l'activer uniquement lorsque vous utilisez des emplacements logiques.

  3. Dans le cadre de cette modification, configurez les paramètres de cluster de bases de données suivants.

    • max_wal_senders

    • max_replication_slots

    • max_connections

    En fonction de votre utilisation prévue, vous devrez peut-être également modifier les valeurs des paramètres suivants. Toutefois, dans de nombreux cas, les valeurs par défaut sont suffisantes.

    • max_logical_replication_workers

    • max_sync_workers_per_subscription

  4. Redémarrez le cluster de bases de données multi-AZ pour que les valeurs des paramètres prennent effet. Pour obtenir des instructions, veuillez consulter Redémarrage d'un cluster de base de données multi-AZ et des instances de base de données de lecteur.

  5. Créez un emplacement de réplication logique sur l'instance de base de données d'enregistreur du cluster de bases de données multi-AZ, comme cela est expliqué dans Utilisation des emplacements de réplication logique. Cela nécessite que vous précisiez un plugin de décodage. Actuellement, RDS for PostgreSQL prend en charge les plug-ins test_decodingwal2json et pgoutput fournis avec PostgreSQL.

    L'emplacement est copié de manière asynchrone sur chaque instance de base de données de lecteur dans le cluster.

  6. Vérifiez l'état de l'emplacement sur toutes les instances de base de données de lecteur du cluster de bases de données multi-AZ. Pour ce faire, inspectez la vue pg_replication_slots sur toutes les instances de base de données de lecteur et assurez-vous que l'état confirmed_flush_lsn progresse alors que l'application consomme activement des modifications logiques.

    Les commandes suivantes montrent comment inspecter l'état de réplication sur les instances de base de données de lecteur.

    % psql -h test-postgres-instance-2.abcdefabcdef.us-west-2.rds.amazonaws.com postgres=> select slot_name, slot_type, confirmed_flush_lsn from pg_replication_slots; slot_name | slot_type | confirmed_flush_lsn --------------+-----------+--------------------- logical_slot | logical | 32/D0001700 (1 row) postgres=> select slot_name, slot_type, confirmed_flush_lsn from pg_replication_slots; slot_name | slot_type | confirmed_flush_lsn --------------+-----------+--------------------- logical_slot | logical | 32/D8003628 (1 row) % psql -h test-postgres-instance-3.abcdefabcdef.us-west-2.rds.amazonaws.com postgres=> select slot_name, slot_type, confirmed_flush_lsn from pg_replication_slots; slot_name | slot_type | confirmed_flush_lsn --------------+-----------+--------------------- logical_slot | logical | 32/D0001700 (1 row) postgres=> select slot_name, slot_type, confirmed_flush_lsn from pg_replication_slots; slot_name | slot_type | confirmed_flush_lsn --------------+-----------+--------------------- logical_slot | logical | 32/D8003628 (1 row)

Une fois que vous avez terminé vos tâches de réplication, arrêtez le processus de réplication, supprimez les emplacements de réplication et désactivez la réplication logique. Pour désactiver la réplication logique, modifiez le groupe de paramètres de votre cluster de bases de données et réaffectez à rds.logical_replication la valeur 0. Redémarrez le cluster pour que la modification des paramètres prenne effet.

Limitations et recommandations

Les limites et recommandations suivantes s'appliquent à l'utilisation de la réplication logique avec des clusters de bases de données multi-AZ exécutant PostgreSQL version 16 :

  • Vous ne pouvez utiliser que des instances de base de données Writer pour créer ou supprimer des emplacements de réplication logiques. Par exemple, la CREATE SUBSCRIPTION commande doit utiliser le point de terminaison du rédacteur du cluster dans la chaîne de connexion de l'hôte.

  • Vous devez utiliser le point de terminaison du rédacteur de cluster lors de toute synchronisation ou resynchronisation de tables. Par exemple, vous pouvez utiliser les commandes suivantes pour resynchroniser une table récemment ajoutée :

    Postgres=>ALTER SUBSCRIPTION subscription-name CONNECTION host=writer-endpoint Postgres=>ALTER SUBSCRIPTION subscription-name REFRESH PUBLICATION
  • Vous devez attendre que la synchronisation des tables soit terminée avant d'utiliser les instances de base de données du lecteur pour la réplication logique. Vous pouvez utiliser la table du pg_subscription_rel catalogue pour surveiller la synchronisation des tables. La synchronisation des tables est terminée lorsque la srsubstate colonne est définie sur ready (r).

  • Nous recommandons d'utiliser des points de terminaison d'instance pour la connexion de réplication logique une fois la synchronisation initiale des tables terminée. La commande suivante réduit la charge sur l'instance de base de données du rédacteur en transférant la réplication vers l'une des instances de base de données du lecteur :

    Postgres=>ALTER SUBSCRITPION subscription-name CONNECTION host=reader-instance-endpoint

    Vous ne pouvez pas utiliser le même emplacement sur plusieurs instances de base de données à la fois. Lorsque deux applications ou plus répliquent des modifications logiques provenant de différentes instances de base de données du cluster, certaines modifications peuvent être perdues en raison d'un basculement du cluster ou d'un problème réseau. Dans ces situations, vous pouvez utiliser les points de terminaison de l'instance pour la réplication logique dans la chaîne de connexion hôte. L'autre application utilisant la même configuration affichera le message d'erreur suivant :

    replication slot slot_name is already active for PID x providing immediate feedback.
  • Les clusters de base de données multi-AZ exécutant PostgreSQL version 16.1 ne peuvent pas réactiver les emplacements de réplication logique perdus sur une instance de base de données. Une cause courante est le basculement initié par l'failover-db-clusterAPI ou les événements liés à l'infrastructure.

  • Lorsque vous utilisez l'pglogicalextension, vous ne pouvez utiliser que le point de terminaison du rédacteur de cluster. L'extension présente des limites connues qui peuvent créer des emplacements de réplication logiques inutilisés lors de la synchronisation des tables. Les emplacements de réplication périmés réservent les fichiers journaux d'écriture anticipée (WAL) et peuvent entraîner des problèmes d'espace disque.