DB Insert

Inserts data rows into the selected database table based on the values from the selected KNIME input table columns. All selected column names need to exactly match the column names within the database table. The column order of the KNIME table and the database table do not need to match.
The output table contains two additional columns if the Append insert statuses checkbox is checked. The first extra column is the number of rows affected by the INSERT statement. A number greater than or equal to zero -- indicates that the command was processed successfully and is an insert count giving the number of rows in the database that were affected by the command's execution. A value of -2 -- indicates that the command was processed successfully but that the number of rows affected is unknown. The second shows a warning message, if any.

Options

Settings

Table to insert: Click Select a table to select the table to write to in the pop up dialog, or enter a valid Schema and Table name into the input fields.
Batch size: Enter a number greater than 0 for the number of rows insert in one batch job. Entering 1 disables batch processing. This way only one row is processed at a time.
Fail on error: Disable this if you want to continue after a database error.
Append insert status columns: Enable this to append two additional (status and error) columns to the output table (see description).
Disable DB Data output port: Select this option to disable the DB Data output port and the execution of the metadata query at the end of the node execution which might cause problems with databases that do not support subqueries.
Select the columns to insert (SET in SQL): Select the columns which should be inserted in the database. The column names in the KNIME input table need to match the column names in corresponding database table. In SQL this is equivalent to the SET columns.

Output Type Mapping

This tab allows you to define rules to map from KNIME types to database types.

Mapping by Name: Columns that match the given name (or regular expression) and KNIME type will be mapped to the specified database type.
Mapping by Type: Columns that match the given KNIME type will be mapped to the specified database type.

Input Ports

: KNIME data table with the data rows to be inserted into the database.
: DB Connection to the database.

Output Ports

: Input KNIME data table with additional columns providing the number of affected rows in the database and warnings, if checked in the dialog.
: DB Data referencing the selected database table.

Popular Predecessors

Popular Successors

Views

This node has no views

Workflows

Developers

You want to see the source code for this node? Click the following button and we’ll use our super-powers to find it for you.

Installation

To use this node in KNIME, install the extension KNIME Database from the below update site following our NodePit Product and Node Installation Guide:

v5.3

A zipped version of the software site can be downloaded here.

Plugin provider: KNIME AG, Zurich, Switzerland

Plugin version: 5.3.2.v202409010954

On NodePit since: 2024-07-09

Last update: 2024-11-21

Tags: Streamable

KNIME versions: Since v3.7

Deploy, schedule, execute, and monitor your KNIME workflows locally, in the cloud or on-premises – with our brand new NodePit Runner.

Try NodePit Runner!