---
id: sqlalchemy-jdbcapi
version: "2.2.1"
license: Apache-2.0
license_treatment: permissive
maintenance: aging
---

# sqlalchemy-jdbcapi — Modern SQLAlchemy dialect for JDBC connections with native implementation

License: permissive · Maintenance: aging · Downloads: 218.3K/mo

## What it is and what it does

SQLAlchemy JDBC/ODBC API is a SQLAlchemy dialect that bridges Python to JDBC and ODBC database connections, enabling access to PostgreSQL, Oracle, MySQL, MariaDB, SQL Server, DB2, SQLite, OceanBase, GBase 8s, IBM iSeries, MS Access, and Apache Phoenix. It handles automatic JDBC driver download from Maven Central, eliminating manual driver setup for JDBC connections, while also supporting native ODBC for systems where a JVM is unavailable. The package integrates fully with SQLAlchemy's ORM, reflection, and Alembic migration tools, and includes asyncio support for async/await workflows and HikariCP connection pooling for high-performance scenarios.

The package targets developers who need to connect Python applications to enterprise or specialized databases via JDBC or ODBC without managing driver downloads manually. It requires Java 8+ for JDBC use and Python 3.10+, and provides type hints throughout. The maintainer explicitly notes that community feedback is essential for improving support across all databases, suggesting that some dialects may have less mature testing than others.

Use it for:

- Connect a Python application to Oracle or SQL Server databases via JDBC without manual driver installation.
- Use SQLAlchemy ORM and query reflection against PostgreSQL, MySQL, or MariaDB through JDBC.
- Migrate database schemas with Alembic across multiple database backends supported by the dialect.
- Build async database applications using asyncio with Core or ORM operations.
- Access specialized databases like OceanBase, GBase 8s, or Apache Phoenix from Python.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

SQLAlchemy dialect for JDBC and ODBC database connections with support for PostgreSQL, Oracle, MySQL, MariaDB, SQL Server, DB2, SQLite, OceanBase, GBase 8s, IBM iSeries, MS Access, and Apache Phoenix.

Yes, with conditions. Install if you need JDBC or ODBC connectivity to one of the supported databases and want SQLAlchemy integration without manual driver management. The low install friction and permissive license are favorable. However, maintenance is aging (268 days since last release), and the description explicitly requests community testing feedback, indicating some dialects may not be production-hardened. Verify that your target database is actively used by the community before deploying to production.

## Install

pip install sqlalchemy-jdbcapi
uv add sqlalchemy-jdbcapi
poetry add sqlalchemy-jdbcapi

## Installing sqlalchemy-jdbcapi

Before you install: Low install friction with a pure-wheel distribution. Maintenance status is aging—last release was 268 days ago—but the repository remains active with recent commits and no archived status. Depends on sqlalchemy and JPype1, both established packages.

License in practice: Licensed under Apache License 2.0 (permissive), which allows commercial and private use with minimal restrictions. No notable licensing constraints for typical adoption.

Quickstart:

pip install sqlalchemy-jdbcapi

from sqlalchemy import create_engine, text

engine = create_engine('jdbcapi+postgresql://user:password@localhost/mydb')
with engine.connect() as conn:
    result = conn.execute(text("SELECT * FROM users"))
    for row in result:
        print(row)

Requires Java Runtime Environment (JRE) 8 or later for JDBC connections; ODBC variant requires OS-installed ODBC driver. Python 3.10+ required.

Verify before relying:

- Extent of real-world testing coverage across all 18 database dialects—description notes reliance on community feedback for database support.
- Performance characteristics and connection pooling behavior under production load with HikariCP.
- Stability and maturity of asyncio support for Core and ORM operations.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 218.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

sqlalchemy jdbc dialect, jdbc database connection python, odbc sqlalchemy driver, oracle mysql postgresql jdbc, sqlalchemy multi-database support, jdbc-odbc, multi-database, orm-integration

[View on SkillFed](https://skillfed.io/packages/sqlalchemy-jdbcapi) · [View on PyPI](https://pypi.org/project/sqlalchemy-jdbcapi/)