From 243eeadfd6994c6ac93467a334601fb23278888f Mon Sep 17 00:00:00 2001 From: dwa Date: Mon, 3 Apr 2017 17:22:40 +0200 Subject: [PATCH] installation instructions for AWS Athena (#2538) --- docs/installation.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/installation.rst b/docs/installation.rst index 7149950885..27bc4dd2df 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -206,12 +206,29 @@ Here's a list of some of the recommended packages. +---------------+-------------------------------------+-------------------------------------------------+ | Greenplum | ``pip install psycopg2`` | ``postgresql+psycopg2://`` | +---------------+-------------------------------------+-------------------------------------------------+ +| Athena | ``pip install "PyAthenaJDBC>1.0.9"``| ``awsathena+jdbc://`` | ++---------------+-------------------------------------+-------------------------------------------------+ Note that many other database are supported, the main criteria being the existence of a functional SqlAlchemy dialect and Python driver. Googling the keyword ``sqlalchemy`` in addition of a keyword that describes the database you want to connect to should get you to the right place. +(AWS) Athena +------------ + +This currently relies on an unreleased future version of `PyAthenaJDBC `_. If you're adventurous or simply impatient, you can install directly from git: :: + + pip install git+https://github.com/laughingman7743/PyAthenaJDBC@support_sqlalchemy + +The connection string for Athena looks like this :: + + awsathena+jdbc://{aws_access_key_id}:{aws_secret_access_key}@athena.{region_name}.amazonaws.com/{schema_name}?s3_staging_dir={s3_staging_dir}&... + +Where you need to escape/encode at least the s3_staging_dir, i.e., :: + + s3://... -> s3%3A//... + Caching -------