SQL Query (Relational)

Performs a SQL query against a JDBC or JNDI data source. The query results are available as an output to the action. The query may contain references parameters be enclosing the parameter in curly braces. For example select * from myTable where department = '{dept}' would replace {dept} with the value of the parameter named "dept".

Component Name: Relational

Inputs:

REQUIRED
JNDI Name - Name of the JNDI connection.

or an SQL Prepared Component object

Prepared Component - A previous SQLLookupRule that defined a prepared component as the output.  The previous SQLLookupRule will share it's connection with the current SQLLookupRule 

or the following JDBC information

JDBC Driver - The JDBC driver to use when connecting to the data source.
JDBC Connection String - The connection string identifying the location of the data source.
JDCB User Name - User name to use when connecting to the data source.
JDBC Password - Password to use when connecting to the data source.

OPTIONAL
Keep Connection Open _-- If selected the query results are retrieved from the data source as needed, otherwise the entire query results are brought over from the data source and cached in memory. It is recommended that you set this option with larger datasets. Never use this option if you are storing the resultset in the session.

Forward Only -  This sets the cursor for the resultset to a forward-only cursor type, allowing one pass at data retrieval. If this is false, and the connection supports scrollable cursors, then the cursor type is scrollable, allowing multiple passes at the data. Forward only is false by default.

SQL Query -  This is required if no prepared component object is defined.  to utilize SQL's prepared statement functionality.

Use {PREPARE:<paramname>} in the sql query, where <paramname> is an input parameter to the SQLLookupRule.  This parameter is resolved during the execution of the SQLLookupRule.

Use {PREPARELATER:<paramname>} in the sql query when defined as a prepared component (see outputs below). The <paramname> and value is provided by the executing component.

Note: Any parameter may be referenced in the query by enclosing the parameter in curly braces.

Outputs:

Result Set Name-- The name of the parameter in which to store the query results.

or

Prepared Component - The name of the parameter in which to store the prepared component object, which can be used for shared connections and later processing by other components.