feat(examples): add ibm_db2i community connector by fivetran-clgritton · Pull Request #32 · fivetran/community_connectors

fivetran-clgritton · 2026-06-25T15:50:33Z

Adds connector for IBM DB2 for i (IBM i / AS400) via pyodbc and the IBM i Access ODBC Driver. Includes full template formatting, CHECKPOINT_INTERVAL + BATCH_SIZE constants, drivers/installation.sh, and README.

Description of Change

The existing ibm_db2 example doesn't directly work for Db2 for i. Additionally, using the IBM ODBC driver with pyodbc seems to be faster in my testing. I'm creating a new basic community connector for Db2i using the ODBC driver.

Testing

Tested in Fivetran_Sales_Sandbox:

Checklist

Some tips and links to help validate your PR:

Tested by deploying to sandbox.
Added/Updated example-specific README.md file, see the README template for the required structure and guidelines.
Followed Python Coding Standards, refer here

Copilot

Pull request overview

Adds a new community connector example for IBM Db2 for i (IBM i / AS400) using pyodbc + the IBM i Access ODBC Driver, including setup assets and documentation, and links it from the repo root README.

Changes:

Added ibm/ibm_db2i example connector (connector.py) that batches DB reads via fetchmany() and upserts to a customer table.
Added supporting artifacts (requirements.txt, configuration.json, driver install script) plus an example-specific README.md.
Updated the repo root README.md to include the new connector in the examples list.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 16 comments.

Show a summary per file

File	Description
README.md	Adds the new `ibm_db2i` entry to the connector examples list.
ibm/ibm_db2i/requirements.txt	Declares `pyodbc` dependency for the example connector.
ibm/ibm_db2i/README.md	Documents setup, configuration, and behavior for the Db2 for i connector example.
ibm/ibm_db2i/drivers/installation.sh	Provides a Debian/Ubuntu install script for IBM i Access ODBC + unixODBC.
ibm/ibm_db2i/connector.py	Implements the connector (ODBC connect, batching, upserts, checkpointing).
ibm/ibm_db2i/configuration.json	Adds placeholder configuration values for community distribution.

fivetran-sahilkhirwal

can you please check copilot comments
Rest everything looks good

fivetran-JenasVimal

Everything looks good , please make these minor changes
Please address the co-pilot comments as well
Thank you

fivetran-JenasVimal

Changes look good ,
Please address the failing checks and receive approval from Tech Writers

fivetran-JenasVimal · 2026-07-03T07:57:18Z

Hi @fivetran-clgritton

Could you please rebase your PR so that the latest checks can run and pass

Thank you!

fivetran-chinmayichandrasekar

Left a few suggestions. Thanks

Adds connector for IBM DB2 for i (IBM i / AS400) via pyodbc and the IBM i Access ODBC Driver. Includes full template formatting, CHECKPOINT_INTERVAL + BATCH_SIZE constants, drivers/installation.sh, and README. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

- Apply black formatting (blank line, long line wrap) - Rename timeout -> timeout_seconds for unit clarity - Increase CHECKPOINT_INTERVAL to 10000 and DEFAULT_TIMEOUT_SECONDS to 60 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…ntry Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

- Add per-line comments to stdlib imports - Make constants private (__BATCH_SIZE, __CHECKPOINT_INTERVAL, __DEFAULT_TIMEOUT_SECONDS) - Update schema() docstring URL to new format - Validate port type in validate_configuration() - Narrow Exception to OSError in test_tcp() - Thread state through fetch_and_upsert_data() and use in checkpoints - Add final op.checkpoint() after fetch loop - Validate db_schema against allowlist to prevent SQL injection - Add timeout_seconds to README configuration parameters - Add Windows/macOS to README Requirements - Fix "Setup Guide" capitalization in Getting started - Fix Features: checkpoints every CHECKPOINT_INTERVAL rows, not per batch - Expand Tables created section with primary key guidance - Fix installation.sh: set -euo pipefail, remove apt-get update || true - Apply black line-length 99 formatting Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Adds table-namespaced state key (customer_last_update_timestamp) and parse_state_timestamp helper to enable incremental syncs after the initial full load. Updates README data handling section to describe the incremental strategy. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Co-authored-by: fivetran-chinmayichandrasekar <chinmayi.chandrasekar@fivetran.com>

