From eb37631e1c1f3d2b1fa00d501e5a94b9775e7064 Mon Sep 17 00:00:00 2001 From: glkappe Date: Mon, 9 Aug 2021 16:02:11 +0800 Subject: [PATCH 1/6] update syncer.to.checkpoint info There is a problem with the `type` level. It is at the same level as the schema. Optimize the document structure to make it easier to read --- tidb-binlog/tidb-binlog-configuration-file.md | 27 +++++++++---------- 1 file changed, 12 insertions(+), 15 deletions(-) diff --git a/tidb-binlog/tidb-binlog-configuration-file.md b/tidb-binlog/tidb-binlog-configuration-file.md index 55f2d8d14d85..ea0c7c69a1bc 100644 --- a/tidb-binlog/tidb-binlog-configuration-file.md +++ b/tidb-binlog/tidb-binlog-configuration-file.md @@ -334,22 +334,19 @@ tbl-name = "~^a.*" ### syncer.to.checkpoint -以下是 `syncer.to.checkpoint` 相关的配置项。 +* `type`：指定用哪种方式保存同步进度，目前支持的选项：`mysql` 和 `tidb`。 -### type +> **注意：** +> 当 file 类型的下游 checkpoint 保存在本地文件系统 +> 当 `mysql` 或 `tidb` 类型保存同步进度时，需要指定以下配置项： -* 指定用哪种方式保存同步进度。 -* 目前支持的选项：`mysql` 和 `tidb` +* `schema`：默认为 `"tidb_binlog"`。 -* 默认：与下游类型相同。例如 `file` 类型的下游进度保存在本地文件系统，`mysql` 类型的下游进度保存在下游数据库。当明确指定要使用 `mysql` 或 `tidb` 保存同步进度时，需要指定以下配置项： + > **注意：** + > + > 在同个 TiDB 集群中部署多个 Drainer 时，需要为每个 Drainer 节点指定不同的 checkpoint schema，否则两个实例的同步进度会互相覆盖。 - * `schema`：默认为 `"tidb_binlog"`。 - - > **注意：** - > - > 在同个 TiDB 集群中部署多个 Drainer 时，需要为每个 Drainer 节点指定不同的 checkpoint schema，否则两个实例的同步进度会互相覆盖。 - - * `host` - * `user` - * `password` - * `port` +* `host` +* `user` +* `password` +* `port` From 6b6263a26cdd9764ad8038e4488db40d48b057a3 Mon Sep 17 00:00:00 2001 From: glkappe Date: Tue, 10 Aug 2021 15:04:46 +0800 Subject: [PATCH 2/6] Update tidb-binlog/tidb-binlog-configuration-file.md Co-authored-by: Chunzhu Li --- tidb-binlog/tidb-binlog-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tidb-binlog/tidb-binlog-configuration-file.md b/tidb-binlog/tidb-binlog-configuration-file.md index ea0c7c69a1bc..04ed56442b06 100644 --- a/tidb-binlog/tidb-binlog-configuration-file.md +++ b/tidb-binlog/tidb-binlog-configuration-file.md @@ -334,7 +334,7 @@ tbl-name = "~^a.*" ### syncer.to.checkpoint -* `type`：指定用哪种方式保存同步进度，目前支持的选项：`mysql` 和 `tidb`。 +* `type`：指定用哪种方式保存同步进度，目前支持的选项：`mysql`, `tidb` 和 `file`。 > **注意：** > 当 file 类型的下游 checkpoint 保存在本地文件系统 From 10fde5c0072afcc2bb4823c96d387bd971bfead5 Mon Sep 17 00:00:00 2001 From: glkappe Date: Tue, 10 Aug 2021 15:04:59 +0800 Subject: [PATCH 3/6] Update tidb-binlog/tidb-binlog-configuration-file.md Co-authored-by: Chunzhu Li --- tidb-binlog/tidb-binlog-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tidb-binlog/tidb-binlog-configuration-file.md b/tidb-binlog/tidb-binlog-configuration-file.md index 04ed56442b06..d89a3d6ae70e 100644 --- a/tidb-binlog/tidb-binlog-configuration-file.md +++ b/tidb-binlog/tidb-binlog-configuration-file.md @@ -337,7 +337,7 @@ tbl-name = "~^a.*" * `type`：指定用哪种方式保存同步进度，目前支持的选项：`mysql`, `tidb` 和 `file`。 > **注意：** -> 当 file 类型的下游 checkpoint 保存在本地文件系统 +> file 类型的下游 checkpoint 保存在 `/savepoint` 文件中 > 当 `mysql` 或 `tidb` 类型保存同步进度时，需要指定以下配置项： * `schema`：默认为 `"tidb_binlog"`。 From c000668a744b50f9aa8dbeaa7ea158525fba717e Mon Sep 17 00:00:00 2001 From: glkappe Date: Mon, 23 Aug 2021 15:28:53 +0800 Subject: [PATCH 4/6] Update tidb-binlog/tidb-binlog-configuration-file.md Co-authored-by: TomShawn <41534398+TomShawn@users.noreply.github.com> --- tidb-binlog/tidb-binlog-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tidb-binlog/tidb-binlog-configuration-file.md b/tidb-binlog/tidb-binlog-configuration-file.md index d89a3d6ae70e..ec7517003859 100644 --- a/tidb-binlog/tidb-binlog-configuration-file.md +++ b/tidb-binlog/tidb-binlog-configuration-file.md @@ -334,7 +334,7 @@ tbl-name = "~^a.*" ### syncer.to.checkpoint -* `type`：指定用哪种方式保存同步进度，目前支持的选项：`mysql`, `tidb` 和 `file`。 +* `type`：指定用哪种方式保存同步进度，目前支持的选项为 `mysql`、`tidb` 和 `file`。 > **注意：** > file 类型的下游 checkpoint 保存在 `/savepoint` 文件中 From eda725131231f8c3d0aff9bd9bd95a4e6293a76b Mon Sep 17 00:00:00 2001 From: TomShawn <41534398+TomShawn@users.noreply.github.com> Date: Mon, 30 Aug 2021 16:21:06 +0800 Subject: [PATCH 5/6] Apply suggestions from code review --- tidb-binlog/tidb-binlog-configuration-file.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/tidb-binlog/tidb-binlog-configuration-file.md b/tidb-binlog/tidb-binlog-configuration-file.md index ec7517003859..43af55325adb 100644 --- a/tidb-binlog/tidb-binlog-configuration-file.md +++ b/tidb-binlog/tidb-binlog-configuration-file.md @@ -336,15 +336,13 @@ tbl-name = "~^a.*" * `type`：指定用哪种方式保存同步进度，目前支持的选项为 `mysql`、`tidb` 和 `file`。 -> **注意：** -> file 类型的下游 checkpoint 保存在 `/savepoint` 文件中 -> 当 `mysql` 或 `tidb` 类型保存同步进度时，需要指定以下配置项： + 该配置选项默认与下游类型相同。例如 `file` 类型的下游 checkpoint 进度保存在本地文件 `/savepoint` 中，`mysql` 类型的下游进度保存在下游数据库。当明确指定要使用 `mysql` 或 `tidb` 保存同步进度时，需要指定以下配置项： * `schema`：默认为 `"tidb_binlog"`。 - > **注意：** - > - > 在同个 TiDB 集群中部署多个 Drainer 时，需要为每个 Drainer 节点指定不同的 checkpoint schema，否则两个实例的同步进度会互相覆盖。 + > **注意：** + > + > 在同个 TiDB 集群中部署多个 Drainer 时，需要为每个 Drainer 节点指定不同的 checkpoint schema，否则两个实例的同步进度会互相覆盖。 * `host` * `user` From 4afd7fd0ff10a186d96d2554e9fa82427ceab4f0 Mon Sep 17 00:00:00 2001 From: TomShawn <41534398+TomShawn@users.noreply.github.com> Date: Mon, 30 Aug 2021 16:22:05 +0800 Subject: [PATCH 6/6] Update tidb-binlog/tidb-binlog-configuration-file.md --- tidb-binlog/tidb-binlog-configuration-file.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/tidb-binlog/tidb-binlog-configuration-file.md b/tidb-binlog/tidb-binlog-configuration-file.md index 43af55325adb..0cc6ec182008 100644 --- a/tidb-binlog/tidb-binlog-configuration-file.md +++ b/tidb-binlog/tidb-binlog-configuration-file.md @@ -340,9 +340,9 @@ tbl-name = "~^a.*" * `schema`：默认为 `"tidb_binlog"`。 - > **注意：** - > - > 在同个 TiDB 集群中部署多个 Drainer 时，需要为每个 Drainer 节点指定不同的 checkpoint schema，否则两个实例的同步进度会互相覆盖。 + > **注意：** + > + > 在同个 TiDB 集群中部署多个 Drainer 时，需要为每个 Drainer 节点指定不同的 checkpoint schema，否则两个实例的同步进度会互相覆盖。 * `host` * `user`