Azure Synapse执行CREATE EXTERNAL TABLE AS SELECT导出至Blob存储失败

问题场景 #

执行以下SQL语句尝试将查询结果导出到Azure Blob Storage：

CREATE EXTERNAL DATA SOURCE MyDataSource WITH (
LOCATION='wasb://rpdm10-azuredw-upload@rpdm.blob.core.windows.net/', 
CREDENTIAL=MyCredential
)

CREATE EXTERNAL FILE FORMAT MyFormat WITH (
    FORMAT_TYPE=DELIMITEDTEXT, 
    FORMAT_OPTIONS (STRING_DELIMITER='"', FIELD_TERMINATOR=',', ENCODING='UTF8'),
    DATA_COMPRESSION='org.apache.hadoop.io.compress.GzipCodec'
)

CREATE EXTERNAL TABLE MyTable WITH (
   LOCATION='/tmp',
   DATA_SOURCE = MyDataSource,
   FILE_FORMAT = MyFormat
) AS SELECT * FROM mytable

执行后触发报错：

Msg 105005, Level 16, State 1, Line 49
CREATE EXTERNAL TABLE AS SELECT statement failed as the path name 'wasb://rpdm10-azuredw-upload@rpdm.blob.core.windows.net/tmp' could not be used for export. Please ensure that the specified path is a directory which exists or can be created, and that files can be created in that directory.

已完成以下验证：

• 凭据正确（错误凭据会触发其他类型报错）
• 存储账户为本地冗余存储（LRS）、通用用途v1类型
• 容器rpdm10-azuredw-upload已存在
• 容器内已创建代表伪文件夹的tmp/ blob
• 更换任意LOCATION路径均触发相同报错

排查与解决方案建议 #

1. 检查存储账户防火墙设置 #

确认Azure Synapse工作区的IP地址已加入Blob存储账户的防火墙允许列表，或临时将存储账户设置为允许所有网络访问进行测试。网络限制会导致Synapse无法写入目标路径，即使容器已存在。

2. 验证凭据权限 #

确保MyCredential对应的SAS令牌或服务主体具备容器级别的Write和Delete权限：

• SAS令牌需包含sp=rwdl权限（读取、写入、删除、列出）
• 服务主体需被分配Storage Blob Data Contributor角色至目标容器或存储账户

3. 修正LOCATION路径格式 #

尝试去掉LOCATION开头的斜杠，改为LOCATION='tmp'。WASB路径中，容器后直接跟文件夹名即可，前置斜杠可能导致路径解析异常。修改后的外部表创建语句：

CREATE EXTERNAL TABLE MyTable WITH (
   LOCATION='tmp',
   DATA_SOURCE = MyDataSource,
   FILE_FORMAT = MyFormat
) AS SELECT * FROM mytable

4. 检查存储账户软删除或锁定设置 #

若存储账户或容器开启了软删除且处于保护期，或存在资源锁定，会导致无法创建/写入文件。可临时关闭软删除（仅测试用）或移除锁定后重试。

5. 切换至ADLS Gen2路径格式（推荐） #

若存储账户支持ADLS Gen2，建议使用abfss://协议替代wasb://，兼容性更优：

CREATE EXTERNAL DATA SOURCE MyDataSource WITH (
LOCATION='abfss://rpdm10-azuredw-upload@rpdm.dfs.core.windows.net/', 
CREDENTIAL=MyCredential
)

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