参数化连接

使用参数化连接来管理跨多个环境(开发、预发布、生产)的同一连接,并避免将凭据硬编码。

使用参数化连接

若要通过参数化连接在不同环境间管理连接值,请在 “连接概览 ”选项卡中选中 “启用参数 ”复选框。 启用参数化连接后,您可以导入现有的参数集,或者创建新的参数集。 如果禁用此选项,值将直接存储在连接配置中。

运行时行为

启用参数化连接不会改变您运行作业的方式。 运行时无需执行任何额外步骤,因为平台会在调用连接器之前解析所有参数值。 因此,下游服务(例如 watsonx.ai )接收的是已完全解析的连接值,且不会察觉到参数集的存在。

导入连接属性

  1. “连接概览 ”选项卡中,选中 “启用参数 ”复选框。
  2. 单击 “选择参数集 ”选项卡。
  3. “导入连接属性 ”窗口中,从下拉列表中选择参数集。
  4. “候选参数 ”选项卡中,选择要导入的参数,然后单击 “添加”

创建新的参数集

如果您没有现成的参数集可用于连接,请创建一个新的参数集,并将您希望包含在该参数集中的连接属性导入其中。

  1. “连接概览 ”选项卡中,选中 “启用参数 ”复选框。
  2. 单击 “选择参数集 ”选项卡。
  3. “导入连接属性 ”窗口中,单击 “添加参数集 ”按钮。
  4. “定义可重用参数集 ”窗口中,输入参数集的名称,并(可选)提供描述。 然后点击 “创建”
  5. 在“参数集”窗口中,选择 “导入连接属性 ”选项卡。
  6. 从下拉列表中选择一种连接类型。
  7. 选择要导入到参数集中的参数,并查看导入表中的以下列:
  • 名称 - 参数的名称。
  • 类型 - 参数类型,例如字符串(单行、多行、加密)、整数或布尔值。
  • 提示 - 一个描述性的参数标题。
  • 默认值 ——导入时可选的值。 如果运行时未定义特定环境的值,它将作为备用方案。 如果此字段留空,则该参数没有默认值,必须在值集中进行定义。
  • 帮助文本 ——该参数的简要说明。
  1. 点击 “导入”
  2. (可选)点击 “编辑 ”图标,可更改参数类型、添加描述或设置默认值。 您还可以从参数集删除一个参数。

在创建参数集时,您可以添加希望在流程中用作参数的环境变量,或创建新参数。

添加值集

您可以定义一个值集,它是一个为参数集中的参数所定义的、带有名称的值集合。 每个值集对应一个特定的环境,例如开发、预发布或生产环境,并包含该环境所需的相应值。 在运行时,平台会应用与数据管道运行环境相匹配的值集。

例如,连接的参数集可能包含用户名密码和主机等属性。 您可以为每个环境定义独立的值集(例如,一个包含开发凭据,另一个包含生产凭据),这样系统就会根据管道的运行环境自动应用相应的值。

要创建一个值集:

  1. 在“参数集”窗口中,打开 “值集 ”选项卡。
  2. 点击 “创建值集 ”。
  3. “创建值集 ”窗口中,为您的值集输入一个名称。
  4. 请为参数集中的每个参数指定在此环境中要使用的值。
  5. 点击 “保存”

管理和编辑连接的参数集

您可以在项目的“资产 ”表中查看和编辑参数集,在此处您可以导入额外的连接属性(已参数化的属性不会被重复),添加环境变量,并为参数集创建新参数。

准则

当参数集包含来自多种连接类型的属性时,平台会显示一条非阻塞警告。 此警告仅供参考,仅作为指导,不影响执行或配置。 这不会影响您继续操作,且无需立即采取任何行动。 这表明您的参数集符合 DataStage-style 的使用方式,即单个参数集可支持多个连接。 您仍然可以使用结合了多种连接类型的参数集。

此外,如果您计划使用参数集进行 1:1 连接绑定,请创建一个仅包含单一连接类型属性的参数集。