From c1f33f9cb3fac48ce934b481c95a06cccc8c1d1f Mon Sep 17 00:00:00 2001 From: Arunprasad Rajkumar Date: Mon, 15 Dec 2025 19:00:45 +0530 Subject: [PATCH 1/3] Bump live-sync to v0.4.0 and document new flags Signed-off-by: Arunprasad Rajkumar --- _partials/_livesync-terminal.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/_partials/_livesync-terminal.md b/_partials/_livesync-terminal.md index a0aaf95edf..37a0b0eeaf 100644 --- a/_partials/_livesync-terminal.md +++ b/_partials/_livesync-terminal.md @@ -175,7 +175,7 @@ instance to a $SERVICE_LONG: As you run the $PG_CONNECTOR continuously, best practice is to run it as a Docker daemon. ```shell - docker run -d --rm --name livesync timescale/live-sync:v0.3.3 run \ + docker run -d --rm --name livesync timescale/live-sync:v0.4.0 run \ --publication --subscription \ --source $SOURCE --target $TARGET --table-map ``` @@ -191,6 +191,11 @@ instance to a $SERVICE_LONG: `--table-map`: (Optional) A JSON string that maps source tables to target tables. If not provided, the source and target table names are assumed to be the same. For example, to map the source table `metrics` to the target table `metrics_data`: + `--table-sync-workers`: (Optional) The number of parallel workers to use for initial table sync. Default is 4. + + `--copy-data`: (Optional) If specified, the initial table data is copied from source to target before starting logical replication. If not specified, only changes after the replication slot creation are replicated. Default is true. + Useful to dry-run the tool without copying data by setting it to false. + ``` --table-map '{"source": {"schema": "public", "table": "metrics"}, "target": {"schema": "public", "table": "metrics_data"}}' ``` @@ -325,7 +330,7 @@ EOF Use the `--drop` flag to remove the replication slots created by the $PG_CONNECTOR on the source database. ```shell - docker run -it --rm --name livesync timescale/live-sync:v0.3.3 run \ + docker run -it --rm --name livesync timescale/live-sync:v0.4.0 run \ --publication --subscription \ --source $SOURCE --target $TARGET \ --drop From a4898ff8a8c788883463829fadf0c78fee0b3444 Mon Sep 17 00:00:00 2001 From: Arunprasad Rajkumar Date: Mon, 15 Dec 2025 19:18:02 +0530 Subject: [PATCH 2/3] Update _partials/_livesync-terminal.md Co-authored-by: Iain Cox Signed-off-by: Arunprasad Rajkumar --- _partials/_livesync-terminal.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_partials/_livesync-terminal.md b/_partials/_livesync-terminal.md index 37a0b0eeaf..8d5e1c9052 100644 --- a/_partials/_livesync-terminal.md +++ b/_partials/_livesync-terminal.md @@ -193,7 +193,7 @@ instance to a $SERVICE_LONG: `--table-sync-workers`: (Optional) The number of parallel workers to use for initial table sync. Default is 4. - `--copy-data`: (Optional) If specified, the initial table data is copied from source to target before starting logical replication. If not specified, only changes after the replication slot creation are replicated. Default is true. + `--copy-data`: (Optional) By default, the initial table data is copied from source to target before starting logical replication. Set to `false` so only changes made after replication slot creation are replicated. Useful to dry-run the tool without copying data by setting it to false. ``` From 69f1e77e9e6920b06366aaebb73320c8d76f6a66 Mon Sep 17 00:00:00 2001 From: Arunprasad Rajkumar Date: Mon, 15 Dec 2025 19:18:09 +0530 Subject: [PATCH 3/3] Update _partials/_livesync-terminal.md Co-authored-by: Iain Cox Signed-off-by: Arunprasad Rajkumar --- _partials/_livesync-terminal.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_partials/_livesync-terminal.md b/_partials/_livesync-terminal.md index 8d5e1c9052..ef199d46b6 100644 --- a/_partials/_livesync-terminal.md +++ b/_partials/_livesync-terminal.md @@ -194,7 +194,7 @@ instance to a $SERVICE_LONG: `--table-sync-workers`: (Optional) The number of parallel workers to use for initial table sync. Default is 4. `--copy-data`: (Optional) By default, the initial table data is copied from source to target before starting logical replication. Set to `false` so only changes made after replication slot creation are replicated. - Useful to dry-run the tool without copying data by setting it to false. + Best practice is to set to `false` during dry-run livesync so you do not copy table data. ``` --table-map '{"source": {"schema": "public", "table": "metrics"}, "target": {"schema": "public", "table": "metrics_data"}}'