Amazon Athena

This article describes how to connect Tableau to Amazon Athena data and set up the data source.

Before you begin

Before you begin, gather this connection information:

  • Name of the server that hosts the database you want to connect to

  • Name of the S3 staging directory, for example, s3://aws-athena-query-results-123456785678-us-eastexample-2/

  • Amazon Web Services (AWS) access keys (access key ID and secret access key). For more information, see Access keys on the AWS website.

  • (Optional) Initial SQL statement to run every time Tableau connects

You must have Java installed on the computer that runs Tableau Desktop. For more information, see Driver Download on the Tableau website.

Driver required

This connector requires a driver to talk to the database. You might already have the required driver installed on your computer. If the driver is not installed on your computer, Tableau displays a message in the connection dialog box with a link to the Driver Download page where you can find driver links and installation instructions.

Make the connection and set up the data source

  1. Start Tableau and under Connect, select Amazon Athena. For a complete list of data connections, select More under To a Server. Then do the following:

    1. Enter the name of the server.

    2. Enter the name of the S3 staging directory.

    3. Enter your AWS access key ID in the Username field.

    4. Enter your AWS secret access key in the Password field.

    5. (Optional) Select Initial SQL to specify a SQL command to run at the beginning of every connection, such as when you open the workbook, refresh an extract, sign in to Tableau Server, or publish to Tableau Server. For more information, see Run Initial SQL.

    6. Select Sign In.

      If Tableau can't make the connection, verify that your credentials are correct. If you still can't connect, your computer is having trouble locating the server. Contact your network administrator or database administrator.

  2. On the data source page, do the following:

    1. (Optional) Select the default data source name at the top of the page, and then enter a unique data source name for use in Tableau. For example, use a data source naming convention that helps other users of the data source figure out which data source to connect to.

    2. Select the sheet tab to start your analysis.

      Use custom SQL to connect to a specific query rather than the entire data source. For more information, see Connect to a Custom SQL Query.

Amazon Athena data source example

Here is an example of an Amazon Athena data source using Tableau Desktop on a Windows computer:

Customize JDBC connections

Amazon Athena uses a JDBC connection, which you can customize using a properties file. For more information, see Customize JDBC Connections Using a Properties File in Tableau Community.

See also

Connect to your S3 data with the Amazon Athena connector in Tableau 10.3 (and later) - Tableau blog post with links to Amazon Athena resources.

Thanks for your feedback! There was an error submitting your feedback. Try again or send us a message.