From 036c944e259abc7b355fee27d1045bdb69b92d5e Mon Sep 17 00:00:00 2001 From: Zixiong Liu Date: Thu, 8 Jul 2021 14:49:27 +0800 Subject: [PATCH 1/6] add compatibility notes for sort-dir --- ticdc/ticdc-overview.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/ticdc/ticdc-overview.md b/ticdc/ticdc-overview.md index 037c570c5c92..af4dafa0c666 100644 --- a/ticdc/ticdc-overview.md +++ b/ticdc/ticdc-overview.md @@ -123,3 +123,11 @@ TiCDC 从 4.0.8 版本开始，可通过修改任务配置来同步**没有有 ## TiCDC 开放数据协议 TiCDC Open Protocol 是一种行级别的数据变更通知协议，为监控、缓存、全文索引、分析引擎、异构数据库的主从复制等提供数据源。TiCDC 遵循 TiCDC Open Protocol，向 MQ (Message Queue) 等第三方数据媒介复制 TiDB 的数据变更。详细信息参考 [TiCDC 开放数据协议](/ticdc/ticdc-open-protocol.md)。 + +## `sort-dir` 及 `data-dir` 配置项 + +`sort-dir` 配置项给 TiCDC 内部的排序器指定临时文件目录，其作用在各版本有过一些不兼容更改： + +- v4.0.11 及更小版本，以及 v5.0.0-rc 中，`sort-dir` 仅作为 changefeed 配置项，给 file sorter 和 unified sorter 指定临时文件目录。在这些版本中，file sorter 和 unified sorter 均未 GA，不推荐生产环境使用。如果有多个 changefeed 被配置使用了 `unified` 作为 `sort-engine`，那么实际使用的临时文件目录可能是任何一个 changefeed 的 `sort-dir` 配置，且每个 TiCDC 节点上使用的目录可能不一致。 +- v4.0.12, v4.0.13, v5.0.0 及 v5.0.1 中，`sort-dir` 可以作为 changefeed 配置项或 cdc server 配置项。但在默认情况下 changefeed 的 `sort-dir` 配置不会生效，而 cdc server 的 `sort-dir` 配置默认为 `/tmp/cdc_sort`. 建议生产环境仅配置 cdc server 的相关配置。如果用户使用 TiUP 部署 TiCDC，建议升级到最新 TiUP 版本并在 TiCDC server 配置中设置 `sorter.sort-dir` 一项。v4.0.13, v5.0.0 和 v5.0.1 中 unified sorter 是默认开启的，如果要升级到如上版本，请确保 TiCDC server 配置中的 `sorter.sort-dir` 已经被正确配置。 +- v5.0.2 及 v5.1.0 中，`sort-dir` 被弃用，建议用户配置 `data-dir`. `data-dir` 可以通过最新版本的 TiUP 进行配置。这些版本中 unified sorter 是默认开启的，升级时请确保 `data-dir` 已经被正确配置，否则将默认使用 /tmp/cdc_data, 如果该目录所在设备空间不足，有可能出现硬盘空间不足的问题。之前配置的 changefeed 的 `sort-dir` 配置将会失效。 From e2d140a026afc3a7d72deb49ddb724570d527f0d Mon Sep 17 00:00:00 2001 From: TomShawn <41534398+TomShawn@users.noreply.github.com> Date: Thu, 15 Jul 2021 17:47:02 +0800 Subject: [PATCH 2/6] Apply suggestions from code review --- ticdc/ticdc-overview.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/ticdc/ticdc-overview.md b/ticdc/ticdc-overview.md index af4dafa0c666..5a8ae0ca1c41 100644 --- a/ticdc/ticdc-overview.md +++ b/ticdc/ticdc-overview.md @@ -126,8 +126,12 @@ TiCDC Open Protocol 是一种行级别的数据变更通知协议，为监控、 ## `sort-dir` 及 `data-dir` 配置项 -`sort-dir` 配置项给 TiCDC 内部的排序器指定临时文件目录，其作用在各版本有过一些不兼容更改： +`sort-dir` 配置项用于给 TiCDC 内部的排序器指定临时文件目录，其作用在各版本有过如下兼容性更改： -- v4.0.11 及更小版本，以及 v5.0.0-rc 中，`sort-dir` 仅作为 changefeed 配置项，给 file sorter 和 unified sorter 指定临时文件目录。在这些版本中，file sorter 和 unified sorter 均未 GA，不推荐生产环境使用。如果有多个 changefeed 被配置使用了 `unified` 作为 `sort-engine`，那么实际使用的临时文件目录可能是任何一个 changefeed 的 `sort-dir` 配置，且每个 TiCDC 节点上使用的目录可能不一致。 -- v4.0.12, v4.0.13, v5.0.0 及 v5.0.1 中，`sort-dir` 可以作为 changefeed 配置项或 cdc server 配置项。但在默认情况下 changefeed 的 `sort-dir` 配置不会生效，而 cdc server 的 `sort-dir` 配置默认为 `/tmp/cdc_sort`. 建议生产环境仅配置 cdc server 的相关配置。如果用户使用 TiUP 部署 TiCDC，建议升级到最新 TiUP 版本并在 TiCDC server 配置中设置 `sorter.sort-dir` 一项。v4.0.13, v5.0.0 和 v5.0.1 中 unified sorter 是默认开启的，如果要升级到如上版本，请确保 TiCDC server 配置中的 `sorter.sort-dir` 已经被正确配置。 -- v5.0.2 及 v5.1.0 中，`sort-dir` 被弃用，建议用户配置 `data-dir`. `data-dir` 可以通过最新版本的 TiUP 进行配置。这些版本中 unified sorter 是默认开启的，升级时请确保 `data-dir` 已经被正确配置，否则将默认使用 /tmp/cdc_data, 如果该目录所在设备空间不足，有可能出现硬盘空间不足的问题。之前配置的 changefeed 的 `sort-dir` 配置将会失效。 +- 在 v4.0.11 及之前的 v4.0 版本，以及在 v5.0.0-rc 中，`sort-dir` 仅作为 changefeed 配置项，给 file sorter 和 unified Sorter 指定临时文件目录。在这些版本中，file sorter 和 unified sorter **均不是**正式功能 (GA)，因此不推荐生产环境使用。 + + 如果有多个 changefeed 被配置使用了 `unified` 作为 `sort-engine`，那么实际使用的临时文件目录可能是任何一个 changefeed 的 `sort-dir` 配置，且每个 TiCDC 节点上使用的目录可能不一致。 +- v4.0.12、v4.0.13、v5.0.0 及 v5.0.1 中，`sort-dir` 可以作为 changefeed 配置项或 `cdc server` 配置项。但在默认情况下 changefeed 的 `sort-dir` 配置不会生效，而 `cdc server` 的 `sort-dir` 配置默认为 `/tmp/cdc_sort`。建议生产环境下仅配置 `cdc server` 的相关配置。 + + 如果你使用 TiUP 部署 TiCDC，建议升级到最新的 TiUP 版本并在 TiCDC server 配置中设置 `sorter.sort-dir` 一项。在 v4.0.13、v5.0.0 和 v5.0.1 中 unified sorter 是默认开启的，如果要将集群升级至这些版本，请确保 TiCDC server 配置中的 `sorter.sort-dir` 已经被正确配置。 +- v5.0.2 及 v5.1.0 中，`sort-dir` 被弃用，建议用户配置 `data-dir`。`data-dir` 可以通过最新版本的 TiUP 进行配置。这些版本中 unified sorter 是默认开启的，升级时请确保 `data-dir` 已经被正确配置，否则将默认使用 `/tmp/cdc_data`。如果该目录所在设备空间不足，有可能出现硬盘空间不足的问题。之前配置的 changefeed 的 `sort-dir` 配置将会失效。 From 0aee4fcc1a8ba8ff944c282f22f7e68645fee137 Mon Sep 17 00:00:00 2001 From: TomShawn <41534398+TomShawn@users.noreply.github.com> Date: Thu, 15 Jul 2021 18:03:43 +0800 Subject: [PATCH 3/6] use a table view --- ticdc/ticdc-overview.md | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/ticdc/ticdc-overview.md b/ticdc/ticdc-overview.md index 5a8ae0ca1c41..f822dae61af4 100644 --- a/ticdc/ticdc-overview.md +++ b/ticdc/ticdc-overview.md @@ -124,14 +124,12 @@ TiCDC 从 4.0.8 版本开始，可通过修改任务配置来同步**没有有 TiCDC Open Protocol 是一种行级别的数据变更通知协议，为监控、缓存、全文索引、分析引擎、异构数据库的主从复制等提供数据源。TiCDC 遵循 TiCDC Open Protocol，向 MQ (Message Queue) 等第三方数据媒介复制 TiDB 的数据变更。详细信息参考 [TiCDC 开放数据协议](/ticdc/ticdc-open-protocol.md)。 -## `sort-dir` 及 `data-dir` 配置项 +## `sort-dir` 及 `data-dir` 配置项的兼容性说明 `sort-dir` 配置项用于给 TiCDC 内部的排序器指定临时文件目录，其作用在各版本有过如下兼容性更改： -- 在 v4.0.11 及之前的 v4.0 版本，以及在 v5.0.0-rc 中，`sort-dir` 仅作为 changefeed 配置项，给 file sorter 和 unified Sorter 指定临时文件目录。在这些版本中，file sorter 和 unified sorter **均不是**正式功能 (GA)，因此不推荐生产环境使用。 - - 如果有多个 changefeed 被配置使用了 `unified` 作为 `sort-engine`，那么实际使用的临时文件目录可能是任何一个 changefeed 的 `sort-dir` 配置，且每个 TiCDC 节点上使用的目录可能不一致。 -- v4.0.12、v4.0.13、v5.0.0 及 v5.0.1 中，`sort-dir` 可以作为 changefeed 配置项或 `cdc server` 配置项。但在默认情况下 changefeed 的 `sort-dir` 配置不会生效，而 `cdc server` 的 `sort-dir` 配置默认为 `/tmp/cdc_sort`。建议生产环境下仅配置 `cdc server` 的相关配置。 - - 如果你使用 TiUP 部署 TiCDC，建议升级到最新的 TiUP 版本并在 TiCDC server 配置中设置 `sorter.sort-dir` 一项。在 v4.0.13、v5.0.0 和 v5.0.1 中 unified sorter 是默认开启的，如果要将集群升级至这些版本，请确保 TiCDC server 配置中的 `sorter.sort-dir` 已经被正确配置。 -- v5.0.2 及 v5.1.0 中，`sort-dir` 被弃用，建议用户配置 `data-dir`。`data-dir` 可以通过最新版本的 TiUP 进行配置。这些版本中 unified sorter 是默认开启的，升级时请确保 `data-dir` 已经被正确配置，否则将默认使用 `/tmp/cdc_data`。如果该目录所在设备空间不足，有可能出现硬盘空间不足的问题。之前配置的 changefeed 的 `sort-dir` 配置将会失效。 +| 版本 | `sort-engine` 的使用 | 说明 | +| :--- | :--- | :-- | +| v4.0.11 及之前的 v4.0 版本，v5.0.0-rc | 作为 changefeed 配置项，给 `file` sorter 和 `unified` Sorter 指定临时文件目录 | 在这些版本中，`file` sorter 和 `unified` sorter **均不是**正式功能 (GA)，不推荐在生产环境中使用。

