pyathenajdbc

What it is and what it does

PyAthenaJDBC is a Python wrapper around the Amazon Athena JDBC driver that implements the DB API 2.0 standard (PEP 249). It allows you to execute SQL queries against Amazon Athena tables directly from Python code, handling the bridge between Python and the Java-based JDBC driver through jpype1.

The package supports basic query execution, cursor iteration, parameterized queries (using PyFormat style with named placeholders), and optional integration with SQLAlchemy (versions 1.0.0–1.x) and Pandas for result handling. You configure connections by specifying an S3 output location for query results and an AWS region, and can pass JVM options or JDBC driver configuration as keyword arguments. However, the project has been abandoned since late 2023 and is no longer maintained, meaning compatibility with current AWS Athena versions, modern Java runtimes, and Python versions beyond 3.9 is uncertain.

Use it for:

• Execute ad-hoc SQL queries against Athena tables from a Python script without setting up a separate database connection layer.
• Integrate Athena query results into a Pandas DataFrame for data analysis workflows.
• Build a Python application that uses SQLAlchemy ORM or query builder with Athena as the backend (SQLAlchemy 1.x only).
• Automate batch data extraction from Athena into Python for ETL or reporting pipelines.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

PyAthenaJDBC wraps the Amazon Athena JDBC driver to provide a Python DB API 2.0 (PEP 249) interface for querying Amazon Athena from Python.

No—not for new projects. The package is abandoned (last release 2020-12-31, repository archived 2023-09-20) and supports only Python 3.6–3.9, making it incompatible with modern Python versions. AWS Athena and its JDBC driver have evolved significantly since the last update, and there is no active maintenance to address compatibility issues. For current Athena access from Python, use boto3 with the AWS SDK or a maintained third-party driver.

Install

pyathenajdbc on PyPI

pip install pyathenajdbc

uv add pyathenajdbc

poetry add pyathenajdbc

Installing pyathenajdbc

Before you install

Installation is low-friction (pure Python wheel), but the package is abandoned as of 2023-09-20 with no active maintenance. The repository is archived and the latest release dates to 2020-12-31. Relies on jpype1 to bridge to Java, which requires a working JVM (Java >= 8 for JDBC 4.2).

License in practice

MIT license is permissive and imposes no significant restrictions on use or redistribution.

Quickstart

from pyathenajdbc import connect

conn = connect(S3OutputLocation='s3://YOUR_S3_BUCKET/path/to/',
               AwsRegion='us-west-2')
try:
    with conn.cursor() as cursor:
        cursor.execute('SELECT * FROM one_row')
        print(cursor.fetchall())
finally:
    conn.close()

Requires Java >= 8 (JDBC 4.2) installed and accessible to jpype1; Python 3.6–3.9 only.

Verify before relying

• Whether jpype1 dependency is compatible with modern Python versions beyond 3.9.
• Current compatibility with recent AWS Athena JDBC driver versions and changes to Athena API.
• Whether the package works reliably with modern Java versions (17+).

Package facts

Evidence: PyAthenaJDBC-3.0.1-py3-none-any.whl

Tags

More Front-Ends packages