skillfed

sqlalchemy-jdbcapi

Modern SQLAlchemy dialect for JDBC connections with native implementation

sqlalchemy-jdbcapi v2.2.1 218.3K downloads/30d#9,341 on PyPI27
Permissive license Apache-2.0 AGING released

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 on this page — 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

sqlalchemy-jdbcapi on PyPI

pip

pip install sqlalchemy-jdbcapi

uv

uv add sqlalchemy-jdbcapi

poetry

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 the current Python release (>=3.10)
Install friction low — pure-Python wheel
Runtime dependencies 2 — sqlalchemy, JPype1
Maintenance aging — 268 days since the last release
Last repo commit
First released
Downloads 218,280/month — #9,341 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: sqlalchemy_jdbcapi-2.2.1-py3-none-any.whl

Keywords: sqlalchemy, jdbc, database, postgresql, oracle, mysql, sql-server, db2, oceanbase

Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: Implementation :: CPythonTopic :: DatabaseTopic :: Database :: Front-EndsTopic :: Software Development :: Libraries :: Python ModulesTyping :: Typed

Tags

sqlalchemy jdbc dialectjdbc database connection pythonodbc sqlalchemy driveroracle mysql postgresql jdbcsqlalchemy multi-database support
jdbc-odbcmulti-databaseorm-integration

More Python Modules packages