Azure Data Factory中linkedService函数无效的密钥库参数化问题

问题原因 #

不同类型链接服务的模板解析上下文存在差异：SQL数据库链接服务支持在关联Key Vault时使用@linkedService()函数读取自身参数，但REST类型链接服务在配置Key Vault引用的场景下，模板引擎无法识别linkedService()函数——因为此时Key Vault链接服务的名称解析优先级高于REST链接服务的参数上下文，导致函数调用无效。

解决方案 #

步骤1：参数化Key Vault链接服务 #

将Key Vault链接服务本身配置为参数化：

• 编辑Key Vault链接服务，添加参数AZKeyVaultName
• 在Key Vault名称输入框中填入@linkedService().AZKeyVaultName
• 保存参数化后的Key Vault链接服务

步骤2：关联REST链接服务与参数化Key Vault链接服务 #

配置REST链接服务时：

• 选择上述参数化的Key Vault链接服务作为密钥来源
• 给REST链接服务添加同名参数AZKeyVaultName
• 在Key Vault链接服务的参数映射中，将REST链接服务的AZKeyVaultName参数传递给Key Vault链接服务的对应参数

步骤3：管道层传递全局参数 #

在管道中：

• 针对REST链接服务（或其关联的数据集），将全局参数中的Key Vault名称赋值给AZKeyVaultName参数
• 参数会逐层传递：管道 → REST链接服务 → Key Vault链接服务，最终正确解析Key Vault名称

临时替代方案（不推荐，安全性较低） #

如果上述参数传递链路仍有问题，可临时通过管道参数直接将API密钥传递给REST链接服务的密钥字段，但该方式会暴露密钥在管道参数中，不符合安全最佳实践。

内容的提问来源于stack exchange，提问作者Dmitriy Ryabin