如果有多个 changefeed 被配置使用了 `unified` 作为 `sort-engine`，那么实际使用的临时文件目录可能是任何一个 changefeed 的 `sort-dir` 配置，且每个 TiCDC 节点上使用的目录可能不一致。 | +| v4.0.12，v4.0.13，v5.0.0 及 v5.0.1 | 作为 changefeed 配置项或 `cdc server` 配置项 | 在默认情况下 changefeed 的 `sort-dir` 配置不会生效，而 `cdc server` 的 `sort-dir` 配置默认为 `/tmp/cdc_sort`。建议生产环境下仅配置 `cdc server` 的相关配置。

如果你使用 TiUP 部署 TiCDC，建议升级到最新的 TiUP 版本并在 TiCDC server 配置中设置 `sorter.sort-dir` 一项。

在 v4.0.13、v5.0.0 和 v5.0.1 中 unified sorter 是默认开启的，如果要将集群升级至这些版本，请确保 TiCDC server 配置中的 `sorter.sort-dir` 已经被正确配置。| +| v5.0.2 及之后的 v5.0 版本，v5.1 | `sort-dir` 被弃用，建议配置 `data-dir` | `data-dir` 可以通过最新版本的 TiUP 进行配置。这些版本中 unified sorter 是默认开启的，升级时请确保 `data-dir` 已经被正确配置，否则将默认使用 `/tmp/cdc_data`。

