SQL Assist - Fields and controls

Start page

Logon page

Tables page

Columns page

Joins page

Groups page

Order page

Conditions page

Mapping page

Insert page

Update page

Review page

Expression Builder

Results

Function parameters

Function Arguments - FormatDate

Start page

Use the Start page to choose the type of SQL statement that you want to create. The types of statements that you can create might be limited, depending on the application that you were using when you started SQL Assist.

Select

Insert

Update

Delete

Select

Creates a statement that returns rows that are based on criteria that you specify on the SQL Assist notebook pages.

Insert

Adds rows, one at a time, to a table.

Update

Changes values in a table.

Delete

Removes rows from a table.

Logon page

Use this page to make a connection to a database.

Database URL

User ID

Password

Driver identifier

Other

Connect

Disconnect

Database URL

Specify the connection type, database type, and database name.

User ID

Specify the user ID that you want to use to connect to the database.

Password

Specify the password for the user ID.

Driver identifier

Specify the type of database to which you are connecting.

Other

Specify the location and name of the JDBC driver that you want to use.

Connect

Connects to the server that is specified in the Database URL field.

Disconnect

Disconnects from the server that is specified in the Database URL field.

Tables page

Use this page to select the tables that you want to include in your SQL statement.

Available tables

Selected tables

>

<

<<

Filter schemas

Filter tables

Available tables

Displays the schemas and tables that are accessible in the database that is identified by the currently selected connection alias.

Selected tables

Displays the tables that will be used in the SQL statement.

>

Moves the highlighted items from the Available list to the Selected list.

<

Moves the highlighted items from the Selected list to the Available list.

<<

Moves all items from the Selected list to the Available list.

Filter schemas

Opens the Filter Schemas window for selecting schemas.

Filter tables

Opens the Filter Tables window for you to specify filtering characters. These characters limit the display to only the table names that begin with those characters. The filtering characters are case-sensitive. The % character is a wildcard character.

Columns page

Use this page to select the columns that you want to include in your SQL statement.

Available columns

Selected columns

>

>>

<

<<

Move Up

Move Down

Add

Edit

Delete

Available columns

Displays the columns in the tables that were selected on the Tables page.

Selected columns

Displays the columns that are included in the result set.

>

Moves the highlighted items from the Available list to the Selected list.

>>

Moves all items from the Available list to the Selected list.

<

Moves the highlighted items from the Selected list to the Available list.

<<

Moves all items from the Selected list to the Available list.

Move Up

Moves the selected item up one position in the list.

Move Down

Moves the selected item down one position in the list.

Add

Opens the Expression Builder - Columns window.

Edit

Opens the Expression Builder - Columns window with the currently selected expression.

Delete

Removes the calculated column from the Selected columns list.

Joins page

Use this page to join tables in an SQL statement. The Joins page displays the columns of each table that is selected in the Tables page. Select columns in each table that you want to join. You can specify multiple joins.

Join

>

<

Unjoin

Join Type

Join

Joins the selected columns. The join is indicated by a red join line.

>

Scrolls through the joins. The line that represents the current join is highlighted in red.

<

Scrolls through the joins. The line that represents the current join is highlighted in red.

Unjoin

Removes the selected join.

Join Type

Opens the Join Type window. Use this window to specify the type of join you want to create: inner join, left outer join, right outer join, or full outer join.

Conditions page

Use this page to specify a search condition for an SQL statement. You can specify multiple search conditions.

And

Or

Available columns

Operators

Values

Find

Add Variable

Clear

Add

Conditions

Advanced Expression

Exclude duplicate rows (SELECT DISTINCT)

And

Indicates that all specified conditions must be met.

Or

Indicates that one of the specified conditions must be met.

Available columns

Displays the names of the columns in the table or tables specified in the Selected tables field on the Tables page.

Operators

Displays the operators that can be used in the condition. The operators can change, depending on the data type of the column that is selected in the Available columns list.

Values

Displays the values that will be used in the condition. You can either type the values into this field, click Find to open the Find window and select the values that you want to use, or click Add Variable to specify a host variable.

Find

Opens the Find window, where you can select values that you want to use in your condition.

Add Variable

Opens the Add Variable window, where you can specify host variables to be used in your condition.

Clear

Removes all of the values from the Values list.

Add

Appends the current condition to the Conditions field.

Conditions

Displays the current conditions.

Advanced Expression

Opens the Expression Builder - Conditions window.

Exclude duplicate rows (SELECT DISTINCT)

Eliminates all but one of each set of duplicate rows in the result set. Two rows are duplicates of one another only if each value in the first is equal to the corresponding value of the second. Two null values are considered equal.

Groups page

Use this page to specify which columns to use to divide the result set into groups.

Include grouping columns

Available columns

Selected columns

Group conditions (HAVING)

Advanced Expression

Include grouping columns

Specify whether to include grouping in your SQL statement.

Available columns

Displays all columns in the Selected columns list on the Columns page, if the Include grouping columns checkbox is selected.

Selected columns

Specifies the columns that will be used to divide the data in the result set into groups, based on the values in those columns.

Group conditions (HAVING)

