如何解决Azure Data Flow调试预览时的“客户端初始化失败”问题？

连通性验证方法 #

1. 验证自定义Azure集成运行时与Cosmos DB的连通性 #

• 登录Azure门户，找到你为Cosmos DB创建的自定义Azure集成运行时，进入测试连通性页面。
• 输入Cosmos DB端点（格式如your-account-name.documents.azure.com）和端口443，执行测试，查看是否能成功建立连接。

2. 验证AutoResolveIntegrationRuntime的连通性 #

数据预览默认使用AutoResolve IR执行，即便Sink配置了自定义IR，也需确认它能访问Cosmos DB：

• 打开Azure Cloud Shell，执行PowerShell命令测试：

  Test-NetConnection your-account-name.documents.azure.com -Port 443
  

• 或用Bash命令：

  nc -zv your-account-name.documents.azure.com 443
  

  Cloud Shell的网络环境与AutoResolve IR一致，测试结果可直接反映AutoResolve的连通情况。

问题解决方案 #

1. 检查Cosmos DB防火墙规则 #

• 进入Cosmos DB账户的防火墙和虚拟网络设置页：
  • 务必勾选允许从所有Azure服务访问此账户，确保AutoResolve等Azure托管服务能正常访问。
  • 若自定义Azure IR部署在虚拟网络中，需将该虚拟网络添加到Cosmos DB的允许列表，并开启Microsoft.AzureCosmosDB服务端点。

2. 确认数据流调试的集成运行时配置 #

• 打开Azure Data Flow的调试设置，确认使用的集成运行时选择的是你为Cosmos DB配置的自定义Azure IR，而非默认的AutoResolve。数据预览会遵循此配置，确保用能连通的IR执行预览操作。

3. 重新验证Cosmos DB链接服务权限 #

• 确认链接服务使用的是主密钥（而非只读密钥），因为Sink写入操作需要完整权限。
• 重新生成Cosmos DB主密钥，更新链接服务中的密钥配置，保存后再次测试数据预览。

4. 排查网络路由与DNS解析 #

• 若自定义Azure IR在虚拟网络中，确认虚拟网络的DNS服务器能正确解析Cosmos DB端点，避免因DNS解析失败导致连接问题。
• 若使用VNet peering，检查peering配置是否正确，确保网络流量能正常路由到Cosmos DB。

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