如果该目录所在设备空间不足，有可能出现硬盘空间不足的问题。之前配置的 changefeed 的 `sort-dir` 配置将会失效。| \ No newline at end of file From c66baa7ed8d38ed13ca996a1483fcec2d6408b9b Mon Sep 17 00:00:00 2001 From: Zixiong Liu Date: Thu, 15 Jul 2021 18:16:36 +0800 Subject: [PATCH 4/6] add suggestions --- ticdc/ticdc-overview.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/ticdc/ticdc-overview.md b/ticdc/ticdc-overview.md index f822dae61af4..e3ffdb42e2d7 100644 --- a/ticdc/ticdc-overview.md +++ b/ticdc/ticdc-overview.md @@ -128,8 +128,8 @@ TiCDC Open Protocol 是一种行级别的数据变更通知协议，为监控、 `sort-dir` 配置项用于给 TiCDC 内部的排序器指定临时文件目录，其作用在各版本有过如下兼容性更改： -| 版本 | `sort-engine` 的使用 | 说明 | -| :--- | :--- | :-- | -| v4.0.11 及之前的 v4.0 版本，v5.0.0-rc | 作为 changefeed 配置项，给 `file` sorter 和 `unified` Sorter 指定临时文件目录 | 在这些版本中，`file` sorter 和 `unified` sorter **均不是**正式功能 (GA)，不推荐在生产环境中使用。

