【实战教程】如何在 Microsoft Fabric 的 Pipeline 中给 Dataflow 传参数？

简单说，就是：

我们在 Pipeline 里运行 Dataflow 时，动态传入一些值（比如地区、日期、阈值），让 Dataflow 根据这些值来处理数据。

这就像你写了一个 Excel 模板，每次只改几个单元格，就能生成不同的报表。是不是很香？

🧩 第一步：在 Dataflow Gen2 中启用“公共参数模式”

📌 什么是公共参数模式？

这是 Fabric 给 Dataflow 加的一个“开关”，打开后，外部（比如 Pipeline）就可以给它传值了。

✅ 操作步骤：

1. 打开你的 Dataflow Gen2。

2. 点击顶部菜单栏的 “开始” → “选项”。

3. 在弹出的窗口中，点击左侧的 “参数”。

4. 勾选这个选项：

   ✅ 启用要发现的参数并替代执行（Enable parameters to be discovered and override for execution）

5. 保存后，你会看到提示：“已启用公共参数模式”。

📷 图示：Dataflow 参数设置界面

🧩 第二步：在 Pipeline 中配置参数值

现在我们来到了主角——Pipeline！

✅ 操作步骤：

1. 打开 Fabric，创建一个新的 Pipeline。
2. 添加一个活动，选择 “Dataflow ”。
3. 在活动设置里，选择你刚刚设置好的 Dataflow。
4. 找到 “Dataflow 参数” 区域，点击“添加参数”。

🧪 示例：

假设你在 Dataflow 中定义了一个参数叫 Region，你可以这样配置：

{  "Region": "华北"}

{  "Region": "华北",  "Threshold": 100}

很多人问：能不能传日期？

答案是：不能直接传 datetime 类型，但可以传字符串，然后在 Power Query 中转换！

✅ 示例流程：

1. 在 Pipeline 中传入参数：

{  "DateParam": "2025-09-01T00:00:00Z"}

2. 在 Dataflow 的 Power Query 中这样写：

let    DateTimeParsed = DateTimeZone.FromText(DateParam),    Filtered = Table.SelectRows(Source, each [OrderDate] > DateTimeParsed)in    Filtered

🧠 Dataflow 支持哪些参数类型？

目前支持的类型有：

❌ 暂不支持 datetime 类型，但可以用字符串模拟。

🧠 参数命名注意事项

• 参数名要完全一致，区分大小写！
• 不要用空格或特殊字符。
• 建议用英文命名，比如 Region, Threshold, DateParam。

❓ Q1：启用参数模式后还能用计划刷新吗？

❌ 不行。启用后只能通过 Pipeline 来刷新。

❓ Q2：能不能传文件路径？

❌ 不支持动态更改数据源路径或目标路径。

❓ Q3：能不能做增量刷新？

❌ 官方不支持，但你可以自己在 Power Query 中写逻辑实现。

✅ 总结一下