Microsoft SQL Server Connector

This Node Is Deprecated — This version of the node has been replaced with a new and improved version. The old version is kept for backwards-compatibility, but for all new workflows we suggest to use the version linked below.
Go to Suggested ReplacementMicrosoft SQL Server Connector

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.

This node creates a connection to a Microsoft SQL Server via the available JDBC driver. You need to provide the server's hostname (or IP address), the port, and a database name. Login credentials can either be provided directly in the configuration or via credentials set on the workflow.

By default the open source driver jTDS is used. Visit the jTDS Project for more information. It is also possible to register additional drivers in the preferences.


The hostname (or IP address) of a Microsoft SQL Server.
The port on which the SQL Server is listening. The default port is 1433.
Database name
The name of the database you want to connect to.
Optional connection parameter such as ssl or authentication options.
For jTDS specific settings see jTDS FAQ
Use credentials
Selection this option if you want to provide authentication data via workflow credentials. Then select the desired credential name in the list below.
Use username & password
Provide a username and a password for authentication. The password may be optional if the server is configured accordingly.
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 replace 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

A database JDBC connection


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.