注释
Fabric Dataflow Gen2 中的公共参数可用作预览功能。 只有支持 CI/CD 的 Dataflow Gen2 才能应用此体验。
Dataflow Gen2 中的参数允许动态控制和自定义数据流,从而通过启用不同的输入和方案来更灵活和可重用数据流,而无需修改数据流本身。 它通过减少对多个数据流的需求并在单个参数化数据流中集中控制来帮助保持组织。
数据流 Gen2 中的公共参数设置是一种新模式,您可以通过 Fabric REST API 或原生 Fabric 体验在 Power Query 编辑器之外传递参数值,以刷新数据流。 它使你能够更动态地体验数据流,其中每个刷新都可以使用不同的参数调用,这些参数会影响数据流的刷新方式。
先决条件
- 支持 CI/CD 的 Dataflow Gen2
- 必须在数据流中设置参数。详细了解如何在数据流中设置查询参数。
注意事项和限制
- 启用了公共参数模式的数据流无法通过 Fabric 计划程序设定刷新计划。 唯一的例外是未设置任何必需参数的数据流。
- 无法通过 Fabric 工作区列表或世系视图手动触发启用了公共参数模式的数据流。 唯一的例外是未设置任何必需参数的数据流。
- 不支持影响数据源或目标的资源路径的参数。 连接链接到在创作的数据流中定义的确切数据源路径,当前无法替代以使用其他连接或资源路径。
- 具有增量刷新的数据流不能利用这种新模式。
- 只有类型 十进制数、 整数、 文本 和 true/false 的参数才能传递替代。 任何其他数据类型不会在刷新历史记录中生成刷新请求,但在监视中心显示。
- 公共参数模式允许用户通过重写参数值来修改数据流中定义的逻辑。 它允许有权刷新数据流的其他人使用其他值刷新数据,从而产生来自数据流中使用的数据源的不同输出。
- 监视中心不会显示有关在调用数据流期间传递的参数的信息。
- 暂存查询只会保留存储在 Staging Lakehouse 中的 Dataflow 的最后一次数据刷新。 用户可以使用数据流连接器查看 Staging Lakehouse 中的数据,以了解存储了哪些数据。 强烈建议在使用公共参数模式时定义数据目标。
- 为相同的参数值提交重复的请求时,只会接受第一个请求,后续请求将被拒绝,直到第一个请求完成其评估。
启用公共参数模式
作为数据流的作者,打开 Dataflow。 在功能区的“开始”选项卡中,选择“ 选项 ”按钮。
选择该按钮将打开新的 “选项 ”对话框。 在垂直菜单中,选择包含数据流组中标签参数的选项。 在“参数”部分中,可以启用名为“启用要发现的参数并替代执行”选项以启用公共参数模式。
选择 “确定 ”按钮提交这些更改。
启用此模式后,会在对话框顶部的 “管理参数 ”对话框中收到一条通知,该对话框顶部显示“已启用公共参数模式”。
启用公共参数模式后,可以保存数据流。
传递用于刷新的自定义参数值
公共参数模式遵循数据流中参数的定义,区分必需参数和非必需参数。
- 必需参数:如果参数设置为必需,若要刷新数据流,需要将值传递给刷新作业。 如果未为设置为必需参数传递任何值,则刷新将失败。
- 非必需参数:这些参数也称为 可选 参数,无需传递任何值即可触发刷新。 如果未传递任何值,则使用参数中定义的当前值进行刷新。 但是,始终可以传递用于刷新的替代值。
在数据管道模块中使用数据流刷新功能
注释
建议详细了解 Fabric 数据管道中的数据流活动 ,以了解其所有功能。
在 Fabric 中创建管道时,可以使用数据流刷新活动来触发具有 CI/CD 支持并启用了公共参数模式的 Dataflow Gen2 的刷新。
可以选择要使用的数据流,并设置要在 “数据流参数 ”部分中使用的参数。
在 “数据流参数 ”部分中,可以传递参数的名称、要传递的值的类型以及要传递的值。 可以手动添加要替代的所有受支持参数。
重要
请务必按照数据流中输入的参数名称准确传递,因为参数名称是区分大小写的。