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

# 使用 JDBC 連接到 Amazon Athena
<a name="connect-with-jdbc"></a>

Amazon Athena 提供兩個 JDBC 驅動程式：版本 2.x 和 3.x。Athena JDBC 3.x 驅動器是新一代的驅動器，可提供更好的效能和相容性。JDBC 3.x 驅動器支援直接從 Amazon S3 讀取查詢結果，從而可提升應用程式的效能，其中這些應用程式會耗用大量查詢結果。新的驅動器降低了第三方相依性，因此可以更輕鬆地整合 BI 工具與自訂應用程式。在大多數情況下，您可以使用新的驅動器，無需變更現有組態或只需進行最少的變更。
+ 若要下載 JDBC 3.x 驅動程式，請參閱 [Athena JDBC 3.x 驅動程式](jdbc-v3-driver.md)。
+ 若要下載 JDBC 2.x 驅動程式，請參閱 [Athena JDBC 2.x 驅動程式](jdbc-v2.md)。

**Topics**
+ [Athena JDBC 3.x 驅動程式](jdbc-v3-driver.md)
+ [Athena JDBC 2.x 驅動程式](jdbc-v2.md)

# Athena JDBC 3.x 驅動程式
<a name="jdbc-v3-driver"></a>

您可以從許多第三方 SQL 用戶端工具和自訂應用程式使用 Athena ODBC 驅動程式連接至 Amazon Athena。

## 系統要求
<a name="jdbc-v3-driver-system-requirements"></a>
+ Java 8 (或更高版本) 執行期環境
+ 至少 20 MB 的可用磁碟空間

## 考量和限制
<a name="jdbc-v3-driver-considerations-and-limitations"></a>

