*: add smooth upgrade TiDB introduction doc #14013

zimulala · 2023-05-17T16:57:30Z

First-time contributors' checklist

I've signed Contributor License Agreement that's required for repo owners to accept my contribution.

What is changed, added or deleted? (Required)

This PR is used to add introduction doc for smooth upgrade.

Which TiDB version(s) do your changes apply to? (Required)

Tips for choosing the affected version(s):

By default, CHOOSE MASTER ONLY so your changes will be applied to the next TiDB major or minor releases. If your PR involves a product feature behavior change or a compatibility change, CHOOSE THE AFFECTED RELEASE BRANCH(ES) AND MASTER.

For details, see tips for choosing the affected versions (in Chinese).

What is the related PR or file link(s)?

This PR is translated from:
Other reference link(s): Upgrade TiDB without manually Canceling DDL tidb#39751

Do your changes match any of the following descriptions?

Delete files
Change aliases
Need modification after applied to another branch
Might cause conflicts after applied to another branch

ti-chi-bot · 2023-05-17T16:57:32Z

[REVIEW NOTIFICATION]

This pull request has been approved by:

qiancai
ran-huang

To complete the pull request process, please ask the reviewers in the list to review by filling /cc @reviewer in the comment.
After your PR has acquired the required number of LGTMs, you can assign this pull request to the committer in the list by filling /assign @committer in the comment to help you merge this pull request.

The full list of commands accepted by this bot can be found here.

Reviewer can indicate their review by submitting an approval review.
Reviewer can cancel approval by submitting a request changes review.

faq/upgrade-faq.md

upgrade-tidb.md

upgrade-tidb-using-tiup.md

TOC.md

upgrade-tidb.md

smooth-upgrade-tidb.md

Benjamin2037 · 2023-05-18T16:03:20Z

smooth-upgrade-tidb.md

+
+  * BR，Lightning (Physical Import Mode) 和通过 ingest 方式导入数据等组件：升级过程中不能处理这类组件的操作，是因为这些操作中可能将 paused 状态的 DDL 拷贝到 TiDB。但是此状态的 DDL 不能自动 resume，可能导致后续 DDL 卡住的情况。
+
+  * DM，Lightning (Logical Import Mode) 和 TiCDC 等组件。即在升级过程中，通过此类组件导入 SQL 到 TiDB，且其中有 DDL 操作，那么会导致此导入操作阻塞，此外可能存在未定义错误。


Suggested change

* DM，Lightning (Logical Import Mode) 和 TiCDC 等组件。即在升级过程中，通过此类组件导入 SQL 到 TiDB，且其中有 DDL 操作，那么会导致此导入操作阻塞，此外可能存在未定义错误。

* DM 和 TiCDC 等组件。即在升级过程中，通过此类组件导入 SQL 到 TiDB，且其中有 DDL 操作，那么会导致此导入操作阻塞，此外可能存在未定义错误。

尽量不要出现 lightning 的字样，另外这种导入后续不是 logical 导入。

什么原因？“Lightning (Physical Import Mode)” 要改吗？

smooth-upgrade-tidb.md

zimulala · 2023-05-19T16:54:44Z

PTAL @Benjamin2037

Benjamin2037

LGTM

smooth-upgrade-tidb.md

zimulala · 2023-05-22T03:01:19Z

PTAL @ran-huang

smooth-upgrade-tidb.md

zimulala · 2023-05-23T03:02:46Z

PTAL @qiancai @ran-huang

zimulala · 2023-05-23T07:37:31Z

PTAL @qiancai @ran-huang

faq/upgrade-faq.md

smooth-upgrade-tidb.md

faq/upgrade-faq.md

Co-authored-by: Grace Cai <qqzczy@126.com>

Co-authored-by: Ran <huangran.alex@gmail.com>

Co-authored-by: Grace Cai <qqzczy@126.com>

qiancai

LGTM

ran-huang · 2023-05-25T03:38:01Z

/verify

…r-ddls

Signed-off-by: Ran <huangran.alex@gmail.com>

ran-huang · 2023-05-25T04:52:19Z

/merge

ti-chi-bot · 2023-05-25T04:52:22Z

