Skip to content

Commit

Permalink
*: optimize 4 docs descriptions (#15191) (#15246)
Browse files Browse the repository at this point in the history
  • Loading branch information
ti-chi-bot authored Oct 17, 2023
1 parent 49ca0fd commit 9550d20
Show file tree
Hide file tree
Showing 2 changed files with 24 additions and 17 deletions.
27 changes: 15 additions & 12 deletions quick-start-with-tidb.md
Original file line number Diff line number Diff line change
Expand Up @@ -269,12 +269,12 @@ TiDB 是一个分布式系统。最基础的 TiDB 测试集群通常由 2 个 Ti

### 准备环境

准备一台部署主机,确保其软件满足需求:
开始部署 TiDB 集群前,准备一台部署主机,确保其软件满足需求:

- 推荐安装 CentOS 7.3 及以上版本
- 运行环境可以支持互联网访问,用于下载 TiDB 及相关软件安装包

最小规模的 TiDB 集群拓扑
最小规模的 TiDB 集群拓扑包含以下实例

> **注意:**
>
Expand All @@ -288,7 +288,7 @@ TiDB 是一个分布式系统。最基础的 TiDB 测试集群通常由 2 个 Ti
| TiFlash | 1 | 10.0.1.1 | 默认端口 <br/> 全局目录配置 |
| Monitor | 1 | 10.0.1.1 | 默认端口 <br/> 全局目录配置 |

部署主机软件和环境要求
部署主机软件和环境要求如下

- 部署需要使用部署主机的 root 用户及密码
- 部署主机[关闭防火墙](/check-before-deployment.md#检测及关闭目标部署机器的防火墙)或者开放 TiDB 集群的节点间所需端口
Expand Down Expand Up @@ -491,14 +491,17 @@ TiDB 是一个分布式系统。最基础的 TiDB 测试集群通常由 2 个 Ti
## 探索更多
- 如果你刚刚部署好一套 TiDB 本地测试集群:
- 学习 [TiDB SQL 操作](/basic-sql-operations.md)
- [迁移数据到 TiDB](/migration-overview.md)
如果你刚刚部署好一套 TiDB 本地测试集群,你可以继续:
- 如果你准备好在生产环境部署 TiDB 了:
- 在线部署:[使用 TiUP 部署 TiDB 集群](/production-deployment-using-tiup.md)
- [使用 TiDB Operator 在云上部署 TiDB](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable)
- 学习 [TiDB SQL 操作](/basic-sql-operations.md)
- [迁移数据到 TiDB](/migration-overview.md)
- 如果你想使用 TiFlash 作为数据分析的解决方案,可参阅以下文档:
- [使用 TiFlash](/tiflash/tiflash-overview.md#使用-tiflash)
- [TiFlash 简介](/tiflash/tiflash-overview.md)
如果你准备好在生产环境部署 TiDB,你可以继续:
- [使用 TiUP 部署 TiDB 集群](/production-deployment-using-tiup.md)
- [使用 TiDB Operator 在 Kubernetes 上部署 TiDB](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable)
如果你想使用 TiFlash 作为数据分析的解决方案,可参阅以下文档:
- [使用 TiFlash](/tiflash/tiflash-overview.md#使用-tiflash)
- [TiFlash 简介](/tiflash/tiflash-overview.md)
14 changes: 9 additions & 5 deletions ticdc/ticdc-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,13 +8,17 @@ title: TiCDC 简介

## TiCDC 适用场景

TiCDC 适用于以下场景:

- 提供多 TiDB 集群,跨区域数据高可用和容灾方案,保证在灾难发生时保证主备集群数据的最终一致性。
- 提供同步实时变更数据到异构系统的服务,为监控、缓存、全文索引、数据分析、异构数据库使用等场景提供数据源。

## TiCDC 主要特性

### 核心能力

TiCDC 提供了以下核心能力:

- 提供 TiDB -> TiDB 之间数据容灾复制的能力,实现秒级别 RPO 和分钟级别 RTO
- 提供 TiDB 之间双向复制的能力,支持通过 TiCDC 构建多写多活的 TiDB 集群
- 提供 TiDB -> MySQL(或其他兼容 MySQL 协议的数据库)的低延迟的增量数据同步能力
Expand All @@ -28,10 +32,10 @@ title: TiCDC 简介

- TiCDC 对于所有的 DDL/DML 都能对外输出**至少一次**
- TiCDC 在 TiKV/TiCDC 集群故障期间可能会重复发相同的 DDL/DML。对于重复的 DDL/DML:
- MySQL sink 可以重复执行 DDL,对于在下游可重入的 DDL (譬如 truncate table)直接执行成功;对于在下游不可重入的 DDL(譬如 create table),执行失败,TiCDC 会忽略错误继续同步。
- Kafka sink
- Kafka sink 提供不同的数据分发策略,可以按照表、主键或 ts 等策略分发数据到不同 Kafka partition。 使用表、主键分发策略,可以保证某一行的更新数据被顺序的发送到相同 partition。
- 对所有的分发策略,我们都会定期发送 Resolved TS 消息到所有的 topic/partition,表示早于该 Resolved TS 的消息都已经发送到 topic/partition,消费程序可以利用 Resolved TS 对多个 topic/partition 的消息进行排序。
- MySQL sink 可以重复执行 DDL,对于在下游可重入的 DDL(譬如 `TRUNCATE TABLE`)直接执行成功;对于在下游不可重入的 DDL(譬如 `CREATE TABLE`),执行失败,TiCDC 会忽略错误继续同步。
- Kafka sink 提供不同的数据分发策略:
- 可以按照表、主键或 ts 等策略分发数据到不同 Kafka partition。使用表、主键分发策略,可以保证某一行的更新数据被顺序的发送到相同 partition。
- 对所有的分发策略,TiCDC 都会定期发送 Resolved TS 消息到所有的 topic/partition,表示早于该 Resolved TS 的消息都已经发送到 topic/partition,消费程序可以利用 Resolved TS 对多个 topic/partition 的消息进行排序。
- Kafka sink 会发送重复的消息,但重复消息不会破坏 Resolved TS 的约束,比如在 changefeed 暂停重启后,可能会按顺序发送 msg1、msg2、msg3、msg2、msg3。你可以在 Kafka 消费端进行过滤。

### 数据同步一致性
Expand All @@ -44,7 +48,7 @@ title: TiCDC 简介

> **注意:**
>
> 从 v6.2 版本起,你可以通过配置 sink uri 参数 [`transaction-atomicity`](/ticdc/ticdc-sink-to-mysql.md#sink-uri-配置-mysqltidb) 来控制 TiCDC 是否拆分单表事务。拆分事务可以大幅降低 MySQL sink 同步大事务的延时和内存消耗。
> 从 v6.2 版本起,你可以通过配置 sink URI 参数 [`transaction-atomicity`](/ticdc/ticdc-sink-to-mysql.md#sink-uri-配置-mysqltidb) 来控制 TiCDC 是否拆分单表事务。拆分事务可以大幅降低 MySQL sink 同步大事务的延时和内存消耗。
## TiCDC 架构

Expand Down

0 comments on commit 9550d20

Please sign in to comment.