H2 Connector (legacy)

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

This node creates a connection to a H2 database file via its JDBC driver. You need to provide the path to the file. No username and password are required for H2 databases.

Note that H2 converts all column names to uppercase therefore we quote them so that their case is retained. This means that if you are writing your own SQL code (e.g. in the Database Table Selector) you have to quote column names, too (using double quotes).

Options

Path
The path to the H2 database file.
Timezone correction
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
  • Use selected timezone allows selecting the time zone to covert the date values into.
Allow spaces in column names
Check this option if the database can handle spaces in column names. Otherwise KNIME will replaces them by underscores.
Validate connection on close
Check this option if you want to validate the connection when closing the dialog.
Retrieve metadata in configure
This option controls subsequent nodes. Usually when a database node is configured it retrieves the metadata of the current table or query from the database for usage in subsequent nodes. If metadata retrieval takes quite some time it will slow down workflow configuration and execution noticeably, especially since metadata is retrieved in both configure and execute. In such cases it's better to switch this option off and only retrieve metadata during execute.

Input Ports

This node has no input ports

Output Ports

Icon
A database JDBC connection

Views

This node has no views

Workflows

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