This pull request has been accepted and is ready to merge.

Commit hash: 50278eb

zimulala added the v7.1 This PR/issue applies to TiDB v7.1. label May 17, 2023

ti-chi-bot bot added missing-translation-status This PR does not have translation status info. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels May 17, 2023

zimulala mentioned this pull request May 17, 2023

releases: add TiDB 7.1.0 release notes (stable version) #13896

Merged

16 tasks

*: support smooth upgrade TiDB

d25e45a

zimulala force-pushed the zimuxia/pause-user-ddls branch from 16f11de to d25e45a Compare May 17, 2023 17:04

Oreoxmt requested a review from ran-huang May 18, 2023 01:38

Oreoxmt assigned ran-huang May 18, 2023

Oreoxmt added translation/doing This PR’s assignee is translating this PR. and removed missing-translation-status This PR does not have translation status info. labels May 18, 2023

Oreoxmt requested a review from benmaoer May 18, 2023 01:38

ran-huang reviewed May 18, 2023

View reviewed changes

TOC.md Outdated Show resolved Hide resolved

ran-huang reviewed May 18, 2023

View reviewed changes

upgrade-tidb.md Outdated Show resolved Hide resolved

*: address comments

a086164

zimulala force-pushed the zimuxia/pause-user-ddls branch from 5db914c to a086164 Compare May 18, 2023 09:00

zimulala requested a review from Benjamin2037 May 18, 2023 09:01

tangenta reviewed May 18, 2023

View reviewed changes

smooth-upgrade-tidb.md Outdated Show resolved Hide resolved

Benjamin2037 reviewed May 18, 2023

View reviewed changes

smooth-upgrade-tidb.md Outdated Show resolved Hide resolved

Benjamin2037 reviewed May 18, 2023

View reviewed changes

smooth-upgrade-tidb.md Outdated Show resolved Hide resolved

Benjamin2037 reviewed May 18, 2023

View reviewed changes

Benjamin2037 reviewed May 19, 2023

View reviewed changes

smooth-upgrade-tidb.md Outdated Show resolved Hide resolved

*: address a comment

5caa887

Benjamin2037 approved these changes May 19, 2023

View reviewed changes

ran-huang reviewed May 22, 2023

View reviewed changes

*: address comments

1435f81

ran-huang reviewed May 22, 2023

View reviewed changes

smooth-upgrade-tidb.md Outdated Show resolved Hide resolved

smooth-upgrade-tidb.md Outdated Show resolved Hide resolved

zimulala commented May 23, 2023

View reviewed changes

smooth-upgrade-tidb.md Outdated Show resolved Hide resolved

Update smooth-upgrade-tidb.md

f9e25e2

ran-huang mentioned this pull request May 24, 2023

add doc for smooth upgrade pingcap/docs#13663

Merged

16 tasks

ran-huang reviewed May 24, 2023

View reviewed changes

faq/upgrade-faq.md Outdated Show resolved Hide resolved

Update faq/upgrade-faq.md

d90e0dd

qiancai reviewed May 24, 2023

View reviewed changes

faq/upgrade-faq.md Outdated Show resolved Hide resolved

smooth-upgrade-tidb.md Outdated Show resolved Hide resolved

smooth-upgrade-tidb.md Outdated Show resolved Hide resolved

faq/upgrade-faq.md Outdated Show resolved Hide resolved

zimulala and others added 6 commits May 25, 2023 10:30

Update smooth-upgrade-tidb.md

fb43f1b

Co-authored-by: Grace Cai <qqzczy@126.com>

Update faq/upgrade-faq.md

c242a7d

Co-authored-by: Grace Cai <qqzczy@126.com>

Update smooth-upgrade-tidb.md

f55e00d

Co-authored-by: Grace Cai <qqzczy@126.com>

Update smooth-upgrade-tidb.md

f529344

Co-authored-by: Ran <huangran.alex@gmail.com>

Update faq/upgrade-faq.md

39d56ca

Co-authored-by: Grace Cai <qqzczy@126.com>

update wording in limitations

97418b1

qiancai approved these changes May 25, 2023

View reviewed changes

