TiDB Binlog Cluster 版本升级方法

新版本的 TiDB(v2.0.8-binlog、v2.1.0-rc.5 及以上版本)不兼容 Kafka 版本以及 Local 版本的 TiDB Binlog,集群升级到新版本后只能使用 Cluster 版本的 TiDB Binlog。如果在升级前已经使用了 Kafka/Local 版本的 TiDB Binlog,必须将其升级到 Cluster 版本。

TiDB Binlog 版本与 TiDB 版本的对应关系如下:

| TiDB Binlog 版本 | TiDB 版本 | 说明 | |||| | Local | TiDB 1.0 及更低版本 || | Kafka | TiDB 1.0 ~ TiDB 2.1 RC5 | TiDB 1.0 支持 local 版本和 Kafka 版本的 TiDB Binlog。 | | Cluster | TiDB v2.0.8-binlog,TiDB 2.1 RC5 及更高版本 | TiDB v2.0.8-binlog 是一个支持 Cluster 版本 TiDB Binlog 的 2.0 特殊版本。 |

升级流程

注意:

如果能接受重新导全量数据,则可以直接废弃老版本,按 TiDB Binlog 集群部署中的步骤重新部署。

如果想从原来的 checkpoint 继续同步,使用以下升级流程:

  1. 部署新版本 Pump。
  2. 暂停 TiDB 集群业务。
  3. 更新 TiDB 以及配置,写 Binlog 到新的 Pump Cluster。
  4. TiDB 集群重新接入业务。
  5. 确认老版本的 Drainer 已经将老版本的 Pump 的数据完全同步到下游。

    查询 Drainer 的 status 接口,示例命令如下:

    1. $ curl 'http://172.16.10.49:8249/status'
    2. {"PumpPos":{"172.16.10.49:8250":{"offset":32686}},"Synced": true ,"DepositWindow":{"Upper":398907800202772481,"Lower":398907799455662081}}

    如果返回的 Synced 为 true,则可以认为 Binlog 数据已经全部同步到了下游。

  6. 启动新版本 Drainer;

  7. 下线老版本的 Pump、Drainer 以及依赖的 Kafka 和 ZookeSeper。