Power BI本地网关无法通过服务主体连接至Azure SQL数据库

云原生阿岚

2026-4-15

遇到这种情况，大概率是几个关键环节没配置到位，我帮你梳理下具体的排查和解决方向：

先验证专用端点的网络连通性
首先要确认运行本地网关的VM能正常访问Azure SQL的专用端点。你可以在VM上执行这两个命令测试：
```
Test-NetConnection <你的SQL服务器全名>.database.windows.net -Port 1433
```
或者用telnet：
```
telnet <你的SQL服务器全名>.database.windows.net 1433
```
如果不通，得检查虚拟网络的路由表、网络安全组（NSG）有没有放行1433端口的流量，还要确认专用DNS区域的配置是否正确——只有VM能正确解析SQL服务器的私有IP，才能建立连接。
检查服务主体的权限是否完整
虽然你已经把服务主体加到了db_datareader角色，但别忘了还要给它授予Azure SQL的登录权限。登录到SQL数据库执行以下SQL语句：
```
CREATE USER [你的服务主体名称] FROM EXTERNAL PROVIDER;
ALTER ROLE db_datareader ADD MEMBER [你的服务主体名称];
```
注意这里的服务主体名称要和MS Entra里的显示名称完全一致，别输错字符。
核对Power BI网关的连接配置细节
在配置网关连接时，选择「服务主体」认证后，要确保填写的应用程序ID（Client ID）和客户端密钥（Client Secret）完全正确，而且密钥没有过期。另外数据库服务器名称一定要填完整的FQDN（比如xxx.database.windows.net），不能只填服务器短名。
检查网关版本兼容性
旧版本的本地网关可能对服务主体认证、专用端点的支持存在bug，建议把网关升级到最新版本后再尝试连接。