如果有多个 changefeed 被配置使用了 `unified` 作为 `sort-engine`，那么实际使用的临时文件目录可能是任何一个 changefeed 的 `sort-dir` 配置，且每个 TiCDC 节点上使用的目录可能不一致。 | -| v4.0.12，v4.0.13，v5.0.0 及 v5.0.1 | 作为 changefeed 配置项或 `cdc server` 配置项 | 在默认情况下 changefeed 的 `sort-dir` 配置不会生效，而 `cdc server` 的 `sort-dir` 配置默认为 `/tmp/cdc_sort`。建议生产环境下仅配置 `cdc server` 的相关配置。

如果你使用 TiUP 部署 TiCDC，建议升级到最新的 TiUP 版本并在 TiCDC server 配置中设置 `sorter.sort-dir` 一项。

在 v4.0.13、v5.0.0 和 v5.0.1 中 unified sorter 是默认开启的，如果要将集群升级至这些版本，请确保 TiCDC server 配置中的 `sorter.sort-dir` 已经被正确配置。| -| v5.0.2 及之后的 v5.0 版本，v5.1 | `sort-dir` 被弃用，建议配置 `data-dir` | `data-dir` 可以通过最新版本的 TiUP 进行配置。这些版本中 unified sorter 是默认开启的，升级时请确保 `data-dir` 已经被正确配置，否则将默认使用 `/tmp/cdc_data`。

如果该目录所在设备空间不足，有可能出现硬盘空间不足的问题。之前配置的 changefeed 的 `sort-dir` 配置将会失效。| \ No newline at end of file +| 版本 | `sort-engine` 的使用 | 说明 | 建议 | +| :--- | :--- | :-- | :-- | +| v4.0.11 及之前的 v4.0 版本，v5.0.0-rc | 作为 changefeed 配置项，给 `file` sorter 和 `unified` Sorter 指定临时文件目录 | 在这些版本中，`file` sorter 和 `unified` sorter **均不是**正式功能 (GA)，不推荐在生产环境中使用。

如果有多个 changefeed 被配置使用了 `unified` 作为 `sort-engine`，那么实际使用的临时文件目录可能是任何一个 changefeed 的 `sort-dir` 配置，且每个 TiCDC 节点上使用的目录可能不一致。 | 不推荐生产环境使用 Unified Sorter | +| v4.0.12，v4.0.13，v5.0.0 及 v5.0.1 | 作为 changefeed 配置项或 `cdc server` 配置项 | 在默认情况下 changefeed 的 `sort-dir` 配置不会生效，而 `cdc server` 的 `sort-dir` 配置默认为 `/tmp/cdc_sort`。建议生产环境下仅配置 `cdc server` 的相关配置。

如果你使用 TiUP 部署 TiCDC，建议升级到最新的 TiUP 版本并在 TiCDC server 配置中设置 `sorter.sort-dir` 一项。

在 v4.0.13、v5.0.0 和 v5.0.1 中 unified sorter 是默认开启的，如果要将集群升级至这些版本，请确保 TiCDC server 配置中的 `sorter.sort-dir` 已经被正确配置。| 需要通过 cdc server 命令行参数 (或 TiUP) 配置 `sort-dir` | +| v5.0.2 及之后的 v5.0 版本，v5.1 | `sort-dir` 被弃用，建议配置 `data-dir` | `data-dir` 可以通过最新版本的 TiUP 进行配置。这些版本中 unified sorter 是默认开启的，升级时请确保 `data-dir` 已经被正确配置，否则将默认使用 `/tmp/cdc_data`。

