binlog: update documents for committs and passoword (#6271) (#6640)

pingcap · Jul 8, 2021 · 0d52ca9 · 0d52ca9
1 parent 9232496
commit 0d52ca9
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 4 deletions.
diff --git a/tidb-binlog/deploy-tidb-binlog.md b/tidb-binlog/deploy-tidb-binlog.md
@@ -324,9 +324,9 @@ Drainer="192.168.0.13"
         [syncer.to]
         host = "192.168.0.13"
         user = "root"
+        # 如果你不想在配置文件中写明文密码，则可以使用 `./binlogctl -cmd encrypt -text string` 生成加密的密码
+        # 如果配置了 encrypted_password 且非空，那么配置的 password 不生效。encrypted_password 和 password 无法同时生效。
         password = ""
-        # 使用 `./binlogctl -cmd encrypt -text string` 加密的密码
-        # encrypted_password 非空时 password 会被忽略
         encrypted_password = ""
         port = 3306
 

diff --git a/tidb-binlog/tidb-binlog-configuration-file.md b/tidb-binlog/tidb-binlog-configuration-file.md
@@ -171,8 +171,12 @@ title: TiDB Binlog 配置说明
 
 ### initial-commit-ts
 
-* 指定从哪个 commit timestamp 之后开始同步。这个配置仅适用于初次开始同步的 Drainer 节点。如果下游已经有 checkpoint 存在，则会根据 checkpoint 里记录的时间进行同步。
-* 默认：`-1`。Drainer 会从 PD 得到一个最新的 timestamp 作为初始时间。
+* 指定从哪个事务提交时间点（事务的 commit ts） 之后开始同步。这个配置仅适用于初次开始同步的 Drainer 节点。如果下游已经有 checkpoint 存在，则会根据 checkpoint 里记录的时间进行同步。
+* commit ts（即 commit timestamp）是 TiDB [事务](/transaction-overview.md)的提交时间点。该时间点是从 PD 获取的全局唯一递增的时间戳，作为当前事务的唯一 ID。典型的 `initial-commit-ts` 配置可以通过以下方式获得：
+    - BR 备份的元信息（即 backupmeta）中记录的 backup TS
+    - Dumpling 备份的元信息（即 metadata）中记录的 Pos
+    - PD Control 中 `tso` 命令返回的结果
+* 默认：`-1`。Drainer 会从 PD 得到一个最新的 timestamp 作为初始时间。即从当前的时间点开始同步。
 
 ### synced-check-time