Skip to content
Merged
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
1 change: 1 addition & 0 deletions TOC-tidb-cloud-premium.md
Original file line number Diff line number Diff line change
Expand Up @@ -140,6 +140,7 @@
- [Changefeed 概述](/tidb-cloud/changefeed-overview.md)
- [到 MySQL Sink](/tidb-cloud/changefeed-sink-to-mysql.md)
- [到 Kafka Sink](/tidb-cloud/changefeed-sink-to-apache-kafka.md)
- [到 Cloud Storage](/tidb-cloud/changefeed-sink-to-cloud-storage.md)
- 参考
- [在 AWS 中设置自托管 Kafka Private Link 服务](/tidb-cloud/setup-aws-self-hosted-kafka-private-link-service.md)
- [为 Changefeed 设置 Private Endpoint](/tidb-cloud/premium/set-up-sink-private-endpoint-premium.md)
Expand Down
2 changes: 1 addition & 1 deletion latest_translation_commit.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{
"target": "release-8.5",
"sha": "ad7f1b4760bc8f86f79ae78abe9fa6728d70c8db"
"sha": "7e1eca1c6d085d3c8d5c51d9a7523091d351cff2"
}
6 changes: 3 additions & 3 deletions sql-plan-management.md
Original file line number Diff line number Diff line change
Expand Up @@ -198,7 +198,7 @@ explain SELECT * FROM t1, t2 WHERE t1.id = t2.id;

当第一次执行 `SELECT` 语句时,优化器通过 GLOBAL 作用域下的绑定为语句添加 `sm_join(t1, t2)` Hint,`explain` 结果中的执行计划顶层节点为 MergeJoin。当第二次执行 `SELECT` 语句时,优化器使用 SESSION 作用域下的绑定而不是 GLOBAL 作用域下的绑定,为语句添加 `hash_join(t1, t2)` Hint,`explain` 结果中的执行计划顶层节点为 HashJoin。

每个标准化 SQL 语句同一时间只能有一个通过 `CREATE BINDING` 创建的绑定。当为同一标准化 SQL 语句创建多个绑定时,最后创建的绑定会被保留,之前所有的绑定(包括手动创建和演化的)都会被标记为已删除。但 session 绑定和 global 绑定可以共存,不受此逻辑影响。
每个标准化后的 SQL 语句同一时间只能有一个通过 `CREATE BINDING` 创建的绑定。当为同一标准化后的 SQL 语句创建多个绑定时,最后创建的绑定会被保留,之前所有的绑定(包括手动创建和演化的)都会被标记为已删除。但 session 绑定和 global 绑定可以共存,不受此逻辑影响。

此外,创建绑定时,TiDB 要求 session 处于数据库上下文中,即客户端连接时已指定数据库或已执行 `use ${database}`。

Expand Down Expand Up @@ -800,9 +800,9 @@ CREATE GLOBAL BINDING for SELECT * FROM t WHERE a < 100 AND b < 100 USING SELECT

由于基线演化会自动创建新绑定,当查询环境发生变化时,自动创建的绑定可能存在多种行为选择。请注意以下事项:

+ 基线演化仅对至少有一个全局绑定的标准化 SQL 语句进行演化。
+ 基线演化仅对至少有一个全局绑定的标准化后的 SQL 语句进行演化。

+ 由于创建新绑定会删除之前所有绑定(针对同一标准化 SQL 语句),手动创建新绑定后,自动演化的绑定会被删除。
+ 由于创建新绑定会删除之前所有绑定(针对同一标准化后的 SQL 语句),手动创建新绑定后,自动演化的绑定会被删除。

+ 演化过程中会保留所有与计算过程相关的 Hint,包括:

Expand Down
2 changes: 2 additions & 0 deletions tidb-cloud/architecture-concepts.md
Original file line number Diff line number Diff line change
Expand Up @@ -103,6 +103,8 @@ BYOC 提供以下特性:

为满足不同工作负载的需求,TiDB Cloud BYOC 同时支持 Single-AZ 和 Multi-AZ 部署,使你能够在更低延时的单可用区部署和跨多个可用区的更高韧性部署之间进行选择。

