Skip to content

AWS Athena Guide (Beta)


It only takes a few minutes to get started with Satori. What you need is:

  • Access to Satori's management console.
  • The AWS region where your Athena data is hosted, for example: us-east-1 for AWS in N. Virginia.

Adding an AWS Athena Data Store to Satori

  1. Login to Satori's management console at
  2. In the Data Stores view, select Add Data Store.
  3. Select the AWS Athena option.
  4. Enter an informative name for the data store, for example: Sales Data Warehouse.
  5. Select the AWS region where your data is hosted, for example: us-east-1.
  6. Click Create. You will be redirected to the Data Stores list.

Connect to AWS Athena via Satori

To connect to AWS Athena using Satori use the Satori hostname that was generated by the management console which can be found under Satori Hostname in the data store settings view, for example:

Authenticating with AWS Credentials

AWS Athena uses a different authentication scheme than most other databases - the client does not send the password to the server on the HTTP request, to be checked by the server. Instead, the client uses the password to cryptographically sign the HTTP request and the server checks that signature.

To support this authentication scheme, Satori needs to re-sign the HTTP request before it sends it to Athena using the credentials of the user.

To send the user credentials to Satori, concatenate the AWS_SECRET_KEY to the AWS_ACCESS_KEY as follows: AWS_ACCESS_KEY|AWS_SECRET_KEY.

The AWS_SECRET_KEY is being transmitted from the client to Satori over a TLS-encrypted connection, and is not stored or logged by Satori in any way. However, since some client tools may not consider the AWS_ACCESS_KEY parameter as a secret like AWS_SECRET_KEY, it is advised to avoid specifying it explicitly in connection parameters and use alternative methods like environment variables, reading it from a file or from a password manager.

Connecting with the JDBC driver

To connect with the JDBC driver, override or add the following parameters in the JDBC URL:

  • EndpointOverride=<Satori Hostname>:443
  • UseResultsetStreaming=0
  • Password=<AWS_SECRET_KEY>

For example:


Connecting with Python

To connect with Python, set the endpoint_url argument to the client function, and the AWS credentials as described above. For example:

client = boto3.client(service_name='athena', region_name='us-east-1',

Network Policy Settings

Satori provides you with the ability to define your network security policy for your data store.


Simply, specify which IP addresses and subnet masks should be allowed access to the Data Store and which IP addresses and subnet masks should be blocked. Note that by default, Satori allows all IP address ranges if you leave the form empty.

Example 1

To allow all IP addresses leave the form empty. Screenshot

Examaple 2

To block specific IP addresses add them to the blocked IP address list. Screenshot

Example 3

To only allow access to specific IP addresses add them to the allow list. Note: Access from all ohter IP addresses ware blocked. Screenshot

Example 4

To allow access from a specific IP address range while blocking parts of the range add the IP range to the list of allowed IP addreses and add the IP address that you wish to block to the Block list. Screenshot