# Athena JDBC 2.x 驱动程序
您可以使用 JDBC 连接将 Athena 连接到商业智能工具和其他应用程序，例如 。要执行此操作，请使用此页面上的 Amazon S3 链接下载、安装和配置 Athena JDBC 2.x 驱动程序。有关构建 JDBC 连接 URL 的信息，请参阅可下载的[JDBC 驱动程序安装和配置指南](https://s3.cn-north-1.amazonaws.com.cn/athena-downloads-cn/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/Simba+Amazon+Athena+JDBC+Connector+Install+and+Configuration+Guide.pdf)。有关许可的更多信息，请参阅 [控制通过 JDBC 和 ODBC 连接的访问](policy-actions.md)。要提交有关 JDBC 驱动程序的反馈，请发送电子邮件至 [athena-feedback@amazon.com](mailto:athena-feedback@amazon.com)。从版本 2.0.24 开始，有两个版本的驱动程序可用：一个包括 Amazon SDK，一个不包括。
**重要**
使用 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](security-iam-awsmanpol.md#awsquicksightathenaaccess-managed-policy)。
**将 JDBC 驱动程序用于多个数据目录** – 若要将 JDBC 驱动程序用于 Athena 的多个数据目录（例如，当使用[外部 Hive 元存储](connect-to-data-source-hive.md)或者[联合查询](federated-queries.md)时），请将 `MetadataRetrievalMethod=ProxyAPI` 包含在 JDBC 连接字符串中。
**在中国区域指定端点** – 在中国区域将 Athena 与 JDBC 结合使用时，请使用 `EndpointOverride=` 和端点格式 `athena.aws-region.amazonaws.com.cn`，以在 JDBC URL 中指定您的区域端点。
以下示例指定了中国（北京）区域的终端节点。
```
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.2.2 符合 JDBC API 4.2 数据标准，且要求 JDK 8.0 或更高版本。有关检查您使用的 Java 运行时环境 (JRE) 版本的信息，请参阅 Java [文档](https://www.java.com/en/download/help/version_manual.html)。
使用以下链接下载 JDBC 4.2 驱动程序 `.jar` 文件。
+ [AthenaJDBC42-2.2.2.1000.jar](https://s3.cn-north-1.amazonaws.com.cn/athena-downloads-cn/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/AthenaJDBC42-2.2.2.1000.jar)
以下 `.zip` 文件下载包含适用于 JDBC 4.2 的 `.jar` 文件以及 Amazon 开发工具包和随附文档、发布说明、许可和协议。
+ [SimbaAthenaJDBC-2.2.2.1000.zip](https://s3.cn-north-1.amazonaws.com.cn/athena-downloads-cn/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/SimbaAthenaJDBC-2.2.2.1000.zip)
## 不带 Amazon SDK 的 JDBC 2.x 驱动程序
JDBC 驱动程序 2.2.2 符合 JDBC API 4.2 数据标准，且要求 JDK 8.0 或更高版本。有关检查您使用的 Java 运行时环境 (JRE) 版本的信息，请参阅 Java [文档](https://www.java.com/en/download/help/version_manual.html)。
使用以下链接下载不包含 Amazon 开发工具包的 JDBC 4.2 驱动程序 `.jar` 文件。
+ [AthenaJDBC42-2.2.2.1001.jar](https://s3.cn-north-1.amazonaws.com.cn/athena-downloads-cn/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1001/AthenaJDBC42-2.2.2.1001.jar)
以下 `.zip` 文件下载包含适用于 JDBC 4.2 的 `.jar` 文件以及随附文档、发布说明、许可和协议。不包括 Amazon SDK。
+ [SimbaAthenaJDBC-2.2.2.1001.zip](https://s3.cn-north-1.amazonaws.com.cn/athena-downloads-cn/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1001/SimbaAthenaJDBC-2.2.2.1001.zip)
## JDBC 2.x 驱动程序发布说明、许可协议和版权声明
下载所需要的版本后，请阅读发布说明，查看许可协议和版权声明。
+ [发行说明](https://s3.cn-north-1.amazonaws.com.cn/athena-downloads-cn/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/release-notes.txt)
+ [许可协议](https://s3.cn-north-1.amazonaws.com.cn/athena-downloads-cn/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/LICENSE.txt)
+ [通知](https://s3.cn-north-1.amazonaws.com.cn/athena-downloads-cn/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/NOTICES.txt)
+ [第三方许可证](https://s3.cn-north-1.amazonaws.com.cn/athena-downloads-cn/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/third-party-licenses.txt)
## JDBC 2.x 驱动程序文档
下载驱动程序的以下文档：
+ [JDBC 驱动程序安装和配置指南](https://s3.cn-north-1.amazonaws.com.cn/athena-downloads-cn/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/Simba+Amazon+Athena+JDBC+Connector+Install+and+Configuration+Guide.pdf)。使用该指南安装和配置此驱动程序。
+ [JDBC 驱动程序迁移指南](https://s3.cn-north-1.amazonaws.com.cn/athena-downloads-cn/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/Simba+Amazon+Athena+JDBC+Connector+Migration+Guide.pdf)。使用该指南从早期版本迁移到最新版本。