dbt-ibmdb2 0.1.4

The db2 adapter plugin for dbt (data build tool)

dbt-ibmdb2

This plugin ports dbt functionality to IBM DB2.

This is an experimental plugin:

• We have not tested it extensively
• Tested with dbt-adapter-tests and DB2 LUW on Mac OS+RHEL8
• Compatiblity with other dbt packages (like dbt_utils) is only partially tested

Please read these docs carefully and use at your own risk. Issues welcome!

TODO

• Implement support for quoting on tables and schemas
• Check compatibility with DB2 for z/OS

Table of Contents

• Installation
• Supported features
• Configuring your profile
• Notes
• Running Tests
• Reporting bugs

Installation

This plugin can be installed via pip:

$ pip install dbt-ibmdb2

Supported features

DB2 LUW	DB2 z/OS	Feature
✅	🤷	Table materialization
✅	🤷	View materialization
✅	🤷	Incremental materialization
✅	🤷	Ephemeral materialization
✅	🤷	Seeds
✅	🤷	Sources
✅	🤷	Custom data tests
✅	🤷	Docs generate
✅	🤷	Snapshots

Notes:

• dbt-ibmdb2 is built on the ibm_db python package and there are some known encoding issues related to z/OS.

Configuring your profile

A dbt profile can be configured to run against DB2 using the following configuration example:

Example entry for profiles.yml:

your_profile_name:
  target: dev
  outputs:
    dev:
      type: ibmdb2
      schema: analytics
      database: test
      host: localhost
      port: 50000
      protocol: TCPIP
      username: my_username
      password: my_password

Option	Description	Required?	Example
type	The specific adapter to use	Required	ibmdb2
schema	Specify the schema (database) to build models into	Required	analytics
database	Specify the database you want to connect to	Required	testdb
host	Hostname or IP-adress	Required	localhost
port	The port to use	Optional	50000
protocol	Protocol to use	Optional	TCPIP
username	The username to use to connect to the server	Required	my-username
password	The password to use for authenticating to the server	Required	my-password

Running Tests

See test/README.md for details on running the integration tests.

Reporting bugs

Want to report a bug or request a feature? Open an issue.

Credits

dbt-ibmdb2 is heavily inspired by and borrows from dbt-mysql and dbt-oracle.