Synapse查询报错：Resolving CosmosDB path失败（账户或区域错误）求助

以下是在确认账户名、区域、只读密钥未变更后的排查点：

• Cosmos DB 区域端点异常：即使区域名称未变，也可能出现该区域的Cosmos DB连接端点临时故障，或微软调整了区域域名后缀。建议直接使用Cosmos DB门户中复制的完整连接字符串替换OPENROWSET内的参数，而非手动拆分填写account/region/key。
• Synapse 网络访问限制：
  • 若Synapse工作区启用了VNet集成，检查Cosmos DB防火墙是否允许Synapse的VNet或出站IP访问；可临时将Cosmos DB设置为"允许所有网络"测试是否是网络拦截问题。
  • 若使用专用终结点连接Cosmos DB，确认专用终结点状态正常，且关联的专用DNS区域已正确配置DNS记录，避免解析失败。
• OPENROWSET 参数格式问题：
  • 核对region参数的拼写是否与Cosmos DB门户显示完全一致（比如是否是North Central US而非NorthCentralUS，空格、大小写都可能影响识别）。
  • 检查只读密钥是否包含特殊字符（如+、/），在SQL字符串中是否未正确转义；可尝试将密钥用双引号包裹，或删除参数中多余的空格。
• Cosmos DB 权限配置变更：
  • 确认只读密钥对应的权限未被修改（比如是否被意外移除了容器的读取权限）；若账户启用了RBAC权限，需检查是否RBAC规则覆盖了密钥的访问权限，导致只读密钥失效。
• Synapse 连接缓存问题：
  • 若使用专用SQL池，可尝试重启池以清除旧的连接缓存；若通过链接服务配置连接，重新创建链接服务或刷新配置。
• 容器名称校验：
  • 确认ContainerObject与Cosmos DB中的容器名称完全一致，Cosmos DB容器名称区分大小写，需排查拼写、大小写错误。

你的查询代码： #

SELECT
    -- queried fields here
FROM OPENROWSET (
    'CosmosDB', N'account=ACCOUNT;database=DATABASE;region=North Central US;key=PrimaryReadOnlyKey',ContainerObject
) AS LWDocs2

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