From c3bbd68b76ed2a9a800dde841d90ac03228b0c80 Mon Sep 17 00:00:00 2001 From: Luca Scannapieco Date: Thu, 14 Mar 2024 09:53:09 +0100 Subject: [PATCH] [docs] Clearify incremental snapshot procedure for Oracle --- documentation/modules/ROOT/pages/connectors/oracle.adoc | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/documentation/modules/ROOT/pages/connectors/oracle.adoc b/documentation/modules/ROOT/pages/connectors/oracle.adoc index 413bf3b54..5b69f537a 100644 --- a/documentation/modules/ROOT/pages/connectors/oracle.adoc +++ b/documentation/modules/ROOT/pages/connectors/oracle.adoc @@ -269,12 +269,11 @@ For information about capturing data from a new table that has undergone structu 2. Remove the internal database schema history topic that is specified by the xref:{context}-property-database-history-kafka-topic[`schema.history.internal.kafka.topic property`]. 3. In the connector configuration: .. Set the xref:{context}-property-snapshot-mode[`snapshot.mode`] to `schema_only_recovery`. -.. Set the value of xref:{context}-property-database-history-store-only-captured-tables-ddl[`schema.history.internal.store.only.captured.tables.ddl`] to `false`. +.. (Optional) Set the value of xref:{context}-property-database-history-store-only-captured-tables-ddl[`schema.history.internal.store.only.captured.tables.ddl`] to `false`. This guarantees that in the future, the connector can reconstruct the schema history for all tables. .. Add the tables that you want the connector to capture to `table.include.list`. -This guarantees that in the future, the connector can reconstruct the schema history for all tables. 4. Restart the connector. The snapshot recovery process rebuilds the schema history based on the current structure of the tables. -5. (Optional) After the snapshot completes, initiate an xref:debezium-oracle-incremental-snapshots[incremental snapshot] to capture existing data for newly added tables along with changes to other tables that occurred while that connector was off-line. +5. (Optional) After the snapshot completes, initiate an xref:debezium-oracle-incremental-snapshots[incremental snapshot] on the newly added tables. In this way, the connector will stream the historical data of the newly added tables and it will resume reading the changes related to the previously configured tables from the redo and archive logs, including changes that occurred while that connector was off-line. 6. (Optional) Reset the `snapshot.mode` back to `schema_only` to prevent the connector from initiating recovery after a future restart. // Type: procedure