AWS Athena Query Action

A GitHub Action to run an Athena query.

Dependencies

• AWS Command Line Interface
• Coreutils - GNU core utilities

All dependencies are pre-installed in the ubuntu-* runner images.

Usage

We recommend using GitHub's OIDC provider to authenticate with AWS before running this action.

steps:
- name: Run Athena Query
  uses: idealo/aws-athena-query-action@v1
  with:
    query-context: Catalog=AwsDataCatalog,Database=myDatabase
    query-string: |
      SELECT * FROM my_table
    output-location: s3://my-bucket/my-prefix
    output-filename: my-output.csv
    output-min-size: 10M

Inputs

See action.yml for more detail.

Name	Description	Required
query-id	The unique identifier of the saved query.	No
query-string	The SQL query statements to be executed.	Yes
query-context	The context within which the query executes.	Yes
output-location	The location in Amazon S3 where your query results are stored.	Yes
query-workgroup	The desired workgroup. default="primary".	No
output-filename	The desired name of the file where the query results are stored.	Yes
output-min-size	The minimum size of the output file in human-readable format.	Yes
download-location	The location on the runner machine where the query results are downloaded.	No
download-filename	The desired name of the file where the query results are downloaded.	No

If query-id is provided, the query-string will be overridden with the SQL statements from the saved query.

Outputs

See action.yml for more detail.

Name	Description
query-id	The unique identifier of the query execution.
output-location	The location in Amazon S3 where your query results are stored.

License

This project is licensed under the MIT License, see LICENSE for more information.