Skip to main content
Version: v2.x

Get Started with Docker and Amazon Athena

Introduction

Currently, testing continues on the Amazon Athena connector for use in self-hosted environments. Our suggested installation method is to use Docker Compose to deploy a working deployment of Hasura with the Amazon Athena connector enabled.

In order to do this, follow the instructions for Hasura Enterprise Edition, but change out the Docker Compose files listed in that documentation with these values:

# in a new directory run
wget https://raw.githubusercontent.com/hasura/graphql-engine/master/install-manifests/enterprise/athena/docker-compose.yaml
# or run
curl https://raw.githubusercontent.com/hasura/graphql-engine/master/install-manifests/enterprise/athena/docker-compose.yaml -o docker-compose.yml

When you use these to launch the services, you'll see three containers running instead of two. The third container is the Amazon Athena GraphQL Connector agent. By navigating to the Hasura Console after execution, you'll find the Amazon Athena data source as a type that can now be added to your Hasura GraphQL Service instance.

You can check the health of the connector using the /health endpoint. The connector is available at the following endpoint:

http://localhost:8081/api/v1/athena/health
Data connector

This data source utilizes the hasura/graphql-data-connector to connect your data source to the GraphQL engine.

Keep up to date

Note

Currently, Hasura supports read-only queries, subscriptions, relationships, and permissions on Amazon Athena.

Please watch this space to get the latest docs on how you can try these features out via the Console or by manipulating Metadata in JSON/YAML directly.

If you'd like to stay informed about the status of Amazon Athena support, subscribe to our newsletter and join our discord!