参数化连接
使用参数化连接来管理跨多个环境(开发、预发布、生产)的同一连接,并避免将凭据硬编码。
使用参数化连接
若要通过参数化连接在不同环境间管理连接值,请在 “连接概览 ”选项卡中选中 “启用参数 ”复选框。 启用参数化连接后,您可以导入现有的参数集,或者创建新的参数集。 如果禁用此选项,值将直接存储在连接配置中。
运行时行为
启用参数化连接不会改变您运行作业的方式。 运行时无需执行任何额外步骤,因为平台会在调用连接器之前解析所有参数值。 因此,下游服务(例如 watsonx.ai )接收的是已完全解析的连接值,且不会察觉到参数集的存在。
导入连接属性
- 在 “连接概览 ”选项卡中,选中 “启用参数 ”复选框。
- 单击 “选择参数集 ”选项卡。
- 在 “导入连接属性 ”窗口中,从下拉列表中选择参数集。
- 在 “候选参数 ”选项卡中,选择要导入的参数,然后单击 “添加”。
创建新的参数集
如果您没有现成的参数集可用于连接,请创建一个新的参数集,并将您希望包含在该参数集中的连接属性导入其中。
- 在 “连接概览 ”选项卡中,选中 “启用参数 ”复选框。
- 单击 “选择参数集 ”选项卡。
- 在 “导入连接属性 ”窗口中,单击 “添加参数集 ”按钮。
- 在 “定义可重用参数集 ”窗口中,输入参数集的名称,并(可选)提供描述。 然后点击 “创建”。
- 在“参数集”窗口中,选择 “导入连接属性 ”选项卡。
- 从下拉列表中选择一种连接类型。
- 选择要导入到参数集中的参数,并查看导入表中的以下列:
- 名称 - 参数的名称。
- 类型 - 参数类型,例如字符串(单行、多行、加密)、整数或布尔值。
- 提示 - 一个描述性的参数标题。
- 默认值 ——导入时可选的值。 如果运行时未定义特定环境的值,它将作为备用方案。 如果此字段留空,则该参数没有默认值,必须在值集中进行定义。
- 帮助文本 ——该参数的简要说明。
- 点击 “导入”。
- (可选)点击 “编辑 ”图标,可更改参数类型、添加描述或设置默认值。 您还可以从参数集删除一个参数。
在创建参数集时,您可以添加希望在流程中用作参数的环境变量,或创建新参数。
添加值集
您可以定义一个值集,它是一个为参数集中的参数所定义的、带有名称的值集合。 每个值集对应一个特定的环境,例如开发、预发布或生产环境,并包含该环境所需的相应值。 在运行时,平台会应用与数据管道运行环境相匹配的值集。
例如,连接的参数集可能包含用户名、 密码和主机等属性。 您可以为每个环境定义独立的值集(例如,一个包含开发凭据,另一个包含生产凭据),这样系统就会根据管道的运行环境自动应用相应的值。
要创建一个值集:
- 在“参数集”窗口中,打开 “值集 ”选项卡。
- 点击 “创建值集 ”。
- 在 “创建值集 ”窗口中,为您的值集输入一个名称。
- 请为参数集中的每个参数指定在此环境中要使用的值。
- 点击 “保存”。
管理和编辑连接的参数集
您可以在项目的“资产 ”表中查看和编辑参数集,在此处您可以导入额外的连接属性(已参数化的属性不会被重复),添加环境变量,并为参数集创建新参数。
准则
当参数集包含来自多种连接类型的属性时,平台会显示一条非阻塞警告。 此警告仅供参考,仅作为指导,不影响执行或配置。 这不会影响您继续操作,且无需立即采取任何行动。 这表明您的参数集符合 DataStage-style 的使用方式,即单个参数集可支持多个连接。 您仍然可以使用结合了多种连接类型的参数集。
此外,如果您计划使用参数集进行 1:1 连接绑定,请创建一个仅包含单一连接类型属性的参数集。