Amazon Athena预编译语句报错[Simba][JDBC](10940)如何修复？

核心错误原因 #

1. 参数占位符被识别为字面量：最初给?加单引号（'?'）会让驱动把它当成普通字符串，而非参数占位符，自然找不到索引1的参数。
2. 驱动兼容性与Athena特性限制：Simba Athena JDBC驱动对PreparedStatement的参数绑定有特殊限制，再加上Athena底层依赖S3存储，INSERT逻辑和传统数据库不同，容易触发索引匹配错误。

修复步骤与正确代码示例 #

1. 编写合规的参数化SQL语句

确保VALUES子句中的?数量与插入列数完全一致，绝对不能给?加单引号，且SQL末尾不要加分号：

// 假设表有20列，对应20个参数占位符
String insertSql = "INSERT INTO your_target_table (col1, col2, col3, ..., col20) VALUES (?, ?, ?, ..., ?)";

2. 正确绑定参数的代码实现

参数索引从1开始，循环设置时注意索引对应关系，同时用try-with-resources自动释放资源：

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.SQLException;
import java.util.List;

public class AthenaInsertDemo {
    public static void main(String[] args) {
        String athenaJdbcUrl = "jdbc:awsathena://athena.<region>.amazonaws.com:443;S3OutputLocation=s3://your-query-results-bucket/;";
        String awsAccessKey = "your-access-key";
        String awsSecretKey = "your-secret-key";
        List<String> dataValues = List.of("val1", "val2", ..., "val20"); // 20个待插入值

        try (Connection conn = DriverManager.getConnection(athenaJdbcUrl, awsAccessKey, awsSecretKey);
             PreparedStatement pstmt = conn.prepareStatement(insertSql)) {

            // 循环绑定参数，索引从1开始
            for (int i = 0; i < dataValues.size(); i++) {
                pstmt.setString(i + 1, dataValues.get(i));
            }

            // 执行插入
            int rowsAffected = pstmt.executeUpdate();
            System.out.println("成功插入 " + rowsAffected + " 行数据");

        } catch (SQLException e) {
            System.err.println("插入失败：" + e.getMessage());
            e.printStackTrace();
        }
    }
}

额外排查要点 #

• 升级驱动版本：旧版Simba Athena JDBC驱动对PreparedStatement支持不完善，建议使用2.0.x及以上版本的驱动。
• 检查表结构与权限：
  • 确保INSERT语句中的列名与表结构完全匹配，VALUES的?数量和列数一致；
  • 确认IAM账号拥有Athena:StartQueryExecution权限，以及目标表对应S3存储位置的S3:PutObject权限。
• 批量插入替代方案：如果需要批量插入，避免使用addBatch()+executeBatch()（部分驱动版本不支持），可以合并多条INSERT语句为一个查询，或者直接将数据写入S3后通过MSCK REPAIR TABLE同步到Athena表。

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