Database Delete
Deletes data rows in the database based on the selected columns from the input table.
All selected column names need to exactly match the column names inside the database. Only the rows matching
the values of the selected column will be deleted.
The output table contains an additional column with the number of rows affected by the DELETE 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). By default, the
sun.jdbc.odbc.JdbcOdbcDriver (Windows and Linux) is only available.
Dialog Options
Settings
- Database Driver
-
Enter the database driver here; it is a Java class (including the
package path), for example: sun.jdbc.odbc.JdbcOdbcDriver
Additional driver can be registered via KNIME's preference page
(Database Driver).
- Database URL
-
Enter the database name here, for example:
jdbc:odbc:database_name or 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 rows should be deleted.
Column Selection
- WHERE columns
-
Select all columns used for the WHERE clause of the DELETE statement;
those column values need to match the corresponding value in the database
in order to run the delete.
Advanced
- Batch Size
-
Enter a number greater than 0 for the number of rows deleted in one batch job; 1 means on row at a time.
Ports
Input Ports
0 |
Table with data rows to be deleted in the database
|
1 |
An optional database connection that should be used instead of providing the connection information
in the dialog.
(optional) |
Output Ports
0 |
Input table with additional column providing number of affected rows in the database.
|
This node is contained in KNIME Base Nodes
provided by KNIME GmbH, Konstanz, Germany.