mirror of
https://github.com/supabase/supabase.git
synced 2026-07-03 08:04:21 +08:00
34022bd570
* add replication section with instructions for services * address comments and neturalise tone * formalised overview and simplified faq * reviewdog silenced (mostly) * move individual tools into tab group and reduce mention of subscriptions * fix tab components * correct postgres typos and others * removed individual service pages and added section for monitoring slots * update nav menu and add information for monitoring * update monitoring docs * added example queries for tracking replication and removed overview * added spelling rules for Xmin and cleaned up CDC format * edits & reorganization --------- Co-authored-by: Charis Lam <26616127+charislam@users.noreply.github.com>
63 lines
2.0 KiB
Plaintext
63 lines
2.0 KiB
Plaintext
---
|
|
title: 'Replicate to another Postgres database using Logical Replication'
|
|
description: 'Example to setup logical replication using publish-subscribe to a Postgres database outside of Supabase'
|
|
footerHelpType: 'postgres'
|
|
---
|
|
|
|
For this example, you will need:
|
|
|
|
- A Supabase project
|
|
- A Postgres database (running v10 or newer)
|
|
|
|
You will be running commands on both of these databases to publish changes from the Supabase database to the external database.
|
|
|
|
1. Create a `publication` on the **Supabase database**:
|
|
|
|
```sql
|
|
CREATE PUBLICATION example_pub;
|
|
```
|
|
|
|
2. Also on the **Supabase database**, create a `replication slot`:
|
|
|
|
```sql
|
|
select pg_create_logical_replication_slot('example_slot', 'pgoutput');
|
|
```
|
|
|
|
3. Now we will connect to our **external database** and subscribe to our `publication` Note: ):
|
|
|
|
<Admonition type="note">
|
|
|
|
This will need a **direct** connection (not a Connection Pooler) to your database and you can find the connection info in the [Dashboard](https://supabase.com/dashboard/project/_/settings/database).
|
|
|
|
You will also need to ensure that IPv6 is supported by your replication destination (or you can enable the [IPv4 add-on](/guides/platform/ipv4-address))
|
|
|
|
If you would prefer not to use the `postgres` user, then you can run `CREATE ROLE <user> WITH REPLICATION;` using the `postgres` user.
|
|
|
|
</Admonition>
|
|
|
|
```sql
|
|
CREATE SUBSCRIPTION example_sub
|
|
CONNECTION 'host=db.oaguxblfdassqxvvwtfe.supabase.co user=postgres password=YOUR_PASS dbname=postgres'
|
|
PUBLICATION example_pub
|
|
WITH (copy_data = true, create_slot=false, slot_name=example_slot);
|
|
```
|
|
|
|
<Admonition type="note">
|
|
|
|
`create_slot` is set to `false` because `slot_name` is provided and the slot was already created in Step 2.
|
|
To copy data from before the slot was created, set `copy_data` to `true`.
|
|
|
|
</Admonition>
|
|
|
|
4. Add all the tables that you want replicated to the publication.
|
|
|
|
```sql
|
|
ALTER PUBLICATION example_pub ADD TABLE example_table;
|
|
```
|
|
|
|
5. Check the replication status using `pg_stat_replication`
|
|
|
|
```sql
|
|
select * from pg_stat_replication;
|
|
```
|