Documented resuming changefeed from Failed state (#16103) (#16261)

pingcap · Jan 23, 2024 · 31bf8ab · 31bf8ab
1 parent a23166f
commit 31bf8ab
Show file tree

Hide file tree

Showing 2 changed files with 2 additions and 1 deletion.
diff --git a/media/ticdc/ticdc-changefeed-state-transfer.png b/media/ticdc/ticdc-changefeed-state-transfer.png
diff --git a/ticdc/ticdc-changefeed-overview.md b/ticdc/ticdc-changefeed-overview.md
@@ -19,7 +19,7 @@ Changefeed 是 TiCDC 中的单个同步任务。Changefeed 将一个 TiDB 集群
 - Stopped：同步任务停止，由于用户手动暂停 (pause) changefeed。处于这个状态的 changefeed 会阻挡 GC 推进。
 - Warning：同步任务报错，由于某些可恢复的错误导致同步无法继续进行。处于这个状态的 changefeed 会不断尝试继续推进，直到状态转为 Normal。最大重试时间为 30 分钟，超过该时间，changefeed 会进入 failed 状态。 处于这个状态的 changefeed 会阻挡 GC 推进。
 - Finished：同步任务完成，同步任务进度已经达到预设的 TargetTs。处于这个状态的 changefeed 不会阻挡 GC 推进。
-- Failed：同步任务失败。由于发生了某些不可恢复的错误，导致同步无法继续进行，并且无法自动恢复。为了让用户有足够的时间处理故障，处于这个状态的 changefeed 会阻塞 GC 推进，阻塞时长为 `gc-ttl` 所设置的值，其默认值为 24 小时。
+- Failed：同步任务失败。处于这个状态的 changefeed 不会自动尝试恢复。为了让用户有足够的时间处理故障，处于这个状态的 changefeed 会阻塞 GC 推进，阻塞时长为 `gc-ttl` 所设置的值，其默认值为 24 小时。在此期间，如果导致任务失败的问题被修复，用户可以手动恢复 changefeed。超过了 `gc-ttl` 时长后，如果 changefeed 仍然处于 Failed 状态，则同步任务无法恢复。
 
 > **注意：**
 >
@@ -35,6 +35,7 @@ Changefeed 是 TiCDC 中的单个同步任务。Changefeed 将一个 TiDB 集群
 - ⑥ `changefeed` 遇到不可重试错误，直接进入 failed 状态。此时 `changefeed` 会继续阻塞上游 GC，阻塞时长为 `gc-ttl` 所配置的时长。
 - ⑦ `changefeed` 的同步进度到达 target-ts 设置的值，完成同步。
 - ⑧ `changefeed` 停滞时间超过 `gc-ttl` 所指定的时长，遭遇 GC 推进错误，不可被恢复。
+- ⑨ `changefeed` 停滞时间小于 `gc-ttl` 所指定的时长，故障原因被修复，执行 `changefeed resume` 恢复同步任务。
 
 ## 操作 Changefeed