メインコンテンツへスキップ

はじめに

Amazon Athenaは、Amazon S3内のビッグデータを標準的なSQLを使用して分析するための、サーバーを必要としないインタラクティブなクエリサービスです。DomoのAmazon Athena JDBC 2.0コネクターを使用して、Athenaインスタンスからクエリを実行します。DomoのAmazon Athena JDBC 2.0コネクターでJDBC 2.0を使用することにより、Amazon Athenaのデータを視覚化することができます。Amazon Athena APIの詳細については、Amazon社のウェブサイト( https://aws.amazon.com/documentation/athena/ )をご覧ください。 Amazon Athenaのアカウントには、Data Centerから接続します。このトピックでは、Amazon Athena JDBC 2.0コネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報については、「 コネクターを使用してDataSetを追加する 」を参照してください。

必要条件

Amazon Athenaアカウントに接続してDataSetを作成するには、以下が必要です。
  • AWSアクセスキー。
  • AWSシークレットキー。
  • クエリの出力が書き込まれるAmazon S3の場所(例: s3://aws-athena-query-results-1234-us-west-2/ )これは、Athena Webコンソールの [Settings] で参照できます。
  • AWSリージョン。
AWSの認証情報を取得する方法については、 http://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html を参照してください。

必要な権限ポリシー

AthenaやAmazon S3バケットなどのAWSサービスやリソースへのアクセス権を得るには、アプリケーションにJDBCドライバーの認証情報を指定します。JDBCドライバーを使用している場合は、 AmazonAthenaFullAccess管理ポリシー に記載されているすべてのアクションがIAMアクセス許可ポリシーに含まれていることを確認します。 AmazonAthenaFullAccess 管理ポリシーはAthenaへのフルアクセスを許可します。 管理ポリシーの内容は変更されるため、ここに表示されるポリシーは古くなる可能性があります。最新のポリシーについてはIAMコンソールを確認してください。
 { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "athena:*" ], "Resource": [ "*" ] }, { "Effect": "Allow", "Action": [ "glue:CreateDatabase", "glue:DeleteDatabase", "glue:GetDatabase", "glue:GetDatabases", "glue:UpdateDatabase", "glue:CreateTable", "glue:DeleteTable", "glue:BatchDeleteTable", "glue:UpdateTable", "glue:GetTable", "glue:GetTables", "glue:BatchCreatePartition", "glue:CreatePartition", "glue:DeletePartition", "glue:BatchDeletePartition", "glue:UpdatePartition", "glue:GetPartition", "glue:GetPartitions", "glue:BatchGetPartition" ], "Resource": [ "*" ] }, { "Effect": "Allow", "Action": [ "s3:GetBucketLocation", "s3:GetObject", "s3:ListBucket", "s3:ListBucketMultipartUploads", "s3:ListMultipartUploadParts", "s3:AbortMultipartUpload", "s3:CreateBucket", "s3:PutObject" ], "Resource": [ "arn:aws:s3:::aws-athena-query-results-*" ] }, { "Effect": "Allow", "Action": [ "s3:GetObject", "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::athena-examples*" ] }, { "Effect": "Allow", "Action": [ "s3:ListBucket", "s3:GetBucketLocation", "s3:ListAllMyBuckets" ], "Resource": [ "*" ] }, { "Effect": "Allow", "Action": [ "sns:ListTopics", "sns:GetTopicAttributes" ], "Resource": [ "*" ] }, { "Effect": "Allow", "Action": [ "cloudwatch:PutMetricAlarm", "cloudwatch:DescribeAlarms", "cloudwatch:DeleteAlarms" ], "Resource": [ "*" ] } ] } 

Amazon Athenaアカウントに接続する

このセクションでは、Amazon Athena JDBC 2.0コネクターページの [認証情報] および [詳細] ペインのオプションについて説明します。このページのほかのペインの項目である [スケジュール設定][DataSetに名前を付け、説明を入力] に関しては、ほとんどのタイプのコネクターで共通しています。詳細については「 コネクターを使用してDataSetを追加する 」を参照してください。

[認証情報]ペイン

このペインには、Amazon Athenaアカウントにアクセスするための認証情報を入力するフィールドがあります。下表では、各フィールドに必要な内容を説明しています。

フィールド

説明

Access Key AWSアクセスキーを入力します。
Secret Key AWSシークレットキーを入力します。
S3 Staging Directory クエリ出力を書き込むAmazon S3の場所を入力します。この場所は、Athena Webコンソールの [Setting] で確認することができます。例: s3://aws-athena-query-results-1234-us-west-2/
Region AWSリージョンを選択します。
Workgroup ワークグループを入力します。
Amazon Athenaの正しい認証情報をすると、同じアカウントを使用して新しいAmazon Athena JDBC 2.0 DataSetをいつでも作成できるようになります。コネクターのアカウントはData Centerの [アカウント] タブで管理することができます。このタブの詳細については、「 コネクターのユーザーアカウントを管理する 」を参照してください。

[詳細]ペイン

このペインには、クエリの入力やレポートの設定のためのオプションが多数含まれています。

メニュー

説明

Report

実行するAmazon Athena JDBC 2.0レポートを選択します。

Query

指定したS3データベースとテーブルに対してクエリを実行することができます。

Query Parameter パラメーターのあるSQLクエリを入力します。

Catalog Name / Data Source

クエリを実行する特定のカタログまたはデータソースをドロップダウンから選択します。

Database Name

クエリを実行するデータベースを選択します。

Table Name

クエリを実行するデータベース内のテーブルを選択します。

Table Columns

クエリを実行する列をすべて選択します。

Query Helper

クエリヘルパーは、選択されたデータベース名、テーブル名、および列名にもとづいて、サンプルのクエリを作成します。

Query

実行するSQLクエリを入力します(例:select * from table_name)。

Query Parameter

クエリパラメーターの値を入力します。この値は、クエリパラメーターの初期値となります。最終実行日はオプションです。指定されていない場合は、デフォルトで「02/01/1700」になります。

例: !{lastvalue:_id}!=1,!{lastvalue:gender}!=‘male’,!{lastrundate:start_date}!=02/01/1944

Connection Timeout

Athenaへの接続確立を目的とした試行が終了するまでの最長時間を、ミリ秒単位で入力します。デフォルト値は1万ミリ秒です。

Socket Timeout

Athenaにデータを送信するため、ソケットを待機する最長時間を、ミリ秒単位で入力します。デフォルト値は1万ミリ秒です。

Maximum Error Retries

JDBCクライアントがAthenaへのリクエストを実行する再試行回数の上限値を入力します。デフォルト値は10回です。

BIGINTをIntegerに変換します BIGINTカラムを整数に変換する場合は、このチェックボックスをオンにします。

その他のペイン

スケジュール設定、再試行、オプションの更新など、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。