TDengine双活部署架构详解与实战指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00031/article/details/148361883

TDengine双活部署架构详解与实战指南

TDengine TDengine is an open source, high-performance, cloud native time-series database optimized for Internet of Things (IoT), Connected Cars, Industrial IoT and DevOps. 项目地址: https://gitcode.com/gh_mirrors/tde/TDengine

什么是TDengine双活部署

TDengine的双活部署(Active-Active Deployment)是一种高可用性架构设计，通过在两套独立的TDengine部署之间建立实时数据同步机制，确保当主节点不可用时能够自动切换到备用节点，为业务提供持续稳定的数据库服务。

双活架构的核心价值

高可用性保障：主节点故障时自动切换，业务无感知
灾难恢复能力：支持异地数据副本，满足容灾需求
资源高效利用：相比传统主备模式，双活架构能更充分利用资源
数据一致性：通过WAL日志实现可靠的数据同步

架构原理

双活部署包含两个对等的TDengine节点（可以是单实例或集群），通过内置的数据订阅组件实现双向数据同步。关键设计特点包括：

双向数据流：主节点和备节点互为源端和目标端
防循环机制：同步数据会特殊标记，避免无限循环复制
自动故障转移：客户端驱动自动检测并切换连接

部署前提条件

企业版TDengine支持此功能
两套部署的配置必须完全一致，包括：
- 数据库名称
- 所有配置参数
- 用户账号和权限设置
确保taosd和taosx服务正常运行

详细配置步骤

1. 初始化双活环境

在两台服务器上分别部署完全相同的TDengine环境，确保：

版本一致
配置文件相同
数据库结构一致

2. 启动复制服务

在主节点执行：

taosx replica start -f primary.example.com:6030 -t secondary.example.com:6030

在备节点执行反向配置：

taosx replica start -f secondary.example.com:6030 -t primary.example.com:6030

参数说明：

-f：源端FQDN（本机地址）
-t：目标端FQDN（对端地址）
可指定特定数据库，不指定则同步所有非系统库

3. 高级配置选项

--new-database-checking-interval：设置新库检测间隔（秒）
--no-new-databases：禁用新库自动检测

客户端配置要点

目前仅Java客户端通过WebSocket连接支持双活模式，关键配置参数：

properties.setProperty(TSDBDriver.PROPERTY_KEY_SLAVE_CLUSTER_HOST, "备节点IP");
properties.setProperty(TSDBDriver.PROPERTY_KEY_SLAVE_CLUSTER_PORT, "6041");
properties.setProperty(TSDBDriver.PROPERTY_KEY_ENABLE_AUTO_RECONNECT, "true");

注意事项：

不要使用USE database语句切换库
连接时直接指定目标数据库
合理设置重试间隔和次数

运维管理命令

监控复制状态

taosx replica status

输出示例：

+---------+----------+----------+----------+------+-------------+----------------+
| replica | task     | source   | sink     | database | status      | note           |
+---------+----------+----------+----------+------+-------------+----------------+
| a       | 2        | td1:6030 | td2:6030 | opc  | running     |                |