# Athena JDBC 3.x 驱动程序
<a name="jdbc-v3-driver"></a>

您可以使用 Athena JDBC 驱动程序从许多第三方 SQL 客户端工具和自定义应用程序连接到 Amazon Athena。

## 系统要求
<a name="jdbc-v3-driver-system-requirements"></a>
+ Java 8（或更高版本）的运行时系统环境
+ 至少 20MB 可用磁盘空间

## 注意事项和限制
<a name="jdbc-v3-driver-considerations-and-limitations"></a>

以下是 Athena JDBC 3.x 驱动程序的一些注意事项和限制。
+ **日志记录** – 3.x 驱动程序使用 [SLF4J](https://www.slf4j.org/manual.html)，这是一个抽象层，支持在运行时系统中使用多种日志记录系统中的任一系统。
+ **加密** – 当使用具有 `CSE_KMS` 加密选项的 Amazon S3 提取器时，Amazon S3 客户端无法解密在 Amazon S3 存储桶中存储的结果。如果您需要 `CSE_KMS` 加密，则可以继续使用流式传输提取器。计划支持将 `CSE_KMS` 加密用于 Amazon S3 提取器。

## JDBC 3.x 驱动程序下载
<a name="jdbc-v3-driver-download"></a>

本节包含 JDBC 3.x 驱动程序的下载和许可证信息。

**重要**  
使用 JDBC 3.x 驱动程序时，请务必注意以下要求：  
**保留端口 444** — 保留 Athena 用于流式传输查询结果的端口 444，对出站流量开放。当您使用 PrivateLink 终端节点连接到 Athena 时，请确保附加到 PrivateLink 终端节点的安全组在端口 444 上对入站流量开放。
**athena:GetQueryResultsStream 策略** — 将 `athena:GetQueryResultsStream` 策略操作添加到使用 JDBC 驱动程序的 IAM 主体。此策略操作并不通过 API 直接公开。它仅作为流式传输结果的一部分与 ODBC 和 JDBC 驱动程序配合使用。有关策略示例，请参阅 [Amazon 托管策略：AWSQuicksightAthenaAccess](security-iam-awsmanpol.md#awsquicksightathenaaccess-managed-policy)。

要下载 Amazon Athena 3.x JDBC 驱动程序，请访问以下链接。

### JDBC 驱动程序 uber jar
<a name="jdbc-v3-driver-download-uber-jar"></a>

以下下载内容将驱动程序及其所有依赖项打包到同一个 `.jar` 文件中。此下载通常用于第三方 SQL 客户端。

[3.7.0 uber jar](https://s3.cn-north-1.amazonaws.com.cn/athena-downloads-cn/drivers/JDBC/3.7.0/athena-jdbc-3.7.0-with-dependencies.jar)

### JDBC 驱动程序 lean jar
<a name="jdbc-v3-driver-download-lean-jar"></a>

以下下载内容是一个 `.zip` 文件，其中包含驱动程序的 lean `.jar` 文件和驱动程序依赖项的单独 `.jar` 文件。此下载通常用于依赖项可能与驱动程序所使用的依赖项冲突的自定义应用程序。如果您想选择要在 lean jar 中包含哪些驱动程序依赖项，以及在自定义应用程序已经包含一个或多个驱动程序依赖项时应排除哪些驱动程序依赖项，则此下载非常有用。

[3.7.0 lean jar](https://s3.cn-north-1.amazonaws.com.cn/athena-downloads-cn/drivers/JDBC/3.7.0/athena-jdbc-3.7.0-lean-jar-and-separate-dependencies-jars.zip)

### 许可证
<a name="jdbc-v3-driver-license"></a>

以下链接包含 JDBC 3.x 驱动程序的许可协议。

[许可证](https://s3.cn-north-1.amazonaws.com.cn/athena-downloads-cn/drivers/JDBC/3.7.0/LICENSE.txt)

## 将可信身份传播与 JDBC 结合使用
<a name="jdbc-v3-driver-trusted-identity"></a>

现在，您可以通过 Amazon Identity and Access Management Identity Center 的单点登录功能连接到使用 JDBC 驱动程序的 Amazon Athena。通过 PowerBI、Tableau 或 DBeaver 等工具访问 Athena 时，您的身份和权限会自动通过 IAM Identity Center 传播到 Athena。有关更多信息，请参阅 [将可信身份传播与 Amazon Athena 驱动程序结合使用](using-trusted-identity-propagation.md)。

**Topics**
+ [系统要求](#jdbc-v3-driver-system-requirements)
+ [注意事项和限制](#jdbc-v3-driver-considerations-and-limitations)
+ [JDBC 3.x 驱动程序下载](#jdbc-v3-driver-download)
+ [将可信身份传播与 JDBC 结合使用](#jdbc-v3-driver-trusted-identity)
+ [开始使用 JDBC 3.x 驱动程序](jdbc-v3-driver-getting-started.md)
+ [Amazon Athena JDBC 3.x 连接参数](jdbc-v3-driver-connection-parameters.md)
+ [其他 JDBC 3.x 配置](jdbc-v3-driver-other-configuration.md)
+ [Amazon Athena JDBC 3.x 发布说明](jdbc-v3-driver-release-notes.md)
+ [Athena JDBC 3.x 驱动程序的早期版本](jdbc-v3-driver-previous-versions.md)