Power BI Services通过Gateway创建MySQL数据源报错排查求助

1. 检查网关状态与连通性 #

• 确认本地网关服务（On-premises data gateway）处于运行状态，可通过Windows服务管理器查看
• 登录Power BI Services，检查网关集群状态为“正常”，且当前数据源已关联到该集群
• 在网关所在机器上执行ping [MySQL服务器IP]测试网络连通，用telnet [MySQL服务器IP] [端口]验证端口是否开放

2. 验证MySQL服务器权限与防火墙 #

• 登录MySQL服务器，检查授权账户是否允许网关机器IP访问：执行SELECT user, host FROM mysql.user;，确保存在对应账户（比如username@网关IP或username@%）
• 检查MySQL服务器防火墙是否开放目标端口（默认3306），同时确认网关机器的防火墙未阻止出站连接到该端口

3. 核对Power BI数据源配置 #

• 服务器地址：确保和Power BI Desktop中使用的一致，优先用IP地址避免主机名解析失败；若用主机名，需在网关机器的hosts文件或DNS中配置解析
• 端口：严格填写MySQL实际监听的端口，默认3306，若修改过需同步
• 凭据：使用和Desktop完全一致的用户名（含主机权限部分）和密码，选择“基本”凭据类型

4. 测试网关机器的MySQL访问 #

• 在网关机器上安装MySQL客户端（如MySQL Workbench），用相同凭据连接目标数据库，确认能正常访问
• 检查网关机器是否安装了64位MySQL ODBC驱动（网关为64位程序），版本建议8.0.x以上，避免兼容性问题

5. 排查Power BI Services端问题 #

• 清除浏览器缓存后重新创建数据源，避免缓存导致的配置异常
• 确认当前Power BI账户拥有网关管理权限和数据源创建权限

6. 查看网关日志定位细节 #

• 网关日志路径：C:\Program Files\On-premises data gateway\Logs，查看最新日志中的具体错误信息（如权限拒绝、连接超时等），精准定位问题

• 服务器地址：优先使用IP地址，若用主机名需确保网关机器能解析；不要使用localhost（除非MySQL和网关在同一机器）
• 端口：必填项，必须与MySQL服务器监听端口一致，不可留空
• 凭据配置：
  • 用户名需与MySQL授权的账户完全匹配，包括主机部分（例如user@192.168.1.5，而非仅user）
  • 密码注意大小写、特殊字符，避免输入错误；若密码含特殊字符，确保输入时未被转义
  • 凭据类型固定选择“基本”，无需尝试其他类型
• 网关关联：创建数据源时必须选择已连通的网关集群，未关联网关无法访问本地MySQL服务器
• 驱动要求：网关机器必须安装64位MySQL ODBC驱动，且版本与MySQL服务器版本兼容
• 数据库名称：注意大小写（Linux环境下MySQL数据库名区分大小写），需与实际数据库名称完全一致

内容的提问来源于stack exchange，提问作者Juan Alvarez