Athena JDBC 2.x 驅動程式

您可以使用 JDBC 連接來將 Athena 連接到商業智慧工具和其他應用程式，例如 SQL Workbench。若要這樣做，請使用此頁面上的 Amazon S3 連結，以下載、安裝和設定 Athena JDBC 2.x 驅動程式。有關建置 JDBC 連接 URL 的資訊，請參閱可下載的JDBC 驅動程式安裝和組態指南。如需許可的相關資訊，請參閱通過JDBC和ODBC連接控制訪問。要提交有關 JDBC 驅動程式的意見回饋，請傳送電子郵件至 [e-mail]。從 2.0.24 版開始，有兩個版本的驅動程式可供使用：一個包含 AWS SDK，另一個則沒有。

重要

當您使用 JDBC 驅動程式時，務必注意以下要求：

• 打開連接埠 444 – 將 Athena 用來串流查詢結果的連接埠 444 保持開放給輸出流量。當您使用 PrivateLink 端點連線至 Athena 時，請確定連接到 PrivateLink 端點的安全群組對連接埠 444 的輸入流量開放。如果連接埠 444 遭到封鎖，您可能會收到錯誤訊息 [Simba][AthenaJDBC](100123) An error has occurred. ([Simba][AthenaJDBC](100123) 發生錯誤。) 資料欄初始化期間發生例外狀況。

• 雅典娜/ GetQueryResultsStream 政策 — 將athena:GetQueryResultsStream政策動作新增至使用 JDBC 驅動程式的 IAM 主體。此政策動作不會直接透過 API 公開。它僅與 ODBC 和 JDBC 驅動程式搭配使用，做為串流結果支援的一部分。如需政策範例，請參閱 AWS 受管理的策略： AWSQuicksightAthenaAccess。

• 使用用於多個資料目錄的 JDBC 驅動程式 – 若要將用於多個資料目錄的 JDBC 驅動程式與 Athena 搭配使用 (例如，在使用外部 Hive 中繼存放區或聯合查詢時)，在您的 JDBC 連線字串中包含 MetadataRetrievalMethod=ProxyAPI。

• 4.1 驅動程式 – 從 2023 年起，將停止對 JDBC 4.1 版提供驅動程式支援。將不再發布進一步更新。如果您仍在使用 JDBC 4.1 驅動程式，強烈建議您改用 4.2 驅動程式。

使用 SDK 的 JDBC 2.x 驅動程式 AWS

JDBC 驅動程式 2.1.5 版本符合 JDBC API 4.2 資料標準，且需要 JDK 8.0 或更新版本。如需檢查您使用之 Java 執行階段環境 (JRE) 版本的相關資訊，請參閱 Java 文件。

使用下列連結來下載 JDBC 4.2 驅動程式 .jar 檔案。

• https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.1.5.1000/AthenaJDBC42-2.1.5.1000.jar

下列.zip檔案下載包含 JDBC 4.2 的.jar檔案，並包含 AWS SDK 和隨附的文件、版本說明、授權和合約。

• SimbaAthena

不含 AWS SDK 的 JDBC 2.x 驅動程式

JDBC 驅動程式 2.1.5 版本符合 JDBC API 4.2 資料標準，且需要 JDK 8.0 或更新版本。如需檢查您使用之 Java 執行階段環境 (JRE) 版本的相關資訊，請參閱 Java 文件。

使用以下鏈接下載不使用 AWS SDK 的 JDBC 4.2 驅動程序.jar文件。

• https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/SimbaAthenaJDBC-2.1.5.1001/AthenaJDBC42-2.1.5.1001.jar

以下 .zip 檔案下載包含 JDBC 4.2 .jar 檔案及隨附的文件、版本備註、授權和協議。它不包括 AWS SDK。

• SimbaAthena

JDBC 2.x 驅動程式版本備註、授權合約和聲明

下載您需要的版本後，請閱讀版本備註，並檢閱授權合約和聲明。

• 版本備註

• 授權合約

• 通知

• 第三方授權

JDBC 2.x 驅動程式文件

下載驅動程式的下列文件：

• JDBC 驅動程式安裝和組態指南 。使用此指南來安裝和設定驅動程式。

• JDBC 驅動程式遷移指南 。使用此指南從舊版遷移到目前的版本。