TcaplusDB能力速览

📅 更新时间：2026年5月 📬 如需技术支持：

1. 用户手册自助查询： https://tcaplusdb.tencent.com/UserGuide/
2. 企微"TcaplusDB AI助手" 智能问答
3. 企微 "Tcaplus_Helper" 人工答疑

概览

🤖 AI 新能力

TcaplusDB 全面拥抱 AI 生态，提供"对话即查询、@即运维、私聊即客服"三大 AI 能力，让数据库操作更简单。

1. TcaplusMCP — 对话即查询

一句话：用自然语言直接查询游戏业务数据，无需编写代码！

基于 MCP（Model Context Protocol）协议，让 AI 智能体可以直接读写 TcaplusDB 业务数据，实现自然语言 → 数据查询的无缝转换。无需记忆 API 接口，对话即查询。

核心价值：

• 直接查询线上业务数据（区别于集群管理类 MCP，TcaplusMCP 面向实际游戏数据）
• 零代码门槛，运营、策划也能自助查数据
• 游戏数据库领域率先接入 MCP 协议，紧跟 AI Agent 生态趋势

📖 详细文档：TcaplusMCP 数据查询指南

适用场景：

• 自然语言查询DB数据（权限同Webclient）, 如： 查询 app 1 zone 2 key为111的记录
• 运营排查问题时自助查数据，无需等研发支持
• 非技术人员通过自然语言查询数据，无需写代码（权限与现有控制台一致，无需额外开通）
• 自动化流程中的数据读写

2.TcaplusDB Skills

一句话：让TcaplusDB的接入开发排查更加便捷，不再依赖人工 目前已发布： SDK代码生成和检查: https://knot.woa.com/skills/detail/27362 表相关操作: https://knot.woa.com/skills/detail/33176

3. Tcaplus_Robot — @即运维

一句话：私聊/企微群内 @机器人即可快速完成故障支持、Binlog 查询、数据统计等操作。

主要能力：

1. help：查询支持的能力列表
2. sos：紧急故障支持，自动电话、拉群 Tcaplus 研发和 DBA
3. binlog：支持指定表、指定 PrimaryKey 的 Binlog 自助查询
4. table_record_stat：查询某表单日访问到的最大记录和最大索引对应的 Key 和长度；支持蓝鲸订阅告警

适用场景：

• 线上故障时快速拉起支持流程
• 自助查询数据变更历史（Binlog）
• 日常运维数据统计

版本要求：

4. TcaplusDB AI助手

一句话：智能问答/数据查询/大时延分析/任务异常诊断等

在企业微信搜索 TcaplusDB AI助手，私聊即可获得：

• TcaplusDB 使用问题智能解答
• 数据查询辅助
• 常见运维操作指导

🔥 核心特性（重点推荐）

5. 条件过滤 & 条件更新

一句话：增删改查操作现在支持带条件执行，一步到位！

解决什么问题： 以前要实现"只有当钻石 ≥ 10 时才扣减并发放道具"这类逻辑，需要先读取记录 → 业务侧判断 → 再写回，存在并发竞态风险（如两次请求同时读到钻石=10，各扣一次变成负数）且多一次网络往返。现在直接在请求中带上条件，服务端原子执行，既安全又高效。

支持能力：

• 数值比较（>、<、=、≥、≤、≠）
• 字符串模糊匹配
• 数组和map的元素操作 适用场景：
• 游戏道具扣减前校验数量
• 排行榜分数仅在超过当前值时更新
• 批量清理满足特定条件的过期数据

版本要求：

📖 详细使用文档：条件过滤和更新

6. 记录级 TTL（自动过期）

一句话：同一张表里，不同记录可以设置不同的过期时间！

解决什么问题： 表级 TTL 只能统一淘汰策略，无法满足"不同道具不同过期时间"的差异化需求。现在每条记录可以独立设置过期时间，到期自动清理，零运维成本。

支持能力：

• 新增写操作直接携带过期时间
• 到期自动删除，无需业务定时扫描

适用场景：

• 限时活动数据（活动结束自动清理）
• 临时 buff/道具（到期自动失效）
• 验证码、session 等短期数据
• 消息已读状态（30天后自动清理）

版本要求：无特殊版本依赖，基础版本即支持。

7. 分布式索引

一句话：支持对 Key 或 Value 字段的范围查询、模糊查询、聚合查询！

解决什么问题： TcaplusDB 传统模式只支持按主键精确查询，业务如果要做"查询等级 > 50 的所有玩家"只能全表扫描。分布式索引让你像用 SQL 的 WHERE 子句一样灵活查询。

支持能力：

• 范围查询（如：score > 1000）
• 模糊查询（如：name LIKE "张%"）
• 聚合查询（如：COUNT、SUM、AVG）

适用场景：

• 排行榜按条件筛选（段位、区服、时间范围）
• 玩家搜索（按昵称模糊匹配）
• 数据统计报表（按维度聚合）
• GM 工具按多条件查询玩家数据（区服+等级+注册时间）

版本要求：无特殊版本依赖。

8. 构造 & 回档能力升级

一句话：支持条件回档; 支持不同记录回档到不同时间点；支持部分字段回档。

解决什么问题： 运营事故发生后，以前只能整表回档，影响范围大、恢复时间长。现在可以精准定位受影响的记录，只回档需要恢复的部分，其他玩家数据完全不受影响。

新增能力：

