从DevOps任务调用PowerShell执行Synapse管道运行时JSON参数报错

问题核心原因 #

PowerShell与Azure CLI对JSON字符串的解析规则存在差异，直接拼接字符串或简单赋值容易出现引号转义错误、JSON格式不规范的问题，导致命令执行失败。

可行的参数传递方案 #

1. 使用PowerShell Here-String定义JSON参数 #

Here-String可以保留JSON的原生格式，无需手动转义引号，避免格式混乱：

$jsonParams = @"
{
    "data_source": {
        "source_path": "/your-container/target-folder",
        "file_pattern": "*.parquet"
    }
}
"@

az synapse pipeline create-run --workspace-name "your-synapse-workspace" --name "target-pipeline" --parameters $jsonParams

2. 通过PS对象转换为标准JSON字符串 #

如果参数需要动态生成，先构建PowerShell对象再转换为JSON，确保格式严格合法：

# 构建参数对象
$paramObject = @{
    data_source = @{
        source_path = "/your-container/target-folder"
        "file_pattern" = "*.parquet"
    }
}
# 转换为压缩格式JSON，减少转义问题
$jsonParams = $paramObject | ConvertTo-Json -Compress

az synapse pipeline create-run --workspace-name "your-synapse-workspace" --name "target-pipeline" --parameters $jsonParams

3. 直接传递转义后的JSON字符串 #

若必须直接拼接，需对PowerShell中的双引号用反引号`转义：

az synapse pipeline create-run --workspace-name "your-synapse-workspace" --name "target-pipeline" --parameters '{`"data_source`":{`"source_path`":`"/your-container/target-folder`",`"file_pattern`":`"*.parquet`"}}'

注：该方式仅适合结构简单的JSON，复杂场景容易出错。

4. 通过文件传递参数 #

将JSON内容写入临时文件，通过@<文件路径>的方式传递，适合复杂JSON参数：

$tempJsonPath = Join-Path $env:TEMP "synapse-pipeline-params.json"
# 写入JSON内容
@'
{
    "data_source": {
        "source_path": "/your-container/target-folder",
        "file_pattern": "*.parquet"
    }
}
'@ | Out-File -FilePath $tempJsonPath -Encoding utf8

# 调用命令传递文件参数
az synapse pipeline create-run --workspace-name "your-synapse-workspace" --name "target-pipeline" --parameters @$tempJsonPath

# 执行完成后清理临时文件
Remove-Item $tempJsonPath -Force

验证与排查步骤 #

• 先在本地PowerShell中输出$jsonParams变量，检查JSON格式是否正确，无多余转义或缺失引号
• 本地测试命令成功后，再迁移到DevOps任务中
• 确保DevOps任务已完成Azure CLI安装和Azure账号登录操作

内容的提问来源于stack exchange，提问作者Rohith Korupalli