小窍门
有关如何在连续集成/连续部署（CI/CD）方案中利用此功能的详细信息，请阅读 有关 Dataflow Gen2 的 CI/CD 和 ALM 解决方案体系结构 以及 有关参数化数据流 Gen2 的端到端教程的文章。
Dataflow Gen2 中的参数允许动态控制和自定义数据流，从而通过启用不同的输入和方案来更灵活和可重用数据流，而无需修改数据流本身。 它通过减少对多个数据流的需求并在单个参数化数据流中集中控制来帮助保持组织。
数据流 Gen2 中的公共参数是一种新模式，您可以通过 Fabric REST API 或本机 Fabric 体验在 Power Query 编辑器之外传递参数值，以便运行数据流。 它允许你更动态地体验数据流，其中每个运行都可以使用不同的参数调用，这些参数会影响数据流的运行方式。
先决条件
- 支持 CI/CD 的 Dataflow Gen2
- 必须在数据流中设置参数。详细了解如何在数据流中设置查询参数。
启用公共参数模式
作为数据流的所有者，打开数据流。 在功能区的“开始”选项卡中，选择“ 选项 ”按钮。
选择该按钮将打开新的 “选项 ”对话框。 在垂直菜单中，选择包含数据流组中标签参数的选项。 在“参数”部分中，可以启用名为“启用要发现的参数并替代执行”选项以启用公共参数模式。
选择 “确定 ”按钮提交这些更改。
启用此模式后，会在对话框顶部的 “管理参数 ”对话框中收到一条通知，该对话框顶部显示“已启用公共参数模式”。
启用公共参数模式后，可以保存数据流。
为数据流运行传递自定义参数值
公共参数模式遵循数据流中参数的定义，区分必需参数和非必需参数。
- 必需参数：如果参数设置为必需，若要运行数据流，需要将值传递给运行作业。 如果未为设置为必需参数传递任何值，则运行将失败。
- 非必需参数：这些参数也称为 可选 参数，无需传递任何值才能触发运行。 如果未传递任何值，则参数中定义的 当前值 用于运行。
在管道中使用数据流活动
注释
建议详细了解 Fabric 管道中的数据流活动 ，以了解其所有功能。
在 Fabric 中创建管道时，可以使用数据流任务来触发具有 CI/CD 支持和启用公共参数模式的数据流 Gen2 的运行。
可以选择要使用的数据流，并设置要在 “数据流参数 ”部分中使用的参数。
在 “数据流参数 ”部分中，可以看到数据流中可用的所有参数，以及值节内每个参数的默认值。
必需参数在其名称旁边具有星号，而可选参数则不具有星号。 同时，可以从网格中删除可选参数，而无法删除所需的参数，并且必须传递值才能运行数据流。
可以选择刷新按钮，从数据流请求最新的参数信息。
支持的参数类型
小窍门
读取和使用 探测数据流参数的 REST API。 本文档提供所有可用的参数类型及其预期值，REST API 提供了从数据流获取参数信息的方法。
下表展示了当前支持的参数类型和 REST API 定义的链接，以便了解 REST API 的预期值。
| 数据流参数类型 | REST API 定义 |
|---|---|
| 文本 | DataflowStringParameter |
| 整数 （int64） | DataflowIntegerParameter |
| 十进制数 | DataflowNumberParameter |
| 日期 | DataflowDateParameter |
| 日期时间 | DataflowDateTimeParameter |
| Time | DataflowTimeParameter |
| DateTimeZone | DataflowDateTimeZoneParameter |
| 持续时间 | DataflowDurationParameter |
| 真/假 | DataflowBooleanParameter |
注意事项和限制
在使用数据流 Gen2 的公开参数模式与 CI/CD 时，请注意以下所有注意事项和限制：
- 计划与手动触发：无法通过 Fabric 计划或手动触发具有公共参数的数据流，除非未设置任何必需的参数。
- 不支持参数化：不支持更改源或目标的资源路径的参数。 连接固定到指定的路径。
- 增量刷新：与公共参数模式不兼容。
- 逻辑修改：公共参数允许用户访问替代值，从而可能会更改数据流输出。
- 监视中心：监视中心不显示执行期间使用的参数值。
- 暂存行为：只有最新的运行存储在 Staging Lakehouse 中。 使用定义的目的地来保留数据。
- 重复请求：如果多次提交相同的参数值，则只有第一个请求被接受，直到它完成。
- 架构映射：参数无法修改目标架构映射。 所有映射都遵循编写的配置。 有关 数据流 Gen2 中的数据目标和托管设置的详细信息，请查看本文。