以下是 Athena JDBC 3.x 驅動程式的一些考量與限制。
+ **記錄日誌** – 3.x 驅動程式使用 [SLF4J](https://www.slf4j.org/manual.html)，這是可在執行期啟用數個記錄日誌系統其中之一的抽象層。
+ **加密** – 搭配使用 Amazon S3 擷取程式與 `CSE_KMS` 加密選項時，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 政策** – 新增針對使用 JDBC 驅動程式的 IAM 主體的 `athena:GetQueryResultsStream` 政策動作。此政策動作不會直接透過 API 公開。它僅與 ODBC 和 JDBC 驅動程式搭配使用，做為串流結果支援的一部分。如需政策範例，請參閱 [AWS 受管政策：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://downloads.athena.us-east-1.amazonaws.com/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://downloads.athena.us-east-1.amazonaws.com/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://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.7.0/LICENSE.txt)

## 可信身分傳播與 JDBC
<a name="jdbc-v3-driver-trusted-identity"></a>

您現在可以透過 AWS 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)

# JDBC 3.x 驅動器入門
<a name="jdbc-v3-driver-getting-started"></a>

使用本節中的資訊，開始使用 Amazon Athena JDBC 3.x 驅動程式。

**Topics**
+ [安裝說明](#jdbc-v3-driver-installation-instructions)
+ [執行驅動程式](#jdbc-v3-driver-running-the-driver)
+ [設定驅動程式](#jdbc-v3-driver-configuring-the-driver)
+ [從 Athena JDBC v2 驅動程式升級](#jdbc-v3-driver-upgrading-from-the-athena-jdbc-v2-driver-to-v3)

## 安裝說明
<a name="jdbc-v3-driver-installation-instructions"></a>

您可以在自訂應用程式或第三方 SQL 用戶端中，使用 JDBC 3.x 驅動程式。

### 在自訂應用程式中
<a name="jdbc-v3-driver-installation-in-a-custom-application"></a>

下載包含驅動程式 jar 及其相依性的 `.zip` 檔案。每個相依性都有自己的 `.jar` 檔案。在自訂應用程式中新增驅動程式 jar 作為相依性。根據您是否已經從另一個來源新增這些相依性至應用程式中，選擇性地新增驅動程式 jar 的相依性。

### 在第三方 SQL 用戶端中
<a name="jdbc-v3-driver-installation-in-a-third-party-sql-client"></a>

下載驅動程式 uber jar 檔案，並依照該用戶端的指示將其新增至第三方 SQL 用戶端。

## 執行驅動程式
<a name="jdbc-v3-driver-running-the-driver"></a>

若要執行驅動程式，您可以使用自訂應用程式或第三方 SQL 用戶端。

### 在自訂應用程式中
<a name="jdbc-v3-driver-running-in-a-custom-application"></a>

使用 JDBC 介面與程式的 JDBC 驅動程式進行互動。下列程式碼顯示了一個自訂 Java 應用程式範例。

```
public static void main(String args[]) throws SQLException {
    Properties connectionParameters = new Properties();
    connectionParameters.setProperty("Workgroup", "primary");
    connectionParameters.setProperty("Region", "us-east-2");
    connectionParameters.setProperty("Catalog", "AwsDataCatalog");
    connectionParameters.setProperty("Database","sampledatabase");
    connectionParameters.setProperty("OutputLocation","s3://amzn-s3-demo-bucket");
    connectionParameters.setProperty("CredentialsProvider","DefaultChain");
    String url = "jdbc:athena://";
    AthenaDriver driver = new AthenaDriver();
    Connection connection = driver.connect(url, connectionParameters);
    Statement statement = connection.createStatement();
    String query = "SELECT * from sample_table LIMIT 10";
    ResultSet resultSet = statement.executeQuery(query);
    printResults(resultSet); // A custom-defined method for iterating over a
                             // result set and printing its contents
}
```

### 在第三方 SQL 用戶端中
<a name="jdbc-v3-driver-running-in-a-third-party-sql-client"></a>

遵循您所使用之 SQL 用戶端的文件。一般而言，您可以使用 SQL 用戶端的圖形化使用者介面來輸入及提交查詢，而查詢結果會顯示在相同的介面中。

## 設定驅動程式
<a name="jdbc-v3-driver-configuring-the-driver"></a>

您可以使用連線參數來設定 Amazon Athena JDBC 驅動程式。如需支援的連線參數，請參閱 [Amazon Athena JDBC 3.x 連線參數](jdbc-v3-driver-connection-parameters.md)。

### 在自訂應用程式中
<a name="jdbc-v3-driver-configuring-in-a-custom-application"></a>

若要在自訂應用程式中設定 JDBC 驅動程式的連線參數，請執行下列其中一個動作：
+ 將參數名稱及其值新增至 `Properties` 物件。當您呼叫 `Connection#connect` 時，將該物件與 URL 一起傳遞。如需範例，請參閱 [執行驅動程式](#jdbc-v3-driver-running-the-driver) 中的 Java 範例應用程式。
+ 在連線字串 (URL) 中，使用下列格式將參數名稱及其值直接新增至通訊協定字首之後。

  ```
  <parameterName>=<parameterValue>;
  ```

  在每個參數名稱/參數值配對的末尾使用分號，分號後不留空格，如下列範例所示。

  ```
  String url = "jdbc:athena://WorkGroup=primary;Region=us-east-1;...;";AthenaDriver driver = new AthenaDriver();Connection connection = driver.connect(url, null);
  ```
**注意**  
如果在連線字串和 `Properties` 物件中同時指定參數，則連線字串中的值優先。不建議在兩個位置指定相同的參數。
+ 將參數值作為引數新增至 `AthenaDataSource` 的方法，如下列範例所示。

  ```
  AthenaDataSource dataSource = new AthenaDataSource();
      dataSource.setWorkGroup("primary");
      dataSource.setRegion("us-east-2");
      ...
      Connection connection = dataSource.getConnection();
      ...
  ```

### 在第三方 SQL 用戶端中
<a name="jdbc-v3-driver-configuring-in-a-third-party-sql-client"></a>

依照您所使用之 SQL 用戶端的指示進行。通常，用戶端會提供圖形化使用者介面來輸入參數名稱及其值。

## 從 Athena JDBC v2 驅動程式升級
<a name="jdbc-v3-driver-upgrading-from-the-athena-jdbc-v2-driver-to-v3"></a>

大多數 JDBC 第 3 版驅動器連線參數都與 JDBC 驅動器第 2 版 (Simba) 回溯相容。這意味著第 2 版連線字串可以與第 3 版驅動程式重複使用。但是，某些連線參數已更改。此處會有這些變更的相關說明。如有必要，當您升級至 JDBC 驅動器第 3 版時，請更新現有的組態。

### 驅動程式類別
<a name="jdbc-v3-driver-upgrading-driver-class"></a>

有些 BI 工具會要求您從 JDBC 驅動程式 `.jar` 檔案提供驅動程式類別。大多數工具都會自動尋找這個類別。第 3 版驅動程式中完全合格的類別名稱為 `com.amazon.athena.jdbc.AthenaDriver`。在第 2 版驅動程式中，該類別為 `com.simba.athena.jdbc.Driver`。

### 連接字串
<a name="jdbc-v3-driver-upgrading-connection-string"></a>

第 3 版驅動器將 `jdbc:athena://` 用於 JDBC 連線字串 URL 開頭的通訊協定。第 3 版驅動器還支援第 2 版通訊協定 `jdbc:awsathena://`，但第 2 版通訊協定已廢除。為了避免出現未定義的行為，如果第 2 版 (或接受以 `jdbc:awsathena://` 為開頭的連線字串的任何其他驅動器) 已向 [DriverManager](https://docs.oracle.com/javase/8/docs/api/java/sql/DriverManager.html) 類別註冊，則第 3 版不接受以 `jdbc:awsathena://` 為開頭的連線字串。

### 憑證提供者
<a name="jdbc-v3-driver-upgrading-credentials-providers"></a>

第 2 版驅動程式會使用完全合格的名稱來辨識不同的憑證提供者 (例如 `com.simba.athena.amazonaws.auth.DefaultAWSCredentialsProviderChain`)。第 3 版驅動程式則使用較短的名稱 (例如 `DefaultChain`)。新名稱會在每個憑證提供者的對應章節中說明。

為第 2 版驅動程式編寫的自訂憑證提供者需要修改第 3 版驅動程式，才能從新的 實作 [AwsCredentialsProvider](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/auth/credentials/AwsCredentialsProvider.html) 介面， 適用於 Java 的 AWS SDK 而不是從先前的 [AWSCredentialsProvider](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/AWSCredentialsProvider.html) 介面 適用於 Java 的 AWS SDK。

JDBC 3.x 驅動器不支援 `PropertiesFileCredentialsProvider`。提供者已在 JDBC 2.x 驅動程式中使用，但屬於舊版的適用於 Java 的 AWS SDK，即將終止支援。若要在 JDBC 3.x 驅動器中實現相同的功能，請改用 [AWS 組態設定檔登入資料](jdbc-v3-driver-aws-configuration-profile-credentials.md) 提供者。

### 日誌層級
<a name="jdbc-v3-driver-upgrading-log-level"></a>

下表顯示 JDBC 第 2 版和第 3 版驅動程式中的 `LogLevel` 參數差異。


****  

| JDBC 驅動程式版本 | 參數名稱 | 參數類型 | 預設值 | 可能的值 | 連線字串範例 | 
| --- | --- | --- | --- | --- | --- | 
|   v2 | LogLevel | 選用 | 0 | 0-6 | LogLevel=6; | 
| v3 | LogLevel | 選用 | TRACE | OFF、ERROR、WARN、INFO、DEBUG、TRACE | LogLevel=INFO; | 

### 查詢 ID 擷取
<a name="jdbc-v3-driver-upgrading-query-id-retrieval"></a>

在第 2 版驅動程式中，您可以將 `Statement` 執行個體取消包裝至 `com.interfaces.core.IStatementQueryInfoProvider`，一個具有兩種方法 `#getPReparedQueryId` 和 `#getQueryId` 的介面。您可以使用這些方法來取得已執行之查詢的查詢執行 ID。

在第 3 版驅動程式中，您可以將 `Statement`、`PreparedStatement` 和 `ResultSet` 執行個體取消包裝至 `com.amazon.athena.jdbc.AthenaResultSet` 介面。該介面有一種方法：`#getQueryExecutionId`。

# Amazon Athena JDBC 3.x 連線參數
<a name="jdbc-v3-driver-connection-parameters"></a>

支援的連線參數在此分為三個區段：[基本連線參數](jdbc-v3-driver-basic-connection-parameters.md)、[進階連線參數](jdbc-v3-driver-advanced-connection-parameters.md) 和 [身分驗證連線參數](jdbc-v3-driver-authentication-connection-parameters.md)。「進階」連線參數和「身分驗證」連線參數區段都有將相關參數群組在一起的子區段。

**Topics**
+ [基本連線參數](jdbc-v3-driver-basic-connection-parameters.md)
+ [進階連線參數](jdbc-v3-driver-advanced-connection-parameters.md)
+ [身分驗證連線參數](jdbc-v3-driver-authentication-connection-parameters.md)

# 基本連線參數
<a name="jdbc-v3-driver-basic-connection-parameters"></a>

下列各節說明 JDBC 3.x 驅動程式的基本連線參數。

## 區域
<a name="jdbc-v3-driver-region"></a>

將執行查詢 AWS 區域 的 。如需區域清單，請參閱 [Amazon Athena 端點和配額](https://docs.aws.amazon.com/general/latest/gr/athena.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| 區域 | AwsRegion (已廢除) | 強制性 (但如果未提供，將使用 [DefaultAwsRegionProviderChain](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/regions/providers/DefaultAwsRegionProviderChain.html) 進行搜尋)  | 無 | 

## 目錄
<a name="jdbc-v3-driver-catalog"></a>

包含將透過驅動程式存取的資料庫和資料表的目錄。如需有關目錄的資訊，請參閱 [DataCatalog](https://docs.aws.amazon.com/athena/latest/APIReference/API_DataCatalog.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| 目錄 | 無 | 選用 | AwsDataCatalog | 

## 資料庫
<a name="jdbc-v3-driver-database"></a>

將在其中執行查詢的資料庫。未明確限定資料庫名稱的資料表將解析至此資料庫。如需有關資料庫的資訊，請參閱[資料庫](https://docs.aws.amazon.com/athena/latest/APIReference/API_Database.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| 資料庫 | 結構描述 | 選用 | 預設 | 

## 工作群組
<a name="jdbc-v3-driver-workgroup"></a>

將在其中執行查詢的工作群組。如需有關工作群組的資訊，請參閱[工作群組](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| WorkGroup | 無 | 選用 | 主要 | 

## 輸出位置
<a name="jdbc-v3-driver-output-location"></a>

Amazon S3 中儲存查詢結果的位置。如需有關輸出位置的資訊，請參閱 [ResultConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultConfiguration.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| OutputLocation | S3OutputLocation (已廢除) | 強制性 (除非工作群組指定了輸出位置) | 無 | 

# 進階連線參數
<a name="jdbc-v3-driver-advanced-connection-parameters"></a>

下列各節說明 JDBC 3.x 驅動程式的進階連線參數。

**Topics**
+ [結果加密參數](#jdbc-v3-driver-result-encryption-parameters)
+ [結果擷取參數](#jdbc-v3-driver-result-fetching-parameters)
+ [結果組態參數](#jdbc-v3-driver-result-config)
+ [查詢結果重複使用參數](#jdbc-v3-driver-query-result-reuse-parameters)
+ [查詢執行輪詢參數](#jdbc-v3-driver-query-execution-polling-parameters)
+ [端點覆寫參數](#jdbc-v3-driver-endpoint-override-parameters)
+ [代理組態參數](#jdbc-v3-driver-proxy-configuration-parameters)
+ [記錄日誌參數](#jdbc-v3-driver-logging-parameters)
+ [Application name (應用程式名稱)](#jdbc-v3-driver-application-name)
+ [連線測試](#jdbc-v3-driver-connection-test)
+ [重試次數](#jdbc-v3-driver-number-of-retries)
+ [網路逾時](#jdbc-v3-driver-networktimeoutmillis)

## 結果加密參數
<a name="jdbc-v3-driver-result-encryption-parameters"></a>

請注意以下重點：
+ 金鑰 AWS KMS 必須在 `EncryptionOption`為 `SSE_KMS`或 時指定`CSE_KMS`。
+ `EncryptionOption` 若未指定 或 `EncryptionOption`為 ，則無法指定 AWS KMS 金鑰`SSE_S3`。

### 加密選項
<a name="jdbc-v3-driver-encryption-option"></a>

查詢結果存放在 Amazon S3 時所使用的加密類型。如需有關查詢結果加密的資訊，請參閱《Amazon Athena API 參考》**中的 [EncryptionConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 可能的值 | 
| --- | --- | --- | --- | --- | 
| EncryptionOption | S3OutputEncOption (已廢除) | 選用 | 無 | SSE\$1S3、SSE\$1KMS、CSE\$1KMS | 

### KMS 金鑰
<a name="jdbc-v3-driver-kms-key"></a>

如果選擇 `SSE_KMS` 或 `CSE_KMS` 做為加密選項，則為 KMS 金鑰 ARN 或 ID。如需詳細資訊，請參閱《Amazon Athena API 參考》**中的 [EncryptionConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| KmsKey | S3OutputEncKMSKey (已廢除) | 選用 | 無 | 

## 結果擷取參數
<a name="jdbc-v3-driver-result-fetching-parameters"></a>

### 結果擷取程式
<a name="jdbc-v3-driver-result-fetcher"></a>

將用於下載查詢結果的擷取程式。

預設的結果擷取程式 `auto` 會直接從 Amazon S3 下載查詢結果，而無需使用 Athena API。當無法直接下載 S3 時，例如使用 `CSE_KMS` 選項加密查詢結果時，其會自動回退至使用 `GetQueryResultsStream` API。

在大多數情況下，建議使用 `auto` 擷取程式。如果您的 IAM 政策或 S3 儲存貯體政策使用 [s3:CalledVia](security-iam-athena-calledvia.md) 條件來限制存取來自 Athena 的 S3 物件請求，則 `auto` 擷取程式會先嘗試從 S3 下載結果，然後回退至使用 `GetQueryResultsStream` API。在這種情況下，您可以將 ResultFetcher 設定為 `GetQueryResultsStream`，以避免額外的 API 呼叫。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 可能的值 | 
| --- | --- | --- | --- | --- | 
| ResultFetcher | 無 | 選用 | auto | auto、S3、GetQueryResults、GetQueryResultsStream | 

### 擷取大小
<a name="jdbc-v3-driver-fetch-size"></a>

這個參數的值用做內部緩衝區的最小值，以及擷取結果時的目標頁面大小。值 0 (零) 表示驅動程式應使用其預設值，如下所述。最大值為 1,000,000。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| FetchSize | RowsToFetchPerBlock (已廢除) | 選用 | 0 | 
+ `GetQueryResults` 擷取程式一律會使用 1,000 的頁面大小，這是 API 呼叫所支援的最大值。當擷取大小大於 1,000 時，會進行多次連續的 API 呼叫，以填滿高於最小值的緩衝區。
+ `GetQueryResultsStream` 擷取程式會使用設定的擷取大小做為頁面大小，或依預設使用 10,000。
+ `S3` 擷取程式會使用設定的擷取大小做為頁面大小，或依預設使用 10,000。

## 結果組態參數
<a name="jdbc-v3-driver-result-config"></a>

### Expected bucket owner (預期的儲存貯體擁有者)
<a name="jdbc-v3-driver-exp-bucket-owner"></a>

預期的 S3 儲存貯體擁有者的帳戶 ID。如果您提供的帳戶 ID 與儲存貯體的實際擁有者不相符，則請求會失敗。如需有關驗證 s3 儲存貯體擁有者的詳細資訊，請參閱[驗證儲存貯體擁有權](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-owner-condition.html#bucket-owner-condition-use)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| ExpectedBucketOwner | 無 | 選用 | 無 | 

### Acl 選項
<a name="jdbc-v3-driver-acl"></a>

指出 Amazon S3 標準 ACL 應設定為控制儲存查詢結果的擁有權。如需有關 `AclOption` 的詳細資訊，請參閱 [AclConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_AclConfiguration.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 可能的值 | 
| --- | --- | --- | --- | --- | 
| AclOption | 無 | 選用 | 無 | BUCKET\$1OWNER\$1FULL\$1CONTROL | 

## 查詢結果重複使用參數
<a name="jdbc-v3-driver-query-result-reuse-parameters"></a>

### 啟用結果重複使用
<a name="jdbc-v3-driver-enable-result-reuse"></a>

指定執行查詢時是否可以重複使用同一查詢之前的結果。如需有關查詢結果重複使用的資訊，請參閱 [ResultReuseByAgeConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultReuseByAgeConfiguration.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| EnableResultReuseByAge | 無 | 選用 | FALSE | 

### 結果重複使用最長期限
<a name="jdbc-v3-driver-result-reuse-max-age"></a>

Athena 應考慮重複使用的之前查詢結果的最長期限 (以分鐘為單位)。如需有關結果重複使用最長期限的資訊，請參閱 [ResultReuseByAgeConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultReuseByAgeConfiguration.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| MaxResultReuseAgeInMinutes | 無 | 選用 | 60 | 

## 查詢執行輪詢參數
<a name="jdbc-v3-driver-query-execution-polling-parameters"></a>

### 最小查詢執行輪詢間隔
<a name="jdbc-v3-driver-minimum-query-execution-polling-interval"></a>

輪詢 Athena 的查詢執行狀態之前要等待的最短時間 (以毫秒為單位)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| MinQueryExecutionPollingIntervalMillis | MinQueryExecutionPollingInterval (已廢除) | 選用 | 100 | 

### 最大查詢執行輪詢間隔
<a name="jdbc-v3-driver-maximum-query-execution-polling-interval"></a>

輪詢 Athena 的查詢執行狀態之前要等待的最長時間 (以毫秒為單位)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| MaxQueryExecutionPollingIntervalMillis | MaxQueryExecutionPollingInterval (已廢除) | 選用 | 5000 | 

### 查詢執行輪詢間隔倍數
<a name="jdbc-v3-driver-query-execution-polling-interval-multiplier"></a>

增加輪詢期間的因數。依預設，輪詢會以 `MinQueryExecutionPollingIntervalMillis` 的值開始，並且每次輪詢都會加倍，直至達到 `MaxQueryExecutionPollingIntervalMillis` 的值為止。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| QueryExecutionPollingIntervalMultiplier | 無 | 選用 | 2 | 

## 端點覆寫參數
<a name="jdbc-v3-driver-endpoint-override-parameters"></a>

### Athena 端點覆寫
<a name="jdbc-v3-driver-athena-endpoint-override"></a>

驅動程式將用來對 Athena 進行 API 呼叫的端點。

請注意以下重點：
+ 如果提供的 URL 中未指定 `https://` 或 `http://` 通訊協定，則驅動程式會插入 `https://` 字首。
+ 若沒有指定此參數，則驅動程式會使用預設端點。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| AthenaEndpoint | EndpointOverride (已廢除) | 選用 | 無 | 

### Athena 串流服務端點覆寫
<a name="jdbc-v3-driver-athena-streaming-service-endpoint-override"></a>

當驅動程式使用 Athena 串流服務時，將用來下載查詢結果的端點。Athena 串流服務可在連接埠 444 上使用。

請注意以下重點：
+ 如果提供的 URL 中未指定 `https://` 或 `http://` 通訊協定，則驅動程式會插入 `https://` 字首。
+ 如果未在提供的 URL 中指定連接埠，則驅動程式會插入串流服務連接埠 444。
+ 如果未指定 `AthenaStreamingEndpoint` 參數，驅動程式會使用 `AthenaEndpoint` 覆寫。如果 `AthenaStreamingEndpoint` 或 `AthenaEndpoint` 覆寫均未指定，則驅動程式會使用預設的串流端點。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| AthenaStreamingEndpoint | StreamingEndpointOverride (已廢除) | 選用 | 無 | 

### LakeFormation 端點覆寫
<a name="jdbc-v3-driver-athena-lake-formation-endpoint-override"></a>

驅動程式使用 AWS Lake Formation [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) API 擷取臨時憑證時，將用於 Lake Formation 服務的端點。若沒有指定此參數，則驅動程式會使用預設的 Lake Formation 端點。

請注意以下重點：
+ 如果提供的 URL 中未指定 `https://` 或 `http://` 通訊協定，則驅動程式會插入 `https://` 字首。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| LakeFormationEndpoint |  LfEndpointOverride (已廢除)  | 選用 | 無 | 

### S3 端點覆寫
<a name="jdbc-v3-driver-athena-s3-endpoint-override"></a>

當驅動程式使用 Amazon S3 擷取程式時，將用來下載查詢結果的端點。若沒有指定此參數，則驅動程式會使用預設的 Amazon S3 端點。

請注意以下重點：
+ 如果提供的 URL 中未指定 `https://` 或 `http://` 通訊協定，則驅動程式會插入 `https://` 字首。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| S3Endpoint | 無 | 選用 | 無 | 

### STS 端點覆寫
<a name="jdbc-v3-driver-athena-sts-endpoint-override"></a>

使用 AWS STS [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) API 擷取臨時憑證時，驅動程式將用於 AWS STS 服務的端點。如果未指定此參數，驅動程式會使用預設 AWS STS 端點。

請注意以下重點：
+ 如果提供的 URL 中未指定 `https://` 或 `http://` 通訊協定，則驅動程式會插入 `https://` 字首。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| StsEndpoint | StsEndpointOverride (已廢除) | 選用 | 無 | 

### SSO OIDC 端點覆寫
<a name="jdbc-v3-driver-athena-sso-oidc-endpoint-override"></a>

使用 `ClientConfiguration.endpointOverride` 覆寫 SSO OIDC 用戶端的預設 HTTP 端點時，驅動器將使用的端點。如需詳細資訊，請參閱 [ClientConfiguration](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| SSOOIDCEndpointOverride |  | 選用 | 無 | 

### SSO 管理員端點覆寫
<a name="jdbc-v3-driver-athena-sso-admin-endpoint-override"></a>

使用 `ClientConfiguration.endpointOverride` 覆寫 SSO 管理員用戶端的預設 HTTP 端點時，驅動器將使用的端點。如需詳細資訊，請參閱 [ClientConfiguration](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| SSOAdminEndpointOverride |  | 選用 | 無 | 

## 代理組態參數
<a name="jdbc-v3-driver-proxy-configuration-parameters"></a>

### 代理主機
<a name="jdbc-v3-driver-proxy-host"></a>

代理主機的 URL。如果您需要 Athena 請求透過代理傳送，請使用此參數。

**注意**  
 確定在 `ProxyHost` 的 URL 開頭包含通訊協定 `https://` 或 `http://`。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| ProxyHost | 無 | 選用 | 無 | 

### 代理連接埠
<a name="jdbc-v3-driver-proxy-port"></a>

要在代理主機上使用的連接埠。如果您需要 Athena 請求透過代理傳送，請使用此參數。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| ProxyPort | 無 | 選用 | 無 | 

### 代理使用者名稱
<a name="jdbc-v3-driver-proxy-username"></a>

在代理伺服器上進行身分驗證的使用者名稱。如果您需要 Athena 請求透過代理傳送，請使用此參數。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| ProxyUsername | ProxyUID (已廢除) | 選用 | 無 | 

### 代理密碼
<a name="jdbc-v3-driver-proxy-password"></a>

在代理伺服器上進行身分驗證的密碼。如果您需要 Athena 請求透過代理傳送，請使用此參數。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| ProxyPassword | ProxyPWD (已廢除) | 選用 | 無 | 

### 免除代理的主機
<a name="jdbc-v3-driver-proxy-exempt-hosts"></a>

啟用代理後 (也就是設定 `ProxyHost` 和 `ProxyPort` 連線參數後)，驅動程式在不使用代理的情況下連線到的一組主機名稱。主機應以縱線 (`|`) 字元分隔 (例如，`host1.com|host2.com`)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| ProxyExemptHosts | NonProxyHosts | 選用 | 無 | 

### 為身分提供者啟用代理
<a name="jdbc-v3-driver-proxy-enabled-for-identity-providers"></a>

指定當驅動程式連線至身分提供者時，是否應使用代理。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| ProxyEnabledForIdP | UseProxyForIdP | 選用 | FALSE | 

## 記錄日誌參數
<a name="jdbc-v3-driver-logging-parameters"></a>

本節說明與記錄日誌相關的參數。

### 日誌層級
<a name="jdbc-v3-driver-logging-parameters-log-level"></a>

指定驅動程式記錄日誌的層級。除非還設定了 `LogPath` 參數，否則不會記錄任何內容。

**注意**  
除非您有特殊需求，否則建議您僅設定 `LogPath` 參數。僅設定 `LogPath` 參數會啟用記錄日誌，並使用預設的 `TRACE` 日誌層級。`TRACE` 日誌層級會提供最詳細的記錄。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 可能的值 | 
| --- | --- | --- | --- | --- | 
| LogLevel | 無 | 選用 | TRACE | OFF、ERROR、WARN、INFO、DEBUG、TRACE | 

### 日誌路徑
<a name="jdbc-v3-driver-logging-parameters-log-path"></a>

執行驅動程式的電腦上儲存驅動程式日誌的目錄路徑。將在指定的目錄中建立具有唯一名稱的日誌檔。如果設定，則啟用驅動程式記錄日誌。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| LogPath | 無 | 選用 | 無 | 

## Application name (應用程式名稱)
<a name="jdbc-v3-driver-application-name"></a>

使用驅動程式的應用程式的名稱。如果指定此參數的值，則該值會包含在驅動程式對 Athena 進行之 API 呼叫的使用者代理字串中。

**注意**  
您也可以透過呼叫 `setApplicationName` 物件上的 `DataSource` 來設定應用程式名稱。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| ApplicationName | 無 | 選用 | 無 | 

## 連線測試
<a name="jdbc-v3-driver-connection-test"></a>

如果設定為 `TRUE`，則即使未在連線上執行查詢，驅動程式也會在每次建立 JDBC 連線時進行連線測試。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| ConnectionTest | 無 | 選用 | TRUE | 

**注意**  
連線測試會將 `SELECT 1` 查詢提交至 Athena，以確認連線設定正確。這表示兩個檔案將儲存在 Amazon S3 中 (結果集和中繼資料)，而且可能會根據 [Amazon Athena 定價](https://aws.amazon.com/athena/pricing)政策收取額外費用。

## 重試次數
<a name="jdbc-v3-driver-number-of-retries"></a>

驅動程式將可重試請求重新傳送至 Athena 的次數上限。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| NumRetries | MaxErrorRetry (已廢除) | 選用 | 無 | 

## 網路逾時
<a name="jdbc-v3-driver-networktimeoutmillis"></a>

網路逾時可控制驅動器等待建立網路連線的時間量。這包括傳送 API 請求所需的時間。在極少數情況下，變更網路逾時可能會非常實用。例如，您可能想要增加長時間垃圾回收暫停的逾時。設定此連線參數等同於在 `Connection` 物件上使用 `setNetworkTimeout` 方法。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
|  NetworkTimeoutMillis  | 無 | 選用 | 無 | 

# 身分驗證連線參數
<a name="jdbc-v3-driver-authentication-connection-parameters"></a>

Athena JDBC 3.x 驅動程式支援多種身分驗證方法。所需的連線參數視您使用的身分驗證方法而定。

**Topics**
+ [IAM](jdbc-v3-driver-iam-credentials.md)
+ [預設](jdbc-v3-driver-default-credentials.md)
+ [AWS 組態設定檔](jdbc-v3-driver-aws-configuration-profile-credentials.md)
+ [執行個體設定檔](jdbc-v3-driver-instance-profile-credentials.md)
+ [Custom](jdbc-v3-driver-custom-credentials.md)
+ [JWT](jdbc-v3-driver-jwt-credentials.md)
+ [JWT 可信身分傳播](jdbc-v3-driver-jwt-tip-credentials.md)
+ [瀏覽器信任的身分傳播](jdbc-v3-driver-browser-oidc-tip-credentials.md)
+ [Azure AD](jdbc-v3-driver-azure-ad-credentials.md)
+ [Okta](jdbc-v3-driver-okta-credentials.md)
+ [Ping](jdbc-v3-driver-ping-credentials.md)
+ [AD FS](jdbc-v3-driver-adfs-credentials.md)
+ [瀏覽器 Azure AD](jdbc-v3-driver-browser-azure-ad-credentials.md)
+ [瀏覽器 SAML](jdbc-v3-driver-browser-saml-credentials.md)
+ [DataZone IdC](jdbc-v3-driver-datazone-idc.md)
+ [DataZone IAM](jdbc-v3-driver-datazone-iamcp.md)

# IAM 憑證
<a name="jdbc-v3-driver-iam-credentials"></a>

您可以將 IAM 憑證與 JDBC 驅動程式配合使用，透過設定以下連線參數連線至 Amazon Athena。

## 使用者
<a name="jdbc-v3-driver-user"></a>

您的 AWS 存取金鑰 ID。如需有關存取金鑰的資訊，請參閱**《IAM 使用者指南》中的 [AWS 安全憑證](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| 使用者 | AccessKeyId | 必要 | 無 | 

## 密碼
<a name="jdbc-v3-driver-password"></a>

您的 AWS 私密金鑰 ID。如需有關存取金鑰的資訊，請參閱**《IAM 使用者指南》中的 [AWS 安全憑證](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| 密碼 | SecretAccessKey | 選用 | 無 | 

## 工作階段字符
<a name="jdbc-v3-driver-session-token"></a>

如果您使用臨時 AWS 登入資料，則必須指定工作階段字符。如需有關暫時憑證的資訊，請參閱《*IAM 使用者指南*》中的 [IAM 中的暫時安全憑證](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| SessionToken | 無 | 選用 | 無 | 

# 預設憑證
<a name="jdbc-v3-driver-default-credentials"></a>

您可以使用在用戶端系統上設定的預設憑證，透過設定以下連線參數連線至 Amazon Athena。如需有關使用預設憑證的資訊，請參閱《*適用於 Java 的 AWS SDK 開發人員指南*》中的[使用預設憑證提供者鏈結](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/credentials.html#credentials-default)。

## 憑證提供者
<a name="jdbc-v3-driver-credentials-provider"></a>

將用來驗證對 AWS的請求的憑證提供者。將此參數的值設為 `DefaultChain`。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 將使用的值 | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (已廢除) | 必要 | 無 | DefaultChain | 

# AWS 組態設定檔登入資料
<a name="jdbc-v3-driver-aws-configuration-profile-credentials"></a>

您可以透過設定下列連線參數來使用存放在 AWS 組態設定檔中的登入資料。 AWS 組態設定檔通常存放在 `~/.aws`目錄中的檔案中）。如需 AWS 組態設定檔的相關資訊，請參閱**《適用於 Java 的 AWS SDK 開發人員指南》中的[使用設定檔](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/credentials-profiles.html)。

## 憑證提供者
<a name="jdbc-v3-driver-aws-configuration-profile-credentials-provider"></a>

將用來驗證對 AWS的請求的憑證提供者。將此參數的值設為 `ProfileCredentials`。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 將使用的值 | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (已廢除) | 必要 | 無 | ProfileCredentials | 

## Profile name (設定檔名稱)
<a name="jdbc-v3-driver-profile-name"></a>

 AWS 組態設定檔的名稱，其登入資料應該用來驗證對 Athena 的請求。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| ProfileName | 無 | 必要 | 無 | 

**注意**  
設定檔名稱也可以指定為 `CredentialsProviderArguments` 參數的值，雖然此用法已廢除。

# 執行個體設定檔憑證
<a name="jdbc-v3-driver-instance-profile-credentials"></a>

此身分驗證類型在 Amazon EC2 執行個體上使用。*執行個體設定檔*是連接至 Amazon EC2 執行個體的設定檔。使用執行個體描述檔登入資料提供者將 AWS 登入資料的管理委派給 Amazon EC2 執行個體中繼資料服務。如此一來，開發人員就無需在 Amazon EC2 執行個體上永久儲存憑證，也不用擔心輪換或管理臨時憑證。

## 憑證提供者
<a name="jdbc-v3-driver-instance-profile-credentials-provider"></a>

將用來驗證對 AWS的請求的憑證提供者。將此參數的值設為 `InstanceProfile`。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 將使用的值 | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (已廢除) | 必要 | 無 | InstanceProfile | 

# 自訂憑證
<a name="jdbc-v3-driver-custom-credentials"></a>

您可以使用此身分驗證類型，藉由使用實作 [AwsCredentialsProvider](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/auth/credentials/AwsCredentialsProvider.html) 介面的 Java 類別來提供您自己的憑證。

## 憑證提供者
<a name="jdbc-v3-driver-custom-credentials-credentials-provider"></a>

將用來驗證對 AWS的請求的憑證提供者。將此參數的值設定為實作 [AwsCredentialsProvider](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/auth/credentials/AwsCredentialsProvider.html) 介面之自訂類別的完全合格類別名稱。在執行期，該類別必須位於使用 JDBC 驅動程式之應用程式的 Java 類別路徑上。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 將使用的值 | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (已廢除) | 必要 | 無 | AwsCredentialsProvider 自訂實作的完全合格類別名稱 | 

## 憑證提供者引數
<a name="jdbc-v3-driver-credentials-provider-arguments"></a>

自訂認證提供者建構函數的逗號分隔字串引數清單。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| CredentialsProviderArguments | AwsCredentialsProviderArguments (已廢除) | 選用 | 無 | 

# JWT 憑證
<a name="jdbc-v3-driver-jwt-credentials"></a>

藉由此身分驗證類型，您可以使用從外部身分提供者獲得的 JSON Web Token (JWT) 作為連線參數，向 Athena 進行身分驗證。外部登入資料提供者必須已經與 聯合 AWS。

## 憑證提供者
<a name="jdbc-v3-driver-jwt-credentials-provider"></a>

將用來驗證對 AWS的請求的憑證提供者。將此參數的值設為 `JWT`。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 將使用的值 | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (已廢除) | 必要 | 無 | JWT | 

## JWT web 身分權杖
<a name="jdbc-v3-driver-jwt-web-identity-token"></a>

從外部聯合身分提供者獲得的 JWT 權杖。此權杖將用於向 Athena 進行身分驗證。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| JwtWebIdentityToken | web\$1identity\$1token (已廢除) | 必要 | 無 | 

## JWT 角色 ARN
<a name="jdbc-v3-driver-jwt-role-arn"></a>

要擔任之角色的 Amazon Resource Name (ARN)。如需有關擔任角色的資訊，請參閱《AWS Security Token Service API 參考》**中的 [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| JwtRoleArn | role\$1arn (已廢除) | 必要 | 無 | 

## JWT 角色工作階段名稱
<a name="jdbc-v3-driver-jwt-role-session-name"></a>

使用 JWT 憑證進行身分驗證時的工作階段名稱。該名稱可以是您選擇的任何名稱。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| JwtRoleSessionName | role\$1session\$1name (已廢除) | 必要 | 無 | 

## 角色工作階段持續時間
<a name="jdbc-v3-driver-jwt-role-session-duration"></a>

角色工作階段的持續時間 (以秒為單位)。如需詳細資訊，請參閱《AWS Security Token Service API 參考**》中的 [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (已廢除) | 選用 | 3600 | 

# JWT 與身分中心整合
<a name="jdbc-v3-driver-jwt-tip-credentials"></a>

此身分驗證類型允許您使用從外部身分提供者獲得的 JSON Web Token (JWT) 作為連線參數，向 Athena 進行身分驗證。您可以使用此外掛程式，透過可信身分傳播啟用對企業身分的支援。如需有關如何搭配使用可信身分傳播與驅動器的詳細資訊，請參閱 [搭配使用可信身分傳播與 Amazon Athena 驅動器](using-trusted-identity-propagation.md)。您也可以[使用 CloudFormation 設定和部署資源](using-trusted-identity-propagation-cloudformation.md)。

透過信任的身分傳播，身分內容會新增至 IAM 角色，以識別請求存取 AWS 資源的使用者。如需有關啟用和使用可信身分傳播的資訊，請參閱[什麼是可信身分傳播？](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation.html)。

## 憑證提供者
<a name="jdbc-v3-driver-jwt-tip-credentials-provider"></a>

將用來驗證對 AWS的請求的憑證提供者。將此參數的值設為 `JWT_TIP`。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 將使用的值 | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (已廢除) | 必要 | 無 | JWT\$1TIP | 

## JWT web 身分權杖
<a name="jdbc-v3-driver-jwt-tip-web-identity-token"></a>

從外部聯合身分提供者獲得的 JWT 權杖。此權杖將用於向 Athena 進行身分驗證。權杖快取預設為啟用，並允許在不同的驅動器連線之間使用相同的 Identity Center 存取權杖。建議在「測試連線」時提供新的 JWT 權杖，因為交換的權杖僅在驅動器執行個體處於作用中狀態時才會存在。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| JwtWebIdentityToken | web\$1identity\$1token (已廢除) | 必要 | 無 | 

## WorkgroupArn
<a name="jdbc-v3-driver-jwt-tip-workgroup-arn"></a>

Amazon Athena 工作群組的 Amazon Resource Name (ARN)。如需有關工作群組的詳細資訊，請參閱[工作群組](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| WorkGroupArn | 無 | 必要 | 主要 | 

## JWT 應用程式角色 ARN
<a name="jdbc-v3-driver-jwt-tip-application-role-arn"></a>

要擔任的角色 ARN。此角色可用於 JWT 交換、透過工作群組標籤取得 IAM Identity Center 客戶自管應用程式 ARN，以及取得存取角色 ARN。如需有關擔任角色的詳細資訊，請參閱 [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| ApplicationRoleArn | 無 | 必要 | 無 | 

## JWT 角色工作階段名稱
<a name="jdbc-v3-driver-jwt-tip-role-session-name"></a>

使用 JWT 憑證進行身分驗證時的工作階段名稱。其可以是您選擇的任何名稱。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| JwtRoleSessionName | role\$1session\$1name (已廢除) | 必要 | 無 | 

## 角色工作階段持續時間
<a name="jdbc-v3-driver-jwt-tip-session-duration"></a>

角色工作階段的持續時間 (以秒為單位)。如需詳細資訊，請參閱 [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (已廢除) | 選用 | 3600 | 

## JWT 存取角色 ARN
<a name="jdbc-v3-driver-jwt-tip-access-role-arn"></a>

要擔任的角色 ARN。這是 Athena 服務所擔任的角色，可代表您進行呼叫。如需有關擔任角色的詳細資訊，請參閱《AWS Security Token Service API 參考**》中的 [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| AccessRoleArn | 無 | 選用 | 無 | 

## IAM Identity Center 客戶自管應用程式 ARN
<a name="jdbc-v3-driver-jwt-tip-customer-idc-application-arn"></a>

IAM Identity Center 客戶自管應用程式的 ARN。如需詳細資訊，請參閱[客戶自管應用程式](https://docs.aws.amazon.com/singlesignon/latest/userguide/customermanagedapps.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| CustomerIdcApplicationArn | 無 | 選用 | 無 | 

# 以身分中心整合為基礎的瀏覽器
<a name="jdbc-v3-driver-browser-oidc-tip-credentials"></a>

此身分驗證類型可讓您從外部身分提供者擷取新的 JSON Web 字符 (JWT)，並使用 Athena 進行身分驗證。您可以使用此外掛程式，透過可信身分傳播啟用對企業身分的支援。如需有關如何搭配使用可信身分傳播與驅動器的詳細資訊，請參閱 [搭配使用可信身分傳播與 Amazon Athena 驅動器](using-trusted-identity-propagation.md)。您也可以[使用 CloudFormation 設定和部署資源](using-trusted-identity-propagation-cloudformation.md)。

透過信任的身分傳播，身分內容會新增至 IAM 角色，以識別請求存取 AWS 資源的使用者。如需有關啟用和使用可信身分傳播的資訊，請參閱[什麼是可信身分傳播？](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation.html)。

**注意**  
外掛程式專為單一使用者桌面環境而設計。在 Windows Server 等共用環境中，系統管理員負責建立和維護使用者之間的安全界限。

## 憑證提供者
<a name="jdbc-v3-driver-browser-oidc-tip-credentials-provider"></a>

將用來驗證對 AWS的請求的憑證提供者。將此參數的值設為 `BrowserOidcTip`。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 將使用的值 | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (已廢除) | 必要 | 無 | BrowserOidcTip | 

## Idp 已知組態 URL
<a name="jdbc-v3-driver-browser-oidc-tip-idp-well-known-config"></a>

IDP Well Known 組態 URL 是為您的身分提供者提供 OpenID Connect 組態詳細資訊的端點。此 URL 通常會以 結尾，`.well-known/openid-configuration`並包含有關身分驗證端點、支援的功能和字符簽署金鑰的基本中繼資料。例如，如果您使用的是 *Okta*，URL 可能看起來像 `https://your-domain.okta.com/.well-known/openid-configuration`。

針對疑難排解：如果您收到連線錯誤，請確認此 URL 可從您的網路存取，並傳回有效的 *OpenID Connect* 組態 JSON。此 URL 必須由安裝驅動程式的用戶端連線，且應由您的身分提供者管理員提供。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| IdpWellKnownConfigurationUrl | 無 | 必要 | 無 | 

## 用戶端識別符
<a name="jdbc-v3-driver-browser-oidc-tip-client-id"></a>

OpenID Connect 提供者向應用程式發出的用戶端識別符。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| OidcClientId | 無 | 必要 | 無 | 

## WorkgroupArn
<a name="jdbc-v3-driver-browser-oidc-tip-workgroup-arn"></a>

Amazon Athena 工作群組的 Amazon Resource Name (ARN)，其中包含信任的身分傳播組態標籤。如需有關工作群組的詳細資訊，請參閱[工作群組](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html)。

**注意**  
此參數與指定查詢執行位置的 `Workgroup` 參數不同。您必須設定這兩個參數：  
`WorkgroupArn` - 指向工作群組，其中包含信任的身分傳播組態標籤
`Workgroup` - 指定執行查詢的工作群組
雖然這些參數通常會參考相同的工作群組，但必須明確設定這兩個參數才能正常運作。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| WorkGroupArn | 無 | 必要 | 主要 | 

## JWT 應用程式角色 ARN
<a name="jdbc-v3-driver-browser-oidc-tip-application-role-arn"></a>

將在 JWT 交換中擔任的角色 ARN。此角色可用於 JWT 交換、透過工作群組標籤取得 IAM Identity Center 客戶自管應用程式 ARN，以及取得存取角色 ARN。如需有關擔任角色的詳細資訊，請參閱 [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| ApplicationRoleArn | 無 | 必要 | 無 | 

## JWT 角色工作階段名稱
<a name="jdbc-v3-driver-browser-oidc-tip-role-session-name"></a>

IAM 工作階段的名稱。名稱可隨意指定，但是一般來說，您會傳遞與應用程式使用者相關聯的名稱或識別碼。這樣一來，應用程式使用的臨時安全憑證會與該使用者相關聯。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| JwtRoleSessionName | role\$1session\$1name (已廢除) | 必要 | 無 | 

## Client secret (用戶端密碼)
<a name="jdbc-v3-driver-browser-oidc-tip-client-secret"></a>

clientSecret 是由您的身分提供者發行的機密金鑰，用於驗證您的應用程式 （用戶端）。雖然此參數是選用的，而且可能不是所有身分驗證流程的必要項目，但在使用時提供額外的安全層。如果您的 IDP 組態需要用戶端秘密，您必須將此參數包含身分提供者管理員提供的值。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| OidcClientSecret | 無 | 選用 | 無 | 

## Scope (範圍)
<a name="jdbc-v3-driver-browser-oidc-tip-scope"></a>

範圍會指定應用程式向身分提供者請求的存取層級。您必須在 `openid` 範圍內包含 ，才能接收包含基本使用者身分宣告的 ID 字符。您的範圍可能需要包含其他許可，例如 `email`或 `profile`，取決於哪些使用者宣告您的身分提供者 （例如 *Microsoft Entra ID*) 已設定為包含在 ID 字符中。這些宣告對於適當的*受信任身分傳播*映射至關重要。如果使用者身分映射失敗，請確認您的範圍包含所有必要的許可，且您的身分提供者已設定為在 ID 字符中包含必要的宣告。這些宣告必須符合 IAM Identity Center 中的*受信任權杖發行者*映射組態。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| Scope (範圍) | 無 | 選用 | openid email offline\$1access | 

## 角色工作階段持續時間
<a name="jdbc-v3-driver-browser-oidc-tip-role-session-duration"></a>

角色工作階段的持續時間 (以秒為單位)。如需詳細資訊，請參閱 [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (已廢除) | 選用 | 3600 | 

## JWT 存取角色 ARN
<a name="jdbc-v3-driver-browser-oidc-tip-access-role-arn"></a>

Athena 代您呼叫所擔任角色的 ARN。如需有關擔任角色的詳細資訊，請參閱《AWS Security Token Service API 參考**》中的 [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| AccessRoleArn | 無 | 選用 | 無 | 

## IAM Identity Center 客戶自管應用程式 ARN
<a name="jdbc-v3-driver-browser-oidc-tip-customer-idc-application-arn"></a>

IAM Identity Center 客戶自管應用程式的 ARN。如需詳細資訊，請參閱[客戶自管應用程式](https://docs.aws.amazon.com/singlesignon/latest/userguide/customermanagedapps.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| CustomerIdcApplicationArn | 無 | 選用 | 無 | 

## 身分提供者連接埠號碼
<a name="jdbc-v3-driver-browser-oidc-tip-idp-port-number"></a>

用於 OAuth 2.0 回呼伺服器的本機連接埠號碼。這用作 redirect\$1uri，您需要允許在 IDP 應用程式中將其列出。預設產生的 redirect\$1uri 為：http：//localhost：7890/athena

**警告**  
在共用環境中，例如 Windows Terminal Server 或遠端桌面服務，循環連接埠 （預設值：7890) 會在相同機器上的所有使用者之間共用。系統管理員可以透過下列方式降低潛在的連接埠劫持風險：  
為不同的使用者群組設定不同的連接埠號碼
使用 Windows 安全政策來限制連接埠存取
在使用者工作階段之間實作網路隔離
如果無法實作這些安全控制，建議您改用 [JWT 信任的身分傳播](jdbc-v3-driver-jwt-tip-credentials.md)外掛程式，這不需要迴路連接埠。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| IdpPortNumber | 無 | 選用 | 7890 | 

## 識別提供者回應逾時
<a name="jdbc-v3-driver-browser-oidc-tip-idp-response-timeout"></a>

等待 OAuth 2.0 回呼回應的逾時，以秒為單位。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| IdpResponseTimeout | 無 | 選用 | 120 | 

## 啟用權杖快取
<a name="jdbc-v3-driver-browser-oidc-tip-enable-token-caching"></a>

EnableTokenCaching 參數會判斷驅動程式是否在連接之間快取身分驗證字符。將 EnableTokenCaching 設為 true 可減少身分驗證提示並改善使用者體驗，但應謹慎使用。此設定最適合單一使用者桌面環境。在 Windows Server 等共用環境中，建議將其停用，以防止具有類似連線字串的使用者之間進行潛在的字符共用。

對於使用 Tableau Server 等工具的企業部署，我們建議您使用 [JWT 信任的身分傳播](jdbc-v3-driver-jwt-tip-credentials.md)外掛程式，而不是此身分驗證方法。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| EnableTokenCaching | 無 | 選用 | FALSE | 

# Azure AD 憑證
<a name="jdbc-v3-driver-azure-ad-credentials"></a>

SAML 型身分驗證機制，可讓您使用 Azure AD 身分提供者向 Athena 進行身分驗證。此方法假設已經在 Athena 和 Azure AD 之間建立了聯合。

**注意**  
本節中的某些參數名稱具有別名。別名是參數名稱的功能對等項目，並已提供與 JDBC 2.x 驅動程式的向後相容性。由於參數名稱已經過改進，以遵循更清晰、更一致的命名慣例，因此我們建議您使用參數名稱，而不是已被取代的別名。

## 憑證提供者
<a name="jdbc-v3-driver-azure-ad-credentials-provider"></a>

將用來驗證對 AWS的請求的憑證提供者。將此參數的值設為 `AzureAD`。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 將使用的值 | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (已廢除) | 必要 | 無 | AzureAD | 

## 使用者
<a name="jdbc-v3-driver-azure-ad-user"></a>

Azure AD 使用者的電子郵件地址，用來透過 Azure AD 進行身分驗證。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| 使用者 | UID (已廢除) | 必要 | 無 | 

## 密碼
<a name="jdbc-v3-driver-azure-ad-password"></a>

Azure AD 使用者的密碼。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| 密碼 | PWD (已廢除) | 必要 | 無 | 

## Azure AD 租用戶 ID
<a name="jdbc-v3-driver-azure-ad-tenant-id"></a>

Azure AD 應用程式的租用戶 ID。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| AzureAdTenantId | tenant\$1id (已廢除) | 必要 | 無 | 

## Azure AD 用戶端 ID
<a name="jdbc-v3-driver-azure-ad-client-id"></a>

Azure AD 應用程式的用戶端 ID。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| AzureAdClientId | client\$1id (已廢除) | 必要 | 無 | 

## Azure AD 用戶端秘密
<a name="jdbc-v3-driver-azure-ad-client-secret"></a>

Azure AD 應用程式的用戶端秘密。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| AzureAdClientSecret | client\$1secret (已廢除) | 必要 | 無 | 

## 偏好的角色
<a name="jdbc-v3-driver-preferred-role"></a>

要擔任之角色的 Amazon Resource Name (ARN)。如需有關 ARN 角色的資訊，請參閱《AWS Security Token Service API 參考》**中的 [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (已廢除) | 選用 | 無 | 

## 角色工作階段持續時間
<a name="jdbc-v3-driver-role-session-duration"></a>

角色工作階段的持續時間 (以秒為單位)。如需詳細資訊，請參閱《AWS Security Token Service API 參考》**中的 [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (已廢除) | 選用 | 3600 | 

## Lake Formation 啟用
<a name="jdbc-v3-driver-lake-formation-enabled"></a>

指定是否使用 [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) Lake Formation API 動作來擷取臨時 IAM 憑證，而非 [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) AWS STS API 動作。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | 無 | 選用 | FALSE | 

# Okta 憑證
<a name="jdbc-v3-driver-okta-credentials"></a>

SAML 型身分驗證機制，可讓您使用 Okta 身分提供者向 Athena 進行身分驗證。此方法假設已經在 Athena 和 Okta 之間設定了聯合。

## 憑證提供者
<a name="jdbc-v3-driver-okta-credentials-provider"></a>

將用來驗證對 AWS的請求的憑證提供者。將此參數的值設為 `Okta`。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 將使用的值 | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (已廢除) | 必要 | 無 | Okta | 

## 使用者
<a name="jdbc-v3-driver-okta-user"></a>

Okta 使用者的電子郵件地址，用來透過 Okta 進行身分驗證。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| 使用者 | UID (已廢除) | 必要 | 無 | 

## 密碼
<a name="jdbc-v3-driver-okta-password"></a>

Okta 使用者的密碼。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| 密碼 | PWD (已廢除) | 必要 | 無 | 

## Okta 主機名稱
<a name="jdbc-v3-driver-okta-host-name"></a>

您的 Okta 組織的 URL。您可以從 Okta 應用程式中的**內嵌連結** URL 擷取 `idp_host` 參數。如需這些步驟，請參閱 [從 Okta 擷取 ODBC 組態資訊](odbc-okta-plugin.md#odbc-okta-plugin-retrieve-odbc-configuration-information-from-okta)。`https://` 後的第一個區段、直到並包括 `okta.com`，即為您的 IdP 主機 (例如，以 `https://trial-1234567.okta.com` 開頭的 URL 為 `trial-1234567.okta.com`)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| OktaHostName | IdP\$1Host (已廢除) | 必要 | 無 | 

## Okta 應用程式 ID
<a name="jdbc-v3-driver-okta-application-id"></a>

您應用程式的兩部分識別符。您可以從 Okta 應用程式中的**內嵌連結** URL 擷取應用程式 ID。如需這些步驟，請參閱 [從 Okta 擷取 ODBC 組態資訊](odbc-okta-plugin.md#odbc-okta-plugin-retrieve-odbc-configuration-information-from-okta)。應用程式 ID 是 URL 的最後兩個區段，包括中間的正斜線。這些區段是兩個由 20 個字元組成的字串，其中包含數字和大小寫字母的混合 (例如 `Abc1de2fghi3J45kL678/abc1defghij2klmNo3p4`)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| OktaAppId | App\$1ID (已廢除) | 必要 | 無 | 

## Okta 應用程式名稱
<a name="jdbc-v3-driver-okta-application-name"></a>

Okta 應用程式的名稱。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| OktaAppName | App\$1Name (已廢除) | 必要 | 無 | 

## Okta MFA 類型
<a name="jdbc-v3-driver-okta-mfa-type"></a>

如果您已將 Okta 設定為需要多重要素驗證 (MFA)，則需要根據您要使用的第二要素指定 Okta MFA 類型和其他參數。

Okta MFA 類型是用以透過 Okta 進行身分驗證的第二身分驗證要素類型 (在密碼之後)。支援的第二要素包括透過 Okta Verify 應用程式傳送的推送通知以及由 Okta Verify、Google Authenticator 生成的或透過簡訊發送的臨時一次性密碼 (TOTP)。個別組織安全政策會判斷使用者登入是否需要 MFA。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 可能的值 | 
| --- | --- | --- | --- | --- | 
| OktaMfaType | okta\$1mfa\$1type (已廢除) | 如果將 Okta 設定為需要 MFA，則為必要 | 無 | oktaverifywithpush, oktaverifywithtotp, googleauthenticator, smsauthentication | 

## Okta 電話號碼
<a name="jdbc-v3-driver-okta-phone-number"></a>

選擇 `smsauthentication` MFA 類型時，Okta 將使用簡訊將臨時一次性密碼傳送到的電話號碼。該電話號碼必須是美國或加拿大的電話號碼。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| OktaPhoneNumber | okta\$1phone\$1number (已廢除) | 如果 OktaMfaType 為 smsauthentication，則為必要 | 無 | 

## Okta MFA 等待時間
<a name="jdbc-v3-driver-okta-mfa-wait-time"></a>

在驅動程式擲出逾時例外狀況之前，等待使用者確認來自 Okta 的推送通知的持續時間 (以秒為單位)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| OktaMfaWaitTime | okta\$1mfa\$1wait\$1time (已廢除) | 選用 | 60 | 

## 偏好的角色
<a name="jdbc-v3-driver-okta-preferred-role"></a>

要擔任之角色的 Amazon Resource Name (ARN)。如需有關 ARN 角色的資訊，請參閱《AWS Security Token Service API 參考》**中的 [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (已廢除) | 選用 | 無 | 

## 角色工作階段持續時間
<a name="jdbc-v3-driver-role-okta-session-duration"></a>

角色工作階段的持續時間 (以秒為單位)。如需詳細資訊，請參閱《AWS Security Token Service API 參考》**中的 [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (已廢除) | 選用 | 3600 | 

## Lake Formation 啟用
<a name="jdbc-v3-driver-okta-lake-formation-enabled"></a>

指定是否使用 [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) Lake Formation API 動作來擷取臨時 IAM 憑證，而非 [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) AWS STS API 動作。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | 無 | 選用 | FALSE | 

# Ping 憑證
<a name="jdbc-v3-driver-ping-credentials"></a>

SAML 型身分驗證機制，可讓您使用 Ping Federate 身分提供者向 Athena 進行身分驗證。此方法假設已經在 Athena 和 Ping Federate 之間設定了聯合。

## 憑證提供者
<a name="jdbc-v3-driver-ping-credentials-provider"></a>

將用來驗證對 AWS的請求的憑證提供者。將此參數的值設為 `Ping`。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 將使用的值 | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (已廢除) | 必要 | 無 | Ping | 

## 使用者
<a name="jdbc-v3-driver-ping-user"></a>

Ping Federate 使用者的電子郵件地址，用於透過 Ping Federate 進行身分驗證。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| 使用者 | UID (已廢除) | 必要 | 無 | 

## 密碼
<a name="jdbc-v3-driver-ping-password"></a>

Ping Federate 使用者的密碼。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| 密碼 | PWD (已廢除) | 必要 | 無 | 

## PingHostName
<a name="jdbc-v3-driver-ping-host-name"></a>

Ping 伺服器的地址。若要尋找您的地址，請造訪下列 URL 並檢視 **SSO 應用程式端點**欄位。

```
https://your-pf-host-#:9999/pingfederate/your-pf-app#/spConnections
```


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| PingHostName | IdP\$1Host (已廢除) | 必要 | 無 | 

## PingPortNumber
<a name="jdbc-v3-driver-ping-port-number"></a>

用於連線至 IdP 主機的連接埠號碼。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| PingPortNumber | IdP\$1Port (已廢除) | 必要 | 無 | 

## PingPartnerSpId
<a name="jdbc-v3-driver-ping-partner-spid"></a>

服務提供者地址。若要尋找服務提供者地址，請造訪下列 URL 並檢視 **SSO 應用程式端點**欄位。

```
https://your-pf-host-#:9999/pingfederate/your-pf-app#/spConnections
```


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
|  PingPartnerSpId  | Partner\$1SPID (已廢除) | 必要 | 無 | 

## 偏好的角色
<a name="jdbc-v3-driver-ping-preferred-role"></a>

要擔任之角色的 Amazon Resource Name (ARN)。如需有關 ARN 角色的資訊，請參閱《AWS Security Token Service API 參考》**中的 [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (已廢除) | 選用 | 無 | 

## 角色工作階段持續時間
<a name="jdbc-v3-driver-role-ping-session-duration"></a>

角色工作階段的持續時間 (以秒為單位)。如需詳細資訊，請參閱《AWS Security Token Service API 參考》**中的 [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (已廢除) | 選用 | 3600 | 

## Lake Formation 啟用
<a name="jdbc-v3-driver-ping-lake-formation-enabled"></a>

指定是否使用 [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) Lake Formation API 動作來擷取臨時 IAM 憑證，而非 [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) AWS STS API 動作。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | 無 | 選用 | FALSE | 

# AD FS 憑證
<a name="jdbc-v3-driver-adfs-credentials"></a>

SAML 型身分驗證機制，可讓您使用 Microsoft Active Directory Federation Services (AD FS) 向 Athena 進行身分驗證。此方法假設使用者已經在 Athena 和 AD FS 之間設定了聯合。

## 憑證提供者
<a name="jdbc-v3-driver-adfs-credentials-credentials-provider"></a>

將用來驗證對 AWS的請求的憑證提供者。將此參數的值設為 `ADFS`。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 將使用的值 | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (已廢除) | 必要 | 無 | ADFS | 

## 使用者
<a name="jdbc-v3-driver-adfs-credentials-user"></a>

AD FS 使用者的電子郵件地址，用來透過 AD FS 進行身分驗證。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| 使用者 | UID (已廢除) | 表單型身分驗證的必要項目。Windows 整合式身分驗證的選用項目。 | 無 | 

## 密碼
<a name="jdbc-v3-driver-adfs-credentials-password"></a>

AD FS 使用者的密碼。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| 密碼 | PWD (已廢除) | 表單型身分驗證的必要項目。Windows 整合式身分驗證的選用項目。 | 無 | 

## ADFS 主機名稱
<a name="jdbc-v3-driver-adfs-credentials-adfshostname"></a>

AD FS 伺服器的地址。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| AdfsHostName | IdP\$1Host (已廢除) | 必要 | 無 | 

## ADFS 連接埠號碼
<a name="jdbc-v3-driver-adfs-credentials-adfsportnumber"></a>

用於連線至 AD FS 伺服器的連接埠號碼。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| AdfsPortNumber | IdP\$1Port (已廢除) | 必要 | 無 | 

## ADFS 依賴方
<a name="jdbc-v3-driver-adfs-credentials-adfsrelyingparty"></a>

可信依賴方。使用此參數來覆寫 AD FS 依賴方端點 URL。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| AdfsRelyingParty | LoginToRP (已廢除) | 選用 | urn:amazon:webservices | 

## ADFS WIA 啟用
<a name="jdbc-v3-driver-adfs-credentials-adfswiaenabled"></a>

布林值。使用此參數來啟用具有 AD FS 的 Windows 整合式身分驗證 (WIA)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| AdfsWiaEnabled | none | 選用 | FALSE | 

## 偏好的角色
<a name="jdbc-v3-driver-adfs-credentials-preferred-role"></a>

要擔任之角色的 Amazon Resource Name (ARN)。如需有關 ARN 角色的資訊，請參閱《AWS Security Token Service API 參考**》中的 [https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (已廢除) | 選用 | 無 | 

## 角色工作階段持續時間
<a name="jdbc-v3-driver-adfs-credentials-role-session-duration"></a>

角色工作階段的持續時間 (以秒為單位)。如需詳細資訊，請參閱 *AWS Security Token Service API 參考*中的 [https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (已廢除) | 選用 | 3600 | 

## Lake Formation 啟用
<a name="jdbc-v3-driver-adfs-credentials-lake-formation-enabled"></a>

指定是否使用 [https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) Lake Formation API 動作來擷取臨時 IAM 登入資料，而非 [https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) AWS STS API 動作。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | none | 選用 | FALSE | 

# 瀏覽器 Azure AD 憑證
<a name="jdbc-v3-driver-browser-azure-ad-credentials"></a>

瀏覽器 Azure AD 是 SAML 型身分驗證機制，可與 Azure AD 身分提供者搭配使用並支援多重因素認證。與標準 Azure AD 身分驗證不同，此機制不需要連線參數中的使用者名稱、密碼或用戶端密碼。如同標準 Azure AD 身分驗證機制，瀏覽器 Azure AD 也會假設使用者已經設定了 Athena 與 Azure AD 之間的聯合。

## 憑證提供者
<a name="jdbc-v3-driver-browser-azure-ad-credentials-provider"></a>

將用來驗證對 AWS的請求的憑證提供者。將此參數的值設為 `BrowserAzureAD`。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 將使用的值 | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (已廢除) | 必要 | 無 | BrowserAzureAD | 

## Azure AD 租用戶 ID
<a name="jdbc-v3-driver-browser-azure-ad-azure-ad-tenant-id"></a>

Azure AD 應用程式的租用戶 ID


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| AzureAdTenantId | tenant\$1id (已廢除) | 必要 | 無 | 

## Azure AD 用戶端 ID
<a name="jdbc-v3-driver-browser-azure-ad-azure-ad-client-id"></a>

Azure AD 應用程式的用戶端 ID


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| AzureAdClientId | client\$1id (已廢除) | 必要 | 無 | 

## 識別提供者回應逾時
<a name="jdbc-v3-driver-identity-provider-response-timeout"></a>

驅動程式停止等待來自 Azure AD 之 SAML 回應之前的持續時間 (以秒為單位)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| IdpResponseTimeout | idp\$1response\$1timeout (已廢除) | 選用 | 120 | 

## 偏好的角色
<a name="jdbc-v3-driver-browser-azure-ad-preferred-role"></a>

要擔任之角色的 Amazon Resource Name (ARN)。如需有關 ARN 角色的資訊，請參閱《AWS Security Token Service API 參考》**中的 [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (已廢除) | 選用 | 無 | 

## 角色工作階段持續時間
<a name="jdbc-v3-driver-browser-azure-ad-role-session-duration"></a>

角色工作階段的持續時間 (以秒為單位)。如需詳細資訊，請參閱《AWS Security Token Service API 參考》**中的 [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (已廢除) | 選用 | 3600 | 

## Lake Formation 啟用
<a name="jdbc-v3-driver-browser-azure-ad-lake-formation-enabled"></a>

指定是否使用 [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) Lake Formation API 動作來擷取臨時 IAM 憑證，而非 [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) AWS STS API 動作。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | 無 | 選用 | FALSE | 

# 瀏覽器 SAML 憑證
<a name="jdbc-v3-driver-browser-saml-credentials"></a>

瀏覽器 SAML 是一般身分驗證外掛程式，可與 SAML 型身分提供者搭配使用並支援多重因素認證。

## 憑證提供者
<a name="jdbc-v3-driver-browser-saml-credentials-provider"></a>

將用來驗證對 AWS的請求的憑證提供者。將此參數的值設為 `BrowserSaml`。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 將使用的值 | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (已廢除) | 必要 | 無 | BrowserSaml | 

## 單一登入登入 URL
<a name="jdbc-v3-driver-single-sign-on-login-url"></a>

您的應用程式在 SAML 型身分提供者上的單一登入 URL。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| SsoLoginUrl | login\$1url (已廢除) | 必要 | 無 | 

## 接聽連接埠
<a name="jdbc-v3-driver-listen-port"></a>

用來接聽 SAML 回應的連接埠號碼。此值應與您設定 SAML 型身分提供者所使用的 URL 相符 (例如，`http://localhost:7890/athena`)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| ListenPort | listen\$1port (已廢除) | 選用 | 7890 | 

## 識別提供者回應逾時
<a name="jdbc-v3-driver-single-sign-on-login-url-identity-provider-response-timeout"></a>

驅動程式停止等待來自 Azure AD 之 SAML 回應之前的持續時間 (以秒為單位)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| IdpResponseTimeout | idp\$1response\$1timeout (已廢除) | 選用 | 120 | 

## 偏好的角色
<a name="jdbc-v3-driver-single-sign-on-login-url-preferred-role"></a>

要擔任之角色的 Amazon Resource Name (ARN)。如需有關 ARN 角色的資訊，請參閱《AWS Security Token Service API 參考》**中的 [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| PreferredRole | preferred\$1role (已廢除) | 選用 | 無 | 

## 角色工作階段持續時間
<a name="jdbc-v3-driver-single-sign-on-login-url-role-session-duration"></a>

角色工作階段的持續時間 (以秒為單位)。如需詳細資訊，請參閱《AWS Security Token Service API 參考》**中的 [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| RoleSessionDuration | Duration (已廢除) | 選用 | 3600 | 

## Lake Formation 啟用
<a name="jdbc-v3-driver-single-sign-on-login-url-lake-formation-enabled"></a>

指定是否使用 [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) Lake Formation API 動作來擷取臨時 IAM 憑證，而非 [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) AWS STS API 動作。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| LakeFormationEnabled | 無 | 選用 | FALSE | 

# DataZone IdC 憑證提供者
<a name="jdbc-v3-driver-datazone-idc"></a>

身分驗證機制，可讓您使用 IAM Identity Center 連線至 Athena 中的 DataZone 管理的資料。

## 憑證提供者
<a name="jdbc-v3-driver-datazone-idc-credentials-provider"></a>

將用來驗證對 AWS的請求的憑證提供者。將此參數的值設為 `DataZoneIdc`。請注意，`AWSCredentialsProviderClass` 別名已廢除；請改用 `CredentialsProvider` 參數名稱。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 將使用的值 | 
| --- | --- | --- | --- | --- | 
| CredentialsProvider | AWSCredentialsProviderClass (已廢除) | 必要 | 無 | DataZoneIdc | 

## DataZone 網域識別碼
<a name="jdbc-v3-driver-datazone-idc-datazone-domain-identifier"></a>

要使用的 DataZone 網域識別碼。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| DataZoneDomainId | 無 | 必要 | 無 | 

## DataZone 環境識別碼
<a name="jdbc-v3-driver-datazone-idc-datazone-environment-identifier"></a>

要使用的 DataZone 環境識別碼。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| DataZoneEnvironmentId | 無 | 必要 | 無 | 

## DataZone 網域區域
<a name="jdbc-v3-driver-datazone-idc-datazone-domain-region"></a>

佈建 DataZone 網域 AWS 區域 的 。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| DataZoneDomainRegion | 無 | 必要 | 無 | 

## 區域
<a name="jdbc-v3-driver-datazone-idc-region"></a>

佈建 DataZone 環境和 Athena 工作群組 AWS 區域 的 。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| 區域 | 無 | 必要 | 無 | 

## IAM Identity Center 發行者 URL
<a name="jdbc-v3-driver-datazone-idc-iam-identity-center-issuer-url"></a>

DataZone 網域使用的 IAM Identity Center 執行個體的發行者 URL。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| IdentityCenterIssuerUrl | 無 | 必要 | 無 | 

## DataZone 端點覆寫
<a name="jdbc-v3-driver-datazone-idc-datazone-endpoint-override"></a>

要使用的 DataZone API 端點，而不是提供的 AWS 區域的預設值。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| DataZoneEndpointOverride | 無 | 選用 | 無 | 

## 啟用權杖快取
<a name="jdbc-v3-driver-datazone-idc-enable-token-caching"></a>

啟用時，允許在不同的驅動器連線之間使用相同的 IAM Identity Center 存取權杖。這可避免建立多個驅動器連線的 SQL 工具啟動多個瀏覽器視窗。如果您啟用此參數，我們建議您在使用 SQL 工具清除權杖快取後立即將其關閉，並需要重新進行身分驗證。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| EnableTokenCaching | 無 | 選用 | FALSE | 

## 接聽連接埠
<a name="jdbc-v3-driver-datazone-idc-listen-port"></a>

接聽 IAM Identity Center 回應的連接埠號碼。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| ListenPort | 無 | 選用 | 8000 | 

## 身分提供者回應逾時
<a name="jdbc-v3-driver-datazone-idc-identity-provider-response-time-out"></a>

驅動器停止等待來自 IAM Identity Center 回應之前的持續時間 (以秒為單位)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| IdpResponseTimeout | 無 | 選用 | 120 | 

# DataZone IAM 憑證提供者
<a name="jdbc-v3-driver-datazone-iamcp"></a>

身分驗證機制，可使用 IAM 憑證連線到 Athena 中的 DataZone 受管理的資料。

## DataZone 網域識別碼
<a name="jdbc-v3-driver-datazone-iamcp-datazone-domain-identifier"></a>

要使用的 DataZone 網域識別碼。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| DataZoneDomainId | 無 | 必要 | 無 | 

## DataZone 環境識別碼
<a name="jdbc-v3-driver-datazone-iamcp-datazone-environment-identifier"></a>

要使用的 DataZone 環境識別碼。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| DataZoneEnvironmentId | 無 | 必要 | 無 | 

## DataZone 網域區域
<a name="jdbc-v3-driver-datazone-iamcp-datazone-domain-region"></a>

佈建 DataZone 網域 AWS 區域 的 。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| DataZoneDomainRegion | 無 | 必要 | 無 | 

## DataZone 端點覆寫
<a name="jdbc-v3-driver-datazone-iamcp-datazone-endpoint-override"></a>

要使用的 DataZone API 端點，而不是提供的 AWS 區域的端點預設值。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| DataZoneEndpointOverride | 無 | 選用 | 無 | 

## 使用者
<a name="jdbc-v3-driver-datazone-iamcp-user"></a>

您的 AWS 存取金鑰 ID。如需有關存取金鑰的詳細資訊，請參閱《IAM 使用者指南**》中的 [AWS 安全憑證](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| 使用者 | AccessKeyId | 選用 | 無 | 

## 密碼
<a name="jdbc-v3-driver-datazone-iamcp-password"></a>

您的 AWS 私密金鑰 ID。如需有關存取金鑰的詳細資訊，請參閱《IAM 使用者指南**》中的 [AWS 安全憑證](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html)。


****  

| 參數名稱 | Alias (別名) | 參數類型 | 預設值 | 
| --- | --- | --- | --- | 
| 密碼 | SecretAccessKey | 選用 | 無 | 

# 其他 JDBC 3.x 組態
<a name="jdbc-v3-driver-other-configuration"></a>

下列各節說明 JDBC 3.x 驅動程式的其他組態設定。

## 網路逾時
<a name="jdbc-v3-driver-network-timeout"></a>

網路逾時可控制驅動器等待建立網路連線的時間量 (以毫秒為單位)。這包括傳送 API 請求所需的時間。在此時間之後，驅動程式會擲出逾時例外狀況。在極少數情況下，變更網路逾時可能會非常實用。例如，您可能想要增加長時間垃圾回收暫停的逾時。

要進行設定，請在 JDBC `Connection` 物件上呼叫 `setNetworkTimeout` 方法。此值可以在 JDBC 連線的生命週期中變更。如需詳細資訊，請參閱 Oracle JDBC API 文件中的 [setNetworkTimeout](https://docs.oracle.com/javase/8/docs/api/java/sql/Connection.html#setNetworkTimeout-java.util.concurrent.Executor-int-)。使用 `setNetworkTimeout` 方法等同於設定 [網路逾時](jdbc-v3-driver-advanced-connection-parameters.md#jdbc-v3-driver-networktimeoutmillis) 連線參數。

下列範例會將網路逾時設定為 5000 毫秒。

```
...
AthenaDriver driver = new AthenaDriver();
Connection connection = driver.connect(url, connectionParameters);
connection.setNetworkTimeout(null, 5000);
...
```

## 查詢逾時
<a name="jdbc-v3-driver-query-timeout"></a>

提交查詢之後，驅動程式會在 Athena 上等待查詢完成的時間量，以秒為單位。在此時間之後，驅動程式會嘗試取消提交的查詢並擲出逾時例外狀況。

查詢逾時無法設定為連線參數。要進行設定，請在 JDBC `Statement` 物件上呼叫 `setQueryTimeout` 方法。這個值可以在 JDBC 陳述式的生命週期中變更。此參數的預設值為 `0` (零)。值 `0` 表示查詢可以執行直到完成 (受限於 [Service Quotas](service-limits.md))。

下列範例會將查詢逾時設定為 5 秒。

```
...
AthenaDriver driver = new AthenaDriver();
Connection connection = driver.connect(url, connectionParameters);
Statement statement = connection.createStatement();
statement.setQueryTimeout(5);
...
```

# Amazon Athena JDBC 3.x 版本備註
<a name="jdbc-v3-driver-release-notes"></a>

這些版本備註詳細說明了 Amazon Athena JDBC 3.x 驅動器中改進和修正。

## 3.7.0
<a name="jdbc-v3-driver-release-notes-2025-11-21"></a>

 版 2025-11-21

### 改進
<a name="jdbc-v3-driver-release-notes-2025-11-21-improvements"></a>
+ **瀏覽器 OIDC 可信任身分傳播身分身分驗證外掛程式** – 新增了新的身分驗證外掛程式，可使用 OpenID Connect (OIDC) 身分提供者進行無縫的瀏覽器型身分驗證。此外掛程式會透過預設瀏覽器處理完整的 OAuth 2.0 流程、自動擷取 JSON Web Token (JWT)，並與信任的身分傳播整合。它專為單一使用者桌面環境而設計，相較於手動 JWT 處理，可提供更簡化的身分驗證體驗。如需受信任身分傳播的詳細資訊，請參閱[什麼是受信任身分傳播？](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation-overview.html)。

### 修正項目
<a name="jdbc-v3-driver-release-notes-2025-11-21-fixes"></a>
+ **增強型時間戳記精確度支援** – 驅動程式現在完全支援從 Athena 查詢透過 `getTimestamp()`方法傳回的時間戳記值中的毫秒和奈秒精確度。
+ **改善複雜類型處理** – 修正在 `DatabaseMetaData#getColumns`和一般中繼資料操作中剖析巢狀資料類型 （陣列、結構和映射） 的問題，確保複雜資料結構的類型資訊準確。
+ **增強型錯誤記錄** – 改善 S3 中繼資料擷取失敗的記錄，提供更清楚的錯誤訊息和更好的診斷資訊。

## 3.6.0
<a name="jdbc-v3-driver-release-notes-2025-09-10"></a>

 版 2025-09-10

### 改進
<a name="jdbc-v3-driver-release-notes-2025-09-10-improvements"></a>
+ **JWT 可信身分傳播身分驗證外掛程式** – 新增了新的身分驗證外掛程式，可支援 JWT 可信身分傳播與 JDBC 驅動器的整合。此身分驗證類型允許您使用從外部身分提供者獲得的 JSON Web Token (JWT) 作為連線參數，向 Athena 進行身分驗證。透過受信任的身分傳播，身分內容會新增至 IAM 角色，以識別請求存取 AWS 資源的使用者。如需有關啟用和使用可信身分傳播的資訊，請參閱[什麼是可信身分傳播？](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation-overview.html)。
+ **自訂 SSO OIDC 和 SSO 管理員端點支援** – 新增對 JDBC 驅動器中自訂 SSO OIDC 和 SSO 管理員端點的支援。此增強功能可讓您在 VPC 後方執行 JDBC 時，為 SSO 服務指定自己的端點。
+ **AWS 開發套件版本更新** – 我們已將驅動程式中使用的 AWS 開發套件版本更新至 2.32.16，並已更新 3.6.0 版的專案相依性。

## 3.5.1
<a name="jdbc-v3-driver-release-notes-2025-07-17"></a>

 版 2025-07-17

### 改進
<a name="jdbc-v3-driver-release-notes-2025-07-17-improvements"></a>
+ **記錄功能** – 將日誌層級提升為 `INFO` 並新增資料列計數、位移和物件長度的指標，進而增強 S3 擷取記錄。實作了連線生命週期追蹤，並對整體記錄效能進行了最佳化。
+ **特殊字元處理** – 改善了對結構描述和目錄名稱中 `LIKE` 模式的特殊字元的處理。
+ **連線狀態管理** – 改善了連線狀態管理，即藉由在連線關閉後防止 API 呼叫，以及在關閉期間新增查詢操作的安全檢查，進而避免潛在錯誤。

### 修正項目
<a name="jdbc-v3-driver-release-notes-2025-07-17-fixes"></a>
+ **DDL 查詢中繼資料** – 修正了 DDL 查詢中繼資料處理的 `NoSuchKeyFound` 問題。

## 3.5.0
<a name="jdbc-v3-driver-release-notes-2025-03-18"></a>

2025-03-18 發布

### 改進
<a name="jdbc-v3-driver-release-notes-2025-03-18-improvements"></a>
+ **結果組態參數** – 新增了對兩個新連線參數 `ExpectedBucketOwner` 和 `AclOption` 的支援。如需詳細資訊，請參閱[結果組態參數](jdbc-v3-driver-advanced-connection-parameters.md#jdbc-v3-driver-result-config)。
+ **AWS SDK 版本** – 驅動程式中使用的 AWS SDK 版本已更新至 2.30.22。

## 3.4.0
<a name="jdbc-v3-driver-release-notes-2025-02-18"></a>

2025-02-18 發布

### 改進
<a name="jdbc-v3-driver-release-notes-2025-02-18-improvements"></a>
+ **結果擷取程式** – 驅動器現在會自動選取下載查詢結果的最快速方法。如此一來，在大多數情況下都無需手動設定擷取程式。如需詳細資訊，請參閱[結果擷取參數](jdbc-v3-driver-advanced-connection-parameters.md#jdbc-v3-driver-result-fetching-parameters)。

### 修正項目
<a name="jdbc-v3-driver-release-notes-2025-02-18-fixes"></a>
+ **ResultSet** – 驅動器現在能夠逐一處理在 S3 上不會產生結果物件的 DDL 陳述式結果集。當 `GetQueryResultsStream` 傳回完全空白的頁面時，它也會傳回空的 `ResultSet` 物件，而不是 null。
+ **ResultsStream** – 結果串流已透過移除不必要的呼叫來進行最佳化，進而計算內部緩衝區中的資料列數。
+ **getTables** – 已根據 `ListTableMetadata` 和 `GetTableMetadata` 回應處理資料表類型，進而最佳化 `GetTables` 呼叫。

## 3.3.0
<a name="jdbc-v3-driver-release-notes-2024-10-30"></a>

 版 2024-10-30

### 改進
<a name="jdbc-v3-driver-release-notes-2024-10-30-improvements"></a>
+ **DataZone 身分驗證** – 新增了對 DataZone 身分驗證外掛程式 `DataZoneIdC` 和 `DataZoneIAM` 的支援。如需詳細資訊，請參閱[DataZone IdC 憑證提供者](jdbc-v3-driver-datazone-idc.md)及[DataZone IAM 憑證提供者](jdbc-v3-driver-datazone-iamcp.md)。
+ **網路逾時** – 現在可以使用 `NetworkTimeoutMillis` 連線參數設定網路逾時。先前，其只能在 `Connection` 物件本身上設定。如需詳細資訊，請參閱[網路逾時](jdbc-v3-driver-other-configuration.md#jdbc-v3-driver-network-timeout)。

### 修正項目
<a name="jdbc-v3-driver-release-notes-2024-10-30-fixes"></a>
+ **S3 空物件處理** – 驅動器現在能在 S3 擷取程式中處理空物件，而不是擲回 Amazon S3 Range Not Satisfiable 例外狀況。
+ **記錄** – 驅動器不會再記錄查詢執行 [...] 請求的訊息項目，但訂閱會在取用查詢結果後取消這則訊息。
+ **空的參數字串** – 驅動器現在能處理連線參數中存在的空字串，就好像參數不存在一樣。這樣一來，即可解決某些 BI 工具因不小心傳遞空字串而導致意外身分驗證嘗試時發生的問題。

## 3.2.2
<a name="jdbc-v3-driver-release-notes-2024-07-29"></a>

 版 2024-07-29

### 改進
<a name="jdbc-v3-driver-release-notes-2024-07-29-improvements"></a>
+ **資料類型映射** – 透過變更驅動器將 `tinyint`、`smallint`、`row` 和 `struct` 資料類型映射至 Java 物件的方式，提高了對 JDBC 規範的合規性。
+ **AWS SDK 版本更新** – AWS 驅動程式中使用的 SDK 版本已更新至 2.26.23。

### 修正項目
<a name="jdbc-v3-driver-release-notes-2024-07-29-fixes"></a>
+ **註解** – 修正了陳述式結尾的行註解問題。
+ **資料庫清單** – 修正了下列問題：當分頁 `ListDatabases` API 傳回的最後一頁為空白時，列出資料庫可能會進入無限迴圈。

## 3.2.1
<a name="jdbc-v3-driver-release-notes-2024-07-03"></a>

 版 2024-07-03

### 改進
<a name="jdbc-v3-driver-release-notes-2024-07-03-improvements"></a>
+ **JWT 憑證提供者** – 新增了對使用者指定的工作階段持續時間的支援。如需詳細資訊，請參閱[角色工作階段持續時間](jdbc-v3-driver-jwt-credentials.md#jdbc-v3-driver-jwt-role-session-duration)。

### 修正項目
<a name="jdbc-v3-driver-release-notes-2024-07-03-fixes"></a>
+ **執行緒集區** – 針對非同步任務，已為每個連線建立一個 `ThreadPoolExecutor`，進而避免使用 `ForkJoin` 集區。
+ **憑證提供者** – 現在會剖析代理主機，以便在為外部 IdP 設定 HTTP 用戶端時取得結構描述和主機。
+ **預設憑證提供者** – 確保用戶端程式碼無法關閉預設憑證提供者。
+ **getColumns** – 修正了 `DatabaseMetaData#getColumns` 方法中的 `ORDINAL_COLUMN` 資料欄屬性問題。
+ **ResultSet** – 新增了對 `Infinity`、`-Infinity`、`NaN` 和 `ResultSet.` 的支援，修正了目錄操作傳回的資料欄類型與已完成查詢的結果集之間的差異。

## 3.2.0
<a name="jdbc-v3-driver-release-notes-2024-02-26"></a>

2024-04-26 發布

### 改進
<a name="jdbc-v3-driver-release-notes-2024-02-26-improvements"></a>
+ **目錄操作效能** – 對於不使用萬用字元的目錄操作，其效能有所提升。
+ **輪詢間隔下限變更** – 已修改輪詢間隔下限預設值，以減少驅動器對 Athena 發出的 API 呼叫次數。仍能盡快偵測到查詢完成。
+ **BI 工具可探索性** – 商業智慧工具能更輕鬆地探索到驅動器。
+ **資料類型映射** – 已改善 Athena `binary`、`array` 和 `struct` DDL 資料類型的資料類型映射。
+ **AWS SDK 版本** – 驅動程式中使用的 AWS SDK 版本已更新至 2.25.34。

### 修正項目
<a name="jdbc-v3-driver-release-notes-2024-02-26-fixes"></a>
+ **聯合目錄資料表清單** – 修正了導致聯合目錄傳回空白資料表清單的問題。
+ **getSchemas** – 修正了導致 JDBC [DatabaseMetaData\$1getSchemas](https://docs.oracle.com/javase/8/docs/api/java/sql/DatabaseMetaData.html#getSchemas--) 方法僅從預設目錄而非所有目錄擷取資料庫的問題。
+ **getColumns** – 修正了使用 Null 目錄名稱呼叫 JDBC [DatabaseMetaData\$1getColumns](https://docs.oracle.com/javase/8/docs/api/java/sql/DatabaseMetaData.html#getColumns-java.lang.String-java.lang.String-java.lang.String-java.lang.String-) 方法時，導致傳回 Null 目錄的問題。

## 3.1.0
<a name="jdbc-v3-driver-release-notes-2024-02-15"></a>

2024-02-15 發布

### 改進
<a name="jdbc-v3-driver-release-notes-2024-02-15-improvements"></a>
+ 對 Microsoft Active Directory Federation Services (AD FS) Windows 整合式身分驗證和表單型身分驗證的支援。
+ 為了與 2.x 版保持回溯相容，現在接受 `awsathena` JDBC 子通訊協定，但會產生廢除警告。請改用 `athena` JDBC 子通訊協定。
+ `AwsDataCatalog` 現在是目錄參數的預設值，而 `default` 是資料庫參數的預設值。這些變更可確保傳回目前目錄和資料庫的正確值，而不是 Null。
+ 為了符合 JDBC 規格，`IS_AUTOINCREMENT` 和 `IS_GENERATEDCOLUMN` 現在會傳回空字串，而不是 `NO`。
+ Athena `int` 資料類型現在會映射至與 Athena 相同的 JDBC 類型 `integer`，而不是 `other`。
+ 當 Athena 的資料欄中繼資料不包含選用 `precision` 和 `scale` 欄位時，驅動器現在會針對 `ResultSet` 資料欄中的對應值傳回零。
+  AWS SDK 版本已更新至 2.21.39。

### 修正項目
<a name="jdbc-v3-driver-release-notes-2024-02-15-fixes"></a>
+ 修正了與 `GetQueryResultsStream` 相關的問題，即當 Athena 的純文字結果資料欄計數與 Athena 結果中繼資料中的資料欄計數不一致時，會發生例外狀況。

## 3.0.0
<a name="jdbc-v3-driver-release-notes-2023-11-16"></a>

 版 2023-11-16

Athena JDBC 3.x 驅動器是新一代的驅動器，可提供更好的效能和相容性。JDBC 3.x 驅動器支援直接從 Amazon S3 讀取查詢結果，從而可提升應用程式的效能，其中這些應用程式會耗用大量查詢結果。新的驅動器降低了第三方相依性，因此可以更輕鬆地整合 BI 工具與自訂應用程式。

# 舊版 Athena JDBC 3.x 驅動器
<a name="jdbc-v3-driver-previous-versions"></a>

強烈建議您使用[最新版本](jdbc-v3-driver.md)的 JDBC 3.x 驅動器。最新版本的驅動器包含最新的改善和修正。僅當您的應用程式與最新版本不相容時，才會使用較舊版本。

## JDBC 驅動程式 uber jar
<a name="jdbc-v3-driver-download-uber-jar-previous"></a>

下面的下載將驅動程式及其所有相依性包在同一個 `.jar` 檔案中。此下載通常用於第三方 SQL 用戶端。
+ [3.6.0 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.6.0/athena-jdbc-3.6.0-with-dependencies.jar)
+ [3.5.1 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.5.1/athena-jdbc-3.5.1-with-dependencies.jar)
+ [3.5.0 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.5.0/athena-jdbc-3.5.0-with-dependencies.jar)
+ [3.4.0 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.4.0/athena-jdbc-3.4.0-with-dependencies.jar)
+ [3.3.0 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.3.0/athena-jdbc-3.3.0-with-dependencies.jar)
+ [3.2.2 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.2/athena-jdbc-3.2.2-with-dependencies.jar)
+ [3.2.1 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.1/athena-jdbc-3.2.1-with-dependencies.jar)
+ [3.2.0 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.0/athena-jdbc-3.2.0-with-dependencies.jar)
+ [3.1.0 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.1.0/athena-jdbc-3.1.0-with-dependencies.jar)
+ [3.0.0 uber jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.0.0/athena-jdbc-3.0.0-with-dependencies.jar)

## JDBC 驅動程式 lean jar
<a name="jdbc-v3-driver-download-lean-jar"></a>

下面的下載是一個 `.zip` 檔案，其中包含驅動程式的 lean `.jar` 和驅動程式相依性的單獨 `.jar` 檔案。此下載通常用於可能具有相依性與驅動程式使用的相依性衝突的自訂應用程式。如果您想選擇要包含在 lean jar 中的驅動程式相依性，以及要排除的驅動程式相依性 (如果您的自訂應用程式已包含一或多個驅動程式相依性)，則此下載非常有用。
+ [3.6.0 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.6.0/athena-jdbc-3.6.0-lean-jar-and-separate-dependencies-jars.zip)
+ [3.5.1 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.5.1/athena-jdbc-3.5.1-lean-jar-and-separate-dependencies-jars.zip)
+ [3.5.0 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.5.0/athena-jdbc-3.5.0-lean-jar-and-separate-dependencies-jars.zip)
+ [3.4.0 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.4.0/athena-jdbc-3.4.0-lean-jar-and-separate-dependencies-jars.zip)
+ [3.3.0 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.3.0/athena-jdbc-3.3.0-lean-jar-and-separate-dependencies-jars.zip)
+ [3.2.2 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.2/athena-jdbc-3.2.2-lean-jar-and-separate-dependencies-jars.zip)
+ [3.2.1 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.1/athena-jdbc-3.2.1-lean-jar-and-separate-dependencies-jars.zip)
+ [3.2.0 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.0/athena-jdbc-3.2.0-lean-jar-and-separate-dependencies-jars.zip)
+ [3.1.0 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.1.0/athena-jdbc-3.1.0-lean-jar-and-separate-dependencies-jars.zip)
+ [3.0.0 lean jar](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.0.0/athena-jdbc-3.0.0-lean-jar-and-separate-dependencies-jars.zip)

# 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) 。使用此指南從舊版遷移到目前的版本。