Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion latest_translation_commit.json
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{"target":"release-8.5","sha":"1979c094c880fd7cf92610f1fec88f55fc365355"}
{"target":"release-8.5","sha":"388c97414047d8a777277379570971c1e57008b1"}
64 changes: 44 additions & 20 deletions tidb-cloud/changefeed-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,58 +9,82 @@ TiDB Cloud changefeed 帮助你将数据从 TiDB Cloud 流式传输到其他数

> **Note:**
>
> - 目前,TiDB Cloud 每个集群最多只允许创建 100 个 changefeed。
> - 目前,TiDB Cloud 每个<CustomContent plan="dedicated">集群</CustomContent><CustomContent plan="premium">实例</CustomContent>最多只允许创建 100 个 changefeed。
> - 目前,TiDB Cloud 每个 changefeed 最多只允许配置 100 条表过滤规则。
> - 对于 [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) 和 [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 集群,changefeed 功能不可用。

## 查看 Changefeed 页面

要访问 changefeed 功能,请按照以下步骤操作:

1. 在 [TiDB Cloud 控制台](https://tidbcloud.com) 中,进入你项目的 [**Clusters**](https://tidbcloud.com/project/clusters) 页面。
1. 在 [TiDB Cloud 控制台](https://tidbcloud.com),<CustomContent plan="dedicated">进入你的项目的 [**Clusters**](https://tidbcloud.com/project/clusters) 页面。</CustomContent><CustomContent plan="premium">进入 [**TiDB Instances**](https://tidbcloud.com/tidbs) 页面。</CustomContent>

> **Tip:**
>
> 你可以使用左上角的下拉框在组织、项目和集群之间切换。

2. 点击目标集群的名称进入其概览页面,然后在左侧导航栏点击 **Data** > **Changefeed**。此时会显示 changefeed 页面。
2. 点击目标<CustomContent plan="dedicated">集群</CustomContent><CustomContent plan="premium">实例</CustomContent>的名称,进入其概览页面,然后在左侧导航栏点击 **Data** > **Changefeed**。此时会显示 changefeed 页面。

在 **Changefeed** 页面,你可以创建 changefeed,查看已有 changefeed 列表,并对已有 changefeed 进行操作(如扩缩容、暂停、恢复、编辑和删除 changefeed)。

## 创建 changefeed

要创建 changefeed,请参考以下教程:

- [Sink to Apache Kafka](/tidb-cloud/changefeed-sink-to-apache-kafka.md)
- [Sink to MySQL](/tidb-cloud/changefeed-sink-to-mysql.md)
- [Sink to TiDB Cloud](/tidb-cloud/changefeed-sink-to-tidb-cloud.md)
- [Sink to cloud storage](/tidb-cloud/changefeed-sink-to-cloud-storage.md)
- [同步到 Apache Kafka](/tidb-cloud/changefeed-sink-to-apache-kafka.md)
- [同步到 MySQL](/tidb-cloud/changefeed-sink-to-mysql.md)
- [同步到 TiDB Cloud](/tidb-cloud/changefeed-sink-to-tidb-cloud.md)
- [同步到云存储](/tidb-cloud/changefeed-sink-to-cloud-storage.md)

## 查询 Changefeed RCU
## 查询 changefeed 容量

<CustomContent plan="dedicated">

对于 TiDB Cloud Dedicated,你可以查询 changefeed 的 TiCDC Replication Capacity Units(RCU)。

1. 进入目标 TiDB 集群的 [**Changefeed**](#view-the-changefeed-page) 页面。
2. 找到你想要查询的 changefeed,在 **Action** 列点击 **...** > **View**。
3. 你可以在页面的 **Specification** 区域看到当前 TiCDC Replication Capacity Units(RCU)。
3. 你可以在页面的 **Specification** 区域看到当前的 TiCDC Replication Capacity Units(RCU)。

</CustomContent>
<CustomContent plan="premium">

对于 TiDB Cloud Premium,你可以查询 changefeed 的 TiCDC Changefeed Capacity Units(CCU)。

1. 进入目标 TiDB 实例的 [**Changefeed**](#view-the-changefeed-page) 页面。
2. 找到你想要查询的 changefeed,在 **Action** 列点击 **...** > **View**。
3. 你可以在页面的 **Specification** 区域看到当前的 TiCDC Changefeed Capacity Units(CCU)。

</CustomContent>

## 扩缩容 changefeed

你可以通过扩容或缩容 changefeed 来更改 TiCDC Replication Capacity Units(RCU)。
<CustomContent plan="dedicated">

你可以通过扩容或缩容 changefeed 来调整其 TiCDC Replication Capacity Units(RCU)。

> **Note:**
>
> - 若要为某个集群扩缩容 changefeed,请确保该集群的所有 changefeed 均为 2023 年 3 月 28 日之后创建
> - 如果某个集群存在 2023 年 3 月 28 日之前创建的 changefeed,则该集群的现有 changefeed 及新建 changefeed 均不支持扩缩容。
> - 若要为集群扩缩容 changefeed,请确保该集群的所有 changefeed 均创建于 2023 年 3 月 28 日之后
> - 如果集群中存在 2023 年 3 月 28 日之前创建的 changefeed,则该集群的所有 changefeed(包括新建的)均不支持扩缩容。

1. 进入目标 TiDB 集群的 [**Changefeed**](#view-the-changefeed-page) 页面。
</CustomContent>
<CustomContent plan="premium">

你可以通过扩容或缩容 changefeed 来调整其 TiCDC Changefeed Capacity Units(CCU)。

</CustomContent>

1. 进入目标 TiDB <CustomContent plan="dedicated">集群</CustomContent><CustomContent plan="premium">实例</CustomContent>的 [**Changefeed**](#view-the-changefeed-page) 页面。
2. 找到你想要扩缩容的 changefeed,在 **Action** 列点击 **...** > **Scale Up/Down**。
3. 选择新的规格。
4. 点击 **Submit**。

扩缩容过程大约需要 10 分钟(期间 changefeed 正常工作),切换到新规格大约需要几秒钟(期间 changefeed 会自动暂停并恢复)。
扩缩容过程大约需要 10 分钟(期间 changefeed 可正常工作),切换到新规格只需几秒(切换期间 changefeed 会自动暂停并恢复)。

## 暂停或恢复 changefeed

1. 进入目标 TiDB 集群的 [**Changefeed**](#view-the-changefeed-page) 页面。
1. 进入目标 TiDB <CustomContent plan="dedicated">集群</CustomContent><CustomContent plan="premium">实例</CustomContent>的 [**Changefeed**](#view-the-changefeed-page) 页面。
2. 找到你想要暂停或恢复的 changefeed,在 **Action** 列点击 **...** > **Pause/Resume**。

## 编辑 changefeed
Expand All @@ -69,11 +93,11 @@ TiDB Cloud changefeed 帮助你将数据从 TiDB Cloud 流式传输到其他数
>
> TiDB Cloud 目前仅支持在暂停状态下编辑 changefeed。

1. 进入目标 TiDB 集群的 [**Changefeed**](#view-the-changefeed-page) 页面。
1. 进入目标 TiDB <CustomContent plan="dedicated">集群</CustomContent><CustomContent plan="premium">实例</CustomContent>的 [**Changefeed**](#view-the-changefeed-page) 页面。
2. 找到你想要暂停的 changefeed,在 **Action** 列点击 **...** > **Pause**。
3. 当 changefeed 状态变为 `Paused` 后,点击 **...** > **Edit** 编辑对应的 changefeed。

TiDB Cloud 默认会填充 changefeed 配置。你可以修改以下配置项:
TiDB Cloud 会默认填充 changefeed 配置。你可以修改以下配置项:

- Apache Kafka sink:所有配置项。
- MySQL sink:**MySQL Connection**、**Table Filter** 和 **Event Filter**。
Expand All @@ -84,12 +108,12 @@ TiDB Cloud changefeed 帮助你将数据从 TiDB Cloud 流式传输到其他数

## 删除 changefeed

1. 进入目标 TiDB 集群的 [**Changefeed**](#view-the-changefeed-page) 页面。
1. 进入目标 TiDB <CustomContent plan="dedicated">集群</CustomContent><CustomContent plan="premium">实例</CustomContent>的 [**Changefeed**](#view-the-changefeed-page) 页面。
2. 找到你想要删除的 changefeed,在 **Action** 列点击 **...** > **Delete**。

## Changefeed 计费

如需了解 TiDB Cloud 中 changefeed 的计费方式,请参见 [Changefeed billing](/tidb-cloud/tidb-cloud-billing-ticdc-rcu.md)。
要了解 TiDB Cloud 中 changefeed 的计费方式,请参见 [Changefeed 计费](/tidb-cloud/tidb-cloud-billing-ticdc-rcu.md)。

## Changefeed 状态

Expand All @@ -105,5 +129,5 @@ TiDB Cloud changefeed 帮助你将数据从 TiDB Cloud 流式传输到其他数
- `RESUMING`:复制任务正在恢复中。
- `DELETING`:复制任务正在删除中。
- `DELETED`:复制任务已删除。
- `WARNING`:复制任务返回警告。由于某些可恢复的错误,复制无法继续。处于该状态的 changefeed 会持续尝试恢复,直到状态变为 `RUNNING`。该状态下的 changefeed 会阻塞 [GC 操作](https://docs.pingcap.com/tidb/stable/garbage-collection-overview)。
- `WARNING`:复制任务返回警告。由于某些可恢复错误,复制无法继续。处于该状态的 changefeed 会持续尝试恢复,直到状态变为 `RUNNING`。该状态下的 changefeed 会阻塞 [GC 操作](https://docs.pingcap.com/tidb/stable/garbage-collection-overview)。
- `FAILED`:复制任务失败。由于某些错误,复制任务无法恢复且无法自动修复。如果在增量数据的垃圾回收(GC)之前解决了问题,你可以手动恢复失败的 changefeed。增量数据的默认生存时间(TTL)为 24 小时,即 changefeed 中断后 24 小时内 GC 机制不会删除任何数据。
Loading