如何在Azure Synapse日志中获取管道和数据流的调试运行详情？

核心问题说明 #

Synapse的管道/数据流调试运行属于临时交互式会话，默认不会写入常规的ActivityRun或PipelineRun日志表，所以直接查询正式运行日志找不到相关数据。

解决步骤 #

1. 启用调试日志持久化（长期统计必备） #

在Synapse Studio中操作：

• 进入管理面板 → 选择监控设置 → 打开调试运行设置
• 勾选「保存调试运行数据到日志分析工作区」（前提是Synapse已关联Log Analytics工作区）
• 保存设置后，后续所有调试运行都会被持久化到日志工作区，支持批量查询统计。

2. 查询调试运行时长（已启用持久化） #

使用Log Analytics的Kusto查询语言，针对调试专用日志表统计：

管道调试总时长统计

SynapsePipelineDebugRuns
| where PipelineName == "目标管道名称"  // 替换为你的管道名
| project StartTime, EndTime, PipelineName, DebugRunId
| extend 单次调试时长秒 = datetime_diff("second", EndTime, StartTime)
| summarize 总调试时长秒 = sum(单次调试时长秒) by PipelineName

数据流调试总时长统计

SynapseActivityDebugRuns
| where ActivityType == "ExecuteDataFlow" and ActivityName == "目标数据流名称"  // 替换为你的数据流名
| project StartTime, EndTime, ActivityName, DebugRunId
| extend 单次调试时长秒 = datetime_diff("second", EndTime, StartTime)
| summarize 总调试时长秒 = sum(单次调试时长秒) by ActivityName

3. 临时查看历史调试时长（未启用持久化） #

如果之前没开日志持久化，只能在Synapse Studio的监控 → 调试运行页面，手动查看最近7天内的调试会话记录，每个会话会显示运行时长，需手动汇总。

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