Tableau与ADLS2连接问题：无法通过Browse方式访问.parquet文件

问题概述 #

• 连接Azure Data Lake Storage Gen2（ADLS2）时，「ADLS Gen2 > File URL」方式可正常建立连接，但「ADLS Gen2 > Browse」方式触发报错：

  "Azure Data Lake Storage Gen2 was unable to process this request. Please report this problem to Tableau."

• 需读取ADLS2中的.parquet文件，但该扩展名不在File URL连接支持的默认列表内；已确认权限有效（File URL连接正常），官方暂未提供有效排查方案。

可行解决方案 #

1. 校验ADLS2存储账户核心配置 #

• 确认存储账户已启用层级命名空间：Browse模式依赖该特性实现目录遍历，而File URL方式不强制要求此配置
• 验证连接身份的权限：确保用于连接的服务主体/托管标识拥有Storage Blob Data Contributor角色（而非普通Contributor角色），该权限是Browse模式遍历目录的必要条件

2. 扩展Tableau的文件扩展名支持 #

• 找到Tableau安装目录下的extensions.conf文件：
  • Windows路径：C:\Program Files\Tableau\Tableau [版本号]\bin
  • Mac路径：/Applications/Tableau Desktop [版本号].app/Contents/bin
• 在文件末尾添加配置：parquet=Parquet Files，保存后重启Tableau，即可通过File URL方式直接输入.parquet文件的完整路径进行读取

3. 排查API兼容性与网络限制 #

• 升级Tableau到最新稳定版本：部分旧版本存在ADLS2 Browse模式的API调用bug，新版本已修复此类问题
• 检查存储账户防火墙设置：确保Tableau所在服务器/客户端的IP地址已被加入ADLS2的允许访问列表（Browse模式涉及的API端点与File URL可能存在差异）

4. 切换至Blob存储兼容连接方式 #

• 选择「Azure Blob Storage」连接类型，输入存储账户名、访问密钥（或SAS令牌），即可正常浏览并读取容器内的.parquet文件，该方式对Parquet格式的支持更稳定

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