Skip to main content

Provides support for DB2 for iSeries for remote python clients using IBM i Access Client Solutions ODBC driver

Project description

i Access Db2 SQLAlchemy Driver Documentation Status

Provides support for DB2 for iSeries for remote python clients using IBM i Access Client Solutions ODBC driver. On up-to-date systems (7.2+ with latest PTFs) you can also use this driver locally on your i Series machine, making local development of server code more feasible.

Other work in this area includes the ibm_db and ibm_db_sa projects, which also provide access to DB2 and support SQLAlchemy. Those two packages rely on and automatically install a binary driver for DB2, while this package relies on you already having install the i Access Client Solutions ODBC driver available on IBM’s support/download site.

  • Free software: MIT license



  • UnixODBC (if on Linux or in PASE for i): Windows ships with ODBC installed, but on Linux you’ll need unixodbc. On Ubuntu you can install this with apt-get install unixodbc. You may also need to apt-get install unixodbc-dev if you get errors about a missing sql.h file.

  • i Access Client Solutions ODBC driver: You’ll need this driver available only from IBM.

  • IBM i 7.2+ on your target system: Older versions of the OS may work but I have not tested against them. If you do not happen to have an IBM Power system sitting around your house (although who doesn’t?!) you may be able to get an account to play with at

Install via pip

Use pip to download and install the latest released version of this tool.:

pip install iaccess

Install via

Download or clone this repo and install via

python install


If you know what you’re doing with SQLAlchemy this package should be nearly invisible to you with the exception of the URI used to connect to the database.:

# connect via hostname / ip address
>>> from sqlalchemy import create_engine
>>> engine = create_engine('iaccess+pyodbc://user:password@hostname/dummy?DBQ=DEFAULT_SCHEMA')  # `dummy` can be any string

# connect via named ODBC DSN
>>> from sqlalchemy import create_engine
>>> engine = create_engine('iaccess+pyodbc://user:password@dsn_name')


This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

The IBM i Access ODBC Driver is developed and licensed separately by IBM.

Continuous integration testing is performed against the system available from the great guys at


0.4.2 (2022-04-22)

  • SERVER= is case-sensitive some versions of iaccess driver

0.2.1 (2020-10-20)

  • Add compilation of mod (%) operator to MOD() function, casting as bigint

0.2.0 (2020-04-02)

  • Warn when i Access driver is not found

0.1.4 (2020-04-01)

  • Fix deployment issue

0.1.2 (2020-04-01)

  • Fix entrypoint definition

0.1.1 (2020-04-01)

  • Remove Python 3.5 from list of supported versions

  • Fix deployment issue: correct PYPI key encryption

0.1.0 (2020-04-01)

  • First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iaccess-0.4.2.tar.gz (20.5 kB view hashes)

Uploaded source

Built Distribution

iaccess-0.4.2-py2.py3-none-any.whl (12.3 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page