ti-chi-bot bot added the status/LGT1 Indicates that a PR has LGTM 1. label May 25, 2023

ran-huang approved these changes May 25, 2023

View reviewed changes

ti-chi-bot bot added status/LGT2 Indicates that a PR has LGTM 2. and removed status/LGT1 Indicates that a PR has LGTM 1. labels May 25, 2023

ran-huang added 2 commits May 25, 2023 12:00

Merge remote-tracking branch 'upstream/master' into zimuxia/pause-use…

df7bec4

…r-ddls

fix lint

50278eb

Signed-off-by: Ran <huangran.alex@gmail.com>

ti-chi-bot bot added the status/can-merge Indicates a PR has been approved by a committer. label May 25, 2023

ti-chi-bot bot merged commit 7027ca1 into pingcap:master May 25, 2023

zimulala mentioned this pull request May 26, 2023

Upgrade TiDB without manually Canceling DDL pingcap/tidb#39751

Closed

17 tasks

ran-huang added translation/done This PR has been translated from English into Chinese and updated to pingcap/docs-cn in a PR. and removed translation/doing This PR’s assignee is translating this PR. labels May 30, 2023

zimulala deleted the zimuxia/pause-user-ddls branch June 19, 2023 02:01

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

*: add smooth upgrade TiDB introduction doc #14013

*: add smooth upgrade TiDB introduction doc #14013

zimulala commented May 17, 2023 •

edited

Loading

ti-chi-bot bot commented May 17, 2023 •

edited

Loading

Benjamin2037 May 18, 2023

Benjamin2037 May 19, 2023

zimulala May 19, 2023

zimulala commented May 19, 2023

Benjamin2037 left a comment

zimulala commented May 22, 2023

zimulala commented May 23, 2023

zimulala commented May 23, 2023

qiancai left a comment

ran-huang commented May 25, 2023

ran-huang commented May 25, 2023

ti-chi-bot bot commented May 25, 2023


		* BR，Lightning (Physical Import Mode) 和通过 ingest 方式导入数据等组件：升级过程中不能处理这类组件的操作，是因为这些操作中可能将 paused 状态的 DDL 拷贝到 TiDB。但是此状态的 DDL 不能自动 resume，可能导致后续 DDL 卡住的情况。

		* DM，Lightning (Logical Import Mode) 和 TiCDC 等组件。即在升级过程中，通过此类组件导入 SQL 到 TiDB，且其中有 DDL 操作，那么会导致此导入操作阻塞，此外可能存在未定义错误。

	* DM，Lightning (Logical Import Mode) 和 TiCDC 等组件。即在升级过程中，通过此类组件导入 SQL 到 TiDB，且其中有 DDL 操作，那么会导致此导入操作阻塞，此外可能存在未定义错误。
	* DM 和 TiCDC 等组件。即在升级过程中，通过此类组件导入 SQL 到 TiDB，且其中有 DDL 操作，那么会导致此导入操作阻塞，此外可能存在未定义错误。

*: add smooth upgrade TiDB introduction doc #14013

*: add smooth upgrade TiDB introduction doc #14013

Conversation

zimulala commented May 17, 2023 • edited Loading

First-time contributors' checklist

What is changed, added or deleted? (Required)

Which TiDB version(s) do your changes apply to? (Required)

What is the related PR or file link(s)?

Do your changes match any of the following descriptions?

ti-chi-bot bot commented May 17, 2023 • edited Loading

Benjamin2037 May 18, 2023

Choose a reason for hiding this comment

Benjamin2037 May 19, 2023

Choose a reason for hiding this comment

zimulala May 19, 2023

Choose a reason for hiding this comment

zimulala commented May 19, 2023

Benjamin2037 left a comment

Choose a reason for hiding this comment

zimulala commented May 22, 2023

zimulala commented May 23, 2023

zimulala commented May 23, 2023

qiancai left a comment

Choose a reason for hiding this comment

ran-huang commented May 25, 2023

ran-huang commented May 25, 2023

ti-chi-bot bot commented May 25, 2023

zimulala commented May 17, 2023 •

edited

Loading

ti-chi-bot bot commented May 17, 2023 •

edited

Loading