用途:该技能用于在创建或修改 Azure Data Factory(ADF)管道前,检查活动嵌套规则、资源上限与常见校验陷阱,避免管道创建失败或运行报错。
主要能力:说明四类支持嵌套的控制流活动(ForEach、If Condition、Until、Switch)的允许与禁止组合,例如 ForEach 内可放 If/Switch,但 If 内不能放 ForEach/Switch/Until,ForEach 不能嵌套 ForEach,Until 不能嵌套 Until/ForEach;Validation 活动只能位于管道根级。列出资源上限,如每管道活动数 80、参数 50、ForEach 并发上限 50、ForEach 条目 100,000、Lookup 返回 5,000 行或 4 MB、Web 活动超时 1 小时、复制活动超时 7 天。还涵盖并行 ForEach 中不可用 Set Variable、数据流列名 128 字符与行大小 1 MB 等限制。
使用方式:禁止嵌套时可用 Execute Pipeline 调用子管道绕过,子管道拥有独立嵌套层级。仓库提供 PowerShell 校验脚本,路径为 ${CLAUDE_PLUGIN_ROOT}/scripts/validate-adf-pipelines.ps1,基本用法为 pwsh -File validate-adf-pipelines.ps1,可加 -PipelinePath、-DatasetPath、-Strict 参数;也可用 /adf-validate 命令运行并解释结果。退出码 0 表示通过,1 表示存在错误、不应部署。可集成到 GitHub Actions 或 Azure DevOps。
适用场景与限制:适合编写、审查或批量生成 ADF 管道 JSON 时做合规检查。脚本检查的是官方 @microsoft/azure-data-factory-utilities 未覆盖的嵌套违规、资源上限、变量作用域、数据集属性与复制活动兼容性等问题。具体连接器校验细节见 references/linked-services.md,嵌套矩阵见 references/nesting-rules.md,资源上限见 references/resource-limits.md。资料未提供该技能的收费、价格与平台支持信息。