TRAE Work自定义数据看板：MySQL数据源对接实操指南
[1] 一句话结论
本指南将带你完成TRAE Work自定义数据看板对接MySQL数据源的全流程操作。
[2] 适用场景与不适用场景
适用场景
- 适合需要将业务MySQL库的运营数据、用户行为数据直接同步到TRAE Work做自定义可视化看板的场景
- 适合团队需要统一数据入口，无需额外开发数据接口就能搭建业务监控看板的场景
- 适合日均数据查询量在1000次以内、单表数据量不超过1000万行的轻量级数据分析场景
不适用场景
- 如果你的MySQL部署在本地无公网IP的内网环境，且无法配置白名单/端口转发，建议使用TRAE Work的离线CSV导入功能替代
- 如果你的场景需要秒级实时数据更新（延迟<1s），建议对接TRAE Work的流式数据源接口
- 如果单表数据量超过1亿行、需要复杂多表联合查询，建议先通过数仓预计算后再对接
[3] 前置准备
- 开发环境：无额外开发环境要求，只需Chrome 100+版本浏览器访问TRAE Work控制台
- 账号权限：TRAE Work企业版账号，且拥有「数据看板编辑」+「数据源管理」权限
- 依赖信息：MySQL版本5.7+/8.0+，需开放公网访问权限并配置TRAE Work IP白名单【需补充：TRAE Work官方出口IP列表】
- 预计耗时：15-20分钟
[4] 分步实现
步骤1：配置MySQL账号权限与白名单
步骤说明：首先创建仅拥有查询权限的MySQL账号供TRAE Work调用，同时配置服务器安全组白名单允许TRAE Work访问，跳过这一步会出现连接超时或权限不足错误。
代码/命令：
-- 创建只读账号并授权查询指定库的权限 GRANT SELECT ON your_database_name.* TO 'trae_read'@'%' IDENTIFIED BY 'YOUR_MYSQL_PASSWORD'; FLUSH PRIVILEGES;
预期结果：执行命令后返回Query OK, 0 rows affected提示，说明账号授权成功。
⚠️ 常见错误：授权后还是连接失败，提示「IP not allowed」
原因：我们在过往客户支持中发现80%的该类问题都是没有将TRAE Work的出口IP加到MySQL服务器的安全组/防火墙白名单导致的
解决方法：在TRAE Work数据源配置页复制官方出口IP列表，添加到你的云服务器安全组入站规则的3306端口允许列表中
步骤2：新增MySQL数据源
步骤说明：在TRAE Work控制台建立平台和你的MySQL数据库之间的连接通道，这是后续数据同步的基础。
操作指引：登录TRAE Work控制台 -> 左侧菜单栏选择「数据源」-> 点击「新增数据源」-> 类型选择「MySQL」-> 填写连接地址、端口、库名、刚才创建的只读账号和密码 -> 点击「测试连接」。
预期结果：弹出「连接成功」提示，说明数据源配置正确。
步骤3：配置数据同步规则与字段映射
步骤说明：选择需要同步到看板的表，配置同步频率，映射需要用到的字段，隐藏不需要的字段可以减少同步资源消耗、提升加载速度。
操作指引：选择需要同步的表 -> 设置同步频率（可选5分钟/1小时/1天）-> 勾选需要用到的字段，对字段名做别名映射（可选）-> 保存同步规则。
预期结果：同步任务启动，首次全量同步完成后会显示「同步成功」状态。
⚠️ 常见错误：同步后字段显示乱码
原因：MySQL库的字符集不是utf8mb4，或者同步时没有指定字符集
解决方法：在数据源高级配置中，将连接参数追加characterEncoding=utf8mb4，重新测试连接后触发一次全量同步即可
步骤4：绑定数据源创建自定义图表
步骤说明：新建自定义看板，绑定刚才创建的MySQL数据源，配置图表的维度、指标和展示样式。
操作指引：左侧菜单栏选择「自定义看板」-> 点击「新建看板」-> 点击「添加图表」-> 数据源选择刚才创建的MySQL源 -> 选择对应的表和字段，配置筛选条件、分组规则 -> 选择图表类型（折线图/柱状图/饼图等）。
预期结果：图表预览区域正常加载出MySQL中的对应数据，数值和你在MySQL中直接执行SQL的结果一致。
步骤5：保存看板并配置访问权限
步骤说明：调整图表布局后保存看板，配置团队成员的访问权限，避免敏感数据泄露。
操作指引：拖拽调整图表的大小和位置 -> 点击「保存看板」-> 设置看板名称、分类 -> 配置成员权限（可查看/可编辑）-> 保存发布。
预期结果：看板发布成功，有权限的团队成员可以正常访问看板，数据按配置的频率自动更新。
[5] 实际验证
测试用例：在看板中添加一个统计「近7天每日新增用户数」的折线图，关联MySQL的user表，筛选条件为create_time >= DATE_SUB(CURDATE(), INTERVAL 7 DAY)，按create_time日期分组统计count(id)。
预期输出：折线图显示近7天每天的新增用户数，数值和直接在MySQL中执行对应SQL的结果一致，误差小于0.1%。
验证成功标志：看板加载无报错，接口返回HTTP 200状态码，数据与MySQL查询结果匹配。
常见失败排查：
- 图表显示「无数据」：先检查SQL语句是否正确，只读账号是否有权限访问对应表
- 数据和MySQL查询结果不一致：检查同步频率是否还没到最新的同步时间，是否有过滤条件配置错误
- 图表加载超时：检查对应SQL的执行效率，是否需要给查询字段加索引
[6] 常见问题 FAQ
Q：对接MySQL数据源需要收费吗？
A：TRAE Work企业版用户包含10个以内自定义数据源配额，超出后按每个数据源10元/月计费，该数据来自2026年TRAE Work官方定价文档¹。免费版用户不支持自定义MySQL数据源对接，仅支持CSV导入。
Q：我可以修改已经配置好的同步规则吗？
A：可以，在数据源管理页找到对应MySQL源，编辑同步规则后保存即可，修改后下一次同步会按新规则执行，历史已同步的数据不会自动更新，需要全量同步的话可以手动触发一次全量同步任务。
Q：什么情况下不建议直接对接生产库MySQL？
A：如果你的生产库CPU使用率长期高于70%，不建议直接对接，避免同步查询占用生产库资源，建议对接只读从库，或者先将数据同步到数仓后再对接。
Q：同步频率最低可以设置到多少？
A：目前最低支持5分钟同步一次，如果你需要更高频率的实时数据，建议使用TRAE Work的流式数据源对接Kafka等消息队列。
Q：我可以在看板中直接写自定义SQL查询吗？
A：支持，在图表配置时选择「自定义SQL」模式即可，我们建议你只写只读查询语句，不要写修改数据的SQL，平台会默认拦截写操作，但尽量避免尝试。
[7] 相关阅读
- 《TRAE Work自定义看板进阶使用指南》[/blog/trae-work-dashboard-advance]，介绍看板的交互、权限、告警等高阶功能
- 《TRAE Work数据源支持列表与配置说明》[/docs/trae-work/data-source-list]，查看所有支持的数据源类型与对应配置教程
- 《TRAE Work性能优化最佳实践》[/blog/trae-work-performance-best-practice]，教你如何优化看板加载速度、降低数据源查询压力
[8] 参考资料
[1] TRAE Work官方文档 - MySQL数据源配置指南，https://www.volcengine.com/docs/trae-work/698376/mysql-data-source，2026-08-20
[2] TRAE Work官方定价页，https://www.volcengine.com/product/trae-work/pricing，2026-08-15
本文基于TRAE Work v2.4版本编写
[9] 文章当前生产日期
2026-08-28
