Windows
Amazon Athena へのアクセスに Windows クライアントコンピューターを使用する場合は、Amazon Athena ODBC ドライバーが必要です。
Windows システム要件
ウェブブラウザを使用せずに Amazon Athena データベースに直接アクセスするクライアントコンピュータに、Amazon Athena ODBC ドライバーをインストールします。
使用する Windows システムは、以下の要件を満たしている必要があります。
-
管理者権限がある
-
次のいずれかの OS。
-
Windows 11、10 または 8.1。
-
Windows Server 2019、2016、または 2012。
-
-
最低でも 100 MB の空きディスク容量。
-
64 ビット Windows 用の Visual Studio の Microsoft Visual C++ 再頒布可能パッケージ
がインストールされている。
Amazon Athena ODBC ドライバーをインストールする
Windows 用 Amazon Athena ODBC ドライバーをダウンロードしてインストールする方法
-
AmazonAthenaODBC-2.インストールファイルをダウンロードします。x.x.x.msi -
インストールファイルを起動し、[次へ] を選択します。
-
使用許諾契約書の条項に同意する場合は、チェックボックス > [次へ] の順に選択します。
-
インストール場所を変更するには、[参照] を選択して目的のフォルダを参照し、[OK] を選択します。
-
インストール場所を確定するには、[次へ] を選択します。
-
[Install] (インストール) を選択します。
-
インストールが完了したら、[完了] を選択します。
ドライバー設定オプションの設定方法
Windows の Amazon Athena ODBC ドライバーの動作を制御するには、次の方法でドライバー設定オプションを指定できます。
-
データソース名 (DSN) を設定する場合は [ODBC データソース管理者] プログラム内で設定。
-
次の場所に Windows レジストリキーを追加または変更する。
HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\YOUR_DSN_NAME -
プログラムで接続するときに、接続文字列にドライバーオプションを設定する。
Windows 上でのデータソース名を設定する
ODBC ドライバーをダウンロードしてインストールした後、クライアントコンピュータか Amazon EC2 インスタンスにデータソース名 (DSN) エントリを追加する必要があります。SQL クライアントツールは、このデータソースを使用して Amazon Athena データベースに接続し、クエリします。
システム DSN エントリを作成するには
-
Windows の [スタート] メニューから [ODBC データソース (64 ビット)] を右クリックし、[その他] > [管理者として実行] の順に選択します。
-
[ODBC データソース管理者] で、[ドライバー] タブを選択します。
-
[名前] 列に [Amazon Athena ODBC (x64)] が表示されていることを確認します。
-
次のいずれかを行います。
-
コンピュータ上のすべてのユーザーに対してドライバーを設定する場合は、[システム DSN] タブを選択します。別のアカウントを使用してデータをロードするアプリケーションでは、別のアカウントのユーザー DSN を検出できない場合があるため、システム DSN 構成オプションを使用することをお勧めします。
注記
[システム DSN] オプションを使用するには、管理者権限が必要です。
-
ユーザーアカウントのみに対してドライバーを設定するには、[ユーザー DSN] タブを選択します。
-
-
追加] を選択します。[新しいデータソースを作成] ダイアログボックスが開きます。
-
[Amazon Athena ODBC (x64)] > [完了] の順に選択します。
-
[Amazon Athena ODBC 設定] ダイアログボックスに、次の情報を入力します。これらのオプションの詳細な情報については、主な ODBC 2.x 接続パラメータを参照してください。
-
[データソース名] に、データソースを識別するために使用する名前を入力します。
-
[説明] には、データソースをすばやく識別できるような説明を入力します。
-
[リージョン] には、Athena を使用する AWS リージョン の名前を入力します (例:
us-west-1)。 -
[カタログ] には、Amazon Athena カタログの名前を入力します。デフォルトは [AWSDataCatalog] で、AWS Glue によって使用されます。
-
[データベース] には、Amazon Athena データベースの名前を入力します。デフォルトは [デフォルト] です。
-
[ワークグループ] には、Amazon Athena ワークグループの名前を入力します。デフォルトは [プライマリ] です。
-
[S3 出力場所] に、クエリ結果が保存されることになる Amazon S3 内のロケーション (例:
s3://DOC-EXAMPLE-BUCKET/) を入力します。 -
(オプション) [暗号化オプション] で、暗号化オプションを選択します。デフォルト:
NOT_SET。 -
(オプション) [KMS キー] では、必要に応じて暗号 KMS キーを選択します。
-
-
IAM 認証の設定オプションを指定するには、[認証オプション] を選択します。
-
次の情報を入力します。
-
[認証タイプ] で [IAM 認証情報] を選択します。これがデフォルトです。使用できる認証タイプの詳細については、「認証オプション」を参照してください。
-
[ユーザー名] には、ユーザー名を入力します。
-
[パスワード] には、パスワードを入力します。
-
[セッショントークン] には、一時的な AWS 認証情報を使用する場合はセッショントークンを入力します。一時的な認証情報の詳細については、「IAM ユーザーガイド」の「AWS リソースを使用した一時的な認証情報の使用」を参照してください。
-
-
[OK] を選択します。
-
[Amazon Athena ODBC 設定] ダイアログボックスの下部で、[テスト] を選択します。クライアントコンピュータが Amazon Athena に正常に接続すると、[接続テスト] ボックスに [接続に成功しました] と表示されます。成功しなかった場合は、ダイアログボックスに関連するエラー情報と共に [接続に失敗しました] と表示されます。
-
[OK] を選択して、接続テストを閉じます。作成したデータソースが、[データソース名] リストに表示されます。
Windows で DSN なし接続を使用する
DSN を使用しない接続を使用すれば、データソース名 (DSN) なしでデータベースに接続できます。次の例は、Amazon Athena に接続する Amazon Athena ODBC (x64) ODBC ドライバーの接続文字列を示しています。
DRIVER={Amazon Athena ODBC (x64)};Catalog=AwsDataCatalog;AwsRegion=us-west-1;Schema=test_schema;S3OutputLocation= s3://DOC-EXAMPLE-BUCKET/;AuthenticationType=IAM Credentials;UID=YOUR_UID;PWD=YOUR_PWD;
