

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Athena JDBC 2.x 驅動程式
<a name="jdbc-v2"></a>

您可以使用 JDBC 連接來將 Athena 連接到商業智慧工具和其他應用程式，例如 [SQL Workbench](http://www.sql-workbench.eu/downloads.html)。若要這樣做，請使用此頁面上的 Amazon S3 連結，以下載、安裝和設定 Athena JDBC 2.x 驅動程式。有關建置 JDBC 連接 URL 的資訊，請參閱可下載的[JDBC 驅動程式安裝和組態指南](https://downloads.athena.us-east-1.amazonaws.com/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 版開始，提供兩種版本的驅動程式：一種包含 AWS SDK，另一種則不包含。

**重要**  
當您使用 JDBC 驅動程式時，務必注意以下要求：  
**打開連接埠 444** – 將 Athena 用來串流查詢結果的連接埠 444 保持開放給輸出流量。當您使用 PrivateLink 端點連接到 Athena 時，請確定連接至 PrivateLink 端點的安全群組已在連接埠 444 上開放給輸入流量。如果連接埠 444 遭到封鎖，您可能會收到錯誤訊息 [Simba][AthenaJDBC](100123) An error has occurred. ([Simba][AthenaJDBC](100123) 發生錯誤。) 資料欄初始化期間發生例外狀況。
**athena:GetQueryResultsStream 政策** – 新增針對使用 JDBC 驅動程式的 IAM 主體的 `athena:GetQueryResultsStream` 政策動作。此政策動作不會直接透過 API 公開。它僅與 ODBC 和 JDBC 驅動程式搭配使用，做為串流結果支援的一部分。如需政策範例，請參閱 [AWS 受管政策：AWSQuicksightAthenaAccess](security-iam-awsmanpol.md#awsquicksightathenaaccess-managed-policy)。
**使用用於多個資料目錄的 JDBC 驅動程式** – 若要將用於多個資料目錄的 JDBC 驅動程式與 Athena 搭配使用 (例如，在使用[外部 Hive 中繼存放區](connect-to-data-source-hive.md)或[聯合查詢](federated-queries.md)時)，在您的 JDBC 連線字串中包含 `MetadataRetrievalMethod=ProxyAPI`。
**4.1 驅動程式** – 從 2023 年起，將停止對 JDBC 4.1 版提供驅動程式支援。將不再發布進一步更新。如果您仍在使用 JDBC 4.1 驅動程式，強烈建議您改用 4.2 驅動程式。

## 搭配 AWS SDK 的 JDBC 2.x 驅動程式
<a name="download-the-jdbc-driver"></a>

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.jarAthenaJDBC](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/AthenaJDBC42-2.2.2.1000.jar)

下列`.zip`檔案下載包含 JDBC 4.2 `.jar` 的檔案，並包含 AWS SDK 和隨附的文件、版本備註、授權和協議。
+ [SimbaAthenaJDBC-2.2.2.1000.zipSimbaAthenaJDBC](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/SimbaAthenaJDBC-2.2.2.1000.zip)

## 不含 AWS SDK 的 JDBC 2.x 驅動程式
<a name="download-the-jdbc-driver-no-sdk"></a>

JDBC 驅動程式 2.2.2 版符合 JDBC API 4.2 資料標準，且需要 JDK 8.0 或更新版本。如需檢查您使用之 Java 執行階段環境 (JRE) 版本的相關資訊，請參閱 Java [文件](https://www.java.com/en/download/help/version_manual.html)。

使用以下連結下載不含 AWS SDK 的 JDBC 4.2 驅動程式`.jar`檔案。
+ [AthenaJDBC42-2.2.2.1001.jarAthenaJDBC](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1001/AthenaJDBC42-2.2.2.1001.jar)

以下 `.zip` 檔案下載包含 JDBC 4.2 `.jar` 檔案及隨附的文件、版本備註、授權和協議。它不包含 AWS SDK。
+ [SimbaAthenaJDBC-2.2.2.1001.zipSimbaAthenaJDBC](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1001/SimbaAthenaJDBC-2.2.2.1001.zip)

## JDBC 2.x 驅動程式版本備註、授權合約和聲明
<a name="atelong-jdbc-driver-license-agreement"></a>

下載您需要的版本後，請閱讀版本備註，並檢閱授權合約和聲明。
+ [版本備註](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/release-notes.txt)
+ [授權合約](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/LICENSE.txt)
+ [通知](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/NOTICES.txt)
+ [第三方授權](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/third-party-licenses.txt)

## JDBC 2.x 驅動程式文件
<a name="jdbc-v2-documentation"></a>

下載驅動程式的下列文件：
+ [JDBC 驅動程式安裝和組態指南](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/Simba+Amazon+Athena+JDBC+Connector+Install+and+Configuration+Guide.pdf) 。使用此指南來安裝和設定驅動程式。
+ [JDBC 驅動程式遷移指南](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.2.2.1000/docs/Simba+Amazon+Athena+JDBC+Connector+Migration+Guide.pdf) 。使用此指南從舊版遷移到目前的版本。