From 97c4ccbd5295ac745deabdeaf3d797ee90ebba14 Mon Sep 17 00:00:00 2001 From: Roman Kudryashov Date: Mon, 19 Aug 2024 14:04:49 +0300 Subject: [PATCH] DBZ-8156 Add docs for `no_tables` config option for `publication.autocreate.mode` --- .../ROOT/pages/connectors/postgresql.adoc | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/documentation/modules/ROOT/pages/connectors/postgresql.adoc b/documentation/modules/ROOT/pages/connectors/postgresql.adoc index 88a42bfc5..ed352d38b 100644 --- a/documentation/modules/ROOT/pages/connectors/postgresql.adoc +++ b/documentation/modules/ROOT/pages/connectors/postgresql.adoc @@ -3224,11 +3224,17 @@ You grant the required permission by using the following SQL command `CREATE PUB A database administrator or the user configured to perform replications must have created the publication before running the connector. If the connector cannot find the publication, the connector throws an exception and stops. + + -`filtered` - If a publication exists, the connector uses it. -If no publication exists, the connector creates a new publication for tables that match the current filter configuration as specified by the `schema.include.list`, `schema.exclude.list`, and `table.include.list`, and `table.exclude.list` connector configuration properties. -For example: `CREATE PUBLICATION FOR TABLE `. -If the publication exists, the connector updates the publication for tables that match the current filter configuration. -For example: `ALTER PUBLICATION SET TABLE `. +`filtered` - If a publication does not exist, the connector creates one by running a SQL command in the following format: `CREATE PUBLICATION FOR TABLE `. + + +The resulting publication includes tables that match the current filter configuration, as specified by the `schema.include.list`, `schema.exclude.list`, `table.include.list`, and `table.exclude.list` connector configuration properties. + +If the publication exists, the connector updates the publication for tables that match the current filter configuration by running a SQL command in the following format: `ALTER PUBLICATION SET TABLE `. + + + +`no_tables` - If a publication exists, the connector uses it. +If a publication does not exist, the connector creates a publication without specifying any table by running a SQL command in the following format: `CREATE PUBLICATION ;`. + +Set the `no_tables` option if you want the connector to capture only logical decoding messages, and not capture any other change events, such as those caused by `INSERT`, `UPDATE`, and `DELETE` operations on any table. +If you select this option, to prevent the connector from emitting and processing `READ` events, you can specify names of schemas or tables for which you do not want to capture changes, for example, by using `"table.exclude.list": "public.*"` or `"schema.exclude.list": "public"`. |[[postgresql-replica-autoset-type]]<> |_empty string_