SQL Navigator for Oracle 7.4 - Installation Notes

Software installation Server side installation Server side support Citrix Presentation Server installation notes Product licensing Copyright

Code Editor SQL

The Code Editor opens ready to edit SQL code. The toolbar is appropriate to SQL development. Each of the toolbar icons is described below. In addition, all standard editing functions are available. See For more information, see Edit, Compile And Execute. for more information.

General Code Editor Functions

Icon

Tool Tip

Description

Back

Navigate between hyperlinked database objects (in the editing pane) and their dependent objects and components.

Forward

New SQL

Write a single SQL statement or a series of SQL statements in a new editing pane. The toolbar will open for SQL development.

New Stored Object

Create a stored object. Open the New Stored Object Dialog.

Open File

Open an external file in the Code Editor.

An alternative way to open file is to drag and drop a file from Windows Explorer to the SQL Navigator window.

Save to File

Save the contents of the current Code Editor pane to an external file.

Open Object

Locate a stored object using the Select DB Object Dialog and open the object in the editing pane.

Auto Code Completion

Turn On/Off Auto Code Completion. When turned on, the Code Editor matches variables, parameters, procedures and types as you type.

Vertical Split

Adjust the layout of the editing pane.

Select from the options to split the editing pane in half either horizontally or vertically. The content of the editing pane will be visible in both panes. You can scroll the panes independent of each other.

TIP: To open a different script in one of the panes:

Open the second script in a new editing pane of the Code Editor.
Return to the split panes. In the pane to load the second script right-click and select Split/Compare | Second Source.
Select the second source from the list of all scripts currently open in the Code Editor.

SQL Specific Functions

Icon Tool Tip Description

Send to Session

Switch to other sessions and continue working within the same window, with the same script. This feature allows you to run the same script against different databases without the need to copy it into another instance of the Code Editor. It also allows you to correct the oversight of opening a file into the wrong session.

You can choose from a list of current sessions or start a brand new session.

Note:

When you run that window (execute the SQL or compile the PL/SQL code, for example), SQL Navigator will prompt you to change to the new (current) session. It allows you to quickly correct the oversight of opening a file into the "wrong" session.
You can change session while editing SQL scripts only. This option is not available to stored programs.

Add Condition

Insert Where clause conditions in the SQL script using a graphical interface.

Type the SQL statement up to the where clause (Select * from emp_table).
Click Add Condition to open the Add Filter window.
Select and fill in the field, operator and value(s) accordingly.
Click Ok to insert the where clause.

The Value(s) field is shown depending on which Operator has been selected.

Use when there is no semicolon (;) in the script.

Remove All Conditions

Updateable

Edit the data returned by SQL queries. Update, delete and insert new records and save your changes back to the database. This feature is particularly useful for creating test data.

TIP:

Updateable requires simple SELECT statements with no joins, subqueries in select clause, calculated fields, group by, having, count(), substr or DISTINCT.
Updateable queries are slow to execute.

Off

Data returned by SQL queries is read-only.

Stop on Error

Use in conjunction with Execute to End to validate syntax.

Not Selected	Execute all SQL statements. Highlight all erroneous statements.
Selected	Stop execution of SQL statements on encountering the first error. Highlight the offending code.

Fetch All

Limit the rows retrieved on execution of the SQL statement:

Not Selected

Retrieve enough rows to fill the visible area of the grid.

Fetch additional rows on scroll down requests.

Selected

Retrieve all rows.

Spool Screen Select to capture a log of executed SQL statements in the SQL Query Log (The Spool Tab).

Scan Defines/Substitutions

Turn On/Off Scan Defines/Substitutions

Turn on Scan Defines/Substitutions if your script uses variables or text that contain the characters &, &&, or = :[bind variable]. Otherwise, the statements containing the variables will generate an error.

Echo SQL On/Off

SQL History

Show/Hide the Toolbox History

If the Toolbox is unpinned, showing History will not make History visible until the Toolbox is shown.

Expand SQL Pane Maximize screen real estate of the SQL pane.

Skip to Top

Execution Control Buttons:

The location of the cursor marks the execution start point.
Use Skip to Previous and Skip to Next to move the cursor through the SQL statements.
Click Execute to End or press F9 to run the script to the end.
Click Execute Step or press F8 to execute the current statement.
To work with the result see SQL Query Results Data Grid.

TIP:

You cannot run multiple queries within the same session simultaneously. If you need to run multiple queries simultaneously, you can open another connection to the same database.
To validate syntax use Execute to End in conjunction with Stop on Error.

Skip to Previous

Execute to End

Execute Step

Stop

Skip to Next

Skip to Bottom

PL/SQL Debugger

Show/Hide the Toolbox PL/SQL Debugger

If the Toolbox is unpinned, showing the PL/SQL debugger will not make the PL/SQL debugger visible until the Toolbox is shown.

Abort Debug Session For more on debug see PL/SQL Debugger.

Team Coding Version Control

To enable Team Coding see Administer Team Coding.

Icon

Tool Tip

Description

Get Latest Revision

Get the latest version of an object or script as it is held in the Version Control repository.

The Get Latest Revision command overwrites the version of the object or script in the database, replacing it with the latest version held in the VCS repository. You can use the View Differences Dialog to compare versions before overwriting the object.

Check Out

Check out or check in the current object or script.

Open:

Check In

Undo Check Out

Cancel the check-out. You are prompted to confirm that you want to discard any changes you have made and restore the database version of the item as it was prior to check-out.

Confirm Yes	You have made and saved changes to the object and you want to discard those changes.
Confirm No	You have made and saved changes to the object and you want those changes to be retained in the database. As a result the version saved in the third party version control repository will be different from the version saved in the database.

Tools and Applications

Icon

Tool Tip

Description

SQL Optimizer

Explain Plan

Explain Plan Tool

PL/SQL Formatter

Format PL/SQL, SQL*Forms, Oracle Forms, and SQL*Plus source code.

Menu Icon	Menu Name	More Information
	Format Text	Format the entire source currently in the editor. To format just a selection, select the text you want to format. Output is displayed in the Output Window.
	Syntax Check	Check the syntax. Output is displayed in the Output Window. If syntax errors are detected, the text stays unchanged. The errors are displayed in the Output Window.
	Profile Code	Create a summary of the code statistics. You can copy to clipboard or save to file.
	Multi-File Formatting	Open the Multi-File Formatting Selection dialog. Select Folder and enter the folder that directly contains the files you want to format. Or Select Files and enter the files you want to format. Select Backup files to folder to create a backup copy of the files you are about to format.
	Format Options	Define how the Formatter Tool formats code. Formatting Options