DB Table Selector

This node takes a DB Connection as input and allows to select a table or view from within the connected database. The node outputs a DB Data object which contains the database connection information as well as a database query that defines the data in the database.
In addition, this node allows to enter a customized SELECT statement which is then propagated to all connected nodes.

Options

Schema
The optional database schema name.
Table
The table or view name.
Select a table

Click on the button to open the Database Metadata Browser which allows you to browse the database metadata and to select a table or view. At first opening it fetches the metadata from the database and caches it for subsequent use.

The Database Metadata Browser allows you to browse the database metadata and to select a table or view. Click the Refresh button at the bottom right to re-fetch the metadata from the database. The data is grouped by database schema and type e.g. view or table. By clicking on an entity it shows contained elements. If you click on a table or view the dialog will fetch the column names and types of the selected element. To select a table or view select the name and click OK or double click the element. To search for a particular table or view enter the name or parts of the name into the search field and click on the Magnifying Glass button or press enter.

Custom Query
Enable/Disable custom query for the selected table.
Flow Variable List
This list is only visible if the Custom Query option is enabled. It 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).
SQL Statement
This option is only visible if the Custom Query option is enabled. It provides a SQL editor to enter the SELECT statement that should be propagated to all connected nodes. Optionally, the #table# placeholder can be used to refer to the table or view selected above.
To open code completion press <CTRL> + <SPACE>. Table and columns names are only suggested if the metadata is available e.g. shown in the Database Metadata Browser. To perform undo press <CTRL> + Z and for re-do <CTRL> + Y.
Preview
This section is only visible if the Custom Query option is enabled. To evaluate the SQL query click on the Evaluate button. This will trigger the execution of the query in the database and fetches the top 10 rows of the result.
Please notice that the query that is used to fetch the preview data is altered to only return the top 10 rows for efficiency usually by wrapping it into a LIMIT statement.

Input Ports

Icon
DB Connection to connect to the database.

Output Ports

Icon
DB Data referencing the data in the database.

Popular Successors

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.