1. 项目概述：从零构建你的分布式数据库集群

最近几年，数据库领域最火的话题之一就是分布式。无论是互联网大厂的秒杀场景，还是传统企业的数据中台建设，单机数据库的性能和容量瓶颈越来越明显。而TDSQL，作为一款成熟的金融级分布式数据库产品，因其在腾讯内部海量业务和众多外部金融客户中的稳定表现，成为了许多团队在选型时重点考察的对象。但说实话，第一次接触TDSQL部署的朋友，很容易被其涉及的多组件和配置项搞得头大。官方文档虽然全面，但更像一本“字典”，当你真正要动手从零搭建一套可用于开发测试甚至生产预发的环境时，总会觉得缺了那么一份“手把手”的实操指南。

这份手册的目的就在于此。它不是对官方文档的简单复述，而是结合我多次在物理机和云环境上部署TDSQL（特指其分布式版本，通常包含计算层、存储层和调度层）的实际经验，整理出的一套“避坑指南”和“最佳实践”。我会假设你有一批干净的CentOS 7或RHEL 7服务器，从系统初始化开始，一步步带你完成集群的搭建、初始化、基础功能验证，并分享那些只有踩过坑才知道的关键配置和排查技巧。无论你是DBA、运维工程师还是架构师，当你需要评估或搭建一套TDSQL环境时，这份手册希望能让你少走弯路，快速得到一个稳定可用的数据库集群。

2. 部署架构设计与核心组件解析

在真正敲命令之前，我们必须先搞清楚我们要部署的是什么，以及各个部件之间的关系。TDSQL的分布式架构通常指的是TDSQL for MySQL（或称TDSQL分布式版），其核心思想是“计算存储分离”和“分库分表自动化”。理解这个架构，是后续所有配置和排错的基础。

2.1 核心三层架构解析

一个标准的TDSQL分布式集群主要包含三个逻辑层，它们在物理上可能部署在同一批或不同的服务器上：

调度层（Scheduler/Manager）：这是集群的“大脑”，负责全局管理。主要组件是TDSQL Manager。它的职责包括：管理所有计算节点和存储节点的元信息（Meta Data）；接收SQL请求并进行解析、优化，生成分布式执行计划；协调分布式事务（如两阶段提交）；以及负责集群的扩缩容、备份恢复等运维操作。你可以把它想象成项目的总指挥，不直接干搬砖的活，但所有人和资源的调度都归它管。

计算层（SQL Engine/Proxy）：这是集群的“手脚”，负责直接与应用程序交互。主要组件是TDSQL Proxy（有时也被称为网关或接入层）。每个Proxy实例都是一个无状态的服务，应用程序像连接普通MySQL一样连接它。Proxy接收SQL，如果是简单的点查，可能会直接路由到后端的特定存储节点；如果是复杂的跨节点查询，则会请求调度层获取执行计划，然后自己充当协调者，从多个存储节点拉取数据并进行聚合。部署多个Proxy可以实现负载均衡和高可用。

存储层（Data Node）：这是集群的“仓库”，负责数据的持久化存储。每个存储节点本质上是一个增强版的MySQL实例（基于Percona Server或MariaDB，并进行了一系列内核优化和定制）。数据以分片（Shard）为单位分布在不同存储节点上。每个分片通常采用主从复制（半同步或强同步）架构来保证数据可靠性，其中一个主节点（Master）负责写，一个或多个从节点（Slave）负责读和故障切换。

2.2 部署模式选型：一体机与分离部署

根据资源情况和业务需求，部署模式主要有两种：

一体化部署：为了简化部署和节省机器，可以将Manager、Proxy和某个存储节点的主实例部署在同一台物理机上。这种模式常见于测试开发环境。优点是部署快，资源消耗少。缺点非常明显：存在单点故障风险，一旦这台机器宕机，管理功能和部分数据访问都会中断；而且性能容易互相干扰，不适合压测。

