Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add binlog usage restrictions #5832

Merged
merged 6 commits into from
Mar 25, 2021
Merged

add binlog usage restrictions #5832

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
a14941c
add binlog usage restrictions
IANTHEREAL Mar 25, 2021
4396f9d
Update tidb-binlog-overview.md
IANTHEREAL Mar 25, 2021
02170dd
Update tidb-binlog-overview.md
IANTHEREAL Mar 25, 2021
495bb6b
Update tidb-binlog/tidb-binlog-overview.md
IANTHEREAL Mar 25, 2021
d98080c
Update tidb-binlog/tidb-binlog-overview.md
IANTHEREAL Mar 25, 2021
cd3dddd
Update tidb-binlog/tidb-binlog-overview.md
IANTHEREAL Mar 25, 2021
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
14 changes: 13 additions & 1 deletion tidb-binlog/tidb-binlog-overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,10 @@ TiDB Binlog 支持以下功能场景：
- **数据同步**：同步 TiDB 集群数据到其他数据库
- **实时备份和恢复**：备份 TiDB 集群数据，同时可以用于 TiDB 集群故障时恢复

> **注意：**
>
> TiDB Binlog 与 TiDB v5.0.0-rc 版本开始引入的一些特性不兼容，无法一起使用，详情参照[注意事项](#注意事项)。建议使用 [TiCDC](/ticdc/ticdc-overview.md) 替代 TiDB Binlog。

## TiDB Binlog 整体架构

![TiDB Binlog 架构](/media/tidb-binlog-cluster-architecture.png)
Expand Down Expand Up @@ -45,7 +49,15 @@ TiDB Binlog 集群主要分为 Pump 和 Drainer 两个组件，以及 binlogctl

## 注意事项

* 需要使用 TiDB v2.0.8-binlog、v2.1.0-rc.5 及以上版本，否则不兼容该版本的 TiDB Binlog。
* TiDB Binlog 与 TiDB v5.0.0-rc 版本开始引入的以下特性不兼容，无法一起使用：

- [TiDB 聚簇索引特性](/clustered-indexes.md#限制)：开启 TiDB Binlog 后 TiDB 不允许创建非单个整数列作为主键的聚簇索引；已创建的聚簇索引表的数据插入、删除和更新动作不会通过 TiDB Binlog 同步到下游。如需同步聚簇索引表，请使用 [TiCDC](/ticdc/ticdc-overview.md)；
- TiDB 系统变量 [tidb_enable_async_commit](/system-variables.md#tidb_enable_async_commit-从-v500-rc-版本开始引入)：启用 TiDB Binlog 后，开启该选项无法获得性能提升。要获得性能提升，建议使用 [TiCDC](/ticdc/ticdc-overview.md) 替代 TiDB Binlog。
- TiDB 系统变量 [tidb_enable_1pc](/system-variables.md#tidb_enable_1pc-从-v500-rc-版本开始引入)：启用 TiDB Binlog 后，开启该选项无法获得性能提升。要获得性能提升，建议使用 [TiCDC](/ticdc/ticdc-overview.md) 替代 TiDB Binlog。

* TiDB Binlog 与 TiDB v4.0.7 版本开始引入的以下特性不兼容，无法一起使用：

- TiDB 系统变量 [tidb_enable_amend_pessimistic_txn](/system-variables.md#tidb_enable_amend_pessimistic_txn-从-v407-版本开始引入)：两个功能存在兼容性问题，一起使用会造成 TiDB Binlog 复制数据不一致的正确性问题。
Comment on lines +58 to +60
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这个提醒得 cherry-pick 到 4.0 文档吧？

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

可以，这个合并后，我把这段挪过去


* Drainer 支持将 Binlog 同步到 MySQL、TiDB、Kafka 或者本地文件。如果需要将 Binlog 同步到其他 Drainer 不支持的类型的系统中，可以设置 Drainer 将 Binlog 同步到 Kafka，然后根据 binlog consumer protocol 进行定制处理，参考 [Binlog Consumer Client 用户文档](/tidb-binlog/binlog-consumer-client.md)。

Expand Down