如果该目录所在设备空间不足，有可能出现硬盘空间不足的问题。之前配置的 changefeed 的 `sort-dir` 配置将会失效。| 需要通过 cdc server 命令行参数 (或 TiUP) 配置 `data-dir` | \ No newline at end of file From 0d62750f2f3dbcd8a6f81f7fb409f9e8e3f27350 Mon Sep 17 00:00:00 2001 From: TomShawn <41534398+TomShawn@users.noreply.github.com> Date: Thu, 15 Jul 2021 19:07:35 +0800 Subject: [PATCH 5/6] minor format fix --- ticdc/ticdc-overview.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/ticdc/ticdc-overview.md b/ticdc/ticdc-overview.md index e3ffdb42e2d7..26ab67e54857 100644 --- a/ticdc/ticdc-overview.md +++ b/ticdc/ticdc-overview.md @@ -128,8 +128,8 @@ TiCDC Open Protocol 是一种行级别的数据变更通知协议，为监控、 `sort-dir` 配置项用于给 TiCDC 内部的排序器指定临时文件目录，其作用在各版本有过如下兼容性更改： -| 版本 | `sort-engine` 的使用 | 说明 | 建议 | +| 版本 | `sort-engine` 的使用 | 说明 | 使用建议 | | :--- | :--- | :-- | :-- | -| v4.0.11 及之前的 v4.0 版本，v5.0.0-rc | 作为 changefeed 配置项，给 `file` sorter 和 `unified` Sorter 指定临时文件目录 | 在这些版本中，`file` sorter 和 `unified` sorter **均不是**正式功能 (GA)，不推荐在生产环境中使用。

如果有多个 changefeed 被配置使用了 `unified` 作为 `sort-engine`，那么实际使用的临时文件目录可能是任何一个 changefeed 的 `sort-dir` 配置，且每个 TiCDC 节点上使用的目录可能不一致。 | 不推荐生产环境使用 Unified Sorter | -| v4.0.12，v4.0.13，v5.0.0 及 v5.0.1 | 作为 changefeed 配置项或 `cdc server` 配置项 | 在默认情况下 changefeed 的 `sort-dir` 配置不会生效，而 `cdc server` 的 `sort-dir` 配置默认为 `/tmp/cdc_sort`。建议生产环境下仅配置 `cdc server` 的相关配置。

如果你使用 TiUP 部署 TiCDC，建议升级到最新的 TiUP 版本并在 TiCDC server 配置中设置 `sorter.sort-dir` 一项。

在 v4.0.13、v5.0.0 和 v5.0.1 中 unified sorter 是默认开启的，如果要将集群升级至这些版本，请确保 TiCDC server 配置中的 `sorter.sort-dir` 已经被正确配置。| 需要通过 cdc server 命令行参数 (或 TiUP) 配置 `sort-dir` | -| v5.0.2 及之后的 v5.0 版本，v5.1 | `sort-dir` 被弃用，建议配置 `data-dir` | `data-dir` 可以通过最新版本的 TiUP 进行配置。这些版本中 unified sorter 是默认开启的，升级时请确保 `data-dir` 已经被正确配置，否则将默认使用 `/tmp/cdc_data`。

如果该目录所在设备空间不足，有可能出现硬盘空间不足的问题。之前配置的 changefeed 的 `sort-dir` 配置将会失效。| 需要通过 cdc server 命令行参数 (或 TiUP) 配置 `data-dir` | \ No newline at end of file +| v4.0.11 及之前的 v4.0 版本，v5.0.0-rc | 作为 changefeed 配置项，给 `file` sorter 和 `unified` Sorter 指定临时文件目录 | 在这些版本中，`file` sorter 和 `unified` sorter **均不是**正式功能 (GA)，不推荐在生产环境中使用。

如果有多个 changefeed 被配置使用了 `unified` 作为 `sort-engine`，那么实际使用的临时文件目录可能是任何一个 changefeed 的 `sort-dir` 配置，且每个 TiCDC 节点上使用的目录可能不一致。 | 不推荐在生产环境中使用 Unified Sorter | +| v4.0.12，v4.0.13，v5.0.0 及 v5.0.1 | 作为 changefeed 配置项或 `cdc server` 配置项 | 在默认情况下 changefeed 的 `sort-dir` 配置不会生效，而 `cdc server` 的 `sort-dir` 配置默认为 `/tmp/cdc_sort`。建议生产环境下仅配置 `cdc server` 的相关配置。

