Documentation Index
Fetch the complete documentation index at: https://www.integrate.io/docs/llms.txt
Use this file to discover all available pages before exploring further.
| Description | The World’s Most Advanced Open Source Relational Database |
|---|---|
| Type | Write-ahead log (WAL) Replication |
| Supported Replication | Initial Sync Continuous Sync |
| Authentication Type | Password Authentication |
Setting up PostgreSQL CDC for ELT & CDC
ELT & CDC uses WAL based logical replication -pgoutputdecoding for PostgreSQL database source and requires a user with LOGIN and REPLICATION role. It also requires the user to have CREATE permission on the schema and database to be synced.
Supported providers
- Amazon RDS PostgreSQL
- Amazon Aurora PostgreSQL
- Azure Single Node PostgreSQL
- Self-hosted (generic) PostgreSQL
- Google Cloud SQL for PosgreSQL
Requirements
- PostgreSQL versions 10.x or above.
- Database user with CREATE permission on the schema and database to be synced.
- Tables with PRIMARY KEY .
- Sync user should be the OWNER of the tables.
- The ownership requirement is for adding the tables to the PUBLICATION that we create in order for receiving replication events from the database. For more info, click here.
- Master instances of Postgres (log based replication only works for master instances).
Features
| Feature | Supported | Notes |
|---|---|---|
| Full (Historical) sync | Yes | |
| Incremental sync | Yes | |
| Replicate DELETE | Yes | |
| UPSERT | Yes | |
| Append only mode | Yes | Can be specified at a table level |
| Exclude tables | Yes | |
| Exclude columns | Yes | |
| SSL Support | Yes | |
| SSH tunnel | Yes | SSH Tunnel Guide |
Heartbeat
PostgreSQL uses theconfirmed_flush_lsn to determine which WAL segments can be safely removed, so if it’s not updated because the tables in your publication aren’t changing, the WAL storage can indeed grow significantly.
To ensure that the confirmed_flush_lsn advances even when there are no transactions for the selected tables, we created a heartbeat table, insert a single record and update it every 10 minutes while the pipeline is running.
Frequently Asked Questions (FAQs)
How do you handle Postgres replication slots?
How do you handle Postgres replication slots?
We create a replication slot when the initial sync starts. After the initial sync completes, we start listening for changes from it. Once a pipeline is deleted or archived by you, we try to remove the replication slot from your Postgres DB provided that we can still access it.
How do you handle large JSONB objects?
How do you handle large JSONB objects?
Large JSONB objects are mapped as
TEXT/VARCHAR/STRING columns and might be truncated (depending on destination). Note about the TOAST table - if there are tables which use the toast tables (usually tables with huge JSONB or TEXT columns) then their REPLICA IDENTITY (https://www.postgresql.org/docs/10/sql-altertable.html#SQL-CREATETABLE-REPLICA-IDENTITY) needs to be set to FULL for us to properly sync the data in case of continuous sync.