以下のセクションでは、主な各接続パラメータについて説明します。
データソース名
データソースの名前を指定します。
| 接続文字列名 | パラメータタイプ | デフォルト値 | 接続文字列の例 |
|---|---|---|---|
| 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 バケットにクエリ結果は生成されません。
