n8n-nodes-ibmi-db2

This is an n8n community node. It lets you query a DB2 instance running on iSeries (AS400) in your n8n workflows.

I created this node for internal use (initially based off of GeorgeJeffcock/n8n's repo for reference as I was learning how to write custom nodes).
It uses node-jt400 to establish a TCP/IP connection to the database and runs a query returning the results as data that can be used in n8n.

n8n is a fair-code licensed workflow automation platform.

Requirements
Installation
Operations
Credentials
Compatibility
Resources

Requirements

Since this package uses node-jt400 to connect to IBMi/AS400, prior to installing the node, your environment will need to meet the following requirements:

Linux

• g++
• make

Windows

• Windows Build Tools

Mac

• Xcode IDE

Docker

Due to its dependencies, currently this package is not compatible with the Docker version of n8n out of the box, unless you modify the base image to include the required tools as shown in the workaround below.

Workaround

1. Create a new Dockerfile and paste the following content:

   # Use the latest image from n8n
   FROM n8nio/n8n:latest
   
   # Switch to root user
   USER root
   
   # Install packages necessary to build the custom node's dependencies
   RUN apk add --update --no-cache bash make g++ make python3 py3-pip openjdk8
   
   # Switch back to node user
   USER node

2. From the same folder run docker build -t my_custom_image/n8n .
3. If you did not create a volume for n8n yet run docker volume create n8n_data
4. Run docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n my_custom_image/n8n (Refer to the official documentation for additional options)

You should now be able to install the node from the frontend without errors.

Note

You will need to rebuild your custom image any time you want to update to a newer version of n8n.

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

• Query - Execute a SQL query
• Insert - Insert rows in database
• Update - Update rows in database
• Delete - Delete rows in database

Credentials

The node supports the following credentials/settings:

• Host - TCP/IP host name/address of the database server
• User - User name for connecting to the database
• Password - Password for connecting to the database
• Database (optional) - Default database/schema
• Libraries (optional) - Specifies one or more libraries that you want to add/replace in the library list
• Port (optional) - Connection port
• Translate Binary (optional) - Specifies whether binary data is translated. If this property is set to "true", then BINARY and VARBINARY fields are treated as CHAR and VARCHAR fields (Default: True)
• Translate Boolean (optional) - Specifies how Boolean objects are interpreted when setting the value for a character field/parameter. Setting the property to "false", would store the Boolean object in the character field as either "1" or "0 (Default: False)"

Compatibility

Developed and tested on n8n v1.14.2. I did not test any previous version, so if you feel like trying and reporting back I will update this README.

Resources

• n8n community nodes documentation
• node-jt400 npm page
• IBM Toolbox JDBC properties