Question: How can the replication frequency in PostgreSQL be adjusted?


In PostgreSQL, replication frequency refers to how often changes made in the primary database are copied to the standby or replica databases. Adjusting this frequency can be crucial for balancing between performance and data freshness. PostgreSQL provides several ways to manage replication timing, primarily through the configuration of the wal_level, archive_mode, archive_command, and the settings in the recovery.conf file (or equivalent parameters in postgresql.conf for versions after PostgreSQL 12) on the standby server.

Streaming Replication

For near real-time replication, PostgreSQL uses streaming replication. The frequency here is generally controlled by network latency and the volume of write-ahead logs (WAL) being generated. To ensure minimal lag:

  1. Increase max_wal_senders: This parameter in postgresql.conf determines the maximum number of concurrent WAL sender processes.

    max_wal_senders = 10
  2. Adjust wal_sender_timeout: Controls the maximum time to wait for WAL status updates from a standby.

    wal_sender_timeout = '30s'

These adjustments help control how quickly changes are streamed to replicas but be mindful of the load it may place on your system.

WAL File Shipping

Another approach is WAL file shipping using archive commands or third-party tools like Barman or pgBackRest. Frequency control here depends on how often WAL files are archived and sent to the standby servers:

  1. Set archive_mode to on and configure archive_command to copy completed WAL segments to a safe location.

    archive_mode = on archive_command = 'cp %p /path_to_archive/%f'
  2. Configure archive_timeout to force PostgreSQL to switch WAL files more frequently, making them available for shipping.

    archive_timeout = '300s' # Switch and archive WAL every 5 minutes

Remember to carefully balance between too frequent archiving (which can increase I/O load and decrease performance) and the risk of data loss or stale replicas.

Logical Replication

PostgreSQL also supports logical replication, which allows more granular control over what data gets replicated. However, the frequency of replication in this mode is largely controlled by the rate of changes and the system's ability to apply those changes on the subscriber side. Similar performance considerations as with streaming replication apply.


Adjusting the replication frequency in PostgreSQL involves understanding the underlying replication method used and configuring the parameters that control WAL generation and transmission. Each method offers different levels of granularity and control over replication timing, introducing a trade-off between performance and data freshness. Always test configuration changes in a staging environment to understand their impact before applying them to production systems.

Was this content helpful?

White Paper

Free System Design on AWS E-Book

Download this early release of O'Reilly's latest cloud infrastructure e-book: System Design on AWS.

Free System Design on AWS E-Book
Start building today

Dragonfly is fully compatible with the Redis ecosystem and requires no code changes to implement.