Connecting to Amazon Athena

You can import your data from Amazon Athena into a Sisense ElastiCube or Live models, using Introducing Live Models.

The Sisense Athena connector allows you to quickly connect to your Amazon S3 data to query and mashup data from Amazon S3. Amazon Athena allows you to tap into all your data in S3 without the need to set up complex processes to extract, transform, and load the data (ETL). Amazon Athena is an interactive query service that makes it easy to analyze data in Amazon S3 using standard SQL, which makes it easy for anyone with SQL skills to quickly analyze large-scale datasets. The data formats that Athena supports include CSV, JSON, Parquet, Avro, and ORC.

The connector supports the ability to preview and explore all catalogs and schema/databases that are listed under their catalogs.

The connector supports most field types, including array types. Sisense converts unrecognized types of data to strings, and issues a notification message about this.

The connector also supports accumulative builds by table, by field, and by a specific field that you set from the UI. This allows you to easily build only new data according to a specified index in your table without manually changing configuration files.

The connector allows you to use partitions to save time and money on the scanned data.

You can connect to Amazon Athena either by providing your IAM Credentials or by authenticating via a connection string, where you can connect via your IAM Profile or Instance Profile (EC2).

For a list of performance-tuning tips for Amazon Athena, see Top 10 Performance Tuning Tips for Amazon Athena.

Importing Partitioned Data

If your Amazon S3 data is partitioned, the Sisense Athena connector allows you to use partitions on the scanned data. Since you pay for the queries that you run in Athena, this ability saves you time and money.
For example, see below the difference in the amount of data scanned with and without partitions:

SELECT sum(l_tax)FROM lineitem_partioned WHERE l_shipdate = CAST('1992-02-02' as date)

SELECT sum(l_tax)FROM lineitem_partioned WHERE l_shipdate = CAST('1992-02-02' as date) AND dt = '1992-02-02'

Importing Data

To import data from Amazon S3:

1. In the Data page, open an ElastiCube or create a new ElastiCube.

2. In the Model Editor, click . The Add Data dialog box is displayed.

3. Click Amazon Athena. The Athena Connect area is displayed.

   

4. If connecting using your IAM Credentials, select Basic.

   • In Region, enter the region endpoint of your Athena instance. To find the region code from a region name, see AWS Regional Services.
   • In S3 Output Location , indicate the location where the query output files are downloaded. Athena will cache all query results in this location. For details, see Working with query results, recent queries, and output files.
   • In Access Key, provide your AWS access key. To find your AWS access key and secret key, see AWS Account and Access Keys.
   • In Secret Key , provide your AWS secret key.
   • (Optionally) In Additional Parameters, enter the appropriate configuration options by appending key-value pairs to the string (e.g., timeout=10;). This allows you to use all the parameters that are supported by the driver.

5. If connecting using different authentication methods, click Advanced. Sisense uses connection strings to connect to Athena and import data into Sisense. Connection strings contain authentication parameters that the data source uses to verify your identity and determine which information you can export to Sisense.
   Provide the connection string in the following structure:
   jdbc:awsathena:AwsRegion=<region>;User= <AWS access key>;Password=<AWS secret key>;S3OutputLocation=<location>;

   For details about building the connection string, see Using Athena with the JDBC driver.

6. If you are connecting to your EC2 instance, click EC2. EC2 is an Amazon service where you can install Sisense. This enables Sisense to run faster.

   • In Region, indicate the region endpoint of your Athena instance. To find the region code from a region name, see AWS service endpoints.
     

     Note:

     Amazon Athena is supported in the regions listed in AWS Regional Services.

   • In S3 Output Location, indicate the location to which the query output files are downloaded. Athena will cache all query results in this location. For details, click here.
   • In Additional Parameters, enter the appropriate configuration options, such as your credentials, by appending key-value pairs to the string (e.g., timeout=10;).

7. Click Next. A list of tables in the database are displayed. All tables and views associated with the database will appear in a new window.

8. From the Tables list, select the relevant table or view you want to work with. You can click next to the relevant table or click Preview to see a preview of the data inside it.

9. (Optional) Click + to customize the data you want to import with SQL. For more information, see Importing Data with Custom Queries.

10. (Optional)

    • ElastiCube
      Click + to customize the data you want to import with SQL. See Importing Data with Custom Queries for more information.
    • Live
      Click + to customize the data you want to access with SQL. See Creating Custom Live Table Queries for more information.

11. After you have selected all the relevant tables, click Done. The tables are added to your data model.

Limitations

Source Limitations

1. AWS places a limitation for query timeout which is 30 minutes. If your build takes longer, you can contact AWS Support to request a limit increase.

2. The number of DML queries you can submit simultaneously is 20 by default. DML queries include SELECT queries. You can contact AWS Support to request a limit increase.

Connector Limitations

1. The AWS Active Directory Federation Services using SAML 2.0 authentication method is not supported by the Sisense Athena connector.

2. While adding new tables, the Athena beta connector displays all the tables that exist in the data source, regardless of the user permissions/specified schema. As the connector may retrieve a long list of items, this can slow down the process of adding the tables.

Troubleshooting

If your builds are failing, check the following:

1. Port 444 is not open for outbound communication.

2. Is your Athena in the location defined in your Athena settings?

3. Is the size your data greater than 50GB?

4. What is the timeout limit in AWS? If you build takes longer than 30 minutes, you can contact AWS Support to request a limit increase.