# Binlog 同步

Binlog 同步功能可将 TiDB 的增量数据实时同步到其他存储中。 支持 MySQL、TiDB、Kafka、US3作为目标存储。

## 进入管理页面

在产品主页中找到对应的实例， 点击“详情”按钮进入详情页面。

<!-- image-todo -->

## 开启 Binlog

切换到 “Binlog同步” 面板

<!-- image-todo -->

Binlog 同步服务默认不开启，点击“同步服务”开关打开开启窗口 

<!-- image-todo -->

设置Binlog保存周期， 默认为“7”， 保存7天（支持范围1～14天）。
<!-- image-todo -->

成功开启后“同步服务”状态更新为“已开启”
<!-- image-todo -->

## 全量数据迁移，记录CommitTS数据

推荐使UDTS进行全量迁移，成功完成全量迁移后，UDTS会返回CommitTS数据。 

<!-- image-todo -->

> 如果当前为空数据库或者不需要迁移存量数据的时候可不进行全量迁移，通过点击“获取CommitTs”按钮获取当前CommitTS。
<!-- image-todo -->

## 添加消费者

点击“添加消费者”按钮打开添加窗口， 可为一个实例添加多个消费者。
<!-- image-todo -->

选择MySQL协议消费者（如MySQL数据库、TiDB数据库或者其它兼容MySQL协议的数据库）或者Kafka， 输入上一步中获取的CommitTS数据以及其它需求信息完成添加。
<!-- image-todo -->

## 查看消费者

在“第三步: Binlog消费者”中，会列出当前已有的消费者，可根据右上角不同协议查看对应协议消费者列表。

<!-- image-todo -->

## 删除消费者

当需要删除某个消费者的时候， 可在消费者列表中通过“删除”按钮删除。

<!-- image-todo -->

## 修改 Binlog GC

Binlog 保留周期， 可在开启Binlog功能的时候设置或在Binlog开启之后通过点击“BinlogGC”编辑按钮调整。 

<!-- image-todo -->

<!-- image-todo -->

## 关闭 Binlog

在不需要使用Binlog功能时建议关闭Binlog服务。即可降低成本，又可提高性能。

>在关闭Binlog之前必需先删除所有的消费者。

在“第一步：Binlog同步服务”中点击“同步服务”开关来关闭Binlog服务。
<!-- image-todo -->