Specifies an expression that is used to eliminate unwanted grouped data by filtering the results that are returned by the grouping columns.

Advanced Expression

Opens the Expression Builder - Conditions window.

Order page

Use this page to specify the order of rows in the result set. You can specify multiple sort columns.

Available columns

Selected columns

>

>>

<

<<

Order

Move Up

Move Down

Display output columns only

Display all available columns

Available columns

Displays the columns in the tables that were selected on the Tables page.

Selected columns

Specifies one or more columns to be used as sort columns.

>

Moves the highlighted items from the Available list to the Selected list.

>>

Moves all items from the Available list to the Selected list.

<

Moves the highlighted items from the Selected list to the Available list.

<<

Moves all items from the Selected list to the Available list.

Order

Indicates whether the values in the column are listed in ascending (up) or descending (down) order.

Move up

Moves the selected item up one position in the list.

Move down

Moves the selected item down one position in the list.

Display output columns only

Displays those columns that are specified in the Selected columns list on the Columns page.

Display all available columns

Displays those columns that are listed in the Available columns list on the Columns page, plus any column expressions.

Mapping page

Use this page to remap the data retrieved from a table column to a different SQL data type. This action also maps the data to a different Java class.

Column

Current data type

New data type

Defaults

Column

Displays the columns that are available for mapping.

Current data type

Displays the SQL data type for the column.

New data type

Specifies the data type to which the data retrieved from the column will be mapped.

Defaults

Resets the mapping of all columns to their default SQL data types.

Insert page

Use this page to specify the values that you want to add to the specified table.

Value

Value

Displays the value to be inserted.

Update page

Use this page to specify the values that you want to change in the specified table.

Value

Value

Displays the value that will be added to the table.

Review page

Use the Review page to display the SQL statement that was generated from selections on the other pages.

Available columns

SQL statement

Undo

Run

Save

Do not include schema names for tables owned by schema name

Available columns

Displays the tables and columns that you can use in your SQL statement.

SQL statement

Displays the SQL statement that was generated from selections on the other pages.

Undo

Removes any unsaved changes that you made in the SQL statement field.

Run

Runs the SQL statement against the database and displays the results in the Results window.

Save

Opens a Save window in which you can specify the location and name of the file in which you want to save your SQL statement. The default file extension is sql.

Do not include schema names for tables owned by schema name

Specify whether to qualify table names in the SQL statement that are owned by the current user with that user's schema.

Expression Builder

Use the Expression Builder window to build a column expression, a row condtion, or a group condition.

Columns

Operators

Case

Value

Functions

Constants

And

Or

=

<>

(

)

Expression

Clear

Undo

Redo

Columns

Displays columns that you can use in your expression.

Operators

Displays operators that you can use in your expression. The operators in this list can change, depending on whether you are building a column expression, a row condition, or a group condition.

Case

Displays case operators that you can use in your expression.

Value

Displays values that you type. The values are added to the expression when you click the checkmark button.

Functions

Displays functions that you can use in your expression. Clicking on a function category displays the functions of that category in the list below.

Constants

Displays constants that you can use in your expression.

And

Adds the logical operator AND to the expression at the cursor location.

Or

Adds the logical operator OR to the expression at the cursor location.

=

Adds the operator = (equals) to the expression at the cursor location.

<>

Adds the operator <> (not equal) to the expression at the cursor location.

(

Adds the operator ( (left parenthesis) to the expression at the cursor location.

)

Adds the operator ) (right parenthesis) to the expression at the cursor location.

Expression

Displays the expression as you type or build it.

Clear

Removes all input from the Expression field.

Undo

Removes the last change that you made from the Expression field.

Redo

Reverses the last change that you made in the Expression field.

Results

Use the Results window to view the result set of your SQL statement.

Copy to clipboard

Save

OK

Copy to clipboard

Copies the result set to the clipboard.

Save

Saves the result set in a file.

OK

Closes the window.

Function Parameters

Use the Function Parameters window to specify parameters for the selected function.

Format

Parameter

Format

Select the format of the function.

Parameter

Specify the values for each parameter.

Function Arguments - FormatDate

Use the Function Arguments - FormatDate window to change date and time information from one format to another.

Available columns

Input column

Input format - Category

Input format - Format

Input format - Example

Input format - Format string

Output format - Category

Output format - Format

Output format - Example

Output format - Format string

Available columns

Displays the columns that you can use with the FormatDate function.

Input column

Displays the name of the column that contains the field for which you want to reformat the date and time. This field is required.

Input format - Category

Displays the category of the date/time format that is currently defined to the input column. This field is required.

Input format - Format

Displays the date time format that is currently defined for the input column. This field is required.

Input format - Example

Displays examples that correspond to the date/time formats that are listed in the Format column.

Input format - Format string

Displays the format string for the date or time in the input column.

Output format - Category

Displays the category of the new date or time format. This field is required.

Output format - Format

Displays the new date or time format. This field is required.

Output format - Examples

Displays examples that correspond to the date/time formats that are listed in the Format column.

Output format - Format string

Displays the selected format string for the date or time in the Format column.