Azure Synapse管道调试失败：OPENROWSET查询报2011错误求助

可能的原因及对应解决办法 #

• 管道参数传递错误
  若你的Parquet查询语句中使用了管道参数（如@pipeline().parameters.parquetPath），可能存在参数未定义、赋值为空或参数名拼写错误的情况。CSV语句未使用参数或参数配置正确，因此可以正常执行。
  解决：

  1. 进入管道的"参数"面板，确认所用参数已创建且默认值/运行时赋值不为空；
  2. 核对Script Activity中的SQL语句，确保参数引用的名称（如parquetPath）与定义的参数名完全一致，注意大小写和空格；
  3. 尝试移除所有参数，将Parquet文件路径硬编码到SQL语句中，调试验证是否能正常执行。

• OPENROWSET语法或数据源配置问题
  Parquet格式的OPENROWSET语法要求更严谨，可能存在数据源引用错误或路径格式问题，而CSV语句的语法刚好符合要求。
  解决：

  1. 核对Parquet查询的OPENROWSET语法，确保包含FORMAT = 'PARQUET'，且DATA_SOURCE是master库中已创建的有效外部数据源，示例正确语句：

     SELECT TOP 100 *
     FROM OPENROWSET(
         BULK 'https://yourstorage.dfs.core.windows.net/container/folder/*.parquet',
         FORMAT = 'PARQUET',
         DATA_SOURCE = 'YourExternalDataSource'
     ) AS parquet_data
     

  2. 检查Parquet文件路径是否存在特殊字符（如空格、中文），若有需在语句中正确转义，或修改路径避免特殊字符。

• Script Activity配置的隐性错误
  虽然管道验证通过，但可能存在SQL语句中未闭合的变量引用、误将语句内容放入参数区等隐性问题，导致执行时解析出空参数。
  解决：

  1. 打开Script Activity的"Script"标签，检查SQL语句中是否存在{{...}}格式的未定义变量；
  2. 确认所有语句内容都在"Query"输入框中，未误填到其他配置项中。

• 执行上下文权限差异
  管道外执行查询时使用的是你的用户权限，而管道通过链接服务执行时，使用的是链接服务的身份（如MSI、SQL账号），可能该身份对Parquet文件所在存储账户的访问权限不足（CSV文件所在路径权限正常）。
  解决：

  1. 检查链接服务使用的身份（如MSI）是否被授予存储账户的Blob Data Reader权限；
  2. 验证该身份能否访问Parquet文件的存储路径，可通过在master库中执行相同语句，切换到链接服务身份测试。

额外排查步骤 #

• 查看管道运行的详细日志，找到报错信息中{0}对应的具体参数名，精准定位空参数；
• 复制Script Activity中的SQL语句，直接在Synapse Studio的无服务器SQL池查询窗口执行，再次确认语句本身无问题。

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