如何通过Python创建Managed Identity认证的Azure Data Factory链接服务
Azure Data Factory 托管标识认证Linked Service的Python实现方案
实现逻辑
你之前用快速入门代码搭建的创建流程完全可以复用,不需要改动SDK初始化、API调用的整体结构,仅需替换Linked Service配置中涉及认证的字段即可。
具体替换规则:
- 移除原有配置中所有存储访问密钥、数据库账号密码类的敏感字段,比如
accountKey、password、连接串里的密钥片段 - 在
typeProperties节点下新增authenticationType: ManagedIdentity字段,明确声明认证模式 - 保留资源连接所需的非敏感基础信息,比如资源URL、服务器地址、数据库名
- 若使用用户分配托管标识(而非ADF内置的系统分配托管标识),需在
typeProperties中额外配置credential字段,关联提前在ADF中创建的托管标识凭证对象
可直接运行的代码示例
以下示例可直接对接你已初始化完成的DataFactoryManagementClient实例,和原有账号密钥模式的API调用逻辑完全一致:
1. Azure Data Lake Gen2 存储(系统分配MSI)
adf_client.linked_services.create_or_update( resource_group_name="<你的资源组名称>", factory_name="<你的ADF实例名称>", linked_service_name="AdlsGen2MsiLink", properties={ "type": "AzureBlobFS", "typeProperties": { "url": "https://<你的存储账号名>.dfs.core.windows.net", "authenticationType": "ManagedIdentity" } } )
2. Azure SQL 数据库(系统分配MSI)
adf_client.linked_services.create_or_update( resource_group_name="<你的资源组名称>", factory_name="<你的ADF实例名称>", linked_service_name="SqlMsiLink", properties={ "type": "AzureSqlDatabase", "typeProperties": { "server": "<你的SQL服务器名>.database.windows.net", "database": "<你的数据库名>", "authenticationType": "ManagedIdentity" } } )
用户分配托管标识的扩展配置
如果需要绑定用户分配的托管标识,只需在上述任意一个示例的typeProperties里补充以下配置块即可,前提是你已经在ADF中创建了对应关联用户MSI的凭证对象:
"credential": { "referenceName": "<你在ADF中创建的MSI凭证名称>", "type": "CredentialReference" }
常见配置问题
- 不要把
authenticationType字段放在typeProperties的外层,SDK会判定为无效参数,导致配置无法落地 - 系统分配MSI模式下不需要额外传身份凭证参数,只要ADF的系统托管标识在目标资源上被授予了对应访问权限(比如存储的Storage Blob Data Contributor角色、SQL的数据库用户权限),就可以正常连通
- 需确认
azure-mgmt-datafactorySDK版本不低于4.0.0,低版本SDK存在兼容问题,会静默忽略托管标识相关的配置字段 - 所有支持MSI认证的Linked Service类型,认证类型的枚举值统一为
ManagedIdentity,不需要针对不同资源调整参数值
内容的提问来源于stack exchange,提问作者Mendi Neymark
相关产品推荐
相关产品推荐

