Skip to main content

Amazon Athena Connections

Amazon Athena is a service that enables a data analyst to perform interactive queries in the AWS public cloud on data stored in Amazon Simple Storage Service (S3)For more information, see


This connection is in early preview. It is read-only and available only in SaaS product editions. For more information on early previews, see Early Preview Connection Types.

Limitations and Requirements


During normal selection or import of an entire table, you may encounter an error indicating a problem with a specific column. Since some tables require filtering based on a particular column, data from them can only be ingested using custom SQL statements. In this case, the problematic column can be used as a filter in the WHERE clause of a custom SQL statement to ingest the table.

  • For more information, please consult the CData driver documentation for the specific table.

  • For more information on using custom SQL, see Create Dataset with SQL.


For filtering date columns, this connection type supports a set of literal functions on dates. You can use these to reduce the volume of data extracted from the database using a custom SQL query. For more information, see the pg_dateliteralfunctions.htm page in the driver documentation for this connection type.

  • Supports authentication using AWS key and secret.

Create Connection

via Cloud Portal

When you create the connection, please review the following properties and specify them accordingly:

Connection Property


AWS Region

The hosting region for your Amazon Web Services resources.

For more information, see

S3 Staging Directory

Specifies the location in your S3 bucket where Amazon Athena can store the results of a query.


The name of the Amazon Athena database.

Connect String Options

The following are the connect string options passed to the JDBC driver by default:


Timeout - This value sets the connection timeout in seconds. Setting this value to 0 disables timeouts.

CleanQueryResults - The results of every query that runs on Amazon Athena is stored in the S3 staging directory. SettingCleanQueryResultstotrueclears the query results from the S3 staging directory after ingestion.

Access Key ID

AWS account access key. This value is accessible from your AWS security credentials page.

Secret access key

AWS account secret key. This value is accessible from your AWS security credentials page.

Default Column Data Type Inference

Leave this value as Enabled.

For more information, see the driver documentation .

via API

Depending on your product edition, you can create connections of this type. Key information:

"vendor": "amazon_athena",
"vendorName": "Amazon Athena",
"type": "jdbc"

For more information, see

Coming soon.

Data Type Conversions

For more information, see the driver documentation .