主な ODBC 2.x 接続パラメータ - Amazon Athena

主な ODBC 2.x 接続パラメータ

以下のセクションでは、主な各接続パラメータについて説明します。

データソース名

データソースの名前を指定します。

接続文字列名 パラメータタイプ デフォルト値 接続文字列の例
DSN DSN を使用しない接続タイプの場合のオプション none DSN=AmazonAthenaOdbcUsWest1;

説明

データソースの説明が含まれます。

接続文字列名 パラメータタイプ デフォルト値 接続文字列の例
説明 オプションです。 none Description=Connection to Amazon Athena us-west-1;

カタログ

データカタログ名を指定します。詳細については、「Amazon Athena API リファレンス」の「DataCatalog」を参照してください。

接続文字列名 パラメータタイプ デフォルト値 接続文字列の例
カタログ オプションです。 AwsDataCatalog Catalog=AwsDataCatalog;

リージョン

AWS リージョン を指定します。AWS リージョン の詳細については、「リージョンとアベイラビリティーゾーン」を参照してください。

接続文字列名 パラメータタイプ デフォルト値 接続文字列の例
AwsRegion 必須 none AwsRegion=us-west-1;

データベース

データベース名を指定します。詳細については、「Amazon Athena API リファレンス」の「Database」を参照してください。

接続文字列名 パラメータタイプ デフォルト値 接続文字列の例
Schema オプションです。 default Schema=default;

Workgroup

ワークグループ名を指定します。詳細については、「Amazon Athena API リファレンス」の「ワークグループ」を参照してください。

接続文字列名 パラメータタイプ デフォルト値 接続文字列の例
Workgroup オプションです。 primary Workgroup=primary;

出力場所

クエリ結果が保存される Amazon S3 内の場所を指定します。出力場所の詳細については、「Amazon Athena API リファレンス」の「ResultConfiguration」を参照してください。

接続文字列名 パラメータタイプ デフォルト値 接続文字列の例
S3OutputLocation 必須 none S3OutputLocation=s3://amzn-s3-demo-bucket/;

暗号化オプション

[ダイアログパラメータ名]: 暗号化オプション

暗号化オプションを指定します。暗号化オプションの詳細については、「Amazon Athena API リファレンス」の「EncryptionConfiguration」を参照してください。

接続文字列名 パラメータタイプ デフォルト値 使用できる値 接続文字列の例
S3OutputEncOption オプションです。 none NOT_SET, SSE_S3, SSE_KMS, CSE_KMS S3OutputEncOption=SSE_S3;

KMS キー

暗号化用の KMS キーを指定します。KMS キー用の暗号化設定に関する詳細については、「Amazon Athena API リファレンス」の「EncryptionConfiguration」を参照してください。

接続文字列名 パラメータタイプ デフォルト値 接続文字列の例
S3OutputEncKMSKey オプションです。 none S3OutputEncKMSKey=your_key;

接続テスト

ODBC データソース管理者には、Amazon Athena への ODBC 2.x 接続をテストするために使用できる [テスト] オプションが用意されています。この手順については、「Windows 上でのデータソース名を設定する」を参照してください。接続をテストすると、ODBC ドライバーは GetWorkGroup Athena API アクションをコールします。コールでは、指定した認証タイプと対応する認証情報プロバイダを使用して、認証情報を取得します。ODBC 2.x ドライバーを使用する場合、接続テストは無料です。このテストでは、Amazon S3 バケットにクエリ結果は生成されません。