Database Reader

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.

Establishes and opens a database access connection to read data from.

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).


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.
Your log-in password for the database. Note, the password is de- and encrypted before handling it internally.
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.
SQL Statement
Enter SQL statement being execute here, for example SELECT * FROM table.
Additional SQL commands (create, drop, set parameter, etc.) can be arrange in front of the actual SELECT statement and are execute together line-by-line during configure and execute. Note, those additional SQL commands need to be separated by semicolon.
Run SQL query only during execute, skips configure
The SQL query is executed as it is without accessing the meta info from the database during configure, which results in an empty data table spec after configure.
Database Browser
Click Fetch Metadata to connect to the database using the entered settings and to fetch all tables and display them grouped by type in a tree view. Click on any table to retrieve all contained columns. Double-click on a table or column to insert its name into the SQL query at the current cursor position.
Flow Variable List
The list contains the flow variables that are currently available at the node input. Double clicking any of the entries will insert the respective identifier at the current cursor position (replacing the selection, if any).

Input Ports

An optional database connection that should be used instead of providing the connection information in the dialog.

Output Ports

Table with data read from the database


This node has no views




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.