在设计器中使用管道参数生成通用管道

重要

本文提供有关使用 Azure 机器学习 SDK v1 的信息。 SDK v1 自 2025 年 3 月 31 日起弃用。 对它的支持将于 2026 年 6 月 30 日结束。 可以在该日期之前安装和使用 SDK v1。 使用 SDK v1 的现有工作流将在支持结束日期后继续运行。 但是,在产品发生体系结构更改时,可能会面临安全风险或中断性变更。

建议在 2026 年 6 月 30 日之前过渡到 SDK v2。 有关 SDK v2 的详细信息,请参阅 什么是 Azure 机器学习 CLI 和 Python SDK v2? 以及 SDK v2 参考

本文介绍如何使用管道参数在 Azure 机器学习设计器中生成灵活的管道。 使用管道参数可以在运行时动态设置值,以便封装管道逻辑并重复使用资产。

重新提交管道作业、 重新训练模型执行批处理预测时,管道参数特别有用。

本文介绍如何执行以下操作:

  • 创建管道参数。
  • 删除和管理管道参数。
  • 触发管道作业时提供管道参数。

先决条件

重要

如果看不到本文中提到的 UI 元素,例如 Studio 或设计器中的按钮,则可能是因为您没有足够的工作区权限级别。 请与 Azure 订阅管理员联系,验证是否已获得正确的访问权限级别。 有关详细信息,请参阅管理用户和角色

创建管道参数

在设计器中创建管道参数有三种方法:

  • 在设置面板中创建管道参数并将其绑定到组件。
  • 将组件参数提升为管道参数。
  • 将数据集提升到管道参数。

注释

管道参数仅支持基本数据类型,例如 intfloatstring

选项 1:在设置面板中创建管道参数

在本部分,你将在设置面板中创建管道参数。

  1. 在管道草稿中,选择 “管道”接口

  2. “管道接口 ”部分中,选择 + 按钮,然后选择参数类型,例如 Double

  3. 输入参数名称和默认值。

    例如,输入 minimum-missing-value-ratio-2 为输入名称和 0.1 默认值。

    显示如何创建管道参数的屏幕截图。

  4. 选择“保存”

创建管道参数之后,必须将其附加到要动态设置的组件参数

选项 2:升级组件参数

为组件值创建管道参数的最简单方法是提升组件参数。 使用以下步骤将组件参数提升为管道参数:

  1. 双击要向其附加管道参数的组件。

  2. 选择要指定的参数旁边的省略号按钮(...)。

  3. 选择“添加到管道输入”

    显示如何将组件参数提升为管道参数的屏幕截图。

  4. 输入输入名称和默认值。

  5. 选择“保存”

现在可以在提交管道时为此参数指定新值。

选项 3:将数据集提升为管道参数

如果要使用变量数据集提交管道,需要将数据集提升为管道参数:

  1. 双击要转换为管道参数的数据集。

  2. 在数据集的详细信息窗格中,选择“ 设置为管道输入”。

    显示如何将数据集设置为管道参数的屏幕截图。

  3. 选择“保存”

现在,你就可以在下次运行管道时使用管道参数来指定其他数据集。

将组件参数附加到管道参数或从管道参数分离组件参数

本部分介绍如何将组件参数附加到管道参数以及如何从管道参数分离组件参数。

将组件参数附加到管道参数

如果要在触发管道作业时一次更改值,可以将重复组件的组件参数附加到同一管道参数。

在以下示例中,将复制 “清理缺失数据 ”组件。 对于每个 清理缺失数据 组件,将 最小缺失值比率 附加到管道参数 minimum-missing-value-ratio-2

  1. 双击“ 清理缺失的数据 ”组件。

  2. 选择“...”省略号按钮,该按钮位于“最小缺失值比率”框的上方。

  3. 选择管道参数 minimum-missing-value-ratio-2

    显示如何附加管道参数的屏幕截图。

  4. 选择“保存”

已成功将 “最小值缺失值比率 ”字段附加到管道参数。

从管道参数分离组件参数

从管道参数分离组件参数时,它无法执行。

可以通过选择组件参数旁边的省略号按钮(...),然后选择 “从管道输入分离”来分离组件参数。

显示如何分离组件参数的屏幕截图。

更新和删除管道参数

本部分介绍如何更新和删除管道参数。

更新管道参数

完成以下步骤以更新组件管道参数:

  1. 在画布右侧,选择 “管道”界面
  2. 可以查看和更新所有管道参数的名称和默认值。

删除数据集管道参数

完成以下步骤以删除数据集管道参数:

  1. 双击数据集组件。
  2. 清除 “设置为管道输入 ”复选框。
  3. 选择“保存”

删除组件管道参数

完成以下步骤以删除组件管道参数:

  1. 在画布右侧,选择 “管道”界面

  2. 选择管道参数旁边的回收站图标。

    显示应用于组件的当前管道参数的屏幕截图。

  3. 在弹出窗口中确认删除。

    注释

    删除管道参数会导致所有附加组件参数被分离。 分离组件参数的值将保留当前管道参数值。

触发管道作业时提供管道参数

在本部分中,你将了解如何在提交管道作业时提供管道参数。

重新提交管道作业

使用管道参数提交管道后,可以使用不同的参数重新提交作业:

  1. 转到管道详细信息页面。 在 “管道运行概述 ”窗格中,可以检查当前管道参数和值。

  2. 选择“重新提交”。

  3. “设置管道作业 ”窗口中,指定新的管道参数。

    显示如何使用管道参数重新提交管道的屏幕截图。

使用已发布的管道

还可以发布管道以使用其管道参数。 已发布的管道是已部署到计算资源上的管道。 客户端应用程序可以通过 REST 终结点调用管道。

已发布的终结点对于重新训练和批量预测应用场景特别有用。 有关详细信息,请参阅如何在设计器中重新训练模型在设计器中运行批量预测

后续步骤

在本文中,你了解了如何在设计器中创建管道参数。 接下来,你将了解如何使用管道参数重新训练模型或执行批量预测

你还可以了解如何通过 SDK v1 以编程方式使用管道