如果你使用 TiUP 部署 TiCDC，建议升级到最新的 TiUP 版本并在 TiCDC server 配置中设置 `sorter.sort-dir` 一项。

在 v4.0.13、v5.0.0 和 v5.0.1 中 unified sorter 是默认开启的，如果要将集群升级至这些版本，请确保 TiCDC server 配置中的 `sorter.sort-dir` 已经被正确配置。| 需要通过 `cdc server` 命令行参数（或 TiUP）配置 `sort-dir` | +| v5.0.2 及之后的 v5.0 版本，v5.1 | `sort-dir` 被弃用，建议配置 `data-dir` | `data-dir` 可以通过最新版本的 TiUP 进行配置。这些版本中 unified sorter 是默认开启的，升级时请确保 `data-dir` 已经被正确配置，否则将默认使用 `/tmp/cdc_data`。

如果该目录所在设备空间不足，有可能出现硬盘空间不足的问题。之前配置的 changefeed 的 `sort-dir` 配置将会失效。| 需要通过 `cdc server` 命令行参数（或 TiUP）配置 `data-dir` | From 27f71f5d5dec3632ec0f61fb4384a1e244660a01 Mon Sep 17 00:00:00 2001 From: TomShawn <41534398+TomShawn@users.noreply.github.com> Date: Thu, 15 Jul 2021 19:08:16 +0800 Subject: [PATCH 6/6] Update ticdc/ticdc-overview.md --- ticdc/ticdc-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ticdc/ticdc-overview.md b/ticdc/ticdc-overview.md index 26ab67e54857..f63b0e547f1b 100644 --- a/ticdc/ticdc-overview.md +++ b/ticdc/ticdc-overview.md @@ -132,4 +132,4 @@ TiCDC Open Protocol 是一种行级别的数据变更通知协议，为监控、 | :--- | :--- | :-- | :-- | | v4.0.11 及之前的 v4.0 版本，v5.0.0-rc | 作为 changefeed 配置项，给 `file` sorter 和 `unified` Sorter 指定临时文件目录 | 在这些版本中，`file` sorter 和 `unified` sorter **均不是**正式功能 (GA)，不推荐在生产环境中使用。

如果有多个 changefeed 被配置使用了 `unified` 作为 `sort-engine`，那么实际使用的临时文件目录可能是任何一个 changefeed 的 `sort-dir` 配置，且每个 TiCDC 节点上使用的目录可能不一致。 | 不推荐在生产环境中使用 Unified Sorter | | v4.0.12，v4.0.13，v5.0.0 及 v5.0.1 | 作为 changefeed 配置项或 `cdc server` 配置项 | 在默认情况下 changefeed 的 `sort-dir` 配置不会生效，而 `cdc server` 的 `sort-dir` 配置默认为 `/tmp/cdc_sort`。建议生产环境下仅配置 `cdc server` 的相关配置。

如果你使用 TiUP 部署 TiCDC，建议升级到最新的 TiUP 版本并在 TiCDC server 配置中设置 `sorter.sort-dir` 一项。

在 v4.0.13、v5.0.0 和 v5.0.1 中 unified sorter 是默认开启的，如果要将集群升级至这些版本，请确保 TiCDC server 配置中的 `sorter.sort-dir` 已经被正确配置。| 需要通过 `cdc server` 命令行参数（或 TiUP）配置 `sort-dir` | -| v5.0.2 及之后的 v5.0 版本，v5.1 | `sort-dir` 被弃用，建议配置 `data-dir` | `data-dir` 可以通过最新版本的 TiUP 进行配置。这些版本中 unified sorter 是默认开启的，升级时请确保 `data-dir` 已经被正确配置，否则将默认使用 `/tmp/cdc_data`。

如果该目录所在设备空间不足，有可能出现硬盘空间不足的问题。之前配置的 changefeed 的 `sort-dir` 配置将会失效。| 需要通过 `cdc server` 命令行参数（或 TiUP）配置 `data-dir` | +| v5.0.2 及之后的版本 | `sort-dir` 被弃用，建议配置 `data-dir` | `data-dir` 可以通过最新版本的 TiUP 进行配置。这些版本中 unified sorter 是默认开启的，升级时请确保 `data-dir` 已经被正确配置，否则将默认使用 `/tmp/cdc_data`。

如果该目录所在设备空间不足，有可能出现硬盘空间不足的问题。之前配置的 changefeed 的 `sort-dir` 配置将会失效。| 需要通过 `cdc server` 命令行参数（或 TiUP）配置 `data-dir` |