你可以在[创建资源池](/tidb-cloud/byoc/create-resource-pool-byoc.md)时,将每个资源池的高可用模式设置为 **Zonal** 或 **Regional**。Zonal 资源池部署在单个可用区中,而 Regional 资源池部署在多个可用区中。TiDB Cloud 会根据 BYOC Region 配置和可用的云资源来确定可用区放置。 在资源池中创建或恢复的 TiDB Cloud BYOC 实例会继承该资源池的高可用模式。资源池创建后,你无法更改其高可用模式或可用区放置。

![TiDB Cloud BYOC Architecture](/media/tidb-cloud/byoc-architecture.png)

一个 TiDB Cloud BYOC 部署包含以下主要组件:
Expand Down
106 changes: 96 additions & 10 deletions tidb-cloud/changefeed-sink-to-cloud-storage.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,53 @@
---
title: Sink to Cloud Storage
summary: 本文档介绍如何创建 changefeed,将数据从 TiDB Cloud 流式同步到 Amazon S3、Google Cloud Storage (GCS) 或 Azure Blob Storage。内容包括限制、目标端配置、同步与规范配置,以及启动同步流程。
summary: 本文档介绍如何创建 changefeed,将数据从 TiDB Cloud 流式同步到云存储。内容包括限制、目标端配置、同步与规范配置,以及启动同步流程。
---

# Sink to Cloud Storage

本文档描述如何创建 changefeed,将数据从 TiDB Cloud 流式同步到云存储。目前支持 Amazon S3、Google Cloud Storage (GCS) 和 Azure Blob Storage。
本文档介绍如何创建 changefeed,将数据从 <CustomContent plan="dedicated">TiDB Cloud Dedicated</CustomContent><CustomContent plan="premium">TiDB Cloud Premium</CustomContent> 同步到云存储。

<CustomContent plan="dedicated">