分离式部署：生产环境的强制推荐模式。各组件严格分离：

• Manager节点：独立部署，通常至少2个节点组成高可用集群（基于Raft协议），防止“大脑”宕机。
• Proxy节点：独立部署，至少2个节点，通过负载均衡器（如LVS、F5或云ELB）对外提供统一入口。
• 存储节点：每组主从（即一个分片）部署在不同的物理机上，确保没有单点。多个分片的主节点也应尽量分散在不同物理机，避免热点。

在我们的手册中，为了全面展示组件间的配置，我会以一个接近生产环境的分离式部署为蓝本进行讲解，但会说明哪些组件在资源紧张时可以合并。我们假设一个最小化高可用集群：2台Manager机器，2台Proxy机器，2个数据分片（每个分片1主1从，共4台存储机器）。总计8台服务器。

2.3 资源规划与配置建议

资源规划不到位，后期性能问题和运维麻烦会层出不穷。以下是我的经验建议：

服务器配置：

• Manager节点：对CPU和内存要求中等，但需要稳定的网络和磁盘。建议4核8G以上，SSD磁盘用于存放元数据。网络延迟务必低。
• Proxy节点：这是连接池和SQL转发中心，CPU密集型。建议8核16G以上。内存大小直接影响其能维护的连接数。也需要SSD磁盘。
• 存储节点：资源消耗大户。CPU、内存、磁盘IO和容量都需要重点规划。内存尤其关键，应尽可能大，因为InnoDB Buffer Pool的大小直接决定性能。生产环境建议64G内存起步，CPU16核以上，使用高性能NVMe SSD。

网络与安全：

• 网络延迟：所有组件之间的网络延迟必须低且稳定， ideally 在0.5ms以内（同机房）。跨机房部署需要专门配置，并容忍更高的延迟。
• 防火墙：开放组件间必要的端口。例如，Manager需要访问所有节点的管理端口；Proxy需要访问所有存储节点的MySQL端口；存储主从之间需要复制端口。一个常见的做法是在部署前期，在安全策略允许的情况下，可以暂时在集群内部网段关闭防火墙或配置全通策略，待部署完成后再细化规则。
• 主机名与DNS：为每台机器配置好静态主机名（如hostnamectl set-hostname manager01），并在/etc/hosts文件中配置所有集群节点的IP与主机名映射。强烈不建议在配置中使用IP地址，使用主机名在后续扩容和故障迁移时会更灵活。

注意：很多部署失败案例的根源都在于网络。务必在安装前使用ping、telnet（测试端口）和iptables -L等命令，确保所有节点之间在所需端口上是双向连通的。

3. 系统初始化与基础环境准备

兵马未动，粮草先行。在安装任何TDSQL软件包之前，我们需要一个干净、统一、优化过的操作系统环境。这一步的细致程度直接决定了后续部署的顺利程度。

3.1 操作系统统一与内核参数调优

TDSQL官方通常推荐CentOS 7.x或RHEL 7.x系列。确保所有节点的操作系统版本一致。

内核参数调整：编辑/etc/sysctl.conf，以下参数对数据库性能至关重要，特别是存储节点。

# 增加系统最大文件句柄数，防止“Too many open files”错误 fs.file-max = 1000000 # 网络相关优化，提升高并发连接能力 net.core.somaxconn = 65535 net.ipv4.tcp_max_syn_backlog = 65535 net.ipv4.tcp_syncookies = 1 net.ipv4.tcp_tw_reuse = 1 net.ipv4.tcp_tw_recycle = 0 # 在NAT环境下建议为0，避免问题 net.ipv4.tcp_fin_timeout = 30 net.ipv4.ip_local_port_range = 1024 65535 # 内存与swap相关，让系统更积极地使用内存 vm.swappiness = 10 vm.dirty_ratio = 60 vm.dirty_background_ratio = 5 # 内存分配策略，避免OOM Killer误杀数据库进程 vm.overcommit_memory = 0 vm.overcommit_ratio = 90 # 信号量设置，应对高并发 kernel.sem = 250 512000 100 2048