fivetran-JenasVimal

LGTM

github-actions Bot added size/L ai-assisted/unknown risk/unknown labels Jun 25, 2026

fivetran-clgritton requested a review from fivetran-sahilkhirwal June 25, 2026 15:57

fivetran-clgritton self-assigned this Jun 25, 2026

fivetran-clgritton requested a review from fivetran-JenasVimal June 25, 2026 15:57

fivetran-clgritton added risk/low size/S and removed risk/unknown size/L labels Jun 25, 2026

github-actions Bot added size/L and removed size/S labels Jun 25, 2026

fivetran-clgritton added size/S ai-assisted/yes and removed size/L ai-assisted/unknown labels Jun 25, 2026

fivetran-sahilkhirwal requested a review from Copilot June 28, 2026 18:37

Copilot started reviewing on behalf of fivetran-sahilkhirwal June 28, 2026 18:38 View session

Copilot AI reviewed Jun 28, 2026

View reviewed changes

fivetran-sahilkhirwal reviewed Jun 28, 2026

View reviewed changes

fivetran-JenasVimal requested changes Jun 29, 2026

View reviewed changes

Comment thread ibm/ibm_db2i/README.md Outdated

Comment thread ibm/ibm_db2i/README.md

Comment thread ibm/ibm_db2i/connector.py Outdated

Comment thread ibm/ibm_db2i/connector.py

Comment thread ibm/ibm_db2i/connector.py Outdated

fivetran-clgritton requested a review from fivetran-JenasVimal June 30, 2026 18:02

fivetran-JenasVimal requested a review from fivetran-chinmayichandrasekar July 1, 2026 09:07

fivetran-JenasVimal requested changes Jul 1, 2026

View reviewed changes

fivetran-clgritton force-pushed the feature/ibm_db2i branch from 2903967 to f21cb3f Compare July 6, 2026 14:17

github-actions Bot added size/XXL and removed size/S labels Jul 6, 2026

fivetran-clgritton requested a review from fivetran-JenasVimal July 6, 2026 14:30

fivetran-chinmayichandrasekar reviewed Jul 6, 2026

View reviewed changes

Comment thread ibm/ibm_db2i/README.md Outdated

Comment thread ibm/ibm_db2i/README.md

Comment thread ibm/ibm_db2i/README.md Outdated

Comment thread ibm/ibm_db2i/README.md Outdated

fivetran-clgritton and others added 7 commits July 6, 2026 10:53

fix(ibm_db2i): fix black formatting (line-length 99) and add README e…

054ec4f

…ntry Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

fix(ibm_db2i): update __main__ block to match template comments exactly

a92e0e2

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Apply suggestions from code review

3db40e6

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

fivetran-clgritton force-pushed the feature/ibm_db2i branch from f21cb3f to 77f0689 Compare July 6, 2026 14:54

Apply suggestions from code review

fc77375

Co-authored-by: fivetran-chinmayichandrasekar <chinmayi.chandrasekar@fivetran.com>

github-actions Bot added size/L and removed size/XXL labels Jul 6, 2026

fivetran-JenasVimal requested review from fivetran-chinmayichandrasekar and fivetran-sahilkhirwal July 6, 2026 20:29

fivetran-JenasVimal approved these changes Jul 6, 2026

View reviewed changes

fivetran-sahilkhirwal reviewed Jul 9, 2026

View reviewed changes

Comment thread ibm/ibm_db2i/ibm-iaccess_1.1.0.29-1.0_amd64.deb

Uh oh!

Conversation

fivetran-clgritton commented Jun 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description of Change

Testing

Checklist

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

fivetran-sahilkhirwal left a comment

Choose a reason for hiding this comment

Uh oh!

fivetran-JenasVimal left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

fivetran-JenasVimal left a comment

Choose a reason for hiding this comment

Uh oh!

fivetran-JenasVimal commented Jul 3, 2026

Uh oh!

fivetran-chinmayichandrasekar left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

fivetran-JenasVimal left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

fivetran-clgritton commented Jun 25, 2026 •

edited

Loading

fivetran-JenasVimal left a comment •

edited

Loading