> **注意:**
>
> - 若要将数据从 {{{ .dedicated }}} 同步到云存储,请确保你的 TiDB 集群版本为 v7.1.1 或更高版本。如需将 TiDB Cloud Dedicated 集群升级到 v7.1.1 或更高版本,请[联系 TiDB Cloud Support](/tidb-cloud/tidb-cloud-support.md)。
> - 对于 [{{{ .starter }}}](/tidb-cloud/select-cluster-tier.md#starter) 实例,changefeed 功能不可用。
> - 对于 [{{{ .essential }}}](/tidb-cloud/select-cluster-tier.md#essential) 实例,changefeed 功能仅可按请求提供。更多信息,参见 [Changefeed](/tidb-cloud/essential-changefeed-overview.md)。
> - 对于 [{{{ .premium }}}](/tidb-cloud/select-cluster-tier.md#premium) 实例,参见 [Sink to Cloud Storage](https://docs.pingcap.com/tidbcloud/changefeed-sink-to-cloud-storage/?plan=premium)。

</CustomContent>

<CustomContent plan="premium">

> **注意:**
>
> - 若要将数据同步到云存储,请确保你的 TiDB 集群版本为 v7.1.1 或更高。如需将 TiDB Cloud Dedicated 集群升级到 v7.1.1 或更高版本,请[联系 TiDB Cloud Support](/tidb-cloud/tidb-cloud-support.md)。
> - 对于 [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) 实例,changefeed 功能不可用。
> - 对于 [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 实例,changefeed 功能仅可按请求提供。更多信息,参见 [Changefeed](/tidb-cloud/essential-changefeed-overview.md)。
> - 对于 [{{{ .starter }}}](/tidb-cloud/select-cluster-tier.md#starter) 实例,changefeed 功能不可用。
> - 对于 [{{{ .essential }}}](/tidb-cloud/select-cluster-tier.md#essential) 实例,changefeed 功能仅可按请求提供。更多信息,参见 [Changefeed](/tidb-cloud/essential-changefeed-overview.md)。
> - 对于 [{{{ .dedicated }}}](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群,参见 [Sink to Cloud Storage](https://docs.pingcap.com/tidbcloud/changefeed-sink-to-cloud-storage/)。

</CustomContent>

## 限制

- 每个 TiDB Cloud Dedicated 集群最多可创建 100 个 changefeed。
- 每个 <CustomContent plan="dedicated">TiDB Cloud Dedicated 集群</CustomContent><CustomContent plan="premium">TiDB Cloud Premium 实例</CustomContent> 最多可创建 100 个 changefeed。
- 由于 TiDB Cloud 使用 TiCDC 建立 changefeed,因此具有与 [TiCDC 相同的限制](https://docs.pingcap.com/tidb/stable/ticdc-overview#unsupported-scenarios)。
- 如果待同步的表没有主键或非空唯一索引,则在某些重试场景下,由于同步过程中缺乏唯一约束,可能会导致下游插入重复数据。

## 步骤 1. 配置目标端

<CustomContent plan="dedicated">

进入目标 TiDB Cloud Dedicated 集群的总览页面。在左侧导航栏点击 **Data** > **Changefeed**,点击 **Create Changefeed** 进入 **Destination** 页面,然后根据 TiDB Cloud Dedicated 集群所在云服务商选择 **Amazon S3**、**GCS** 或 **Azure Blob Storage** 作为目标端。不同目标端的配置流程有所不同。

</CustomContent>

<CustomContent plan="premium">

进入目标 TiDB Cloud Premium 实例的总览页面。在左侧导航栏点击 **Data** > **Changefeed**,点击 **Create Changefeed** 进入 **Destination** 页面,然后根据 TiDB Cloud Premium 实例所在云服务商选择 **Amazon S3** 或 **Alibaba Cloud OSS** 作为目标端。不同目标端的配置流程有所不同。

</CustomContent>

<SimpleTab>
<div label="Amazon S3">

Expand All @@ -32,7 +57,7 @@ summary: 本文档介绍如何创建 changefeed,将数据从 TiDB Cloud 流式

如需使用 IAM Role 进行认证,请按以下步骤操作:

1. 在 Amazon S3 的 **Destination** 页面,填写 **S3 URI**。确保 S3 bucket TiDB 集群处于同一 AWS 区域。
1. 在 Amazon S3 的 **Destination** 页面,填写 **S3 URI**。确保 S3 bucket 与你的 <CustomContent plan="dedicated">TiDB Cloud Dedicated 集群</CustomContent><CustomContent plan="premium">TiDB Cloud Premium 实例</CustomContent> 处于同一 AWS 区域。
2. 在 **Bucket Access** 下选择 **AWS Role ARN**。
3. 若需创建新的 Role ARN,点击 **Click here to create new one with AWS CloudFormation**。该模板会自动配置所需权限。

Expand All @@ -55,14 +80,17 @@ summary: 本文档介绍如何创建 changefeed,将数据从 TiDB Cloud 流式

如需使用 access key 认证,请按以下步骤操作:

1. 在 Amazon S3 的 **Destination** 页面,填写 **S3 URI**。确保 S3 bucket TiDB 集群处于同一 AWS 区域。
1. 在 Amazon S3 的 **Destination** 页面,填写 **S3 URI**。确保 S3 bucket 与你的 <CustomContent plan="dedicated">TiDB Cloud Dedicated 集群</CustomContent><CustomContent plan="premium">TiDB Cloud Premium 实例</CustomContent> 处于同一 AWS 区域。
2. 在 **Bucket Access** 下选择 **AWS Access Key**。
3. 填写以下内容
3. 填写以下字段

- **Access Key ID**
- **Secret Access Key**

</div>

<CustomContent plan="dedicated">

<div label="GCS">

对于 **GCS**,在填写 **GCS Endpoint** 前,需要先授予 GCS bucket 访问权限。请按以下步骤操作:
Expand Down Expand Up @@ -118,6 +146,11 @@ summary: 本文档介绍如何创建 changefeed,将数据从 TiDB Cloud 流式
7. 在 TiDB Cloud 控制台,进入 Changefeed 的 **Destination** 页面,在 **bucket gsutil URI** 输入框中填写 URI。

</div>

</CustomContent>

<CustomContent plan="dedicated">

<div label="Azure Blob Storage">

对于 **Azure Blob Storage**,你需要先在 Azure 门户配置容器并获取 SAS token。请按以下步骤操作:
Expand Down Expand Up @@ -158,9 +191,62 @@ summary: 本文档介绍如何创建 changefeed,将数据从 TiDB Cloud 流式
- **SAS Token**:输入第 3 步获取的 SAS token。

</div>

</CustomContent>

<CustomContent plan="premium">

<div label="Alibaba Cloud OSS">

对于 **Alibaba Cloud OSS**,请按以下步骤配置 changefeed:

1. 在 [Alibaba Cloud 控制台](https://www.alibabacloud.com/)中,完成以下前置步骤:

1. 创建一个与 TiDB Cloud Premium 实例位于同一 Region 的 OSS bucket。详细操作请参见 [Create a bucket](https://www.alibabacloud.com/help/en/oss/user-guide/create-a-bucket-4)。
2. 为 changefeed 创建一个 RAM 用户,并生成一对 AccessKey。详细操作请参见 [Create an AccessKey pair](https://www.alibabacloud.com/help/en/ram/user-guide/create-an-accesskey-pair)。
3. 为该 RAM 用户创建并绑定一个自定义 RAM policy,仅授予 changefeed 所需的最小权限。更多信息请参见 [Control access to OSS resources with RAM policies](https://www.alibabacloud.com/help/en/oss/user-guide/ram-policy)。

- `oss:ListObjects`
- `oss:GetObject`
- `oss:PutObject`
- `oss:DeleteObject`

以下 JSON 示例展示了包含所需权限的 policy。请将 `<Your bucket name>` 替换为你的 OSS bucket 名称。

```json
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": [
"oss:ListObjects",
"oss:GetObject",
"oss:PutObject",
"oss:DeleteObject"
],
"Resource": [
"acs:oss:*:*:<Your bucket name>",
"acs:oss:*:*:<Your bucket name>/*"
]
}
]
}
```

2. 在 Alibaba Cloud OSS 的 **Destination** 页面,填写以下字段:

- **Bucket URI**:输入格式为 `oss://<Your bucket name>/<prefix>/` 的 OSS URI。
- **Access Key ID**:输入 RAM 用户的 AccessKey ID。
- **Access Key Secret**:输入 RAM 用户的 AccessKey Secret。

</div>

</CustomContent>

</SimpleTab>

点击 **Next**,建立 TiDB Cloud Dedicated 集群与 Amazon S3、GCS 或 Azure Blob Storage 的连接。TiDB Cloud 会自动测试并验证连接是否成功。
点击 **Next**,建立从 <CustomContent plan="dedicated">TiDB Cloud Dedicated 集群</CustomContent><CustomContent plan="premium">TiDB Cloud Premium 实例</CustomContent> 到你的云存储的连接。TiDB Cloud 会自动测试并验证连接是否成功。

- 若连接成功,将进入下一步配置。
- 若连接失败,会显示连接错误,你需要处理该错误。错误解决后,点击 **Next** 重试连接。
Expand Down
16 changes: 14 additions & 2 deletions tidb-cloud/premium/backup-and-restore-premium.md
Original file line number Diff line number Diff line change
Expand Up @@ -242,7 +242,13 @@ TiDB Cloud 支持将数据恢复到新实例。

<CustomContent plan="byoc">

对于 {{{ .byoc }}},请选择与备份位于同一云服务提供商和 region 的活跃资源池。如果没有可用的合适资源池,`Organization Owner` 可以在恢复实例前创建一个。其他角色无法创建资源池。更多信息,请参见 [Create a Resource Pool](/tidb-cloud/byoc/create-resource-pool-byoc.md)。
对于 {{{ .byoc }}},请选择与备份位于同一云服务提供商和 region 的活跃资源池。恢复后的实例会继承所选资源池的高可用模式。你可以将同一备份恢复到单可用区或多可用区资源池。如果没有可用的合适资源池,`Organization Owner` 可以在恢复实例前创建一个。其他角色无法创建资源池。更多信息,请参见 [Create a Resource Pool](/tidb-cloud/byoc/create-resource-pool-byoc.md)。

如果所选资源池设置了 Pool vCPU Limit,且其当前已配置的 vCPU 大于或等于该限制,TiDB Cloud 会显示警告,并且你无法将实例恢复到该资源池。要继续,请前往 Resource Pool 详情页面,提高或关闭 Pool vCPU Limit,或选择另一个资源池。

> **Note:**
>
> 即使当前已配置的 vCPU 低于 Pool vCPU Limit,恢复实例也可能导致总已配置 vCPU 超过该限制。这可能会限制资源扩缩容并降低资源池中所有实例的性能。在恢复实例之前,请确保资源池具有足够的 vCPU 容量。如有必要,请提高或关闭 Pool vCPU Limit,或选择另一个资源池。

</CustomContent>

Expand Down Expand Up @@ -366,7 +372,13 @@ TiDB Cloud 支持将数据恢复到新实例。

<CustomContent plan="byoc">

对于 {{{ .byoc }}},请选择一个与目标云服务提供商和 region 匹配的活跃资源池。如果没有可用的合适资源池,`Organization Owner` 可以在恢复实例之前创建一个。其他角色无法创建资源池。更多信息,请参见 [Create a Resource Pool](/tidb-cloud/byoc/create-resource-pool-byoc.md)。
对于 {{{ .byoc }}},请选择一个与目标云服务提供商和 region 匹配的活跃资源池。恢复后的实例会继承所选资源池的高可用模式。你可以将同一备份恢复到单可用区或多可用区资源池。如果没有可用的合适资源池,`Organization Owner` 可以在恢复实例之前创建一个。其他角色无法创建资源池。更多信息,请参见 [Create a Resource Pool](/tidb-cloud/byoc/create-resource-pool-byoc.md)。

如果所选资源池设置了 Pool vCPU Limit,且其当前已配置的 vCPU 大于或等于该限制,TiDB Cloud 会显示警告,并且你无法将实例恢复到该资源池。要继续,请前往 Resource Pool 详情页面,提高或关闭 Pool vCPU Limit,或选择另一个资源池。

> **Note:**
>
> 即使当前已配置的 vCPU 低于 Pool vCPU Limit,恢复实例也可能导致总已配置 vCPU 超过该限制。这可能会限制资源扩缩容并影响资源池中所有实例的性能。在恢复实例之前,请确保资源池具有足够的 vCPU 容量。如有必要,请提高或关闭 Pool vCPU Limit,或选择另一个资源池。

</CustomContent>

Expand Down
12 changes: 12 additions & 0 deletions tidb-cloud/releases/tidb-cloud-release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,18 @@ aliases: ['/zh/tidbcloud/supported-tidb-versions','/zh/tidbcloud/release-notes',

本页面列出了 [TiDB Cloud](https://www.pingcap.com/tidb-cloud/) 在 2026 年的发布说明。

## 2026 年 8 月 25 日 {#august-25-2026}

**常规变更**

- **TiDB Cloud Premium**

- TiDB Cloud Premium 现已支持将 changefeed 数据直接同步到 Amazon S3 和阿里云对象存储服务(OSS)。

此功能使你能够将变更数据归档到云存储中,用于下游分析和长期保留,同时通过消除对中间消息队列的需求来降低成本。

更多信息,请参见 [Sink to Cloud Storage](https://docs.pingcap.com/tidbcloud/changefeed-sink-to-cloud-storage/?plan=premium)。

## 2026 年 8 月 18 日 {#august-18-2026}

**常规变更**
Expand Down
5 changes: 2 additions & 3 deletions tidb-cloud/tidb-cloud-billing.md
Original file line number Diff line number Diff line change
Expand Up @@ -103,10 +103,9 @@ TiDB Cloud 根据你所消耗的资源进行收费。

> **注意:**
>
> 月账单中的总金额可能与每日使用明细中的总金额不同,这是由于精度差异造成的:
> 你的 **Bills** 数据以及 **Cost Explorer** 或 **Usage Details** CSV 下载中的数据会以不同的粒度进行处理和展示。**Bills** 数据按月结算计算,而 **Cost Explorer** 和 **Usage Details** CSV 下载则提供更细粒度的明细,例如按天、服务、项目、集群或资源划分。因此,由于不同聚合级别的舍入,总金额可能会略有差异。
>
> - 月账单中的总金额会四舍五入到小数点后第 2 位。
> - 每日使用明细中的总金额精确到小数点后第 6 位。
> **Cost Explorer** 和 **Usage Details** CSV 下载用于使用量和成本分析。如果这些数据源之间存在差异,发票上显示的金额是你最终应支付的金额。

以下是与存储相关的计费说明:

Expand Down
Loading