Skip to content

Commit 4dcaa26

Browse files
authored
Add descriptions of load schema snapshot (#19835) (#19875)
1 parent 80f323d commit 4dcaa26

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

tidb-binlog/tidb-binlog-configuration-file.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -305,6 +305,14 @@ If the safe mode is enabled, Drainer modifies the replication updates in the fol
305305

306306
Default value: `false`
307307

308+
#### load-schema-snapshot
309+
310+
- Specifies how Drainer loads table information.
311+
- When you set it to `false`, Drainer replays all DDL operations from history to derive the table schema for each table at a specific schema version. This approach requires processing all DDL changes from the initial state to the target schema version, which might involve significant data processing and replaying.
312+
- When you set it to `true`, Drainer directly reads the table information at the checkpoint TS. Becasue it directly reads the table information at a specific point in time, this method is usually more efficient. However, it is subject to the GC mechanism, because GC might delete older data versions. If the checkpoint TS is too old, the corresponding table information might have been deleted by GC, making it impossible to read directly.
313+
- When configuring Drainer, choose whether to read the table information at the checkpoint TS based on actual needs. If data integrity and consistency are priorities and handling a large number of DDL changes is acceptable, it is recommended to set it to `false`. If efficiency and performance are more important, and the checkpoint TS is guaranteed to be after the GC safe point, it is recommended to set it to `true`.
314+
- Default value: `false`
315+
308316
### syncer.to
309317

310318
The `syncer.to` section introduces different types of downstream configuration items according to configuration types.
@@ -349,4 +357,4 @@ When the downstream is Kafka, the valid configuration items are as follows:
349357
* `host`
350358
* `user`
351359
* `password`
352-
* `port`
360+
* `port`

0 commit comments

Comments
 (0)