使用服务主体认证无法加载Power BI报表且无法通过访问令牌导出视觉对象级别数据

我来帮你排查下这个服务主体认证的问题，你遇到的打印报表显示Report()空对象、没法导出视觉数据的情况，大概率是权限配置或者代码流程没走对，咱们一步步来解决：

一、先确认服务主体的权限配置（最容易踩坑的点） #

• 工作区权限：服务主体必须被添加到目标报表所在的Power BI工作区，并且分配「成员」或「管理员」角色。你登录Power BI Service后，找到对应工作区，进入「访问权限」，搜索你的服务主体（用client_id对应的应用名称），添加并设置合适的角色。
• 全局API权限开关：Power BI管理员需要在Admin Portal里开启「允许服务主体访问Power BI API」的设置，这个是全局控制项，没开的话服务主体根本没法正常访问报表资源。

二、修正代码流程，正确初始化Report对象 #

你现在的代码只完成了获取access_token的步骤，但没有正确传入报表参数初始化Report对象，所以才会打印出空的Report()。给你补全正确的代码示例：

from powerbiclient import Report, models
import requests
import os  # 用环境变量存密钥更安全

tenant_id = 'AAA'
client_id = 'BBB'
# 建议把密钥存在环境变量里，不要硬编码
client_secret = os.getenv("POWERBI_CLIENT_SECRET")  

# 获取访问令牌
url = f'https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token'
headers = {'Content-Type': 'application/x-www-form-urlencoded'}
body = {
    'grant_type': 'client_credentials',
    'client_id': client_id,
    'client_secret': client_secret,
    'scope': 'https://analysis.windows.net/powerbi/api/.default'
}

response = requests.post(url, headers=headers, data=body)
if response.status_code == 200:
    access_token = response.json().get('access_token')
    if not access_token:
        print("获取访问令牌失败，响应中没有token字段")
    else:
        # 替换成你自己的报表ID和嵌入URL
        report_id = "你的报表唯一ID"
        embed_url = "你的报表嵌入URL（可以从Power BI Service的嵌入设置里获取）"
        
        # 正确初始化Report对象，指定token类型为AAD
        report = Report(
            token=access_token,
            embed_url=embed_url,
            id=report_id,
            token_type=models.TokenType.AAD
        )
        print(report)  # 现在应该能看到包含报表信息的对象，而不是空的Report()
        
        # 导出视觉对象数据的示例
        # 先获取报表里的所有视觉对象
        visuals = report.get_visuals()
        if visuals:
            # 取第一个视觉对象的ID，你可以换成目标视觉对象的ID
            target_visual_id = visuals[0]['name']
            # 导出数据，rows参数控制返回行数
            visual_data = report.export_visual_data(target_visual_id, rows=100)
            print("导出的视觉对象数据：")
            print(visual_data)
else:
    print(f"请求令牌失败，状态码：{response.status_code}")
    print(f"错误详情：{response.json()}")

三、导出视觉数据的额外注意事项 #

• 如果报表连接的是本地数据源（比如通过On-Premises Data Gateway），服务主体必须被添加到网关的权限列表里，否则没法读取底层数据。
• 部分复杂视觉对象（比如自定义视觉、某些特殊矩阵）可能不支持导出数据，你可以先在Power BI Service里手动尝试导出，如果手动都失败，代码也无法实现。

备注：内容来源于stack exchange，提问作者user1702932