PostgreSQL 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 ReplacementPostgreSQL 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 PostgreSQL server via its 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.

Options

Hostname
The hostname (or IP address) of a PostgreSQL server.
Port
The port on which the PostgreSQL server is listening. The default port is 5432.
Database name
The name of the database you want to connect to.
SSL
Connect using SSL.
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 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

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.