cdc: add compatibility notes for sort-dir #6648
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
ti-chi-bot
added
missing-translation-status
|
@leoppro PTAL |
TomShawn
added
needs-cherry-pick-release-4.0
translation/doing
ti-chi-bot
removed
the
missing-translation-status
TomShawn
added
type/compatibility-or-feature-change
amyangfei
approved these changes
Jul 15, 2021
TomShawn
reviewed
Jul 15, 2021
ti-chi-bot
added
size/S
TomShawn
reviewed
Jul 15, 2021
ticdc/ticdc-overview.md
Outdated
| | :--- | :--- | :-- | | ||
| | v4.0.11 及之前的 v4.0 版本，v5.0.0-rc | 作为 changefeed 配置项，给 `file` sorter 和 `unified` Sorter 指定临时文件目录 | 在这些版本中，`file` sorter 和 `unified` sorter **均不是**正式功能 (GA)，不推荐在生产环境中使用。<br/><br/>如果有多个 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` 的相关配置。<br /><br />如果你使用 TiUP 部署 TiCDC，建议升级到最新的 TiUP 版本并在 TiCDC server 配置中设置 `sorter.sort-dir` 一项。<br /><br />在 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`。<br /><br />如果该目录所在设备空间不足，有可能出现硬盘空间不足的问题。之前配置的 changefeed 的 `sort-dir` 配置将会失效。| |
There was a problem hiding this comment.
@amyangfei PTAL "v5.0.2 及之后的 v5.0 版本，v5.1". Thanks. Shall we use "v5.0.2 及之后，以及其他更新的版本"？
|
/rebase |
github-actions
bot
force-pushed
the
zixiong-sort-dir
branch
from
4fd823b to
0aee4fc
Compare
TomShawn
approved these changes
Jul 15, 2021
|
[REVIEW NOTIFICATION] This pull request has been approved by:
To complete the pull request process, please ask the reviewers in the list to review by filling The full list of commands accepted by this bot can be found here. Reviewer can indicate their review by submitting an approval review. |
ti-chi-bot
added
status/LGT2
TomShawn
reviewed
Jul 15, 2021
TomShawn
added
the
requires-version-specific-changes
|
/merge |
|
This pull request has been accepted and is ready to merge. Commit hash: 27f71f5
|
ti-chi-bot
added
the
status/can-merge
11 tasks
|
In response to a cherrypick label: new pull request created: #6681. |
|
In response to a cherrypick label: new pull request created: #6682. |
11 tasks
|
In response to a cherrypick label: new pull request created: #6683. |
11 tasks
ti-chi-bot
added a commit
that referenced
this pull request
Jul 15, 2021
ti-chi-bot
added a commit
that referenced
this pull request
Jul 15, 2021
3AceShowHand
pushed a commit
to 3AceShowHand/docs-cn
that referenced
this pull request
Jul 27, 2021
ti-chi-bot
added a commit
that referenced
this pull request
Jul 27, 2021
11 tasks
TomShawn
reviewed
Jul 28, 2021
| | :--- | :--- | :-- | :-- | | ||
| | v4.0.11 及之前的 v4.0 版本，v5.0.0-rc | 作为 changefeed 配置项，给 `file` sorter 和 `unified` Sorter 指定临时文件目录 | 在这些版本中，`file` sorter 和 `unified` sorter **均不是**正式功能 (GA)，不推荐在生产环境中使用。<br/><br/>如果有多个 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` 的相关配置。<br /><br />如果你使用 TiUP 部署 TiCDC，建议升级到最新的 TiUP 版本并在 TiCDC server 配置中设置 `sorter.sort-dir` 一项。<br /><br />在 v4.0.13、v5.0.0 和 v5.0.1 中 unified sorter 是默认开启的，如果要将集群升级至这些版本，请确保 TiCDC server 配置中的 `sorter.sort-dir` 已经被正确配置。| 需要通过 `cdc server` 命令行参数（或 TiUP）配置 `sort-dir` | | ||
| | v5.0.2 及之后的版本 | `sort-dir` 被弃用，建议配置 `data-dir` | `data-dir` 可以通过最新版本的 TiUP 进行配置。这些版本中 unified sorter 是默认开启的，升级时请确保 `data-dir` 已经被正确配置，否则将默认使用 `/tmp/cdc_data`。<br /><br />如果该目录所在设备空间不足，有可能出现硬盘空间不足的问题。之前配置的 changefeed 的 `sort-dir` 配置将会失效。| 需要通过 `cdc server` 命令行参数（或 TiUP）配置 `data-dir` | |
There was a problem hiding this comment.
TomShawn
added
translation/done
11 tasks
This was referenced Aug 4, 2021
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
What is changed, added or deleted? (Required)
sort-diranddata-dirin TiCDCWhich TiDB version(s) do your changes apply to? (Required)
Do your changes match any of the following descriptions?