使用Apache Drill查询Oracle表时出现列数不匹配验证错误

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

1. 元数据加载失败（核心触发点） #

Drill执行查询前会从Oracle拉取表的列元数据，若元数据读取失败，就会出现Expected columns: []的错误，同时DESCRIBE返回空。常见场景：

• 表包含156列的大量列：部分Drill版本在处理超大量列的表时，元数据解析逻辑存在限制或bug，导致无法完整读取列信息；
• 存在Drill不兼容的Oracle特定数据类型：比如TIMESTAMP WITH TIME ZONE、INTERVAL、自定义类型等，Drill无法解析这些类型，直接中断元数据加载流程。

排查/解决：

• 先尝试查询表的部分列而非*，比如执行SELECT col1, col2 FROM <storage_plugin>.<schema>.<table> LIMIT 10，如果能正常运行，说明是全量列元数据加载的问题；
• 检查Oracle表的列类型，替换或转换不兼容的数据类型后重试；或者直接升级Drill到最新稳定版本，新版本通常修复了更多数据类型兼容问题。

2. Drill Oracle存储插件配置异常 #

存储插件的参数设置可能影响元数据读取效率或范围，比如缓存开关、列数限制等。

排查/解决：

• 进入Drill Web UI（默认地址http://<drill-host>:8047），找到Oracle存储插件的配置：
  • 确认enableMetadataCache未被设置为false（禁用缓存会导致每次查询都重新读取元数据，大列数表可能因性能问题读取失败）；
  • 检查是否存在maxColumns之类的限制参数，若有则调整为大于156的值；
• 保存配置后重启Drill，再尝试DESCRIBE和查询操作。

3. Drill所用数据库用户权限不足 #

即使该用户能在SQL Developer中查询表数据，但若缺少读取Oracle系统元数据的权限，Drill无法获取表的列信息。

排查/解决：

• 给Drill使用的Oracle用户授予SELECT_CATALOG_ROLE角色，或直接授予系统视图查询权限：

  GRANT SELECT_CATALOG_ROLE TO <drill_user>;
  

• 授权后重新连接Drill，执行DESCRIBE查看是否能返回列信息。

4. 表结构特殊（分区表、隐藏列等） #

如果目标表是分区表、全局临时表，或者包含隐藏列、虚拟列，Drill的元数据读取逻辑可能无法正确识别。

排查/解决：

• 在Oracle中执行DESC <schema>.<table>确认表结构，通过以下语句检查是否存在隐藏列：

  SELECT column_name FROM ALL_TAB_COLUMNS WHERE table_name = '<TABLE_NAME>' AND hidden_column = 'YES';
  

• 若为分区表，尝试在Drill中指定分区查询，或修改存储插件的partitioned参数为true（若未开启）。

5. Drill与Oracle版本不兼容 #

不同版本的Drill对Oracle的兼容性存在差异，比如旧版Drill（<1.20）对Oracle 19c+的部分特性支持不足。

排查/解决：

• 查阅Drill官方兼容性矩阵，确认当前Drill版本是否支持你使用的Oracle版本；
• 若不兼容，升级Drill到对应兼容版本。

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