PyAthena
PyAthena is a Python DB API 2.0 (PEP 249) client for Amazon Athena.
Requirements
-
Python
- CPython 3.10, 3.11, 3.12, 3.13, 3.14
Installation
$ pip install PyAthena
Extra packages:
| Package | Install command | Version |
|---|---|---|
| SQLAlchemy | pip install PyAthena[SQLAlchemy] |
>=1.0.0 |
| Pandas | pip install PyAthena[Pandas] |
>=1.3.0 |
| Arrow | pip install PyAthena[Arrow] |
>=10.0.0 |
| Polars | pip install PyAthena[Polars] |
>=1.0.0 |
Usage
from pyathena import connect
cursor = connect(s3_staging_dir="s3://YOUR_S3_BUCKET/path/to/",
region_name="us-west-2").cursor()
cursor.execute("SELECT * FROM one_row")
print(cursor.description)
print(cursor.fetchall())
Native asyncio is also supported:
import asyncio
from pyathena import aconnect
async def main():
async with await aconnect(s3_staging_dir="s3://YOUR_S3_BUCKET/path/to/",
region_name="us-west-2") as conn:
cursor = conn.cursor()
await cursor.execute("SELECT 1")
print(await cursor.fetchone())
asyncio.run(main())
License
Many of the implementations in this library are based on PyHive, thanks for PyHive.
Links
- Documentation: https://pyathena.dev/
- PyPI Releases: https://pypi.org/project/PyAthena/
- Source Code: https://github.com/pyathena-dev/PyAthena/
- Issue Tracker: https://github.com/pyathena-dev/PyAthena/issues
Logo
The PyAthena logo was generated using Nano-Banana Pro (Gemini 3 Pro Image).
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pyathena-3.29.1.tar.gz.
File metadata
- Download URL: pyathena-3.29.1.tar.gz
- Upload date:
- Size: 126.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ac1294693fb7c6b3324a4462b6a3d9c4e23683d04cf0356df1be6787f66caaff
|
|
| MD5 |
f1e36d3558fff3af879ab3a93c1c8e80
|
|
| BLAKE2b-256 |
6cc2319e5faed7e7d986a43b1278dec9209e025bfa467aca3d4f5b08d5dad015
|
Provenance
The following attestation bundles were made for pyathena-3.29.1.tar.gz:
Publisher:
release.yaml on pyathena-dev/PyAthena
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pyathena-3.29.1.tar.gz -
Subject digest:
ac1294693fb7c6b3324a4462b6a3d9c4e23683d04cf0356df1be6787f66caaff - Sigstore transparency entry: 975867822
- Sigstore integration time:
-
Permalink:
pyathena-dev/PyAthena@52dfba6142561f032cb225c5848986ae1f6ef8f3 -
Branch / Tag:
refs/tags/v3.29.1 - Owner: https://github.com/pyathena-dev
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yaml@52dfba6142561f032cb225c5848986ae1f6ef8f3 -
Trigger Event:
push
-
Statement type:
File details
Details for the file pyathena-3.29.1-py3-none-any.whl.
File metadata
- Download URL: pyathena-3.29.1-py3-none-any.whl
- Upload date:
- Size: 181.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
23894c643deaa89f7f8d2563f162c99039931fb01718bf7e4529f4acd883981c
|
|
| MD5 |
343c4bfd908fe38a7e8b18c83efa4a78
|
|
| BLAKE2b-256 |
c398cdd842d1c71e82196d6c7cb6873ad0a7508f73112b550458087754b47a3d
|
Provenance
The following attestation bundles were made for pyathena-3.29.1-py3-none-any.whl:
Publisher:
release.yaml on pyathena-dev/PyAthena
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pyathena-3.29.1-py3-none-any.whl -
Subject digest:
23894c643deaa89f7f8d2563f162c99039931fb01718bf7e4529f4acd883981c - Sigstore transparency entry: 975867825
- Sigstore integration time:
-
Permalink:
pyathena-dev/PyAthena@52dfba6142561f032cb225c5848986ae1f6ef8f3 -
Branch / Tag:
refs/tags/v3.29.1 - Owner: https://github.com/pyathena-dev
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yaml@52dfba6142561f032cb225c5848986ae1f6ef8f3 -
Trigger Event:
push
-
Statement type:
