DB Merge

Merges (insert/updates) all data rows from the selected database table that match the values of a row from the selected KNIME input table columns. All selected column names of the KNIME table need to exactly match the column names from the database. The WHERE column values of the input KNIME data row need to match the values of the database row to update; whereas the SET database column values are replaced by the input KNIME column values. Only the rows matching all values of the selected column of any given input row will be updated. If no matching rows are found, the node inserts new row into the selected 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 Append merge statuses checkbox is checked. The first extra columns is the number of rows affected by the MERGE statement. A number greater than or equal to zero -- indicates that the command was processed successfully and is an update 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 column shows a warning message, if any.

Options

Settings

Table to merge

Click Select a table to select the table to merge 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 merged 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 merge 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 merge (SET in SQL)

Select the columns which should be merged in the database e.g. if a matching row exists the values of the selected columns are updated otherwise a new row is created and the values of the selected columns are inserted in to the corresponding database columns. 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.

Select identification columns (WHERE in SQL)

Select all columns used to identify the records in the database that should be merged. Only records in the database that match the values from the input table are merged. 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 WHERE 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.

Views

This node has no views

Workflows

• 2021_01_18_DB_MergeKNIME Forum
• 2021_01_18_DB_Merge_reproducedKNIME Forum
• Aufgabe2KNIME Hub
• Aufgabe7KNIME Hub
• BausteineKNIME Hub
• Show all 22 workflows

Links

• database insert or updateby ipazin on 2018-10-26

  forum.knime.com/p/49137
• Data loading too slow. What will happen if I cancel the execution?by izaychik63 on 2021-10-26

  forum.knime.com/p/137909
• Concatenation (?): update existing rows and add new onesby izaychik63 on 2019-02-20

  forum.knime.com/p/54873
• Help for add only new rowsby izaychik63 on 2020-06-16

  forum.knime.com/p/94424
• DB2 Inserts from Hadoopby izaychik63 on 2020-05-10

  forum.knime.com/p/90587
• Show all 12 links

Developers