使用Bicep部署Azure BlobFS链接服务至ADF时遇集成运行时错误求助

错误原因总结 #

1. 集成运行时引用关联问题：尽管AutoResolveIntegrationRuntime状态正常，但部署时ADF资源刚创建完成，IR可能未完全完成初始化流程；同时链接服务的其他错误配置触发了更宽泛的输入格式验证失败。
2. 链接服务核心配置错误：
   • 错误将accountKey设置为ADF的系统分配主体ID，完全不符合AzureBlobFS链接服务的认证逻辑。
   • 冗余的credential配置块（未关联有效凭据资源）干扰了认证规则校验。
   • 使用Blob存储端点（primaryEndpoints.blob），但AzureBlobFS类型对应ADLS Gen2，需使用DFS端点（primaryEndpoints.dfs）。

修正步骤 #

1. 正确配置connectVia块 #

针对AutoResolveIntegrationRuntime，有两种合规配置方式：

• 推荐方式：省略connectVia块：ADF默认会自动使用AutoResolveIntegrationRuntime，无需显式声明。
• 显式声明方式（若需明确指定）：

  connectVia: {
    referenceName: 'AutoResolveIntegrationRuntime'
    type: 'IntegrationRuntimeReference'
    parameters: {}
  }
  

2. 修正AzureBlobFS认证与端点配置 #

移除错误的accountKey和冗余的credential块，替换为ADLS Gen2的DFS端点，修正后的typeProperties如下：

typeProperties: {
  azureCloudType: 'AzurePublic'
  servicePrincipalCredentialType: 'SecureString'
  servicePrincipalId: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
  servicePrincipalKey: {
    type: 'SecureString'
    value: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
  }
  tenant: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
  url: bicepstorage.properties.primaryEndpoints.dfs
}

完整修正后的Bicep代码 #

//---Data Factory
resource datafactory 'Microsoft.DataFactory/factories@2018-06-01' = {
  name: adf_name
  location: loc_name
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    globalParameters: {}
    publicNetworkAccess: 'Enabled'
  }
}

//--- Data Factory Linked Service
resource adls_linked_service 'Microsoft.DataFactory/factories/linkedservices@2018-06-01' = {
  name: 'ls_adf_to_adls'
  parent: datafactory
  properties: {
    annotations: []
    description: 'linked_service_for_adls'
    parameters: {}
    type: 'AzureBlobFS'
    typeProperties: {
      azureCloudType: 'AzurePublic'
      servicePrincipalCredentialType: 'SecureString'
      servicePrincipalId: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
      servicePrincipalKey: {
        type: 'SecureString'
        value: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
      }
      tenant: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
      url: bicepstorage.properties.primaryEndpoints.dfs
    }
  }
}

额外注意事项 #

• 确保服务主体已被授予ADLS Gen2存储账户的对应权限（如Storage Blob Data Contributor），否则即使链接服务部署成功，也无法正常访问数据。
• 若仍遇到IR相关错误，可先单独部署ADF资源，等待5-10分钟让AutoResolveIntegrationRuntime完全初始化后，再部署链接服务。

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