Full guide: Athena data output
This article provides a full guide on how to create an Amazon Athena data output in Upsolver.
Last updated
This article provides a full guide on how to create an Amazon Athena data output in Upsolver.
Last updated
1. Go to the Outputs page and click New.
2. Select Amazon Athena as your output type.
3. Name your output and select your Data Sources, then click Next.
Click Properties to review this output's properties. See: Output properties
4. Click the information iconin the fields tree to view information about a field. The following will be displayed:
How many of the events in this data source include this field, expressed as a percentage (e.g. 20.81%).
The percentage distribution of the field values. These distribution values can be exported by clicking Export.
5. Click the information iconnext to a hierarchy element (such as the overall data) to review the following metrics:
The number of fields in the selected hierarchy.
6. Click the plus iconin the fields tree to add a field from the data source to your output. This will be reflected under the Data Source Field in the Schema tab. If required, modify the Output Column Name along with the Column Type.
Note: All numbers are mapped to doubles by default. Change this to BIGINT if you know that your numbers are integers.
Toggle from UI to SQL at any point to view the corresponding SQL code for your selected output.
You can also edit your output directly in SQL. See: Transform with SQL
7. Add any required calculated fields and review them in the Calculated Fields tab. See: Adding calculated fields
8. Add any required lookups and review them under the Calculated Fields tab.
9. Through the Filters tab, add a filter like WHERE in SQL to the data source.
See: Adding filters
10. Click Make Aggregated to turn the output into an aggregated output. Read the warning before clicking OK and then add the required aggregation. This aggregation field will then be added to the Schema tab. See: Aggregation functions
11. In the Aggregation Calculated Fields area under the Calculated Fields tab, add any required calculated fields on aggregations. See: Functions, Aggregation functions
12. Partition the data by clicking More > Manage Partitions and then selecting the following:
Key: Partitions the data table using one or more fields (or calculated fields)
Partitioning Time: Partitions the data table using a specific time field
13. To keep only the latest event per upsert key, click More > Manage Upserts then select the following:
Keys: A unique key identifying a row in the table
Deletions: The delete key (events with the value true in their deletion key field will be deleted)
See: Data types and features, How do upserts work?
Click Preview at any time to view a preview of your current output.
14. Click Run and fill out the following fields:
S3 Storage: The storage for the data of the table; the access key of this storage must belong to the same AWS account as the access key of the selected connection
Connection: How to create a new connection
Database Name
Table Name
See: Running an output
15. Click Next and complete the following:
Select the compute cluster to run the calculation on. Alternatively, click the drop-down and create a new compute cluster.
16. Finally, click Deploy to run the output. It will show as Running in the output panel and is now live in production and consumes compute resources.
You have now successfully outputted your table to Athena.
