# Athena JDBC 3.x ドライバー Athena JDBC ドライバーを使用し、多くのサードパーティ SQL クライアントツールおよびカスタムアプリケーションから Amazon Athena に接続できます。 ## システム要件 + Java 8 (またはそれ以降) のランタイム環境 + 最低 20 MB の空きディスク容量。 ## 考慮事項と制限事項 次の内容では、Athena JDBC 3.x ドライバーの考慮事項と制限事項の一部が示されます。 + **ログ** — 3.x ドライバーは [SLF4J](https://www.slf4j.org/manual.html) を使用します。これは、ランタイム時にいくつかのログシステムのいずれかを使用できるようにする抽象化レイヤーです。 + **暗号化** — `CSE_KMS` 暗号化オプションで Amazon S3 フェッチャーを使用するとき、Amazon S3 クライアントは Amazon S3 バケットに保存される結果を復号化できません。`CSE_KMS` 暗号化が必要な場合、ストリーミングフェッチャーを引き続き使用できます。Amazon S3 フェッチャーによる `CSE_KMS` 暗号化のサポートが計画されています。 ## JDBC 3.x ドライバーのダウンロード このセクションには、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 次のダウンロードは、ドライバーおよびそのすべての依存関係を同じ `.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 次のダウンロードには、ドライバー用の lean `.jar` およびドライバーの依存関係用の個別 `.jar` ファイルを含む `.zip` ファイルです。このダウンロードは、ドライバーが使用する依存関係と競合する依存関係を持つカスタムアプリケーションによく使用されます。このダウンロードは、ドライバーの依存関係のどっちを lean jar に含め、カスタムアプリケーションに既に 1 つ以上含まれている場合はどの依存関係を除外するかを選択する場合に便利です。 [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) ### ライセンス 次のリンクには、JDBC 3.x ドライバーの使用許諾契約が含まれています。 [License](https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.7.0/LICENSE.txt) ## JDBC での信頼できる ID の伝播 AWS Identity and Access Management Identity Center を通じて、シングルサインオン機能を備えた JDBC ドライバーを使用して Amazon Athena に接続できるようになりました。PowerBI、Tableau、DBeaver などのツールから Athena にアクセスすると、ID とアクセス許可が IAM Identity Center を介して Athena に自動的に伝播されます。詳細については、「[Amazon Athena ドライバーで信頼できる ID の伝播を使用する](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 での信頼できる ID の伝播](#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 ODBC 3.x リリースノート](jdbc-v3-driver-release-notes.md) + [以前のバージョンの Athena JDBC 3.x ドライバー](jdbc-v3-driver-previous-versions.md) # JDBC 3.x ドライバーの使用を開始する このセクションの情報を使用して 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) ## インストール手順 JDBC 3.x ドライバーは、カスタムアプリケーションまたはサードパーティの SQL クライアントで使用できます。 ### カスタムアプリケーションの場合 ドライバー jar とその依存関係を含む `.zip` ファイルをダウンロードします。依存関係にはそれぞれ独自の `.jar` ファイルがあります。ドライバー jar を依存関係としてカスタムアプリケーションに追加します。別のソースからアプリケーションにその依存関係を既に追加しているかどうかに基づいて、ドライバー jar の依存関係を選択的に追加します。 ### サードパーティ製 SQL クライアントの場合 ドライバーの uber jar ファイルをダウンロードし、サードパーティ SQL クライアントの指示に従ってそのクライアントに追加します。 ## ドライバーの実行 ドライバーを実行するには、カスタムアプリケーションまたはサードパーティの SQL クライアントを使用できます。 ### カスタムアプリケーションの場合 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 クライアントの場合 使用している SQL クライアントのマニュアルに従ってください。通常は、SQL クライアントのグラフィカルユーザーインターフェイスを使用してクエリを入力および送信します。クエリ結果は同じインターフェイスに表示されます。 ## ドライバーの設定 接続パラメータを使用して Amazon Athena JDBC ドライバーを設定できます。サポートされている接続パラメータについては、「[Amazon Athena JDBC 3.x 接続パラメータ](jdbc-v3-driver-connection-parameters.md)」を参照してください。 ### カスタムアプリケーションの場合 カスタムアプリケーションの JDBC ドライバーの接続パラメータを設定するには、次のいずれかの操作を行います。 + パラメータ名およびその値を `Properties` オブジェクトに追加します。`Connection#connect` を呼び出すとき、そのオブジェクトを URL と一緒に渡します。例については、[ドライバーの実行](#jdbc-v3-driver-running-the-driver) のサンプルの Java アプリケーションを参照してください。 + 接続文字列 (URL) では、次の形式を使用してパラメータ名およびその値をプロトコルプレフィックスの直後に追加します。 ``` =; ``` 次の例のように、各パラメーター名/パラメータ値のペアの末尾にはセミコロンを使用します。セミコロンの後には、空白を入れないでください。 ``` 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 クライアントの場合 使用している SQL クライアントの指示に従ってください。通常、クライアントはパラメータ名とその値を入力するグラフィカルユーザーインターフェイスを用意します。 ## Athena JDBC v2 ドライバーからのアップグレード JDBC バージョン 3 の接続パラメータのほとんどは、バージョン 2 (Simba) JDBC ドライバーとの下位互換性があります。つまり、バージョン 2 の接続文字列はバージョン 3 のドライバーで再利用できることを意味します。ただし、一部の接続パラメータは変更されています。これらの変更は本書で説明されています。バージョン 3 の JDBC ドライバーにアップグレードするときは、必要に応じて既存の設定を更新してください。 ### ドライバークラス 一部の BI ツールでは、JDBC ドライバー `.jar` ファイルからドライバークラスを指定するように求められます。ほとんどのツールはこのクラスを自動的に見つけます。バージョン 3 ドライバーのクラスの完全修飾名は `com.amazon.athena.jdbc.AthenaDriver` です。バージョン 2 ドライバーでは、クラスは `com.simba.athena.jdbc.Driver` でした。 ### 接続文字列 バージョン 3 ドライバーは、JDBC 接続文字列 URL の先頭にあるプロトコルに `jdbc:athena://` を使用します。バージョン 3 ドライバーはバージョン 2 プロトコル `jdbc:awsathena://` もサポートしていますが、バージョン 2 プロトコルの使用は非推奨になっています。定義されていない動作を避けるため、バージョン 3 は、バージョン 2 (または `jdbc:awsathena://` で始まる接続文字列を受け入れるその他のドライバー) が [DriverManager](https://docs.oracle.com/javase/8/docs/api/java/sql/DriverManager.html) クラスで登録されている場合、`jdbc:awsathena://` で始まる接続文字列を受け入れません。 ### 認証情報プロバイダー バージョン 2 ドライバーは、完全修飾名を使用してさまざまな認証情報プロバイダー (例: `com.simba.athena.amazonaws.auth.DefaultAWSCredentialsProviderChain`) を特定します。バージョン 3 ドライバーは短い名前 (例: `DefaultChain`) を使用します。新しい名前は、各認証情報プロバイダーの対応するセクションで説明されています。 以前の AWS SDK for Java から [AWSCredentialsProvider](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/AWSCredentialsProvider.html) インターフェイスを実装するのではなく、新しい AWS SDK for Java から [AwsCredentialsProvider](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/auth/credentials/AwsCredentialsProvider.html) インターフェイスを実装するには、バージョン 2 ドライバー用に作成されたカスタム認証情報プロバイダーをバージョン 3 ドライバー用に変更する必要があります。 `PropertiesFileCredentialsProvider` は、JDBC 3.x ドライバーではサポートされていません。このプロバイダーは JDBC 2.x ドライバーで使用されていましたが、サポート終了間近の AWS SDK for Java の以前のバージョンに属しています。JDBC 3.x ドライバーで同じ機能を実現するには、代わりに [AWS 設定プロファイルの認証情報](jdbc-v3-driver-aws-configuration-profile-credentials.md) プロバイダーを使用してください。 ### ログレベル 次のテーブルには、JDBC バージョン 2 とバージョン 3 のドライバーにある `LogLevel` パラメータの違いが示されています。 **** | JDBC ドライバーバージョン | パラメータ名 | パラメータタイプ | デフォルトの値 | 使用できる値 | 接続文字列の例 | | --- | --- | --- | --- | --- | --- | | v2 | LogLevel | オプションです。 | 0 | 0～6 | LogLevel=6; | | v3 | LogLevel | オプションです。 | TRACE | OFF、ERROR、WARN、INFO、DEBUG、TRACE | LogLevel=INFO; | ### クエリ ID の取得 バージョン 2 ドライバーでは、`Statement` インスタンスを `com.interfaces.core.IStatementQueryInfoProvider` にアンラップします。これは `#getPReparedQueryId` および `#getQueryId` の 2 つのメソッドを持つインターフェイスです。これらのメソッドを使用し、実行されたクエリのクエリ実行 ID を取得できます。 バージョン 3 ドライバーでは、`Statement`、`PreparedStatement`、`ResultSet` インスタンスを `com.amazon.athena.jdbc.AthenaResultSet` インターフェイスにアンラップします。このインターフェイスには `#getQueryExecutionId` という 1 つのメソッドがあります。 # Amazon Athena JDBC 3.x 接続パラメータ サポートされている接続パラメータはここで [基本的な接続パラメータ](jdbc-v3-driver-basic-connection-parameters.md)、[詳細接続パラメータ](jdbc-v3-driver-advanced-connection-parameters.md)、[認証接続パラメータ](jdbc-v3-driver-authentication-connection-parameters.md) の 3 つのセクションに分かれています。[詳細接続パラメータ] および [認証接続パラメータ] セクションには、関連するパラメータをまとめたサブセクションがあります。 **Topics** + [基本的な接続パラメータ](jdbc-v3-driver-basic-connection-parameters.md) + [詳細接続パラメータ](jdbc-v3-driver-advanced-connection-parameters.md) + [認証接続パラメータ](jdbc-v3-driver-authentication-connection-parameters.md) # 基本的な接続パラメータ 次のセクションでは、JDBC 3.x ドライバーの基本的な接続パラメータについて説明します。 ## リージョン クエリが実行される AWS リージョン。リージョンのリストについては、「[Amazon Athena エンドポイントとクォータ](https://docs.aws.amazon.com/general/latest/gr/athena.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | リージョン | AwsRegion (廃止) | 必須 (ただし、指定しない場合は [DefaultAwsRegionProviderChain](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/regions/providers/DefaultAwsRegionProviderChain.html) を使用して検索されます) | なし | ## カタログ ドライバーでアクセスされるデータベースおよびテーブルを含むカタログ。データカタログの詳細については、「[DataCatalog](https://docs.aws.amazon.com/athena/latest/APIReference/API_DataCatalog.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | カタログ | なし | オプションです。 | AwsDataCatalog | ## データベース クエリが実行されるデータベース。データベース名で明示的に修飾されていないテーブルは、このデータベースに解決されます。データベースの詳細については、「[Database](https://docs.aws.amazon.com/athena/latest/APIReference/API_Database.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | データベース | スキーマ | オプションです。 | デフォルト | ## Workgroup クエリが実行されるワークグループ。ワークグループの詳細については、「[WorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | WorkGroup | なし | オプションです。 | プライマリー | ## 出力場所 クエリ結果が保存される Amazon S3 内の場所。出力場所の詳細については、「[ResultConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultConfiguration.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | OutputLocation | S3OutputLocation (廃止) | 必須 (ワークグループが出力場所を指定している場合を除く) | なし | # 詳細接続パラメータ 次のセクションでは、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) + [アプリケーション名](#jdbc-v3-driver-application-name) + [接続テスト](#jdbc-v3-driver-connection-test) + [再試行回数](#jdbc-v3-driver-number-of-retries) + [ネットワークタイムアウト](#jdbc-v3-driver-networktimeoutmillis) ## 結果の暗号化パラメータ 以下の点に注意してください。 + AWS KMS キーは、`EncryptionOption` が `SSE_KMS` または `CSE_KMS` の場合に指定する必要があります。 + AWS KMS キーは、`EncryptionOption` が指定されていないか、`EncryptionOption` が `SSE_S3` の場合に指定できません。 ### 暗号化オプション Amazon S3 に保存されている前提でクエリ結果に使用される暗号化のタイプ。クエリ結果の暗号化の詳細については、「Amazon Athena API リファレンス」の「[EncryptionConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用できる値 | | --- | --- | --- | --- | --- | | EncryptionOption | S3OutputEncOption (廃止) | オプションです。 | なし | SSE\$1S3、SSE\$1KMS、CSE\$1KMS | ### KMS キー KMS キーの ARN または ID (`SSE_KMS` または `CSE_KMS` が暗号化オプションとして選択されている場合)。暗号化オプションの詳細については、「Amazon Athena API リファレンス」の「[EncryptionConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | KmsKey | S3OutputEncKMSKey (廃止) | オプションです。 | なし | ## 結果フェッチパラメータ ### 結果フェッチャー クエリ結果のダウンロードに使用されるフェッチャー。 デフォルトの結果フェッチャーの `auto` は、Athena API を使用せずに Amazon S3 から直接クエリ結果をダウンロードします。S3 の直接ダウンロードを行うことができない場合 (クエリ結果が `CSE_KMS` オプションで暗号化されている場合など)、自動的にフォールバックして `GetQueryResultsStream` API が使用されます。 ほとんどの場合、`auto` フェッチャーを使用することをお勧めします。IAM ポリシーまたは S3 バケットポリシーが [s3:CalledVia](security-iam-athena-calledvia.md) 条件を使用して Athena からの S3 オブジェクトリクエストへのアクセスを制限する場合、`auto` フェッチャーは最初に S3 からの結果のダウンロードを試行し、その後にフォールバックして `GetQueryResultsStream` API を使用します。この場合、追加の API コールを回避するために ResultFetcher を `GetQueryResultsStream` に設定できます。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用できる値 | | --- | --- | --- | --- | --- | | ResultFetcher | なし | オプションです。 | 自動 | auto、S3、GetQueryResults、GetQueryResultsStream | ### フェッチサイズ このパラメータの値は、内部バッファの最小値として使用され、結果をフェッチする際のターゲットページサイズとして使用されます。0 (ゼロ) の値は、ドライバーは以下で説明するデフォルト値を使用する必要があることを意味します。最大値は 1,000,000 です。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | FetchSize | RowsToFetchPerBlock (廃止) | オプションです。 | 0 | + `GetQueryResults` フェッチャーは API 呼び出しでサポートされる最大値である 1,000 のページサイズを常に使用します。フェッチサイズが 1,000 を超えると、最小サイズを超えるバッファを埋めるために連続して複数の API 呼び出しが行われます。 + `GetQueryResultsStream` フェッチャーは、設定されたフェッチサイズをページサイズとして使用するか、デフォルトの 10,000 を使用します。 + `S3` フェッチャーは、設定されたフェッチサイズをページサイズとして使用するか、デフォルトの 10,000 を使用します。 ## 結果設定パラメータ ### 予想されるバケット所有者 想定される S3 バケット所有者のアカウント ID。指定したアカウント ID がバケットの実際の所有者と一致しない場合、このリクエストは失敗します。s3 バケット所有者の検証の詳細については、「[バケットの所有権の検証](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-owner-condition.html#bucket-owner-condition-use)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ExpectedBucketOwner | なし | オプションです。 | なし | ### Acl オプション Amazon S3 の既定 ACL を設定して、保存されたクエリ結果の所有権を制御する必要があることを示します。`AclOption` に関する詳細については、「[AclConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_AclConfiguration.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用できる値 | | --- | --- | --- | --- | --- | | AclOption | なし | オプションです。 | なし | BUCKET\$1OWNER\$1FULL\$1CONTROL | ## クエリ結果の再利用パラメータ ### 結果の再利用を有効にする クエリ実行時に同じクエリによる以前の結果を再利用できるかどうかを指定します。クエリ結果の再利用の詳細については、「[ResultReuseByAgeConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultReuseByAgeConfiguration.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | EnableResultReuseByAge | なし | オプションです。 | FALSE | ### 結果再利用の最大有効期間 Athena が再利用を考慮するべき以前のクエリ結果の最大有効期間 (分単位)。結果再利用の最大有効期間の詳細については、「[ResultReuseByAgeConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultReuseByAgeConfiguration.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | MaxResultReuseAgeInMinutes | なし | オプションです。 | 60 | ## クエリ実行ポーリングパラメータ ### クエリ実行の最小ポーリング間隔 Athena にクエリ実行ステータスをポーリングする前に待機する最小時間 (ミリ秒単位)。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | MinQueryExecutionPollingIntervalMillis | MinQueryExecutionPollingInterval (廃止) | オプションです。 | 100 | ### クエリ実行の最大ポーリング間隔 Athena にクエリ実行ステータスをポーリングする前に待機する最大時間 (ミリ秒単位)。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | MaxQueryExecutionPollingIntervalMillis | MaxQueryExecutionPollingInterval (廃止) | オプションです。 | 5000 | ### クエリ実行ポーリング間隔の乗数 ポーリング期間を延長する要素。デフォルトでは、ポーリングは `MinQueryExecutionPollingIntervalMillis` の値から始まり、`MaxQueryExecutionPollingIntervalMillis` の値に達するまでポーリングごとに倍増します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | QueryExecutionPollingIntervalMultiplier | なし | オプションです。 | 2 | ## エンドポイントオーバーライドパラメータ ### Athena エンドポイントオーバーライド ドライバーが Athena に API 呼び出しを行うために使用するエンドポイント。 以下の点に注意してください。 + 提示された URL に `https://` または `http://` プロトコルが指定されていない場合、ドライバーは `https://` プレフィックスを挿入します。 + このパラメータが指定されていない場合、ドライバーはデフォルトエンドポイントを使用します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | AthenaEndpoint | EndpointOverride (廃止) | オプションです。 | なし | ### Athena ストリーミングサービスエンドポイントのオーバーライド ドライバーが Athena ストリーミングサービスを使用するとき、クエリ結果をダウンロードするために使用するエンドポイント。Athena ストリーミングサービスはポート 444 で利用できます。 以下の点に注意してください。 + 提示された URL に `https://` または `http://` プロトコルが指定されていない場合、ドライバーは `https://` プレフィックスを挿入します。 + 提示された URL にポートが指定されていない場合、ドライバーはストリーミングサービスのポート 444 を挿入します。 + `AthenaStreamingEndpoint` パラメータが指定されていない場合、ドライバーは `AthenaEndpoint` オーバーライドを使用します。`AthenaStreamingEndpoint` オーバーライドも、`AthenaEndpoint` オーバーライドも指定されていない場合、ドライバーはデフォルトのストリーミングエンドポイントを使用します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | AthenaStreamingEndpoint | StreamingEndpointOverride (廃止) | オプションです。 | なし | ### LakeFormation エンドポイントオーバーライド 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://` プレフィックスを挿入します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | LakeFormationEndpoint | LfEndpointOverride (廃止) | オプションです。 | なし | ### S3 エンドポイントオーバーライド ドライバーが Amazon S3 フェッチャーを使用するとき、クエリ結果をダウンロードするために使用するエンドポイント。このパラメータが指定されていない場合、ドライバーはデフォルトの Amazon S3 エンドポイントを使用します。 以下の点に注意してください。 + 提示された URL に `https://` または `http://` プロトコルが指定されていない場合、ドライバーは `https://` プレフィックスを挿入します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | S3Endpoint | なし | オプションです。 | なし | ### STS エンドポイントオーバーライド AWS STS[AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) API を使用して一時的な認証情報を取得するとき、ドライバーが AWS STS サービスに使用するエンドポイント。このパラメータが指定されていない場合、ドライバーはデフォルトの AWS STS エンドポイントを使用します。 以下の点に注意してください。 + 提示された URL に `https://` または `http://` プロトコルが指定されていない場合、ドライバーは `https://` プレフィックスを挿入します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | StsEndpoint | StsEndpointOverride (廃止) | オプションです。 | なし | ### SSO OIDC エンドポイントのオーバーライド ドライバーが `ClientConfiguration.endpointOverride` を使用して SSO OIDC クライアントのデフォルトの HTTP エンドポイントをオーバーライドするときに使用するエンドポイント。詳細については、「[ClientConfiguration](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | SSOOIDCEndpointOverride | | オプションです。 | なし | ### SSO Admin エンドポイントのオーバーライド ドライバーが `ClientConfiguration.endpointOverride` を使用して SSO Admin クライアントのデフォルトの HTTP エンドポイントをオーバーライドするときに使用するエンドポイント。詳細については、「[ClientConfiguration](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | SSOAdminEndpointOverride | | オプションです。 | なし | ## プロキシ設定パラメータ ### プロキシのホスト プロキシホストの URL。Athena がプロキシ経由でリクエストする必要がある場合、このパラメータを使用してください。 **注記** `ProxyHost` の URL の先頭には必ずプロトコル `https://` または `http://` を含めてください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ProxyHost | なし | オプションです。 | なし | ### プロキシのポート プロキシホストで使用するポート。Athena がプロキシ経由でリクエストする必要がある場合、このパラメータを使用してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ProxyPort | なし | オプションです。 | なし | ### プロキシユーザー名 プロキシサーバーで認証するユーザー名。Athena がプロキシ経由でリクエストする必要がある場合、このパラメータを使用してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ProxyUsername | ProxyUID (廃止) | オプションです。 | なし | ### プロキシのパスワード プロキシサーバーで認証するパスワード。Athena がプロキシ経由でリクエストする必要がある場合、このパラメータを使用してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ProxyPassword | ProxyPWD (廃止) | オプションです。 | なし | ### プロキシ免除ホスト プロキシが有効になっているとき (すなわち、`ProxyHost` および `ProxyPort` 接続パラメータが設定されているとき)、ドライバがプロキシを使わずに接続する一連のホスト名。ホストはパイプ (`|`) 文字で区切る必要があります (例えば、`host1.com|host2.com`)。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ProxyExemptHosts | NonProxyHosts | オプションです。 | なし | ### ID プロバイダー用に有効になっているプロキシ ドライバーが ID プロバイダーに接続するとき、プロキシを使用するかどうかを指定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ProxyEnabledForIdP | UseProxyForIdP | オプションです。 | FALSE | ## ログパラメータ このセクションでは、ログに関連するパラメータについて説明します。 ### ログレベル ドライバーログのレベルを指定します。`LogPath` パラメータも設定しない限り、何もログされません。 **注記** 特別な要件がない限り、`LogPath` パラメータのみを設定することをお勧めします。`LogPath` パラメータのみを設定すると、ロギングが有効になってデフォルトの `TRACE` ログレベルが使用されます。`TRACE` ログレベルは最も詳細なログを提供します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用できる値 | | --- | --- | --- | --- | --- | | LogLevel | なし | オプションです。 | TRACE | OFF、ERROR、WARN、INFO、DEBUG、TRACE | ### ログパス ドライバーログが保存されるドライバーを実行するコンピューター上のディレクトリへのパス。一意の名前のログファイルが指定したディレクトリ内に作成されます。設定すると、ドライバーログが有効になります。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | LogPath | なし | オプションです。 | なし | ## アプリケーション名 ドライバーを使用するアプリケーションの名前。このパラメータの値を指定すると、その値はドライバーが Athena に対して行う API 呼び出しのユーザーエージェント文字列に含まれます。 **注記** `DataSource` オブジェクトの `setApplicationName` を呼び出すことにより、アプリケーション名を設定することもできます。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ApplicationName | なし | オプションです。 | なし | ## 接続テスト `TRUE` に設定すると、JDBC 接続でクエリが実行されなくても、ドライバは JDBC 接続が作成されるたびに接続テストを実行します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ConnectionTest | なし | オプションです。 | TRUE | **注記** 接続テストでは `SELECT 1` クエリを Athena に送信し、接続が正しく設定されていることを確認します。すなわち、2 つのファイルが Amazon S3 (結果セットおよびメタデータ) に保存され、「[Amazon Athena 料金表](https://aws.amazon.com/athena/pricing)」ポリシーに従って追加料金が適用される場合があります。 ## 再試行回数 ドライバーが再実行可能なリクエストを Athena に再送信するべき最大回数。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | NumRetries | MaxErrorRetry (廃止) | オプションです。 | なし | ## ネットワークタイムアウト ネットワークタイムアウトは、ドライバーがネットワーク接続が確立されるまで待機する時間を制御します。これには、API リクエストの送信にかかる時間が含まれます。まれに、ネットワークタイムアウトを変更すると利便性が向上することがあります。例えば、ガベージコレクションの一時停止の際のタイムアウトを増やすことができます。この接続パラメータの設定は、 `Connection` オブジェクトでの `setNetworkTimeout` メソッドの使用と同等です。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | NetworkTimeoutMillis | なし | オプションです。 | なし | # 認証接続パラメータ 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) + [カスタム](jdbc-v3-driver-custom-credentials.md) + [JWT](jdbc-v3-driver-jwt-credentials.md) + [JWT の信頼できる ID の伝播](jdbc-v3-driver-jwt-tip-credentials.md) + [ブラウザの信頼できる ID 伝播](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) + [Browser Azure AD](jdbc-v3-driver-browser-azure-ad-credentials.md) + [Browser 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 認証情報 次の接続パラメータを設定することにより、IAM 認証情報を JDBC ドライバーと使用して Amazon Athena に接続できます。 ## ユーザー AWS アクセスキー ID。アクセスキーに関する詳細については、「*IAM ユーザーガイド*」の「[AWS セキュリティ認証情報](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ユーザー | AccessKeyId | 必須 | なし | ## パスワード AWS シークレットキーの ID。アクセスキーに関する詳細については、「*IAM ユーザーガイド*」の「[AWS セキュリティ認証情報](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | パスワード | SecretAccessKey | オプションです。 | なし | ## セッショントークン 一時的な AWS 認証情報を使用している場合は、セッショントークンを指定する必要があります。一時的なセキュリティ認証情報の詳細については、「*IAM ユーザーガイド*」の「[IAM の一時的なセキュリティ認証情報](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | SessionToken | なし | オプションです。 | なし | # デフォルト認証情報 次の接続パラメータを設定することにより、クライアントシステムで設定するデフォルトの認証情報を使用して Amazon Athena に接続できます。デフォルト認証情報の使用に関する詳細については、「*AWS SDK for Java デベロッパーガイド*」の「[デフォルト認証情報プロバイダチェーンの使用](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/credentials.html#credentials-default)」を参照してください。 ## 認証情報プロバイダー AWS へのリクエストの認証に使用される認証情報プロバイダー。このパラメータの値を `DefaultChain` に設定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用する値 | | --- | --- | --- | --- | --- | | CredentialsProvider | AWSCredentialsProviderClass (廃止) | 必須 | なし | DefaultChain | # AWS 設定プロファイルの認証情報 次の接続パラメータを設定することで、AWS 設定プロファイルに保存されている認証情報を使用できます。AWS 設定プロファイルは通常、「`~/.aws`」ディレクトリのファイルに保存されます)。AWS 設定プロファイルの詳細については、「*AWS SDK for Java デベロッパーガイド*」の「[プロファイルの使用](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/credentials-profiles.html)」を参照してください。 ## 認証情報プロバイダー AWS へのリクエストの認証に使用される認証情報プロバイダー。このパラメータの値を `ProfileCredentials` に設定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用する値 | | --- | --- | --- | --- | --- | | CredentialsProvider | AWSCredentialsProviderClass (廃止) | 必須 | なし | ProfileCredentials | ## プロファイル名 Athena へのリクエストを認証するために認証情報を使用する必要がある AWS 設定プロファイルの名前。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ProfileName | なし | 必須 | なし | **注記** プロファイル名は、`CredentialsProviderArguments` パラメータの値として指定することもできますが、この使用は廃止されています。 # インスタンスプロファイルの認証情報 この認証タイプは Amazon EC2 インスタンスで使用されます。「*インスタンスプロファイル*」Amazon EC2 インスタンスにアタッチされたプロファイルです。インスタンスプロファイル認証情報プロバイダーを使用すると、AWS 認証情報の管理を Amazon EC2 インスタンスメタデータサービスに委任されます。これにより、デベロッパーは認証情報を Amazon EC2 インスタンスに永続的に保存する必要がなくなり、一時的な認証情報のローテーションや管理について心配する必要がなくなります。 ## 認証情報プロバイダー AWS へのリクエストの認証に使用される認証情報プロバイダー。このパラメータの値を `InstanceProfile` に設定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用する値 | | --- | --- | --- | --- | --- | | CredentialsProvider | AWSCredentialsProviderClass (廃止) | 必須 | なし | InstanceProfile | # カスタム認証情報 この認証タイプを使用して、「[AwsCredentialsProvider](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/auth/credentials/AwsCredentialsProvider.html)」インターフェイスを実装する Java クラスを使用して独自の認証情報を入力できます。 ## 認証情報プロバイダー AWS へのリクエストの認証に使用される認証情報プロバイダー。このパラメータの値は、「[AwsCredentialsProvider](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/auth/credentials/AwsCredentialsProvider.html)」インターフェイスを実装するカスタムクラスの完全修飾クラス名に設定します。ランタイム時には、そのクラスは JDBC ドライバーを使用するアプリケーションの Java クラスパス上にある必要があります。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用する値 | | --- | --- | --- | --- | --- | | CredentialsProvider | AWSCredentialsProviderClass (廃止) | 必須 | なし | AwsCredentialsProvider のカスタム実装の完全修飾クラス名 | ## 認証情報プロバイダーの引数 カスタム認証情報プロバイダーコンストラクタの文字列引数のカンマ区切りリスト。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | CredentialsProviderArguments | AwsCredentialsProviderArguments (廃止) | オプションです。 | なし | # JWT 認証情報 この認証タイプでは、外部 ID プロバイダーから取得した JSON Web トークン (JWT) を接続パラメータとして使用して Athena で認証できます。外部認証情報プロバイダーは、AWS と既にフェデレート設定されている必要があります。 ## 認証情報プロバイダー AWS へのリクエストの認証に使用される認証情報プロバイダー。このパラメータの値を `JWT` に設定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用する値 | | --- | --- | --- | --- | --- | | CredentialsProvider | AWSCredentialsProviderClass (廃止) | 必須 | なし | JWT | ## JWT ウェブ ID トークン 外部のフェデレーション ID プロバイダーから取得した JWT トークン。このトークンは Athena での認証に使用されます。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | JwtWebIdentityToken | web\$1identity\$1token (廃止) | 必須 | なし | ## JWT ロール ARN 引き受けるロールの Amazon リソースネーム (ARN)。引き受けるロールの詳細については、「*AWS Security Token Service API リファレンス*」の「[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | JwtRoleArn | role\$1arn (廃止) | 必須 | なし | ## JWT ロールセッション名 JWT 認証情報を認証に使用するときのセッションの名前。名前は、任意の名前でかまいません。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | JwtRoleSessionName | role\$1session\$1name (廃止) | 必須 | なし | ## ロールセッションの期間 ロールセッションの期間 (秒)。詳細については、「*AWS Security Token Service API リファレンス*」の「[AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | RoleSessionDuration | 時間 (廃止) | オプションです。 | 3600 | # アイデンティティセンター統合を含む JWT この認証タイプでは、外部 ID プロバイダーから取得した JSON Web トークン (JWT) を接続パラメータとして使用して Athena で認証できます。このプラグインを使用すると、信頼できる ID の伝播による企業 ID のサポートを有効にすることができます。ドライバーで信頼できる ID の伝播を使用する方法の詳細については、「[Amazon Athena ドライバーで信頼できる ID の伝播を使用する](using-trusted-identity-propagation.md)」を参照してください。[CloudFormation を使用してリソースを設定およびデプロイする](using-trusted-identity-propagation-cloudformation.md)こともできます。 信頼できる ID の伝播では、ID コンテキストが IAM ロールに追加され、AWS リソースへのアクセスをリクエストするユーザーを識別します。信頼できる ID の伝播の有効化と使用方法の詳細については、「[信頼できる ID の伝播とは](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation.html)」を参照してください。 ## 認証情報プロバイダー AWS へのリクエストの認証に使用される認証情報プロバイダー。このパラメータの値を `JWT_TIP` に設定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用する値 | | --- | --- | --- | --- | --- | | CredentialsProvider | AWSCredentialsProviderClass (廃止) | 必須 | なし | JWT\$1TIP | ## JWT ウェブ ID トークン 外部のフェデレーション ID プロバイダーから取得した JWT トークン。このトークンは Athena での認証に使用されます。トークンキャッシュはデフォルトで有効になっており、複数のドライバー接続にわたって同じ IAM Identity Center アクセストークンの使用が許可されます。交換されたトークンはドライバーインスタンスがアクティブな間のみ存在するため、「接続のテスト」時に新しい JWT トークンを提供することをお勧めします。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | JwtWebIdentityToken | web\$1identity\$1token (廃止) | 必須 | なし | ## WorkgroupArn Amazon Athena ワークグループの Amazon リソースネーム (ARN)。ワークグループの詳細については、「[ワークグループ](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | WorkGroupArn | なし | 必須 | プライマリー | ## JWT アプリケーションロール ARN 引き受けるロールの ARN。このロールは、JWT 交換、ワークグループタグによる IAM Identity Center カスタマーマネージドアプリケーション ARN の取得、アクセスロール ARN の取得に使用されます。ロールの引き受けの詳細については、「[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ApplicationRoleArn | なし | 必須 | なし | ## JWT ロールセッション名 JWT 認証情報で認証する場合のセッションの名前。任意の名前を指定できます。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | JwtRoleSessionName | role\$1session\$1name (廃止) | 必須 | なし | ## ロールセッションの期間 ロールセッションの期間 (秒)。詳細については、「[AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | RoleSessionDuration | 時間 (廃止) | オプションです。 | 3600 | ## JWT アクセスロール ARN 引き受けるロールの ARN。これは、ユーザーに代わって呼び出しを行うために Athena サービスが引き受けるロールです。引き受けるロールの詳細については、「*AWS Security Token Service API リファレンス*」の「[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | AccessRoleArn | なし | オプションです。 | なし | ## IAM Identity Center カスタマーマネージドアプリケーション ARN IAM Identity Center カスタマーマネージドアプリケーションの ARN。詳細については、「[カスタマーマネージドアプリケーション](https://docs.aws.amazon.com/singlesignon/latest/userguide/customermanagedapps.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | CustomerIdcApplicationArn | なし | オプションです。 | なし | # アイデンティティセンター統合を含むブラウザベース この認証タイプでは、外部 ID プロバイダーから新規の JSON Web トークン (JWT) を取得して Athena で認証できます。このプラグインを使用すると、信頼できる ID の伝播による企業 ID のサポートを有効にすることができます。ドライバーで信頼できる ID の伝播を使用する方法の詳細については、「[Amazon Athena ドライバーで信頼できる ID の伝播を使用する](using-trusted-identity-propagation.md)」を参照してください。[CloudFormation を使用してリソースを設定およびデプロイする](using-trusted-identity-propagation-cloudformation.md)こともできます。 信頼できる ID の伝播では、ID コンテキストが IAM ロールに追加され、AWS リソースへのアクセスをリクエストするユーザーを識別します。信頼できる ID の伝播の有効化と使用方法の詳細については、「[信頼できる ID の伝播とは](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation.html)」を参照してください。 **注記** このプラグインは、シングルユーザーデスクトップ環境向けに特別に設計されています。Windows Server などの共有環境では、システム管理者がユーザー間のセキュリティ境界を確立して維持する責任を負います。 ## 認証情報プロバイダー AWS へのリクエストの認証に使用される認証情報プロバイダー。このパラメータの値を `BrowserOidcTip` に設定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用する値 | | --- | --- | --- | --- | --- | | CredentialsProvider | AWSCredentialsProviderClass (廃止) | 必須 | なし | BrowserOidcTip | ## IDP well known configuration URL IDP Well Known Configuration URL は、ID プロバイダーの OpenID Connect 設定の詳細を提供するエンドポイントです。この URL は通常、`.well-known/openid-configuration` で終わり、認証エンドポイント、サポートされている機能、トークン署名キーに関する必須メタデータが含まれています。例えば、*Okta* を使用している場合、URL は `https://your-domain.okta.com/.well-known/openid-configuration` のようになります。 トラブルシューティング：接続エラーが発生した場合は、この URL がネットワークからアクセス可能なものであり、有効な *OpenID Connect* 設定 JSON を返すことを確認します。URL は、ドライバーがインストールされているクライアントが到達できるものでなければならず、ID プロバイダーの管理者から提供される必要があります。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | IdpWellKnownConfigurationUrl | なし | 必須 | なし | ## クライアント識別子 OpenID Connect プロバイダーがアプリケーションに対して発行したクライアント識別子。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | OidcClientId | なし | 必須 | なし | ## WorkgroupArn 信頼できる ID の伝搬設定タグを含む Amazon Athena ワークグループの Amazon リソースネーム（ARN）。ワークグループの詳細については、「[ワークグループ](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html)」を参照してください。 **注記** このパラメータは、クエリの実行場所を指定する `Workgroup` パラメータとは異なります。次の両方のパラメータを設定する必要があります。 `WorkgroupArn` - 信頼できる ID の伝搬設定タグを含むワークグループを指す `Workgroup` - クエリを実行するワークグループを指定する これらは通常、同じワークグループを参照しますが、適切なオペレーションのために両方のパラメータを明示的に設定する必要があります。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | WorkGroupArn | なし | 必須 | プライマリー | ## JWT アプリケーションロール ARN JWT 交換で継承されるロールの ARN。このロールは、JWT 交換、ワークグループタグによる IAM Identity Center カスタマーマネージドアプリケーション ARN の取得、アクセスロール ARN の取得に使用されます。ロールの引き受けの詳細については、「[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ApplicationRoleArn | なし | 必須 | なし | ## JWT ロールセッション名 IAM セッションの名前。どのようなものでもかまいませんが、通常は、アプリケーションを使用するユーザーに関連付けられている名前または識別子を渡します。そうすると、アプリケーションが使用する一時的なセキュリティ認証情報は、そのユーザーに関連付けられます。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | JwtRoleSessionName | role\$1session\$1name (廃止) | 必須 | なし | ## クライアントシークレット clientSecret は、アプリケーション（クライアント）の認証に利用している ID プロバイダーによって発行された機密キーです。このパラメータはオプションであり、すべての認証フローに必須ではない場合がありますが、使用するとセキュリティレイヤーが追加されます。IDP 設定にクライアントシークレットが必要な場合は、ID プロバイダー管理者から提供された値をこのパラメータに含める必要があります。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | OidcClientSecret | なし | オプションです。 | なし | ## スコープ スコープでは、アプリケーションが ID プロバイダーに要求するアクセス許可のレベルを指定します。重要なユーザー ID クレームを含む ID トークンを受け取るには、`openid` をスコープに含める必要があります。ID プロバイダー（*Microsoft Entra ID* など）が ID トークンに含めるように設定されているユーザークレームによっては、`email` や `profile` などの追加のアクセス許可をスコープに含める必要がある場合があります。これらのクレームは、適切な「*信頼できる ID の伝搬*」マッピングに不可欠です。ユーザー ID マッピングが失敗した場合、必要なすべてのアクセス許可がスコープに含まれており、必要なクレームを ID トークンに含めるように ID プロバイダーが設定されていることを確認します。これらのクレームは、IAM アイデンティティセンターの「*信頼できるトークン発行者*」マッピング設定と一致する必要があります。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | スコープ | なし | オプションです。 | openid email offline\$1access | ## ロールセッションの期間 ロールセッションの期間 (秒)。詳細については、「[AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | RoleSessionDuration | 時間 (廃止) | オプションです。 | 3600 | ## JWT アクセスロール ARN Athena がユーザーに代わって呼び出しを行うために引き受けるロールの ARN。引き受けるロールの詳細については、「*AWS Security Token Service API リファレンス*」の「[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | AccessRoleArn | なし | オプションです。 | なし | ## IAM Identity Center カスタマーマネージドアプリケーション ARN IAM Identity Center カスタマーマネージドアプリケーションの ARN。詳細については、「[カスタマーマネージドアプリケーション](https://docs.aws.amazon.com/singlesignon/latest/userguide/customermanagedapps.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | CustomerIdcApplicationArn | なし | オプションです。 | なし | ## ID プロバイダーのポート番号 OAuth 2.0 コールバックサーバーに使用するローカルポート番号。これは redirect\$1uri として使用されます。これを IDP アプリケーションの許可リストに登録する必要があります。デフォルトで生成される redirect\$1uri は、http://localhost:7890/athena です。 **警告** Windows ターミナルサーバーやリモートデスクトップサービスなどの共有環境では、ループバックポート（デフォルト：7890）は同一マシン上のすべてのユーザー間で共有されます。システム管理者は、潜在的なポートハイジャックリスクを以下の方法で軽減できます。 ユーザーグループごとに異なるポート番号を設定する Windows セキュリティポリシーを使用してポートアクセスを制限する ユーザーセッション間のネットワーク分離を実装する これらのセキュリティコントロールを実装できない場合は、ループバックポートを必要としない「[JWT の信頼できる ID の伝搬](jdbc-v3-driver-jwt-tip-credentials.md)」プラグインの使用をお勧めします。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | IdpPortNumber | なし | オプションです。 | 7890 | ## ID プロバイダーの応答タイムアウト OAuth 2.0 コールバック応答を待機するタイムアウト（秒単位）。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | IdpResponseTimeout | なし | オプションです。 | 120 | ## トークンキャッシュを有効にする EnableTokenCaching パラメータは、ドライバーが接続間で認証トークンをキャッシュするかどうかを決定します。EnableTokenCaching を true に設定すると、認証プロンプトが減るのでユーザーエクスペリエンスが向上しますが、慎重に使用する必要があります。この設定は、シングルユーザーデスクトップ環境に最適です。Windows Server などの共有環境では、同様の接続文字列を持つユーザー間でのトークン共有を予防するために、これを無効にしておくことをお勧めします。 Tableau Server などのツールを使用したエンタープライズデプロイの場合は、この認証方法の代わりに「[JWT の信頼できる ID の伝搬](jdbc-v3-driver-jwt-tip-credentials.md)」プラグインを使用することをお勧めします。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | EnableTokenCaching | なし | オプションです。 | FALSE | # Azure AD 認証情報 Azure AD ID プロバイダーを使用して Athena への認証を可能にする SAML ベースの認証メカニズム。この方法では、Athena と Azure AD の間にフェデレーションが既に設定されていることを前提としています。 **注記** このセクションの一部のパラメーター名にはエイリアスがあります。エイリアスはパラメーター名と機能的に同等であり、JDBC 2.x ドライバーとの下位互換性を保つために提供されています。パラメーター名は、より明確で一貫性のある命名規則に従うように改良されたため、非推奨になったエイリアスの代わりにパラメーター名を使用することをお勧めします。 ## 認証情報プロバイダー AWS へのリクエストの認証に使用される認証情報プロバイダー。このパラメータの値を `AzureAD` に設定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用する値 | | --- | --- | --- | --- | --- | | CredentialsProvider | AWSCredentialsProviderClass (廃止) | 必須 | なし | AzureAD | ## ユーザー Azure AD での認証に使用する Azure AD ユーザーのメールアドレス。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ユーザー | UID (廃止) | 必須 | なし | ## パスワード Azure AD ユーザーのパスワード。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | パスワード | PWD (廃止) | 必須 | なし | ## Azure AD テナント ID Azure AD アプリケーションのテナント ID。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | AzureAdTenantId | tenant\$1id (廃止) | 必須 | なし | ## Azure AD クライアント ID Azure AD アプリケーションのクライアント ID。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | AzureAdClientId | client\$1id (廃止) | 必須 | なし | ## Azure AD クライアントシークレット Azure AD アプリケーションのクライアントシークレット。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | AzureAdClientSecret | client\$1secret (廃止) | 必須 | なし | ## 優先ロール 引き受けるロールの Amazon リソースネーム (ARN)。ARN ロールの詳細については、「*AWS Security Token Service API リファレンス*」の「[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | PreferredRole | preferred\$1role (廃止) | オプションです。 | なし | ## ロールセッションの期間 ロールセッションの期間 (秒)。詳細については、「AWS Security Token Service API リファレンス」の「[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | RoleSessionDuration | 時間 (廃止) | オプションです。 | 3600 | ## Lake Formation 有効 [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) AWS STS API アクションの代わりに、一時的な IAM 認証情報を取得するために [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) Lake Formation API アクションを使用するかどうかを指定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | LakeFormationEnabled | なし | オプションです。 | FALSE | # Okta 認証情報 Okta ID プロバイダーを使用して Athena への認証を可能にする SAML ベースの認証メカニズム。この方法では、Athena と Okta の間にフェデレーションが既に設定されていることを前提としています。 ## 認証情報プロバイダー AWS へのリクエストの認証に使用される認証情報プロバイダー。このパラメータの値を `Okta` に設定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用する値 | | --- | --- | --- | --- | --- | | CredentialsProvider | AWSCredentialsProviderClass (廃止) | 必須 | なし | Okta | ## ユーザー Okta での認証に使用する Okta ユーザーのメールアドレス。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ユーザー | UID (廃止) | 必須 | なし | ## パスワード Okta ユーザーのパスワード。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | パスワード | PWD (廃止) | 必須 | なし | ## Okta ホスト名 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`)。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | OktaHostName | IdP\$1Host (廃止) | 必須 | なし | ## Okta アプリケーション ID アプリケーション用の 2 つの部分で構成される識別子です。Okta アプリケーションの **[リンク埋め込み]** URL からアプリケーション ID を抽出できます。手順については、「[Okta から ODBC の設定情報を取得する](odbc-okta-plugin.md#odbc-okta-plugin-retrieve-odbc-configuration-information-from-okta)」を参照してください。アプリケーション ID は、URL の最後の 2 つのセグメントで、中央のスラッシュも含まれます。これら 2 つのセグメントは、数字と大文字と小文字が混在する 20 文字の文字列 2 組です (例: `Abc1de2fghi3J45kL678/abc1defghij2klmNo3p4`)。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | OktaAppId | App\$1ID (廃止) | 必須 | なし | ## Okta アプリケーション名 Okta アプリケーションの名前。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | OktaAppName | App\$1Name (廃止) | 必須 | なし | ## Okta MFA タイプ 多要素認証 (MFA) を必要とするように Okta を設定した場合、使用する 2 番目の要素に応じて Okta MFA タイプと追加のパラメータを指定する必要があります。 Okta MFA タイプは、Okta での認証に使用する 2 番目の認証要素タイプです (パスワードに次ぐもの)。サポートされている 2 番目の要素には、Okta Verify アプリを介して配信されるプッシュ通知、ならびに Okta Verify や Google Authenticator によって生成または SMS を介して送信される一時的なワンタイムパスワード (TOTP) が含まれています。個々の組織のセキュリティポリシーによって、ユーザーのログインに MFA が必要かどうかが決まります。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用できる値 | | --- | --- | --- | --- | --- | | OktaMfaType | okta\$1mfa\$1type (廃止) | Okta が MFA を必要とするように設定されている場合は必須です | なし | oktaverifywithpush, oktaverifywithtotp, googleauthenticator, smsauthentication | ## Okta 電話番号 `smsauthentication` MFA タイプが選択されたとき、Okta が SMS を使用して一時的なワンタイムパスワードを送信する電話番号。電話番号は、米国またはカナダの電話番号である必要があります。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | OktaPhoneNumber | okta\$1phone\$1number (廃止) | OktaMfaType が smsauthentication の場合は必須 | なし | ## Okta MFA の待機時間 ドライバーがタイムアウト例外を発生させる前、ユーザーが Okta からのプッシュ通知を確認するために待機する時間 (秒単位)。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | OktaMfaWaitTime | okta\$1mfa\$1wait\$1time (廃止) | オプションです。 | 60 | ## 優先ロール 引き受けるロールの Amazon リソースネーム (ARN)。ARN ロールの詳細については、「*AWS Security Token Service API リファレンス*」の「[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | PreferredRole | preferred\$1role (廃止) | オプションです。 | なし | ## ロールセッションの期間 ロールセッションの期間 (秒)。詳細については、「AWS Security Token Service API リファレンス」の「[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | RoleSessionDuration | 時間 (廃止) | オプションです。 | 3600 | ## Lake Formation 有効 [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) AWS STS API アクションの代わりに、一時的な IAM 認証情報を取得するために [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) Lake Formation API アクションを使用するかどうかを指定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | LakeFormationEnabled | なし | オプションです。 | FALSE | # Ping 認証情報 Ping フェデレーション ID プロバイダーを使用して Athena への認証を可能にする SAML ベースの認証メカニズム。この方法では、Athena と Ping フェデレーション の間にフェデレーションが既に設定されていることを前提としています。 ## 認証情報プロバイダー AWS へのリクエストの認証に使用される認証情報プロバイダー。このパラメータの値を `Ping` に設定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用する値 | | --- | --- | --- | --- | --- | | CredentialsProvider | AWSCredentialsProviderClass (廃止) | 必須 | なし | Ping | ## ユーザー Ping フェデレーションで認証に使用する Ping フェデレーションユーザーのメールアドレス。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ユーザー | UID (廃止) | 必須 | なし | ## パスワード Ping フェデレーションユーザーのパスワード。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | パスワード | PWD (廃止) | 必須 | なし | ## PingHostName Ping サーバーのアドレス。アドレスを確認するには、次の URL にアクセスして **[SSO アプリケーションエンドポイント]** フィールドを確認してください。 ``` https://your-pf-host-#:9999/pingfederate/your-pf-app#/spConnections ``` **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | PingHostName | IdP\$1Host (廃止) | 必須 | なし | ## PingPortNumber IdP ホストへの接続に使用するポート番号。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | PingPortNumber | IdP\$1Port (廃止) | 必須 | なし | ## PingPartnerSpId サービスプロバイダのアドレス。サービスプロバイダのアドレスを確認するには、次の URL にアクセスして **[SSO アプリケーションエンドポイント]** フィールドを確認してください。 ``` https://your-pf-host-#:9999/pingfederate/your-pf-app#/spConnections ``` **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | PingPartnerSpId | Partner\$1SPID (廃止) | 必須 | なし | ## 優先ロール 引き受けるロールの Amazon リソースネーム (ARN)。ARN ロールの詳細については、「*AWS Security Token Service API リファレンス*」の「[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | PreferredRole | preferred\$1role (廃止) | オプションです。 | なし | ## ロールセッションの期間 ロールセッションの期間 (秒)。詳細については、「AWS Security Token Service API リファレンス」の「[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | RoleSessionDuration | 時間 (廃止) | オプションです。 | 3600 | ## Lake Formation 有効 [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) AWS STS API アクションの代わりに、一時的な IAM 認証情報を取得するために [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) Lake Formation API アクションを使用するかどうかを指定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | LakeFormationEnabled | なし | オプションです。 | FALSE | # AD FS 認証情報 Microsoft Active Directory Federation Services (AD FS) を使用した Athena への認証を可能にする SAML ベースの認証メカニズムです。この手法は、ユーザーが Athena と AD FS 間のフェデレーションを既に設定していることを前提としています。 ## 認証情報プロバイダー AWS へのリクエストの認証に使用される認証情報プロバイダー。このパラメータの値を `ADFS` に設定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用する値 | | --- | --- | --- | --- | --- | | CredentialsProvider | AWSCredentialsProviderClass (廃止) | 必須 | なし | ADFS | ## ユーザー AD FS での認証に使用する AD FS ユーザーの E メールアドレスです。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ユーザー | UID (廃止) | フォームベースの認証に必要です。Windows 統合認証の場合はオプションです。 | なし | ## パスワード AD FS ユーザーのパスワードです。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | パスワード | PWD (廃止) | フォームベースの認証に必要です。Windows 統合認証の場合はオプションです。 | なし | ## AD FS ホスト名 AD FS サーバーのアドレスです。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | AdfsHostName | IdP\$1Host (廃止) | 必須 | なし | ## AD FS ポート番号 AD FS サーバーへの接続に使用するポート番号です。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | AdfsPortNumber | IdP\$1Port (廃止) | 必須 | なし | ## AD FS 依存パーティ 信頼できる依存パーティ。このパラメータを使用して、AD FS 依存パーティエンドポイント URL を上書きします。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | AdfsRelyingParty | LoginToRP (廃止) | オプションです。 | urn:amazon:webservices | ## AD FS WIA 有効 Boolean。このパラメータを使用して、AD FS で Windows 統合認証 (WIA) を有効にします。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | AdfsWiaEnabled | none | オプションです。 | FALSE | ## 優先ロール 引き受けるロールの Amazon リソースネーム (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)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | PreferredRole | preferred\$1role (廃止) | オプションです。 | なし | ## ロールセッションの期間 ロールセッションの期間 (秒)。詳細については、「*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)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | RoleSessionDuration | 時間 (廃止) | オプションです。 | 3600 | ## Lake Formation 有効 一時的な 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 アクションではなく [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 アクションを使用するかどうかを指定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | LakeFormationEnabled | none | オプションです。 | FALSE | # Browser Azure AD 認証情報 Browser Azure AD は、Azure AD ID プロバイダーと連携する SAML ベースの認証メカニズムであり、多要素認証をサポートします。標準の Azure AD 認証メカニズムとは異なり、このメカニズムには接続パラメータにユーザー名、パスワード、クライアントシークレットは不要です。標準の Azure AD 認証メカニズムと同様に、ブラウザ Azure AD もユーザーが Athena と Azure AD の間にフェデレーションを既に設定していることを前提としています。 ## 認証情報プロバイダー AWS へのリクエストの認証に使用される認証情報プロバイダー。このパラメータの値を `BrowserAzureAD` に設定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用する値 | | --- | --- | --- | --- | --- | | CredentialsProvider | AWSCredentialsProviderClass (廃止) | 必須 | なし | BrowserAzureAD | ## Azure AD テナント ID Azure AD アプリケーションのテナント ID。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | AzureAdTenantId | tenant\$1id (廃止) | 必須 | なし | ## Azure AD クライアント ID Azure AD アプリケーションのクライアント ID。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | AzureAdClientId | client\$1id (廃止) | 必須 | なし | ## ID プロバイダーの応答タイムアウト ドライバーが Azure AD からの SAML レスポンスの待機を停止するまでの時間 (秒単位)。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | IdpResponseTimeout | idp\$1response\$1timeout (廃止) | オプションです。 | 120 | ## 優先ロール 引き受けるロールの Amazon リソースネーム (ARN)。ARN ロールの詳細については、「*AWS Security Token Service API リファレンス*」の「[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | PreferredRole | preferred\$1role (廃止) | オプションです。 | なし | ## ロールセッションの期間 ロールセッションの期間 (秒)。詳細については、「AWS Security Token Service API リファレンス」の「[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | RoleSessionDuration | 時間 (廃止) | オプションです。 | 3600 | ## Lake Formation 有効 [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) AWS STS API アクションの代わりに、一時的な IAM 認証情報を取得するために [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) Lake Formation API アクションを使用するかどうかを指定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | LakeFormationEnabled | なし | オプションです。 | FALSE | # Browser SAML 認証情報 Browser SAML は、SAML ベースの ID プロバイダーと連携する汎用認証プラグインであり、多要素認証をサポートします。 ## 認証情報プロバイダー AWS へのリクエストの認証に使用される認証情報プロバイダー。このパラメータの値を `BrowserSaml` に設定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用する値 | | --- | --- | --- | --- | --- | | CredentialsProvider | AWSCredentialsProviderClass (廃止) | 必須 | なし | BrowserSaml | ## シングルサインオンのログイン URL SAML ベースの ID プロバイダー上のアプリケーションにおける Single sign-on URL。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | SsoLoginUrl | login\$1url (廃止) | 必須 | なし | ## リッスンポート SAML レスポンスをリッスンするために使用されるポート番号。この値は、SAML ベースの ID プロバイダー (例えば、`http://localhost:7890/athena`) を設定した URL と一致する必要があります。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ListenPort | listen\$1port (廃止) | オプションです。 | 7890 | ## ID プロバイダーの応答タイムアウト ドライバーが Azure AD からの SAML レスポンスの待機を停止するまでの時間 (秒単位)。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | IdpResponseTimeout | idp\$1response\$1timeout (廃止) | オプションです。 | 120 | ## 優先ロール 引き受けるロールの Amazon リソースネーム (ARN)。ARN ロールの詳細については、「*AWS Security Token Service API リファレンス*」の「[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | PreferredRole | preferred\$1role (廃止) | オプションです。 | なし | ## ロールセッションの期間 ロールセッションの期間 (秒)。詳細については、「AWS Security Token Service API リファレンス」の「[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | RoleSessionDuration | 時間 (廃止) | オプションです。 | 3600 | ## Lake Formation 有効 [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) AWS STS API アクションの代わりに、一時的な IAM 認証情報を取得するために [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) Lake Formation API アクションを使用するかどうかを指定します。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | LakeFormationEnabled | なし | オプションです。 | FALSE | # DataZone IdC 認証情報プロバイダー IAM Identity Center を使用して Athena で DataZone 管理対象データへの接続を有効にする認証メカニズム。 ## 認証情報プロバイダー AWS へのリクエストの認証に使用される認証情報プロバイダー。このパラメータの値を `DataZoneIdc` に設定します。`AWSCredentialsProviderClass` エイリアスは非推奨であることに注意してください。代わりに `CredentialsProvider`パラメータ名を使用してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | 使用する値 | | --- | --- | --- | --- | --- | | CredentialsProvider | AWSCredentialsProviderClass (廃止) | 必須 | なし | DataZoneIdc | ## DataZone ドメイン識別子 使用する DataZone ドメインの識別子。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | DataZoneDomainId | なし | 必須 | なし | ## DataZone 環境識別子 使用する DataZone 環境の識別子。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | DataZoneEnvironmentId | なし | 必須 | なし | ## DataZone ドメインリージョン DataZone ドメインがプロビジョニングされる AWS リージョン。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | DataZoneDomainRegion | なし | 必須 | なし | ## リージョン DataZone 環境と Athena ワークグループがプロビジョニングされる AWS リージョン。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | リージョン | なし | 必須 | なし | ## [IAM アイデンティティセンター発行者 URL] DataZone ドメインが使用する IAM Identity Center インスタンスの発行者 URL。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | IdentityCenterIssuerUrl | なし | 必須 | なし | ## DataZone エンドポイントのオーバーライド 指定された AWS リージョンのデフォルトの代わりに使用される DataZone API エンドポイント。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | DataZoneEndpointOverride | なし | オプションです。 | なし | ## トークンキャッシュを有効にする 有効にすると、複数のドライバー接続にわたって同じ IAM Identity Center アクセストークンの使用が許可されます。これにより、複数のドライバー接続を作成する SQL ツールによって複数のブラウザウィンドウが開かれることが防止されます。このパラメータを有効にする場合は、使用直後に SQL ツールを閉じてトークンキャッシュをクリアし、再認証を要求することをお勧めします。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | EnableTokenCaching | なし | オプションです。 | FALSE | ## リッスンポート IAM Identity Center レスポンスをリッスンするポート番号。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ListenPort | なし | オプションです。 | 8000 | ## ID プロバイダーの応答タイムアウト ドライバーが IAM Identity Center からの応答の待機を停止するまでの時間 (秒単位)。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | IdpResponseTimeout | なし | オプションです。 | 120 | # DataZone IAM 認証情報プロバイダー IAM 認証情報を使用して Athena の DataZone 管理対象データに接続する認証メカニズム。 ## DataZone ドメイン識別子 使用する DataZone ドメインの識別子。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | DataZoneDomainId | なし | 必須 | なし | ## DataZone 環境識別子 使用する DataZone 環境の識別子。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | DataZoneEnvironmentId | なし | 必須 | なし | ## DataZone ドメインリージョン DataZone ドメインがプロビジョニングされる AWS リージョン。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | DataZoneDomainRegion | なし | 必須 | なし | ## DataZone エンドポイントのオーバーライド 指定された AWS リージョン のエンドポイントのデフォルトの代わりに使用する DataZone API エンドポイント。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | DataZoneEndpointOverride | なし | オプションです。 | なし | ## ユーザー AWS アクセスキー ID。アクセスキーの詳細については、「*IAM ユーザーガイド*」の「[AWS セキュリティ認証情報](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | ユーザー | AccessKeyId | オプションです。 | なし | ## パスワード AWS シークレットキーの ID。アクセスキーの詳細については、「*IAM ユーザーガイド*」の「[AWS セキュリティ認証情報](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html)」を参照してください。 **** | パラメータ名 | エイリアス | パラメータタイプ | デフォルトの値 | | --- | --- | --- | --- | | パスワード | SecretAccessKey | オプションです。 | なし | # その他の JDBC 3.x 設定 次のセクションでは、JDBC 3.x ドライバーの一部の追加設定について説明します。 ## ネットワークタイムアウト ネットワークタイムアウトは、ドライバーがネットワーク接続が確立されるまで待機する時間 (ミリ秒) を制御します。これには、API リクエストの送信にかかる時間が含まれます。この時間が経過すると、ドライバーはタイムアウト例外を発生させます。まれに、ネットワークタイムアウトを変更すると利便性が向上することがあります。例えば、ガベージコレクションの一時停止の際のタイムアウトを増やすことができます。 設定するには、JDBC `setNetworkTimeout` オブジェクトで `Connection` メソッドを呼び出します。この値は 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) 接続パラメータを設定することと同等です。 次の例では、ネットワークタイムアウトを 5,000 ミリ秒に設定しています。 ``` ... AthenaDriver driver = new AthenaDriver(); Connection connection = driver.connect(url, connectionParameters); connection.setNetworkTimeout(null, 5000); ... ``` ## クエリタイムアウト クエリが送信された後、トライバーが Athena 上でクエリが完了するまで待機する時間 (秒単位) この時間が経過すると、ドライバーは送信されたクエリをキャンセルしようとし、タイムアウト例外を発生させます。 クエリタイムアウトは接続パラメータとして設定できません。設定するには、JDBC `setQueryTimeout` オブジェクトで `Statement` メソッドを呼び出します。この値は JDBC ステートメントのライフサイクル中に変更できます。このパラメータのデフォルト値は `0` (ゼロ) です。値が `0` の場合、クエリは完了するまで実行できることを意味します ([サービスクォータ](service-limits.md) が適用されます)。 次の例では、クエリタイムアウトを 5 秒に設定しています。 ``` ... AthenaDriver driver = new AthenaDriver(); Connection connection = driver.connect(url, connectionParameters); Statement statement = connection.createStatement(); statement.setQueryTimeout(5); ... ``` # Amazon Athena ODBC 3.x リリースノート これらのリリースノートには、Amazon Athena JDBC 3.x ドライバーの改良と修正の詳細が記載されています。 ## 3.7.0 2025 年 11 月 21 日リリース ### 改良点 + **「ブラウザ OIDC の信頼できる ID の伝搬」認証プラグイン** – OpenID Connect (OIDC) ID プロバイダーによるシームレスなブラウザベース認証を可能にする新しい認証プラグインを追加しました。このプラグインは、デフォルトのブラウザを介した完全な OAuth 2.0 フローの処理、JSON ウェブトークン（JWT）の自動取得、信頼できる ID の伝搬との統合を行います。シングルユーザーデスクトップ環境専用に設計されており、JWT の手動処理よりも効率的な認証エクスペリエンスを提供します。信頼できる ID の伝播の詳細については、「[信頼できる ID の伝播とは](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation-overview.html)」を参照してください。 ### 修正内容 + **タイムスタンプ精度サポートの強化** – ドライバーは、`getTimestamp()` メソッドを介して Athena クエリから返されるタイムスタンプ値のミリ秒とナノ秒の精度を完全にサポートするようになりました。 + **複雑な型処理の改善** – `DatabaseMetaData#getColumns` と一般的なメタデータオペレーションの両方でネストされたデータ型 (配列、構造体、マップ) を解析する際の問題を修正し、複雑なデータ構造の型情報の精度を確保しました。 + **エラーログ記録の強化** – エラーメッセージがより明確になって診断情報が向上するように、S3 メタデータ取得失敗のログ記録を改善しました。 ## 3.6.0 2025 年 9 月 10 日リリース ### 改良点 + **JWT の信頼できる ID の伝播認証プラグイン** – JWT の信頼できる ID の伝播と JDBC ドライバーの統合をサポートする新しい認証プラグインが追加されました。この認証タイプでは、外部 ID プロバイダーから取得した JSON Web トークン (JWT) を接続パラメータとして使用して Athena で認証できます。信頼できる ID の伝播では、ID コンテキストが IAM ロールに追加され、AWS リソースへのアクセスをリクエストするユーザーを識別します。信頼できる ID の伝播の有効化と使用方法の詳細については、「[信頼できる ID の伝播とは](https://docs.aws.amazon.com/singlesignon/latest/userguide/trustedidentitypropagation-overview.html)」を参照してください。 + **カスタム SSO OIDC および SSO Admin エンドポイントのサポート** – JDBC ドライバーでカスタム SSO OIDC および SSO Admin エンドポイントのサポートが追加されました。この機能強化により、VPC の背後で JDBC を実行するときに SSO サービス用の独自のエンドポイントを指定できます。 + **AWS SDK バージョンの更新** – ドライバーで使用される AWS SDK バージョンを 2.32.16 に更新し、リリース 3.6.0 のプロジェクトの依存関係を更新しました。 ## 3.5.1 2025 年 7 月 17 日リリース ### 改良点 + **ログ記録機能** – ログレベルを `INFO` に引き上げ、行数、オフセット、オブジェクト長のメトリクスを追加することで、S3 フェッチログ記録を強化しました。接続ライフサイクルの追跡を実装し、全体的なログ記録パフォーマンスを最適化しました。 + **特殊文字の処理** — スキーマ名とカタログ名の `LIKE` パターンの特殊文字の処理が改善されました。 + **接続状態管理** – 接続状態管理を改善し、接続の閉鎖後に API コールを防止し、シャットダウン中のクエリオペレーションの安全チェックを追加することで、潜在的なエラーを防止しました。 ### 修正内容 + **DDL クエリメタデータ** – DDL クエリメタデータ処理の `NoSuchKeyFound` 問題を修正しました。 ## 3.5.0 2025 年 3 月 18 日リリース ### 改良点 + **結果設定パラメータ** – 2 つの新しい接続パラメータ `ExpectedBucketOwner` と`AclOption` のサポートが追加されました。詳細については、「[Result configuration parameters](jdbc-v3-driver-advanced-connection-parameters.md#jdbc-v3-driver-result-config)」を参照してください。 + **AWS SDK バージョン** – ドライバーで使用されている AWS SDK バージョンが 2.30.22 に更新されました。 ## 3.4.0 2025 年 2 月 18 日リリース ### 改良点 + **結果フェッチャー** – ドライバーは、クエリ結果をダウンロードする最も速い方法を自動的に選択するようになりました。これにより、ほとんどの場合、フェッチャーを手動で設定する必要がなくなります。詳細については、「[結果フェッチパラメータ](jdbc-v3-driver-advanced-connection-parameters.md#jdbc-v3-driver-result-fetching-parameters)」を参照してください。 ### 修正内容 + **ResultSet** – ドライバーは、S3 で結果オブジェクトを生成しない DDL ステートメントの結果セットに対する反復処理を処理するようになりました。また、`GetQueryResultsStream` が完全に空のページを返すとき、null ではなく空の `ResultSet` オブジェクトが返されます。 + **ResultsStream** – 結果のストリーミングは、内部バッファの行数をカウントする不要な呼び出しを削除することで最適化されています。 + **getTables** – `GetTables` の呼び出しは、 `ListTableMetadata` と `GetTableMetadata` の応答に基づいてテーブルタイプを処理することで最適化されています。 ## 3.3.0 2024 年 10 月 30 日リリース ### 改良点 + **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)」を参照してください。 ### 修正内容 + **S3 空のオブジェクト処理** – ドライバーは、Amazon S3 Range Not Satisfiable 例外をスローする代わりに、S3 フェッチャー内の空のオブジェクトを処理するようになりました。 + **ログ記録** – クエリ結果を使用した後、ドライバーは、メッセージ「Items requested for query execution [...], but subscription is cancelled」をログに記録しなくなりました。 + **空のパラメータ文字列** – ドライバーは、接続パラメータに存在する空の文字列を、パラメータが存在しないかのように処理するようになりました。これにより、一部の BI ツールが誤って空の文字列を渡して意図しない認証の試行が発生したときに発生する問題が解決されます。 ## 3.2.2 2024 年 7 月 29 日リリース ### 改良点 + **データ型マッピング** — ドライバーが `tinyint`、`smallint`、`row`、および `struct` データ型を Java オブジェクトにマッピングする方法を変更することで、JDBC 仕様への準拠を改善しました。 + **AWS SDK バージョンの更新** – ドライバーで使用されている AWS SDK バージョンが 2.26.23 に更新されました。 ### 修正内容 + **コメント** – ステートメントの最後にある行コメントの問題を修正しました。 + **データベースのリスト** — ページ分割された `ListDatabases` API によって返された最後のページが空の場合に、リストデータベースが無限ループに入る可能性がある問題を修正しました。 ## 3.2.1 2024 年 7 月 3 日リリース ### 改良点 + **JWT 認証情報プロバイダー** – ユーザー指定のセッション期間のサポートが追加されました。詳細については、「[ロールセッションの期間](jdbc-v3-driver-jwt-credentials.md#jdbc-v3-driver-jwt-role-session-duration)」を参照してください。 ### 修正内容 + **スレッドプール** – `ForkJoin` プールを使用しないように、非同期タスク用に接続ごとに `ThreadPoolExecutor` が 1 つずつ作成されました。 + **認証情報プロバイダー** – HTTP クライアントが外部 IdP 用に設定されている場合、プロキシホストが解析され、スキームとホストが取得されるようになりました。 + **デフォルトの認証情報プロバイダー** – デフォルトの認証情報プロバイダーをクライアントコードで閉じることができないようにしました。 + **getColumns** – `DatabaseMetaData#getColumns` メソッドの `ORDINAL_COLUMN` 列プロパティの問題を修正しました。 + **ResultSet** – `Infinity`、`-Infinity`、および `NaN` のサポートが `ResultSet.` に追加されました カタログオペレーションから返される列タイプと、完了したクエリの結果セットの間の不一致が修正されました。 ## 3.2.0 2024 年 4 月 26 日リリース ### 改良点 + **カタログ操作のパフォーマンス** – ワイルドカード文字を使用しないカタログ操作のパフォーマンスが改善されました。 + **最小ポーリング間隔の変更** – 最小ポーリング間隔のデフォルトを変更し、ドライバーが Athena に対して行う API 呼び出し回数を減らしました。クエリ候補がすばやく検出されます。 + **BI ツールの検出可能性** – ビジネスインテリジェンスツールのドライバーをより簡単に検出できるようになりました。 + **データ型マッピング** – Athena `binary`、`array`、および `struct` DDL データ型へのデータ型マッピングが改善されました。 + **AWS SDK バージョン** – ドライバーで使用されている AWS SDK バージョンが 2.25.34 に更新されました。 ### 修正内容 + **フェデレーションカタログのテーブルリスト** – フェデレーションカタログが空のテーブルリストを返す問題を修正しました。 + **getSchemas** – JDBC [DatabaseMetadata\$1getSchemas](https://docs.oracle.com/javase/8/docs/api/java/sql/DatabaseMetaData.html#getSchemas--) メソッドが、すべてのカタログからではなくデフォルトのカタログからのみデータベースを取得する問題を修正しました。 + **getColumns** – 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 カタログ名で呼び出されたときに、null カタログが返される問題を修正しました。 ## 3.1.0 2024 年 2 月 15 日リリース ### 改良点 + 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` データ型は、`other` ではなく Athena `integer` と同じ JDBC 型にマップされるようになりました。 + Athena の列メタデータにオプションの `precision` および `scale` フィールドが含まれていない場合、ドライバーは `ResultSet` 列内の対応する値に 0 を返すようになりました。 + AWS SDK バージョンは、2.21.39 に更新されました。 ### 修正内容 + Athena からのプレーンテキスト結果の列数が Athena 結果メタデータの列数と一致しない場合に例外が発生する `GetQueryResultsStream` の問題を修正しました。 ## 3.0.0 2023 年 11 月 16 日リリース Athena JDBC 3.x ドライバーは、より優れたパフォーマンスと互換性を提供する新世代ドライバーです。JDBC 3.x ドライバーは、Amazon S3 からの直接的なクエリ結果の読み取りをサポートするので、大規模なクエリ結果を使用するアプリケーションのパフォーマンスが向上します。新しいドライバーではサードパーティーとの依存関係も少なくなっているため、BI ツールやカスタムアプリケーションとの統合が容易になります。 # 以前のバージョンの Athena JDBC 3.x ドライバー [最新バージョン](jdbc-v3-driver.md)の JDBC 3.x ドライバーを使用することを強くお勧めします。ドライバーの最新バージョンには、最新の改良と修正が含まれています。ご使用のアプリケーションが最新バージョンと互換性がない場合にのみ、古いバージョンを使用してください。 ## JDBC ドライバー uber jar 次のダウンロードは、ドライバーおよびそのすべての依存関係を同じ `.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 次のダウンロードには、ドライバー用の lean `.jar` およびドライバーの依存関係用の個別 `.jar` ファイルを含む `.zip` ファイルです。このダウンロードは、ドライバーが使用する依存関係と競合する依存関係を持つカスタムアプリケーションによく使用されます。このダウンロードは、ドライバーの依存関係のどっちを lean jar に含め、カスタムアプリケーションに既に 1 つ以上含まれている場合はどの依存関係を除外するかを選択する場合に便利です。 + [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)