执行sysctl -p使配置生效。这些参数调整了系统的网络连接处理能力、内存管理策略，为数据库的高并发访问打下了基础。

资源限制调整：编辑/etc/security/limits.conf，为运行数据库的用户（通常是mysql）解除限制。

mysql soft nofile 655350 mysql hard nofile 655350 mysql soft nproc 655350 mysql hard nproc 655350 mysql soft core unlimited mysql hard core unlimited

这里mysql是后续安装数据库软件时创建的系统用户。nofile是文件描述符数量，数据库会打开大量文件；nproc是进程数；core允许生成core dump文件，便于故障调试。

3.2 依赖包安装与时间同步

安装必要的系统工具和依赖库：

yum install -y epel-release yum install -y wget vim net-tools telnet tree htop iotop iftop sysstat lrzsz ntpdate libaio numactl

• libaio：异步IO库，MySQL性能依赖。
• numactl：NUMA架构绑定工具，对于大内存机器，绑定MySQL进程到特定CPU节点可以提升性能。

时间同步是分布式系统的生命线！TDSQL的全局事务一致性严重依赖各节点时钟同步。配置所有节点与同一时间源同步。

# 1. 安装chrony（比ntp更现代） yum install -y chrony # 2. 编辑配置文件 /etc/chrony.conf，使用阿里云或腾讯云内网NTP服务器 server ntp.tencent.com iburst server ntp1.aliyun.com iburst # 3. 启动并设为开机自启 systemctl start chronyd systemctl enable chronyd # 4. 查看同步状态 chronyc sources -v

确保所有节点的时钟偏差（offset）在毫秒级， ideally 小于100ms。

3.3 存储规划与文件系统选择

对于存储节点，磁盘规划是性能的核心。

分区与挂载：如果使用裸盘，建议用parted工具创建GPT分区表，并分出一个主分区。使用XFS文件系统，它对大文件和高并发IO支持更好。

# 假设新磁盘为 /dev/sdb parted /dev/sdb mklabel gpt parted /dev/sdb mkpart primary xfs 0% 100% mkfs.xfs /dev/sdb1 mkdir /data echo '/dev/sdb1 /data xfs defaults,noatime,nodiratime 0 0' >> /etc/fstab mount -a

noatime,nodiratime挂载选项可以减少文件访问时间的更新，提升IO性能。

目录结构规划：在/data目录下，为MySQL数据、日志、备份等创建清晰的子目录结构，例如：

/data/mysql_data # 数据文件目录 (datadir) /data/mysql_log # 日志目录 (binlog, relaylog, slowlog等) /data/mysql_tmp # 临时文件目录 /data/backup # 备份目录

统一的目录结构便于后续的监控、备份和运维脚本编写。

4. TDSQL组件安装与集群初始化

环境准备好后，我们开始安装软件并组建集群。这里以使用TDSQL官方提供的RPM包为例。

4.1 软件包获取与安装

首先，从官方渠道获取对应版本的安装包，通常包含tdsql-manager，tdsql-proxy，tdsql-mysql（存储节点）等。将其上传到各自角色的服务器上。

在所有节点上安装基础依赖和客户端：

# 安装MySQL客户端，用于后续连接测试 yum install -y https://repo.mysql.com/mysql80-community-release-el7-7.noarch.rpm yum install -y mysql-community-client

在Manager节点安装Manager组件：

rpm -ivh tdsql-manager-*.rpm

安装后，配置文件通常位于/usr/local/tdsql_manager/conf目录下。

在Proxy节点安装Proxy组件：

rpm -ivh tdsql-proxy-*.rpm

配置文件通常位于/usr/local/tdsql_proxy/conf。

在存储节点安装MySQL组件：

rpm -ivh tdsql-mysql-*.rpm

这个包会安装一个经过深度定制的MySQL服务器。配置文件位于/etc/my.cnf。

