Connect your Athena

In order to connect your Athena cluster, Whaly needs some credentials. This guide will details the necessary steps:

  1. Create an IAM User and generate an Access Key (+secret)

  2. Select your region & work group


To connect Athena to Whaly, you need the following:

  • An AWS Project

  • Admin rights on the AWS Project (to create IAM User, custom policy and a S3 Bucket)

  • An S3 bucket on which the query results can be written. You can create one if needed.

To save cost on the Output Bucket, you can configure its Bucket Lifecycle rule to delete any file after 1 day as the results won't be used after a query have resolved.

Create an IAM User and generate an Access Key (+secret)

To connect to your AWS Athena cluster, Whaly need to have a User and its credentials (Access Key). In order to create such a User, please follow this guide.

When being asked which permissions and policies the user should have, please create a custom Policy that have the following rights:

In the Policy definition, you need to fill the ARNs of the S3 buckets that Whaly will have access to.

Whaly user needs to access to 2 kinds of S3ย buckets:

  • Input buckets: Those are the buckets in which you have the data that is being queried by Athena

  • A single Output bucket: This is the bucket that Whaly will use to store the query results

    "Version": "2012-10-17",
    "Statement": [
            "Effect": "Allow",
            "Action": [
            "Resource": "*"
            "Effect": "Allow",
            "Action": [
            "Resource": "*"
            "Effect": "Allow",
            "Action": [
            "Resource": [
            // In this list, you should include the S3 ARNs of both inputs and output buckets
            // Ex:
            // Output bucket
            // "arn:aws:s3:::whaly-athena-output/*",
            // "arn:aws:s3:::whaly-athena-output",
            // Input buckets
            // "arn:aws:s3:::whaly-athena-input",
            // "arn:aws:s3:::whaly-athena-input/*",
            // ...
  • Once the IAM User created with the proper policy, you can create an Access Key under it to retrieve the Access Key Id and the Access Key Secret.

Select your region & Workgroup

In order to properly query your Athena data, Whaly needs to know in which region you want to run the compute. It should be one of the AWS Region (ex. us-east1). A good practise would be to use the same one as the one you are using when doing SQL Queries in the console:

Also, you'll need to select an existing work group or create one. Inside Whaly, you'll need to pass the name of the Workgroup you wish to use when querying your data with Whaly.

Last updated