Database Update

This Node Is Deprecated — This node is kept for backwards-compatibility, but the usage in new workflows is no longer recommended. The documentation below might contain more information.

This node is part of the deprecated database framework. For more information on how to migrate to the new database framework see the migration section of the database documentation.

Updates the data rows in the database with the data values from the input tables. All selected column names need to exactly match the column names from the database. The WHERE column values need to match the row to update; whereas the SET column values are replaced by the input row values.

The output table contains an additional column with the number of rows affected by the UPDATE 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.

If the optional input is connected the database connection information is taken from the port, otherwise you need to specify the connection information in the dialog.

Make sure you have your vendor-specific database driver registered in the KNIME preference page (section Database Driver).

Options

Settings

Database Driver
Enter the database driver here; it is a Java class (including the package path). Additional driver can be registered via KNIME's preference page (Database Driver).
Database URL
Enter the database name here, for example: jdbc:mysql://host:port/database_name
Workflow Credentials
If checked, the credentials (user and password) are used as defined on the workflow. The credential name links to the specified user and password. Those can be replaced or edit using the 'Workflow Credentials' menu available in the workflow context menu.
User Name
Your log-in user name for the database.
Password
Your log-in password for the database. Note, the password is de- and encrypted before handling it internally and is not stored inside the settings.
TimeZone
Select the TimeZone to convert the date, time or timestamp field into. The current implementation can't represent time zones. In order to support persisting those fields into a database, the time values can be changed according to the selected time zone, which is used as the offset (including the daylight saving time) for the original values: No Correction (use UTC) is used for workflows (created before 2.8) and doesn't apply any correction, Use local TimeZone uses the local time zone offset to correct the date field before reading or writing, and TimeZone: allows selecting the time zone to covert the date values into.
Allow spaces in column names
Some databases do not allow whitespace characters in column names. If your database supports spaces in column names you can enable this option. Otherwise whitespace characters will be replaced by underscores.
Table Name
Enter the name of the table in which the data should be updated.

Column Selection

SET columns
Select all columns used for the SET clause of the UPDATE statement; those column values are changing the data in the database.
WHERE columns
Select all columns used for the WHERE clause of the UPDATE statement; those column values need to match the corresponding value in the database in order to make the update.

Advanced

Batch Size
Enter a number greater than 0 for the number of rows updated in one batch job; 1 means on row at a time.

Input Ports

Icon
Table with data to be updated in the database
Icon
An optional database connection that should be used instead of providing the connection information in the dialog.

Output Ports

Icon
Input table with additional column providing number of affected rows in the database.

Views

This node has no views

Workflows

Links

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.