4.2 存储节点MySQL实例初始化

这是最关键的一步，每个存储节点都需要初始化一个干净的MySQL数据目录。

1. 停止可能存在的MySQL服务：systemctl stop mysqld
2. 清理旧数据：如果/data/mysql_data目录已存在，请备份后彻底删除。
3. 初始化数据库：

   # 切换到mysql用户，使用mysqld初始化 su - mysql mysqld --initialize-insecure --user=mysql --datadir=/data/mysql_data --basedir=/usr/local/mysql

   --initialize-insecure会生成一个空密码的root账户，方便首次登录。生产环境应使用--initialize生成随机密码。
4. 调整目录权限：确保/data/mysql_data和/data/mysql_log等目录的所有者和组均为mysql。
5. 启动MySQL：systemctl start mysqld，并检查日志/data/mysql_log/error.log确认无报错。
6. 修改root密码并创建管理账户：

   mysql -uroot -p # 初始无密码，直接回车 ALTER USER 'root'@'localhost' IDENTIFIED BY 'YourStrongPassword123!'; CREATE USER 'tdsql_admin'@'%' IDENTIFIED BY 'AnotherStrongPassword!'; GRANT ALL PRIVILEGES ON *.* TO 'tdsql_admin'@'%' WITH GRANT OPTION; FLUSH PRIVILEGES;

   这里创建了一个tdsql_admin账户，供Manager节点远程管理该存储节点。

4.3 配置管理节点并启动集群

现在，我们需要告诉Manager集群里都有哪些成员。

1. 编辑Manager配置文件：主要配置文件通常是manager.conf或cluster.xml。你需要定义：

   • cluster_id：集群唯一ID。
   • zk_address：如果使用ZooKeeper做协调（高可用Manager模式），需要配置ZK地址。单机Manager模式可能不需要。
   • node_list：列出所有Proxy节点和存储节点的IP、端口、角色信息。
   • shard_list：定义数据分片，指定每个分片的主库和从库是哪个存储节点。

   这是一个极度简化的示例片段，实际是复杂的XML或JSON格式：

   <shard id="1"> <master host="storage01" port="3306" user="tdsql_admin" password="..."/> <slave host="storage02" port="3306" user="tdsql_admin" password="..."/> </shard> <shard id="2"> <master host="storage03" port="3306" user="tdsql_admin" password="..."/> <slave host="storage04" port="3306" user="tdsql_admin" password="..."/> </shard> <proxy_list> <proxy host="proxy01" port="3306"/> <proxy host="proxy02" port="3306"/> </proxy_list>

2. 启动Manager服务：systemctl start tdsql_manager。查看Manager日志，确认它成功连接到了所有配置的节点。

3. 通过Manager初始化集群元数据：Manager启动后，通常会提供一个管理界面（Web或命令行工具）。你需要登录管理界面，执行“集群初始化”或“导入配置”操作。这一步会向所有存储节点和Proxy节点下发配置，并创建系统所需的元数据库（如__tdsql_meta__）。

4.4 配置Proxy节点并接入集群

1. 编辑Proxy配置文件：主要配置是proxy.conf。核心是告诉Proxy Manager的地址在哪里。

   manager_address = manager01:9900,manager02:9900 instance_name = proxy01 # 本实例名称 listen_port = 3306 # 对外提供服务的端口

2. 启动Proxy服务：systemctl start tdsql_proxy。查看Proxy日志，确认其成功连接到Manager并拉取了集群配置（包括存储节点列表、分片信息等）。

3. 验证Proxy状态：通过MySQL客户端连接Proxy的端口（如mysql -h proxy01 -P 3306 -u tdsql_admin -p）。如果连接成功，说明Proxy已就绪。但此时可能还没有业务数据库。

5. 集群管理与基本操作验证

集群启动后，我们还需要进行一些基本的管理操作和功能验证，确保集群是健康且可用的。

