Athena JDBC 2.x 驱动程序
您可以使用 JDBC 连接将 Athena 连接到商业智能工具和其他应用程序，例如 。要执行此操作，请使用此页面上的 Amazon S3 链接下载、安装和配置 Athena JDBC 2.x 驱动程序。有关构建 JDBC 连接 URL 的信息，请参阅可下载的JDBC 驱动程序安装和配置指南
重要
使用 JDBC 驱动程序时，请务必注意以下要求：
-
保留端口 444 — 保留 Athena 用于流式传输查询结果的端口 444，对出站流量开放。当您使用 PrivateLink 终端节点连接到 Athena 时，请确保附加到 PrivateLink 终端节点的安全组在端口 444 上对入站流量开放。如果端口 444 被阻止，您可能会收到错误消息
[Simba][AthenaJDBC](100123) An error has occurred. Exception during column initialization（[Simba][AthenaJDBC](100123) 出现错误。列初始化期间出现异常）。 -
athena:GetQueryResultsStream 策略 — 将
athena:GetQueryResultsStream策略操作添加到使用 JDBC 驱动程序的 IAM 主体。此策略操作并不通过 API 直接公开。它仅作为流式传输结果的一部分与 ODBC 和 JDBC 驱动程序配合使用。有关策略示例，请参阅Amazon 托管策略：AWSQuicksightAthenaAccess。 -
将 JDBC 驱动程序用于多个数据目录 – 若要将 JDBC 驱动程序用于 Athena 的多个数据目录（例如，当使用外部 Hive 元存储或者联合查询时），请将
MetadataRetrievalMethod=ProxyAPI包含在 JDBC 连接字符串中。 -
在中国区域指定端点 – 在中国区域将 Athena 与 JDBC 结合使用时，请使用
EndpointOverride=和端点格式athena.，以在 JDBC URL 中指定您的区域端点。aws-region.amazonaws.com.cn以下示例指定了中国（北京）区域的终端节点。
jdbc:awsathena://EndpointOverride=athena.cn-north-1.amazonaws.com.cn:443;AwsRegion=cn-north-1; -
4.1 驱动程序 – 从 2023 年开始，将停止对 JDBC 版本 4.1 的驱动程序支持。不会发布进一步的更新。如果您使用的是 JDBC 4.1 驱动程序，我们强烈建议您迁移到 4.2 驱动程序。
带有 Amazon SDK 的 JDBC 2.x 驱动程序
JDBC 驱动程序版本 2.1.5 符合 JDBC API 4.2 数据标准，且要求 JDK 8.0 或更高版本。有关检查您使用的 Java 运行时环境 (JRE) 版本的信息，请参阅 Java 文档
使用以下链接下载 JDBC 4.2 驱动程序 .jar 文件。
以下 .zip 文件下载包含适用于 JDBC 4.2 的 .jar 文件以及 Amazon 开发工具包和随附文档、发布说明、许可和协议。
不带 Amazon SDK 的 JDBC 2.x 驱动程序
JDBC 驱动程序版本 2.1.5 符合 JDBC API 4.2 数据标准，且要求 JDK 8.0 或更高版本。有关检查您使用的 Java 运行时环境 (JRE) 版本的信息，请参阅 Java 文档
使用以下链接下载不包含 Amazon 开发工具包的 JDBC 4.2 驱动程序 .jar 文件。
以下 .zip 文件下载包含适用于 JDBC 4.2 的 .jar 文件以及随附文档、发布说明、许可和协议。不包括 Amazon SDK。
JDBC 2.x 驱动程序发布说明、许可协议和版权声明
下载所需要的版本后，请阅读发布说明，查看许可协议和版权声明。
JDBC 2.x 驱动程序文档
下载驱动程序的以下文档：
-
JDBC 驱动程序安装和配置指南
。使用该指南安装和配置此驱动程序。 -
JDBC 驱动程序迁移指南
。使用该指南从早期版本迁移到最新版本。