使用AthenaJDBC执行SELECT查询时遇(100071)日期类型不支持报错

问题场景 #

执行普通SELECT查询（非EXPLAIN语句）时，AthenaJDBC抛出如下错误：

[Simba][AthenaJDBC](100071) An error has been thrown from the AWS Athena client. NOT_SUPPORTED: Unsupported data type in EXPLAIN (TYPE IO): date

但相同查询在Athena控制台可正常运行。

解决方案 #

• 升级Simba Athena JDBC驱动
  旧版本驱动存在date类型的EXPLAIN解析兼容问题——即便你没主动执行EXPLAIN，驱动内部可能会自动触发EXPLAIN做查询预检查或优化。替换为AWS官方提供的最新版驱动即可解决该类型兼容问题。

• 禁用驱动自动EXPLAIN功能
  部分版本的驱动默认会自动执行EXPLAIN语句，可通过JDBC连接参数关闭该行为：
  在JDBC URL中添加DisableQueryPreview=true，示例：

  jdbc:awsathena://AwsRegion=us-east-1;DisableQueryPreview=true;
  

• 校验表结构与数据类型映射
  若表基于外部数据源（如S3上的Parquet/CSV文件）创建，确认表定义中的date类型与实际存储的数据类型一致，避免驱动解析元数据时出现类型混淆。

内容的提问来源于stack exchange，提问作者Zidane Zine eddine