如何通过代码将Power BI语义模型部署到10个工作空间并切换SQL数据源

当然可以通过脚本实现这个需求，最直接的方式是结合Power BI REST API，用PowerShell或Python编写自动化脚本，批量完成语义模型复制和数据源配置修改。以下是具体实现方案：

前期准备 #

你需要先收集好这些信息：

• 源工作空间ID、源语义模型（数据集）ID（在Power BI工作空间的语义模型设置页能找到）
• 10个目标工作空间的ID
• 每个目标对应的SQL Server数据库名称、SQL Server实例地址
• 已配置好的网关ID（在Power BI管理门户的「网关」板块查看）
• 有足够权限的服务主体/用户凭据（推荐用服务主体，权限管控更方便）
• 确保网关已经能访问所有目标SQL Server数据库

PowerShell脚本实现示例 #

1. 认证到Power BI服务 #

用服务主体获取访问令牌：

# 替换为你的实际信息
$tenantId = "你的租户ID"
$clientId = "服务主体应用ID"
$clientSecret = "服务主体客户端密钥"

$tokenEndpoint = "https://login.microsoftonline.com/$tenantId/oauth2/token"
$resource = "https://analysis.windows.net/powerbi/api"

$authBody = @{
    grant_type    = "client_credentials"
    client_id     = $clientId
    client_secret = $clientSecret
    resource      = $resource
}

$authResponse = Invoke-RestMethod -Uri $tokenEndpoint -Method Post -Body $authBody
$accessToken = $authResponse.access_token

2. 批量处理目标工作空间 #

先把所有目标的工作空间ID和对应数据库名整理成数组，然后循环执行复制+修改数据源：

# 定义目标列表，替换为你的10个目标信息
$targetList = @(
    @{WorkspaceId = "目标工作空间1ID"; DbName = "DB_01"},
    @{WorkspaceId = "目标工作空间2ID"; DbName = "DB_02"},
    # ... 补充剩下8个目标
)

$sourceWorkspaceId = "源工作空间ID"
$sourceDatasetId = "源语义模型ID"
$sqlServerInstance = "你的SQL Server实例地址"
$gatewayId = "网关ID"
$sqlUsername = "SQL认证用户名"
$sqlPassword = "SQL认证密码"

foreach ($target in $targetList) {
    # 第一步：复制源语义模型到目标工作空间
    $cloneUrl = "https://api.powerbi.com/v1.0/myorg/groups/$sourceWorkspaceId/datasets/$sourceDatasetId/Clone"
    $cloneBody = @{
        targetGroupId = $target.WorkspaceId
        name          = "业务语义模型_$($target.DbName)" # 自定义目标语义模型名称
    } | ConvertTo-Json

    $cloneResult = Invoke-RestMethod -Uri $cloneUrl -Method Post -Headers @{Authorization = "Bearer $accessToken"} -Body $cloneBody -ContentType "application/json"
    $targetDatasetId = $cloneResult.id

    # 第二步：修改目标语义模型的数据源配置
    # 获取目标数据集的数据源信息
    $dsUrl = "https://api.powerbi.com/v1.0/myorg/groups/$($target.WorkspaceId)/datasets/$targetDatasetId/datasources"
    $datasources = Invoke-RestMethod -Uri $dsUrl -Headers @{Authorization = "Bearer $accessToken"}

    foreach ($ds in $datasources.value) {
        if ($ds.datasourceType -eq "Sql") {
            $updateBody = @{
                credentialDetails = @{
                    credentialType = "Basic" # 根据你的网关认证方式调整，比如Windows/ServiceAccount
                    credentials    = "{""username"":""$sqlUsername"",""password"":""$sqlPassword""}"
                    encryptedConnection = "Encrypted"
                    privacyLevel = "Organizational"
                }
                connectionDetails = @{
                    server = $sqlServerInstance
                    database = $target.DbName
                }
                gatewayId = $gatewayId
            } | ConvertTo-Json -Depth 3

            $updateDsUrl = "https://api.powerbi.com/v1.0/myorg/groups/$($target.WorkspaceId)/datasets/$targetDatasetId/datasources/$($ds.id)"
            Invoke-RestMethod -Uri $updateDsUrl -Method Patch -Headers @{Authorization = "Bearer $accessToken"} -Body $updateBody -ContentType "application/json"
        }
    }

    Write-Host "已完成目标工作空间 $($target.WorkspaceId) 的语义模型部署与数据源配置"
}

关键注意事项 #

• 服务主体必须拥有源工作空间的读取权限，以及每个目标工作空间的成员/管理员权限
• 网关必须提前配置好对所有目标数据库的访问权限，否则数据源更新会失败
• 如果语义模型包含行级别安全（RLS），复制后需要重新配置规则（如果有定制需求）
• 若使用Windows认证，credentialType改为Windows，credentials里填Windows账号密码

替代方案：Power BI CLI #

如果不想写原生脚本，可以用官方的Power BI CLI工具（pbi-cli），它封装了REST API，语法更简洁。核心命令示例：

• 复制语义模型：

pbi dataset clone --source-workspace-id <源工作空间ID> --dataset-id <源数据集ID> --target-workspace-id <目标ID> --name <新语义模型名称>

• 更新数据源：

pbi datasource update --workspace-id <目标ID> --dataset-id <目标数据集ID> --datasource-id <数据源ID> --connection-details '{"server":"<SQL实例>","database":"<目标DB>"}' --gateway-id <网关ID> --credential-type Basic --credentials '{"username":"<账号>","password":"<密码>"}'

同样可以用循环（比如bash脚本）批量处理10个目标。

内容的提问来源于stack exchange，提问作者Kotana Sai