5.1 通过管理界面或命令行管理集群

TDSQL通常提供多种管理方式：

• Web控制台：最直观的方式，通过浏览器访问Manager节点的特定端口（如8080），可以查看集群拓扑、节点状态、监控指标，进行创建数据库、账号管理、数据导入等操作。
• 命令行工具：如tdsql_cli或mysql客户端连接Manager的管理端口，执行DDL和集群管理命令。

创建一个分布式数据库：在管理界面或通过命令行，执行类似以下的命令：

CREATE DATABASE testdb DISTRIBUTED BY SHARDKEY;

关键是指定DISTRIBUTED BY SHARDKEY，这表示该库下的表将根据分片键进行分布式存储。你还需要在创建表时指定分片键（Shardkey）。

创建一张分片表：

USE testdb; CREATE TABLE user_info ( user_id BIGINT NOT NULL, username VARCHAR(50), email VARCHAR(100), PRIMARY KEY (user_id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DISTRIBUTED BY SHARDKEY(user_id);

这里指定user_id作为分片键，TDSQL会根据这个字段的值，通过哈希或其他算法，将不同user_id的行数据分布到不同的存储分片上。

5.2 数据操作验证与路由测试

现在，我们可以测试集群的基本功能了。

1. 插入数据：通过任意一个Proxy节点插入几条数据。

   INSERT INTO user_info (user_id, username, email) VALUES (10001, '张三', 'zhangsan@example.com'); INSERT INTO user_info (user_id, username, email) VALUES (10002, '李四', 'lisi@example.com');

2. 查询数据：执行点查和范围查询。

   -- 点查（应能正确路由到对应分片） SELECT * FROM user_info WHERE user_id = 10001; -- 范围查询（可能需要跨分片聚合） SELECT * FROM user_info WHERE user_id BETWEEN 10000 AND 10005; -- 全表扫描（跨所有分片） SELECT COUNT(*) FROM user_info;

3. 验证数据分布：登录到不同的存储节点MySQL实例，直接查看testdb.user_info表的数据。你会发现，数据并没有完整地出现在每一个节点上，而是根据user_id的哈希值分布在了不同的节点上。这正是分布式数据库的特点。

5.3 高可用故障切换测试

这是检验集群可靠性的核心测试。我们模拟一个存储节点主库宕机。

1. 查看当前拓扑：在管理界面，确认分片1的主库是storage01，从库是storage02。
2. 模拟主库故障：在storage01服务器上，执行systemctl stop mysqld。
3. 观察集群行为：
   • 在管理界面，你会看到storage01的状态变为“故障”或“下线”。
   • 集群的高可用模块（HA）应该能自动检测到故障，并在几十秒内触发主从切换。storage02会被提升为新的主库。
   • 切换过程中，正在访问该分片的写事务可能会收到短暂错误或超时，但之后应该自动恢复。
   • 通过Proxy执行INSERT语句，数据应该能写入新的主库storage02。
4. 恢复旧主库：修复storage01的问题后，启动MySQL。它应该能自动作为从库，同步新主库storage02的数据，追平数据后重新加入集群。

这个测试验证了集群的自动故障转移（Failover）能力，这是金融级数据库的核心要求。

6. 监控、备份与日常运维要点

集群上线后，持续的监控、备份和日常维护是保证其长期稳定运行的基石。

6.1 监控指标体系建设

你需要从多个维度监控集群：

主机层监控：CPU、内存、磁盘使用率、磁盘IOPS/吞吐量、网络流量。使用node_exporter+ Prometheus + Grafana是行业标准做法。

组件层监控：

• Manager：进程状态、与各节点心跳是否正常、元数据存储是否健康。
• Proxy：连接数（当前连接、总连接）、QPS、TPS、请求延迟（P95， P99）、SQL错误率。
• 存储节点（MySQL）：这是监控重点。包括：
  • 性能：Innodb_rows_read/inserted/updated/deleted、Questions、Com_*。
  • 资源：Innodb_buffer_pool_reads（缓冲池未命中率）、Threads_running、Innodb_row_lock_time_avg。
  • 复制状态：对于从库，Slave_IO_Running和Slave_SQL_Running必须是Yes，Seconds_Behind_Master延迟要尽可能小。
  • 慢查询：定期分析慢查询日志（slow_query_log），优化SQL。

业务层监控：应用端的请求成功率、端到端延迟。这需要与业务系统配合。

TDSQL Manager通常自带一部分监控面板，但建议将其关键指标也接入到公司统一的Prometheus监控体系中，实现告警联动（如通过Alertmanager发送到钉钉、企业微信）。

6.2 备份与恢复策略

分布式数据库的备份比单机更复杂，因为要保证全局数据的一致性点。

物理备份（推荐）：使用TDSQL配套的备份工具（如tdsql_dumper），它能够在分布式环境下，协调所有存储节点在同一逻辑时间点进行快照备份，确保备份集的一致性。备份流程通常为：

1. 通过Manager发起全局备份任务。
2. Manager通知所有Proxy暂停分布式事务的提交。
3. 等待所有进行中的事务完成，并获取一个全局一致的Binlog位点（GTID或时间点）。
4. 通知所有存储节点在此位点进行物理备份（如使用xtrabackup）。
5. 备份完成后，释放Proxy的暂停状态。
6. 将各节点的备份文件汇总、压缩、上传到对象存储或远程备份服务器。

逻辑备份：使用mysqldump通过Proxy连接进行全库或单表备份。对于超大规模数据，恢复时间会很长，常用于备份特定表或小型数据库。命令示例：mysqldump -h proxy_vip -u backup_user -p --single-transaction --databases testdb > backup.sql

恢复演练：备份的价值在于能恢复。必须定期进行恢复演练，在一个隔离的环境中将备份集恢复出来，验证备份的有效性和恢复流程的熟练度。

6.3 常见运维操作与问题排查

扩容存储节点：当现有分片容量或性能不足时，需要增加新的存储节点并加入到现有分片中，或者增加新的分片。这是一个在线操作，但数据重分布（Rebalance）期间会对性能有影响，需要在业务低峰期进行。通过管理界面发起“扩容”任务，选择新节点和需要调整的分片。

慢查询分析与优化：

1. 在Proxy或存储节点开启慢查询日志。
2. 使用pt-query-digest工具分析慢日志。
3. 重点关注：是否缺少分片键（Shardkey）导致全分片扫描；是否跨分片JOIN或子查询；单分片内是否缺少有效索引。
4. 优化手段：增加合适的索引（尤其在分片键上）；改写SQL，避免跨分片操作；调整表结构。

连接数暴涨：应用连接池配置不当或存在连接泄漏，导致Proxy连接数打满。排查步骤：

1. show processliston Proxy查看连接来源和状态。
2. 检查应用侧连接池配置（最大连接数、空闲超时）。
3. 在Proxy配置中限制单个前端IP的最大连接数。
4. 使用tcpkill或通过Proxy kill掉空闲超时的连接。

主从延迟：从库Seconds_Behind_Master持续很高。

• 原因1：主库写入压力大，从库单线程回放跟不上。解决方案：考虑升级从库硬件（更好的IO）；或使用并行复制（MTS）版本，并优化slave_parallel_workers参数。
• 原因2：从库有长查询阻塞了回放。解决方案：监控并优化从库上的慢查询。
• 原因3：网络带宽不足。解决方案：检查主从节点间的网络质量。

部署和运维TDSQL集群是一个系统工程，涉及的知识面从操作系统、网络到数据库内核和分布式理论。这份手册提供了一个从零开始的实践框架和关键点提示。真正的熟练来自于在具体环境中反复操作和解决问题。建议先在测试环境充分演练所有流程，形成自己的检查清单和运维手册，再向生产环境推进。记住，谨慎和充分的测试是DBA最好的朋友。