无法更新ADF中Databricks链接服务的MI凭据问题求助

可能原因 #

• 实时模式元数据缓存：ADF实时模式下，门户端会缓存链接服务的配置信息，即使界面上修改了凭据，缓存未同步会导致刷新后显示旧数据。
• 链接服务关联依赖：该Databricks链接服务可能被其他运行或锁定状态的资源（如数据流、管道）引用，强制覆盖了你的修改操作。
• ARM模板残留配置：若之前通过ARM模板部署过该链接服务，模板中硬编码的旧MI配置会在发布时自动覆盖界面修改内容。
• MI权限冲突：新MI没有足够权限访问Databricks工作区或ADF资源，系统会自动回退到旧的有效凭据配置。

解决办法 #

1. 清除缓存并强制刷新 #

• 清空浏览器缓存，关闭ADF门户页面后重新打开，使用Ctrl+Shift+R强制刷新页面，再尝试修改并保存凭据。
• 若使用ADF Studio，退出当前工作区后重新登录，避免会话级缓存影响。

2. 使用REST API直接更新链接服务 #

绕过门户缓存，通过ADF REST API直接修改配置：

1. 调用GET接口获取当前链接服务配置：

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/linkedservices/{linkedServiceName}?api-version=2018-06-01

2. 修改返回JSON中properties.typeProperties.servicePrincipalId为新MI的对象ID，再调用PUT接口提交更新：

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/linkedservices/{linkedServiceName}?api-version=2018-06-01
Content-Type: application/json

{
  "properties": {
    "type": "AzureDatabricks",
    "typeProperties": {
      "domain": "{databricksWorkspaceUrl}",
      "authentication": "MSI",
      "servicePrincipalId": "{newMIObjectId}",
      "resourceId": "/subscriptions/{subscriptionId}/resourceGroups/{rgName}/providers/Microsoft.Databricks/workspaces/{workspaceName}"
    },
    "connectVia": {
      "referenceName": "AutoResolveIntegrationRuntime",
      "type": "IntegrationRuntimeReference"
    }
  }
}

3. 检查并移除关联依赖锁定 #

• 进入ADF门户，查看该链接服务的「依赖项」，停止所有正在运行的关联数据流或管道。
• 若有资源设置了只读等锁定，先解除锁定再修改凭据配置。

4. 同步ARM模板配置 #

• 进入ADF的「ARM模板」页面，导出当前模板，检查linkedServices节点下对应链接服务的配置，将旧MI的servicePrincipalId替换为新MI的ID。
• 重新部署修改后的ARM模板，确保发布后的配置与预期一致。

5. 验证新MI的权限 #

• 确认新MI已加入Databricks工作区的管理员或用户组，拥有「允许访问Databricks工作区」的权限。
• 检查新MI在ADF资源组中的角色权限，至少拥有Data Factory Contributor或自定义的对应权限，确保能正常更新链接服务配置。

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