1. 已删除表的构造和回档
2. 条件回档，只回档符合条件的记录，用SQL来表达条件（如：只回档某个区服的数据）
3. 指定索引 Key 回档（精确到某个玩家）
4. 不同玩家回档到不同时间点
5. 仅回档部分字段（只恢复金币，不影响等级）

适用场景：

• 运营误操作后精准恢复受影响玩家
• 外挂导致异常数据的定向回滚
• 版本 bug 导致部分字段异常的修复
• 误删表的紧急恢复

版本要求：

9. 定时数据导出增强（分析型文本）

一句话：每日定时将指定字段数据自动导出到业务机器，支持条件筛选和多级字段！

解决什么问题： 数据分析场景需要定期从 TcaplusDB 拉取数据到分析平台，以前需要业务自己写脚本拉取，容易出错且难以维护。现在平台原生支持定时导出，配置一次即可持续运行。

支持能力：

1. 支持不同区的同名表配置成一个任务，一个任务下可以有多个不同子任务（不同的筛选条件、导出目的地）
2. 支持条件导出，条件通过SQL表达（只导出满足条件的记录）
3. 新增对二级或多级字段的导出（TDR 表和 PB 表的子字段都支持）
4. 支持导出到任意时间点的数据快照
5. 功能稳定性大幅增强，支持任务各自异常的自动重试
6. 支持将敏感词（如昵称、公告）上报至安全性审核

适用场景：

• 每日玩家行为数据导出到数据仓库
• 定时导出充值消费流水用于对账
• 离线分析所需的增量/全量数据同步
• 合规审计数据定期归档

版本要求：

📊 查询与索引增强

10. TopN 索引

一句话：在本地索引基础上，按指定 Value 字段排序，自动保留 TopN 条记录。

解决什么问题： 排行榜场景需要维护"前 N 名"数据，以前需要业务自己排序截断。TopN 索引让数据库自动维护排序结果，查询时直接返回 Top 记录，零额外开发。

适用场景：

• 实时排行榜（战力榜、等级榜、积分榜）
• 热门内容 Top 列表
• 最近 N 条操作记录

版本要求：无特殊版本依赖。

11. SortList（有序 List 表）

一句话：List 表定义时增加按指定 Value 字段自动排序，查询时更高效。

解决什么问题： List 表存储的元素默认无序，业务查询后需要自行排序。SortList 在写入时自动维护有序性，查询直接返回有序结果，减少业务侧排序开销。

适用场景：

• 聊天消息按时间排序
• 邮件列表按优先级排序
• 任务队列按截止时间排序

版本要求：无特殊版本依赖。

🔧 数据操作增强

12. PB 表 Map 元素级操作

一句话：支持对 Protobuf 表中 Map 类型字段的单个元素进行增删改查！

解决什么问题： 以前修改 PB 表（Protobuf 定义的表）的 Map 字段，需要读取整个 Map → 修改目标元素 → 写回整个 Map，数据量大时性能差。现在可以直接操作单个 Key-Value 对，精准高效。

适用场景：

• 玩家背包（Map<道具ID, 数量>）的单个道具增减
• 配置表（Map<配置项, 值>）的单项修改
• 好友关系（Map<好友ID, 关系数据>）的增删

版本要求：

13. 触发器（跨集群、跨表自动同步）

一句话：一张表记录的部分或全部字段变更时，自动同步到另一张表！

解决什么问题： 业务多地部署，就近接入： 欧洲用户写入的数据，自动同步到亚洲。 表A的部分高频字段变更时，自动同步到表B。解决高频字段访问和不同索引的问题。

适用场景：

• 玩家属性变更自动同步到排行榜表
• 订单状态变更自动同步到统计表
• 主表数据变更自动更新缓存表

版本要求：无特殊版本依赖。

🚀 数据流转

14. TDW/HDFS 数据定时导入

一句话：将 TDW/HDFS 中的数据定时导入到 TcaplusDB 指定环境。

解决什么问题： 大数据平台产出的计算结果（如推荐模型、用户画像）需要灌入在线数据库供业务实时查询，以前需要自行开发导入工具。现在平台原生支持定时从 TDW/HDFS 拉取数据并写入指定表。

适用场景：

• AI 模型推理结果导入在线服务
• 离线计算的排行榜数据同步到线上
• 运营活动配置批量导入
• 数据修复/数据迁移

版本要求：无特殊版本依赖。

🛠 平台工具升级

15. WebServiceAPI v2

一句话：Web API 全面升级，性能提升 3~15 倍，支持跨区批量操作！

主要升级：

1. 支持跨区批量提单：加/删/改/清/重建/复制表
2. 性能优化：大批量操作多区多表速度提升 3~15 倍
3. 更安全易用：接口设计更规范，鉴权更完善

适用场景：

• 自动化运维脚本（批量建表、改表）
• CI/CD 流水线中的数据库变更
• 管理后台的批量操作

版本要求：无特殊版本依赖。

📋 版本依赖速查表

💬 获取帮助

• OMS 平台：通过运营管理平台提交工单获取技术支持
• 智能客服：企微搜索 Tcaplus_helper，私聊即可获得 AI 智能问答
• 机器人支持：业务群内 @Tcaplus_Robot 获取快速支持
• 文档中心：TcaplusDB 用户手册 提供完整的使用指南
• 紧急故障：群内 @Tcaplus_Robot 输入 sos，自动拉起故障响应流程

📖 名词说明

📝 本文档持续更新，如有新特性上线将同步补充。 最后更新：2026年5月