Azure Synapse链接服务无法预览表数据及COPY语句报错求助

针对你遇到的COPY语句无法打开ADLS Gen2上Parquet文件的问题，结合“另一个环境相同配置正常”的前提，从以下几个维度逐一排查：

1. 存储账户网络访问配置排查 #

• 检查存储账户的防火墙与虚拟网络设置：确认当前Synapse工作区的IP地址已加入存储账户的允许列表，或者存储账户开启了「允许受信任的Microsoft服务访问」选项（该选项常因配置变更被意外关闭）。如果使用自托管集成运行时，需确保运行时所在机器的IP在存储账户的允许范围内。
• 确认存储账户的分层命名空间未被禁用：报错路径是dfs.core.windows.net，要求存储账户必须启用分层命名空间，若当前环境该配置被修改，会直接导致文件无法访问。

2. 托管标识权限精确校验 #

• 检查托管标识的权限分配：确保Synapse链接服务使用的托管标识，被直接分配了存储账户的Blob数据贡献者（或更高权限），且权限范围覆盖目标Parquet文件所在的容器/文件夹。避免依赖继承权限，因继承可能因角色分配范围变更失效。
• 用门户的「访问控制(IAM)」→「检查访问权限」功能，输入托管标识名称，验证它对目标文件路径的读取权限是否有效。
• 确认链接服务中指定的托管标识未被修改：是否误切换为其他认证方式（如账户密钥），或托管标识本身被替换。

3. 文件本身与路径校验 #

• 验证Parquet文件完整性：用Azure Storage Explorer打开目标文件，确认文件未损坏。若损坏，替换为正常文件后重试。
• 检查路径大小写一致性：ADLS Gen2路径区分大小写，确认Lookup活动查询中引用的路径（存储账户名、文件夹、文件名）与实际路径完全一致，避免因大小写拼写错误导致无法找到文件。

4. 链接服务与集成运行时配置 #

• 确认链接服务认证方式：确保链接服务使用「托管标识」认证，未被改为其他方式。若使用自托管集成运行时，检查运行时状态是否正常，是否因版本更新导致配置失效。
• 手动执行COPY语句验证：在Synapse池的SQL编辑器中执行以下语句，排查是否为池到存储的访问问题：

COPY INTO [临时测试表]
FROM 'https://my-storage-account.dfs.core.windows.net/a-folder/a-parquet-file.snappy.parquet'
WITH (
    FILE_TYPE = 'PARQUET',
    CREDENTIAL = (IDENTITY = 'Managed Identity')
);

若手动执行报错，问题聚焦在池与存储的访问链路；若执行成功，需排查Lookup活动的配置细节（如查询语句、集成运行时关联）。

5. 环境差异深层对比 #

• 逐行对比两个环境的存储账户配置：包括防火墙规则、VNet关联、分层命名空间状态、软删除设置等，找出细微差异。
• 确认Synapse池的权限：托管标识需具备Synapse池的数据库参与者或更高权限，确保能在池中执行查询与COPY操作。

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