Chapter 29. Logical Replication

Table of Contents

29.1. Publication
29.2. Subscription
29.2.1. Replication Slot Management
29.2.2. Examples: Set Up Logical Replication
29.2.3. Examples: Deferred Replication Slot Creation
29.3. Logical Replication Failover
29.4. Row Filters
29.4.1. Row Filter Rules
29.4.2. Expression Restrictions
29.4.3. UPDATE Transformations
29.4.4. Partitioned Tables
29.4.5. Initial Data Synchronization
29.4.6. Combining Multiple Row Filters
29.4.7. Examples
29.5. Column Lists
29.5.1. Examples
29.6. Conflicts
29.7. Restrictions
29.8. Architecture
29.8.1. Initial Snapshot
29.9. Monitoring
29.10. Security
29.11. Configuration Settings
29.11.1. Publishers
29.11.2. Subscribers
29.12. Quick Setup

Logical replication is a method of replicating data objects and their changes, based upon their replication identity (usually a primary key). We use the term logical in contrast to physical replication, which uses exact block addresses and byte-by-byte replication. PostgreSQL supports both mechanisms concurrently, see Chapter 26. Logical replication allows fine-grained control over both data replication and security.

Logical replication uses a publish and subscribe model with one or more subscribers subscribing to one or more publications on a publisher node. Subscribers pull data from the publications they subscribe to and may subsequently re-publish data to allow cascading replication or more complex configurations.

Logical replication of a table typically starts with taking a snapshot of the data on the publisher database and copying that to the subscriber. Once that is done, the changes on the publisher are sent to the subscriber as they occur in real-time. The subscriber applies the data in the same order as the publisher so that transactional consistency is guaranteed for publications within a single subscription. This method of data replication is sometimes referred to as transactional replication.

The typical use-cases for logical replication are:

The subscriber database behaves in the same way as any other PostgreSQL instance and can be used as a publisher for other databases by defining its own publications. When the subscriber is treated as read-only by application, there will be no conflicts from a single subscription. On the other hand, if there are other writes done either by an application or by other subscribers to the same set of tables, conflicts can arise.