dev/v3.0/v2.1: add large binlog operation FAQ (new) (#1441)

pingcap · Aug 9, 2019 · 9ff78a3 · 9ff78a3
1 parent db9a491
commit 9ff78a3
Show file tree

Hide file tree

Showing 3 changed files with 21 additions and 0 deletions.
diff --git a/dev/reference/tools/tidb-binlog/reparo.md b/dev/reference/tools/tidb-binlog/reparo.md
@@ -44,6 +44,8 @@ Usage of Reparo:
     Specifies the time point of finishing the recovery process.
     Format: "2006-01-02 15:04:05"
     If it is not set, the recovery process ends up with the last binlog file.
+-safe-mode bool
+    Specifies whether to enable safe mode. When enabled, it supports repeated replication.
 ```
 
 ### Description of the configuration file
@@ -81,6 +83,11 @@ log-level = "info"
 # If it is set to "mysql", you need to configure `host`, `port`, `user` and `password` in [dest-db].
 dest-type = "mysql"
 
+# Safe-mode configuration
+# Value: "true"/"false" ("false" by default)
+# If it is set to "true", Reparo splits the `UPDATE` statement into a `DELETE` statement plus a `REPLACE` statement.
+safe-mode = false
+
 # `replicate-do-db` and `replicate-do-table` specify the database and table to be recovered.
 # `replicate-do-db` has priority over `replicate-do-table`.
 # You can use a regular expression for configuration. The regular expression should start with "~".

diff --git a/v2.1/reference/tools/tidb-binlog/reparo.md b/v2.1/reference/tools/tidb-binlog/reparo.md
@@ -44,6 +44,8 @@ Usage of Reparo:
     Specifies the time point of finishing the recovery process.
     Format: "2006-01-02 15:04:05"
     If it is not set, the recovery process ends up with the last binlog file.
+-safe-mode bool
+    Specifies whether to enable safe mode. When enabled, it supports repeated replication.
 ```
 
 ### Description of the configuration file
@@ -81,6 +83,11 @@ log-level = "info"
 # If it is set to "mysql", you need to configure `host`, `port`, `user` and `password` in [dest-db].
 dest-type = "mysql"
 
+# Safe-mode configuration
+# Value: "true"/"false" ("false" by default)
+# If it is set to "true", Reparo splits the `UPDATE` statement into a `DELETE` statement plus a `REPLACE` statement.
+safe-mode = false
+
 # `replicate-do-db` and `replicate-do-table` specify the database and table to be recovered.
 # `replicate-do-db` has priority over `replicate-do-table`.
 # You can use a regular expression for configuration. The regular expression should start with "~".

diff --git a/v3.0/reference/tools/tidb-binlog/reparo.md b/v3.0/reference/tools/tidb-binlog/reparo.md
@@ -45,6 +45,8 @@ Usage of Reparo:
     Specifies the time point of finishing the recovery process.
     Format: "2006-01-02 15:04:05"
     If it is not set, the recovery process ends up with the last binlog file.
+-safe-mode bool
+    Specifies whether to enable safe mode. When enabled, it supports repeated replication.
 ```
 
 ### Description of the configuration file
@@ -82,6 +84,11 @@ log-level = "info"
 # If it is set to "mysql", you need to configure `host`, `port`, `user` and `password` in [dest-db].
 dest-type = "mysql"
 
+# Safe-mode configuration
+# Value: "true"/"false" ("false" by default)
+# If it is set to "true", Reparo splits the `UPDATE` statement into a `DELETE` statement plus a `REPLACE` statement.
+safe-mode = false
+
 # `replicate-do-db` and `replicate-do-table` specify the database and table to be recovered.
 # `replicate-do-db` has priority over `replicate-do-table`.
 # You can use a regular expression for configuration. The regular expression should start with "~".