Sei sulla pagina 1di 465



750
2EZMKEXSV

F O R

O R A C L E

Users Guide
Version 4


This guide contains proprietary information, which is
protected by copyright. The information in this guide is
subject to change without notice and does not represent
a commitment on the part of Quest Software. The
software described in this guide is furnished under a
license or nondisclosure agreement. This software may
be used or copied only in accordance with the terms of
this agreement. No part of this guide may be reproduced
or transmitted in any form or by any means, electronic
or mechanical, including photocopying and recording,
for any purpose other than the purchasers personal use
without the written permission of Quest Software, Inc.
2001 Quest Software, Inc. All Rights Reserved.
SQL Navigator is a trademark of Quest Software, Inc.
Other trademarks and registered trademarks used in this
guide are the property of their respective owners.

8001 Irvine Center Drive


Irvine, CA 92618
USA
www.quest.com
U.S and Canada: 949 754.8000
UK: +44.1628.601000
Germany: +49.211.770967.0
Australia: +61.3.9811.8000

Contents

Chapter 1 Quick Tour of SQL Navigator

&IXXIVGSHIJEWXIV
8LI7502EZMKEXSVYWIVMRXIVJEGI 
)EW]FVS[WMRKERHSFNIGXREZMKEXMSR 
*EWXEGGIWWXSER]SFNIGX
-RWXERXEGGIWWXS]SYVlJEZSVMXIWz
'SQQERHWERHXSSPWJSVLERHPMRKHEXEFEWISFNIGXWERHGSHI 
:MWYEPIHMXSVWJSVHEXEFEWISFNIGXW 
4S[IVJYP750)HMXSV 
'SQTPIXII\IGYXMSRIRZMVSRQIRXJSVWXSVIHTVSKVEQW
'SQTPIXIERHI\XIRWMFPIGSHIXIQTPEXIPMFVEVMIW 
8IEQGSHMRKERH:IVWMSR'SRXVSPWYTTSVX 
;IFHIZIPSTQIRXWYTTSVX
6ITSVXMRKXSSPW
,S[XSJMRHXLILIPT]SYRIIH 
Chapter 2 Whats new in this version?

51

;LEX
WRI[MR7502EZMKEXSV#
+IXXMRKEGGIWWXSRI[JIEXYVIW
-RXIVJEGI)RLERGIQIRXW
)HMXMRK)RLERGIQIRXW 
(IFYKKIVIRLERGIQIRXW 
2I[ERHMQTVSZIHHIZIPSTQIRXXSSPW 
-QTVSZIH8IEQ'SHMRKJEGMPMXMIW
+IRIVEPERHQMWGIPPERISYWIRLERGIQIRXW 
Chapter 3 The SQL Navigator interface

109

3ZIVZMI[SJXLI7502EZMKEXSVMRXIVJEGI 
1IRYW8SSPFEVW 'SQQERHW
/I]FSEVHWLSVXGYXW 
'SHIIHMXSVWSZIVZMI[ 
;SVOWTEGIW%WQEVXIV[E]SJ[SVOMRK
'SRRIGXMRKXSXLI3VEGPIHEXEFEWI
:MI[MRKWIVZIVSYXTYX 
8LI3VEGPI.SF1EREKIV 

ii

Welcome to SQL Navigator Version 4 Users Guide

Chapter 4 Navigating the database

167

2EZMKEXMRKXLIHEXEFEWI 
8LI(&2EZMKEXSV[MRHS[ 
(&2EZMKEXSVGSQQERHW 
;SVOMRK[MXLSFNIGXWMRXLI(&2EZMKEXSV 
(&2EZMKEXSVHVEKERHHVSTXMTW  
Chapter 5 Working with SQL statements and scripts

183

;VMXMRKERHIHMXMRK750GSHI 
*EWXUYIV]FYMPHMRK[MXLXLI5YIV]&YMPHIV  
)\IGYXMRK750ERH[SVOMRK[MXLVIWYPXW 
8LI7TSSP[MRHS[ 
:MI[MRKVIWYPXWMRXLI6IWYPX[MRHS[  
Chapter 6 Working with PL/SQL code

237

;SVOMRK[MXL407503ZIVZMI[  


8]TMGEP40750IHMXMRKWGIREVMS  
;SVOMRK[MXLTEGOEKIW  
8SSPWERHGSQQERHWJSVIHMXMRKWXSVIHTVSKVEQW  
(EXEFEWI7SYVGI'SHI7IEVGL  
;VMXMRKERHIHMXMRKWXSVIHTVSKVEQW  
)\IGYXMRKWXSVIHTVSKVEQW  
3TXMQM^MRKWXSVIHTVSKVEQW8LI407504VSJMPIV  
(IFYKKMRK40750  
Chapter 7 Working with HTML and Java

329

'VIEXMRK,810TEKIW  


;SVOMRK[MXL.EZE 
Chapter 8 Working with database objects

339

:MWYEPIHMXSVWJSVHEXEFEWISFNIGXW 
:MWYEPIHMXSVWJSVHEXEFEWISFNIGXW 
*MRHMRKERHSTIRMRKEHEXEFEWISFNIGX  
3VEGPI(EXE(MGXMSREV]ZMI[W  
3TIRMRKX[SSVQSVIMRWXERGIWSJXLIWEQIIHMXMRK[MRHS[  
'VIEXMRKEPXIVMRKSVGST]MRKHEXEFEWISFNIGXW 
Chapter 9 Tools for analysis and tuning

369

%REP]^MRKHEXEFEWIWXVYGXYVIW 
9WMRKXLI)\TPEMR4PERXSSP 

iii

Contents

Chapter 10 Version Control and Team Coding

375

3ZIVZMI[
-RWXEPPMRK8IEQ'SHMRKSTXMSRW 
'SRJMKYVMRK8IEQ'SHMRK3TXMSRW 
8IEQ'SHMRK*MPI)\XIRWMSR3TXMSRW
8IEQ'SHMRK+IRIVEPSTXMSRW
9WMRK'SHI'SRXVSP+VSYTW
-RWXEPPMRKXLMVHTEVX]ZIVWMSRGSRXVSPTVSHYGXW 
Chapter 11 SQL Navigator reports

413

7502EZMKEXSVVITSVXW 
Chapter 12 Customizing SQL Navigator

417

'YWXSQM^MRKQIRYWERHXSSPFEVW 
7IXXMRK7502EZMKEXSVTVIJIVIRGIW
8SHMWTPE]XLI4VIJIVIRGIWHMEPSK 
+IRIVEPTVIJIVIRGIW 
9WIVMRXIVJEGITVIJIVIRGIW 
(SGOEFPI3YXTYX;MRHS[ 
(VSTERH8VYRGEXIWEJIX]STXMSRW 
7IWWMSRTVIJIVIRGIW 
(IJEYPX8EFPIWTVIJIVIRGIW 
(VEKERHHVSTGSHMRKTVIJIVIRGIW
)\TPEMR4PERTVIJIVIRGIW 
'SHI%WWMWXERXTVIJIVIRGIW 
4VMRXMRKTVIJIVIRGIW 
3FNIGXIHMXSVTVIJIVIRGIW
(IFYKKIVTVIJIVIRGIW 
)\XVEGX((0TVIJIVIRGIW 
)\XVEGX((08EFPI:MI[7TIGMJMGTVIJIVIRGIW 
)\XVEGX((04EVXMXMSRMRKTVIJIVIRGIW
;SVOWTEGITVIJIVIRGIW 
'SHI)HMXSVTVIJIVIRGIW 
750)HMXSV4VIJIVIRGIW 
7XSVIH4VSKVEQ)HMXSV4VIJIVIRGIW 
+IRIVEP'SHI)HMXSV4VIJIVIRGIW 
03&:MI[IVTVIJIVIRGIW 
(MJJIVIRGIZMI[IVTVIJIVIRGIW 
8IEQ'SHMRKTVIJIVIRGIW 

iv

Welcome to SQL Navigator Version 4 Users Guide

Chapter 13 Installing server-side objects

441

-RWXEPPMRKWIVZIVWMHISFNIGXW 
Chapter 14 The SQL Navigator add-on modules

445

40750(IFYKKIV  


*SVQEXXIV4PYW  
/RS[PIHKI<TIVXJSV%GXMZI40750(IZIPSTQIRX  
/RS[PIHKI<TIVXJSV3VEGPI%HQMRMWXVEXMSR  
%TTPMGEXMSR8YRMRKERH)\TIVX%HZMGI 
(EXE*EGXSV]JSVETTPMGEXMSRXIWXMRK  
Chapter 15 About Quest Software

449

&YWMRIWW6YRW&IXXIVSR5YIWX 



1
Quick Tour of SQL Navigator

8LMWKYMHITVSZMHIWLMKLPIZIPSZIVZMI[WSJXLIKVETLMGEP[SVOMRKIRZMVSRQIRX
SJ7502EZMKEXSVEW[IPPEWHIXEMPIHMRWXVYGXMSRWJSVYWMRKMX9WIVWYTKVEHMRK
JVSQTVIZMSYWZIVWMSRW[MPPJMRHEWYQQEV]SJGLERKIWERHRI[JIEXYVIWMR
GLETXIV ERHEPWSMRXLISRPMRILIPT 
For installation instructions, please see the SQL
Navigator Getting Started guide.

In this chapter
Better code, faster.
The SQL Navigator user interface
Easy browsing and object navigation
Fast access to any object
Instant access to your favorites
Commands and tools for handling database objects and code
Visual editors for database objects
Powerful SQL Editor
Complete execution environment for stored programs
Complete and extensible code template libraries
Team coding and Version Control support
Web development support
Reporting tools
How to find the help you need

6
6
8
10
12
14
26
28
32
35
38
43
47
48

SQL Navigator Users Guide

Better code, faster.


7502EZMKEXSVTVSZMHIWERMRXIKVEXIHIRZMVSRQIRXJSVHIZIPSTMRKERHXIWXMRK
3VEGPIWXSVIHTVSKVEQWERHTVSGIHYVIWWGLIQEWSFNIGXW750WGVMTXWERH
QSVIEPPJVSQERIEW]XSYWIKVETLMGEPYWIVMRXIVJEGI
8LI7502EZMKEXSVJEQMP]SJTVSHYGXWMWEGSQTPIXIHIZIPSTQIRXIRZMVSRQIRX
JSV3VEGPIWIVZIVWMHIHIZIPSTQIRXERHQEREKIQIRX-XLEWFIIRGSRGIMZIH
HIWMKRIHERHHIZIPSTIHF]3VEGPIHIZIPSTIVWERH(&%W[MXLLERHWSR
I\TIVMIRGIMRXLIQSWXGSQQSRTVSFPIQWJEGMRK3VEGPIHIZIPSTIVW
For all the latest product information, including
tips and techniques, visit
http://www.quest.com/sql_navigator.

The SQL Navigator user interface


8LI7502EZMKEXSVMRXIVJEGIMWLMKLP]GYWXSQM^EFPI8LIJSPPS[MRKI\EQTPI
WLS[WEX]TMGEPEVVERKIQIRXSJXSSPFEVWERH[MRHS[W1ER]SXLIV
EVVERKIQIRXWEVITSWWMFPI
1SWX7502EZMKEXSVXSSPFEVWERH[MRHS[WGERFIQSZIHEVSYRHERHVIWM^IH
8LIQEMR7502EZMKEXSV[MRHS[EYXSQEXMGEPP]lVIQIQFIVWzMXWWM^IWXEXI
ERHTSWMXMSR8SSPFEVWGERFIQSZIHERHHSGOIHEXXLIFSXXSQPIJXERHVMKLX
WMHIWSJXLI[MRHS[SVPIJXlJPSEXMRKzJSVFIXXIVYWISJ[MRHS[WTEGI=SY
GERIEWMP]LMHIERHWLS[MRHMZMHYEPXSSPFEVW7SQI[MRHS[WWYGLEWXLI
;SVOWTEGI3YXTYXERH'SHI%WWMWXERX[MRHS[WGERFIQEHIHSGOEFPI
WXE]SRXST[MRHS[WF]QIERWSJEWLSVXGYXQIRYSTXMSR
)EGLWIWWMSRVIPEXIH[MRHS[ GSHIIHMXSVSFNIGXIHMXSVERHWSSR VIQIQFIVW
ERHEYXSQEXMGEPP]STIRWMRXLIETTVSTVMEXIHEXEFEWIWIWWMSR
=SYGERJVIIP]W[MXGLXSSXLIVWIWWMSRWERHGSRXMRYI[SVOMRK[MXLMRXLIWEQI
[MRHS[SVSTIRERI[[MRHS[

Chapter 1

Quick Tour of SQL Navigator

All Toolbars can be


floating, docked, or
hidden. Toolbar
buttons become active
according to item
selected.
Main menu bar.

The DB Navigator
shows the entire
database structure as a
tree with expandable
nodes.

The optional Details


panel shows essential
information about the
item selected in the
tree.
The Workspace
window gives you
quick access to oftenused objects and
connections.

Click on any item in the


Task Bar to give it
focus.

The Output window


displays server output
including Oracle errors.




SQL Navigator Users Guide

Easy browsing and object navigation


7502EZMKEXSVEPPS[WIEW]REZMKEXMSRSJXLIVIPEXMSREPHEXEFEWIWXVYGXYVI
[MXLEPPQENSVHEXEFEWISFNIGXWERHXLIMVVIPEXMSRWLMTWHMWTPE]IHMRE
GSRZIRMIRXLMIVEVGLMGEPMRXIVJEGIXLI(&2EZMKEXSV

You can set and save
filters to limit the
objects displayed in the
tree.
The DB Navigator toolbar
helps you navigate and
control how schema
objects are displayed.

Expand nodes (using


mouse clicks or the arrow
keys) to drill down to
underlying objects or data.
Double-click an object to
open it for editing.

Drag often-used objects or


connections to your
Workspace for fast access.

The optional Details pane


displays contents or properties of
the object selected in the tree.

Commands available on
floating menus and toolbars
change according to the items
selected in the tree.

Chapter 1

Quick Tour of SQL Navigator

Visualization of schema
'SQTVILIRWMZIZMWYEPVITVIWIRXEXMSRSJHEXEFEWIWGLIQEWLIPTW]SY[SVO
JEWXIVERHWQEVXIV

Supports most object types


8LI(&2EZMKEXSVGERHMWTPE]SFNIGXXEFPIWGSPPIGXMSRX]TIWHMVIGXSVMIW
PMFVEVMIW.EZESFNIGXWRIWXIHXEFPIWERHXEFPIGSPYQRWERHX]TIEXXVMFYXIWSJ
YWIVHIJMRIHHEXE (&%HMGXMSREV]ZMI[WEVIVIUYMVIHJSVZMI[MRKWSQIRSHIW
SJXLI(&2EZMKEXSVXVII 

Supports Oracle 8 partitioned tables and indexes


8LI(&2EZMKEXSVWYTTSVXW3VEGPITEVXMXMSRIHXEFPIWERHMRHI\IW4EVXMXMSRW
EVIHMWTPE]IHYRHIVGSVVIWTSRHMRKTEVXMXMSRIHXEFPIWSVMRHI\IWWS]SYGER
FVS[WIXLIQMRHMZMHYEPP]8LI)\XVEGX((0JYRGXMSRMRGPYHIWTEVXMXMSR
MRJSVQEXMSR[LIRKIRIVEXMRKEWGVMTX

Drill-down on types
8]TIWGERFII\TERHIHMRSVHIVXSWLS[HIXEMPWSJXLIMVX]TIWERHSVWXSVI
XEFPIW

Selective viewing
7502EZMKEXSVJMPXIVWPIX]SYHIJMRITVIJIVIRGIWJSVZMI[MRKHEXEFEWISFNIGXW
JSVIEGLHEXEFEWIXLI]EVIGSRRIGXIHXS[MXLYRMUYIJMPXIVWIXWEWWSGMEXIH[MXL
IEGLTVIJIVIRGI

Saved views
:MI[MRKF]SFNIGXX]TIERHYWMRKWGLIQEIPIQIRXW[MXLJMPXIVWPIXW]SY^IVSMR
SRSFNIGXWSJMRXIVIWX=SYGERWEZIJEZSVMXIJMPXIVGSQFMREXMSRWMRXSEGEXEPSK
SJXIQTPEXIWJSVPEXIVYWI

Quick table browsing


7502EZMKEXSV
WUYMGOFVS[WIVPIXW]SYZMI[XLIGSRXIRXWSJHEXEFEWIXEFPIW
ERHZMI[WMRVIEHSRP]QSHIFIRIJMXMRKHIZIPSTIVWERH(&%WEPMOI

Create SQL in browser


7502EZMKEXSVPIXW]SYGVIEXI750UYIVMIWXSVYREKEMRWXER]XEFPISVZMI[
)ZIRPSRKJMIPHWGERFIZMI[IHMRETSTYTIHMXSV

10

SQL Navigator Users Guide

Fast access to any object


Quickly find objects in any schema
8LI*MRH3FNIGXWJIEXYVIMRXLI7IEVGLQIRYPIXW]SYUYMGOP]JMRHSFNIGXWMR
ER]WGLIQE-XHMWTPE]WEWSVXEFPIPMWXFEWIHSR]SYVWIEVGLEVKYQIRXW



Find objects from stored programs or scripts


8SMRWXERXP]JMRHSFNIGXWJVSQWXSVIHTVSKVEQWSVWGVMTXWERHSTIRXLIQMR
XLI:MWYEP)HMXSVWYWIXLI3TIR3FNIGXEX'YVWSVGSQQERHMRXLI)HMXQIRY

Quick Describe
=SYGERZMI[EHIWGVMTXMSRSJSFNIGXWXVYGXYVIWMQTP]F]VMKLXGPMGOMRKEXEFPI
MRHI\GPYWXIVTVSGIHYVIJYRGXMSRSVTEGOEKIERHGLSSWMRK(IWGVMFIJVSQXLI
WLSVXGYXQIRY

Chapter 1

Quick Tour of SQL Navigator

11



Oracle Data Dictionary views


&]HIJEYPX7502EZMKEXSVKMZIW]SY97)6SFNIGXHEXEHMGXMSREV]ZMI[W
QIERMRK]SYGERWIISRP]SFNIGXW]SYS[RSVJSV[LMGL]SYLEZIFIIRKVERXIH
SFNIGXTVMZMPIKIW-J]SY[ERXXSWIIEPPSFNIGXWEZEMPEFPIYRHIV]SYV(&%YWIV
TVMZMPIKIW]SYGERWIPIGX)REFPIYWMRK(&%HMGXMSREV]ZMI[WYRHIV
:MI["4VIJIVIRGIW"7IWWMSR(&%HMGXMSREV]ZMI[WEVIVIUYMVIHJSVIHMXMRK
4VSJMPIW6SPIWERH9WIVWSVJSVZMI[MRKXLIJSPPS[MRKRSHIWSJXLI(&
2EZMKEXSVXVII
 6SPIW
 WSQIRSHIWYRHIV9WIVW
 (EXEJMPIWYRHIV8EFPIWTEGIW
 6IHS0SK+VSYTW
 6SPPFEGO7IKQIRXW

Search filters
=SYGERJMPXIV]SYVWIEVGLVIWYPXWF]WTIGMJ]MRKREQISVS[RIVREQIXIQTPEXI
MRGPYHMRK[MPHGEVHGLEVEGXIVW X]TIHEXIPEWXQSHMJMIHSVWXEXYW

12

SQL Navigator Users Guide

Sorted results
7IEVGLVIWYPXWGERFIWSVXIHSRER]GSPYQR REQIS[RIVX]TI
GVIEXMSRQSHMJMGEXMSRHEXIERHWXEXYW MREWGIRHMRKSVHIWGIRHMRKSVHIV
WMQTP]F]GPMGOMRKXLIGSPYQRLIEHIVSVEWLSVXGYXQIRYMXIQ

Optional detail view


8LIPMWXGERFIZMI[IH[MXLSV[MXLSYXHIXEMPWWMQMPEVXSXLI[E]XLI
;MRHS[W)\TPSVIV[MRHS[[SVOW

Double-click anywhere to edit


;LIR]SYHSYFPIGPMGOSREHMWTPE]IHSFNIGX2EZMKEXSVEYXSQEXMGEPP]STIRWMX
JSVIHMXMRK

Locate in schema
=SYGERYWIXLI0SGEXIMR7GLIQEGSQQERHXSHMWTPE]XLIWIPIGXIHSFNIGXMR
(&2EZMKEXSV

Batch selection and update


;LIRQYPXMTPISFNIGXWEVIWIPIGXIH]SYGERETTP]GSQQERHWPMOI'ST]8I\X
(VST)\XVEGX((0'SQTMPI)REFPI(MWEFPIERH8VYRGEXIXSXLIIRXMVI
FEXGLSJSFNIGXW

Instant access to your favorites


7502EZMKEXSV
W;SVOWTEGIJIEXYVIKMZIW]SYMRWXERXEGGIWWXS]SYVJVIUYIRXP]
YWIHHEXEFEWISFNIGXWERHGSRRIGXMSRW
6SYKLP]WMQMPEVXS;MRHS[Wl*EZSVMXIWzJSPHIVW;SVOWTEGIWEVILSPHMRK
EVIEW[LIVI]SYGERWXSVIWLSVXGYXWXSXLMRKWXLEX]SYJVIUYIRXP]RIIHXS[SVO
[MXLMRWXIEHSJWIEVGLMRKJSVXLIQMRZEVMSYWPMWXWERHHMVIGXSVMIW=SYGER
IZIRYWI]SYV[SVOWTEGIXSWXSVIHEXEFEWIGSRRIGXMSRWJSVSRIGPMGOEGGIWW

List view and Detail view


=SYGERWIPIGXXLIHMWTPE]JSVQEXJSV;SVOWTEGIMXIQW

Chapter 1

Quick Tour of SQL Navigator

13



14

SQL Navigator Users Guide

Managing the Workspace window


The number in brackets after the Workspace
name tells you how many items are in the workspace.

To limit the types of objects


shown in the Workspace
window, click the Filter
button.
Double-click an object or
connection to open it.




0MOIXLISXLIVHSGOEFPI[MRHS[WXLI;SVOWTEGI[MRHS[VIXEMRWMXWWM^IERH
TSWMXMSRFIX[IIRWIWWMSRWQSVISZIVIEGLMRHMZMHYEP[SVOWTEGI[MRHS[
VIXEMRWMXWS[RWIXSJTEVEQIXIVW

Commands and tools for handling database


objects and code
7502EZMKEXSVQIRYWERHXSSPFEVWGERFIJPSEXMRKSVHSGOIHWS]SYGERTYX
XLIQ[LIVI]SY[ERXXLIQ8LI]EVIGSQTPIXIP]GYWXSQM^EFPI=SYVWIXXMRKW
EVIWEZIHERHVIGEPPIHEYXSQEXMGEPP]8LIQIRYWEGGIWWMFPIJVSQXLIQEMR
QIRYFEVEVIWLS[RMRXLIJSPPS[MRKTEKIW1SWXGSQQERHWEVIEPWSEZEMPEFPI
JVSQXSSPFEVWXLEXEVIIEW]XSQSZIEVSYRHEW]SY[SVO
0DLQPHQXEDU


8LIEZEMPEFPIGSQQERHWGLERKIEGGSVHMRKXSXLIGYVVIRXSFNIGX XLISFNIGX
WIPIGXIHMRXLIQEMR[SVOEVIE %PWSXLI]EVIGSQTPIXIP]GYWXSQM^EFPI]SY
GEREHHERHVIQSZIQIRYERHXSSPFEVGSQQERHW

Chapter 1

Quick Tour of SQL Navigator

15

Default settings for SQL Navigator menus


File menu
3TIVEXMSRWSRJMPIWERH[SVOWTEGIWTPYWXLI)\MXGSQQERH



16

SQL Navigator Users Guide

Edit menu
'SQQSRXI\XERHGSHIIHMXMRKEGXMSRW

Chapter 1

Quick Tour of SQL Navigator

17

Search menu
*MRHMRKXI\XGSHIERHHEXEFEWISFNIGXW

View menu
'SRXVSPPMRK[LEXMWHMWTPE]IHMRXLIQEMRETTPMGEXMSREVIE

18

SQL Navigator Users Guide

Session menu
7IWWMSR[MHIEGXMSRW

Chapter 1

Quick Tour of SQL Navigator

19

Object menu
3TIVEXMRKSRHEXEFEWISFNIGXW
3FNIGXQIRY[LIREXEFPIMWWIPIGXIH



20

SQL Navigator Users Guide

3FNIGXQIRY[LIREWXSVIHTVSGIHYVIMWWIPIGXIH


Chapter 1

Quick Tour of SQL Navigator

21

Debug menu
'SHIHIFYKKMRK



22

SQL Navigator Users Guide

Tools menu
-RZSOMRKERHGSRXVSPPMRKMRXIKVEXIHXSSPW

Chapter 1

Quick Tour of SQL Navigator

23

Team Coding menu


:IVWMSRGSRXVSPERHXIEQGSHMRKJYRGXMSRW



Windows menu
'SRXVSPPMRKXLIEVVERKIQIRXSJSTIR[MRHS[WMRXLI7502EZMKEXSV
ETTPMGEXMSREVIE



24

SQL Navigator Users Guide

Help menu
%GGIWWXSYWIVEWWMWXERGI



Menu synchronization
8LIGSQQERHWXLEXEVIEZEMPEFPIMREPP[MRHS[WGLERKIEWHMJJIVIRXX]TIWSJ
SFNIGXWERH[MRHS[WEVIWIPIGXIHSVSTIRIH
(EXEFEWISFNIGXWEWWSGMEXIH[MXLERSTIR[MRHS[FIGSQIlGYVVIRXzJSVXLI
IRXMVI7502EZMKEXSVHIZIPSTQIRXIRZMVSRQIRX
;LIRIZIV]SYSTIREHEXEFEWISFNIGX EXEFPITVSGIHYVIJYRGXMSRMRHI\ERH
WSSR MRSRISJXLIJSPPS[MRK[MRHS[W7502EZMKEXSVIREFPIWEPPXLI
ETTVSTVMEXIQIRYSVXSSPFEVGSQQERHWJSVXLEXSFNIGX
 (&2EZMKEXSV
 *MRH3FNIGXW
 'SHI7IEVGL
 ;SVOWTEGI
 (IWGVMFIXSSP
 :MWYEPSFNIGXIHMXSVW
 &VS[WI)HMXHEXE
*SVI\EQTPI[LIRERSFNIGXMWSTIRMRERIHMXMRK[MRHS[]SYGERYWIXLI
0SGEXIMR7GLIQEGSQQERHXSNYQTXSXLEXSFNIGX
WRSHIMRXLI(&2EZMKEXSV
XVIII\TERHMRKEPPMRXIVQIHMEXIRSHIWERHSTIRMRKXLISFNIGX
WHIXEMPW

Chapter 1

Quick Tour of SQL Navigator

25

Toolbars
%PPXSSPFEVWMRXLIQEMRETTPMGEXMSR[MRHS[EVIGYWXSQM^EFPI
 8SWIIELMRXEFSYXXLITYVTSWISJER]XSSPFEVFYXXSRTEYWIXLIQSYWI
TSMRXIVSZIVMX
 =SYGERQSZIXSSPFEVWXSER]PSGEXMSRMRXLI[SVOEVIEERHHSGOXLIQEX
XLIFSXXSQPIJXERHVMKLXWMHIWSJXLI[SVOEVIE 8LI7IWWMSRXSSPFEVMWER
I\GITXMSRMXGERFIHSGOIHSRP]XSXLIXSTSVFSXXSQSJXLIQEMR[MRHS[ 
8SSPFEVWGERJPSEXSRXSTSJXLIGYVVIRX[MRHS[
 =SYGERWLS[ERHLMHIXSSPFEVWXSTVSZMHIQSVI[SVOWTEGI=SYGER
GLERKIXLIWLETISJXSSPFEVWF]HVEKKMRKXLIMVLSVM^SRXEPSVZIVXMGEP
FSYRHEVMIW
 8LIQSWXVIGIRX[MRHS[ERHXSSPFEVWM^IERHTSWMXMSR[MPPFI
EYXSQEXMGEPP]VIWXSVIHYTSRVISTIRMRK
8LIJSPPS[MRKXSSPFEVWEVIEZEMPEFPI F]HIJEYPX MRXLIQEMR[MRHS[-JXLI]
EVIRSXZMWMFPI]SYQE]RIIHXSVIWIX]SYVXSSPFEVW
Toolbar

Purpose

7IWWMSR

(YTPMGEXIWXLI7IWWMSRQIRYERHGSRXEMRWXLI'YVVIRX7IWWMSR
WIPIGXMSRFS\

)HMX

(YTPMGEXIWXLI)HMXQIRY

*YRGXMSRW

(YTPMGEXIWWSQIGSQQERHWJSYRHYRHIVXLI:MI[*MPIERH
8SSPWQIRYWERHGSRXEMRWXLI'YVVIRX;SVOWTEGIGSQFSFS\

(IFYK

(YTPMGEXIWXLI(IFYKQIRY

3FNIGX

(YTPMGEXIWXLI3FNIGXQIRYERHGSRXEMRWXLI'YVVIRX7GLIQE
GSQFSFS\

8IEQ'SHMRK

(YTPMGEXIWXLI8IEQ'SHMRKQIRY

26

SQL Navigator Users Guide

Visual editors for database objects


7502EZMKEXSV
WIHMXMRKXSSPWJSVHEXEFEWISFNIGXWEVIZMWYEPXLI]KMZI]SYE
ZMWYEPVITVIWIRXEXMSRSJEHEXEFEWISFNIGXHIJMRMXMSR:MWYEPSFNIGXIHMXSVW
EPPS[]SYXSZMI[HEXEFEWISFNIGXHIJMRMXMSRWERHGVIEXISVEPXIVHEXEFEWI
SFNIGXWZMEETSMRXERHGPMGOMRXIVJEGIIPMQMREXMRKXLIRIIHXSVIQIQFIV750
W]RXE\ERH[VMXI750WXEXIQIRXWQERYEPP]
8LI:MWYEP3FNIGX)HMXSVGSQQERHSRXLI:MI[QIRYKMZIW]SYUYMGOEGGIWW
XSEPPXLISFNIGXIHMXSVW=SYGEREPWSSTIRER]SFNIGXJSVIHMXMRKF]HSYFPI
GPMGOMRKMXMRXLI(&2EZMKEXSVXVII

Opening an object editor from the View menu

Chapter 1

Quick Tour of SQL Navigator

27

Opening an object editor from the DB Navigator tree



28

SQL Navigator Users Guide

Powerful SQL Editor


=SYGERIHMXERHI\IGYXI750WXEXIQIRXWERHWGVMTXWGSRXEMRMRKQYPXMTPI
WXEXIQIRXWMRXLI750)HMXSV=SYGERWYFQMXER]750WXEXIQIRXMRGPYHMRK
(10ERH((0WXEXIQIRXW;LIRE7)0)'8WXEXIQIRXMWI\IGYXIHXLIVS[W
VIXYVRIHEVIHMWTPE]IHEWEKVMHERHGERFIHMWTPE]IHEWXI\XXSXLI7TSSP
[MRHS[

The SQL window and the results display




The SQL editing window


contains the SQL
statement(s) to be edited
and executed.

It includes an Execution
Status pane.

When you execute a


SELECT statement, the
Results pane displays the
rows returned in the form of
a dynamic grid with options
for viewing, sorting, and
navigating.
If you want to edit the data,
use the Updateable Query
option in the SQL Editor
toolbar when executing.

Updateable Query
button

Chapter 1

Quick Tour of SQL Navigator

29

Code markers



The Spool Output window



30

SQL Navigator Users Guide

Result Display
8LISYXTYXSJIZIV]750WXEXIQIRXI\IGYXIHGERFIHMWTPE]IHMREVIWM^EFPI
6IWYPXEVIE=SYGERWIXTVIJIVIRGIWXLEXGSRXVSPLS[XLIVIWYPXWEVIHMWTPE]IH
JSVI\EQTPI
 -RXLIPS[IVTERISJEWTPMXIHMXMRK[MRHS[
 3RWITEVEXIXEFFIHTEKIW
8LIVIGERFIQYPXMTPIVIWYPXWIXWSRITIVWXEXIQIRXI\IGYXIH

Drag-and-drop Query Builder


Quickly build complex SQL statements
;MXL7502EZMKEXSV
W5YIV]&YMPHIV]SYGERUYMGOP]FYMPHGSQTPI\750
WXEXIQIRXWF]HVEKKMRKXEFPIWJVSQEPMWXMRXSE[SVOEVIEGLIGOMRKVIUYMVIH
JMIPHWERHPMROMRKXLIQYWMRKEHVEKERHHVSTXIGLRMUYI

Sort and group


5YIV]JIEXYVIWEPWSMRGPYHIWSVXMRKERHKVSYTMRKEWIPIGXMSRGVMXIVMEFYMPHIV
ERHQSVI

Save and re-use queries


5YIVMIWGERFIWEZIHXSHMWOJSVPEXIVVIYWI

Execute and Roll-back


=SYGERSTIRE8IWX[MRHS[XSI\IGYXI750XLIREYXSQEXMGEPP]VSPPFEGOER]
GLERKIW YTHEXIWHIPIXIWSVMRWIVXW 'PSWMRKXLI8IWX[MRHS[VIPEYRGLIW
5YIV]&YMPHIV
8LI5YIV]&YMPHIV[MRHS[LEWX[SVIWM^EFPITERIW
 %[SVOEVIE XSTTERI [LIVI]SYWIPIGXXLIGSPYQRW]SY[ERXMR]SYV
UYIV]ERH[LIVI]SYGEREPWSIEWMP]GVIEXINSMRWF]HVEKKMRKGSPYQR
REQIW
 %UYIV]HMWTPE]EVIE FSXXSQTERI [LIVI]SYGERZMI[]SYVUYIV]MRX[S
HMJJIVIRX[E]WEWMXMWFIMRKFYMPXEW750GSHISVEWEHEXEKVMH=SYGER
EPWSWIXGVMXIVMEMRXLMWEVIE

Chapter 1

Quick Tour of SQL Navigator

31


8LI5YIV]&YMPHIV[MRHS[LEWX[SVIWM^EFPITERIW
 %[SVOEVIE XSTTERI [LIVI]SYWIPIGXXLIGSPYQRW]SY[ERXMR]SYV
UYIV]ERH[LIVI]SYGEREPWSIEWMP]GVIEXINSMRWF]HVEKKMRKGSPYQR
REQIW
 %UYIV]HMWTPE]EVIE FSXXSQTERI [LIVI]SYGERZMI[]SYVUYIV]MRX[S
HMJJIVIRX[E]WEWMXMWFIMRKFYMPXEW750GSHISVEWEHEXEKVMH=SYGER
EPWSWIXGVMXIVMEMRXLMWEVIE

32

SQL Navigator Users Guide

Complete execution environment for stored programs


9WMRK7502EZMKEXSV]SYGER
 FVS[WITVSKVEQWXVYGXYVIW
 ZMI[ERHIHMXXLIWSYVGIGSHISJEPPTVSKVEQYRMXW
 GSQTMPIXLIGSHI
 WIXMRTYXTEVEQIXIVW
 VYRXLITVSKVEQ
 [EXGLXLIVIWYPXWMRXLISYXTYX[MRHS[
8LI7XSVIH4VSKVEQ)HMXSV[LMGL]SYYWIXSIHMX40750ERHSXLIVTVSKVEQ
GSHIMRGPYHIWE'SHI)\TPSVIVXSSPXLEXLIPTWQEOI]SYV[SVO[MXL
TEGOEKIWTVSGIHYVIWERHJYRGXMSRWQSVIIJJMGMIRXERHIVVSVJVII
8LI'SHI)\TPSVIV
 MWFEWIHSREREHZERGIHTEVWMRKXIGLRMUYIXLEXYRHIVWXERHW40750W]RXE\
 HMWTPE]WHIXEMPIHMRJSVQEXMSREFSYXETEGOEKI
WGSQTSRIRXWWYGLEW
ZEVMEFPIWERHTEVEQIXIVWXLIMVX]TIWWXVYGXYVIERHGYVWSVW
 EYXSQEXMGEPP]LMKLPMKLXWXLITEGOEKIHTVSGIHYVI]SYEVIGYVVIRXP]MR
 WYTTSVXWHVEKERHHVSTMRXSXLIIHMXSV
 GSQFMRIWMRJSVQEXMSRJVSQXLIWTIGMJMGEXMSRERHFSH]
 LMKLPMKLXWW]RXE\
 HMWXMRKYMWLIWRSRTYFPMWLIHTVSGIHYVIWERHJYRGXMSRW[MXLEHMJJIVIRXMGSR
 ZMWYEPP]QEVOWTVSGIHYVIWMRWMHIETEGOEKIXLEXGSRXEMRW]RXE\IVVSVW
 PIXW]SYUYMGOP]NYQTFIX[IIRXLIMQTPIQIRXEXMSRERHHIGPEVEXMSRSJXLI
GYVVIRXTVSGIHYVIMRETEGOEKI 'XVP7LMJXYTEVVS[ERH'XVP7LMJXHS[R
EVVS[ 
 PIXW]SYUYMGOP]NYQTFIX[IIRXLIFIX[IIRXLIWTIGMJMGEXMSRERHXLIFSH]
%PX* 
7KH&RGH([SORUHU
EXWWRQRQWKH6WRUHG

 


3URJUDP(GLWRU

WRROEDU



Chapter 1

Quick Tour of SQL Navigator

&RGH([SORUHUWRRO

LQWKH6WRUHG
3URJUDP(GLWRUKHOSV
PDNH\RXUZRUNZLWK
SDFNDJHV
SURFHGXUHVDQG
IXQFWLRQVPRUH
HIILFLHQWDQGHUURU

33







IUHH


 =SYGERWXEVXEWXSVIHTVSKVEQJVSQXLI750)HMXSVXLI(&2EZMKEXSVSV
XLI7XSVIH4VSKVEQ)HMXSV
 =SYGERHIZIPSTERHHIFYK40750GSHITVITEVIXIWXHEXEVYRWXSVIH
TVSKVEQWEKEMRWXXLIHEXEFEWIERHMQQIHMEXIP]ZMI[XLIVIWYPXW
'SQTMPEXMSRIVVSVWEVITVIGMWIP]LMKLPMKLXIH
 *PI\MFPIIHMXMRKERHTVSGIWWMRKPIX]SYWMRKPIWXITXLVSYKLGSHIWOMT
VI[MRHERHSXLIVIHMXMRKJYRGXMSRW
 (VEKERHHVSTJIEXYVIWPIX]SYHVEKERHHVST40750W]RXE\750
JYRGXMSRWGSPYQRREQIWERHHEXEFEWISFNIGXREQIWMRXSGSHI8LI'SHI
%WWMWXERXTVSZMHIWIEW]EGGIWWXSGSHIWRMTTIXWHVEKERHHVSTW]RXE\ERH
XLI40:MWMSRGEXEPSKW
 9WMRKXLI(IFYK1SHI]SYGER[EXGLXLIZEVMEFPIHYVMRKVYRXMQI=SY
GERVYRWXSVIHTVSKVEQWMRTEVEPPIPF]STIRMRKEHHMXMSREPWIWWMSRW[MXLMR
7502EZMKEXSV9WMRK3VEGPIVYRERHHIFYKTVSGIHYVIW[MXLTEVEQIXIVW
SJX]TI407506)'36(
 8LI)\IGYXMSR'SHI;M^EVHERHMRXIKVEXIH40750HIFYKKMRKXSSPWLIPT
]SYGVIEXIERSR]QSYW40750FPSGOWXLEXGEPPWXSVIHTVSKVEQW-JERIVVSV
SGGYVW[LIRXV]MRKXSVYREKIRIVEXIHGEPPMRKGSHIFPSGO JSVI\EQTPIHYI
XSEW]RXE\IVVSV SVMJ]SYGLSSWIXSIHMXXLIFPSGOFIJSVIVYRRMRKMXXLI
XI\XMWSTIRIHMRXLI750)HMXSV

34

SQL Navigator Users Guide

 7502EZMKEXSVMRXIKVEXIW[MXL*SVQEXXIV4PYWEYRMUYIYXMPMX]JSV
VIJSVQEXXMRKI\MWXMRK40750750ERH750 4PYW XLVSYKL WSYVGI
GSHI*SVQEXXIV4PYWL]TIVJEWXVIJSVQEXXMRKMRWXERXP]MQTVSZIWXLI
QEMRXEMREFMPMX]SJGSHIF]EHZERGIHEREP]WMWERHTVSJMPMRKQIXLSHW
 =SYGERHIJMRIFSSOQEVOWERHIEWMP]QSZIFIX[IIRXLIQ[MXLMREPEVKI
TVSKVEQ
 =SYLEZIXLISTXMSRXSEYXSQEXMGEPP]GSQTMPIEPPHITIRHIRXSFNIGXW[LIR
WEZMRKERSFNIGXYWMRKXLISFNIGXIHMXSV8LMWIPMQMREXIWXLIRIIHXSJMRH
ERHGSQTMPIEPPHITIRHIRXSFNIGXWXLEXFIGEQIMRZEPMH[LIREPXIVMRKE
TVSGIHYVIXEFPISVSXLIVWXVYGXYVI
 8LIMRXIKVEXIH3YXTYX[MRHS[MWGSRZIRMIRXJSVXIWXMRKERHHIFYKKMRK
[MXL7EZIERH4VMRXSTXMSRW-XEPPS[WYTXSPMRIWSJSYXTYXXSFI
HMWTPE]IHERHIPMQMREXIWXLIRIIHXSW[MXGLXSERSXLIVXSSPXSXIWX]SYV
WXSVIHTVSKVEQW8LI3YXTYX[MRHS[GERFIQEHIEHSGOEFPIWXE]SRXST
[MRHS[SVERSVQEP1(-[MRHS[F]QIERWSJEWLSVXGYXQIRYSTXMSR
 =SYGERGSVVIGXIVVSVWIEWMP][MXLZMVXYEPP]YRPMQMXIHPIZIPWSJ9RHSERH
6IHSJYRGXMSRW
 'YWXSQM^IHGSPSVWIPIGXMSRJSV40750ERH750OI][SVHWXI\XERH
GSQQIRXWQEOIWGSHIQSVIVIEHEFPI
 =SYGERWEZIXMQIF]YWMRKTVSKVEQQEFPIOI]WERHLSXOI]WJSVJVIUYIRXP]
YWIH40750GSHIMRGPYHMRKQYPXMPMRIWIKQIRXW
 8SZMI[EJYPP]I\TERHIH3VEGPIIVVSVHIWGVMTXMSR]SYGERHSYFPIGPMGOSR
ERIVVSVGSHIMRER]SJXLIIHMXSVWSVMRXLI3YXTYX[MRHS[8LIVIWYPXMRK
HMEPSKGSRXEMRWXLIIVVSVQIWWEKIHIWGVMTXMSRGEYWIERHEGXMSRWNYWXEW
XLI]ETTIEVMRXLI3VEGPIHSGYQIRXEXMSR
 8LI,810-QTSVXGETEFMPMX]PIXW]SYIEWMP]GSRZIVXER,810JMPIMRXSE
40750WXSVIHTVSGIHYVI8LIWXSVIHTVSGIHYVI[MPPMRXYVRSYXTYXXLI
,810GSHIZMEXLI3VEGPI;IF'EVXVMHKI

Chapter 1

Quick Tour of SQL Navigator

Complete and extensible code template libraries


8LI'SHI%WWMWXERXKMZIW]SYMRWXERXEGGIWWXSXIQTPEXIWJSV
 3TXMQM^EXMSRLMRXW
 40750W]RXE\
 750JYRGXMSRW
 ;IF7IVZIV407504VSGIHYVIW
 40:MWMSRPMFVEVMIW
=SYGEREPWSGVIEXI]SYVS[RPMFVEVMIWSJGSHIWRMTTIXW
=SYGERHVEKXLIWIMXIQWMRXS]SYVGSHIIHMXMRK[MRHS[JSVJEWXIEW]ERH
EGGYVEXIGSHIKIRIVEXMSR

Code Assistant window

35

36

SQL Navigator Users Guide

PL/SQL Debugger
8LI7502EZMKEXSVHIZIPSTQIRXIRZMVSRQIRXMRGPYHIWERSTXMSREPMRXIKVEXIH
40750(IFYKKIV8LIHIFYKKIVVIUYMVIWEWITEVEXIPMGIRWIEKVIIQIRX
7502EZMKEXSV
W(IFYKKIVLIPTW]SYHIFYKWXSVIHTVSKVEQWMRGPYHMRK
 TVSGIHYVIW
 JYRGXMSRW
 TEGOEKIWERHTEGOEKIFSHMIW
 XVMKKIVW
 X]TIWERHX]TIFSHMIW
;MXLXLI40750(IFYKKIV]SYGER
 -RMXMEXIHIFYKKMRKJVSQ[MXLMRERIHMXMRKWIWWMSR
 7IX[EXGLIWERHFVIEOTSMRXWFIJSVISVHYVMRKHIFYKKMRKHMVIGXP]JVSQXLI
GSHIIHMXSV
 )\IGYXIER]40750GSHIWXITF]WXITSVTSMRXXSTSMRX
 8VEGIMRXSQYPXMTPIPIZIPWSJTVSGIHYVIGEPPW
 )\EQMRIERHWIXZEVMEFPIWHYVMRKI\IGYXMSRSJTVSGIHYVIW
 :MI[XLIGEPPWXEGOERHZEPYIWSJ[EXGLIHZEVMEFPIWEXER]TSMRXHYVMRKXLI
HIFYKKMRKWIWWMSR
 %GGIWWEPPJYRGXMSRWSJ7502EZMKEXSVEJXIVEHIFYKWIWWMSRMWWXEVXIH
 (IFYK40750GSHIXLEXMWVYRJVSQERI\XIVREPGPMIRXWIVZIVETTPMGEXMSR
YWMRK7502EZMKEXSV
W.YWX-R8MQI(IFYKKMRKJIEXYVI
 8VEGO]SYVETTPMGEXMSR
WJPS[SJI\IGYXMSRQSRMXSVZEVMEFPIWERHIZIR
GLERKIXLII\IGYXMSRPSKMGlSRXLIJP]zF]QSHMJ]MRKZEPYIWSJTVSKVEQ
ZEVMEFPIW

Chapter 1

Quick Tour of SQL Navigator

Debugger commands

37

38

SQL Navigator Users Guide

Team coding and Version Control support


7502EZMKEXSVTVSZMHIWI\XIRWMZIERHJPI\MFPI8IEQ'SHMRKGSRXVSPW
MRGPYHMRKMRXIKVEXMSR[MXLXLMVHTEVX]ZIVWMSRGSRXVSPW]WXIQW
8LI7502EZMKEXSV8IEQ'SHMRKQSHYPI
 TVSZMHIW40750(IZIPSTIVW[MXLXLIEFMPMX]XSHIZIPSTWXSVIHTVSKVEQW
4VSGIHYVIW*YRGXMSRW4EGOEKIW8VMKKIVWERH:MI[W MREGSSTIVEXMZI
QERRIV
 TVIZIRXWQYPXMTPI7502EZMKEXSVYWIVWQSHMJ]MRKXLIWEQISFNIGXW
GSRGYVVIRXP]XLVSYKLEGLIGOMRGLIGOSYXQIGLERMWQ
8LIWIJIEXYVIWEVIEZEMPEFPIXSEPPYWIVW[LIXLIVSVRSXXLI]EVIYWMRKEXLMVH
TEVX]ZIVWMSRGSRXVSPTVSHYGX
7502EZMKEXSVEPWS[SVOW[MXLEXLMVHTEVX]ZIVWMSRGSRXVSPTVSHYGXXS
QEMRXEMRVIZMWMSRLMWXSVMIW8LMWLETTIRWEYXSQEXMGEPP]MRXLIFEGOKVSYRHWS
]SYHSR
XLEZIXSPIEZI7502EZMKEXSVXSYTHEXI]SYVZIVWMSRGSRXVSPVIZMWMSR
LMWXSVMIW

Team Coding menu and toolbar





Chapter 1

Quick Tour of SQL Navigator

39

Viewing the status of objects under Team Coding control


8LI8IEQ'SHMRK:MI[IVWLS[WHIXEMPWSJSFNIGXWYRHIV8IEQ'SHMRK
GSRXVSPMRGPYHMRK[LMGLSFNIGXWEVIGYVVIRXP]GLIGOIHSYXERH[LIRXLI][IVI
PEWXGLIGOIHMR'LIGOIHSYXSFNIGXWEVIJPEKKIH
=SYGERGLIGOSYXSVGLIGOMRSFNIGXWHMVIGXP]JVSQXLMW[MRHS[ERH [MXL
ETTVSTVMEXITVMZMPIKIW ]SYGEREPWSJVII^ISFNIGXWWSXLEXXLI]GERRSXFI
QSHMJMIHF]SXLIVYWIVW%WWLS[RFIPS[]SYGERZMI[HIXEMPWSJER]SFNIGXMR
XLIPMWX

Viewing object details in the Team Coding Viewer

Reviewing the Version Control archives


=SYGERZMI[EPPZIVWMSRGSRXVSPEVGLMZIWMREPPTVSNIGXWYWMRKXLI750
2EZMKEXSV:IVWMSR'SRXVSP&VS[WIV%WWLS[RFIPS[]SYGERZMI[
HMJJIVIRGIWFIX[IIRVIZMWMSRW=SYGEREPWSGLIGOSYXSFNIGXWERHWGVMTXWYWMRK
XLI:IVWMSR'SRXVSP&VS[WIV
8LMWFVS[WIVMWRSXEZEMPEFPIXSYWIVWSJ7''%4-8IEQ'SHMRKWYTTSVX
MRWXIEHWIPIGXMRKXLMWSTXMSRPEYRGLIWXLIYWIVMRXIVJEGISJXLIXLMVHTEVX]
TVSHYGXMRYWI 

40

SQL Navigator Users Guide

Preparing to compare versions from the Version Control Browser

Graphic profiler for optimizing stored programs


=SYGERYWIXLIMRXIKVEXIH'SZIVEKI4VSJMPMRKXSSPXSEREP]^IXLII\IGYXMSR
XMQIERHIJJMGMIRG]SJ]SYVWXSVIHTVSKVEQW 3VEGPISVLMKLIV 
8LI407504VSJMPIVTVSZMHIWIEW]XSYWITVSJMPMRKMRGPYHMRKI\IGYXMSRXMQI
WXEXMWXMGWERHGSZIVEKIEREP]WMWJSV40750HIZIPSTIVW9RPMOIXLITVSJMPMRK
YXMPMXMIWTVSZMHIH[MXL3VEGPIERHPEXIVXLI407504VSJMPIVXSSPMW
KVETLMGEPERHEPPS[WIEW]REZMKEXMSRERHHVMPPHS[RXLVSYKLXLIHEXE8LI
4VSJMPIVMWTEVXMGYPEVP]YWIJYPJSV
 JMRHMRKFSXXPIRIGOWMRWXSVIHGSHI
 UYEPMX]EWWYVERGIERHXIWXMRK
8LI4VSJMPIV[MPPWLS[]SYEPMRIF]PMRIEREP]WMWSJXLII\IGYXMSRMRGPYHMRK
XLIRYQFIVSJXMQIWIEGLPMRI[EWI\IGYXIHERHXLIXMQIVIUYMVIHJSV
I\IGYXMSR

Chapter 1

Quick Tour of SQL Navigator

41

Summary and statistics results from a profiling run



42

SQL Navigator Users Guide

Best-practice recommendations for


code structure
*SVQEXXIV4PYWMWEZIV]TS[IVJYPERHJPI\MFPIXSSPJSVEREP]^MRKERH
JSVQEXXMRKIRXMVI40750ETTPMGEXMSRW=SYKIXMRWXERXGSHIJSVQEXXMRKJSVER
IRXMVIETTPMGEXMSRSVNYWXEWMRKPIJMPIERHMRWXERXGSHIVIZMI[W[LMPI]SY
GSHIr[MXLFIWXTVEGXMGIVIGSQQIRHEXMSRWJSVGSHIGSVVIGXRIWW
QEMRXEMREFMPMX]IJJMGMIRG]VIEHEFMPMX]ERHTVSKVEQWXVYGXYVI

Chapter 1

Quick Tour of SQL Navigator

43

Web development support


7502EZMKEXSVkW;IF(IZIPSTQIRXTVSZMHIWERMRXIKVEXIHHIZIPSTQIRX
IRZMVSRQIRX[MXLEHZERGIHGSHMRKXIWXMRKERHZMI[MRKSJ40750TVSKVEQW
JSVXLI3VEGPI;IFWIVZIV-XMRGPYHIWE[IFWIVZIVW]RXE\XSSPERMRXIKVEXIH
,810FVS[WIVER,810XS40750GSRZIVXIVERHGSRXI\XWIRWMXMZILIPT
JSV[IFWIVZIVJYRGXMSRW8LMWEPPS[WYWIVWXSHIZIPSTXLI40750GSHI
MRHITIRHIRXSJXLI[IFWIVZIVERHZMI[XLI,810MRERMRXIKVEXIH[IF
FVS[WIVXLIVIF]IPMQMREXMRKXLIRIIHXSW[MXGLJVSQXLIMVGSHMRKIRZMVSRQIRX
XSERI\XIVREPFVS[WIV

Viewing HTML source in SQL Navigator



44

SQL Navigator Users Guide

Previewing HTML output in SQL Navigator



Chapter 1

Quick Tour of SQL Navigator

45

Importing HTML as PL/SQL

46

SQL Navigator Users Guide

Previewing HTML output

Chapter 1

Quick Tour of SQL Navigator

47

Reporting tools
7502EZMKEXSVGSRXEMRWJPI\MFPIVITSVXMRKXSSPWXLEXPIX]SYTVMRXVITSVXWSR
SFNIGXWMREHEXEFEWI=SYGERKIRIVEXIVITSVXWJVSQEPPHEXEFEWIMRWXERGIWSV
JVSQWIPIGXIHHEXEFEWIWERH]SYGERWTIGMJ]GVMXIVMEXSPMQMXXLIVITSVXXS
GIVXEMRXEFPIWSVGSPYQRW
(S^IRWSJVITSVXXIQTPEXIWEVITVSZMHIHJSVTVMRXMRKVITSVXWSJWIPIGXIHSFNIGXW
JVSQSRISVQSVIHEXEFEWIW

Generating a report from the Report Tree



48

SQL Navigator Users Guide

How to find the help you need


=SYLEZIWIZIVEPSTXMSRWJSVUYMGOP]JMRHMRKXLIMRJSVQEXMSR]SYRIIHJVSQ
XLI7502EZMKEXSVSRPMRILIPTW]WXIQ

Context-sensitive help for a window or dialog


 4VIWW*SVGPMGOXLI,IPTFYXXSRMRE7502EZMKEXSV[MRHS[SVHMEPSK

2SXI2SXEPP[MRHS[WERHHMEPSKWEVIPMROIHXSWTIGMEPLIPTXSTMGW

General and How-To information


 *VSQXLI7502EZMKEXSV,IPTQIRYGLSSWI'SRXIRXW
 -RXLI,IPT[MRHS[FVS[WILIPTXSTMGWYWMRKXLI'SRXIRXWPMWX MRXLIPIJX

TERI 

Locate SQL Navigator commands


 *VSQXLI7502EZMKEXSV,IPTQIRYGLSSWI*MRHE'SQQERH
 -RXLI,IPT[MRHS[TIVJSVQEOI][SVHSVJYPPXI\XWIEVGLSREGSQQERH

REQI

Look up keyboard shortcuts and function keys


 *VSQXLI7502EZMKEXSV,IPTQIRYGLSSWI7LSVXGYX *YRGXMSROI]W

Keyword searching
 -RXLI,IPT[MRHS[GPMGOXLI-RHI\XEFXSGLSSWIJVSQEPMWXSJMRHI\IH
XSTMGW
 -RXLI,IPT[MRHS[GPMGOXLI7IEVGLXEFXSTIVJSVQEJYPPXI\XWIEVGLSJ

the help files.


Closely related topics
 9WIXLIFEGOERHJSV[EVHFYXXSRWMRXLIXSSPFEVEXXLIXSTSJXLI,IPT

[MRHS[XSFVS[WIXLVSYKLEWIVMIWSJVIPEXIHXSTMGW

 'PMGOXLI7II%PWSFYXXSRMRXLIXSSPFEVEXXLIXSTSJXLI,IPT[MRHS[XS

GLSSWIJVSQEPMWXSJVIPEXIHXSTMGW



8LIFVS[WIFYXXSRWERHXLI7II%PWSFYXXSREVIMRXLIXSSPFEVEXXLIXSTSJXLI
,IPT[MRHS[8LIVIQE]EPWSFIE7II%PWSFYXXSR[MXLMRXLIXSTMG[MRHS[

Chapter 1

Quick Tour of SQL Navigator

L Still cant find it?


-J]SYJMRHXLEXMRJSVQEXMSRMRXLI,IPTW]WXIQMWMRGSVVIGXYRGPIEVSV
MRGSQTPIXITPIEWIVITSVXXLITVSFPIQXS5YIWXXIGLRMGEPWYTTSVX 7II
l'SRXEGXWzSRTEKI
For all the latest product information, including
tips and techniques, visit
www.quest.com/sql_navigator .




49

2
Whats new in this version?

9WIVWYTKVEHMRKJVSQTVIZMSYWZIVWMSRW[MPPJMRHEWYQQEV]SJRI[ERH
IRLERGIHJIEXYVIWMRXLMWGLETXIV

In this chapter
Whats new in SQL Navigator 4?
Getting access to new features
Interface Enhancements
Editing Enhancements
Debugger enhancements
New and improved development tools
Improved Team Coding facilities
General and miscellaneous enhancements

52
52
53
72
89
94
104
105

52

SQL Navigator Users Guide

Whats new in SQL Navigator 4?


7502EZMKEXSVHIPMZIVWEHVEQEXMGMQTVSZIQIRXSZIVMXWTVIHIGIWWSV
ZIVWMSR MRMXWYWEFMPMX]VSFYWXRIWWERHTIVJSVQERGI7502EZMKEXSV
W
IRLERGIHYWIVMRXIVJEGIERHSXLIVMQTSVXERXRI[ERHMQTVSZIHJIEXYVIWQEOI
MXERIZIRQSVITS[IVJYPXSSP[MXLSYXYRRIGIWWEV]GSQTPI\MX]1ER]SJXLI
TIVJSVQERGIMQTVSZIQIRXWERHIEWISJYWIIRLERGIQIRXWEVIEMQIHEXYWIVW
[LSHIZIPSTETTPMGEXMSRWJSVPEVKIHEXEFEWIW

To browse descriptions of new features


9WIXLI&VS[WIFYXXSRWMRXLI,IPT[MRHS[XSSPFEV
SV
9WIXLI,IPT8EFPISJ'SRXIRXWTERIXSPSGEXIETEVXMGYPEVWYFXSTMG
 8LIFVS[WIFYXXSRWEVIMRXLIXSSPFEVEXXLIXSTSJXLI,IPT[MRHS[




Getting access to new features


2I[STXMSRWLEZIFIIREHHIHXSXLIQIRYWERHXSSPFEVW,S[IZIVXLI]QE]
RSXFIZMWMFPIMJ]SYLEZIYWIHERIEVPMIVVIPIEWISJ7502EZMKEXSVERHQEHI
ER]GYWXSQM^EXMSRWXSXLIQIRYWSVXSSPFEVW
8SQEOIXLIRI[STXMSRWZMWMFPI]SYGERIMXLIV
 VIWIXQIRYWERHXSSPFEVWEYXSQEXMGEPP]XSXLIHIJEYPXSTXMSRWSV
 QERYEPP]GYWXSQM^IQIRYWERHXSSPFEVWJSVXLIMRHMZMHYEPSTXMSRW]SY
TVIJIV

To reset toolbars to the default settings


1
2
3
4

3RXLIJEVVMKLXSJXLIQEMRQIRYFEVSVSJER]XSSPFEVGPMGOXLI 
1SVI&YXXSRW FYXXSR
'LSSWI%HHSV6IQSZI&YXXSRW
7IPIGXXLIMXIQWXSFIVIWIXERHXLIRGPMGO6IWIX8SSPFEV2SXIXLEXER]
TVIZMSYWGYWXSQM^EXMSRW[MPPFIPSWX
'SRJMVQXLITVSQTXXSVIWIXXLIWIPIGXIHXSSPFEVW

Chapter 2

Whats new in this version?

53

To display or hide individual toolbars


1
2
3

3RXLIJEVVMKLXSJXLIQEMRQIRYFEVSVSJER]XSSPFEVGPMGOXLI 
1SVI&YXXSRW FYXXSR
'LSSWI%HHSV6IQSZI&YXXSRWERHXLIRGPMGOXLI'YWXSQM^IXEF
7IPIGXEXSSPFEVREQIXSQEOIXLEXXSSPFEVETTIEVMRXLI7502EZMKEXSV
ETTPMGEXMSR[MRHS[SVGPIEVXLIWIPIGXMSRXSLMHIMX

To add or remove individual commands


1
2
3
4

-RXLIQEMRQIRYFEVSRXLIJEVVMKLXGPMGOXLI  1SVI&YXXSRW 
FYXXSR
'LSSWI%HHSV6IQSZI&YXXSRWERHXLIRGPMGOXLI'YWXSQM^IXEF
8SVIQSZIMXIQWJVSQ7502EZMKEXSVQIRYWERHXSSPFEVW]SYGERWMQTP]
HVEKXLIQSJJXLIXSSPFEVSVQIRY[LMPIXLI'YWXSQM^IHMEPSKMWEGXMZI
8SEHHMXIQWXS7502EZMKEXSVQIRYWERHXSSPFEVW]SYGERWMQTP]HVEK
XLIQJVSQXLIGSQQERHPMWXWMRXLI'YWXSQM^IHMEPSKXSXLIXSSPFEVSV
QIRY[LIVI]SY[ERXXLIQXSFIZMWMFPI

Interface Enhancements
Interface Enhancements
-RVIWTSRWIXSYWIVW
VIUYIWXWRYQIVSYWMQTVSZIQIRXWLEZIFIIRQEHIXSXLI
7502EZMKEXSVMRXIVJEGI
 )EWMIVW[MXGLMRKFIX[IIRWIWWMSRW
 8LIQEMRQIRYERHXSSPFEVWEVIRS[JYPP]GYWXSQM^EFPI
 1ER]XSSP[MRHS[WRSXNYWXXLI3YXTYX[MRHS[EVIRS[HSGOEFPI
 9WIVWGERUYMGOP]JMRHERHEGXMZEXIXLIMV[MRHS[WYWMRKEXEWOFEV
 0SRKVYRRMRKXEWOWEVIRS[TIVJSVQIHMRXLIFEGOKVSYRHERHPSGOSRP]
XLIGYVVIRXWIWWMSR
 8LIQEMRQIRYERHXSSPFEVWLEZIFIIRQEHIWMQTPIVERHQSVIMRXYMXMZI
ERHEVIJYPP]GYWXSQM^EFPI
 (VEKERHHVSTJYRGXMSREPMX]LEWFIIRI\XIRHIH
 8LITVMQEV]XI\XJSRXYWIHXLVSYKLSYXXLI-()MWRS[YWIVWIPIGXEFPI

54

SQL Navigator Users Guide

Customizable menus and toolbars


8LIQIRYWERHXSSPFEVWEVIJYPP]GYWXSQM^EFPI%R]QIRYMXIQFYXXSRSV
XSSPFEVGERFILMHHIRSVWLS[R9WIVWGERGVIEXISVVIQSZIXSSPFEVWVISVHIV
MXIQWERHEHHMXIQWJVSQEQEWXIVGSQQERHPMWXYWMRKHVEKERHHVST%R]
GYWXSQM^EXMSRMWWEZIHTIVQERIRXP]MRXLIW]WXIQVIKMWXV]ERHVIWXSVIH
EYXSQEXMGEPP]RI\XXMQI7502EZMKEXSVMWVYR



Docking toolbars and windows


Windows
8LIJSPPS[MRK[MRHS[WGERFIQEHIHSGOEFPIWXE]SRXST[MRHS[WSV
RSVQEP1(-[MRHS[W
 3YXTYX[MRHS[
 ;SVOWTEGI[MRHS[
 %YXS(IWGVMFI[MRHS[
 )\IGYXMSR7XEXYW[MRHS[ MRXLI(IFYKKIV 
 'SHI%WWMWXERX[MRHS[
 8EWO1EREKIV[MRHS[
 7SYVGI4VIZMI[[MRHS[

Chapter 2

Whats new in this version?

55

(SGOEFPI[MRHS[WGERFIHSGOIHXSXLIXSTFSXXSQSVWMHIWSJXLIQEMR
[MRHS[SVER]SXLIVHSGOEFPI[MRHS[
;LIRXLI(SGOEFPISTXMSRMWWIPIGXIHJSVXLI3YXTYX[MRHS[MXVIQEMRW
ZMWMFPI SRXST [LIRSXLIV[MRHS[WEVISTIRIH 8LMWMWRSXXVYISJSXLIV
HSGOEFPI[MRHS[WMR7502EZMKEXSV ;LIRXLI(SGOEFPISTXMSRMWRSX
WIPIGXIHXLI3YXTYX[MRHS[MWERSVQEP1(-[MRHS[XLEXGERFILMHHIR
FILMRHXLIGYVVIRX[MRHS[
=SYGERHSGOWIZIVEP[MRHS[WXSXLIWEQIWMXI
;LIRQSZMRKEHSGOEFPI[MRHS[]SYGERTVIZIRXMXJVSQHSGOMRKF]LSPHMRK
HS[RXLI'XVPOI]
=SYGERGPSWIEHSGOEFPI[MRHS[[LIXLIVMXMWJPSEXMRKSVHSGOIH;LIR
STIRIHEHSGOEFPI[MRHS[EYXSQEXMGEPP]ETTIEVWMRXLIWEQIWXEXI JPSEXMRK
SVHSGOIH ERHMRXLIWEQIWGVIIRTSWMXMSRSVEXXLIWEQIWMXIEW[LIRMX[EW
PEWXGPSWIH

Toolbars
8SSPFEVWGERFIHSGOIHXSER]WMHISJXLIQEMR[MRHS[SVGERJPSEXSRXSTSJ
XLIGYVVIRX[MRHS[%HHMXMSREPP]XLIQEMRQIRYFEVGERFIJPSEXMRKSV
HSGOIH
<RXFDQPRYHWRROEDUVFORVHWRWKHDUHDZKHUH\RXDUHZRUNLQJ



56

SQL Navigator Users Guide

Synchronized menus and toolbars


%RI[JIEXYVISJ7502EZMKEXSVMWXLIGSRGITXSJGYVVIRXSFNIGXW(EXEFEWI
SFNIGXWEWWSGMEXIH[MXLERSTIR[MRHS[FIGSQIGYVVIRXJSVXLIIRXMVI750
2EZMKEXSVHIZIPSTQIRXIRZMVSRQIRX -() 
;LIRIZIV]SYSTIRSVWIPIGXEHEXEFEWISFNIGX EXEFPITVSGIHYVIJYRGXMSR
MRHI\ERHWSSR MRSRISJXLIJSPPS[MRK[MRHS[W7502EZMKEXSVIREFPIWEPP
XLIETTVSTVMEXIQIRYSVXSSPFEVGSQQERHWJSVXLEXSFNIGX
 (&2EZMKEXSV
 *MRH3FNIGXW
 'SHI7IEVGL
 ;SVOWTEGI
 (IWGVMFIXSSP
 :MWYEPSFNIGXIHMXSVW
 &VS[WI)HMXHEXE

EXAMPLE
;LIRERSFNIGXMWHMWTPE]IHMRERIHMXMRK[MRHS[]SYGERYWIXLI
0SGEXI
MR7GLIQEGSQQERH MRXLI3FNIGXQIRY XSNYQTXSXLEXSFNIGX
WRSHIMRXLI
(&2EZMKEXSVXVIII\TERHMRKEPPMRXIVQIHMEXIRSHIWERHHMWTPE]MRKXLI
SFNIGX
WHIXEMPZMI[

Simplified menus and toolbars


Main menu bar
8LIQEMRQIRYWERHXSSPFEVWLEZIFIIRWMQTPMJMIHJSVQSVIMRXYMXMZIEGGIWWXS
GSQQERHWERHJYRGXMSRW8LIQEMRQIRYFEVRS[ F]HIJEYPX GSRXEMRWXLI
JSPPS[MRKQIRYW
This menu...

Has commands for...

*MPI

STIVEXMSRWSRIRXMVIJMPIWERH[SVOWTEGIWTPYWXLI)\MX
GSQQERH

)HMX

GSQQSRXI\XIHMXMRKEGXMSRW

7IEVGL

JMRHMRKXI\XGSHIERHHEXEFEWISFNIGXW

:MI[

GSRXVSPPMRKXLIETTIEVERGISJZEVMSYW[MRHS[W

7IWWMSR

WIWWMSR[MHIEGXMSRW

3FNIGX

STIVEXMRKSRHEXEFEWISFNIGXW

Chapter 2

Whats new in this version?

57

This menu...

Has commands for...

(IFYK

GSHIHIFYKKMRK

8SSPW

MRZSOMRKERHGSRXVSPPMRKWIGSRHEV]XSSPW

8IEQ'SHMRK

EGGIWWXSGSHIGSRXVSPJIEXYVIW

;MRHS[

1EREKMRKSTIR7502EZMKEXSV[MRHS[W

,IPT

EGGIWWXSSRPMRILIPT

Main window toolbars


8LIJSPPS[MRKXSSPFEVWEVIRS[EZEMPEFPIMRXLIQEMR[MRHS[%PPXSSPFEVW
EVIGYWXSQM^EFPI
Toolbar

Purpose

8IEQ'SHMRK

HYTPMGEXIWXLI8IEQ'SHMRKQIRY

7IWWMSR

HYTPMGEXIWXLI7IWWMSRQIRYERHGSRXEMRWXLI'YVVIRX
7IWWMSRGSQFSFS\

)HMX

HYTPMGEXIWXLI)HMXQIRY

*YRGXMSRW

HYTPMGEXIWWSQIGSQQERHWJSYRHYRHIVXLI:MI[*MPI
ERH8SSPWQIRYWERHGSRXEMRWXLI'YVVIRX;SVOWTEGI
GSQFSFS\

(IFYK

HYTPMGEXIWXLI(IFYKQIRY

3FNIGX

HYTPMGEXIWXLI3FNIGXQIRYERHGSRXEMRWXLI'YVVIRX
7GLIQEGSQFSFS\

Object menu and toolbar


*SVEHHIHGSRWMWXIRG]ERHIEWISJYWIEGVSWWXLIIRXMVIETTPMGEXMSRXLI3FNIGX
QIRYERH3FNIGXXSSPFEVEVIEP[E]WEZEMPEFPI-RXLI(&2EZMKEXSVXLI
3FNIGXQIRYERHXSSPFEVVITPEGIXLI2EZMKEXSVXSSPFEVERHTSTYTQIRYW
8LIEGXMSRWPMWXIHMRXLI3FNIGXQIRYERHXSSPFEVEVIGSRXI\XWIRWMXMZIXLI]
EVIEP[E]WVIPIZERXXSXLIGYVVIRXP]WIPIGXIHSFNIGXWMRXLIGYVVIRX[MRHS[
JSVI\EQTPIXLIGYVVIRXXVIIRSHIPMWXMXIQSVHEXEFEWISFNIGX

58

SQL Navigator Users Guide

Improved Preferences setup


%VIHIWMKRIH4VIJIVIRGIWHMEPSKTVSZMHIWGPIEVERHGSRWMWXIRXZMWYEP
VITVIWIRXEXMSRSJKPSFEPW]WXIQTVIJIVIRGIW8LI4VIJIVIRGIWHMEPSKRS[YWIWE
LMIVEVGLMGEPX[SGSPYQRKVMH DMRWTIGXSV
XSVITVIWIRXTVIJIVIRGIWVITPEGMRK
XLISPHQYPXMXEFFIHDRSXIFSSO
GSRXVSP8LIRI[JSVQEXMWRSXSRP]IEWMIVXS
ZMI[ERHGSRXVSPFYXVIUYMVIWPIWWW]WXIQVIWSYVGIW
%RYQFIVSJRI[TVIJIVIRGIWLEZIFIIREHHIH3ZIVSRILYRHVIHTVIJIVIRGI
WIXXMRKWEVIEZEMPEFPIJSV]SYXS[SVO[MXL

Preference settings are available through the View menu



Chapter 2

Whats new in this version?

59

Drag-and-Drop enhancements
8LIJSPPS[MRKI\XIRWMSRWXSXLIHVEKERHHVSTJIEXYVIEVIEZEMPEFPIMRXLI
GYVVIRXZIVWMSR
If you want to...

Then...

3TIRERSFNIGXMR
ERIHMXSV

(VEKXLISFNIGXJVSQXLI(&2EZMKEXSV*MRH3FNIGXW
[MRHS[SV;SVOWTEGISRXSXLIETTPMGEXMSRHIWOXST

%HHERSFNIGXXSE
[SVOWTEGI

(VEKXLISFNIGXJVSQXLI(&2EZMKEXSVSV*MRH
3FNIGXW[MRHS[XSXLI;SVOWTEGI

%HHEGSHIPSGEXMSR
WLSVXGYX
FSSOQEVO XSE
[SVOWTEGI

(VEKXLIWIPIGXMSRJVSQXLIVIWYPXPMWXMRXLI7IEVGL
7SYVGI'SHI[MRHS[XSXLI;SVOWTEGI

%HHERSFNIGXXSXLI
5YIV]&YMPHIV
W
[SVOWTEGI

(VEKXLIXEFPISVZMI[JVSQXLI(&2EZMKEXSV*MRH
3FNIGXW[MRHS[SV;SVOWTEGIXSXLI5YIV]&YMPHIV

%HHERI\XIVREPJMPI
XSXLIGYVVIRX
[SVOWTEGI

(VEKXLIJMPIJVSQXLI;MRHS[W)\TPSVIVXSXLI
;SVOWTEGI

3TIRERI\XIVREP
JMPIMR750)HMXSV

(VEKXLIJMPIJVSQXLI;MRHS[W)\TPSVIVXSXLIQEMR
[MRHS[

60

SQL Navigator Users Guide

Personalized workspaces for developers


7502EZMKEXSV
W;SVOWTEGIJIEXYVIKMZIW]SYMRWXERXEGGIWWXS]SYVJVIUYIRXP]
YWIHHEXEFEWISFNIGXWERHGSRRIGXMSRW
;SVOWTEGIWEVI[MRHS[W[LIVI]SYGERWXSVIWIXWSJVIPEXIHMXIQWXLEX]SY
JVIUYIRXP]RIIHXS[SVO[MXL-RWXIEHSJWIEVGLMRKJSVXLIIRXMXMIW]SY[ERXXS
[SVO[MXLMRZEVMSYWPMWXWERHHMVIGXSVMIW]SYGERWXSVIWLSVXGYXWXSXLSWI
SFNIGXWMR]SYV[SVOWTEGIW=SYGERYWI]SYV[SVOWTEGIXSPSKSRXSXLI
HEXEFEWI7MQTP]HSYFPIGPMGOEGSRRIGXMSRSVSFNIGXMRXLI[SVOWTEGIXS
GVIEXIERI[WIWWMSR


8LIWIMXIQWGERMRGPYHI
 JMPIW
 HEXEFEWIGSRRIGXMSRW YWIVREQIGSRRIGXMSRWXVMRKW 
 WGLIQEW MRTEVXMGYPEVGSRRIGXMSRW 
 WGLIQESFNIGXW
 GSHIPSGEXMSRFSSOQEVOW[MXLMRWXSVIHTVSKVEQW
 WGLIQESFNIGXXIQTPEXIW
=SYGERGVIEXIQYPXMTPI;SVOWTEGIW0MOIXLISXLIVHSGOEFPI[MRHS[WXLI
;SVOWTEGI[MRHS[WVIXEMRWM^IERHTSWMXMSRFIX[IIRWIWWMSRWIEGLMRHMZMHYEP
[SVOWTEGI[MRHS[VIXEMRWMXWS[RWIXSJTEVEQIXIVW

Chapter 2

Whats new in this version?

61

New Task Bar for easier window-switching


-RTVIZMSYWZIVWMSRWJMRHMRKE[MRHS[MRXLIEGXMZI[MRHS[PMWX[LIRQER]
[MRHS[W[IVISTIRGSYPHFIHMJJMGYPXHYIXSPMQMXEXMSRWSJXLIWXERHEVH
;MRHS[W1(-QIGLERMWQ8LIPMWX[EWRSXEP[E]WMREGSRZIRMIRXSVHIVERH
MXHMWTPE]IHJYPP[MRHS[GETXMSRW[LMGLQEHIMXLEVHXSVIEH
8LMWZIVWMSRSJ7502EZMKEXSVTVSZMHIWEWSPYXMSRJSVXLMWTVSFPIQMRXLI
JSVQSJE8EWO&EVXLEXMWVITVIWIRXIHEWEHSGOIHSVJPSEXMRKXSSPFEV[MXL
H]REQMGGSRXIRXW
7MQMPEVXSXLI;MRHS[W8EWO&EV[LMGLPMWXWEPPEGXMZIETTPMGEXMSRWXLI750
2EZMKEXSV8EWO&EVPMWXWEPPEGXMZI[MRHS[WEWXSSPFEVFYXXSRWIEGL[MXLE
[MRHS[MGSRERHXMXPI'PMGOMRKEFYXXSREGXMZEXIWXLIETTVSTVMEXI[MRHS[
FVMRKMRKMXXSXLIJSVIKVSYRHERHKMZMRKMXJSGYW



Quick detail view of any object


-XMWIEW]XSHMWTPE]JYPPHIXEMPWSJERSFNIGXGYVVIRXP]STIRMRERIHMXSVSVPMWXIH
MRXLIWIEVGLVIWYPXWSVXLI[SVOWTEGI'LSSWMRKXLI0SGEXIJYRGXMSRSRXLI
QEMRQIRYSVXLIWLSVXGYXQIRY[MPPSTIRXLI(&2EZMKEXSV[MRHS[
EYXSQEXMGEPP]I\TERHXVIIRSHIWEWRIGIWWEV]ERHHMWTPE]XLIHIXEMPWSJXLI
GYVVIRXSFNIGX-RXLI(&2EZMKEXSVXLI4VSTIVXMIWGSQQERHEPWSTIVJSVQWER
IUYMZEPIRXJYRGXMSR

62

SQL Navigator Users Guide

Invoking the Properties display from the DB Navigator shortcut


menu



Chapter 2

Whats new in this version?

63

The Properties display



64

SQL Navigator Users Guide

AutoDescribe feature
8LI(IWGVMFIXSSPGERRS[FIYWIHRSXSRP]SRXEFPIWMRHI\IWGPYWXIVWERH
SFNIGXWFYXEPWSSRTVSGIHYVIWJYRGXMSRWERHTEGOEKIW8LI(IWGVMFIXSSP
PMWXWETEGOEKI
WIRXV]TSMRXWERHXLIEVKYQIRXWSJETVSGIHYVISVJYRGXMSR
=SYGERYWIIMXLIVXLI(IWGVMFIGSQQERHSVXLI%YXS(IWGVMFIJIEXYVIXS
HIWGVMFIERSFNIGXHMWTPE]IHMRXLI(&2EZMKEXSV[MRHS[

;MXLXLI%YXS(IWGVMFIJIEXYVIIREFPIH]SY[MPPEYXSQEXMGEPP]WIIE
HIWGVMTXMSRSJXLIWIPIGXIHSFNIGX%PXIVREXMZIP]]SYGERGPMGOXLI(IWGVMFI
GSQQERHSRXLI3FNIGXQIRY[LIRIZIVRIIHIH



Chapter 2

Whats new in this version?

65

Automatic Source Preview


%RI[JIEXYVI7SYVGI4VIZMI[PIXW]SYTVIZMI[XLIWSYVGIGSHISJXI\XSFNIGXW
SVETEGOEKI
WMRHMZMHYEPIRXV]TSMRXW

Previewing an objects source code from the DB Navigator



66

SQL Navigator Users Guide

To preview the source code of text objects


1

2
3

7IPIGXXLISFNIGXMRXLI(&2EZMKEXSVXLI*MRH3FNIGXWHMEPSKVIWYPXWXLI
'SHI7IEVGLHMEPSKVIWYPXWSVXLI;SVOWTEGI=SYGEREPWSGPMGOERSFNIGX
REQIMRXLI7XSVIH4VSKVEQSV750)HMXSV
*VSQXLI:MI[QIRYGLSSWI7SYVGI4VIZMI[
;LIRXLI7SYVGI4VIZMI[[MRHS[MWSTIR]SYGERWIPIGXSFNIGXWMRER]SJ
XLI[MRHS[WREQIHEFSZIERHXLISFNIGX
WWSYVGIGSHI[MPPEYXSQEXMGEPP]
ETTIEVMRXLI7SYVGI4VIZMI[[MRHS[

Easier switching between sessions


;LIR]SYSTIRERSFNIGXMXEYXSQEXMGEPP]STIRWMRXLIETTVSTVMEXIHEXEFEWI
WIWWMSR
;LIRYWMRKXLI750)HMXSV]SYGERJVIIP]W[MXGLXSSXLIVWIWWMSRWERH
GSRXMRYI[SVOMRK[MXLMRXLIWEQI[MRHS[[MXLXLIWEQIWGVMTX8LMWJIEXYVI
IREFPIW]SYXSVYRXLIWEQIWGVMTXEKEMRWXHMJJIVIRXHEXEFEWIW[MXLSYXXLIRIIH
XSGST]MXMRXSERSXLIVMRWXERGISJ750)HMXSV-XEPWSEPPS[W]SYXSUYMGOP]
GSVVIGXXLISZIVWMKLXSJSTIRMRKEJMPIMRXSXLI[VSRKWIWWMSR

Choosing from the list of current sessions



Chapter 2

Whats new in this version?

67

Speedy selection of database objects


8LMWZIVWMSRSJ7502EZMKEXSVQEOIWMXJEWXIVERHIEWMIVXSWIPIGXHEXEFEWI
SFNIGXWXS[SVOSR
%RI[7IPIGX(&3FNIGXHMEPSKWMQMPEVXSXLIWXERHEVH;MRHS[W*MPI"3TIR
HMEPSKVITPEGIWXLISPHWGLIQESFNIGXREQIGSQFSFS\IWXLEX[IVIMRXLI
ZMWYEPSFNIGXIHMXSVW-XMWRSPSRKIVRIGIWWEV]XSFVS[WIXLIWGLIQESFNIGXPMWXW
MJXLIS[RIVERHSVSFNIGXREQIEVIORS[R
8SJMRHERHSTIREHEXEFEWISFNIGX]SYIRXIVXLIREQISJXLISFNIGXSVX]TI
MREREQIQEWOYWMRKXLI750[MPHGEVH  WTIGMJ]XLISFNIGXX]TI STXMSREP 
ERHXLIRWIPIGXXLISFNIGXJVSQEPMWXSJQEXGLIW
=SYGERIZIRJMPXIVXLIPMWXWSJWGLIQEWERHSVSFNIGXWMREWGLIQEF]GIVXEMR
GVMXIVMEWYGLEWREQIXIQTPEXI

Click Open DB Object



68

SQL Navigator Users Guide

to open the Select DB Object dialog



Chapter 2

Whats new in this version?

69

Job Manager
7502EZMKEXSVYWIVWGERIEWMP]EGGIWWXLI3VEGPI(&17.3&7WGLIHYPIVXS
GLIGOXLIWXEXYWERHWIXXMRKWSJI\MWXMRKNSFWERHEHHIHMXERHVIQSZINSFW
-X
WEZEMPEFPIJVSQXLI8SSPWQIRY

Easier database browsing


7502EZMKEXSV
WTSTYPEV(&2EZMKEXSVXSSPMWIZIRQSVITS[IVJYPERHIEWMIV
XSYWIXLERFIJSVI

Oracle 8i objects
(&2EZMKEXSVHMWTPE]WEPPX]TIWSJ3VEGPIERHMSFNIGXW

Windows Explorer-style display


(&2EZMKEXSVLEWER)\TPSVIVWX]PI[MRHS[[MXLX[SVIWM^EFPITERIW
8LIPIJXTERIHMWTPE]WXLIXVIIWXVYGXYVIERHXLIVMKLXTERIHMWTPE]WHIXEMPW
EFSYXXLIWIPIGXIHRSHI'PMGOERSFNIGXMRXLIXVIIXSZMI[MXWTVSTIVXMIW
=SYGERLMHIXLIVMKLXTERIXSWEZIWGVIIRWTEGISVMRGVIEWIXLIWTIIHSJXLI
HMWTPE]

Additional nodes
8LIMQTVSZIH(&2EZMKEXSVXVIIZMI[RS[MRGPYHIWRSHIWJSV1]7GLIQE
3XLIV7GLIQEWERH'YVVIRX-RWXERGI

Less duplication
)EGLSFNIGXMWTVIWIRXIHMRXLIXVII[MXLJYPPHIXEMPWSRP]SRGI
6IJIVIRGIWXSERSHIJVSQSXLIVRSHIWFILEZIEWL]TIVPMROWVEXLIVXLER
HYTPMGEXMRKEPPVIPIZERXMRJSVQEXMSR8SNYQTXSXLIRSHIXLEXVITVIWIRXWXLI
JYPPHIJMRMXMSRSJERSFNIGX]SYGERYWIXLI0SGEXIMR7GLIQEGSQQERH

70

SQL Navigator Users Guide



Display and selection options


8LIPMWXSJSFNIGXWMRXLIVMKLXTERIMWHMWTPE]IH[LIRXLIWIPIGXIHRSHIMRXLI
XVIIMWEGSRXEMRIVSJSFNIGXW WYGLEWXLI8EFPIWRSHIYRHIVEWGLIQE ERHMX
LEWFIIRI\TERHIH
8LIPMWXGERFIHMWTPE]IHEWEWMQTPIPMWXSJREQIWSVEHIXEMPIHQYPXMGSPYQR
VITSVXWLS[MRKEPPORS[RTVSTIVXMIWSJXLISFNIGXW
8LMWPMWXEPPS[WJSVWIPIGXMSRSJQYPXMTPISFNIGXWJSVFEXGLSTIVEXMSRWPMOI(VST
)\XVEGX((0SV'SQTMPI

Chapter 2

Whats new in this version?

71

Comprehensive online Help with enhanced navigation


aids
=SYLEZIERYQFIVSJSTXMSRWJSVUYMGOP]JMRHMRKXLIMRJSVQEXMSR]SYRIIH
JVSQXLI7502EZMKEXSVSRPMRILIPTW]WXIQ
 'SRXI\XWIRWMXMZILIPTJSVE[MRHS[SVHMEPSK
 +IRIVEPERH,S[8SMRJSVQEXMSR
 /I][SVHMRHI\ERHJYPPXI\XWIEVGLMRK
 7II%PWSFYXXSRJSVGPSWIP]VIPEXIHXSTMGW
 'SQQERHPSGEXSV

72

SQL Navigator Users Guide

Editing Enhancements
All-in-one SQL Editor
-RXLMWZIVWMSRSJ7502EZMKEXSVXLIJSVQIV7MRKPI750)HMXSVERH750
7GVMTX)HMXSVEVIGSQFMRIHMRXSSRIKVIEXIHMXMRKXSSPXLI750)HMXSV


8LI750)HMXSVMRGPYHIWXLIJSPPS[MRKRI[JIEXYVIW
 &EGOKVSYRHI\IGYXMSRSJWGVMTXW
 7MRKPIVIGSVH ZIVXMGEP ZMI[SJVIWYPXW
 3TXMSRXSVIGEPPTVIZMSYWP]VYR750WXEXIQIRXW
 7YTTSVXJSV750 4PYWGSQQERHW '322)'8(-7'322)'8
()7'6-&))<)'98)6)1%6/ 
 (SXPSSOYT
 ,]TIVPMROMRK

Chapter 2

Whats new in this version?











73

%YXSQEXMGOI][SVHGETMXEPM^EXMSR TVIJIVIRGIWIXXMRK 
%YXSQEXMGMRHIRXEXMSR
3TXMSRXSFVS[WIQYPXMTPIVIWYPXWIXW
4VIJIVIRGIJSVQYPXMTEKISVGSQFMRIHZMI[SJVIWYPXW
:MWYEPMRHMGEXMSRSJIEGLWXEXIQIRX
WWXEXYWYWMRKWTIGMEPW]QFSPWMRXLI
KYXXIVEPSRKWMHIXLIWXEXIQIRX
%FMPMX]XSWSVXUYIV]VIWYPXWF]ER]GSPYQRMREWGIRHMRKSVHIWGIRHMRK
SVHIV[MXLSYXVIVYRRMRKXLIUYIV]
4STYTGEPIRHEVJSVIHMXMRKHEXIJMIPHW
3FNIGXZMI[IVERH03&ZMI[IV
7YTTSVXJSVFMRHZEVMEFPIW

Improved PL/SQL Editor for stored programs with


powerful new Code Explorer
8LMWZIVWMSRSJ7502EZMKEXSVKMZIW]SYETS[IVJYPRI[7XSVIH4VSKVEQ
)HMXSV[MXLXLIWIGSRZIRMIRXJIEXYVIW
 7QEVXGSHIGSQTPIXMSR
 'SHI)\TPSVIVH]REQMGTEVWIVJSVMQQIHMEXIW]RXE\GLIGOMRK
 .EZEWSYVGIGSHILERHPMRK
 GYWXSQM^EFPIW]RXE\LMKLPMKLXMRKJSVFSXL40750ERH.EZE
 H]REQMGLMKLPMKLXMRKSJQEXGLMRKTEMVWSJFVEGOIXW
 H]REQMGLMKLPMKLXMRKSJXLIGPSWIWXIRGSQTEWWMRKFPSGO
 SRIOI]W[MXGLMRKFIX[IIRMQTPIQIRXEXMSRERHWTIGMJMGEXMSRSJETEGOEKIH
TVSGIHYVI
 GSRXI\XWIRWMXMZIXSSPXMTHIWGVMTXMSRJSVMHIRXMJMIVW
 H]REQMGLMKLPMKLXMRKSJSFNIGXREQIW L]TIVPMROW YRHIVXLIQSYWITSMRXIV
ERHWMRKPIGPMGOREZMKEXMSRXSXLISFNIGXHIJMRMXMSR
 (SXPSSOYTJSVVIGSVHQIQFIVW

74

SQL Navigator Users Guide


8LI7XSVIH4VSKVEQ)HMXSV[LMGL]SYYWIXSIHMX40750ERHSXLIVTVSKVEQ
GSHIMRGPYHIWE'SHI)\TPSVIVXSSPXLEXLIPTWQEOI]SYV[SVO[MXL
TEGOEKIWTVSGIHYVIWERHJYRGXMSRWQSVIIJJMGMIRXERHIVVSVJVII
8LI'SHI)\TPSVIVMWFEWIHSREREHZERGIHTEVWMRKXIGLRMUYIXLEX
YRHIVWXERHW40750W]RXE\-XHMWTPE]WHIXEMPIHMRJSVQEXMSREFSYXETEGOEKI
W
GSQTSRIRXWWYGLEWZEVMEFPIWERHTEVEQIXIVWXLIMVX]TIWERHWXVYGXYVI
'SHI)\TPSVIVGSQFMRIWMRJSVQEXMSRJVSQXLIWTIGMJMGEXMSRERHFSH]
LMKLPMKLXWW]RXE\ERHHMWXMRKYMWLIWRSRTYFPMWLIHTVSGIHYVIWERHJYRGXMSRW
[MXLEHMJJIVIRXMGSR
'SHI)\TPSVIVZMWYEPP]QEVOWTVSGIHYVIWMRWMHIETEGOEKIXLEXGSRXEMRW]RXE\
IVVSVW

Chapter 2

Whats new in this version?

75

Automatic Code Completion


7QEVXGSHIGSQTPIXMSREYXSQEXMGEPP]HMWTPE]WEDTMGO
PMWXSJQEXGLMRKW]QFSPW
ZEVMEFPIWTEVEQIXIVWTVSGIHYVIWX]TIW MRXLIGYVVIRXWGSTI[LIR]SYWXEVX
X]TMRKMRERMHIRXMJMIV
-RXLII\EQTPIFIPS[XLIYWIVX]TIWeJSPPS[MRKXLIBEGINWXEXIQIRXERH
XLIR7502EZMKEXSVHMWTPE]WEPMWXSJQEXGLMRKTVSGIHYVIREQIW



Dot-lookup for record members


(SXPSSOYTEYXSQEXMGEPP]HMWTPE]WEDTMGO
PMWXSJQIQFIVWSJE40750
VIGSVHGYVWSVTEGOEKISV63;8=4)VIGSVH[LIR]SYX]TIEHSXGLEVEGXIV
EJXIVEREQISJZEVMEFPI
-RXLII\EQTPIFIPS[XLIYWIVX]TIWemp.ERHXLIR7502EZMKEXSVHMWTPE]WE
PMWXSJQEXGLMRKQIQFIVW




76

SQL Navigator Users Guide

Begin/End markers for loops and blocks


;LIR]SYTPEGIXLIGYVWSVMRWMHIE&)+-2)2(-*)2(-*SV
0334)2(0334FPSGOXLI7502EZMKEXSVGSHIIHMXSVWWLS[]SYXLIFIKMR
ERHIRHTSMRXWF]QIERWSJDKP]TLW
 QEVOIVW MRXLIDKYXXIV
 PIJXQEVKMR 



%RYQFIVSJSXLIVKYXXIVQEVOIVWEVIYWIHEW[IPP
%

& ' ( ) * + , -

.

/


%
&
'
(
)
*
+
,
-
.
/

FSSOQEVOW  
IREFPIHFVIEOTSMRX
HMWEFPIHFVIEOTSMRX
GYVVIRXI\IGYXMSRPMRI
MRZEPMHFVIEOTSMRX
IVVSVPMRI WXEXIQIRXXLEX[EWI\IGYXIH[MXLIVVSVW 
7)0)'8WXEXIQIRXXLEXTVSHYGIHVIWYPXW
RSR7)0)'8WXEXIQIRXXLEX[EWI\IGYXIHWYGGIWWJYPP]
[EVRMRKPMRI WXEXIQIRXXLEX[EWI\IGYXIH[MXL[EVRMRKW 
FPSGOFIKMR
FPSGOIRH

Chapter 2

Whats new in this version?

77

Hyperlinking in the Stored Program editor


-RXLI7XSVIH4VSKVEQIHMXSVMJ]SY[ERXXSQSZIXLIXI\XGYVWSVXSXLI
HIGPEVEXMSRSJEZEVMEFPI SV%YXS(IWGVMFIMXMJMX
WXLIREQISJERI\XIVREP
HEXEFEWI NYWXTVIWW'XVPERHTSMRXXSXLIZEVMFEPI[MXLXLIQSYWI8SVIXYVR
XSXLIJSVQIVTSWMXMSRMRXLIXI\XTVIWW'XVP&EGOWTEGI

Pointing to the variable while pressing Ctrl moves the cursor to


the declaration


8SWIIEHIWGVMTXMSRSJER]SFNIGXJVSQ[MXLMRXLI7XSVIH4VSKVEQ)HMXSV]SY
GERWMQTP]GPMGOXLISFNIGX
WREQI[LMPILSPHMRKHS[RXLI'XVPOI]8LMW[MPP
STIRER%YXS(IWGVMFI[MRHS[JSVXLEXSFNIGX
-REHHMXMSRMJXLIVIJIVIRGIHSFNIGXMWEXI\XSFNIGX ZMI[TVSGIHYVIJYRGXMSR
TEGOEKISVTEGOEKIHTVSGIHYVIJYRGXMSR ERHXLI7SYVGI4VIZMI[[MRHS[MW
STIRXLIRXLISFNIGX
WWSYVGIMWEYXSQEXMGEPP]TVIZMI[IH

78

SQL Navigator Users Guide

Pointing to the object name while pressing Ctrl opens the


AutoDescribe window



Chapter 2

Whats new in this version?

79

Easy switching between specification and body


;LIRIHMXMRKETEGOEKIHTVSGIHYVI]SYGERYWI'XVP7LMJXTPYWXLIHS[RSV
YTEVVS[XSQSZIXLIGYVWSVFIX[IIRXLIWTIGMJMGEXMSRERHXLIFSH]



80

SQL Navigator Users Guide

Improved syntax highlighting


8LI7XSVIH4VSKVEQ)HMXSVYWIWHMJJIVIRXGSPSVWXSLMKLPMKLX40750W]RXE\
IPIQIRXW[MXLMRETVSKVEQ
;LIR]SYWIXXLIGYVWSVEXEFVEGOIX[MXLMRERI\TVIWWMSRXLIQEXGLMRK
FVEGOIXMWEYXSQEXMGEPP]LMKLPMKLXIH
;LIR]SYTPEGIXLIGYVWSVMRSVEFPSGOTVSGIHYVIPSSTSV-*WXEXIQIRX]SY
[MPPWIIEVVS[WMRXLIKYXXIV XSXLIPIJXSJXLIGSHIPMWXMRK XLEXQEVOXLI
FIKMRRMRKERHIRHSJXLIFPSGO


%RYQFIVSJSXLIVQEVOIVWEVIYWIHEW[IPP
=SYGERWTIGMJ]XLIFILEZMSVSJXLIWIJIEXYVIWMR4VIJIVIRGIWHMEPSKW

Integrated PL/SQL Profiler (Oracle 8.1.5+)


8LI407504VSJMPIVGSZIVEKIXSSPMWRS[QSVIXMKLXP]MRXIKVEXIHMRXSXLI
ETTPMGEXMSR

Chapter 2

Whats new in this version?

81

 =SYGEREGGIWWXLI0SGEXI3FNIGXMR(&2EZMKEXSVERH3TIRGSQQERHW
[LIREWXSVIHTVSKVEQMWWIPIGXIHMRXLI4VSJMPIV
W6YRWSV+VSYTWXVII
 =SYGERSTIRXLI7XSVIH4VSKVEQ)HMXSVERHNYQTXSEWIPIGXIHPMRISJ
WSYVGIGSHIF]HSYFPIGPMGOMRKMRXLI7SYVGI:MI[IV
 7GVSPPMRK QSZMRKXLIGYVWSVTSWMXMSR MRXLI7XSVIH4VSKVEQ)HMXSVWIPIGXW
XLIGSVVIWTSRHMRKPMRIMRXLITVSJMPIV7SYVGI:MI[IV
 8LIWIVZIVSYXTYXMWEYXSQEXMGEPP]VIXVMIZIHEJXIVXLIVYR
 7IWWMSRWXEXMWXMGWGERFIHMWTPE]IHSRXLIWYQQEV]TEKI[LIREVYRMW
WIPIGXIH
 8LI4VSJMPIVYWIWXLI3VEGPIWIWWMSRMX[EWEGXMZEXIHMR 4VIZMSYWP]MXYWIH
MXWS[RWIWWMSR 

You can launch the Profiler from the Tools menu or the
Functions toolbar



82

SQL Navigator Users Guide

Viewing an open object in the DB Navigator


;LIREWXSVIHTVSKVEQMWWIPIGXIHMRXLI4VSJMPIV
W6YRWSV+VSYTWXVII]SY
GERYWIXLI0SGEXIMR(&2EZMKEXSVERH3TIRGSQQERHWXSNYQTXSXLI
PSGEXMSRSJXLISFNIGXMRXLI(&2EZMKEXSVXVII

Using the Locate in DB Navigator command

Chapter 2

Whats new in this version?

83

Result of the Locate in DB Navigator command

84

SQL Navigator Users Guide

Using the Profiler with the Stored Program editor


=SYGERSTIRXLI7XSVIH4VSKVEQ)HMXSVERHNYQTXSEWIPIGXIHPMRISJWSYVGI
GSHIF]HSYFPIGPMGOMRKMRXLI7SYVGI:MI[IV
7GVSPPMRK QSZMRKXLIGYVWSVTSWMXMSR MRXLI7XSVIH4VSKVEQ)HMXSVWIPIGXWXLI
GSVVIWTSRHMRKPMRIMRXLITVSJMPIV7SYVGI:MI[IV


Browsing and editing table data


=SYGERWIPIGXEXEFPIERHXLIRIEWMP]FVS[WISVIHMXXEFPIHEXE
8SSTIRXLI5YIV]&YMPHIVERHGVIEXIHVEKERHHVST750WXEXIQIRXWWIPIGX
XLIXEFPIERHGLSSWI&VS[WI(EXE
8SSTIRXLI750)HMXSVWSXLEX]SYGERGVIEXIERHVYREUYIV]ERHZMI[SV
IHMXXEFPIHEXEMREVIWYPXWKVMHWIPIGXXLIXEFPIERHGLSSWI5YMGO&VS[WISV
)HMX(EXE 8LI)HMX(EXEGSQQERHI\IGYXIWERYTHEXIEFPIUYIV] 

Chapter 2

Whats new in this version?

85

The Browse Data command opens a Query Builder window

86

SQL Navigator Users Guide

The Quick Browse and Edit Data commands open the SQL Editor



Chapter 2

Whats new in this version?

87

Source Code Search enhancements


=SYGERPEYRGLEWSYVGIGSHIWIEVGLJVSQXLI7IEVGLQIRY


6MKLXGPMGOSREVIWYPXXSYWIXLIWLSVXGYXQIRYSTXMSRW=SYGEREPWSHVEK
VIWYPXWSJ7SYVGI'SHIWIEVGLIWXSXLI;SVOWTEGIEWFSSOQEVOWSVMRXS
IHMXMRK[MRHS[W=SYGERTVIZMI[XLIWSYVGIF]STIRMRKXLI7SYVGI4VIZMI[
[MRHS[ERHXLIRWIPIGXMRKVS[WMRXLIWIEVGLVIWYPXW

Extract DDL enhancements


;LIRKIRIVEXMRK((0XLMWZIVWMSRSJ7502EZMKEXSVIRGPSWIWRSR
EPTLERYQIVMGERHQM\IHGEWISFNIGXREQIWMRWMHIHSYFPIUYSXIWVEXLIVXLER
KIRIVEXMRKIVVSVEWTVIZMSYWP]
=SYGERWIPIGXXLIGEWIJSVXLI750OI][SVHWMR((0YTTIVPS[IVSVMRMXMEP
GETMXEPW
8LI)\XVEGX((0JYRGXMSRMRGPYHIWTEVXMXMSRMRJSVQEXMSR[LIRKIRIVEXMRKE
WGVMTX
)\XVEGX((0VYRWEWEFEGOKVSYRHXEWO=SYGERWIPIGXQYPXMTPISFNIGXWWXEVX
ERI\XVEGX((0XEWOERHOIITSR[SVOMRK[LMPIMXVYRW


88

SQL Navigator Users Guide

Shortcut menu options for code search results



Chapter 2

Whats new in this version?

89

Debugger enhancements
Debugger enhancements
-RXLI40750(IFYKKIVXLI)\IGYXMSR7XEXYW[MRHS[MWRS[HSGOEFPI8S
QEOIXLI[MRHS[HSGOEFPIWIPIGXXLI(SGOEFPISTXMSRJVSQXLIWLSVXGYX
QIRY
8LISTXMSRXSKIRIVEXIHIFYKMRJSVQEXMSR[LIRWEZMRKSVGSQTMPMRKWXSVIH
SFNIGXWMWRS[WIXMRHMZMHYEPP]JSVIEGLHEXEFEWIERHMWTIVWMWXIRXEGVSWW
WIWWMSRW
-RXLI7XSVIH4VSKVEQ)HMXSV]SYGERWIXSVGLERKIEFVIEOTSMRXF]GPMGOMRK
XLIKYXXIVXSXLIPIJXSJXLIFVIEOTSMRXPMRI

Context-sensitive tooltip description for identifiers


8LI8VMKKIV)HMXSVRS[TVSZMHIW8SSPXMT)ZEPYEXMSR[LMPIHIFYKKMRK




Multi-paged Output window


8LI3YXTYX[MRHS[HMWTPE]WXLIVIWYPXWSJTVSKVEQGSQTMPEXMSRERH
I\IGYXMSRMRGPYHMRKER]IVVSVW

90

SQL Navigator Users Guide

8LI3YXTYX[MRHS[LEWXEFFIHTEKIWJSVSYXTYXJVSQHMJJIVIRXWIWWMSRWTPYW
SRITEKIJSVKIRIVEPQIWWEKIWRSXVIPEXIHXSETEVXMGYPEVWIWWMSR


8LI3YXTYX[MRHS[GERFIQEHIHSGOEFPIIMXLIVF]ETVIJIVIRGIWIXXMRKSV
F]QIERWSJEWLSVXGYXQIRYSTXMSR;LIRHSGOEFPIXLI[MRHS[MWEP[E]W
ZMWMFPIXLEXMWEP[E]WSRXST
3YXTYXPMRIWSJHMJJIVIRXX]TIW MRJSVQEXMSRIVVSVWWIVZIVSYXTYX EVI
HMWXMRKYMWLIHF]HMJJIVIRXJSRXGSPSVWERHRS[XLI]EVIEPWSQEVOIH[MXL
HMJJIVIRXKP]TLW W]QFSPW 
=SYGERGPMGOSRER3VEGPIIVVSVPMRIMRXLISYXTYX[MRHS[XSZMI[XLI3VEGPI
)VVSV(IWGVMTXMSRXI\XJSVXLEXIVVSV
=SYGERWIRH3YXTYX[MRHS[GSRXIRXWXSXLITVMRXIVYWMRK'XVP4

Execution code generation enhancements


%RI[)\IGYXMSR'SHI[M^EVH[LMGLLIPTW]SYTPEGI40750GSHIFPSGOW
MRXS]SYV750WGVMTXWVITPEGIWXLIJSVQIV'EPPMRK'SHI+IRIVEXMSR[M^EVH-X
LEWERI[[MRHS[ERHMWRSPSRKIVQSHEP8LI)\IGYXMSR'SHI[M^EVH
JIEXYVIWW]RXE\LMKLPMKLXMRKERH[SVOW[MXL6)*'96736ZEVMEFPIW03&W
ERHSXLIVRI[3VEGPIHEXEX]TIW'03&&03&ERH&*-0)EVKYQIRXWEVI
WYTTSVXIH EWEVI3FNIGXERH'SPPIGXMSR8]TIW MJ]SYYWIFMRHZEVMEFPIWJSV
XLISYXTYX

Chapter 2

Whats new in this version?

91

Step 1run the procedure

92

SQL Navigator Users Guide

Step 2select profiling options



Chapter 2

Whats new in this version?

93

Step 3set options for variables, parameters, and


COMMIT/ROLLBACK



94

SQL Navigator Users Guide

Step 4(optional) monitor profiling results

New and improved development tools


Formatter Plus and Knowledge Xpert
7502EZMKEXSVWYTTSVXWMRXIKVEXMSR[MXLXLIPEXIWXZIVWMSRWSJ/RS[PIHKI
<TIVX JSVQIVP]6IZIEP2IX XSSPW/RS[PIHKI<TIVXJSV%GXMZI40750
(IZIPSTQIRX/RS[PIHKI<TIVXJSV3VEGPI%HQMRMWXVEXMSRERH*SVQEXXIV
4PYW8LIGYVVIRXZIVWMSRSJ*SVQEXXIV4PYWMWWLMTTIH[MXL7502EZMKEXSVERH
MRWXEPPIHEYXSQEXMGEPP]MRXLIWEQI[SVOMRKJSPHIV2SXIXLEXXSYWIXLI
*SVQEXXIV4PYWWYTTPMIH[MXL7502EZMKEXSV]SYRIIHMXXSFIIREFPIHMR]SYV
PMGIRWIOI]

Chapter 2

Whats new in this version?

95

Describe tool enhancements


8LI(IWGVMFIGSQQERH[SVOWQYGLJEWXIVXLERMRZIVWMSR
8LI(IWGVMFIXSSPGERRS[FIYWIHRSXSRP]SRXEFPIWMRHI\IWGPYWXIVWERH
SFNIGXWFYXEPWSSRTVSGIHYVIWJYRGXMSRWERHTEGOEKIW8LI(IWGVMFIXSSP
PMWXWETEGOEKI
WIRXV]TSMRXWERHXLIEVKYQIRXWSJETVSGIHYVISVJYRGXMSR
=SYGERYWIIMXLIVXLI(IWGVMFIGSQQERHSVXLI%YXS(IWGVMFIJIEXYVIXS
(IWGVMFIERSFNIGXHMWTPE]IHMRXLI(&2EZMKEXSV[MRHS[8LI%YXS(IWGVMFI
[MRHS[GERVIQEMRSTIR[LMPI]SYWIPIGXHMJJIVIRXSFNIGXWJSVZMI[MRK

Selecting AutoDescribe for a table



96

SQL Navigator Users Guide

The AutoDescribe window

=SYGERSTIRSRIHSGOEFPI%YXS(IWGVMFI[MRHS[ERHSRISVQSVIRSR
HSGOEFPI(IWGVMFI[MRHS[WMRXLIETTPMGEXMSR[SVOEVIE
;MXLXLI%YXS(IWGVMFIJIEXYVIIREFPIH]SY[MPPEYXSQEXMGEPP]WIIE
HIWGVMTXMSRSJER]WIPIGXIHSFNIGX%PXIVREXMZIP]]SYGERQERYEPP]MRZSOIXLI
(IWGVMFIGSQQERH[LIRIZIVRIIHIH

Chapter 2

Whats new in this version?

97

Easier viewing of data in database objects


8SZMI[ZEPYIWSJEXXVMFYXIWVIXYVRIHJVSQEUYIV]MRGPYHMRKRIWXIH
EXXVMFYXIWSJYWIVHIJMRIHX]TIW03&WERH6)*W]SYNYWXHSYFPIGPMGOEGIPP
MRXLIVIWYPXWKVMHSVGPMGOXLIIPPMTWMW HVMPPHS[R FYXXSRSRXLIVMKLXWMHISJ
XLIGIPP



SQL Navigator does not support working with
LOB or Object table columns when using an
Oracle 7 client connected to Oracle 8 database.
For full functionality, use an Oracle 8 client to
connect to an Oracle 8 database.

Support for LOBs (large objects)


*SVZMI[MRKPSRKFMREV]SFNIGXHEXE]SYGERPEYRGLXLI03&ZMI[IVJVSQXLI
750)HMXSVSVXLI)\IGYXMSR'SHI[M^EVH'03&&03&ERH&*-0)
EVKYQIRXWEVIWYTTSVXIH EWEVI3FNIGXERH'SPPIGXMSR8]TIW MJ]SYYWIFMRH
ZEVMEFPIWJSVXLISYXTYX
=SYGER[SVO[MXLXLIJSPPS[MRK3VEGPIM03&HEXEX]TIW
Type




View

Edit

&03&

=

2

'03&

=

=

&*-0)

=

2

2'03&

=

2

98

SQL Navigator Users Guide

Object Data Viewer


8LMWZIVWMSRSJ7502EZMKEXSVMRGPYHIWER3FNIGXZMI[IVXLEXTVSZMHIWE
KVETLMGEPZMI[SJ3VEGPISFNIGXWMRXEFPIGSPYQRW
=SYGERPEYRGLXLI3FNIGX:MI[IVMRXLVII[E]W
 F]FVS[WMRKEXEFPIGSRXEMRMRKSFNIGXGSPPIGXMSRSVVIJIVIRGIGSPYQRW
 F]I\IGYXMRKEUYIV]MRXLI750)HMXSVXLEXVIXYVRWSFNIGXGSPPIGXMSRSV
VIJIVIRGIGSPYQRW
 F]I\IGYXMRKEWXSVIHTVSGIHYVIXLEXVIXYVRWSFNIGXGSPPIGXMSRSVVIJIVIRGI
GSPYQRW

Viewing a binary object in the BLOB viewer



Chapter 2

Whats new in this version?

99

Viewing character data in the CLOB viewer



100

SQL Navigator Users Guide

Support for Oracle 8 partitioned tables and indexes


8LI(&2EZMKEXSVWYTTSVXW3VEGPITEVXMXMSRIHXEFPIWERHMRHI\IW4EVXMXMSRW
EVIHMWTPE]IHYRHIVGSVVIWTSRHMRKTEVXMXMSRIHXEFPIWSVMRHI\IW8LI)\XVEGX
((0JYRGXMSRMRGPYHIWTEVXMXMSRMRJSVQEXMSR[LIRKIRIVEXMRKEWGVMTX



Chapter 2

Whats new in this version?

101

New and enhanced Visual Object Editors


7502EZMKEXSV
WZMWYEPSFNIGXIHMXSVWLEZIFIIRZMWYEPP]IRLERGIH
 %PPZMWYEPSFNIGXIHMXSVWJIEXYVIEWXERHEVHXSSPFEVEXXLIXSTSJXLI[MRHS[
ERHEWXEXYWPMRIEXXLIFSXXSQ
 &YXXSRWXLEXHYTPMGEXIHJYRGXMSRWEZEMPEFPIMRXLIQEMR7502EZMKEXSV
XSSPFEVLEZIFIIRVIQSZIH
 %ZEMPEFPIJYRGXMSRWERHGSQQERHWQE]ZEV]EGGSVHMRKXSXLI3VEGPI
ZIVWMSRFIMRKYWIH
 8LI3TIRSFNIGXHMEPSKRS[TVSZMHIWEQSWXVIGIRXP]YWIH 169 SFNIGX
PMWX
 8LIVIEVIRI[IHMXSVWJSV3FNIGX8]TIWERH4VSJMPIW

New edit functions


8LIVIEVIRI[IHMXSVWJSV3FNIGX8]TIWERH4VSJMPIW
:EVMSYWSFNIGXIHMXSVWLEZIFIIRKMZIRRI[JYRGXMSREPMX]JSVI\EQTPI
 XLI8EFPIERH-RHI\IHMXSVWRS[WYTTSVXEPPWXERHEVHHEXEX]TIWERHYWIV
HIJMRIHHEXEX]TIWMRGPYHMRK03&W 0EVKI3FNIGXW TEVXMXMSRWERHWYF
TEVXMXMSRWERHTVSZMHIXEFFIHTEKIWHMWTPE]MRKMRHI\IWGSRWXVEMRXWERH
HITIRHIRGMIW
 XLI6SPIIHMXSVHMWTPE]WKVERXIHVSPIWERHKVERXIHTVMZMPIKIWEXXLIWEQI
XMQI
 XLI:MI[IHMXSVLEWERI[8VMKKIVWXEFXLEXWLS[WXLIXVMKKIVWEXXEGLIHXS
XLIZMI[(SYFPIGPMGOMRKSREXVMKKIVREQISTIRWMXMRXLIXVMKKIVIHMXSV
 XLI9WIVIHMXSVERH6SPIIHMXSVEVIRS[WITEVEXI
%PPZMWYEPSFNIGXIHMXSVWEPPS[JSVIRXIVMRKRSREPTLERYQIVMGERHQM\IHGEWI
SFNIGXREQIW

User can set default schema for object editors


-RTVIZMSYWZIVWMSRWXLIHIJEYPXWGLIQEJSVEPPZMWYEPSFNIGXIHMXSVW[EWXLI
GYVVIRXYWIV
WWGLIQE8LMW[EWRSXEP[E]WGSRZIRMIRXTEVXMGYPEVP]MJXLIYWIV
JVIUYIRXP][SVOIH[MXLSXLIVYWIVW
WGLIQEW
8LMWZIVWMSRSJ7502EZMKEXSVLERHPIWXLMWHMJJIVIRXP]-RMXMEPP][LIRERI[
WIWWMSRMWWXEVXIHXLIGYVVIRXWGLIQEMWXLIYWIV
WS[RWGLIQE,S[IZIV]SY
GERGLERKIXSERSXLIVWGLIQEEXER]XMQIF]QIERWSJEHVSTHS[RPMWXSRXLI
3FNIGXXSSPFEV
8LIRI[WGLIQEMWXLIRYWIHEWXLIHIJEYPXWGLIQE[LIRSTIRMRKERSFNIGXJSV
IHMXMRKSVGVIEXMRKERI[SFNIGX

102

SQL Navigator Users Guide

Query Builder enhancements


8LMWZIVWMSRSJ7502EZMKEXSVMRGPYHIWERYQFIVSJMQTVSZIQIRXWXSXLI
5YIV]&YMPHIV,IVIEVIEJI[I\EQTPIW
 8LI5YIV]&YMPHIV[MRHS[MWRSPSRKIVQSHEP
 =SYGERHVEKSFNIGXWMRXSXLI5YIV]&YMPHIV[SVOWTEGIJVSQXLI(&
2EZMKEXSVXVIIJVSQXLI*MRH3FNIGXW[MRHS[SVJVSQXLI;SVOWTEGI
[MRHS[
 8LI%HH(&3FNIGXMRZSOIWXLIWXERHEVHSFNIGXWIPIGXMSR[MRHS[
 8LI%HH'SPYQRGSQQERHEPPS[WEHHMRKEVFMXVEV]GSPYQRI\TVIWWMSRW
 7LS['SPYQR8]TIWGSQQERHGSRXVSPWXLIHMWTPE]SJGSPYQRX]TI
MRJSVQEXMSRMRXLIXEFPIW
 %NSMRFIX[IIRGSPYQRWSJHMJJIVIRXX]TIWMWVITVIWIRXIH[MXLEHSXXIHPMRI
ERHNSMRPMRIWRS[HMWTPE]ELMRX

Code Assistant enhancements


=SYGERVISVHIVGST]ERHQSZIMXIQWMRXLI'SHI%WWMWXERXYWMRKHVEKERH
HVST
%YXSQEXMGWSVXMRKLEWFIIRVIQSZIHWSRS[]SYGERJVIIP]VIEVVERKIWRMTTIXW
ERHJSPHIVW

Launch the Code Assistant from the View menu



Chapter 2

Whats new in this version?

103

The Code Assistant



104

SQL Navigator Users Guide

Improved Team Coding facilities


8LIRI[8IEQ'SHMRKQSHYPIMRXLMWZIVWMSRSJ7502EZMKEXSVVITVIWIRXWE
GSQFMREXMSRSJXLIJYRGXMSREPMX]TVIZMSYWP]TVSZMHIHF]8IEQ4VSKVEQQMRK
ERH:'7MR:IVWMSR-XEHHVIWWIWZEVMSYWMWWYIWVEMWIHF]I\MWXMRKYWIVWSJ
XLITVIZMSYWJYRGXMSREPMX]TVSZMHIWEHHMXMSREPJPI\MFMPMX]ERHTIVQMXWXLI
TSWWMFMPMX]SJJYXYVIIRLERGIQIRXW[LMGL[IVIRSXTSWWMFPIMRXLITVIZMSYW
MQTPIQIRXEXMSR
,IVIEVIWSQILMKLPMKLXW*SVHIXEMPW]SYGERFVS[WIXLI:IVWMSR'SRXVSPERH
8IEQ'SHMRKXSTMGW
 8IEQ4VSKVEQQMRK GLIGOMRERHGLIGOSYX ERHZIVWMSRGSRXVSPJIEXYVIW
RS[STIVEXIMRGSRNYRGXMSR[MXLIEGLSXLIV
 8LIWMQTPI7GLIQE1ETTMRKQSHIPLEWFIIRVITPEGIHF]JPI\MFPI'SHI
'SRXVSP+VSYTW ''+W XLEXLIPT]SYGSRXVSPSFNIGXWJVSQSRISVQSVI
WGLIQEWYWMRKGYWXSQM^EFPIKVSYTMRKW
 =SYGERSVKERM^ISFNIGXWMRXS''+WF]YWMRK3FNIGX1EWOWVITVIWIRXMRK
FSXLWTIGMJMGHEXEFEWISFNIGXWERHGSPPIGXMSRWSJWMQMPEVSFNIGXW F]YWMRK
XLI3VEGPI[MPHGEVH =SYGEREPWSWIXYTI\GPYWMSRQEWOWXSI\GPYHI
WTIGMJMGSFNIGXWJVSQE''+
 )ZIR[MXLSYXEXLMVHTEVX]ZIVWMSRGSRXVSPTVSHYGX]SYGERYWI''+WWS
XLEXVIJIVIRGIHSFNIGXW[MPPFIXVEGOIHF]8IEQ'SHMRK XLSYKL[MXLSYX
VIZMWMSRLMWXSV] 
 7GVMTXWEVIRS[WYTTSVXIHMR:IVWMSR'SRXVSP
 %PPGSRJMKYVEXMSRHEXEMWRS[WXSVIHMRXLIHEXEFEWIYRHIV8IEQ'SHMRK
GSRXVSP-RHMZMHYEP[SVOWXEXMSRWHSRSXRIIHXSFIGSRJMKYVIH
 %QSVIJPI\MFPIWIGYVMX]QSHIPMWIQTPS]IHQEOMRKJYPPYWISJ3VEGPI
WIGYVMX]JIEXYVIW
 (IZIPSTIVWGERVIQETXLIMVWGLIQEWXSER]''+VIQSZMRKXLI
7502%:C%(1-2WYTIVYWIVFSXXPIRIGO
 8LI:IVWMSR'SRXVSP&VS[WIVRS[STIRWSFNIGXWMREZMWYEPSFNIGXIHMXSV
VEXLIVXLERMRXLI750)HMXSV

Chapter 2

Whats new in this version?

105

General and miscellaneous enhancements


Faster, more efficient execution
-RXLMWZIVWMSRSJ7502EZMKEXSV[ILEZIXEOIRERYQFIVSJQIEWYVIWXS
WXVIEQPMRIXLII\IGYXMSRSJFEWMGJYRGXMSRW3RISJXLIQSWXWMKRMJMGERXMWXLI
YWISJMRXIVREPGEGLIJSVEPPSTIVEXMSRWXLEXVIXVMIZIHEXEJVSQXLI3VEGPIHEXE
HMGXMSREV]8LMWWEZIWXMQIERHI\XVETVSGIWWMRKG]GPIW3XLIVIRKMRIIVMRK
MQTVSZIQIRXWMRGPYHIXLIJSPPS[MRK
 WLEVMRKHEXEFIX[IIRGSRRIGXMSRWXSXLIWEQIHEXEFEWIYWIVREQI
 YWMRKFMRHZEVMEFPIW[LIVIZIVTSWWMFPIMRWXIEHSJH]REQMGGSRWXVYGXMSRSJ
750MRMRXIVREPUYIVMIW
 VIHYGIHTSPPMRKSJXLIHEXEFEWIF]YWMRKFPSGOMRKQSHIGSQFMRIH[MXL
QYPXMXLVIEHIHI\IGYXMSRMRWXIEHSJRSRFPSGOMRKQSHIERHEWMRKPIXLVIEH
 ERMQTVSZIHQIXLSHSJWXSVMRKUYIV]VIWYPXWXLEXXEOIWSRIJMJXLEWQYGL
QIQSV]EWXLITVIZMSYWZIVWMSR
 PMQMXMRKXLIPSEHMRKSJSFNIGXPMWXWWYGLEWXLIPMWXSJWXSVIHTVSKVEQWMRXLI
7XSVIH4VSKVEQ)HMXSVXSMRWXERGIW[LIVIXLIYWIVI\TPMGMXP]VIUYIWXW
EGGIWWXSXLIPMWX

More complete Oracle 8/8i support


8LI(&2EZMKEXSVHMWTPE]WEPPX]TIWSJ3VEGPIERHMSFNIGXW

Multi-threaded task execution


1ER]PSRKVYRRMRKXEWOWEVIRS[I\IGYXIHMRWITEVEXIXLVIEHWMRXLI
FEGOKVSYRH8LIWIXEWOWMRGPYHI
 FEXGLGSQQERHWSRHEXEFEWISFNIGXWWYGLEW(VST'SQTMPISV)\XVEGX
((0
 WGVMTXI\IGYXMSRMR750)HMXSV
 JYPPI\TERWMSRSJERSHIMR(&2EZMKEXSV
 WSYVGIGSHIWIEVGL
 XLI*MRH3FNIGXWGSQQERH
&EGOKVSYRHI\IGYXMSRLETTIRWEYXSQEXMGEPP]ERHQIERWXLEXEPPXLI
ETTPMGEXMSR
WJYRGXMSREPMX]VIQEMRWEZEMPEFPIXSXLIYWIV[LMPIXLIXEWOMW
VYRRMRKMREWITEVEXIWIWWMSR
8LIVIEVI4EYWI6IWYQIERH7XSTFYXXSRWSRXLIXSSPFEVXLEXEPPS[]SYXS
MRXIVVYTXI\IGYXMSRSJEGYVVIRXXEWO%LMRXSRXLI7XSTFYXXSRH]REQMGEPP]
WLS[W[LMGLXEWOMWVYRRMRKERH MJETTPMGEFPI MXWGYVVIRXTVSKVIWW

106

SQL Navigator Users Guide

8LI8EWO1EREKIVHMWTPE]WEPPEGXMZIERHGSQTPIXIXEWOWERHIREFPIWJYPP
GSRXVSPSZIVXEWOW

More convenient Logon routine


8LI3VEGPI0SKSRHMEPSKRS[PIXW]SYWEZIETEWW[SVHJSVIEGL
YWIVREQIHEXEFEWIGSQFMREXMSR
=SYVTEWW[SVHMWWEZIHMRIRGV]TXIHJSVQEXERHXLIRVIGEPPIHEYXSQEXMGEPP]
[LIR]SYRI\XIRXIVXLIWEQIYWIVREQIHEXEFEWIGSQFMREXMSR
8LIYWIVREQIJMIPHEYXSQEXMGEPP]VIGEPPWYWIVREQITEWW[SVHWGSQFMREXMSRW
FEWIHSRXLIJMVWXPIXXIV W IRXIVIHMRXSXLIJMIPH

Improved date/time representation and handling


9RPMOITVIZMSYWZIVWMSRWXLMWZIVWMSRSJ7502EZMKEXSVHSIWRSXTIVJSVQ
WIVZIVWMHIGSRZIVWMSRSJHEXEMRXSXLIWXVMRKJSVQEX8LISRP]I\GITXMSRMRXLMW
ZIVWMSRMWJSVRYQIVMGJMIPHW[MXLQSVIXLERHMKMXW8LIWIEVIVIXVMIZIHERH
LERHPIHEWXI\XWXVMRKW
8LMWETTVSEGLLEWEPPS[IHYWXSMQTPIQIRXWSQIRI[JIEXYVIWWYGLEWETST
YTGEPIRHEVJSVHEXIIHMXMRKERHWSVXMRKF]ER]GSPYQRMR750)HMXSV
&VS[WI)HMX(EXE*MRH3FNIGXWERH(&2EZMKEXSV
-XEPWSEJJIGXWXLI[E]HEXEMWVITVIWIRXIHXSXLIYWIV%PP3VEGPI(%8)ZEPYIW
GSRXEMRMRKXLIXMQISJHE]TEVXEVIEYXSQEXMGEPP]HMWTPE]IH[MXLFSXLHEXIERH
XMQIZEPYIWTVIWIRXVIKEVHPIWWSJXLI207C(%8)C*361%8WIXXMRKSRXLI
WIVZIV1SVISZIVEPPHEXIWEVIHMWTPE]IHMRXLIWEQIJSVQEXXLVSYKLSYXXLI
YWIVMRXIVJEGIVIKEVHPIWWSJMRHMZMHYEPWIWWMSRWkHIJEYPXHEXIJSVQEXW
8LMWJSVQEXMWGSRXVSPPIHF]XLIYWIVZMEXLI(EXI(MWTPE]IH*SVQEXWIXXMRK
YRHIV+IRIVEP`9WIV-RXIVJEGITVIJIVIRGIW*SVGSRZIRMIRGIXLI
207C(%8)C*361%8JSVIEGLRI[WIWWMSRMWF]HIJEYPXWIXXSXLIWEQIZEPYI
EWXLI(MWTPE]IH*SVQEX9WIVWGERGLERKIXLI(IJEYPX(EXI*SVQEXYRHIV
7IWWMSRTVIJIVIRGIWMJXLI][MWLXSQEOIMXHMJJIVIRXJVSQXLI(MWTPE]IH
*SVQEXEPXLSYKL[IVIGSQQIRHOIITMRKMXXLIWEQIXSEZSMHGSRJYWMSR2SXI
XLEXMXMWXLI207C(%8)C*361%8WIXXMRKXLEXMWYWIHMQTPMGMXP][LIRXLI
YWIVWTIGMJMIWHEXIZEPYIWEWWXVMRKWMR750WXEXIQIRXWJSVI\EQTPI7)0)'8 
*631IQT;,)6)LMVIHEXI kk

More stable, easier to maintain


8LMWZIVWMSRSJ7502EZMKEXSVMWFEWIHSRERI[MRXIVREPHIWMKRXLEXIREFPIW
YWXSMQTPIQIRXRI[JIEXYVIW[MXLQMRMQEPVMWOXSTIVJSVQERGIERHWXEFMPMX]
7SQISJXLIGSVIQSHYPIWSJXLITVSHYGXLEZIFIIRVI[VMXXIRERHXLIIRXMVI

Chapter 2

Whats new in this version?

107

GSHIFEWILEWFIIRVIWXVYGXYVIHXSIRJSVGIELMKLIVPIZIPSJQSHYPEVMX]ERH
SFNIGXSVMIRXEXMSR8LMWIRWYVIWFIXXIVGSHIVIYWEFMPMX]ERHQEMRXEMREFMPMX]

Superceded functionality
8LIJSPPS[MRKJYRGXMSREPMX]MRTVIZMSYWZIVWMSRWLEWFIIRWYTIVGIHIHMRXLMW
ZIVWMSRSJ7502EZMKEXSV

'SHI-RWTIGXSV

6ITPEGIHF]XLIMRXIKVEXIH'SHI)\TPSVIV

(&2EZMKEXSV`,MIVEVGLMGEP
HMWTPE]SJGSQTPI\EVKYQIRXW

6ITPEGIHF]XLI%YXS(IWGVMFIJIEXYVI

(&2EZMKEXSV`0MWX'SQQERH

6ITPEGIHF]XLI*MRH3FNIGXWGSQQERH
ERHXLI(IXEMPW:MI[

(IFYK`7LS[)\IGYXMSR4SMRX

2S[EGLMIZIHF]HSYFPIGPMGOMRKXLIGEPP
WXEGOIRXV]

(IWGVMFI,MWXSV]

7YTIVGIHIHF]XLI;SVOWTEGIERH
%YXS(IWGVMFIJIEXYVIW

8IEQ4VSKVEQQMRK :'7

6ITPEGIHF]JPI\MFPI8IEQ'SHMRKQSHYPI

3
The SQL Navigator interface

8LMWGLETXIV[MPPWLS[]SYEVSYRHXLI7502EZMKEXSVKVETLMGEPIRZMVSRQIRX
-XMWQSVIHIXEMPIHXLERXLISZIVZMI[MR'LETXIVERHTVSZMHIWRSXNYWX
SZIVZMI[WFYXlLS[XSzMRJSVQEXMSREW[IPP

In this chapter
Overview of the SQL Navigator interface
Menus, Toolbars, & Commands
Keyboard shortcuts
Code editors overview
Workspaces: A smarter way of working
Connecting to the Oracle database
Viewing server output
The Oracle Job Manager

110
122
135
142
146
155
161
162

110

SQL Navigator Users Guide

Overview of the SQL Navigator interface


Main windows
8LI7502EZMKEXSVMRXIVJEGIMWLMKLP]GYWXSQM^EFPI8LIJSPPS[MRKI\EQTPI
WLS[WEX]TMGEPEVVERKIQIRXSJXSSPFEVWERH[MRHS[W1ER]SXLIV
EVVERKIQIRXWEVITSWWMFPI
1SWX7502EZMKEXSVXSSPFEVWERH[MRHS[WGERFIQSZIHEVSYRHERHVIWM^IH
8LIQEMR7502EZMKEXSV[MRHS[EYXSQEXMGEPP]VIQIQFIVWMXWWM^IWXEXI
ERHTSWMXMSR8SSPFEVWGERFIQSZIHERHHSGOIHEXXLIFSXXSQPIJXERHVMKLX
WMHIWSJXLI[MRHS[SVPIJXJPSEXMRKJSVFIXXIVYWISJ[MRHS[WTEGI=SY
GERIEWMP]LMHIERHWLS[MRHMZMHYEPXSSPFEVW7SQI[MRHS[WWYGLEWXLI
;SVOWTEGI3YXTYXERH'SHI%WWMWXERX[MRHS[WGERFIQEHIHSGOEFPI
WXE]SRXST[MRHS[WF]QIERWSJEWLSVXGYXQIRYSTXMSR
)EGLWIWWMSRVIPEXIH[MRHS[ GSHIIHMXSVSFNIGXIHMXSVERHWSSR VIQIQFIVW
ERHEYXSQEXMGEPP]STIRWMRXLIETTVSTVMEXIHEXEFEWIWIWWMSR
=SYGERJVIIP]W[MXGLXSSXLIVWIWWMSRWERHGSRXMRYI[SVOMRK[MXLMRXLIWEQI
[MRHS[SVSTIRERI[[MRHS[

Chapter 3

The SQL Navigator interface

111

All Toolbars can be


floating, docked, or
hidden. Toolbar
buttons become active
according to item
selected.
Main menu bar.

The DB Navigator
shows the entire
database structure as a
tree with expandable
nodes.

The optional Details


panel shows essential
information about the
item selected in the
tree.
The Workspace
window gives you
quick access to oftenused objects and
connections.

Click on any item in the


Task Bar to give it
focus.

The Output window


displays server output
including Oracle errors.

112

SQL Navigator Users Guide

The Task Bar


8LI8EWO&EVMWEHSGOEFPIXSSPFEV[MXLH]REQMGGSRXIRXW
7MQMPEVXSXLI;MRHS[WXEWOFEV[LMGLPMWXWEPPEGXMZIETTPMGEXMSRWXLI750
2EZMKEXSV8EWO&EVPMWXWEPPEGXMZI[MRHS[WEWXSSPFEVFYXXSRWIEGL[MXLE
[MRHS[MGSRERHXMXPI'PMGOMRKEFYXXSREGXMZEXIWXLIETTVSTVMEXI[MRHS[
FVMRKMRKMXXSXLIJSVIKVSYRHERHKMZMRKMXXLIJSGYW


8LIEGXMZI[MRHS[WPMWXIHSRXLI8EWO&EVEVIKVSYTIHF]WIWWMSR[MXLXLI
QSWXVIGIRXWIWWMSR
W[MRHS[WETTIEVMRKSRXLIPIJX8LIGYVVIRX[MRHS[MW
VITVIWIRXIHSRXLI8EWO&EVEWXLISRP]FYXXSRMRXLIHS[RTSWMXMSR8SWII
EXSSPXMTEFSYXERMXIQTSMRXXSMX[MXLXLIQSYWI

To enable the SQL Navigator Task Bar


 6MKLXGPMGOER][LIVIMRXLIQEMRQIRYFEVERHWIPIGX8EWO&EV
8LI8EWO&EVGERFIHSGOIHMRXLIYTTIVTEVXSJXLIETTPMGEXMSR[MRHS[SV
]SYGERHIXEGLMXERHTPEGIMX[LIVI]SY[ERXMX

Managing windows
8SSTIREGPSWIH7502EZMKEXSV[MRHS[
 'LSSWIXLI[MRHS[JVSQXLI:MI[QIRY 8SSTIREZMWYEPSFNIGXIHMXSV
GLSSWIERSTXMSRJVSQXLI:MI[ :MWYEP3FNIGX)HMXSVQIRY 
3V
 'PMGOXLIETTVSTVMEXIFYXXSRMRXLI*YRGXMSRWXSSPFEV
3V
 -RXLI(&2EZMKEXSVSV;SVOWTEGIHSYFPIGPMGOSRERSFNIGXEWWSGMEXIH
[MXLXLIVIUYMVIH[MRHS[

Chapter 3

The SQL Navigator interface

113

Saving Window Layouts


7502EZMKEXSV
WHSGOEFPI[MRHS[WPIX]SYEVVERKIXLIETTPMGEXMSR[SVOEVIE
XSWYMX]SYV[E]SJ[SVOMRK&YX]SYHSR
XLEZIXSOIITQSZMRK[MRHS[W
EVSYRHIZIV]XMQI]SYGLERKIXSEHMJJIVIRXHIZIPSTQIRXXEWO=SYGERWEZI
YTXSXIRHMJJIVIRX[MRHS[PE]SYXWERHVIGEPPXLIQ[MXLEGSYTPISJQSYWI
GPMGOW

To save and swap window layouts


1

2
3

*VSQXLI:MI[QIRYGLSSWI7GVIIR0E]SYX2SXIXLIPMWXSJRYQFIVIH
PE]SYXW8LISRI[MXLXLIGLIGOQEVOFIWMHIMXMWXLIGYVVIRXPE]SYX%R]
EVVERKIQIRXSJHSGOEFPI[MRHS[W]SYQEOI[LMPIXLMWPE]SYXMWWIPIGXIH
[MPPEYXSQEXMGEPP]FIVIQIQFIVIH[LIR]SYW[MXGLXSEHMJJIVIRXPE]SYX
8SWEZIXLIGYVVIRXPE]SYXERHW[MXGLXSEHMJJIVIRXPE]SYXGPMGOERSXLIV
RYQFIVIHPE]SYXMRXLIPMWX
8SVIWXSVIXLIGYVVIRXPE]SYXXSXLI7502EZMKEXSVHIJEYPXGLSSWI6IWIX
(SGOMRK

Accessing functions and tools


=SYGERUYMGOP]EGGIWWXLIGSHIIHMXSVWERHSXLIVQENSVXSSPWERHJYRGXMSRWEX
ER]XMQIYWMRKXLIHSGOEFPI*YRGXMSRWXSSPFEV8LIXSSPFEVMWJYPP]
GYWXSQM^EFPI
8SWIIELMRXEFSYX[LEXEXSSPFEVFYXXSRHSIWTEYWIXLIQSYWITSMRXIVSZIV
MX
8SWIPIGXJVSQEPMWXSJSTIRIHMXSVWGPMGOXLIHS[REVVS[ 6 XSXLIVMKLXSJ
ER)HMXSVFYXXSR

Navigating the database with DB Navigator


8LIGIRXVEPJIEXYVISJXLI7502EZMKEXSVMRXIVJEGIMWMXWLMIVEVGLMGEPZMI[SJ
XLIVIPEXMSREPHEXEFEWIWXVYGXYVIGEPPIHXLI(&2EZMKEXSV
9WIXLI(&2EZMKEXSV[MRHS[JSVJEWXERHTS[IVJYPHEXEFEWIFVS[WMRKERH
HVMPPHS[R(&2EZMKEXSVGSQFMRIWXLIEHZERXEKIWSJXLI;MRHS[W)\TPSVIV
ERHE;IFFVS[WIV
(&2EZMKEXSVHMWTPE]WEPPX]TIWSJ3VEGPIERHMSFNIGXWKMZMRK]SYE
LMIVEVGLMGEPZMI[SJER]WGLIQEMRGPYHMRKHITIRHERXSFNIGXW

114

SQL Navigator Users Guide

Tree view and detail view


(&2EZMKEXSVPIXW]SYZMI[HEXEFEWISFNIGXWMREX[STERI[MRHS[EXVII
ZMI[SRXLIPIJXERHEPMWXZMI[SRXLIVMKLX;LIR]SYWIPIGXE7GLIQERSHI
SV3FNIGX8]TIRSHI JSVI\EQTPI8EFPISV-RHI\ MRXLIPIJXTERIXLIVMKLX
TERIWLS[WEPMWXSJSFNIGXGSRXEMRIHMRXLEXRSHI
;LIR]SYWIPIGXEWTIGMJMGSFNIGXMRXLIPIJXTERIXLIPMWXZMI[TERIWLS[W]SY
EPMWXSJXLIEXXVMFYXIWSJXLISFNIGX]SYWIPIGXIH
-JXLIVMKLXTERIMWLMHHIR]SYGERWLS[MXF]IMXLIVSJXLIJSPPS[MRKQIXLSHW

To show or hide the DB Navigator details pane


 'PMGO
SRXLI(&2EZMKEXSVXSSPFEV
3V
 6MKLXGPMGOMRXLI(&2EZMKEXSV[MRHS[ERHGLSSWI:MI[ 7LS[,MHI
(IXEMPWJVSQXLIWLSVXGYXQIRY

Display and selection options


8LIPMWXSJSFNIGXWMRXLIVMKLXTERIMWHMWTPE]IH[LIRXLIWIPIGXIHRSHIMRXLI
XVIIMWEGSRXEMRIVSJSFNIGXW WYGLEWXLI8EFPIWRSHIYRHIVEWGLIQE ERHMX
LEWFIIRI\TERHIH
8LIPMWXGERFIHMWTPE]IHEWEWMQTPIPMWXSJREQIWSVEHIXEMPIHQYPXMGSPYQR
VITSVXWLS[MRKEPPORS[RTVSTIVXMIWSJXLISFNIGXW
'PMGOERSFNIGXMRXLIXVIIXSZMI[XLISFNIGX
WTVSTIVXMIW
8LMWPMWXEPPS[WJSVWIPIGXMSRSJQYPXMTPISFNIGXWJSVFEXGLSTIVEXMSRWPMOI(VST
)\XVEGX((0SV'SQTMPI

Data Dictionary views


(&%ZMI[WEVIVIUYMVIHJSVZMI[MRKWSQISFNIGXW

Chapter 3

The SQL Navigator interface




115



116

SQL Navigator Users Guide

Finding objects quickly


7502EZMKEXSVKMZIW]SYWIZIVEPGSRZIRMIRXTSMRXERHGPMGOSTXMSRWJSVUYMGO
EGGIWWXSHEXEFEWISFNIGXW*SYVSJXLIQSWXYWIJYPEVI
 8LI*MRH3FNIGXWHMEPSKJSVJMRHMRKSRISVQSVISFNIGXWF]QIERWSJE
WIEVGLEVKYQIRX
 8LI(&2EZMKEXSVXSSPJSVZMWYEP)\TPSVIVPMOIREZMKEXMSRSJEWGLIQE
 8LI0SGEXIMRWGLIQEGSQQERH[LMGLWLS[W]SY[LIVIERSTIRHEXEFEWI
SFNIGX JSVI\EQTPISRIXLEX]SYEVIIHMXMRK VIWMHIWMRXLI(&2EZMKEXSV
LMIVEVGL]
=SYGEREPWSYWI[SVOWTEGIWXSSVKERM^I]SYVWLSVXGYXWXSSFNIGXWXLEX]SY
QE]RIIHXS[SVO[MXLJVIUYIRXP]

Displaying a schema object and its properties


;LIRERSFNIGXMWSTIRMRERIHMXMRK[MRHS[ERH]SY[ERXXSWII[LIVIXLEX
SFNIGXVIWMHIWMRXLIWGLIQE]SYGERYWIXLI0SGEXIMR7GLIQEGSQQERHXS
NYQTXSXLEXSFNIGX
WRSHIMRXLI(&2EZMKEXSVXVII8LMWEGXMSRI\TERHWEPP
MRXIVQIHMEXIRSHIWERHHMWTPE]WXLISFNIGX
WHIXEMPWWYGLEWTVMZMPIKIWERH
GSPYQRW
8LI0SGEXIMR7GLIQEGSQQERHMWEZEMPEFPIRSXSRP]JVSQXLISFNIGXIHMXMRK
[MRHS[WFYXEPWSJVSQXLIJSPPS[MRK[MRHS[W
 (&2EZMKEXSV
 *MRH3FNIGXW
 'SHI7IEVGL
 ;SVOWTEGI
 (IWGVMFIXSSP
 %REP]^IXSSP
 &VS[WI(EXEERH)HMX(EXE

To locate an open or selected object in the schema


'PMGO

SVJVSQXLI3FNIGXQIRYGLSSWI0SGEXIMR7GLIQE

Chapter 3

The SQL Navigator interface

117

You can hide the right pane to save screen space


or increase the speed of the display.
Click
(the Show/Hide Details button) on the
DB Navigator toolbar
Or
Right-click in the DB Navigator window and
choose View Show/Hide Details from the
shortcut menu.

Managing database objects


7502EZMKEXSV
WIHMXMRKXSSPWJSVHEXEFEWISFNIGXWEVIZMWYEPXLI]KMZI]SYE
ZMWYEPVITVIWIRXEXMSRSJEHEXEFEWISFNIGXHIJMRMXMSR:MWYEPSFNIGXIHMXSVW
EPPS[]SYXSZMI[HEXEFEWISFNIGXHIJMRMXMSRWERHGVIEXISVEPXIVHEXEFEWI
SFNIGXWZMEETSMRXERHGPMGOMRXIVJEGIIPMQMREXMRKXLIRIIHXSVIQIQFIV750
W]RXE\ERH[VMXI750WXEXIQIRXWQERYEPP]
7502EZMKEXSVTVSZMHIWZMWYEPIHMXSVWJSVXLIJSPPS[MRKSFNIGXW
 'SRWXVEMRXW
 -RHI\IW
 (EXEFEWI0MROW
 -RHI\IW
 2IWXIH8EFPIW
 4VSJMPIW
 6SPIW
 7IUYIRGIW
 7XSVIH4VSKVEQW
 7]RSR]QW
 8EFPIW
 8VMKKIVW
 9WIVW
 :%66%=W
 :MI[W

118

SQL Navigator Users Guide

Opening a visual object editor


8LI:MWYEP3FNIGX)HMXSVGSQQERHSRXLI:MI[QIRYKMZIW]SYUYMGOEGGIWW
XSEPPXLISFNIGXIHMXSVW




Chapter 3

The SQL Navigator interface

119

Opening objects
'SQQSRETTVSEGLIWXSQEREKMRKHEXEFEWISFNIGXWMR7502EZMKEXSVEVIXS
 0SGEXIERSFNIGXMRXLI(&2EZMKEXSVXVIIERHXLIRETTP]EXSSPFEVSV
QIRYJYRGXMSRSVHSYFPIGPMGOXSSTIRMXMRERIHMXSV
 0SGEXIXLISFNIGXYWMRKXLI*MRH3FNIGXWHMEPSKMRXLI7IEVGLQIRY[LMGL
PIXW]SYWTIGMJ]EVERKISJWIEVGLGVMXIVME REQIS[RIVHEXIPEWXQSHMJMIH
ERHWSSR 
 3TIRERIHMXSVSJXLIETTVSTVMEXIX]TIERHXLIRPSGEXIXLISFNIGX[MXLMR
XLIIHMXMRK[MRHS[
You can use the SQL wildcard character % as part
of your search for object names. The wildcard by
itself will return all object names meeting the
criteria.

To open a database object in a visual editor


'LSSWISRISJXLIJSPPS[MRKQIXLSHW
 (SYFPIGPMGOEHEXEFEWISFNIGXMRXLI(&2EZMKEXSVXVIIE[SVOWTEGISV
XLI*MRH3FNIGXW[MRHS[
 *VSQXLI:MI[QIRYGLSSWI:MWYEP3FNIGX)HMXSVERHXLIRTMGOERIHMXSV
JVSQXLIPMWX
 *VSQXLI*YRGXMSRWXSSPFEV]SYGERSTIRXLI8VMKKIVIHMXSVSVXLI7XSVIH
4VSKVEQIHMXSV
 *VSQXLI3FNIGXQIRYGLSSWI'VIEXI(&3FNIGXXLIRGLSSWIXLIX]TISJ
SFNIGX]SY[ERXXSGVIEXI
 *VSQXLI3FNIGXQIRYGLSSWI3TIR(&3FNIGXXLIRWTIGMJ]XLIWGLIQEE
REQIQEWO F]HIJEYPX ERHERSFNIGXX]TI

120

SQL Navigator Users Guide

To create a database object


 *VSQXLI3FNIGXQIRYGLSSWI'VIEXI(&3FNIGXERHXLIRGLSSWIXLI
X]TISJSFNIGX]SY[ERXXSGVIEXI

Performing actions on a selected schema object


;LIRER]WGLIQESFNIGXMWSTIRSVWIPIGXIH]SYGERETTP]EGXMSRWJVSQXLI
3FNIGXQIRY8LMWETTPMIWXSSFNIGXWSTIRSVWIPIGXIHMRER]SJXLIJSPPS[MRK
[MRHS[WERHHMEPSKW
 (&2EZMKEXSV
 :MWYEPSFNIGXIHMXSVW
 *MRH3FNIGXW
 'SHI7IEVGL
 ;SVOWTEGI
 (IWGVMFIXSSP
 %REP]^IXSSP
 &VS[WI(EXEERH)HMX(EXE
8LIEZEMPEFPIEGXMSRWZEV]HITIRHMRKYTSRXLIX]TISJSFNIGXWIPIGXIH8LIWI
EGXMSRWMRGPYHIWYGLGSQQSRJYRGXMSRWEWXLSWIPMWXIHFIPS[1SWXSJXLIWI
EGXMSRWEVIHIWGVMFIHMR3VEGPIHSGYQIRXEXMSRFYXEJI[EVIYRMUYIXS750
2EZMKEXSV
 'VIEXI(&3FNIGX

 5YMGO&VS[WI

 3TIR(&3FNIGX
 3TIR

 )HMX(EXE
 %REP]^I

 (IWGVMFI

 8VYRGEXI

 6IREQI
 (VST
 )\XVEGX((0
 :MI[(MJJIVIRGI
 4YFPMWL.EZEXS40750
 'SQTMPI
 )\IGYXI
 &VS[WI(EXE

 7XSVEKI %PPSGEXI(IEPPSGEXI
'SEPIWGI 
 )REFPI
 (MWEFPI
 +VERX
 6IZSOI
 0SGEXIMR7GLIQE
 4VSTIVXMIW
 %HHXS;SVOWTEGI

Chapter 3

The SQL Navigator interface

121

Oracle Data Dictionary views


&]HIJEYPX7502EZMKEXSVKMZIW]SY97)6SFNIGXHEXEHMGXMSREV]ZMI[W
QIERMRK]SYGERWIISRP]SFNIGXW]SYS[RSVJSV[LMGL]SYLEZIFIIRKVERXIH
SFNIGXTVMZMPIKIW
=SYGERIREFPI(&%HMGXMSREV]ZMI[WJSVEGYVVIRXWIWWMSRMR7IWWMSR
TVIJIVIRGIWMJ]SY[ERXXSWIIEPPSFNIGXWEZEMPEFPIYRHIV]SYV(&%YWIV
TVMZMPIKIW(&%HMGXMSREV]ZMI[WEVIVIUYMVIHJSVIHMXMRK4VSJMPIW6SPIWERH
9WIVWSVJSVZMI[MRKXLIJSPPS[MRKRSHIWSJXLI(&2EZMKEXSVXVII
 6SPIW
 WSQIRSHIWYRHIV9WIVW
 (EXEJMPIWYRHIV8EFPIWTEGIW
 6IHS0SK+VSYTW
 6SPPFEGO7IKQIRXW

Required privileges
*SVEGGIWWXS(&%HMGXMSREV]ZMI[WEYWIVQYWXLEZISRISJXLIJSPPS[MRK
VSPIWSVTVMZMPIKIW
 (&%6SPI
 7)0)'8'%8%03+6SPI
 7)0)'8%2=8%&0)4VMZMPIKI

How SQL Navigator handles the views


;LIR(&%HMGXMSREV]ZMI[WEVIWIPIGXIH7502EZMKEXSVMRXIVVSKEXIWXLIHEXE
HMGXMSREV]HMJJIVIRXP]
 6IKEVHPIWWSJ(&%:MI[WIXXMRK7502EZMKEXSVYWIW97)6CZMI[WJSV
XLIPSKKIHSRYWIVkWSFNIGXW
 ;MXLSYX(&%:MI[W7502EZMKEXSVYWIW%00CZMI[WJSVSXLIVYWIVkW
SFNIGXW
 ;MXL(&%:MI[W7502EZMKEXSVYWIW7=7(&%CZMI[WJSVSXLIVYWIVkW
SFNIGXW
Using DBA dictionary views may affect
performance for some Oracle instances,
depending on the number of users and objects, as
well as other environmental factors.

122

SQL Navigator Users Guide

Menus, Toolbars, & Commands


Menus
8LIQEMRQIRYFEVGERFIJPSEXMRKSVHSGOIH

Main menu bar



1IRYWERHXSSPFEVWEVIGSQTPIXIP]GYWXSQM^EFPI=SYGER
 EHHSVVIQSZIQIRYERHXSSPFEVFYXXSRWERHGSQQERHW
 EHHSVVIQSZIXSSPFEVWERHQIRYWXLIQWIPZIW
 GVIEXIRI[QIRYWERHXSSPFEVW
%R]GYWXSQM^EXMSRMWWEZIHTIVQERIRXP]MRXLIW]WXIQVIKMWXV]ERHVIWXSVIH
EYXSQEXMGEPP]RI\XXMQI7502EZMKEXSVMWVYR8LIQEMRQIRYFEV F]HIJEYPX 
GSRXEMRWXLIJSPPS[MRKQIRYW-JXLIWIQIRYWEVIRSXZMWMFPI]SYQE]RIIHXS
VIWIX]SYVQIRYW

This menu

Has commands for

*MPI

STIVEXMSRWSRJMPIWERH[SVOWTEGIWTPYWXLI)\MX
GSQQERH

)HMX

GSQQSRXI\XERHGSHIIHMXMRKEGXMSRW

7IEVGL

JMRHMRKXI\XGSHIERHHEXEFEWISFNIGXW

:MI[

GSRXVSPPMRKXLIETTIEVERGISJZEVMSYW[MRHS[W

7IWWMSR

WIWWMSR[MHIEGXMSRW

3FNIGX

STIVEXMRKSRHEXEFEWISFNIGXW

(IFYK

GSHIHIFYKKMRK

8SSPW

MRZSOMRKERHGSRXVSPPMRKWIGSRHEV]XSSPW

8IEQ'SHMRK

ZIVWMSRGSRXVSPERHXIEQGSHMRKJYRGXMSRW

;MRHS[W

GSRXVSPPMRKXLIEVVERKIQIRXSJSTIR[MRHS[WMR
XLI7502EZMKEXSVETTPMGEXMSREVIE

,IPT

EGGIWWXSSRPMRILIPT

Chapter 3

The SQL Navigator interface

123

Menu synchronization
8LIGSQQERHWXLEXEVIEZEMPEFPIMREPP[MRHS[WGLERKIEWHMJJIVIRXX]TIWSJ
SFNIGXWERH[MRHS[WEVIWIPIGXIHSVSTIRIH
(EXEFEWISFNIGXWEWWSGMEXIH[MXLERSTIR[MRHS[FIGSQIGYVVIRXJSVXLI
IRXMVI7502EZMKEXSVHIZIPSTQIRXIRZMVSRQIRX
;LIRIZIV]SYSTIREHEXEFEWISFNIGX EXEFPITVSGIHYVIJYRGXMSRMRHI\ERH
WSSR MRSRISJXLIJSPPS[MRK[MRHS[W7502EZMKEXSVIREFPIWEPPXLI
ETTVSTVMEXIQIRYSVXSSPFEVGSQQERHWJSVXLEXSFNIGX
 (&2EZMKEXSV
 *MRH3FNIGXW
 'SHI7IEVGL
 ;SVOWTEGI
 (IWGVMFIXSSP
 :MWYEPSFNIGXIHMXSVW
 &VS[WI)HMXHEXE
*SVI\EQTPI[LIRERSFNIGXMWSTIRMRERIHMXMRK[MRHS[]SYGERYWIXLI
0SGEXIMR7GLIQEGSQQERHXSNYQTXSXLEXSFNIGX
WRSHIMRXLI(&2EZMKEXSV
XVIII\TERHMRKEPPMRXIVQIHMEXIRSHIWERHSTIRMRKXLISFNIGX
WHIXEMPW

SQL Navigator command list


&IGEYWI7502EZMKEXSVMWWSTEGOIH[MXLYWIJYPJIEXYVIWMXGERWSQIXMQIWFI
GLEPPIRKMRKXSVIQIQFIVI\EGXP][LIVIXSEGGIWWEWTIGMJMGGSQQERH9WYEPP]
VMKLXGPMGOMRKERSFNIGXMWEPPXLEXMWVIUYMVIHXSEGGIWWXLIETTVSTVMEXI
GSQQERH
-JXLEXHSIWR
X[SVOXLIJSPPS[MRKPMWXMRK[MPPLIPT]SYPSGEXIGSQQERHWWGER
XLIEPTLEFIXMGEPPMWXSJGSQQERHWMRGSPYQRSRIERHXLIRVIEHEGVSWWXSWII
[LMGLQIRYERHSVXSSPFEVGSRXEMRWXLIGSQQERH8SWII[LEXEREQIH
XSSPFEVPSSOWPMOIGPMGOXLIL]TIVPMROMRXLIWIGSRHGSPYQR
-JXLIGSQQERHPMWXIHLIVIHSIWR
XETTIEVMRXLIHIWMKREXIHQIRYSVXSSPFEV
SV]SYHSRSXWIIXLIQIRYSVXSSPFEVMR]SYV7502EZMKEXSVETTPMGEXMSR
[MRHS[]SYQE]RIIHXSVIWIX]SYVXSSPFEVW
=SYGEREPWSPSSOYTER]7502EZMKEXSVGSQQERHMRXLISRPMRILIPT
OI][SVHMRHI\SVJYPPXI\XWIEVGL8SHMWTPE]XLITYVTSWISJER]XSSPFEV
FYXXSRMRE7502EZMKEXSV[MRHS[TSMRXXSMX[MXLXLIQSYWIERHEXSSPXMT
[MPPETTIEV


124

SQL Navigator Users Guide

Command

Menu or Toolbar

%FSVX)\IGYXMSR

(IFYKQIRYERHXSSPFEV

%FSYX7502EZMKEXSV

,IPTQIRY

%HHXS;SVOWTEGI

3FNIGXQIRYERHXSSPFEV

%HH;EXGL

(IFYKQIRYERHXSSPFEV

%PPSGEXI

3FNIGXQIRYERHXSSPFEV

%REP]^I

3FNIGXQIRYERHXSSPFEV

%VVERKI%PP

;MRHS[1IRY

%XXEGL)\XIVREP7IWWMSR

(IFYKQIRYERHXSSPFEV

%YXS7XIT3ZIV

(IFYKQIRYERHXSSPFEV

%YXS8VEGI

(IFYKQIRYERHXSSPFEV

%YXS(IWGVMFI8SSP

:MI[QIRY

&VIEO3R)\GITXMSR

(IFYKQIRYERHXSSPFEV

&VS[WI(EXE

3FNIGXQIRYERHXSSPFEV

'ETXYVI;IF3YXTYX

7IWWMSRQIRYERHXSSPFEV

'EWGEHI

;MRHS[1IRY

'LIGO-R

8IEQ'SHMRKQIRYERHXSSPFEV

'LIGO-R%PP

8IEQ'SHMRKQIRYERHXSSPFEV

'LIGO3YX

8IEQ'SHMRKQIRYERHXSSPFEV

'PSWI WIWWMSR 

7IWWMSRQIRYERHXSSPFEV

'PYWXIV)HMXSV

:MI[QIRY

'SEPIWGI

3FNIGXQIRYERHXSSPFEV

'SHI%WWMWXERX

:MI[QIRY

Chapter 3

The SQL Navigator interface

Command

125

Menu or Toolbar

'SHI'SRXVSP+VSYTW

8IEQ'SHMRKQIRYERHXSSPFEV

'SHI7IEVGL

7IEVGLQIRY

'SQQIRX

)HMX1IRYERHXSSPFEV

'SQQMX

7IWWMSRQIRYERHXSSPFEV

'SQTMPI

3FNIGXQIRYERHXSSPFEV

'SQTMPI(ITIRHERXW

3FNIGXQIRYERHXSSPFEV

'SQTMPI(ITIRHIRGMIW

3FNIGXQIRYERHXSSPFEV

'SQTMPI6IFYMPH

3FNIGXQIRYERHXSSPFEV

'SRWXVEMRX)HMXSV

:MI[QIRY

'SRXIRXW ,IPT 

,IPTQIRY

'SRXI\X,IPT

,IPTQIRY

'SRXMRYI

(IFYKQIRYERHXSSPFEV

'SRZIVX/I][SVHWXS
0S[IVGEWI

)HMX1IRYERHXSSPFEV

'SRZIVX/I][SVHWXS
9TTIVGEWI

)HMX1IRYERHXSSPFEV

'ST]

)HMX1IRYERHXSSPFEV

'VIEXI(&3FNIGX

3FNIGXQIRYERHXSSPFEV

'VIEXI7YTTSVX&YRHPI

,IPTQIRY

'69(1EXVM\

)HMX1IRYERHXSSPFEV

'YVVIRX7GLIQE

3FNIGXQIRYERHXSSPFEV

'YVVIRX7IWWMSR

7IWWMSRQIRYERHXSSPFEV

'YVVIRX;SVOWTEGI

*MPI1IRY

126

SQL Navigator Users Guide

Command

Menu or Toolbar

'YX

)HMX1IRYERHXSSPFEV

(EXE*EGXSV]

8SSPWQIRY

(EXEFEWI0MRO)HMXSV

:MI[QIRY

(&2EZMKEXSV

:MI[QIRY

(&17C398498498C0
-2)  

)HMX1IRYERHXSSPFEV

(IEPPSGEXI

3FNIGXQIRYERHXSSPFEV

(IFYK:EVMEFPI

)HMX1IRYERHXSSPFEV

(IPIXI;SVOWTEGI

*MPI1IRY

(IWGVMFI

3FNIGXQIRYERHXSSPFEV

(IWGVMFI3FNIGXEX
'YVWSV

)HMX1IRYERHXSSPFEV

(MWEFPI

3FNIGXQIRYERHXSSPFEV

(MWGSRRIGX

7IWWMSRQIRYERHXSSPFEV

(MWGSRRIGX%PP

7IWWMSRQIRYERHXSSPFEV

(VST

3FNIGXQIRYERHXSSPFEV

)HMX(EXE

3FNIGXQIRYERHXSSPFEV

)REFPI

3FNIGXQIRYERHXSSPFEV

)REFPI-RPMRI%HZMGI

8SSPWQIRY

)ZEPYEXI1SHMJ]

(IFYKQIRYERHXSSPFEV

)\IGYXI

3FNIGXQIRYERHXSSPFEV

)\MX

*MPI1IRY

)\TPEMR4PER8SSP

8SSPWQIRY

Chapter 3

The SQL Navigator interface

Command

127

Menu or Toolbar

)\XVEGX((0

3FNIGXQIRYERHXSSPFEV

*MPI

)HMX1IRYERHXSSPFEV

*MRH

7IEVGLQIRY

*MRH2I\X

7IEVGLQIRY

*MRH3FNIGXW

7IEVGLQIRY

*MRH4VIZMSYW

7IEVGLQIRY

*SVQEX8I\X

8SSPWQIRY

*SVQEXXIV8SSPW

8SSPWQIRY

*SVQEXXMRK3TXMSRW

8SSPWQIRY

+IX0EXIWX6IZMWMSR

8IEQ'SHMRKQIRYERHXSSPFEV

+SXS&SSOQEVO

)HMX1IRYERHXSSPFEV

+SXS0MRI

)HMX1IRYERHXSSPFEV

+VERX

3FNIGXQIRYERHXSSPFEV

,S[XS9WI,IPT

,IPTQIRY

,810*MPI

*MPI1IRY

-QTSVX,810EW
40750

8SSPWQIRY

-RGPYHI(IFYK-RJS
[LIRGSQTMPMRK 

7IWWMSRQIRYERHXSSPFEV

-RHIRX

)HMX1IRYERHXSSPFEV

-RHI\)HMXSV

:MI[QIRY

.EZE)HMXSV

:MI[QIRY

.EZE1EREKIV

8SSPWQIRY

128

SQL Navigator Users Guide

Command

Menu or Toolbar

.SF1EREKIV

8SSPWQIRY

.YQTXS1EXGLMRK
&VEGOIX

)HMX1IRYERHXSSPFEV

0EYRGL*SVQEXXIV4PYW

8SSPWQIRY

0MWX%PP&VIEOTSMRXW

(IFYKQIRYERHXSSPFEV

0MWX%PP;EXGLIW

(IFYKQIRYERHXSSPFEV

0MWX&SSOQEVOW

)HMX1IRYERHXSSPFEV

0SGEXIMR7GLIQE

3FNIGXQIRYERHXSSPFEV

0S[IV'EWI

)HMX1IRYERHXSSPFEV

1MRMQM^I%PP

;MRHS[1IRY

1SVI;MRHS[W

;MRHS[1IRY

2IWXIH8EFPI)HMXSV

:MI[QIRY

2I[*MPI

*MPI1IRY

2I[7IWWMSR

7IWWMSRQIRYERHXSSPFEV

2I[750)HMXSV

:MI[QIRY

2I[;SVOWTEGI

*MPI1IRY

2I\X;MRHS[

;MRHS[1IRY

3TIR SFNIGX 

3FNIGXQIRYERHXSSPFEV

3TIR(&3FNIGX

3FNIGXQIRYERHXSSPFEV

3TIR*MPI

*MPI1IRY

3TIR3FNIGXEX'YVWSV

)HMX1IRYERHXSSPFEV

3TIR7IPIGXIH8I\XMR
750)HMXSV

)HMX1IRYERHXSSPFEV

Chapter 3

The SQL Navigator interface

Command

129

Menu or Toolbar

3TIR;SVOWTEGI

*MPI1IRY

3YXTYX;MRHS[

:MI[QIRY

4EWXI

)HMX1IRYERHXSSPFEV

4EYWI%YXS7XITTMRK

(IFYKQIRYERHXSSPFEV

40750(IFYKKMRK

7IWWMSRQIRYERHXSSPFEV

407504VSJMPIV

8SSPWQIRY

40:MWMSR'SRXVSP4ERIP

8SSPWQIRY

4VIJIVIRGIW

:MI[QIRY

4VIZMSYW;MRHS[

;MRHS[1IRY

4VMRX

*MPI1IRY

4VMRX4VIZMI[

*MPI1IRY

4VMRX7IXYT

*MPI1IRY

4VSHYGX%YXLSVM^EXMSR

8SSPWQIRY

4VSJMPI)HMXSV

:MI[QIRY

4VSTIVXMIW

3FNIGXQIRYERHXSSPFEV

4VSZMHIV0SKSR

8IEQ'SHMRKQIRYERHXSSPFEV

4YFPMWL.EZEXS40750

3FNIGXQIRYERHXSSPFEV

5YIV]&YMPHIV

8SSPWQIRY

5YMGO&VS[WI

3FNIGXQIRYERHXSSPFEV

6IGSRRIGX

7IWWMSRQIRYERHXSSPFEV

6IHS

)HMX1IRYERHXSSPFEV

6IREQI

3FNIGXQIRYERHXSSPFEV

130

SQL Navigator Users Guide

Command

Menu or Toolbar

6IREQI;SVOWTEGI

*MPI1IRY

6ISTIR

*MPI1IRY

6ITPEGI

7IEVGLQIRY

6ITSVX8VII

8SSPWQIRY

6IWIX(SGOMRK

:MI[QIRY

6IZSOI

3FNIGXQIRYERHXSSPFEV

6SPI)HMXSV

:MI[QIRY

6SPPFEGO

7IWWMSRQIRYERHXSSPFEV

6YR XEWO 

7IWWMSRQIRYERHXSSPFEV

6YRXS'YVWSV

(IFYKQIRYERHXSSPFEV

7EZI*MPI

*MPI1IRY

7EZI*MPI%W

*MPI1IRY

7GVIIR0E]SYX

:MI[QIRY

7IEVGL/RS[PIHKI<TIVX

8SSPWQIRY

7IPIGX WIWWMSRW 

7IWWMSRQIRYERHXSSPFEV

7IPIGX%PP

)HMX1IRYERHXSSPFEV

7IUYIRGI)HMXSV

:MI[QIRY

7IVZIV3YXTYX

7IWWMSRQIRYERHXSSPFEV

7IVZIV7MHI-RWXEPPEXMSR
;M^EVH

8SSPWQIRY

7LSVXGYX*YRGXMSR/I]W

,IPTQIRY

7LS[7XEXMWXMGW

8SSPWQIRY

7SYVGI4VIZMI[

:MI[QIRY

Chapter 3

The SQL Navigator interface

Command

131

Menu or Toolbar

750-QTEGX

8SSPWQIRY

750-QTEGX%REP]WMW

8SSPWQIRY

750-QTEGX*MRH750

8SSPWQIRY

750-QTEGX;LIVI9WIH

8SSPWQIRY

7507GVMTX

*MPI1IRY

7XEXYW

8IEQ'SHMRKQIRYERHXSSPFEV

7XEXYW;MRHS[

(IFYKQIRYERHXSSPFEV

7XIT3ZIV

(IFYKQIRYERHXSSPFEV

7XST XEWOI\IGYXMSR 

7IWWMSRQIRYERHXSSPFEV

7XSVEKI

3FNIGXQIRYERHXSSPFEV

7XSVIH4VSKVEQ)HMXSV

:MI[QIRY

7YWTIRH XEWO 

7IWWMSRQIRYERHXSSPFEV

7]RSR]Q)HMXSV

:MI[QIRY

7]RXE\'LIGO

8SSPWQIRY

8EFPI)HMXSV

:MI[QIRY

8EFPIWTEGI)HMXSV

:MI[QIRY

8EWO1EREKIV

:MI[QIRY

8IEQ'SHMRK:MI[IV

8IEQ'SHMRKQIRYERHXSSPFEV

8MPI,SVM^SRXEP

;MRHS[1IRY

8MPI:IVXMGEP

;MRHS[1IRY

8SKKPI&SSOQEVO

)HMX1IRYERHXSSPFEV

8SKKPI&VIEOTSMRX

(IFYKQIRYERHXSSPFEV

132

SQL Navigator Users Guide

Command

Menu or Toolbar

8VEGI-RXS

(IFYKQIRYERHXSSPFEV

8VEGI3YX

(IFYKQIRYERHXSSPFEV

8VMKKIV)HMXSV

:MI[QIRY

8VYRGEXI

3FNIGXQIRYERHXSSPFEV

9RGSQQIRX

)HMX1IRYERHXSSPFEV

9RHS

)HMX1IRYERHXSSPFEV

9RHS'LIGOSYX

8IEQ'SHMRKQIRYERHXSSPFEV

9RMRHIRX

)HMX1IRYERHXSSPFEV

9TTIV'EWI

)HMX1IRYERHXSSPFEV

9WIV)HMXSV

:MI[QIRY

:%66%=)HMXSV

:MI[QIRY

:IVWMSR'SRXVSP&VS[WIV

8IEQ'SHMRKQIRYERHXSSPFEV

:MI[(MJJIVIRGI

8SSPWQIRY

:MI[)HMXSV

:MI[QIRY

:MI[)HMXSV

:MI[QIRY

:MWYEP3FNIGX)HMXSV

:MI[QIRY

;IF'SRJMKYVEXMSR

7IWWMSRQIRYERHXSSPFEV

;SVOWTEGI

:MI[QIRY

<TIVX8YRMRK

8SSPWQIRY

Chapter 3

The SQL Navigator interface

133

Toolbars
Toolbars
%PPXSSPFEVWEVIGYWXSQM^EFPI
 8SWIIELMRXEFSYXXLITYVTSWISJER]XSSPFEVFYXXSRTEYWIXLIQSYWI
TSMRXIVSZIVMX
 =SYGERQSZIXSSPFEVWXSER]PSGEXMSRMRXLI[SVOWTEGIERHHSGOXLIQEX
XLIFSXXSQPIJXERHVMKLXWMHIWSJXLI[SVOEVIE 8LI7IWWMSRXSSPFEVMWER
I\GITXMSRMXGERFIHSGOIHSRP]XSXLIXSTSVFSXXSQSJXLIQEMR[MRHS[ 
8SSPFEVWGERJPSEXSRXSTSJXLIGYVVIRX[MRHS[
 =SYGERWLS[ERHLMHIXSSPFEVWXSTVSZMHIQSVI[SVOWTEGI=SYGER
GLERKIXLIWLETISJXSSPFEVWF]HVEKKMRKXLIMVLSVM^SRXEPSVZIVXMGEP
FSYRHEVMIW
 8LIQSWXVIGIRX[MRHS[ERHXSSPFEVWM^IERHTSWMXMSR[MPPFI
EYXSQEXMGEPP]VIWXSVIHYTSRVISTIRMRK
8LIJSPPS[MRKXSSPFEVWEVIEZEMPEFPI F]HIJEYPX MRXLIQEMR[MRHS[-JXLI]
EVIRSXZMWMFPI]SYQE]RIIHXSVIWIX]SYVXSSPFEVW

Toolbar

Purpose

7IWWMSR

HYTPMGEXIWXLI7IWWMSRQIRYERHGSRXEMRWXLI'YVVIRX
7IWWMSRWIPIGXMSRFS\

)HMX

HYTPMGEXIWXLI)HMXQIRY

*YRGXMSRW

HYTPMGEXIWWSQIGSQQERHWJSYRHYRHIVXLI:MI[*MPI
ERH8SSPWQIRYWERHGSRXEMRWXLI'YVVIRX;SVOWTEGI
GSQFSFS\

(IFYK

HYTPMGEXIWXLI(IFYKQIRY

3FNIGX

HYTPMGEXIWXLI3FNIGXQIRYERHGSRXEMRWXLI'YVVIRX
7GLIQEGSQFSFS\

8IEQ'SHMRK

(YTPMGEXIWXLI8IEQ'SHMRKQIRY

134

SQL Navigator Users Guide

The Team Coding Toolbar



The Session toolbar



The Object Toolbar


8LIEGXMSRWEZEMPEFPIMRXLI3FNIGXQIRYERHXSSPFEVEVIGSRXI\XWIRWMXMZI
XLI]EVIEP[E]WVIPIZERXXSXLIGYVVIRXP]WIPIGXIHSFNIGXWMRXLIGYVVIRX[MRHS[
JSVI\EQTPIXLIGYVVIRXXVIIRSHIPMWXMXIQSVHEXEFEWISFNIGX

The Functions Toolbar

The Edit Toolbar



The Debug Toolbar



Chapter 3

The SQL Navigator interface

135

Keyboard shortcuts
7IIEPWSl4VSKVEQQMRKWLSVXGYXWzTEKI
$FWLRQ

.H\

'%06B287387387B/,1(

&WUO'

$ERUW([HFXWLRQ

6KLIW&WUO)

$GG:DWFK

&WUO)

$XWR6WHS2YHU

6KLIW&WUO)

$XWR7UDFH,QWR

6KLIW&WUO)

%UHDNRQ([FHSWLRQ

&WUO$OW;

%ULQJXSVHFRQGSUHIHUHQFHGLDORJ

&75/(QWHU

%URZVH7DEOH'DWD

&WUO%

&ORVHGURSGRZQER[HV

$/78S$UURZ

NH\
&ORVHH[SDQGHGVXEJURXS

.H\

&RPSLOH3URFHGXUH7ULJJHU

&WUO)

&RS\WKHVHOHFWHGWH[WWRWKHFOLSERDUG

&WUO,QV&WUO&

&XW

&WUO;

'%1DYLJDWRU:LQGRZ

)

'%062XWSXW/LQH

&WUO'

'HEXJ9DULDEOH

)

'HFUHPHQWYDOXHVLQQXPHULFVSLQFRQWUROV

&75/'RZQ

$UURZ
'HVFULEH

&WUO)

(GLW&HOO'DWD

$OW(QWHU

(YDOXDWH0RGLI\

&WUO)

([HFXWH64/VWDWHPHQWLQ64/(GLWRU

&WUO)

([SDQGVXEJURXS

.H\

)LQGQH[W

)

136

SQL Navigator Users Guide

$FWLRQ

.H\

)LQG2EMHFW

&WUO2

)LQGSUHYLRXV

6KLIW)

)LQG7DERQ)LQG5HSODFH

&WUO)

)RUPXOWLSOHUHVXOWVHWV

$OWQ

ZKHUHQ

WKH

UHVXOW


VHWQXPEHU

VWDUWLQJ


IURP 

*RWRDOLQHQXPEHU

&WUO*

*RWRWKHERWWRPRIWKHILOH

&WUO(QG

*RWRWKHSUHYLRXVO\VHWPDUNHU

&WUO&WUO

*RWRWKHWRSRIWKHILOH

&WUO+RPH

*UDQW3ULYLOHJHV

$OW*

+HOS&RQWHQWV

&WUO)

+HOS

)

,QFUHPHQWYDOXHVLQQXPHULFVSLQFRQWUROV

&75/8S$UURZ

,QGHQWFXUUHQWOLQHVHOHFWLRQ

&WUO,

-XPSWRPDWFKLQJ%UDFNHW

&WUO@

/LVW$OO%UHDNSRLQWV

&WUO$OW%

/LVW$OO:DWFKHV

&WUO$OW:

/LVW%RRNPDUNV

$OW%

/RFDWH2EMHFW,Q6FKHPD

&WUO/

/RZHUFDVH

&WUO$/7/

0DQXDO)XOO3DUVH

)

0RYHWKHFDUHWWRWKHEHJLQQLQJRIWKHOLQH

+RPH

0RYHWKHFDUHWWRWKHHQGRIWKHOLQH

(QG

0RYHWKHFDUHWWRWKHQH[WZRUG

&WUO5LJKW$UURZ

Chapter 3

The SQL Navigator interface

137

$FWLRQ

.H\

0RYHWKHFDUHWWRWKHSUHYLRXVZRUG

&WUO/HIW$UURZ

0RYHWKHFDUHWXSWRWKHERWWRPRIWKHZLQGRZ

&WUO3J'Q

1H[W:LQGRZ

)

2SHQGURSGRZQER[HV

$/7'RZQ$UURZ

NH\
2SHQQHZ64/(GLWRU

&WUO0

2SHQQHZ6WRUHG3URJUDP(GLWRU

&WUO1

2SHQ2EMHFWDW&XUVRU

&WUO(QWHU

2SHQ6HOHFWHG2EMHFW

&WUO)

2SHQ&ORVH:RUNVSDFH:LQGRZ

&WUO:

3DVWHWKHWH[WIURPWKHFOLSERDUG

6KLIW,QV&WUO9

3DXVH$XWR6WHSSLQJ

&WUO$OW3

3/?)RUPDWWHU)RUPDW7H[W

&WUO5

3UHYLRXV:LQGRZ

6KLIW)

3ULQW

&WUO3

5HGRWKHODVWXQGRQHRSHUDWLRQ

&WUO6KLIW=

&WUO<


6KLIW$OW%NVS

5HIUHVK

)

5HSODFH7DERQ)LQG5HSODFH

&WUO+

5HVXOWV7DERQ64/(GLWRU

$OW5

5XQWRFXUVRU

)

5XQ

)

6DYHILOH

&WUO6

6HDUFK.QRZOHGJH;SHUW

&WUO.

6HOHFWDOO

&WUO$

138

SQL Navigator Users Guide

$FWLRQ

.H\

6HWWKHSRVLWLRQRIPDUNHU  DWWKH


FXUUHQWFDUHWSRVLWLRQ


&WUO6KLIW&WU

O6KLIW
6SRRO7DERQ64/(GLWRU

$OW/

64/7DERQ(GLWRU

$OW4

6WDWXV:LQGRZ

&WUO$OW6

6WHSRYHU

)

6WRS

6FROO/RFN

7RJJOHEHWZHHQ4XHU\DQG5HVXOWVSDJH

&WUO)

7RJJOH%UHDNSRLQW

)

7RJJOHLWHPEHWZHHQ&KHFNHGDQG8Q&KHFNHG

6SDFHEDU

7UDFHLQWR

)

7UDFHRXW

6KLIW)

8QGRWKHODVWRSHUDWLRQ

&WUO=$OW%NVS

8Q,QGHQWFXUUHQWOLQH6HOHFWLRQ

&WUO8

8SSHUFDVH

&WUO$/78

Chapter 3

The SQL Navigator interface

139

Programming shortcuts
=SYGERTVSKVEQ/I]GSQFMREXMSRWJVSQ'XVP7LMJX%XS'XVP7LMJX>
[MXLXI\XYTXSGLEVEGXIVWMRPIRKXL

To program shortcut keys


*VSQXLI:MI[QIRYGLSSWI4VIJIVIRGIW
9RHIVXLI'SHI)HMXSVWTVIJIVIRGILIEHMRKI\TERH40750ERHXLIR
WGVSPPHS[RXSXLI8IQTPEXIWGEXIKSV]
;LIVI]SYWIIXLI[SVHW )HMX'SHI7LSVXGYXW"GPMGOERHXLIRZMI[SV
GLERKIWLSVXGYXOI]EWWMKRQIRXWEWVIUYMVIH

1
2
3

Default settings
.H\&RPELQDWLRQ

9DOXH

&WUO6KLIW$

,)FRQGLWLRQBLVBWUXH7+(1VWDWHPHQWV

&WUO6KLIW%

%22/($1

&WUO6KLIW&

&/26(FXUVRUBQDPH

&WUO6KLIW'

GEPVBRXWSXWSXWBOLQH



&WUO6KLIW(

(;&(37,21

:+(1H[FHSWLRQBQDPH7+(1

VWDWHPHQWV

:+(1QRBGDWDBIRXQG7+(1

VWDWHPHQWV

:+(1RWKHUV7+(1&DXWLRQ+DQGOHVDOOH[FHSWLRQV

VWDWHPHQWV

&WUO6KLIW)

)25M,1/223

VWDWHPHQWV

(1'/223

&WUO6KLIW*

*272ODEHOBQDPH

&WUO6KLIW+

&WUO6KLIW-

&WUO6KLIW.

140

SQL Navigator Users Guide

.H\&RPELQDWLRQ

9DOXH

&WUO6KLIW/

/223

VWDWHPHQWV

(1'/223

&WUO6KLIW0

0/6/$%(/

&WUO6KLIW1

180%(5 SUHFLVLRQVFDOH 

&WUO6KLIW2

23(1FXUVRUBQDPH

&WUO6KLIW3

&WUO6KLIW4

&WUO6KLIW5

5$,6(H[FHSWLRQBQDPH

&WUO6KLIW6

64/&2'(

&WUO6KLIW7

YDULDEOHBQDPH&RO1DPH7<3(

&WUO6KLIW8

&WUO6KLIW9

9$5&+$5  

&WUO6KLIW:

:+,/(FRQGLWLRQBLVBWUXH/223

VWDWHPHQWV

(1'/223

&WUO6KLIW;

(;,7:+(1FRQGLWLRQBLVBWUXH7RH[LWRXWRIORRS

&WUO6KLIW<

&WUO6KLIW=

Chapter 3

The SQL Navigator interface

141

Debugging shortcuts

$FWLRQ

.H\

$ERUW([HFXWLRQ

6KLIW&WUO)

$GG:DWFK

&WUO)

$XWR6WHS2YHU

6KLIW&WUO)

$XWR7UDFH,QWR

6KLIW&WUO)

%UHDNRQ([FHSWLRQ

&WUO$OW;

'HEXJ9DULDEOH

)

(YDOXDWH0RGLI\

&WUO)

/LVW$OO%UHDNSRLQWV

&WUO$OW%

/LVW$OO:DWFKHV

&WUO$OW:

3DXVH$XWR6WHSSLQJ

&WUO$OW3

5XQWRFXUVRU

)

6WDWXV:LQGRZ

&WUO$OW6

6WHSRYHU

)

6WRS

6FROO/RFN

7RJJOH%UHDNSRLQW

)

7UDFHLQWR

)

7UDFHRXW

6KLIW)

142

SQL Navigator Users Guide

Code editors overview


Code editors
7502EZMKEXSVTVSZMHIWX[STS[IVJYPGSHIIHMXMRKIRZMVSRQIRXWXSLERHPI
QSWX750ERH40750HIZIPSTQIRXXLI750)HMXSVERHXLI7XSVIH4VSKVEQ
)HMXSV EPWSVIJIVVIHXSEWXLI40750)HMXSV 
8LIVIMWEPWSE8VMKKIV)HMXSVXLEXMWRSXGSZIVIHMRXLMWKVSYTSJXSTMGW
FIGEYWIMXMWVIEPP]EZMWYEPIHMXSVXLSYKLMXMRGPYHIWEGSHIIHMXMRK[MRHS[
To create or edit

Use this editor

750WXEXIQIRXWSVWGVMTXW

750)HMXSV

TVSGIHYVIW

7XSVIH4VSKVEQ)HMXSV

JYRGXMSRW

7XSVIH4VSKVEQ)HMXSV

TEGOEKIWERHTEGOEKIFSHMIW

7XSVIH4VSKVEQ)HMXSV

SFNIGXX]TIWERHSFNIGXX]TIFSHMIW

7XSVIH4VSKVEQ)HMXSV

XVMKKIVW

8VMKKIV)HMXSV

SQL Editor overview


=SYGERIHMXERHI\IGYXI750WXEXIQIRXWERHWGVMTXWGSRXEMRMRKQYPXMTPI
WXEXIQIRXWMRXLI750)HMXSV=SYGERWYFQMXER]750WXEXIQIRXMRGPYHMRK
(10ERH((0WXEXIQIRXW;LIRE7)0)'8WXEXIQIRXMWI\IGYXIHXLIVS[W
VIXYVRIHEVIHMWTPE]IHEWEKVMHERHGERFISYXTYXEWXI\XXSXLI7TSSP
[MRHS[

Chapter 3

The SQL Navigator interface

143

The SQL window and the results display

144

SQL Navigator Users Guide

Code markers

;LIR]SYTPEGIXLIGYVWSVMRWMHIE&)+-2)2(-*)2(-*SV
0334)2(0334FPSGOXLI7502EZMKEXSVGSHIQEVOIVWWLS[]SYXLI
FIKMRERHIRHTSMRXW



The Spool Output window



Chapter 3

The SQL Navigator interface

145

The Stored Program Editor


-R7502EZMKEXSV]SYYWIXLI7XSVIH4VSKVEQ)HMXSVXSHIZIPSTXLIJSPPS[MRK
X]TIWSJ40750TVSKVEQW
 4VSGIHYVIW
 *YRGXMSRW
 3FNIGX8]TIW
 4EGOEKIW
7502EZMKEXSVTVSZMHIWEWITEVEXIIHMXSVJSVHEXEFEWIXVMKKIVW 
=SYGERYWI7502EZMKEXSV
WWYMXISJMRXIKVEXIHHIZIPSTQIRXXSSPWXS
 FVS[WIXLI(&2EZMKEXSVXVII[LMGLHMWTPE]WXLIWXSVIHTVSKVEQW[MXLEPP
HITIRHIRXSFNIGXW
 ZMI[XLIWSYVGIGSHISJEPPTVSKVEQYRMXW
 GSQTMPIXLIGSHI
 WIXMRTYXTEVEQIXIVW
 VYRXLITVSKVEQ
 JM\IVVSVW
 XIWXXLIGSHI
 ZMI[VIWYPXWMRXLISYXTYX[MRHS[
 STXMQM^IXLIGSHI
*SVQSVIMRJSVQEXMSRWII;SVOMRK[MXL40750

146

SQL Navigator Users Guide

Workspaces: A smarter way of working


7502EZMKEXSV
W;SVOWTEGIJIEXYVIKMZIW]SYMRWXERXEGGIWWXS]SYV
JVIUYIRXP]YWIHHEXEFEWISFNIGXWERHGSRRIGXMSRW
;SVOWTEGIWEVI[MRHS[W[LIVI]SYGERWXSVIWLSVXGYXWXSMXIQWXLEX]SY
JVIUYIRXP]RIIHXS[SVO[MXLMRWXIEHSJWIEVGLMRKJSVXLIQMRZEVMSYWPMWXWERH
HMVIGXSVMIW
8LIWIMXIQWGERMRGPYHI
 JMPIW
 HEXEFEWIGSRRIGXMSRW YWIVREQIGSRRIGXMSRWXVMRKW 
 WGLIQEW MRTEVXMGYPEVGSRRIGXMSRW 
 WGLIQESFNIGXW
 GSHIPSGEXMSRFSSOQEVOW[MXLMRWXSVIHTVSKVEQW
 WGLIQESFNIGXXIQTPEXIW
%RI\EQTPISJEWGLIQESFNIGXXIQTPEXIMWER]XEFPIMRXLIWGLIQE
7'388 
=SYGERYWI]SYV[SVOWTEGIXSPSKSRXSXLIHEXEFEWIWMQTP]HSYFPIGPMGOE
GSRRIGXMSRSVSFNIGXMRXLI[SVOWTEGIXSGVIEXIERI[WIWWMSR
You might want to try making your work easier by
creating specialized Workspaces for
All objects and files related to a project
All database connections
Built-in utility packs, procedures, or functions
(such as DBMS_OUTPUT/PIPE/ALERT packages)
Home-grown utility packs

-XMWIEW]XSEHHMXIQWXSXLIGYVVIRX[SVOWTEGI*SVI\EQTPI]SYGERHVEK
7GLIQEWX]TIJSPHIVWWGLIQESFNIGXWERHSXLIVMXIQWMRXSXLI[SVOWTEGIJVSQ
XLI(&2EZMKEXSVXVIIZMI[SVPMWXZMI[XLI*MRH3FNIGXWZMI[SVXLI7IEVGL
7SYVGI'SHI[MRHS[
=SYGEREPWSYWIXLIWIGSQQERHW
 XLI%HH3FNIGXWERH%HH*MPIWGSQQERHWJVSQXLI[SVOWTEGIWLSVXGYX
QIRY
 XLI%HHXS;SVOWTEGIGSQQERHJVSQXLI3FNIGXQIRYSVXLI3FNIGX
XSSPFEV
 XLI%HHXS;SVOWTEGIGSQQERHJVSQXLI(&2EZMKEXSVWLSVXGYXQIRY

Chapter 3

The SQL Navigator interface

147

=SYGEREPWSWIXETVIJIVIRGISEHHSFNIGXWEYXSQEXMGEPP]XSXLI[SVOWTEGI
[LIR]SYSTIRXLIQMREZMWYEPSFNIGXIHMXSV7IIXLI;SVOWTEGIIRXV]YRHIV
4VIJIVIRGIWMRXLI:MI[QIRY
Caution If you save the password when you
create the connection, no password will be
required to open a connection from the
workspace.

To create a workspace
=SYGERGVIEXIQYPXMTPI[SVOWTEGIW3RP]SRI[SVOWTEGIGERFIGYVVIRXXLI
[SVOWTEGIXLEXMWHMWTPE]IHMRXLI[MRHS[MWYWIHEWXLIXEVKIXJSV%HHXS
;SVOWTEGI
 3RXLI7502EZMKEXSVQEMRQIRYFEVGLSSWI*MPIERHXLIRGLSSWI2I[
;SVOWTEGI

148

SQL Navigator Users Guide

The workspace window


=SYGERWIPIGXXLIHMWTPE]JSVQEXJSV;SVOWTEGIMXIQW



Chapter 3

The SQL Navigator interface

149

Managing the Workspace window

0MOIXLISXLIVHSGOEFPI[MRHS[WXLI;SVOWTEGI[MRHS[VIXEMRWMXWWM^IERH
TSWMXMSRFIX[IIRWIWWMSRWQSVISZIVIEGLMRHMZMHYEP[SVOWTEGI[MRHS[
VIXEMRWMXWS[RWIXSJTEVEQIXIVW
8SQEOIXLI;SVOWTEGI[MRHS[HSGOEFPIWIPIGXXLI(SGOEFPISTXMSRJVSQ
XLIWLSVXGYXQIRY



Managing workspaces
Managing workspaces
8LMWKVSYTSJXSTMGWTVSZMHIW,S[8SMRJSVQEXMSRJSVTIVJSVQMRKGSQQSR
[SVOWTEGIVIPEXIHXEWOW
=SYGERYWIXLI,IPT[MRHS[FVS[WIFYXXSRWSVFVS[WIXLIWIXSTMGWMRXLI
'SRXIRXWPMWX

To add an object or file to the current workspace


 'LSSWISRISJXLIJSPPS[MRK
 (VEKSFNIGXWMRXSXLIGYVVIRX[SVOWTEGIJVSQ(&2EZMKEXSV;MRHS[W
)\TPSVIVSVSXLIV[SVOWTEGIW
SV
6MKLXGPMGOERSFNIGXSVJMPIERHGLSSWI%HHXS;SVOWTEGI
You can set a preference to automatically add
objects to a current workspace when a specified
event occurs (such as opening or editing an
object).

150

SQL Navigator Users Guide

Saving connection shortcuts in your Workspace


=SYGERWEZIGSRRIGXMSRWLSVXGYXW YWIVREQIGSRRIGXMSRWXVMRKW MR]SYV
[SVOWTEGI W ERHXLIRWMQTP]HSYFPIGPMGOXSSTIRXLIQ=SYGEREPWSWXSVI
WLSVXGYXWXSSFNIGXWMRXLI[SVOWTEGI;LIR]SYHSYFPIGPMGOXLIMVMGSRWXLI]
[MPPEYXSQEXMGEPP]STIRXLIVIUYMVIHGSRRIGXMSR


7KHZRUNVSDFHZLQGRZFDQLQFOXGHFRQQHFWLRQ

VKRUWFXWV

*SVQSVIMRJSVQEXMSRWII
 8SSTIREGSRRIGXMSRMRXLI[SVOWTEGI
 8SEHHERSFNIGXSVJMPIXSXLIGYVVIRX[SVOWTEGI

To connect to a database from the workspace


=SYGERWIPIGXEHEXEFEWISFNIGXMR]SYV[SVOWTEGIERHIEWMP]STIRMXJSV
ZMI[MRKSVIHMXMRK7502EZMKEXSVEYXSQEXMGEPP]STIRWXLIVIUYMVIHHEXEFEWI
GSRRIGXMSRERHHMWTPE]WXLISFNIGX
WTVSTIVXMIWMRERSFNIGXIHMXMRK[MRHS[
%PXIVREXMZIP]]SYGEREGXMZEXIEHEXEFEWIGSRRIGXMSRERHSTIRE(&
2EZMKEXSV[MRHS[JSVXLEXHEXEFEWI

To open a workspace object for editing


 'LSSWISRISJXLIJSPPS[MRK
 (SYFPIGPMGOXLISFNIGXMGSR
SV
 6MKLXGPMGOXLISFNIGXMGSRERHXLIRGLSSWI3TIR



-J]SYLEZIWEZIH]SYVTEWW[SVH7502EZMKEXSVMQQIHMEXIP]STIRWXLI
SFNIGXJSVIHMXMRK
-J]SYLEZIRSXWEZIH]SYVTEWW[SVHXLI3VEGPI0SKSRHMEPSKMWHMWTPE]IH
JMVWXFIJSVIXLIIHMXMRK[MRHS[

Chapter 3

The SQL Navigator interface

151

2SXIXLEXMJ]SYYWIXLI3TIRGSQQERHSRERMXIQXLEXMWRSXEHEXEFEWI
SFNIGX EGSRRIGXMSRJSVI\EQTPI ]SY[MPPFITVSQTXIHXSWTIGMJ]XLI
HEXEFEWISFNIGX]SY[ERXXSSTIR
-J]SYLEZIWEZIH]SYVTEWW[SVH7502EZMKEXSVMQQIHMEXIP]STIRWXLI
GSRRIGXMSRERHTVSQTXW]SYXSWTIGMJ]XLIHEXEFEWISFNIGX]SY[ERXXSSTIR
-J]SYLEZIRSXWEZIH]SYVTEWW[SVHXLI3VEGPI0SKSRHMEPSKMWHMWTPE]IH
JMVWXFIJSVIXLI7IPIGXE(&3FNIGXHMEPSK

To connect to a database and open a DB Navigator window


1
2

6MKLXGPMGOER]MXIQMRXLI[SVOWTEGIXLEXMWVIPEXIHXSEHEXEFEWIERH
XLIRGLSSWI'SRRIGX%W
-JXLI3VEGPI0SKSRHMEPSKETTIEVWX]TIETEWW[SVH
8LI(&2EZMKEXSV[MRHS[ETTIEVWERHXLIHEXEFEWIGSRRIGXMSRMW
IWXEFPMWLIH
Caution If you save the password when you
create the connection, no password will be
required to open the connection from the
workspace.

To open a workspace
8LI*YRGXMSRWXSSPFEVGSRXEMRWE'YVVIRX;SVOWTEGIGSRXVSPXLEXPIXW]SY
UYMGOP]STIRE[SVOWTEGIERHW[MXGLFIX[IIRHMJJIVIRX[SVOWTEGIW
'PMGOXLI(S[REVVS[XSSTIRXLIPMWX



1
2
3

3RXLI*YRGXMSRWXSSPFEVGPMGOXLIHS[REVVS[XSSTIRXLIPMWXSJ
[SVOWTEGIW
*VSQXLIPMWXWIPIGXXLI[SVOWTEGI]SY[ERXXSYWIEWXLIGYVVIRX
[SVOWTEGI
-JXLI[SVOWTEGI[MRHS[MWRSXZMWMFPIGLSSWI;SVOWTEGI;MRHS[JVSQ
XLI:MI[QIRY

152

SQL Navigator Users Guide

To filter the list of objects in a workspace


1

3RXLI[SVOWTEGIXSSPFEVGPMGOXLI*MPXIVFYXXSR



*VSQXLI;SVOWTEGI*MPXIVPMWXWIPIGXXLISFNIGXX]TIW]SY[ERXXSHMWTPE]
MRXLIGYVVIRX[SVOWTEGI
)EGLMRHMZMHYEP[SVOWTEGI[MRHS[VIXEMRWMXWS[RWIXSJTEVEQIXIVW

To open a workspace object or file


1

'LSSWISRISJXLIJSPPS[MRK
 (SYFPIGPMGOXLISFNIGXMGSR
SV
 6MKLXGPMGOXLISFNIGXMGSRERHXLIRGLSSWI3TIR

2
3

-JTVSQTXIHWTIGMJ]XLIHEXEFEWISFNIGX]SY[ERXXSSTIR
-JTVSQTXIHWYTTP]XLITEWW[SVH7EZIXLITEWW[SVHMJ]SYTVIJIVXSSTIR
XLISFNIGX[MXLSYXTVSZMHMRKXLITEWW[SVHMRJYXYVI

To remove an object or file from a workspace




'LSSWISRISJXLIJSPPS[MRK
 6MKLXGPMGOXLISFNIGXERHXLIRGLSSWI6IQSZI
SV
 7IPIGXXLISFNIGXERHTVIWWXLI(IPIXIOI]

Invoking the Describe command for a workspace object


8LI3VEGPI()7'6-&)GSQQERHVITSVXWXLIEXXVMFYXIWQIXLSHWERH
EVKYQIRXWSJERSFNIGXX]TI8LI7502EZMKEXSV(IWGVMFIGSQQERH[SVOW
[MXLQSVISFNIGXWXLERHSIWXLI750 4PYWZIVWMSRSJXLIGSQQERH=SYGER
HIWGVMFIRSXSRP]TVSGIHYVIWJYRGXMSRWTEGOEKIWW]RSR]QWERHSFNIGXX]TIW
FYXEPWSXEFPIWMRHI\IWGPYWXIVWERHSFNIGXW
=SYGERYWIIMXLIVXLI(IWGVMFIGSQQERHSVXLI%YXS(IWGVMFIJIEXYVIXS
HIWGVMFIERSFNIGXHMWTPE]IHMRXLI(&2EZMKEXSV[MRHS[ SVSXLIVGYVVIRX
[MRHS[ 
%YXS(IWGVMFI;MXLXLI%YXS(IWGVMFIJIEXYVIIREFPIHEHSGOEFPI(IWGVMFI
[MRHS[STIRWERHWXE]WSRXSTSJXLIETTPMGEXMSR[MRHS[%W]SYWIPIGX
ZEVMSYWSFNIGXWMRXLI(&2EZMKEXSVXVII]SY[MPPEYXSQEXMGEPP]WIIE
HIWGVMTXMSRSJXLIWIPIGXIHSFNIGXMRXLI%YXS(IWGVMFI[MRHS[

Chapter 3

The SQL Navigator interface

153

(IWGVMFI=SYGERQERYEPP]MRZSOIXLI(IWGVMFIGSQQERH[LIRIZIVRIIHIH
-XSTIRWEHIWGVMFI[MRHS[JSVEWMRKPIWIPIGXIHSFNIGXERH[MPPRSXYTHEXI
EYXSQEXMGEPP][LIR]SYWIPIGXERSXLIVSFNIGX

To enable the AutoDescribe feature


1
2
3

*VSQXLI:MI[QIRYGLSSWI%YXS(IWGVMFI8SSP
)RWYVIXLEXXLIVIUYMVIHHEXEFEWIGSRRIGXMSRMWEGXMZI
8SZMI[ERSFNIGX
WHIWGVMTXMSRMRXLIHSGOEFPI%YXS(IWGVMFI[MRHS[NYWX
WIPIGXXLISFNIGXMRXLIGYVVIRX[MRHS[

To invoke the Describe command


1
2

)RWYVIXLEXXLIVIUYMVIHHEXEFEWIGSRRIGXMSRMWEGXMZI
(SSRISJXLIJSPPS[MRK
 7IPIGXXLIHEXEFEWISFNIGXERHXLIRJVSQXLI3FNIGXQIRYGLSSWI
(IWGVMFI
SV
 6MKLXGPMGOXLISFNIGXERHGLSSWI(IWGVMFI

-J]SY[ERXXSOIITXLII\MWXMRK(IWGVMFI[MRHS[STIR[LMPISTIRMRK
EHHMXMSREP(IWGVMFI[MRHS[WGPMGOXLI4MRXSSPFEVMGSRMRXLI(IWGVMFI
[MRHS[

To view or update objects in a workspace


 'LSSWISRISJXLIJSPPS[MRK
 -RXLI[SVOWTEGIWIPIGXXLIWLSVXGYXERHGLSSWIEGSQQERHJVSQE
XSSPFEV
SV
 6MKLXGPMGOXLISFNIGXSVJMPIERHXLIRWIPIGXEGSQQERHJVSQXLI
WLSVXGYXQIRY
7502EZMKEXSVEYXSQEXMGEPP]STIRWEHEXEFEWIGSRRIGXMSRERHETTPMIWXLI
EGXMSRXSXLIYRHIVP]MRKHEXEFEWISFNIGX

Context-sensitive commands in workspaces


8LIGSQQERHWEZEMPEFPIMRXLI[SVOWTEGIEVIGSRXI\XWIRWMXMZIQIERMRK
HMJJIVIRXGSQQERHWFIGSQIEZEMPEFPIEWHMJJIVIRXX]TIWSJSFNIGXWEVIWIPIGXIH
EWWLS[RMRXLIJSPPS[MRKXEFPI

154

SQL Navigator Users Guide

To do this

With this object

Use this
command

'VIEXIERI[WIWWMSR

'SRRIGXMSR

'SRRIGX

7GLIQE
8IQTPEXI
7GLIQESFNIGX
&SSOQEVO
3TIRXLI(&2EZMKEXSV[MRHS[
EYXSQEXMGEPP]I\TERHXVIIRSHIW
EWRIGIWWEV]ERHHMWTPE]XLI
HIXEMPWSJXLIGYVVIRXSFNIGX

7GLIQE

3TIRXLIJMPIMRXLI750)HMXSV

*MPI

3TIR

3TIRXLISFNIGXMRE:MWYEP3FNIGX
)HMXSV

(EXEFEWISFNIGX

3TIR

(MWTPE]XLI7IPIGX(&3FNIGX
HMEPSKERHXLIRSTIRXLIWIPIGXIH
SFNIGXMREZMWYEPSFNIGXIHMXSV

'SRRIGXMSR
7GLIQE

3TIR

3TIRXLI'SHI)HMXSVERHWIXXLI
XI\XGYVWSVEXXLIETTVSTVMEXIPMRI

'SHIPSGEXMSR

3TIR

7LS[XLISFNIGXHIWGVMTXMSRMRXLI
(IWGVMFI[MRHS[

7GLIQESFNIGX

(IWGVMFI

3TIRXLI5YIV]6IWYPXW[MRHS[
JSVFVS[WMRK

8EFPI

&VS[WI(EXE

0SGEXI

8IQTPEXI
7GLIQESFNIGX
&SSOQEVO

8IQTPEXI

:MI[
4EVXMXMSR

3TIRVIGSVHWMRE5YIV]6IWYPXW
[MRHS[JSVIHMXMRK

8EFPI

)HMX(EXE

)\IGYXIXLIWGVMTX

*MPI WGVMTX 

)\IGYXI

3TIRXLISFNIGXMRXLII\IGYXMSR
[M^EVH

4VSGIHYVI

)\IGYXI

4EVXMXMSR

*YRGXMSR
4EGOEKI

6IQSZIXLIMXIQJVSQXLI
%R][SVOWTEGIMXIQ
[SVOWTEGI RSXJVSQXLIHEXEFEWI 

6IQSZI

1EOIEPPMXIQWSJXLIWEQIX]TI
MRZMWMFPI

,MHIXLMWMXIQ
X]TI

%R][SVOWTEGIMXIQ

Chapter 3

The SQL Navigator interface

155

Connecting to the Oracle database


Connecting using Net8
7502EZMKEXSVGERYWIIMXLIV750 2IXSV2IXXSGSRRIGXXSEHEXEFEWI
,S[IZIVEGSRJPMGXQE]SGGYVMJFSXL750 2IXERH2IXEVIMRWXEPPIHSRXLI
GPMIRX[SVOWXEXMSR

Connecting Using Connect Strings


7502EZMKEXSVGERGSRRIGXXSEPSGEPHEXEFEWIERHXSVIQSXIHEXEFEWIWYWMRK
750 2IXZIVWMSRSVLMKLIV
8LIGSRRIGXWXVMRKMWYRMUYIXSIEGLGSQTYXIVPSGEPSVVIQSXIERHXSXLI
750 2IXZIVWMSRMRWXEPPIHSR]SYVGPMIRX4' WYGLEW750 2IX:IVWMSRSV
LMKLIV 
*SVI\EQTPIJSVXLIPSGEPHEXEFEWIYRHIV4IVWSREP3VEGPIJSV;MRHS[W
ERH;MRHS[W28XLIGSRRIGXWXVMRKMWSVFPERO

Examples of Connect Strings for SQL*Net 1


t:Seattle:PRODN
x:server1
d:boston:devp

Example of a Connect String for SQL*Net 2


Prodn1
SQL*Net 2.x connect strings (also called service
names) are defined in the file tnsnames.ora,
usually located in the c:\orawin95\network\admin
directory for Windows 95 and in the
c:\orant\network\admin directory for Windows NT.
To modify these connect strings use only the
Oracle SQL*Net Easy Configuration Utility.

156

SQL Navigator Users Guide

There are many communication protocols and


configurations available for SQL*Net. For more
information, refer to any of the following
resources:

SQL*Net Administrators Guide


SQL*Net Users Guide
Your companys DBA or system administrator

Connecting using command line parameters


'SRRIGXMSRHIXEMPWGERFITEWWIHZMEGSQQERHPMRITEVEQIXIVW
8SGSRRIGXXSXLIHEXEFEWIMQQIHMEXIP]SRWXEVXYTERHF]TEWWXLI'SRRIGXXS
(EXEFEWIHMEPSKTEWWXLITEVEQIXIV
'322)'8!YWIVREQITEWW[SVH$GSRRIGXCWXVMRK
MRXLIGSQQERHPMRI[LIRWXEVXMRK7502EZMKEXSV
-REHHMXMSREOI]TEVEQIXIV)<)'GERFITEWWIHEPSRK[MXLXLIJMPIREQIMR
XLIGSQQERHPMRIXSJSVGII\IGYXMSRSJXLIWGVMTX

Connecting to Personal Oracle


-J]SYEVIGSRRIGXMRKXS4IVWSREP3VEGPIJSV;MRHS[W]SYQYWXYWIE8'4
PSSTFEGOGSRRIGXMSRMRSVHIVXSYWIXLI40750(IFYKKIV%HIJEYPX8'4
PSSTFEGOGSRRIGXMSRMWGVIEXIHF]750 2IX=SYGERZMI[SVQSHMJ]MXYWMRK
XLI750 2IX)EW]'SRJMKYVEXMSR9XMPMX]JVSQ3VEGPI

Connecting to a database from the SQL Editor


8SI\IGYXIE750WXEXIQIRXSVWGVMTX[MXLMR750)HMXSV]SYQYWXJMVWXFI
GSRRIGXIHXSXLIVIPIZERXHEXEFEWI
-XMWTSWWMFPIXSGSRRIGXERHHMWGSRRIGXHEXEFEWIWJVSQ[MXLMRXLI750)HMXSV
YWMRK750 4PYWGSQQERHW

To connect to a database via the SQL Editor


 'PMGOXLI750XEFERHXLIRX]TIERHI\IGYXIE'322)'8WXEXIQIRXYWMRK
XLIJSPPS[MRK750 4PYWJSVQEX

Connect name/password@database

Chapter 3

The SQL Navigator interface

157

To disconnect from a database via the SQL Editor


 'PMGOXLI750XEFERHXLIRX]TIERHI\IGYXIE(-7'322)'8WXEXIQIRX
YWMRKXLIJSPPS[MRK750 4PYWJSVQEX

Disconnect name/password@database
-J]SYX]TIERHI\IGYXIXLI(-7'322)'8WXEXIQIRX[MXLSYXWTIGMJ]MRKER]
HEXEFEWIHIXEMPWXLIGYVVIRXWIWWMSR]SYEVIYWMRK[MPPFIHMWGSRRIGXIH
3XLIV750 4PYWGSQQERHWXLEXGERFIYWIH[MXLMRXLI750)HMXSVEVI
()7'6-&))<)'98)ERH6)1%6/

To close a connection
 'LSSWI7IWWMSR 'PSWI 

To activate another session in another window


 7IPIGXERSXLIVXEWOJVSQXLI8EWO&EVSVW[MXGLXSERSXLIVWIWWMSRERH
XLIRGPMGOEFYXXSRSVQIRYMXIQXSSTIRERI[[MRHS[ 

Oracle Logon


'PMGOXLIHVSTHS[RFYXXSRXSTMGOJVSQE
PMWXSJEZEMPEFPIHEXEFEWIGSRRIGXMSRW

;LIR]SYWXEVX7502EZMKEXSVSVMRZSOIXLI2I[7IWWMSRGSQQERHXLI
3VEGPI0SKSRHMEPSK WLS[REFSZI TVSQTXW]SYJSVGSRRIGXMSRMRJSVQEXMSR
=SYGERGPMGOXLIHVSTHS[RFYXXSRMRXLI(EXEFEWIFS\JSVEPMWXSJEZEMPEFPI
HEXEFEWIGSRRIGXMSRW
The Logon dialog on startup is controlled by a Preferences
option. See page 422, Show Logon Dialog at startup

158

SQL Navigator Users Guide

Automatically saving passwords


8LI3VEGPI0SKSRHMEPSKKMZIW]SYXLISTXMSRSJWEZMRKETEWW[SVHJSVIEGL
YWIVREQIHEXEFEWIGSQFMREXMSR
=SYVTEWW[SVHMWWEZIHMRIRGV]TXIHJSVQEXERHXLIRVIGEPPIHEYXSQEXMGEPP]
[LIR]SYRI\XIRXIVXLIWEQIYWIVREQIHEXEFEWIGSQFMREXMSR
8LIYWIVREQIJMIPHEYXSQEXMGEPP]VIGEPPWYWIVREQITEWW[SVHWGSQFMREXMSRW
FEWIHSRXLIJMVWXPIXXIV W IRXIVIHMRXSXLIJMIPH

Creating a session
;LIR]SYJMVWXWXEVXYT7502EZMKEXSV]SYGVIEXIEHEXEFEWIGSRRIGXMSR=SY
GERWIXYTQYPXMTPIWIWWMSRW[MXLSRIHEXEFEWISV[MXLQER]HEXEFEWIW)EGL
HEXEFEWIGSRRIGXMSRMWORS[REWER3VEGPIMRWXERGI
8LIQSWXVIGIRXP]YWIHGSRRIGXMSRWLS[WEWXLIHIJEYPXGSRRIGXMSR750
2EZMKEXSVWEZIWXLIGSRRIGXMSRTVSJMPIW]SYIRXIVXSEPMWXSJGSRRIGXMSRW
)EGLWIWWMSRVIPEXIH[MRHS[ GSHIIHMXSVSFNIGXIHMXSVERHWSSR VIQIQFIVW
ERHEYXSQEXMGEPP]STIRWMRXLIETTVSTVMEXIHEXEFEWIWIWWMSR
-RXLMWZIVWMSRSJ7502EZMKEXSV]SYGERJVIIP]W[MXGLXSSXLIVWIWWMSRWERH
GSRXMRYI[SVOMRK[MXLMRXLIWEQI[MRHS[
8SEGXMZEXIERSXLIV[MRHS[JSVERSXLIVWIWWMSRWIPIGXXLISXLIV[MRHS[JVSQ
XLI8EWO&EVSVW[MXGLWIWWMSRWERHXLIRGPMGOEFYXXSRSVQIRYMXIQXSSTIR
ERI[[MRHS[

Switching between sessions


;LIR]SYSTIRERSFNIGXMXEYXSQEXMGEPP]STIRWMRXLIETTVSTVMEXIHEXEFEWI
WIWWMSR
;LIRYWMRKXLI750)HMXSV]SYGERJVIIP]W[MXGLXSSXLIVWIWWMSRWERH
GSRXMRYI[SVOMRK[MXLMRXLIWEQI[MRHS[[MXLXLIWEQIWGVMTX8LMWJIEXYVI
IREFPIW]SYXSVYRXLIWEQIWGVMTXEKEMRWXHMJJIVIRXHEXEFEWIW[MXLSYXXLIRIIH
XSGST]MXMRXSERSXLIVMRWXERGISJ750)HMXSV-XEPWSEPPS[W]SYXSUYMGOP]
GSVVIGXXLISZIVWMKLXSJSTIRMRKEJMPIMRXSXLI[VSRKWIWWMSR

Chapter 3

The SQL Navigator interface

159

Choosing from the list of current sessions



To switch sessions or create a new session



Use the drop-down
list on the Session
Toolbar to switch
sessions.
Alternatively, you
can click the New
Session icon to
open a new one.

Fast access to connections stored in your Workspace


=SYGERWEZIGSRRIGXMSRWLSVXGYXW YWIVREQIGSRRIGXMSRWXVMRKW MR]SYV
[SVOWTEGI W ERHXLIRWMQTP]HSYFPIGPMGOXSSTIRXLIQ=SYGEREPWSWXSVI
WLSVXGYXWXSSFNIGXWMRXLI[SVOWTEGI;LIR]SYHSYFPIGPMGOXLIMVMGSRWXLI]
[MPPEYXSQEXMGEPP]STIRXLIVIUYMVIHGSRRIGXMSR

160

SQL Navigator Users Guide

The workspace window can include


connection shortcuts

Troubleshooting Connections to Oracle


Message

Solution

(MVIGXSV]RSXMRTEXL

)RWYVIXLEXXLI3VEGPIFMRHMVIGXSV]MWWTIGMJMIHMRXLITEXL&]HIJEYPX3VEGPI
WFMR
HMVIGXSV]MWG@SVE[MR@FMRYRHIV;MRHS[WERHG@SVERX@FMRYRHIV;MRHS[W
28
)RXIVXLITEXLGSQQERHMRXLI(37TVSQTXXSGLIGOXLITEXL-JXLIHMVIGXSV]MWRSX
MRXLITEXLEHHMXXSXLITEXLMREYXSI\IGFEXERHVIFSSXXLIW]WXIQ

3VEGPI6IUYMVIH
7YTTSVX*MPIWRSX
MRWXEPPIH

)RWYVIXLEXEXPIEWXSRISJXLIFMX3VEGPI6IUYMVIH7YTTSVX*MPIWEVIMRWXEPPIH
8LIWIJMPIWEVIMRWXEPPIHF]HIJEYPX[LIR]SYMRWXEPPER]SJXLIFMX3VEGPITVSHYGXW
WYGLEW750 2IXERH750 4PYW
8SZIVMJ][LIXLIVXLI6IUYMVIH7YTTSVX*MPIWEVIMRWXEPPIHWXEVXXLI3VEGPIMRWXEPPIV
%PPMRWXEPPIHGSQTSRIRXWEVIPMWXIHMRXLIVMKLXWMHISJXLIHMEPSKFS\-JXLI6IUYMVIH
7YTTSVX*MPIWHSRSXETTIEVSRXLIVMKLXLERHWMHIPMWXFS\MRWXEPPXLIWIJMPIWJVSQ
3VEGPIWSJX[EVIQIHME

'SRRIGXWXVMRKWJSV
PSGEPERHVIQSXI
HEXEFEWI

-J]SYEVIGSRRIGXMRKXSEPSGEPHEXEFEWIYWI SVEFPERO EWXLIGSRRIGXWXVMRK-J


]SYEVIGSRRIGXMRKXSEVIQSXIHEXEFEWI
w )RWYVIXLEXXLIFMX750 2IXGPMIRXMWMRWXEPPIH
w )RWYVIXLEXXLIJMPIXRWREQIWSVELEWFIIRTVSTIVP]GSRJMKYVIHYWMRKXLI
750 2IX)EW]'SRJMKYVEXMSR
w )RWYVIXLEXTVSTIVRIX[SVOGSRRIGXMZMX]MWEZEMPEFPIXSXLIVIQSXIGSQTYXIV
9WIXLI8274-2+9XMPMX]JVSQ3VEGPI%GGIWW(37ERHIRXIVXRWTMRK MRWXERGI
REQI"-JGSVVIGXP]GSRJMKYVIH750 2IXVIWTSRHW[MXL3/QIWWEKIWERH
QIEWYVIHVIWTSRWIXMQIW
w )RWYVIXLEXXLI750 2IXPMWXIRIVETTPMGEXMSRMWVYRRMRKSRXLIVIQSXI
GSQTYXIV

Chapter 3

The SQL Navigator interface

161

Viewing server output


Viewing server output
=SYGERZMI[EPPWIVZIVQIWWEKIWMRER3YXTYX[MRHS[
8LI3YXTYX[MRHS[LEWXEFFIHTEKIWJSVSYXTYXJVSQHMJJIVIRXWIWWMSRWTPYW
SRITEKIJSVKIRIVEPQIWWEKIWRSXVIPEXIHXSETEVXMGYPEVWIWWMSR
3YXTYXPMRIWSJHMJJIVIRXX]TIW MRJSVQEXMSRIVVSVWWIVZIVSYXTYX EVI
HMWXMRKYMWLIHF]HMJJIVIRXJSRXGSPSVW%HHMXMSREPP]XLI]EVIQEVOIHF]
HMJJIVIRXMGSRWXSQEOIXLIQIZIRQSVIRSXMGIEFPI
8SQEOIXLI[MRHS[HSGOEFPIWIPIGXXLI(SGOEFPISTXMSRJVSQXLIWLSVXGYX
QIRY;LIRXLI(SGOEFPISTXMSRMWWIPIGXIHXLI[MRHS[VIQEMRWZMWMFPI SR
XST [LIRSXLIV[MRHS[WEVISTIRIH;LIRXLI(SGOEFPISTXMSRMWRSX
WIPIGXIHMXMWERSVQEP1(-[MRHS[XLEXGERFILMHHIRFILMRHXLIGYVVIRX
[MRHS[;LIRQSZMRKEHSGOEFPI[MRHS[]SYGERTVIZIRXMXJVSQHSGOMRK
F]LSPHMRKXLI'XVPOI]HS[R

Interpreting the output display


8LI3YXTYX[MRHS[HMWTPE]WTVSGIWWSVERHWIVZIVSYXTYXMRXLIJSPPS[MRK
GSPSVWGLIQI
Color

Data type

&PYI

7IVZIVSYXTYX

6IH

)VVSV1IWWEKIW

&PEGO

3XLIVTVSGIWWMRKQIWWEKIW

To display the Output window






 'LSSWISRISJXLIJSPPS[MRK
*VSQXLI:MI[QIRYGLSSWI3YXTYX;MRHS[
SV
3RXLI*YRGXMSRWXSSPFEVGPMGO



162

SQL Navigator Users Guide

=SYGERQSZIHSGOERHYRHSGOXLI3YXTYX[MRHS[XSSTXMQM^I]SYV
[SVOWTEGI
8SQEOIXLI[MRHS[HSGOEFPIWIPIGXXLI(SGOEFPISTXMSRJVSQXLIWLSVXGYX
QIRY;LIRXLI(SGOEFPISTXMSRMWWIPIGXIHXLI[MRHS[VIQEMRWZMWMFPI SR
XST [LIRSXLIV[MRHS[WEVISTIRIH;LIRXLI(SGOEFPISTXMSRMWRSX
WIPIGXIHMXMWERSVQEP1(-[MRHS[XLEXGERFILMHHIRFILMRHXLIGYVVIRX
[MRHS[

To change size of the buffer for server output


1

-RXLI:MI[QIRYGLSSWI4VIJIVIRGIW"+IRIVEP

2
3

'PMGO7IWWMSR
)RXIVXLIHIWMVIHYTTIVPMQMXJSVXLI(&173YXTYX&YJJIV &]XIW 

To print Output window contents


 4VIWW'XVP4

To copy and paste selected text from the Output window


1
2

8SGST]XI\XWIPIGXMXXLI3YXTYX[MRHS[XLIRTVIWW'XVP'8LMWTPEGIW
XLIWIPIGXIHXI\XSRXLIGPMTFSEVH
8STEWXIGSTMIHXI\XTPEGIXLIGYVWSVEXXLIHIWXMREXMSRERHTVIWW'XVP:

The Oracle Job Manager


Managing jobs
*VSQ7502EZMKEXSV]SYGEREGGIWWXLI3VEGPI(&17.3&7WGLIHYPIVXS
GLIGOXLIWXEXYWERHWIXXMRKWSJI\MWXMRKNSFWERHEHHIHMXERHVIQSZINSFW
-RSVHIVXSWYGGIWWJYPP]YWIXLI.SF1EREKIVJIEXYVI]SYQE]RIIHXSEHNYWX
XLIWIXXMRKWSR]SYVWIVZIVMRXLI-2-836%GSRJMKYVEXMSRJMPIXSEPPS[YWISJ
XLI(&17C.3&7TEGOEKI
8LIJSPPS[MRKWIXXMRKWEVIVIGSQQIRHIH
 NSFCUYIYICTVSGIWWIW!
 NSFCUYIYICMRXIVZEP!
 NSFCUYIYICOIITCGSRRIGXMSRW!JEPWI
6IQIQFIVXSVIWXEVX]SYVWIVZIVFIJSVIXLIWIWIXXMRKWXEOIIJJIGX 
3VEGPINSFWEVIFEXGLIWSJ750WGVMTXWVIEH]JSVVYRRMRK=SYGERWGLIHYPI
NSFWXSVYREXVIKYPEVXMQIWSV]SYGERTVIIQTXENSFWGLIHYPIERHVYRENSF

Chapter 3

The SQL Navigator interface

163

MQQIHMEXIP]8SWGLIHYPIENSF]SYWYFQMXMXXSXLINSFUYIYIERHWTIGMJ]XLI
JVIUYIRG]EX[LMGLXLINSFMWXSFIVYR=SYGEREPWSEPXIVHMWEFPISVHIPIXI
NSFW]SYLEZIWYFQMXXIH

To view job properties


1
2

*VSQXLI8SSPWQIRYGLSSWI.SF1EREKIV
-RXLI3VEGPI.SF1EREKIVPMWXZMI[XLIHIXEMPWJSVEPPNSFW 7II.SF
4VSTIVXMIWPMWX JSVJMIPHHIWGVMTXMSRW 

Oracle Job Manager job properties


Control Tab
Field

Description

2I\XHEXI

8LIRI\XHEXIXLINSF[MPPFIVYR8LIHIJEYPXZEPYIMW
7=7(%8)

6YRTIVMSHMGEPP]

8LIJVIUYIRG][MXL[LMGLXLINSFVYRW

&VSOIR

-JWIPIGXIHNSFMWHMWEFPIH
=SYGERHMWEFPISRP]NSFWXLEX]SYS[R-J]SYXV]XS
QEVOENSF]SYHSRSXS[RXLI.SF1EREKIVHMWTPE]W
EQIWWEKIWXEXMRKXLEXXLINSFMWRSXMRXLINSFUYIYI


.SF

8LIMHIRXMJMIVEWWMKRIHXSXLINSF

7XEXYW

8LIGYVVIRXWXEXYWSJXLINSF

0SKSRYWIV

0SKSR-(SJXLIYWIVXLEXS[RWXLINSF

7XEVXXMQI

(MWTPE]WXLIXMQIXLINSFWXEVXIH


Advanced tab
Field

Description

7IVMEPRYQFIV

7IVMEPRYQFIVSJXLIGYVVIRXWIWWMSR
(MWTPE]IH[LIRENSFMWVYRRMRK

*EMPYVIW

2YQFIVSJXMQIWENSFLEWJEMPIH
I\IGYXMSR

4VMZMPIKIYWIV

9WIVXLEXLEWTVMZMPIKIXSQERMTYPEXI
NSFW

164

SQL Navigator Users Guide

7GLIQEYWIV

7GLIQE[LIVINSFMWPSGEXIH

1MRYXIW

2YQFIVSJQMRYXIWFIX[IIRGYVVIRX
3VEGPIHEXIERHXLIXMQINSFMW
WGLIHYPIHXSVYR

1MRYXIW[EMXIH

8MQIXMPPXLIRI\XNSFMWVYR

4EVWI

7IPIGXXLMWSTXMSRXSGLIGOXLEXXLI
40750GSHILEWRSIVVSVW

To delete a job from the queue


1
2

*VSQXLI8SSPWQIRYGLSSWI.SF1EREKIV
3VEGPI.SF1EREKIV[MRHS[WIPIGXENSFJVSQXLIPMWXERHXLIRGPMGO

(IPIXI.SFXSSPFEVFYXXSR
XLI
;LIRTVSQTXIHGSRJMVQXLEX]SY[ERXXSHIPIXIXLINSF

To disable a job
You can disable only jobs that you own. If you try
to mark a job you do not own, the Job Manager
displays a message stating that the job is not in
the job queue.

*VSQXLI8SSPWQIRYGLSSWI.SF1EREKIV

-RXLI3VEGPI.SF1EREKIVPMWXHSYFPIGPMGOXLINSF]SY[ERXXSHMWEFPI

%PXIVREXMZIP]]SYGERWIPIGXXLINSFERHXLIRGPMGOXLI
4VSTIVXMIWFYXXSR
-RXLI3VEGPI.SF4VSTIVXMIWHMEPSKFS\WIPIGX&VSOIR

)HMX.SF

'PMGO3/2SXIXLEXXLINSFMGSRGLERKIWXSKVIIR[MXLEVIHGMVGPI
MRHMGEXMRKXLEXXLINSFWXEXYWMW&VSOIR

To edit or create a job


1

*VSQXLI8SSPWQIRYGLSSWI.SF1EREKIV

8SGVIEXIERI[NSFMRXLI3VEGPI.SF1EREKIVXSSPFEVGPMGOXLI
2I[.SFFYXXSR
8SIHMXENSFMRXLI3VEGPI.SF1EREKIVPMWXHSYFPIGPMGOXLINSF

%PXIVREXMZIP]]SYGERWIPIGXXLINSFERHXLIRGPMGOXLI
4VSTIVXMIWFYXXSR

)HMX.SF

Chapter 3

The SQL Navigator interface

1
2

3
4

165

-RXLI3VEGPI.SFTVSTIVXMIWHMEPSKFS\GPMGOXLI'SRXVSPXEFERHWTIGMJ]
XLIVIUYMVIHSTXMSRW WII.SF4VSTIVXMIWPMWX 
8SWTIGMJ]XLI40750GSHIJSVXLINSFGPMGOXLI40750XEFERHIRXIV
XLI40750GSHI=SYGERYWIXLI3TIRFYXXSRXSWIEVGLJSVERI\MWXMRK
WGVMTXSVXLI2I[FYXXSRXSGVIEXIERI[40750WGVMTX
8SWTIGMJ]EHHMXMSREPTVSTIVXMIWGPMGOXLI%HZERGIHXEF
8SWYFQMXXLINSFXS(&17C.3&7GPMGO3/

To run a job
1
2

*VSQXLI8SSPWQIRYGLSSWI.SF1EREKIV
3VEGPI.SF1EREKIV[MRHS[WIPIGXENSFJVSQXLIPMWXERHXLIRGPMGOXLI
6YRXSSPFEVFYXXSR

4
Navigating the database

8LMWGLETXIVI\TPEMRWLS[XSZMI[ERHEGGIWWEPPXLISFNIGXWMR]SYV3VEGPI
HEXEFEWIYWMRKXLI(&2EZMKEXSVELMIVEVGLMGEPZMI[[MXLTS[IVJYPJIEXYVIW

In this chapter
Navigating the database
The DB Navigator window
DB Navigator commands
Working with objects in the DB Navigator
DB Navigator drag-and-drop tips

168
168
170
172
180

168

SQL Navigator Users Guide

Navigating the database


9WIXLI(&2EZMKEXSV[MRHS[JSVJEWXERHTS[IVJYPHEXEFEWIFVS[WMRKERH
HVMPPHS[R(&2EZMKEXSVGSQFMRIWXLIEHZERXEKIWSJXLI;MRHS[W)\TPSVIV
ERHE;IFFVS[WIV
(&2EZMKEXSVHMWTPE]WEPPX]TIWSJ3VEGPIERHMSFNIGXWKMZMRK]SYE
LMIVEVGLMGEPZMI[SJER]WGLIQEMRGPYHMRKHITIRHERXSFNIGXW8LIXVIIZMI[
MRGPYHIWRSHIWJSV1]7GLIQE3XLIV7GLIQEWERH'YVVIRX-RWXERGI
-RXLI(&2EZMKEXSV[MRHS[]SYGERHSEPPXLMWERHQSVI
 :MI[PMWXWSJSFNIGXWGSRXEMRIHEXER]LMIVEVGLMGEPPIZIPSJEWGLIQE
 :MI[SVLMHIHIXEMPW EPPTVSTIVXMIW SJXLIPMWXIHSFNIGXW
 &VS[WISVIHMXXLIHEXEWXSVIHMRXEFPIW
 4IVJSVQSTIVEXMSRW WYGLEW)\XVEGX((0 SRWMRKPISVQYPXMTPIWIPIGXIH
SFNIGXW
 9WIJMPXIVWXSHIJMRITVIJIVIRGIWJSVZMI[MRKHEXEFEWISFNIGXW
 ;LIRETVSTIVX]MWEVIJIVIRGIXSERSXLIVHEXEFEWISFNIGX JSVI\EQTPIXLI
FEWIXEFPIJSVERMRHI\SVW]RSR]QkWFEWISFNIGX GPMGOSRXLIVIJIVIRGIMR
XLI:EPYIGSPYQRXSNYQTXSXLIVIJIVIRGIHSFNIGXkWRSHIERHHMWTPE]MXW
TVSTIVXMIW

The DB Navigator window


A hierarchical view of the database
(&2EZMKEXSVPIXW]SYZMI[HEXEFEWISFNIGXWMREX[STERI[MRHS[EXVII
ZMI[SRXLIPIJXERHEPMWXZMI[SRXLIVMKLX
;LIR]SYWIPIGXE7GLIQERSHISV3FNIGX8]TIRSHI JSVI\EQTPI8EFPISV
-RHI\ MRXLIPIJXTERIXLIVMKLXTERIWLS[WEPMWXSJSFNIGXWGSRXEMRIHMRXLEX
RSHI
8LMWPMWXEPPS[WJSVWIPIGXMSRSJQYPXMTPISFNIGXWJSVFEXGLSTIVEXMSRWPMOI(VST
)\XVEGX((0SV'SQTMPI
8LMWPMWXEPPS[WJSVWIPIGXMSRSJQYPXMTPISFNIGXWJSVFEXGLSTIVEXMSRWPMOI(VST
)\XVEGX((0SV'SQTMPI
;LIR]SYWIPIGXEWTIGMJMGSFNIGXMRXLIPIJXTERIXLIPMWXZMI[TERIWLS[W]SY
EPMWXSJXLIEXXVMFYXIWSJXLISFNIGX]SYWIPIGXIH

Chapter 4

Navigating the database

169

To show or hide the DB Navigator details pane


 'PMGO
SRXLI(&2EZMKEXSVXSSPFEV
3V
 6MKLXGPMGOMRXLI(&2EZMKEXSV[MRHS[ERHGLSSWI:MI[ 7LS[,MHI
(IXEMPWJVSQXLIWLSVXGYXQIRY

170

SQL Navigator Users Guide

Interpreting the DB Navigator display


This symbol

Indicates that
8LIRSHIGERFII\TERHIH



+VE]IHXI\X 


8LIRSHIGERFIGSPPETWIH



8LIHEXEFEWISFNIGXEXXLEXRSHIMW
HMWEFPIHSVSJJPMRI
8LIHEXEFEWISFNIGXEXXLEXRSHIMW
MRZEPMH

DB Navigator commands
DB Navigator toolbar commands
;LIR]SYWIPIGXERSFNIGXMRXLI(&2EZMKEXSV[MRHS[]SYGERSTIVEXISR
XLISFNIGXF]GPMGOMRKXSSPFEVMGSRWSVGLSSWMRKGSQQERHWJVSQXLI(&
2EZMKEXSV[MRHS[XSSPFEVSVJVSQSXLIVXSSPFEVWERHQIRYWJSVI\EQTPI
XLI3FNIGXQIRY

Using the (Forward) and (Back) buttons


8LI*SV[EVHERH&EGOFYXXSRWMRXLMWZIVWMSRSJ7502EZMKEXSVEVIMRWSQI
[E]WWMQMPEVXSXLIJSV[EVHERHFEGOFYXXSRWMRER,810FVS[WIVFYXXLI
(&2EZMKEXSVZIVWMSRWEVIEPWSHEXEFEWIE[EVI8LI]PIX]SYREZMKEXIFIX[IIR
L]TIVPMROIHHEXEFEWISFNIGXWERHXLIMVHITIRHIRXSFNIGXWERHGSQTSRIRXW
=SYGERYWIXLIQXSUYMGOP]QSZIFIX[IIR
 %RSFNIGXERHMXWHITIRHIRGMIWERHZMGIZIVWE
 %RMRHI\SVXVMKKIVERHXLIXEFPIXS[LMGLMXVIJIVWERHZMGIZIVWE
 %GSPPIGXSVX]TIERHXLIFEWIX]TISJXEFPIMXMWVIPEXIHXS
 %W]RSR]QERHMXWFEWISFNIGX
=SYGEREPWSYWIXLI*SV[EVHERH&EGOFYXXSRWMRGSRNYRGXMSR[MXLXLI

1SZI9T FYXXSR3RGI]SYGPMGOXLI1SZI9TFYXXSRXSGLERKILMIVEVGL]
PIZIPWMRXLI(&2EZMKEXSVXVII]SYGERXLIRYWIXLI&EGOFYXXSRXSVIXYVRXS
XLIPIZIP[LIVI]SYJMVWXYWIH1SZI9T7YFWIUYIRXP]]SYGERYWIXLI
*SV[EVHERH&EGOFYXXSRWXSVIXVEGI]SYVWXITW

Chapter 4

Navigating the database

171

To show or hide details about the selected DB Navigator node


 'PMGO
XSSPFEV

XLI7LS[,MHI(IXEMPWFYXXSRSRXLI(&2EZMKEXSV

To move around in the Navigator window


 9WIXLIQSYWISVXLIOI]FSEVH%VVS[OI]W=SYGEREPWSYWIXLI4EKI9T
ERH4EKI(S[ROI]WXSWGVSPPQYPXMTPIPMRIW 

To expand a node in the DB Navigator


 'PMGOXLIWMKRSVHSYFPIGPMGOEGSPPETWIHRSHI
%PXIVREXMZIP]TVIWWXLIVMKLXEVVS[OI]SVXLIWTEGIFEV[LMPIXLIRSHIMW
WIPIGXIH 

To collapse a node in the DB Navigator


 -RXLI(&2EZMKEXSVGPMGOXLIrWMKRSVHSYFPIGPMGOERI\TERHIHRSHI
%PXIVREXMZIP]TVIWWXLIPIJXEVVS[OI][LMPIXLIRSHIMWWIPIGXIH 

To expand the selected DB Navigator node and all its


descendants
 'LSSWIXLI*YPP])\TERH2SHIJVSQ(EXEFEWIFYXXSR

To refresh the entire DB Navigator tree from the database


 'LSSWIXLI6IJVIWLFYXXSRMRXLI(&2EZMKEXSVXSSPFEVSVXLI6IJVIWL
GSQQERHMRXLIWLSVXGYXQIRY

172

SQL Navigator Users Guide

Working with objects in the DB Navigator


Finding and opening objects in the DB Navigator
8LI*MRH3FNIGXWHMEPSKLIPTW]SYUYMGOP]JMRHSFNIGXWMRER]WGLIQE8LMW
QIXLSHMWSJXIRJEWXIVERHIEWMIVXLERQERYEPP]WIEVGLMRKXLI(&2EZMKEXSV
XVIIZMI[

To display a dynamic list of all objects in a schema


1
2

-RXLIXSTPIZIPSJXLI(&2EZMKEXSVXVIIWIPIGXEWGLIQERSHI
*VSQXLI7IEVGLQIRYGLSSWI*MRH3FNIGXW

;LIRXLI*MRH3FNIGXWHMEPSKETTIEVWGPMGO7IEVGL%PXIVREXMZIP]]SYGER
VIJMRI]SYVWIEVGLF]2EQIQEWOX]TIWXEXYWERHHEXIQSHMJMIH SVER]
GSQFMREXMSR 
;LIRXLIPMWXSJSFNIGXWETTIEVW]SYGER
7SVXXLIPMWXF]GPMGOMRKGSPYQRLIEHIVW

3TIRERSFNIGXF]HSYFPIGPMGOMRK
4IVJSVQSXLIVEGXMSRWSRXLISFNIGXF]VMKLXGPMGOMRKERHWIPIGXMRKE
GSQQERHJVSQXLIWLSVXGYXQIRY

Opening an object from the DB Navigator


8SSTIRERSFNIGXJSVIHMXMRKWMQTP]HSYFPIGPMGOXLISFNIGXMRXLIPIJXSVVMKLX
TERISJXLI(&2EZMKEXSV

Locating an object in the schema from an editor


;LIRERSFNIGXMWSTIRMREREGXMZI[MRHS[ ERIHMXMRK[MRHS[JSVI\EQTPI 
SVWIPIGXIHMRXLI(&2EZMKEXSVERH]SY[ERXXSWII[LIVIXLEXSFNIGXVIWMHIW
MRXLIWGLIQE]SYGERYWIXLI0SGEXIMR7GLIQEGSQQERHXSNYQTXSXLEX
SFNIGX
WRSHIMRXLI(&2EZMKEXSVXVIII\TERHMRKEPPMRXIVQIHMEXIRSHIWERH
STIRMRKXLISFNIGX
WHIXEMPW

To locate an open or selected object in the schema


 *VSQXLI3FNIGXQIRYGLSSWI0SGEXIMR7GLIQE

Chapter 4

Navigating the database

173

You can hide the right pane to save screen space


or increase the speed of the display.
Click
(the Show/Hide Details button)
on the DB Navigator toolbar
Or
Right-click in the DB Navigator window and
choose View Show/Hide Details from the
shortcut menu.

Using filters to customize the display of objects


=SYGERHIJMRIJMPXIVWIXWXSETTP]XSIEGLHEXEFEWI]SYGSRRIGXXS

Oracle data dictionary views


(&%HMGXMSREV]ZMI[WEVIVIUYMVIHJSVZMI[MRKXLIJSPPS[MRKRSHIWSJXLI(&
2EZMKEXSVXVII
 6SPIW
 7SQIRSHIWYRHIV9WIVW
 (EXEJMPIW YRHIV8EFPIWTEGIW 
 6IHS0SK+VSYTW
 6SPPFEGO7IKQIRXW

Quickly finding objects in any schema


8LI*MRH3FNIGXWHMEPSKLIPTW]SYUYMGOP]JMRHSFNIGXWMRER]WGLIQE8LMW
QIXLSHMWSJXIRJEWXIVERHIEWMIVXLERQERYEPP]WIEVGLMRKXLI(&2EZMKEXSV
XVIIZMI[

To display a dynamic list of all objects in a schema


1
2

-RXLIXSTPIZIPSJXLI(&2EZMKEXSVXVIIWIPIGXEWGLIQERSHI
*VSQXLI7IEVGLQIRYGLSSWI*MRH3FNIGXW

;LIRXLI*MRH3FNIGXWHMEPSKETTIEVWGPMGO7IEVGL%PXIVREXMZIP]]SYGER
VIJMRI]SYVWIEVGLF]2EQIQEWOX]TIWXEXYWERHHEXIQSHMJMIH SVER]
GSQFMREXMSR 
;LIRXLIPMWXSJSFNIGXWETTIEVW]SYGER

174

SQL Navigator Users Guide

7SVXXLIPMWXF]GPMGOMRKGSPYQRLIEHIVW
3TIRERSFNIGXF]HSYFPIGPMGOMRK
4IVJSVQSXLIVEGXMSRWSRXLISFNIGXF]VMKLXGPMGOMRKERHWIPIGXMRKE
GSQQERHJVSQXLIWLSVXGYXQIRY

To open a found object for editing


 (SYFPIGPMGOER]SFNIGXMRXLIWIEVGLVIWYPXWHMWTPE]

To select and edit multiple objects


;MXLXLI*MRH3FNIGXWHMEPSK]SYGERETTP]EGXMSRWXSQYPXMTPISFNIGXWEXSRI
XMQI;LIRQYPXMTPISFNIGXWEVIWIPIGXIH]SYGER
 ETTP]GSQQERHWPMOI'ST]8I\X(VST)\XVEGX((0'SQTMPI)REFPI
(MWEFPIERH8VYRGEXIXSXLIIRXMVIFEXGLSJSFNIGXW
 HVEKXLIKVSYTSJSFNIGXWMRXSEXI\XIHMXSVSV(&2EZMKEXSV

Viewing the contents of a DB Navigator tree node


(&2EZMKEXSVPIXW]SYZMI[HEXEFEWISFNIGXWMREX[STERI[MRHS[EXVII
ZMI[SRXLIPIJXERHEPMWXZMI[SRXLIVMKLX
;LIR]SYWIPIGXE7GLIQERSHISV3FNIGX8]TIRSHI JSVI\EQTPI8EFPISV
-RHI\ MRXLIPIJXTERIXLIVMKLXTERIWLS[WEPMWXSJSFNIGXGSRXEMRIHMRXLEX
RSHI
;LIR]SYWIPIGXEWTIGMJMGSFNIGXMRXLIPIJXTERIXLIPMWXZMI[TERIWLS[W]SY
EPMWXSJXLIEXXVMFYXIWSJXLISFNIGX]SYWIPIGXIH
-JXLIVMKLXTERIMWLMHHIR]SYGERWLS[MXF]IMXLIVSJXLIJSPPS[MRKQIXLSHW
 'PMGO
SRXLI(&2EZMKEXSVXSSPFEV
3V
 6MKLXGPMGOMRXLI(&2EZMKEXSV[MRHS[ERHGLSSWI:MI[ 7LS[,MHI
(IXEMPWJVSQXLIWLSVXGYXQIRY

To open an object from the DB Navigator window


 (SYFPIGPMGOXLISFNIGXMRXLIPIJXSVVMKLXTERISJXLI(&2EZMKEXSV

Finding objects by search argument


;MXLXLI*MRH3FNIGXWHMEPSK]SYGERGSRWXVYGXEWIEVGLEVKYQIRXJSVER]
HEXEFEWISFNIGX=SYGERJMPXIV]SYVWIEVGLVIWYPXWF]WTIGMJ]MRKREQISV

Chapter 4

Navigating the database

175

S[RIVREQIXIQTPEXI MRGPYHMRK[MPHGEVHGLEVEGXIVW SFNIGXX]TIHEXIPEWX


QSHMJMIHSVWXEXYW

To display a dynamic list of all objects in a schema


1
2

-RXLIXSTPIZIPSJXLI(&2EZMKEXSVXVIIWIPIGXEWGLIQERSHI
*VSQXLI7IEVGLQIRYGLSSWI*MRH3FNIGXW

;LIRXLI*MRH3FNIGXWHMEPSKETTIEVWVIJMRI]SYVWIEVGLF]2EQIQEWO
X]TIWXEXYWERHHEXIQSHMJMIH SVER]GSQFMREXMSR 
;LIRXLIPMWXSJSFNIGXWETTIEVW]SYGER

7SVXXLIPMWXF]GPMGOMRKGSPYQRLIEHIVW
3TIRERSFNIGXF]HSYFPIGPMGOMRK
4IVJSVQSXLIVEGXMSRWSRXLISFNIGXF]VMKLXGPMGOMRKERHWIPIGXMRKE
GSQQERHJVSQXLIWLSVXGYXQIRY
You can specify the search string,
schema name, and object name using
wildcard characters "%" and "_"
(according to SQL LIKE operator
definitions).

To open a found object for editing


(SYFPIGPMGOER]SFNIGXMRXLIWIEVGLVIWYPXWHMWTPE]

To select and edit multiple objects


;MXLXLI*MRH3FNIGXWHMEPSK]SYGERETTP]EGXMSRWXSQYPXMTPISFNIGXWEXSRI
XMQI;LIRQYPXMTPISFNIGXWEVIWIPIGXIH]SYGER
 ETTP]GSQQERHWPMOI'ST]8I\X(VST)\XVEGX((0'SQTMPI)REFPI
(MWEFPIERH8VYRGEXIXSXLIIRXMVIFEXGLSJSFNIGXW
 HVEKXLIKVSYTSJSFNIGXWMRXSEXI\XIHMXSVSV(&2EZMKEXSV

176

SQL Navigator Users Guide

Displaying an objects place in the schema


;LIRERSFNIGXMWSTIRMREREGXMZI[MRHS[ ERIHMXMRK[MRHS[JSVI\EQTPI 
SVMWWIPIGXIHMRXLI(&2EZMKEXSV[MRHS[]SYGERYWIXLI0SGEXIMR7GLIQE
GSQQERHXSNYQTXSXLEXSFNIGX
WRSHIMRXLI(&2EZMKEXSVXVIII\TERHMRK
EPPMRXIVQIHMEXIRSHIWERHSTIRMRKXLISFNIGX
WHIXEMPW 

To locate an object in the schema


 'PMGO

SVJVSQXLI3FNIGXQIRYGLSSWI0SGEXIMR7GLIQE

To apply DB Navigator filters to restrict the object types


displayed for a session
=SYYWIXLI*MPXIV4VSTIVXMIWHMEPSKXSGVIEXISVQSHMJ](&2EZMKEXSVJMPXIVW
XLEXVIWXVMGXXLIHMWTPE]SJSFNIGXWMRXLI(&2EZMKEXSVXVIIZMI[=SYGERXLIR
WEZI]SYVJMPXIVWWSXLEXXLI][MPPFIEZEMPEFPIJVSQXLI(&2EZMKEXSV[MRHS[
XSSPFEV
'PMGOXLI+IRIVEPXEFXSWTIGMJ][LEXWGLIQE W WLSYPHFIZMWMFPIMRXLI(&
2EZMKEXSVXVII[LIRXLMWJMPXIVMWETTPMIH
'PMGO+PSFEP*MPXIVWXSWTIGMJ][LMGLSJXLIXSTPIZIPRSHIWWLSYPHFI
HMWTPE]IH
'PMGO3FNIGX*MPXIVWXSWTIGMJ][LMGLWTIGMJMGSFNIGXX]TIWWLSYPHFIHMWTPE]IH
YRHIVIEGLHMWTPE]IHWGLIQE=SYGEREPWSWTIGMJ]REQIQEWOWJSVWIPIGXIH
SFNIGXX]TIWSVKPSFEPP]JSVEPPSFNIGXW
2EQIQEWOWMR3FNIGXJMPXIVWEVIWTIGMJMIHEGGSVHMRKXS3VEGPI
WLIKE
STIVEXSVHIJMRMXMSR [LMGLMWEPWSZEPMHJSVXLI*MRH3FNIGXWGSQQERHERHXLI
'SHI7IEVGLERH7IPIGX(&3FNIGXHMEPSKW *SVI\EQTPIWIXXMRKXLIREQI
QEWOABC%[MPPVIWYPXMRHMWTPE]MRKSRP]XLSWISFNIGXW[MXLREQIWFIKMRRMRK
[MXLXLIGLEVEGXIVW%&'

To define filter properties


1

-RXLI(&2EZMKEXSVXSSPFEVGPMGO

-RXLI*MPXIV4VSTIVXMIWHMEPSK]SYGERWIPIGXERI\MWXMRKJMPXIVREQISV
IRXIVERI[SRIMRXLI*MPXIV2EQIFS\=SYGEREPWSHIPIXIWEZIHJMPXIVWSV
WEZIRI[SRIW
9WIXLI+IRIVEP+PSFEP*MPXIVWERH3FNIGX*MPXIVWXEFWXSWIPIGXJMPXIV
WIXXMRKW3FNIGXWQEVOIH[MXLEGLIGOQEVO[MPPETTIEVMRXLI(&
2EZMKEXSV[MRHS[[LIRXLIJMPXIVMWETTPMIH8SZMI[LMRXWTPEGIXLI
QSYWITSMRXIVSZIVXLIWIXXMRK

 XLI*MPXIVFYXXSR 

Chapter 4

Navigating the database

4
5
6

177

8SETTP]EREQIQEWOXSXLIWIPIGXIHWGLIQE W ERHSFNIGXWGPMGOXLI
3FNIGX*MPXIVWXEFERHX]TIXLIREQIQEWOMRXLI*MPXIVFS\
-J]SY[ERXXSETTP]XLIQEWOXSEPPWGLIQEWERHQEWOWGPMGO%WWMKR
+PSFEPP]
;LIRJMRMWLIHGPMGO3/XSVIJVIWLXLI(&2EZMKEXSV[MRHS[[MXLXLI
RI[SVQSHMJMIHJMPXIVETTPMIH

To display the shortcut menu for a selected object


 6MKLXGPMGOXLISFNIGX 

To perform an action on a database object in the DB Navigator


 7IPIGXXLIRSHIERHGPMGOEXSSPFEVFYXXSRSVVMKLXGPMGOXSMRZSOIXLI
WLSVXGYXQIRYERHXLIRGLSSWIEGSQQERH 

To view or hide details about the selected DB Navigator node


 'PMGO
XLI7LS[,MHI(IXEMPWFYXXSRSRXLI(&2EZMKEXSV
XSSPFEV
3V
6MKLXGPMGOMRXLI(&2EZMKEXSV[MRHS[ERHGLSSWI:MI[7LS[,MHI(IXEMPW
JVSQXLIWLSVXGYXQIRY 

To create a database object from the DB Navigator


 7IPIGXXLISFNIGXERHGPMGOXLI'VIEXI(&3FNIGXFYXXSRSRXLI3FNIGX
XSSPFEV
3V
6MKLXGPMGOXLISFNIGXERHGLSSWI'VIEXI 

To edit a database object from the DB Navigator


 (VEKXLISFNIGXREQIMRXSERIHMXSV[MRHS[
3V
(SYFPIGPMGOXLISFNIGX 
3V
7IPIGXXLISFNIGXERHGPMGOXLI3TIRFYXXSRSRXLI3FNIGXXSSPFEV

To drop a database object from the DB Navigator


 7IPIGXXLISFNIGXERHGPMGOXLI(VSTFYXXSRSRXLI3FNIGXXSSPFEV

178

SQL Navigator Users Guide

To rename a database object from the DB Navigator


 7IPIGXXLISFNIGXERHGPMGOXLI6IREQIFYXXSR

To compile an object from the DB Navigator


In the DB Navigator
 7IPIGXXLISFNIGXERHGPMGOXLI'SQTMPIFYXXSR
 6MKLXGPMGOXLISFNIGXERHGLSSWIE'SQTMPISTXMSRJVSQXLIWLSVXGYX
QIRY

Browsing or editing table data from the DB Navigator


;LIREXEFPIMWWIPIGXIHMRXLI(&2EZMKEXSV[MRHS[]SYGERIEWMP]FVS[WI
SVIHMXXLIHEXEWXSVIHMRXLIXEFPI

To browse or edit table data from the DB Navigator


1

-RXLI(&2EZMKEXSV[MRHS[WIPIGXXLIXEFPI

'LSSWISRISJXLIJSPPS[MRK
To

Do this

3TIRXLIWIPIGXIHXEFPIMRXLI5YIV]
&YMPHIV[MRHS[[LIVI]SYGERFYMPHE
UYIV]F]WIPIGXMRKERHHVEKKMRKGSPYQRW

*VSQXLI3FNIGXQIRYGLSSWI
&VS[WI(EXE
SV
3RXLI3FNIGXXSSPFEVGPMGO



3TIRXLIWIPIGXIHXEFPIMRXLI&VS[WI(EXE *VSQXLI3FNIGXQIRYGLSSWI5YMGO
[MRHS[[LIVI]SYGERZMI[SVIHMXHEXEMR &VS[WISV)HMX(EXE
IMXLIVEKVMHJSVQEXSVEWMRKPIVS[ZMI[
SV
3RXLI3FNIGXXSSPFEVGPMGO  )HMX
(EXE 

Chapter 4

Navigating the database

179

To build a query from a selected table


1
2

-RXLI(&2EZMKEXSV[MRHS[WIPIGXXLIXEFPI
'LSSWISRISJXLIJSPPS[MRK 
*VSQXLI3FNIGXQIRYGLSSWI&VS[WI(EXE
SV
3RXLI3FNIGXXSSPFEVGPMGO

-RXLI5YIV]&YMPHIV[MRHS[]SYGERFYMPHEUYIV]F]WIPIGXMRKERH
HVEKKMRKGSPYQRW

To extract DDL in the DB Navigator and display it in the SQL


Editor
1

7IPIGXXLISFNIGX W ERHGPMGOXLI)\XVEGX((0FYXXSR



-RXLI4VSTIVXMIWHMEPSKWIPIGXXLI)\XVEGX((0STXMSRWERHGPMGO3/ 

To invoke the DESCRIBE command for an object in the DB


Navigator
8LI3VEGPI()7'6-&)GSQQERHVITSVXWXLIEXXVMFYXIWQIXLSHWERH
EVKYQIRXWSJERSFNIGXX]TI8LI7502EZMKEXSV(IWGVMFIGSQQERH[SVOW
[MXLQSVISFNIGXWXLERHSIWXLI750 4PYWZIVWMSRSJXLIGSQQERH=SYGER
HIWGVMFIRSXSRP]TVSGIHYVIWJYRGXMSRWTEGOEKIWW]RSR]QWERHSFNIGXX]TIW
FYXEPWSXEFPIWMRHI\IWGPYWXIVWERHSFNIGXW
=SYGERYWIIMXLIVXLI(IWGVMFIGSQQERHSVXLI%YXS(IWGVMFIJIEXYVIXS
HIWGVMFIERSFNIGXHMWTPE]IHMRXLI(&2EZMKEXSV[MRHS[ SVSXLIVGYVVIRX
[MRHS[ 
%YXS(IWGVMFI;MXLXLI%YXS(IWGVMFIJIEXYVIIREFPIHEHSGOEFPI(IWGVMFI
[MRHS[STIRWERHWXE]WSRXSTSJXLIETTPMGEXMSR[MRHS[%W]SYWIPIGX
ZEVMSYWSFNIGXWMRXLI(&2EZMKEXSVXVII]SY[MPPEYXSQEXMGEPP]WIIE
HIWGVMTXMSRSJXLIWIPIGXIHSFNIGXMRXLI%YXS(IWGVMFI[MRHS[
(IWGVMFI=SYGERQERYEPP]MRZSOIXLI(IWGVMFIGSQQERH[LIRIZIVRIIHIH
-XSTIRWEHIWGVMFI[MRHS[JSVEWMRKPISFNIGXERH[MPPRSXYTHEXI
EYXSQEXMGEPP][LIR]SYWIPIGXERSXLIVSFNIGX

180

SQL Navigator Users Guide

To enable the AutoDescribe feature


1
2
3

*VSQXLI:MI[QIRYGLSSWI%YXS(IWGVMFI8SSP
)RWYVIXLEXXLIVIUYMVIHHEXEFEWIGSRRIGXMSRMWEGXMZI
8SZMI[ERSFNIGX
WHIWGVMTXMSRMRXLIHSGOEFPI%YXS(IWGVMFI[MRHS[NYWX
WIPIGXXLISFNIGXMRXLIGYVVIRX[MRHS[

To invoke the Describe command


1
2




3

)RWYVIXLEXXLIVIUYMVIHHEXEFEWIGSRRIGXMSRMWEGXMZI
(SSRISJXLIJSPPS[MRK

7IPIGXXLIHEXEFEWISFNIGXERHXLIRJVSQXLI3FNIGXQIRYGLSSWI
(IWGVMFI
SV

6MKLXGPMGOXLISFNIGXERHGLSSWI(IWGVMFI
-J]SY[ERXXSOIITXLII\MWXMRK(IWGVMFI[MRHS[STIR[LMPISTIRMRK
EHHMXMSREP(IWGVMFI[MRHS[WGPMGOXLI4MRXSSPFEVMGSRMRXLI(IWGVMFI
[MRHS[

To view or edit database object definition in the DB Navigator


 (SYFPIGPMGOXLIXI\XTSVXMSRSJXLIRSHI 

To execute a stored program from the DB Navigator


 7IPIGXXLITVSKVEQSFNIGXERHGPMGOXLI)\IGYXIFYXXSRSRXLI3FNIGX
XSSPFEV



DB Navigator drag-and-drop tips


To drag database object names from the DB navigator into an
editor
 'PMGOXLIXI\XTSVXMSRSJXLIHEXEFEWISFNIGXRSHIERHHVEKMXMRXSER
IHMXSV[MRHS[ 

To add a code location shortcut to a workspace


 (VEKXLIWIPIGXMSRJVSQXLIVIWYPXPMWXMRXLI7IEVGL7SYVGI'SHI[MRHS[
XSXLI;SVOWTEGI

Chapter 4

Navigating the database

181

To add an external file to the current workspace


 (VEKXLIJMPIJVSQXLI;MRHS[W)\TPSVIVXSXLI;SVOWTEGI

To add an object to a workspace


 *VSQXLI(&2EZMKEXSVHVEKXLISFNIGXXSXLI;SVOWTEGI

To add an object to the Query Builder work area


 (VEKXLIXEFPISVZMI[JVSQXLI(&2EZMKEXSVSV;SVOWTEGIXSXLI5YIV]
&YMPHIV

To copy an object from one schema to another


 3TIREWIGSRH(&2EZMKEXSV[MRHS[ERHHVEKXLISFNIGXJVSQXLIWSYVGI
[MRHS[XSXLIXEVKIX[MRHS[8LIRI\IGYXIXLI((0HMWTPE]IHMRXLI
IHMXMRK[MRHS[

To open an external file in SQL Editor


 (VEKXLIJMPIJVSQXLI;MRHS[W)\TPSVIVXSXLI(&2EZMKEXSV[MRHS[

To open an object in an editor


 *VSQXLI(&2EZMKEXSVHVEKXLISFNIGXMRXSXLIQEMR7502EZMKEXSV
ETTPMGEXMSR[MRHS[ 

5
Working with SQL statements and
scripts

8LMWGLETXIVI\TPEMRWLS[XSGVIEXI750WXEXIQIRXWERHWGVMTXWXYRIXLIQ
I\IGYXIXLIQERH[SVO[MXLVIXYVRIHVIWYPXW

In this chapter
Writing and editing SQL code
Fast query building with the Query Builder
Executing SQL and working with results
The Spool window
Viewing results in the Result window

184
212
226
230
232

184

SQL Navigator Users Guide

Writing and editing SQL code


The SQL Editor

To open the SQL Editor


'LSSWISRISJXLIJSPPS[MRKQIXLSHW

'PMGOXLI750)HMXSVFYXXSRSRXLI*YRGXMSRW
XSSPFEV



SV
*VSQXLI*MPIQIRYWIPIGX2I[*MPI 7507GVMTX
SV
*VSQXLI:MI[QIRYWIPIGX2I[750)HMXSV
SV
*VSQE:MWYEP3FNIGX)HMXSVGPMGOXLI750FYXXSR RSXTVIWIRXMREPPSFNIGX
IHMXSVW 
3XLI750FYXXSR
-RXLI5YIV]&YMPHIVGPMGOXLI'ST]XS)HMXSVFYXXSR
3XLI'ST]XS)HMXSVFYXXSR

Chapter 5

Working with SQL statements and scripts

185

The SQL window


8LI750[MRHS[HMWTPE]WXLIXI\XSJXLI750WXEXIQIRX W XSFIIHMXIHSV
I\IGYXIHERHKMZIW]SYEGGIWWXSIHMXMRKXSSPW
=SYGERGVIEXIRI[WXEXIQIRXWSVSTIRWEZIH750WGVMTXW

To display the SQL editing window


 -RXLI750)HMXSVGPMGOXLI750XEF

SQL Editor toolbar commands


=SYGERTSMRXXSER]7502EZMKEXSVXSSPFEVMGSRXSWIIEXSSPXMTMHIRXMJ]MRK
MXWJYRGXMSR*SPPS[MRKEVIFVMIJHIWGVMTXMSRWSJXLIGSQQERHWEZEMPEFPIMRXLI
750)HMXSVXSSPFEV

Command

Description

2I[

3TIRERI[750WXEXIQIRXSVWGVMTX

3TIR

0SEHEJMPIMRXSXLIIHMXSV

7EZI*MPI

7EZIXLIGYVVIRX750WXEXIQIRXSVWGVMTX

4VMRX*MPI

4VMRXXLIGYVVIRX750WXEXIQIRXSVWGVMTX

9THEXIEFPI

;LIRXSKKPIHSRI\IGYXIE7)0)'8WXEXIQIRX
ERHIHMXXLIVIWYPXMRKHEXEWLIIXMRXLI6IWYPX
HMWPTPE]

7XSTSR)VVSV

;LIRXSKKPIHSRWXSTXLII\IGYXMSRSJER750
WGVMTX[LIRERIVVSVMWIRGSYRXIVIHHYVMRKXLI
TVSGIWWMRKSJXLIWGVMTX8LI)HMXSVPIXW]SYJM\ER]
IVVSVWEW]SYKS

*IXGL%PP

;LIRXSKKPIHSRHMWTPE]VIWYPXWEJXIVEPPVS[WMRE
UYIV]
WVIWYPXEVIJIXGLIH
;LIRXSKKPIHSJJMQQIHMEXIP]HMWTPE]SRP]XLI
JMVWX2VS[WRIIHIHXSJMPPXLI6IWYPX[MRHS[

7TSSP3YXTYX

;LIRXSKKPIHSRHMWTPE]WUYIV]VIWYPXWYRHIVXLI
7TSSPXEFSJXLI750)HMXSV

186

SQL Navigator Users Guide

7GER(IJMRIW

7GERXLIWGVMTXJSVWYFWXMXYXMSRZEVMEFPIW8SKKPI
XLMWSR[LIRYWMRKZEVMEFPIWSVXI\XXLEXGSRXEMR
XLIXLIGLEVEGXIVW  SV!?FMRHZEVMEFPIWA

7XEXIQIRX6IGEPP

3TIRXLI7XEXIQIRX6IGEPPHMEPSKXSVIXVMIZIE
TVIZMSYWP]I\IGYXIHWXEXIQIRXJVSQXLIGYVVIRX
WIWWMSRERHTYXMXMRXSXLIIHMXMRK[MRHS[

7OMTXS8ST

7IXXLII\IGYXMSRWXEVXTSMRXERHXLIGYVWSVXSXLI
JMVWXWXEXIQIRX

7OMTXS4VIZMSYW

8EOIXLIGYVWSVFEGOXSXLITVIZMSYW750
WXEXIQIRX

6YR

7XEVXXLII\IGYXMSRSJ750WXEXIQIRXWJVSQXLI
GYVVIRXGYVWSVTSWMXMSR

7MRKPI7XIT

7XEVXI\IGYXMSRJVSQXLIGYVVIRXGYVWSVTSWMXMSR
ERHWXSTW[LIRSRI750WXEXIQIRXLEWFIIR
I\IGYXIH

7XST

7XSTXLII\IGYXMSRSJXLIWGVMTXEXXLIGYVVIRXP]
I\IGYXMRK750WXEXIQIRX

7OMTXS2I\X

4PEGIXLII\IGYXMSRTSMRXSRXLIRI\XI\IGYXEFPI
750WXEXIQIRX

7OMTXS&SXXSQ

4PEGIXLII\IGYXMSRTSMRXEXXLIPEWXWXEXIQIRXMR
XLIGYVVIRXWGVMTX

+IX0EXIWX6IZMWMSR

;LIRXIEQGSHMRKMWMRYWIKIXWXLIPEXIWXZIVWMSR
SJERSFNIGXSVWGVMTXXLEXMWLIPHMRXLI:'7
VITSWMXSV]

'LIGO3YX

;LIRXIEQGSHMRKMWMRYWIGLIGOWSYXXLISFNIGX
SVWGVMTXXSXLIGYVVIRXYWIV

'LIGO-R

;LIRXIEQGSHMRKMWMRYWITPEGIWXLIGYVVIRX
ZIVWMSRSJXLISFNIGXSVWGVMTXMRXSXLIHEXEFEWI

9RHS'LIGOSYX

;LIRXIEQGSHMRKMWMRYWIVIZIVWIWEGLIGOSYX
STIVEXMSRWSXLEXXLISFNIGXSVWGVMTXGERFI
QSHMJMIHF]ERSXLIVYWIV

<TIVX8YRMRK

<TIVX8YRMRKEPPS[WHIZIPSTIVWXSEREP]^IERH
EYXSQEXMGEPP]VI[VMXIMRIJJMGMIRX750UYIVMIW[LMPI
XLI]EVIFIMRKFYMPX

Chapter 5

Working with SQL statements and scripts

187

)\TPEMR4PER8SSP

3TIRWXLI)\TPEMR4PER8SSP

7IEVGLSV6ITPEGIMR
8I\X

3TIREWIEVGLVITPEGIHMEPSK

7IEVGL/RS[PIHKI
<TIVX

*SVQIVP]XLI6IZIEP2IX/RS[PIHKI&EWI:MWMXXLI
5YIWX[IFWMXIJSVYTXSHEXIMRJSVQEXMSR

750-QTEGX

750-QTEGXTVSZMHIWEGGYVEXIERHEYXSQEXMG
MQTEGXEREP]WMWJSVER]TVSTSWIHWXVYGXYVEP
HEXEFEWIGLERKIW-RGPYHIWXLIWIVITSVXW
*MRH750
-QTEGX%REP]WMW
-RHI\%REP]WMW

*SVQEXXIV8SSPW

%HZERGIHJSVQEXXMRKXSSPW

SQL Editor shortcut menu commands


8LIWLSVXGYX VMKLXGPMGO QIRYWMRXLI750)HMXSVKMZI]SYUYMGOEGGIWWXS
GSQQSRP]YWIHGSQQERHWJSV[SVOMRK[MXL750GSHI 

SQL Window
Command

Description

'YX

'ST]WIPIGXIHXI\XXSXLI'PMTFSEVH[LMPI
VIQSZMRKMXJVSQXLI750XEF

'ST]

'ST]WIPIGXIHXI\XXSXLI'PMTFSEVH[MXLSYX
VIQSZMRKMXJVSQXLI750XEF

4EWXI

4EWXIXLIGSRXIRXWSJXLI'PMTFSEVHXSXLI
GYVVIRXPSGEXMSR

'SQQIRX

'SRZIVXXLIWIPIGXIHXI\XMRXSEGSQQIRX

9RGSQQIRX

6IQSZIGSQQIRXQEVOWJVSQXLIWIPIGXIHXI\X

)\IGYXI

7YFQMXXLIGSRXIRXWSJXLI750XEFXSXLI
HEXEFEWIJSVI\IGYXMSREWER750WXEXIQIRX
-RGPYHIWEWYFQIRYJSVTPEGMRKXLII\IGYXMSR
TSMRX

188

SQL Navigator Users Guide

(IJMRI:EVMEFPIW

(IJMRIIHMXERHVIQSZI750WYFWXMXYXMSR
ZEVMEFPIW
4VIHIJMRIIHMXSVHIPIXIWYFWXMXYXMSRZEVMEFPIW
FIJSVI]SYI\IGYXIEWGVMTX*SVI\EQTPI
7IPIGXEHHVIWWJVSQ'YWXC-H[LIVIGSREQIPMOI
D%8 7*


9THEXIEFPI

%PPS[YWIVWXSIHMXXLIVIWYPXWSJ750UYIVMIWMR
XLI6IWYPXXEF

7XSTSR)VVSV

7XSTXLII\IGYXMSRSJXLIGYVVIRX750WGVMTX
[LIRERIVVSVMWIRGSYRXIVIHHYVMRK
TVSGIWWMRK8LI)HMXSVPIXW]SYJM\ER]IVVSVWEW
]SYKS

*IXGL%PP

;LIRXSKKPIHSRHMWTPE]VIWYPXWEJXIVEPPVS[W
MREUYIV]
WVIWYPXEVIJIXGLIH
;LIRXSKKPIHSJJMQQIHMEXIP]HMWTPE]SRP]XLI
JMVWX2VS[WRIIHIHXSJMPPXLI6IWYPX[MRHS[

7GER(IJMRIW

7GERXLIWGVMTXJSVWYFWXMXYXMSRZEVMEFPIW
8SKKPIXLMWSJJ[LIRYWMRKZEVMEFPIWSVXI\XXLEX
GSRXEMRXLIGLEVEGXIVW  SV!?ZEVMEFPIA

6IEH3RP]

4VIZIRXXLIWGVMTX]SYEVIGYVVIRXP]IHMXMRKSV
EVIEFSYXXSPSEHJVSQFIMRKQSHMJMIH9WI
XLMWSTXMSR[LIR]SYEVII\IGYXMRKEWGVMTXXLEX
]SYHSRSX[ERXXSQSHMJ]MREHZIVXIRXP]

7TSSP3YXTYX

(MWTPE]XLIVIWYPXWSJXLI750UYIV]EWXI\X
YRHIVXLI7TSSPXEF

)GLS750

(MWTPE]XLIXI\XSJER750WGVMTX[MXLMXW
VIWYPXWMRXLI7TSSPXEF

'PIEV7TSSPSR6YR

'PIEVXLIGSRXIRXWSJXLI7TSSPXEFFIJSVI
VYRRMRKXLIGYVVIRX750WGVMTX

8SKKPI&SSOQEVOW

%HHSVVIQSZIEFSSOQEVOSRXLIGYVVIRXPMRI
SJXLI750WGVMTX

+SXS&SSOQEVOW

+SXSXLIPMRISJWGVMTXQEVOIHF]XLIWIPIGXIH
FSSOQEVO

3TIR3FNIGXEX'YVWSV

3TIRWERSFNIGXIHMXSVJSVXLISFNIGXREQIHEX
XLIGYVWSVTSWMXMSR

(IWGVMFI3FNIGXEX'YVWSV

)\IGYXIWE(IWGVMFIGSQQERHJSVXLISFNIGX
REQIHEXXLIGYVWSVTSWMXMSRWLS[MRK]SYXLI
SFNIGX
WWXVYGXYVI

Chapter 5

Working with SQL statements and scripts

189

The Output window


8LI3YXTYX[MRHS[LEWXEFFIHTEKIWJSVSYXTYXJVSQHMJJIVIRXWIWWMSRWTPYW
SRITEKIJSVKIRIVEPQIWWEKIWRSXVIPEXIHXSETEVXMGYPEVWIWWMSR
3YXTYXPMRIWSJHMJJIVIRXX]TIW MRJSVQEXMSRIVVSVWWIVZIVSYXTYX EVI
HMWXMRKYMWLIHF]HMJJIVIRXJSRXGSPSVWERHEVIJPEKKIHF]HMJJIVIRXMGSRWXS
QEOIXLIQIZIRQSVIRSXMGIEFPI
8LI3YXTYX[MRHS[GERFIQEHIEHSGOEFPIWXE]SRXST[MRHS[SVERSVQEP
1(-[MRHS[F]QIERWSJEWLSVXGYXQIRYSTXMSR

To display the Output window


*VSQXLI:MI[QIRYGLSSWI3YXTYX;MRHS[
=SYGERQSZIHSGOERHYRHSGOXLI3YXTYX[MRHS[XSSTXMQM^I]SYV
[SVOWTEGI

Interpreting the output display


8LI3YXTYX[MRHS[HMWTPE]WTVSGIWWSVERHWIVZIVSYXTYXMRXLIJSPPS[MRK
GSPSVWGLIQI
Color

Data type

&PYI

7IVZIVSYXTYX

6IH

)VVSV1IWWEKIW

&PEGO

3XLIVTVSGIWWMRKQIWWEKIW

To change size of the buffer for server output


1
2

-RXLI:MI[QIRYGLSSWI4VIJIVIRGIW +IRIVEP
'PMGO7IWWMSR

)RXIVXLIHIWMVIHYTTIVPMQMXJSVXLI(&173YXTYX&YJJIV &]XIW 

To copy and paste selected text from the Output window


1
2
3

7IPIGXXLIXI\X]SY[ERXXSGST]MRXLI3YXTYX[MRHS[
6MKLXGPMGOXLIWIPIGXMSRERHGLSSWI'ST]SVYWIXLIOI]FSEVHWLSVXGYX
'XVP'XSTPEGIXLIWIPIGXIHXI\XSRXLIGPMTFSEVH
8STEWXIXLIGSTMIHXI\XTPEGIXLIGYVWSVEXXLIHIWXMREXMSRERHTVIWW
'XVP:

190

SQL Navigator Users Guide

To clear the Output window


6MKLXGPMGOMRXLI3YXTYX[MRHS[ERHGLSSWI'PIEV

To print the contents of the Output window


6MKLXGPMGOMRXLI3YXTYX[MRHS[ERHGLSSWI4VMRX

Editing SQL code


=SYGERYWIXLI750)HMXSVXSIHMX750SV40750WSYVGIGSHIMRGPYHMRK
WXSVIHTVSKVEQWXVMKKIVWERHMRHMZMHYEP750WXEXIQIRXWSVWGVMTXW
8LI750)HMXSVTVSZMHIWETS[IVJYPIHMXMRKIRZMVSRQIRX[MXLWYGLYWIJYP
JIEXYVIWEWTVSKVEQQEFPIWLSVXGYXOI]WGSPSVW]RXE\LMKLPMKLXMRKERH
FSSOQEVOW
=SYGEREGGIWWWXERHEVHIHMXMRKJYRGXMSRW *MRH*MRH2I\X6ITPEGI'YX
'ST]4EWXI9RHS6IHSIXG JVSQXLI)HMXERH7IEVGLQIRYWJVSQXLI
OI]FSEVHERHJVSQXLI)HMXXSSPFEV
8LI)HMXXSSPFEVMWJYPP]GYWXSQM^EFPIWSXLIFYXXSRWXLEXETTIEVSRXLI
XSSPFEVEVISRP]EWQEPPWYFWIXSJXLIJYRGXMSRWXLEXEVIEZEMPEFPI
8LI750)HMXSVEPPS[W]SYXSVYREGSQTPIXIWGVMTXMRGSRXMRYSYWSVWMRKPI
WXITQSHI=SYGERWOMTJSV[EVHSVFEGO[EVHF]SRI750WXEXIQIRXSVIHMX
750WXEXIQIRXWSRXLIJP]EW]SYI\IGYXIXLIQ
;MXLXLI750)HMXSV]SYGER
 )HMXXLIXI\XSJ750WXEXIQIRXWYWMRKTS[IVJYPXI\XIHMXMRKJYRGXMSRW
 )\IGYXIXLSWIWXEXIQIRXWEWUYIVMIWZMESFNIGXWTIGMJMGJYRGXMSRWWYGLEW
6YRERH7MRKPI7XIT
 :MI[XLISYXTYXSJXLII\IGYXIHWXEXIQIRXWMRWITEVEXI7TSSPERH6IWYPX
XEFWMRXLI750)HMXSV[MRHS[
 )HMX750WXEXIQIRXWSRXLIJP]EW]SYI\IGYXIXLIQ
 )HMXXLIHEXEVIXYVRIHF]7)0)'8WXEXIQIRXW MJXLI9THEXIEFPI5YIV]
STXMSRMWXYVRIHSR 
 :MI[XLISYXTYXSJXLII\IGYXIHWXEXIQIRXWMRWITEVEXI7TSSPERH6IWYPX
XEFWMRXLI750)HMXSV[MRHS[
 )\TSVXWIPIGXIHSYXTYXHEXEXSXLIGPMTFSEVHJMPIWERHXLITVMRXIV
 6YREGSQTPIXIWGVMTXMRGSRXMRYSYWSVWMRKPIWXITQSHI
 &VS[WIQYPXMTPIVIWYPXWIXW
 6IGEPPTVIZMSYWP]VYR750WXEXIQIRXW
 :MI[VIWYPXWMREHEXEXEFPISVEWMRKPIVIGSVHJSVQEX

Chapter 5

Working with SQL statements and scripts

191

 7OMTJSV[EVHSVFEGO[EVHF]SRI750WXEXIQIRX
 1SHMJ]XLI750)HMXSV
WKIRIVEPFILEZMSVXLVSYKLXLI4VIJIVIRGIWSTXMSR
SRXLI:MI[QIRY

Edit menu and toolbar quick-reference


-REHHMXMSRXSXLI750)HMXSV[MRHS[[MXLMXWWTIGMEP750GSHIIHMXMRK
XSSPFEVXLI)HMXQIRYERH)HMXXSSPFEVKMZI]SYUYMGOEGGIWWXSYWIJYP
GSQQERHWJSV[SVOMRK[MXL750GSHI8LI]FIGSQIEGXMZI[LIRIZIVXLI
GYVVIRXSFNIGXMWIHMXEFPIXI\X
The Edit toolbar is dockable, so you can place it
where it is most convenient. To see a hint
describing the function of any button on the
toolbar, position the mouse pointer over it.

,IVIMWEUYMGOVIJIVIRGIKYMHIXSGSQQSRP]YWIHIHMXMRKJYRGXMSRWMRXLI750
2EZMKEXSVXLI)HMXQIRYERH)HMXXSSPFEV9WIXLI,IPT8EFPISJ'SRXIRXWXS
REZMKEXIXLMWKVSYTSJXSTMGW

Point-and-click column names from any object


=SYGERUYMGOP]MRWIVXGSPYQRREQIWJSVEHEXEFEWISFNIGXMRXS]SYV750
GSHI

To insert a column name

4PEGIXLIGYVWSVMRXLIIHMXSV[MRHS[[LIVI]SY[ERXXLIGSPYQRREQIW
XSFIMRWIVXIH
8]TIXLIREQISJXLISFNIGXJSPPS[IHF]ETIVMSHQEVO  8LIGSPYQR
REQIWHMWTPE]MREHVSTHS[RPMWX
7IPIGXXLIREQISJXLIGSPYQR]SY[ERXXSMRWIVXJVSQXLIHVSTHS[RPMWX

4VIWW)RXIV

1
2

192

SQL Navigator Users Guide

The Edit menu

The Edit toolbar

Chapter 5

Working with SQL statements and scripts

193

Inserting code from another file


=SYGERMRWIVXWSYVGIGSHIJVSQERSXLIVJMPIMRXSXLIGYVVIRXXI\XIHMXMRK
WIWWMSR

To insert selected source code from another file


1
2
3

3TIRXLIWSYVGIJMPIMRXLI750)HMXSV
7IPIGXERHGST]XLIHIWMVIHGSHI8SWIPIGXXLIIRXMVIJMPIYWIXLI7IPIGX%PP
STXMSRJVSQXLI)HMXQIRYXLIRGST]MXXSXLIGPMTFSEVH
7[MXGLXSXLIGYVVIRXIHMXMRK[MRHS[ERHXLIRTEWXIXLIGSTMIHEXXLI
HIWXMREXMSRPSGEXMSR

To insert the entire text from another file from another file
1
2

3TIRXLIHIWXMREXMSRJMPIMRXLI750)HMXSV
*VSQXLI)HMXQIRYGLSSWI-RWIVXERHXLIRGLSSWI*MPI

8LIJMPI]SYWIPIGX[MPPFIMRWIVXIHEXXLIGYVVIRXTSWMXMSRMRXLIIHMXSV

Inserting ready-made code via shortcut keys


8LMWZIVWMSRSJ7502EZMKEXSVTVSZMHIWEWIXSJGSHIXIQTPEXIWXLEXGSRXEMR
VIEH]QEHIGSHIWIKQIRXW=SYGERUYMGOP]MRWIVXXLIWIGSHIWIKQIRXWMRXS
ER]EGXMZIIHMXSV[MRHS[8LIWIKQIRXWLEZIWLSVXGYXOI]WEWWMKRIHXSXLIQ
8LIQE\MQYQRYQFIVSJXIQTPEXIW]SYGERLEZIMR7502EZMKEXSVMRGPYHMRK
XLITVIJSVQEXXIHXIQTPEXIWMW

To insert code from a template


1

4PEGIXLIGYVWSV[LIVI]SY[ERXXSMRWIVXXLIGSHIWIKQIRX

'LSSWISRISJXLIJSPPS[MRK
 -J]SYORS[XLIOI]FSEVHWLSVXGYXEWWMKRIHXSXLIGSHIWIKQIRX]SY
[ERXXLIRWMQTP]X]TIXLIWLSVXGYX
 -J]SYORS[XLIREQISJXLIGSHIWIKQIRX]SY[ERXSVTEVXSJXLI
REQIXLIRX]TIXLIJYPPSVTEVXMEPREQIERHTVIWW'XVPJXSIMXLIV
MRWIVXXLIQEXGLMRKGSHIWIKQIRXSVGLSSWIJVSQEPMWXSJQEXGLIW
 8SHMWTPE]EJYPPPMWXSJEZEMPEFPIXIQTPEXIWTVIWW'XVPJERHXLIRWIPIGX
XLIXIQTPEXIREQIJVSQXLIHVSTHS[RPMWXERHTVIWW)RXIV

194

SQL Navigator Users Guide

Code templates and their assigned shortcuts


8LIWXERHEVHGSHIVSYXMRIWJSV[LMGLXIQTPEXIWLEZIFIIRTVSZMHIHEVIPMWXIH
FIPS[8LIWIXIQTPEXIWVIWMHIEWJMPIWMRXLI8IQTPEXIWHMVIGXSV]SRXLIHVMZI
[LIVI]SYLEZIMRWXEPPIH7502EZMKEXSV8LIHIJEYPXTEXLJSVMRWXEPPEXMSRMW
'@4VSKVEQ*MPIW@5YIWX7SJX[EVI@7502EZMKEXSV@8IQTPEXIW
Code Description

Shortcut Key

&EWMG0SST7XEXIQIRX

7LMJX'XVP0

&SSPIER7XEXIQIRX

7LMJX'XVP&

'PSWI'YVWSV7XEXIQIRX

7LMJX'XVP'

(&17C3984984YXC0MRI

7LMJX'XVP(

)\GITXMSR

7LMJX'XVP)

)\MX;LIR7XEXIQIRX

7LMJX'XVP<

*SV0SST7XEXIQIRX

7LMJX'XVP*

+3830EFIP7XEXIQIRX

7LMJX'XVP+

-*7XEXIQIRX

7LMJX'XVP%

1070%&)07XEXIQIRX

7LMJX'XVP1

2YQFIV7XEXIQIRX

7LMJX'XVP2

3TIRC'YVWSV7XEXIQIRX

7LMJX'XVP3

6EMWIC)\GITXMSR

7LMJX'XVP6

750'3()7XEXIQIRX

7LMJX'XVP7

:%6',%67XEXIQIRX

7LMJX'XVP:

:EVMEFPICREQI

7LMJX'XVP8

;LMPI'SRHMXMSR7XEXIQIRX

7LMJX'XVP;

SQL*Plus command support


8LI750)HMXSVMR7502EZMKEXSVWYTTSVXWXLIJSPPS[MRK750 4PYW
GSQQERHW4PIEWIGSRWYPX3VEGPIHSGYQIRXEXMSRJSVHIXEMPWEFSYX3VEGPIkW
750 4PYWYXMPMX] 

Chapter 5

Working with SQL statements and scripts












195

'SQQIRX(IPMQMXIVW    
(SYFPI,]TLIR  
%X7MKR $ 
(SYFPI%X7MKR $$ 
*SV[EVH7PEWL  
'322)'8
()7'6-&)
(-7'322)'8
)<)'98)
6)1%6/

Validating syntax
8SZEPMHEXIXLIW]RXE\SJ750WXEXIQIRXWYWIXLI7MRKPI7XITFYXXSRSRXLI
WGVMTXIHMXSVXSSPFEVXSWXITXLVSYKLIEGL750WXEXIQIRXMRXLIWGVMTX%WIEGL
750WXEXIQIRXMWI\IGYXIHXLIIHMXSVLMKLPMKLXWXLIIVVSVMRXLI750
WXEXIQIRX=SYGEREPWSYWIXLI7XSTSR)VVSVSTXMSR[LMGLMWEXSKKPIFYXXSR
ERHVYRXLI750WXEXIQIRXJVSQXLIFIKMRRMRK8LIWGVMTX[MPPWXSTEXXLIJMVWX
IVVSVERHLMKLPMKLXXLISJJIRHMRKGSHI 

Automatic indentation
;LIR]SYMRWIVXQYPXMPMRIXI\XMRXSXLIIHMXSVMXMWTPEGIHEXXLIWEQI
MRHIRXEXMSRPIZIPEWXLIGYVVIRXGYVWSVTSWMXMSR
*SVFIWXVIWYPXWFIJSVIMRWIVXMRKXI\XTPEGIXLIGYVWSVEXXLIPSGEXMSRERH
MRHIRXEXMSRPIZIP[LIVI]SY[ERXXLIMRWIVXIHXI\XXSETTIEV

Begin/End markers for loops and blocks


;LIR]SYTPEGIXLIGYVWSVMRWMHIE&)+-2)2(-*)2(-*SV
0334)2(0334FPSGOXLI7502EZMKEXSVGSHIIHMXSVWWLS[]SYXLIFIKMR
ERHIRHTSMRXWF]QIERWSJDKP]TLW
 QEVOIVW MRXLIDKYXXIV
 PIJXQEVKMR  

196

SQL Navigator Users Guide

%RYQFIVSJSXLIVKYXXIVQEVOIVWEVIYWIHEW[IPP
%

& ' ( ) * + , -

.

/


%
&
'
(
)
*
+
,
-
.
/

FSSOQEVOW  
IREFPIHFVIEOTSMRX
HMWEFPIHFVIEOTSMRX
GYVVIRXI\IGYXMSRPMRI
MRZEPMHFVIEOTSMRX
IVVSVPMRI WXEXIQIRXXLEX[EWI\IGYXIH[MXLIVVSVW 
7)0)'8WXEXIQIRXXLEXTVSHYGIHVIWYPXW
RSR7)0)'8WXEXIQIRXXLEX[EWI\IGYXIHWYGGIWWJYPP]
[EVRMRKPMRI WXEXIQIRXXLEX[EWI\IGYXIH[MXL[EVRMRKW 
FPSGOFIKMR
FPSGOIRH

Using Bookmarks in the SQL Editor


9WIEFSSOQEVOXSGSRZIRMIRXP]QEVOZEVMSYWPSGEXMSRWMRXLIWSYVGIGSHIERH
UYMGOP]QSZIEFSYXMRXLIXI\X[MXLSYXWIEVGLMRKXLVSYKLXLIGSHIERH
[MXLSYXPSWMRK]SYVGYVVIRXIHMXMRKPSGEXMSR=SYGERWIXYTXSXIRFSSOQEVOW
*SVI\EQTPI]SYGSYPHTPEGIFSSOQEVORYQFIVMRXLI()'0%6)WIGXMSR
ERHFSSOQEVORYQFIVEX]SYVGYVVIRXIHMXMRKPSGEXMSR8LIRXSUYMGOP]KS
XSXLI()'0%6)WIGXMSR]SY[SYPHTVIWW'XVP%JXIVPSSOMRKEX]SYV
ZEVMEFPISVGYVWSVHIGPEVEXMSRW]SY[SYPHVIXYVRXS]SYVIHMXMRKPSGEXMSRF]
TVIWWMRK'XVP
8SWIXEFSSOQEVOSVXSKSXSEFSSOQEVOXLEX]SYTVIZMSYWP]WIX]SYGER
YWIIMXLIVOI]FSEVHWLSVXGYXWSVWLSVXGYXQIRYW

To set a bookmark using a shortcut menu


1
2

6MKLXGPMGOMRXLI[MRHS[GSRXEMRMRKXLIWSYVGIGSHIERHGLSSWI
*VSQXLIHVSTHS[RPMWXWIPIGXEFSSOQEVORYQFIVJVSQXS

To set a bookmark using a keyboard shortcut


 4VIWW'XVP7LMJX QEVOIVFSSOQEVORYQFIV"*SVI\EQTPIXSWIXQEVOIV
FSSOQEVORYQFIVTVIWW'XVP7LMJX

To list bookmarks
 *VSQXLI)HMXQIRYWIPIGX0MWX&SSOQEVOW

Chapter 5

Working with SQL statements and scripts

197

To go to a bookmark using a shortcut menu


1
2

6MKLXGPMGOMRXLI[MRHS[GSRXEMRMRKXLIWSYVGIGSHI
*VSQXLIWLSVXGYXQIRYWIPIGX+SXSFSSOQEVOW

*VSQXLIHVSTHS[RPMWXWIPIGXEFSSOQEVORYQFIVJVSQXS

To go to a bookmark using a keyboard shortcut


 4VIWW'XVP QEVOIVFSSOQEVORYQFIV"*SVI\EQTPIXSVIEGLQEVOIV
FSSOQEVORYQFIVTVIWW'XVP

Previewing an objects source code


=SYGERTVIZMI[XLIWSYVGIGSHISJXI\XSFNIGXW WXSVIHTVSKVEQWXVMKKIVWERH
ZMI[W SVETEGOEKI
WMRHMZMHYEPIRXV]TSMRXW

To preview the source


1

'LSSWISRISJXLIJSPPS[MRK
 -RXLI7XSVIH4VSKVEQSV750)HMXSVGPMGOERSFNIGXREQI
 -RXLI(&2EZMKEXSVXLI*MRH3FNIGXWHMEPSKVIWYPXWXLI'SHI7IEVGL
HMEPSKVIWYPXWSVE;SVOWTEGIWIPIGXERSFNIGX

*VSQXLI:MI[QIRYGLSSWI7SYVGI4VIZMI[

Formatting source code


750)HMXSVMWMRXIKVEXIH[MXLXLI*SVQEXXIV4PYW2SXIXLEXXSYWIXLI
*SVQEXXIV4PYWWYTTPMIH[MXL7502EZMKEXSV]SYRIIHMXXSFIIREFPIHMR]SYV
PMGIRWIOI]
*SVQEXXIV4PYWTIVJSVQWJSVQEXXMRKSJXLIWIPIGXIHXI\XMJER]SVXLIIRXMVI
WSYVGIGYVVIRXP]MRXLIIHMXSVMREGGSVHERGI[MXL*SVQEXXIV4PYWWIXXMRKW-J
ER]W]RXE\IVVSVWEVIHIXIGXIHXLIXI\XWXE]WYRGLERKIHERHXLIIVVSVWEVI
HMWTPE]IHMRER3YXTYX[MRHS[

To format source code


1
2

-RXLIIHMXSVWIPIGXXLIXI\X]SY[ERXXSJSVQEX-J]SY[ERXXSJSVQEXXLI
IRXMVIWSYVGIGYVVIRXP]MRXLIIHMXSVMXMWRSXRIGIWWEV]XSWIPIGXXI\X
*VSQXLI8SSPWQIRYGLSSWI*SVQEXXIV8SSPWERHXLIRGLSSWI*SVQEX
8I\X

198

SQL Navigator Users Guide

Dragging names of database objects into code


=SYGERHVEKHEXEFEWISFNIGXREQIWMRXS]SYVIHMXMRK[MRHS[JVSQXLI(&
2EZMKEXSV[MRHS[ERHXLI;SVOWTEGI[MRHS[

To drag-and-drop names of database objects


 -RXLI(&2EZMKEXSV[MRHS[SVXLI;SVOWTEGI[MRHS[GPMGOXLISFNIGX
]SY[ERXXSVIJIVIRGIMR]SYVGSHIERHHVEKMXMRXSXLIIHMXMRK[MRHS[

Using substitution variables for flexible SQL statements


*PI\MFPI750WXEXIQIRXWEVIETS[IVJYP[E]XSMQTVSZITVSHYGXMZMX] 
750)HMXSVPIXW]SYYWIWYFWXMXYXMSRZEVMEFPIWMR750WXEXIQIRXWWMQMPEVXS
XLI[E]750 4PYWLERHPIWXLIQ
Toggle on the Scan Defines feature when
using variables or text that contain the
characters &, &&, or = :[bind variable].
Otherwise, the statement containing the
variables will generate an error.

8LIJSPPS[MRKEVIXLITVSGIHYVIWJSV
 7TIGMJ]MRKWYFWXMXYXMSRZEVMEFPIW[MXLXLI W]QFSP
 7TIGMJ]MRKWYFWXMXYXMSRZEVMEFPIW[MXLXLI W]QFSP
 (IJMRMRKERHYRHIJMRMRKRYQIVMGERHGLEVEGXIVZEVMEFPIW

Specifying substitution variables with the & symbol


=SYGERYWIXLI&W]QFSPJSPPS[IHF]EZEVMEFPIREQIXSWTIGMJ]E
WYFWXMXYXMSRZEVMEFPI*SVMRWXERGI]SYGERYWI&EMPNUMEWEZEPMH
WYFWXMXYXMSRZEVMEFPIREQI
%RI\EQTPISJER750WXEXIQIRXHIQSRWXVEXMRKXLIYWISJEWYFWXMXYXMSR
ZEVMEFPIMW
SELECT *
FROM EMP
WHERE EMPNUM = &EMPNUM;
;LIR]SYI\IGYXIXLIWXEXIQIRXEFSZIXLI750)HMXSVTVSQTXW]SYXSIRXIV
XLIZEPYIJSVXLIIQTPS]IIREQIEXVYRXMQI8LMWEPPS[W]SYXSGVIEXIKIRIVMG
750WXEXIQIRXWXLEXGERFIVIYWIH
7YFWXMXYXMSRZEVMEFPIWTIVQMXIZIRKVIEXIVJPI\MFMPMX][LIR]SY[VMXIER750
WXEXIQIRXFIGEYWI]SYGERYWIXLIQMRER]TEVXSJXLI750WXEXIQIRX*SV
I\EQTPI

Chapter 5

Working with SQL statements and scripts

199

SELECT &COL1, &COL2


FROM &TAB;
8LMWWXEXIQIRXTVSQTXW]SYXSIRXIVXLIGSPYQRREQIWEW[IPPEWXLIXEFPI
REQIEXXLIXMQISJI\IGYXMSR
=SYGERYWIXLMWGSRGITXXSGVIEXISXLIVX]TIWSJKIRIVMG750WXEXIQIRXWSV
WGVMTXW3RITVEGXMGEPETTPMGEXMSRSJXLMWGSRGITXMWGVIEXMRKEKIRIVMGWGVMTXJSV
GVIEXMRKYWIVGSHIWEX]SYVWMXI
*SVI\EQTPI
CREATE USER &&UNAME IDENTIFIED BY &PASS;
GRANT ALL ON EMP TO &&UNAME;
8LIYWISJXLIHSYFPIEQTIVWERHMWHIWGVMFIHMRXLITEVEKVETLWXLEXJSPPS[

Specifying substitution variables with the && symbol


=SYGERYWIXLIHSYFPIEQTIVWERHXLIWEQI[E]EWXLIWMRKPIEQTIVWERH
HIWGVMFIHEFSZI [MXLXLIJSPPS[MRKHMJJIVIRGIW
;LIRIZIV7502EZMKEXSVIRGSYRXIVWXLIJMVWX&&ZEVMEFPI7502EZMKEXSV
PSSOWYTXLIZEVMEFPIXSHIXIVQMRI[LIXLIVMXLEWEPVIEH]FIIRHIJMRIHMRIMXLIV
EDEFINEWXEXIQIRXSVMRETVIZMSYW&&ZEVMEFPI
 -JXLIZEVMEFPIMWHIJMRIH750)HMXSVWYFWXMXYXIWXLIZEPYIMRXLI750
WXEXIQIRX
 -JXLIZEVMEFPIMWYRHIJMRIH750)HMXSVTVSQTXW]SYXSIRXIVXLIZEPYISJ
XLIZEVMEFPIHIJMRIWXLIZEVMEFPIJSVJYXYVIPSSOYTWERHWYFWXMXYXIWXLI
ZEPYIMRXLI750WXEXIQIRX
3RGIE&&ZEVMEFPIMWHIJMRIH]SYEVIRSPSRKIVTVSQTXIHXSIRXIVMXWZEPYIMR
XLIWEQIWIWWMSRYRXMP]SYUNDEFINEXLIZEVMEFPI

Defining and undefining numeric and character variables


=SYGERYWIXLIXIVQWDEFINEERHUNDEFINEXSHIJMRIERHYRHIJMRIRYQIVMG
ERHGLEVEGXIVZEVMEFPIWMR750WGVMTXW
%PXIVREXMZIP]XSZMI[HIJMRISVYRHIJMRIXLIWYFWXMXYXMSRZEVMEFPIW]SYGER
VMKLXGPMGOMRXLI750XEFSJXLI750)HMXSV[MRHS[ERHWIPIGX(IJMRI
:EVMEFPIWJVSQXLIWLSVXGYXQIRY
=SYGEREPWSWTIGMJ][LIXLIV]SY[MWLXLIWYFWXMXYXMSRZEVMEFPIWXSVIXEMRXLIMV
ZEPYIWXLVSYKLWYFWIUYIRXWIWWMSRW

To define numeric and character variables


9WIXLIDEFINEWXEXIQIRXMRXLI750)HMXSVXSHIJMRIEWYFWXMXYXMSRZEVMEFPI
%GLEVEGXIVZEVGLEVWYFWXMXYXMSRZEVMEFPIHIJMRMXMSRYWIWWMRKPIUYSXIW

200

SQL Navigator Users Guide

DEFINE EMP_NAME=SCOTT
%RI\EQTPISJERYQIVMGWYFWXMXYXMSRZEVMEFPIHIJMRMXMSRMW
DEFINE EMP_NUM=4467

To undefine numeric and character variables


9WIXLIUNDEFINEWXEXIQIRXMRXLI750)HMXSVXSYRHIJMRIETVIZMSYWP]
HIJMRIHWYFWXMXYXMSRZEVMEFPI*SVI\EQTPI
UNDEFINE EMP_NAME

Using Bind variables


%FMRHZEVMEFPIMWEZEVMEFPIMRE750WXEXIQIRXXLEXQYWXFIVITPEGIH[MXLE
ZEPMHZEPYISVEHHVIWWSJEZEPYIMRSVHIVJSVXLIWXEXIQIRXXSWYGGIWWJYPP]
I\IGYXI
&MRHZEVMEFPIWIREFPI]SYXSYWI40750MRE750 4PYWWGVMTX8LI]TVSZMHIE
QIGLERMWQJSVVIXYVRMRKHEXEJVSQE40750FPSGOWSXLEXMXGERFIYWIHMR
WYFWIUYIRXUYIVMIW
8LI750)HMXSVWYTTSVXWFMRHZEVMEFPIWYWIXLIQXLIWEQI[E]EW]SY[SYPH
YWIXLIQMR750 4PYW
,IVIMWERI\EQTPISJLS[XSHIGPEVIEFMRHZEVMEFPI
VARIABLE s_table_name varchar2(30)
8SVIJIVIRGIEFMRHZEVMEFPIMRE40750FPSGOTVIJEGIMX[MXLEGSPSR  
BEGIN
:s_table_name := EMPLOYEE;
END;
/

Debugging a variable in the SQL Editor


-RXLI750)HMXSV]SYGERYWIXLI(IFYK:EVMEFPIJYRGXMSRXSUYMGOP]GVIEXIE
(&17C398498498C0-2)WXEXIQIRXJSVXLIWIPIGXIHZEVMEFPIMRXLIIHMXSV

To generate a debug statement


1

2

4PEGIXLIGYVWSVSRXLIZEVMEFPIERHTVIWW*
8LIHIFYKWXEXIQIRXMWXLIRKIRIVEXIHERHGSTMIHXSXLIGPMTFSEVH
8STPEGIXLIWXEXIQIRXMR]SYVGSHIQSZIXLIGYVWSVXSXLIHIWMVIH
TSWMXMSRERHXLIRGLSSWI4EWXISVX]TI'XVP:

Chapter 5

Working with SQL statements and scripts

201

Integrated impact analysis and quality assurance


7502EZMKEXSVGERFIMRXIKVEXIH[MXL750-QTEGXXSTVSZMHIMQTEGXEREP]WMW
ERHUYEPMX]EWWYVERGIJVSQER]750IHMXSV
5YIWX7SJX[EVI
W750-QTEGXMWERIEW]XSYWI;MRHS[WFEWIHETTPMGEXMSR
XLEXTVSZMHIWEGSQTPIXITMGXYVISJXLIVIPEXMSRWLMTWFIX[IIR]SYVHEXEFEWIW
ERHETTPMGEXMSRW-XEPPS[W]SYXSHIXIVQMRIUYMGOP]LS[GLERKIWXSTVSKVEQW
[MPPEJJIGXHEXEFEWISFNIGXWERHZMGIZIVWE
=SYGEREPWSYWI750-QTEGXXSTMRTSMRXQER]X]TIWSJ750UYEPMX]TVSFPIQW
TVSFPIQWXLEXEVISJXIRHMJJMGYPXXSMHIRXMJ]I\GITXF]XIWXMRKERHIZIR
TVSFPIQWXLEXQMKLXRSXFIJSYRH[MXLXIWXMRK750-QTEGXIEWMP]MHIRXMJMIW
MRIJJIGXMZISVMREGGYVEXIGSHIERHVIZIEPW750YWEKITVSFPIQWWYGLEW
VIJIVIRGIWXSRSRI\MWXIRXSFNIGXWERHMQTVSTIVNSMRMRK8LMWEPPS[W]SYXS
WTIRHPIWWXMQIWIEVGLMRKJSVIVVSVWERHQSVIXMQIGSVVIGXMRKXLIQ

Entering multiple SQL statements


=SYGERIRXIVQYPXMTPI750WXEXIQIRXWMRXLI750IHMXMRK[MRHS[)EGL750
WXEXIQIRXQYWXIRH[MXLIMXLIV
 EWIQMGSPSR  
 EFPEROPMRISV
 SRXLIRI\XPMRI
8LI750)HMXSVHSIWRSXI\IGYXIRIWXIH750WGVMTXW0MRIWFIKMRRMRK[MXLXLI
$GSQQERHSJ750 4PYWEVIMKRSVIH

To insert a saved text file into the SQL Editor

3TIRXLI750)HMXSVERHTPEGIXLIGYVWSV[LIVI]SY[ERXXLIWEZIHXI\X
JMPIXSFIMRWIVXIH
*VSQXLI)HMXQIRYGLSSWI-RWIVXERHXLIR*MPI

4SMRXXSXLIJMPI]SY[ERXXSMRWIVXERHXLIRGPMGO3/ 

Entering PL/SQL blocks


40750FPSGOWIRXIVIHMRXSXLIWGVMTXQYWXLEZIIMXLIV
 EJSV[EVHWPEWL
 SVETIVMSHQEVO
JSPPS[MRKXLIPEWXPMRISJXLIFPSGO
8LMWMWRIGIWWEV]FIGEYWIXLI40750FPSGOWGERXLIQWIPZIWGSRXEMRFPERO
PMRIWERHWIQMGSPSRW
;LIR]SYGVIEXISVI\IGYXIE40750ERSR]QSYWFPSGOXLIWIQMGSPSRWEVI
VIUYMVIHMRXLI750WXEXIQIRX*SVI\EQTPI

202

SQL Navigator Users Guide

BEGIN
Test_procedure;
END;

Copying selected text


=SYGERGST]XSERHTEWXIJVSQXLIGPMTFSEVHYWMRKXLIWXERHEVH;MRHS[W
OI]FSEVHWLSVXGYXW

To copy to the clipboard


 'LSSWISRISJXLIJSPPS[MRK
 'PMGOXLI'ST]FYXXSRSRXLI)HMXSV8SSPFEV
3V
 4VIWW'XVP'

To paste from the clipboard


 'LSSWISRISJXLIJSPPS[MRK
 'PMGOXLI4EWXIFYXXSRSRXLI)HMX8SSPFEV
3V
 4VIWW'XVP:

Creating a DBMS_OUTPUT.PUT_LINE statement


=SYGERUYMGOP]GVIEXIE(&17C398498498C0-2)WXEXIQIRXJSVXLI
WIPIGXIHZEVMEFPIMRXLIIHMXSV

To create a DBMS_OUTPUT.PUT_LINE statement for a variable


 'LSSWISRISJXLIJSPPS[MRK
 'PMGOXLI(&17C398498498C0-2)FYXXSR
3V
 4VIWW'XVP(
3V
1 4PEGIXLIGYVWSVSRXLIZEVMEFPIERHTVIWW*
2 8STPEGIXLIWXEXIQIRXMR]SYVGSHIQSZIXLIGYVWSVXSXLIHIWMVIH
TSWMXMSRERHWIPIGX4EWXISVX]TI'XVP:

Chapter 5

Working with SQL statements and scripts

203

Jumping to a specified line


To go to a line number
 'LSSWISRISJXLIJSPPS[MRK
 'PMGOXLI+SXS0MRIFYXXSRMRXLI)HMXQIRY
3V
 4VIWW%PX+

Indenting and unindenting


To increase or decrease the indent of selected text
 'LSSWISRISJXLIJSPPS[MRK
 'PMGOXLI-RHIRX9RMRHIRXFYXXSRMRXLI)HMXQIRY
3V
 4VIWW'XVP- MRHIRX SV'XVP9 YRMRHIRX 

Inserting a CRUD matrix


-RWIVXE'69( 'VIEXI9THEXI(IPIXI QEXVM\EWGSQQIRXXI\X
 'LSSWISRISJXLIJSPPS[MRK
 'PMGOXLI'69(1EXVM\FYXXSR
3V
 'LSSWI)HMX -RWIVX '69(1EXVM\JVSQXLIQEMRQIRY

Inserting ready-made code from templates


To insert prepared code into the editor
1
2
3
4

4PEGIXLIGYVWSVMRXLIIHMXSV[MRHS[[LIVI]SY[ERXXLIGSHIXSFI
MRWIVXIH
4VIWW'XVPJ8LIXIQTPEXIREQIWHMWTPE]MREHVSTHS[RPMWX
7IPIGXXLIREQISJXLIXIQTPEXI]SY[ERXXSMRWIVXJVSQXLIHVSTHS[R
PMWX 
4VIWW)RXIV

204

SQL Navigator Users Guide

Recalling previously executed SQL


=SYGERIEWMP]VIGEPPXLIQSWXVIGIRX750WXEXIQIRXWXLEXLEZIFIIRI\IGYXIH
MRXLIGYVVIRXWIWWMSR YTXSXIR =SYGERWTIGMJ]XLIFILEZMSVSJXLMWJIEXYVI
MRXLI750)HMXSVTVIJIVIRGIWWIXXMRKJSV4VIZMSYW7500MQMX

To recall previously executed SQL


1
2

-RXLI750)HMXSVXSSPFEVGPMGOXLI
7XEXIQIRX6IGEPPFYXXSR
-RXLI7507XEXIQIRX6IGEPP[MRHS[WIPIGXXLIWXEXIQIRX]SY[ERXXS
VIGEPP=SYGERTVIWW'XVPYTEVVS[XSQSZIFEGOMRXLIWIUYIRGIERH
'XVPHS[REVVS[XSQSZIJSV[EVH
4MRXLIPS[IVTEVXSJXLI[MRHS[GPMGOEFYXXSRXSWIPIGXXLIIHMXMRKVIWYPX
]SY[ERX
 )HMXSV6ITPEGIXSVITPEGIXLIGYVVIRXGSRXIRXWSJXLIIHMXMRK[MRHS[
 )HMXSV%TTIRHXSEHHXLIVIGEPPIHWXEXIQIRXXSXLIGYVVIRXGSRXIRXW
 'ST]XS'PMTFSEVHMJ]SY[ERXXSGST]ERHTEWXIXLIWXEXQIRXMRXS
ERSXLIVPSGEXMSR
 6IQSZIXSHVSTXLIWXEXIQIRXJVSQXLI7507XEXIQIRX6IGEPPPMWX

Using bookmarks
=SYGERYWIFSSOQEVOWXSQEVOPSGEXMSRWMR]SYVGSHI

To set a bookmark
 'LSSWISRISJXLIJSPPS[MRK
 4VIWW'XVP7LMJX FSSOQEVORYQFIV"
3V
 6MKLXGPMGOXSMRZSOIXLIWLSVXGYXQIRYERHWIPIGX8SKKPIFSSOQEVOW 
FSSOQEVORYQFIV"

To go to a bookmark
 'LSSWISRISJXLIJSPPS[MRK
 4VIWW'XVP FSSOQEVORYQFIV"
3V
 6MKLXGPMGOXSMRZSOIXLIWLSVXGYXQIRYERHWIPIGX+SXSFSSOQEVOW 
FSSOQEVORYQFIV"

Chapter 5

Working with SQL statements and scripts

205

Undo or Redo your editing operations


To undo or redo an editing operation
 'LSSWISRISJXLIJSPPS[MRK
 'PMGOXLI9RHSSV6IHSFYXXSR
3V
 4VIWW'XVP> 9RHS SV'XVP= 6IHS 

Tuning with the Explain Plan tool


9WIXLI)\TPEMR4PERXSSPXSXYRIMRHMZMHYEP750WXEXIQIRXW8LMWXSSPPIXW
]SY 
 KIRIVEXITPERWERHWEZIXLIQMRXLIXEFPISJ]SYVGLSMGI
 SVKERM^I]SYVWEZIHTPERWF]ZEVMSYWGVMXIVMEWYGLEWX]TI JSVI\EQTPI
SRPMRI750WXEXIQIRXWFEXGL750WXEXIQIRXWERHWSSR QSHYPISV
WYFW]WXIQ
 FYMPHWITEVEXITPERXEFPIWJSVHMJJIVIRXWYFW]WXIQWMR]SYVTVSNIGX
 FVS[WIIEGLXEFPIWITEVEXIP]
8LI)\TPEMR4PERXSSPYWIWER3VEGPIGSQQERHXSHMWTPE]XLII\IGYXMSR
TPERXLIWIUYIRGISJHEXEFEWISTIVEXMSRWGLSWIRF]XLI3VEGPISTXMQM^IV
JSVMRHMZMHYEP7)0)'894(%8)-27)68ERH()0)8)WXEXIQIRXW
8LI%REP]^IXSSPGERFIYWIHMRGSRNYRGXMSR[MXLXLI)\TPEMR4PERXSSP8LI
)\TPEMR4PER8SSPHSIWRSXEREP]^IXEFPIWMXWIPJTVMSVXSI\IGYXMRKXLI)\TPEMR
4PERFYXMXHSIWLEZIEXSSPFEVFYXXSRJSVQERYEPPEYRGLSJXLI%REP]^I8SSP

Analyzing queries with Explain Plan


8LI)\TPEMR4PERXSSPYWIWER3VEGPIGSQQERHXSHMWTPE]XLII\IGYXMSR
TPERXLIWIUYIRGISJHEXEFEWISTIVEXMSRWGLSWIRF]XLI3VEGPISTXMQM^IV
JSVMRHMZMHYEP7)0)'894(%8)-27)68ERH()0)8)WXEXIQIRXW
The Explain Plan tool can be used to analyze the
execution of single SQL statements only.

&]I\EQMRMRKXLII\IGYXMSRTPER]SYGERWIII\EGXP]LS[3VEGPII\IGYXIW
]SYV750WXEXIQIRXERHLS[MXGERFIMQTVSZIH
9WIXLI)\TPEMR4PER[MRHS[XSEREP]^I750WXEXIQIRXWF]KIRIVEXMRKER
3VEGPII\IGYXMSRTPERERHXSZMI[SVTVMRXWXSVIHI\IGYXMSRTPERWTVIZMSYWP]
KIRIVEXIH

206

SQL Navigator Users Guide

To change default preferences for the Explain Plan tool


1
2

*VSQXLI:MI[QIRYGLSSWI4VIJIVIRGIW")\TPEMR4PER
7IXXLIHIJEYPXS[RIVERHREQIJSVXLIXEFPI]SY[ERXXSYWIXSWXSVI
I\IGYXMSRTPERW

To execute an Explain Plan for a SQL Statement


1
2

3
4

5
6
7
8
9

-RXLI750)HMXSVGPMGOXLI750XEFERHXLIRX]TISVPSEHXLI750
WXEXIQIRX]SY[ERXXSMRZIWXMKEXI 
7IPIGX F]LMKLPMKLXMRK SRISVQSVIWXEXIQIRXWXSFIEREP]^IH
%PXIVREXMZIP]MJ]SYWIPIGXRSRIEPPWXEXIQIRXWMRXLIIHMXMRK[MRHS[[MPP
FIEREP]^IH
8SHVEKERHHVSTER]STXMQM^IVLMRXMRXS]SYV750WGVMTXYWIXLI'SHI
%WWMWXERX
-J]SYEVIVIUYMVIHXSWTIGMJ]XLIXEFPISVMRHI\REQI]SYGERYWIXLI1]
8EFPIWERH-RHI\IW2EZMKEXSVJMPXIVXSHVEKERHHVSTXLIXEFPIERHMRHI\
REQI =SYGERYWIER]2EZMKEXSVJMPXIVXSTIVJSVQXLIHVEKERHHVST
STIVEXMSR 
-JVIUYMVIH]SYGERIRXIVE7XEXIQIRX-(XSMHIRXMJ]XLIWXEXIQIRX[MXLMR
XLIGYVVIRXTPERXEFPI
8SWEZIXLI750EPSRK[MXLXLIKIRIVEXIHTPERWIPIGX7EZI750XI\X
-J]SY[ERXXSLEZIEGSQQIRXEFSYXXLIKIRIVEXIHTPERHMWTPE]MRXLI
+IRIVEXIH4PER&VS[WIVIRXIVMXMRXLI'SQQIRXJMIPH
=SYGERIRXIVXLI4PER8EFPI3[RIVSVYWIXLIHIJEYPXPMWXIH
=SYGERIRXIVXLI4PER8EFPI2EQISVYWIXLIHIJEYPXPMWXIH-JWTIGMJ]MRKE
RI[TPERXEFPIYWIXLI'VIEXI8EFPIFYXXSRXSGVIEXIXLIXEFPI

10 'PMGO
MRXLI*YRGXMSRWXSSPFEVXSMRZSOIXLI)\TPEMR4PERXSSP8LI
WXEXIQIRXWIPIGXIHMRXLI750)HMXSVETTIEVWMRXLIXSSP
W+IRIVEXI4PER
[MRHS[
11 'PMGO)\TPEMR4PERXSZMI[XLI3VEGPII\IGYXMSRTPERJSVXLIWXEXIQIRX

Viewing the Explain Plan tree


8LIKIRIVEXIHI\IGYXMSRTPERMWHMWTPE]IHMRXLIPS[IVTEVXSJXLI)\TPEMR4PER
[MRHS[=SYGERGPMGOSRRSHIWXSI\TERHERHGSPPETWIXLIQ

Printing the Explain Plan tree


=SYGERYWIXLI4VMRXGSQQERHJVSQXLI*MPIQIRYSVXLI4VMRXFYXXSRSR)HMX
XSSPFEVXSSYXTYX)\TPEMR4PERXVIIHEXEXSXLITVMRXIV8LIJSPPS[MRKHEXEMW
TVMRXIH

Chapter 5

Working with SQL statements and scripts

207

 8LI7507XEXIQIRXJVSQ[LMGLXLII\TPEMRTPERXVII[EWHIVMZIH
 7XEXIQIRX-(8]TI'SWXERH8MQIWXEQT
 8LI)\TPEMR4PERXVIIMRGPYHMRKXLII\IGYXMSRWIUYIRGIRYQFIVWMR
FVEGOIXW
8STVIZMI[]SYVSYXTYXYWIXLI4VMRXTVIZMI[GSQQERHJVSQXLI*MPIQIRY
When an Explain Plan tree printout exceeds one
page, the headings (such as the SQL Text and
statement ID lines) are not repeated. This makes it
easy for you to tile multiple pages together to
display the explain plan tree as a single diagram

Viewing an Operation Description


=SYGERZMI[ERI\TPEREXMSRGEPPIHER3TIVEXMSR(IWGVMTXMSRSJZEVMSYW
RSHIW]SYWIPIGXMRXLI)\TPEMR4PERXVII8LI3TIVEXMSR(IWGVMTXMSR[MRHS[
HMWTPE]WERI\TPEREXMSRSJLS[IEGL750STIVEXMSRMWI\IGYXIHMRVIPEXMSRMR
XLI)\TPEMR4PER
=SYYWIEGLIGOFS\MRXLI)\TPEMR4PER[MRHS[XSHMWTPE]XLI3TIVEXMSR
(IWGVMTXMSR8LIWIXXMRK]SYWIPIGX[MPPFIWXSVIHMRXLIVIKMWXV]ERHVIMRWXEXIH
IEGLXMQI]SYEGXMZEXIXLI)\TPEMR4PER[MRHS[;LIR]SYGPSWIXLI)\TPEMR
4PER[MRHS[XLI3TIVEXMSR(IWGVMTXMSRJSVQMWEPWSGPSWIH

To view the Operation Description


 -RXLI)\TPEMR4PER[MRHS[WIPIGXXLI7LS[(IWGVMTXMSRGLIGOFS\ERH
XLIRWIPIGXERSHIMRXLI)\TPEMRTPERXVII

Browsing saved plans


=SYGERFVS[WIWEZIHI\IGYXMSRTPERW

To use the saved plans browser


1
2
3

-RXLI)\TPEMR4PER[MRHS[GPMGOXLI&VS[WI7EZIH4PERWXEF
)RXIVXLITPERXEFPIREQIERHS[RIV
'PMGOXLI0SEH4PERWFYXXSRXSPSEHTPERWWEZIHMRXLITPERXEFPI

4
5

9WIXLIWGVSPPFEVWXSPSGEXIEWEZIHTPER
'PMGOXLIWEZIHTPERXSHMWTPE]MXMRXLITPER[MRHS[

208

SQL Navigator Users Guide

Tuning a SQL script


;LIR]SYYWIXLI750)HMXSVXSI\IGYXIE750WGVMTXSRER3VEGPIHEXEFEWI
]SY[MPPWSQIXMQIWJMRHXLEXXLIWGVMTXI\IGYXIWQSVIWPS[P]XLERI\TIGXIH-X
QE]FIXLEXSRISVQSVIWXEXIQIRXWMRXLIWGVMTXEVIMRIJJMGMIRXERHGERFI
MQTVSZIH
-JXLI]EVIMRWXEPPIH]SYGERYWIXLI)\TPEMR4PERXSSPERHXLI<TIVX8YRMRK
TVSHYGXXSEREP]^I]SYV750WGVMTXWJSVMRIJJMGMIRGMIW
'PMGOLIVIJSVMRJSVQEXMSREFSYXEREP]^MRKUYIVMIW[MXL)\TPEMR4PER

Xpert Tuning
5YIWX7SJX[EVI
W<TIVX8YRMRKTVSHYGXMWRSXEZEMPEFPIMREPPMRWXEPPEXMSRW
GSRXEMRMRKXLI750)HMXSV
,S[IZIVMJ]SYLEZIMRWXEPPIH<TIVX8YRMRK]SYGERYWIXLIXYRMRKSTXMSRXS
EREP]^IERHXYRIXLII\IGYXMSRSJ750WGVMTXW
Xpert Tuning can be used to analyze the
execution of SQL scripts containing more than
one statement.

<TIVX8YRMRKQEOIWSFWIVZEXMSRWEFSYXEWIPIGXIH750WXEXIQIRXERHXLI
YRHIVP]MRKHEXEFEWIIRZMVSRQIRXERHXLIRVIGSQQIRHWWIZIVEPSTXMSRWXS
MQTVSZITIVJSVQERGI9WIVWGERZMI[XLIPSKMGFILMRHXLIEHZMGIMQTPIQIRX
XLIVIGSQQIRHEXMSRETTP]MXXSXLIHEXEFEWIERHWIIXLIVIWYPXW8LI<TIVX
8YRMRKQSHYPIEYXSQEXMGEPP]TVSHYGIWEPPRIGIWWEV]750XSIJJIGXXLI
GSVVIWTSRHMRKGLERKI
8SVYR<TIVX8YRMRK
1 1EOIWYVIXLEX<TIVX8YRMRKMWMRWXEPPIHERHEHHXLI<TIVX8YRMRK
XSSPFEVFYXXSRXSXLI*YRGXMSRWXSSPFEV
2 3TIRXLI750)HMXSVGPMGOXLI750XEFERHX]TISVPSEHXLI750
WXEXIQIRX]SY[ERXXSMRZIWXMKEXI
3 ,MKLPMKLXXLIXI\XSJXLI750WXEXIQIRXXSWIPIGXMX
4 *VSQXLI8SSPWQIRYWIPIGX<TIVX8YRMRK
*SVQSVIHIXEMPWWIIXLISRPMRILIPTWYTTPMIH[MXLXLI<TIVX8YRMRKTVSHYGX

Chapter 5

Working with SQL statements and scripts

209

To set editor preferences


1
2

*VSQXLI:MI[QIRYGLSSWI4VIJIVIRGIW
'PMGO'SHI)HMXSVWERHXLIRGLSSWI750)HMXSV

7IPIGXSVGPIEVTVIJIVIRGIW

Working with code templates and shortcuts


=SYGERYWIXLI'SHI7LSVXGYXWERH8IQTPEXIWHMEPSKXSGVIEXI]SYVS[RGSHI
XIQTPEXIWIHMXSVHIPIXII\MWXMRKSRIWSVGLERKIXLIWLSVXGYXOI]HIJMRMXMSRW
EXXEGLIHXSEXIQTPEXI

To open the Code Shortcuts and Templates dialog


 *VSQXLI:MI[QIRYWIPIGX
4VIJIVIRGIW 'SHI)HMXSVW 40750 8IQTPEXIW )HMX'SHI7LSVXGYXW

To insert code from a template


1

4PEGIXLIGYVWSV[LIVI]SY[ERXXSMRWIVXXLIGSHIWIKQIRX

'LSSWISRISJXLIJSPPS[MRK
 -J]SYORS[XLIOI]FSEVHWLSVXGYXEWWMKRIHXSXLIGSHIWIKQIRX]SY
[ERXXLIRWMQTP]X]TIXLIWLSVXGYX
 -J]SYORS[XLIREQISJXLIGSHIWIKQIRX]SY[ERXSVTEVXSJXLI
REQIXLIRX]TIXLIJYPPSVTEVXMEPREQIERHTVIWW'XVPJXSIMXLIV
MRWIVXXLIQEXGLMRKGSHIWIKQIRXSVGLSSWIJVSQEPMWXSJQEXGLIW
 8SHMWTPE]EJYPPPMWXSJEZEMPEFPIXIQTPEXIWTVIWW'XVPJERHXLIRWIPIGX
XLIXIQTPEXIREQIJVSQXLIHVSTHS[RPMWXERHTVIWW)RXIV

To create a new template


1
2
3

-RXLI'SHI7LSVXGYXWERH8IQTPEXIWHMEPSKGPMGO%HH
-RXLI2I[8IQTPEXIHMEPSKX]TIEREQIJSVXLIRI[XIQTPEXIERHGPMGO
3/%XIQTPEXIREQIQYWXFIEWMRKPI[SVH[MXLRSWTEGIW
-RXLI'SHIGSPYQRSJXLIRI[VS[X]TIXLI750GSHIJSVXLIXIQTPEXI

-RXLI(IWGVMTXMSRGSPYQRSJXLIRI[VS[]SYGERX]TIEWLSVX
HIWGVMTXMSR
-RXLI7LSVXGYXOI]GSPYQRSJXLIRI[VS[]SYGERWIPIGXEWLSVXGYXOI]
GSQFMREXMSRJVSQXLSWIWXMPPPMWXIHEWEZEMPEFPI
-J]SY[ERXXSLEZIRSWLSVXGYXOI]WIPIGX2SRI

'PMGO3/

4
5

210

SQL Navigator Users Guide

To edit an existing template


1
2
3

3RXLI'SHI7LSVXGYXWERH8IQTPEXIWHMEPSKWIPIGXEXIQTPEXIJVSQXLI
8IQTPEXIWTERI
1SHMJ]XLI750GSHIMRXLI'SHITERIEWVIUYMVIH
'PMGO3/
You cannot change a template name. Instead, you
can delete an existing template and create
another like it with a different name.

To delete a template
1
2
3

3RXLI'SHI7LSVXGYXWERH8IQTPEXIWHMEPSKWIPIGXEXIQTPEXIJVSQXLI
8IQTPEXIWTERI
'PMGO(IPIXI
3RXLI'SRJMVQEXMSRQIWWEKIGPMGO=IW
You cannot delete all the templates. There must
be at least one template remaining in the Code
Templates and Shortcuts dialog.

Customizing SQL Editor toolbars


=SYGERGYWXSQM^IFSXLXLIGSRXIRXWERHETTIEVERGISJXLI750)HMXSV
XSSPFEVW=SYGER
 ,MHISVWLS[XSSPFEVW
 %HHERHVIQSZIXSSPFEVFYXXSRW
 'YWXSQM^IXSSPFEVFYXXSRETTIEVERGI

Hiding or showing toolbars


=SYGERLMHISVWLS[EXSSPFEVMRX[S[E]W
9WYEPP]XLIUYMGOIWX[E]MWXSVMKLXGPMGOMRXLIXSSPFEVEVIEERHWIPIGXE
XSSPFEVJSVHMWTPE]SVGPIEVEWIPIGXMSR
-J]SYEVIGYWXSQM^MRKFYXXSRWERHXSSPFEVW]SYGEREPWSWLS[SVLMHI
XSSPFEVWJVSQXLI'YWXSQM^ISTXMSR

Chapter 5

Working with SQL statements and scripts

211

To quick-select toolbars
1
2

6MKLXGPMGOMRXLIXSSPFEVEVIESJXLI750)HMXSV
'PMGOSREGLIGOFS\XSWIPIGXSVHIWIPIGXMX8LIGSVVIWTSRHMRKXSSPFEV
ETTIEVWSRSVHMWETTIEVWJVSQXLIXSSPFEVEVIE

To customize toolbars
1
2
3
4

'PMGOXLI1SVI&YXXSRWFYXXSRSREHSGOIHXSSPFEVSVXLIGSVVIWTSRHMRK
HS[REVVS[SREJPSEXMRKXSSPFEV
'PMGO%HHSV6IQSZI&YXXSRWERHXLIRGLSSWIXLI'YWXSQM^ISTXMSR
'PMGOXLI8SSPFEVWXEFERHXLIRWIPIGXEGLIGOFS\XSLMHISVWLS[XLI
GSVVIWTSRHMRKXSSPFEV
'PMGO'PSWIXSVIXYVRXS7502EZMKEXSV

Adding and removing toolbar buttons


=SYGEREHHSVVIQSZIXSSPFEVFYXXSRWMRX[S[E]W
 F]LMHMRKSVWLS[MRKXLIFYXXSRWGYVVIRXP]EWWMKRIHXSEXSSPFEV
 F]EWWMKRMRKFYXXSRWXSSVVIQSZMRKXLIQJVSQXLIXSSPFEV

To hide or show a button


1
2
3

'PMGOXLI1SVI&YXXSRWFYXXSRSREHSGOIHXSSPFEVSVXLIGSVVIWTSRHMRK
HS[REVVS[SREJPSEXMRKXSSPFEV
'PMGO%HHSV6IQSZI&YXXSRWERHXLIRGPMGOSREGLIGOFS\XSLMHISV
WLS[XLIGSVVIWTSRHMRKFYXXSR
'PMGOSYXWMHIXLIQIRYXSVIXYVRXSXLI750)HMXSV

To assign a button

2
3

'PMGOXLI1SVI&YXXSRWFYXXSRSREHSGOIHXSSPFEVSVXLIGSVVIWTSRHMRK
HS[REVVS[SREJPSEXMRKXSSPFEV
'PMGO%HHSV6IQSZI&YXXSRWERHXLIRGLSSWIXLI'YWXSQM^ISTXMSR
-RXLI'SQQERHWXEFWIPIGXE'EXIKSV]XSZMI[XLIEZEMPEFPIGSQQERHW

4
5

*VSQXLI'SQQERHWPMWXHVEKEFYXXSRSRXSXLIHIWMVIHXSSPFEV
'PMGO'PSWIXSVIXYVRXSXLI750)HMXSV

212

SQL Navigator Users Guide

To remove a button

2
3

'PMGOXLI1SVI&YXXSRWFYXXSRSREHSGOIHXSSPFEVSVXLIGSVVIWTSRHMRK
HS[REVVS[SREJPSEXMRKXSSPFEV
'PMGO%HHSV6IQSZI&YXXSRWERHXLIRGLSSWIXLI'YWXSQM^ISTXMSR
(VEKXLIYR[ERXIHFYXXSRSJJMXWXSSPFEV

'PMGO'PSWIXSVIXYVRXSXLI750)HMXSV

Customizing toolbar button appearance


=SYGERYWIXLI1SVI&YXXSRWQIRYXSGLERKIXLI[E]MR[LMGLFYXXSRW
ETTIEVSRXLIXSSPFEV

To customize button appearance


1
2
3
4

'PMGOXLI1SVI&YXXSRWFYXXSRSREHSGOIHXSSPFEVSVXLIGSVVIWTSRHMRK
HS[REVVS[SREJPSEXMRKXSSPFEV
'PMGO%HHSV6IQSZI&YXXSRWERHXLIRGLSSWIXLI'YWXSQM^ISTXMSR
-KRSVMRKXLI'YWXSQM^IHMEPSKQSZIXLIQSYWITSMRXIVSZIVEFYXXSRMR
SRISJXLIlPMZIzXSSPFEVWERHVMKLXGPMGO
'LSSWIERSTXMSRJVSQXLIWLSVXGYXQIRY=SYGERGLSSWIXSVIWIXXLI
XSSPFEVHIPIXISVVIREQIXLIWIPIGXIHFYXXSRGLERKIMXWETTIEVERGISV
EHHEWITEVEXSV
'PMGO'PSWIMRXLI'YWXSQM^IHMEPSKXSVIXYVRXSXLI750)HMXSV

Fast query building with the Query Builder


8SIEWMP]GVIEXIXLIJVEQI[SVOJSV7)0)'8-27)6894(%8)ERH()0)8)
750WXEXIQIRXWYWIXLI5YIV]&YMPHIV
8LI5YIV]&YMPHIVTVSZMHIWERIEW][E]XSFYMPHERHXIWXEUYIV]
=SYGERYWIXLI5YIV]&YMPHIVXSGVIEXIXLIJVEQI[SVOSJSELECTUPDATE
INSERTERHDELETEWXEXIQIRXWMR]SYVGSHI8LI5YIV]&YMPHIV[MPPWEZI
]SYXMQIMRFYMPHMRK750WXEXIQIRXWF]PIXXMRK]SYWIPIGXGSPYQRREQIWJVSQ
EPMWXXSTPEGIXLIQMRXS]SYVGSHI=SYGEREPWSYWIXLI5YIV]&YMPHIVXS
UYMGOP]FYMPHEREHLSGUYIV]MJ]SYRIIHXSI\EQMRIXLIHEXEMREXEFPI
5YIV]&YMPHIVMWEP[E]WEZEMPEFPIJVSQXLI8SSPWQIRYERHXLI*YRGXMSRW
XSSPFEV


8LI5YIV]&YMPHIVFYXXSRMGSR

Chapter 5

Working with SQL statements and scripts

213

=SYGEREPWSYWIXLI5YIV]&YMPHIVXSUYMGOP]FYMPHEREHLSGUYIV]MJ]SY
RIIHXSI\EQMRIXLIHEXEMREXEFPI



The Query Builder window


8LI5YIV]&YMPHIV[MRHS[LEWX[SVIWM^EFPITERIW
 %[SVOEVIE XSTTERI [LIVI]SYWIPIGXXLIGSPYQRW]SY[ERXMR]SYV
UYIV]ERH[LIVI]SYGEREPWSIEWMP]GVIEXINSMRWF]HVEKKMRKGSPYQR
REQIW
 %UYIV]HMWTPE]EVIE FSXXSQTERI [LIVI]SYGERZMI[]SYVUYIV]MRX[S
HMJJIVIRX[E]WEWMXMWFIMRKFYMPXEW750GSHISVEWEHEXEKVMH=SYGER
EPWSWIXGVMXIVMEMRXLMWEVIE

214

SQL Navigator Users Guide

Quickly build complex SQL statements


;MXL7502EZMKEXSV
W5YIV]&YMPHIV]SYGERUYMGOP]FYMPHGSQTPI\750
WXEXIQIRXWF]HVEKKMRKXEFPIWJVSQEPMWXMRXSE[SVOEVIEGLIGOMRKVIUYMVIH
JMIPHWERHPMROMRKXLIQYWMRKEHVEKERHHVSTXIGLRMUYI

Sort and group


5YIV]JIEXYVIWEPWSMRGPYHIWSVXMRKERHKVSYTMRKEWIPIGXMSRGVMXIVMEFYMPHIV
ERHQSVI

Save and re-use queries


5YIVMIWGERFIWEZIHXSHMWOJSVPEXIVVIYWI

Execute and Roll-back


=SYGERSTIRE8IWX[MRHS[XSI\IGYXI750XLIREYXSQEXMGEPP]VSPPFEGOER]
GLERKIW YTHEXIWHIPIXIWSVMRWIVXW 'PSWMRKXLI8IWX[MRHS[VIPEYRGLIW
5YIV]&YMPHIV
8LI5YIV]&YMPHIV[MRHS[LEWX[SVIWM^EFPITERIW
 %[SVOEVIE XSTTERI [LIVI]SYWIPIGXXLIGSPYQRW]SY[ERXMR]SYV
UYIV]ERH[LIVI]SYGEREPWSIEWMP]GVIEXINSMRWF]HVEKKMRKGSPYQR
REQIW
 %UYIV]HMWTPE]EVIE FSXXSQTERI [LIVI]SYGERZMI[]SYVUYIV]MRX[S
HMJJIVIRX[E]WEWMXMWFIMRKFYMPXEW750GSHISVEWEHEXEKVMH=SYGER
EPWSWIXGVMXIVMEMRXLMWEVIE

Query Builder quick reference


8LI5YIV]&YMPHIVTVSZMHIWERIEW][E]XSFYMPHERHXIWXEUYIV]=SYGER
EPWSYWIXLI5YIV]&YMPHIVXSUYMGOP]FYMPHEREHLSGUYIV]MJ]SYRIIHXS
I\EQMRIXLIHEXEMREXEFPI
5YIV]&YMPHIVMWEP[E]WEZEMPEFPIJVSQXLI8SSPWQIRYERHJVSQXLI
*YRGXMSRWXSSPFEV

To get started with the Query Builder

6MKLXGPMGOMRXLI5YIV]&YMPHIV[SVOEVIEXSWLS[XLI%HH3FNIGXQIRY
MXIQ
'PMGOXLI%HH3FNIGXXSSPFEVFYXXSRSRXLI5YIV]&YMPHIV[MRHS[SV

(VEKERH(VSTERSFNIGXJVSQXLI(&2EZMKEXSVMRXSXLI[SVOWTEGIEVIE

Chapter 5

Working with SQL statements and scripts

215


If you want to
3TIREUYIV]FYMPHIV[MRHS[

Then
'PMGOXLI5YIV]&YMPHIVMGSR
SV



'LSSWI8SSPW 5YIV]&YMPHIVJVSQXLIQEMR
QIRYFEV

'VIEXIERI[UYIV]

1. 'PMGOXLI2I[5YIV]XSSPFEV
FYXXSRSVGLSSWI2I[5YIV]JVSQ
XLIWLSVXGYXQIRY

2. (IJMRIXLIX]TISJWXEXIQIRX]SY[ERXXS
GVIEXIF]WIPIGXMRKEFYXXSRMRXLIXSSPFEVJSV
7IPIGX9THEXI(IPIXISV-RWIVX

3TIREWEZIHUYIV]

'PMGOXLI3TIR5&(*MPI
XSSPFEVFYXXSRSVGLSSWI
3TIR5&(*MPIJVSQXLI
WLSVXGYXQIRY

%HHEXEFPIREQIXSXLIUYIV]

'PMGOXLI%HH%RSXLIV8EFPI
:MI[SV7]RSR]QXSSPFEV
FYXXSRSVGLSSWI%HH(&
3FNIGXJVSQXLIWLSVXGYX
QIRY







7TIGMJ]EXEFPIGSPYQRXSFIEHHIH -RXLI[SVOEVIEWIPIGXEGSPYQRREQIERH
XSXLIUYIV]
HVEKMXMRXSXLIHEXEKVMHSVGPMGOEGLIGOFS\
XSTPEGIEGLIGOQEVORI\XXSXLIGSPYQR
REQI
%YXSQEXMGEPP]GVIEXIE7)0)'8
UYIV]JSVEPPGSPYQRWSJEWIPIGXIH
XEFPI

-RXLI[SVOEVIEVMKLXGPMGOMRXLIXEFPIERH
GLSSWI7IPIGX%PPJVSQXLIWLSVXGYXQIRY

7IXSTXMSRWVYPIWERHGVMXIVMEJSV
XLIUYIV]

 -RXLIHEXEKVMHJMRHXLIVS[LIEHMRK[MXL
XLIX]TISJSTXMSRSVGVMXIVME]SY[ERXXS
WIX ;LIVI7SVX%KKVIKEXIERHWSSR 
 'PMGOMRWMHIEGIPPMRXLIETTVSTVMEXIVS[
 ;LIREWUYEVIFYXXSRETTIEVWMRWMHIXLI
GIPPGPMGOMXXSZMI[SVWIXSTXMSRWVYPIW
ERHGVMXIVMEJSVXLIUYIV]

'VIEXIEXEFPINSMR

1. %HHXLIXEFPIWJSVXLINSMR
XSXLI[SVOEVIE

2. -RXLI[SVOEVIEHVEKEGSPYQRREQI
JVSQXEFPI%XSEGSPYQRREQIMRXEFPI&



216

SQL Navigator Users Guide

If you want to

Then

7TIGMJ]NSMRGVMXIVME

6MKLXGPMGOXLIPMRIGSRRIGXMRKXLINSMRIH
GSPYQRWERHXLIRGLSSWI0MRO3TXMSRWJVSQ
XLIWLSVXGYXQIRY

+IRIVEXIE750WXEXIQIRX

750GSHIMWEYXSQEXMGEPP]
KIRIVEXIH[LIR]SYEHHE
XEFPIXSXLI[SVOEVIEERH
XLIRWIPIGXGSPYQRREQIW

:MI[XLI750GSHIKIRIVEXIH
JVSQ]SYVZMWYEPUYIV]FYMPHMRK

'PMGOXLI750XEFMRXLIPS[IVPIJXSJXLI
5YIV]FYMPHIV[MRHS[

:MI[]SYVUYIV]VITVIWIRXIHEWE
HEXEKVMH

'PMGOXLI'SPYQRWXEFMRXLIPS[IVPIJXSJXLI
5YIV]FYMPHIV[MRHS[

8IWXXLIUYIV]

'PMGOXLI8IWXFYXXSR

7EZIXLIUYIV]

'PMGOIMXLIVXLI7EZIXLI
UYIV]XSHMWOSVXLI7EZIXLI
UYIV]XSERI[HMWOJMPI
XSSPFEVFYXXSR

4EWXIXLIUYIV]MRXSXLI750
)HMXSV

'PMGOXLI'ST]XLI5YIV]XS
XLI)HMXSVFYXXSR

To set rules, options or criteria for a query


1
2

3
4

3TIRERI[SVI\MWXMRKUYIV]ERHWTIGMJ]XLIWGLIQEXEFPIREQIERH
GSPYQRW]SY[ERXXSYWI
-RXLIHEXEKVMH PS[IVTEVXSJXLI5YIV]&YMPHIV[MRHS[ JMRHXLIVS[
LIEHMRK[MXLXLIX]TISJVYPISTXMSRSVGVMXIVME]SY[ERXXSWIX ;LIVI
7SVX%KKVIKEXIERHWSSR 
-RXLIGLSWIRVS[GPMGOMRWMHIEGIPPFIPSRKMRKXSXLIGSPYQRJSV[LMGL
]SYEVIWIXXMRKXLIVYPISTXMSRSVGVMXIVME
;LIREWUYEVIFYXXSRETTIEVWMRWMHIXLIGIPPGPMGOMXXSSTIRXLIIHMXMRK
[MRHS[ERHZMI[SVWIXXLISTXMSRWVYPIWSVGVMXIVME
When a square button appears inside the cell, you
can use the spacebar or Ctrl+Enter to open the
column editing window.








Chapter 5

Working with SQL statements and scripts

217

Specifying WHERE clauses


=SYGERWTIGMJ]ER]ZEPMHI\TVIWWMSRMRXLI;,)6)GPEYWIRSQEXXIV[LMGL
GSPYQRWEVIWIPIGXIHMRXLI7IPIGXVS[SJXLIHEXEKVMH
8SWTIGMJ];,)6)GPEYWIJSVEGSPYQR[MXLSYXLEZMRKXLIGSPYQRWIPIGXIHMR
XLIUYIV]YWIIMXLIVSJXLIJSPPS[MRKTVSGIHYVIW

If the column is selected


-JXLIGSPYQRXSFIUYIVMIHJSVXLI;,)6)GPEYWIMWEPVIEH]WIPIGXIHMRXLIPMWX
SJGSPYQRWMRXLI[SVOEVIEEFSZIXLIHEXEKVMHHIWIPIGXMXF]GPIEVMRKXLI
GLIGOQEVOJSVXLIGSPYQRJVSQXLI7)0)'8VS[SJXLIHEXEKVMH FYXPIEZI
XLIGSPYQRWIPIGXIHMRXLIGSPYQRPMWX 
-RXLI;,)6)VS[GPMGOMRWMHIEGIPPFIPSRKMRKXSXLIGSPYQRJSV[LMGL]SY
EVIWIXXMRKXLI;,)6)GPEYWI;LIREWUYEVIFYXXSRETTIEVWMRWMHIXLIGIPP
GPMGOMXXSIRXIVXLIGVMXIVMEJSVXLI;,)6)GPEYWI
&IGEYWI]SYGPIEVIHXLIGLIGOQEVOMRXLI7)0)'8VS[XLIGSPYQR[MPPRSX
FIMRGPYHIHMRXLIVIWYPXWIXFYXMX[MPPFIYWIHMRXLI;,)6)GPEYWISJXLI
750WXEXIQIRX

If the column is not selected


-JXLIGSPYQRXSFIUYIVMIHJSVXLI;,)6)GPEYWIMWRSXWIPIGXIHMRXLIPMWXSJ
GSPYQRWMRXLI[SVOEVIEEFSZIXLIHEXEKVMHXLIRGPMGOMRWMHIEGIPPFIPSRKMRK
XSXLIGSPYQRJSV[LMGL]SYEVIWIXXMRKXLI;,)6)GPEYWI;LIREWUYEVI
FYXXSRETTIEVWMRWMHIXLIGIPPGPMGOMXXSIRXIVXLIGVMXIVMEJSVXLI;,)6)
GPEYWI=SYV;,)6)GPEYWIGERWTIGMJ]ER]GSPYQRVIKEVHPIWWSJ[LIXLIVMX
MWMRGPYHIHMRXLI7)0)'8WXEXIQIRXSVRSX

Automatic insertion of column names into a WHERE clause


;LIR]SYIRXIVERI\TVIWWMSRMRE;,)6)GPEYWIXLI5YIV]&YMPHIV[MPP
EYXSQEXMGEPP]MRWIVXXLIWIPIGXIHGSPYQRREQIMRXSXLI750EWETVIJM\MJXLI
I\TVIWWMSRWXEVXW[MXLSRISJXLISTIVEXSVWMRXLIJSPPS[MRKPMWX
-J]SYWXEVXXLII\TVIWWMSR[MXLXLIREQISJERSXLIVGSPYQRSV[MXL
WSQIXLMRKSXLIVXLERSRISJXLIXIVQWFIPS[XLIR5YIV]&YMPHIV[MPPRSX
MRWIVXXLIWIPIGXIHGSPYQRREQIEWETVIJM\XSXLII\TVIWWMSR]SYX]TI-RXLMW
[E]]SYGERVIJIVXSER]GSPYQRSVXEFPIREQIMR]SYV;,)6)GPEYWIIZIR
GSPYQRWRSXREQIHMRXLI7)0)'8WXEXIQIRX

218

SQL Navigator Users Guide

Operator

Meaning

Example

!

)UYEP8S

[LIVI)1423!

"

+VIEXIV8LER

[LIVI)1423"

"!

+VIEXIV8LERSV)UYEP
8S

[LIVI)1423"!

0IWW8LER

[LIVI)1423 

!

0IWW8LERSV)UYEP8S

[LIVI)1423 !

"

2SX)UYEP8S

[LIVI)1423 "

!

2SX)UYEP8S

[LIVI)1423!

B!

2SX)UYEP8S

[LIVI)1423B!

!

2SXIUYEPXS

[LIVI)1423!

0-/)

0MOI


[LIVI)2%1)0-/)k*6(k
SV
[LIVI)2%1)0-/)k*6(k

238

2SX

[LIVI)2%1)238-2
k*6)(kk&%62)=k 

-2

-R

[LIVI)2%1)-2 k*6)(kk&%62)=k 
SV
[LIVI)2%1)-2 k*6)(kk&%62)=k 

&)8;))
2

&IX[IIR

[LIVI)1423&)8;))2ERH


Customizing Query Builder


6MKLXGPMGOMRXLI5YIV]&YMPHIV[MRHS[XSWIPIGXJVSQERYQFIVSJSTXMSRW
XLEXPIX]SYGYWXSQM^I5YIV]&YMPHIVXSWYMX]SYVTVIJIVVIH[E]SJ[SVOMRK

Code catalogs for fast and easy coding


8LI'SHI%WWMWXERXKMZIW]SYMRWXERXEGGIWWXSE7]RXE\ERH;IF'EXEPSKE
'SHIERH750'EXEPSK40:MWMSRGEXEPSKWE7XERHEVHWGEXEPSKERHE7LEVIH
GEXEPSKERHORS[PIHKIFEWIWGEPPIH/RS[PIHKI<TIVXJSV%GXMZI40750
(IZIPSTQIRXERH/RS[PIHKI<TIVXJSV3VEGPI%HQMRMWXVEXMSR=SYGERHVEK
XLIWIMXIQWMRXS]SYVGSHIIHMXMRK[MRHS[JSVJEWXIEW]ERHEGGYVEXIGSHI
KIRIVEXMSR

Chapter 5

Working with SQL statements and scripts

219

SQL Navigator provides two tools that assist in


information sharing among members of a
development team. The shared catalog can be
used to maintain a repository of code snippets,
while the standards catalog allows SQL and
PL/SQL templates to be stored.
For tips and techniques, see
http://www.quest.com/sql_navigator

Using code catalogs and the Code Assistant


'SHIGEXEPSKJYRGXMSRWEVIGSRWSPMHEXIHMRXLI'SHI%WWMWXERX[LMGLTVSZMHIW
IEW]EGGIWWXSGSHIWRMTTIXGEXEPSKWHVEKERHHVSTW]RXE\/RS[PIHKI<TIVX
JSV%GXMZI40750(IZIPSTQIRXERH/RS[PIHKI<TIVXJSV3VEGPI
%HQMRMWXVEXMSR
8LI7]RXE\ERH;IFGEXEPSKMWEVIEH]XSYWIPMFVEV]SJ40750W]RXE\8LI
;IFGEXEPSKMWEZEMPEFPIMJ]SYLEZIPMGIRWIHXLI;IF(IZIPSTQIRX1SHYPI
8LI'SHIERH750GEXEPSKMWJSV]SYVS[RYWI7XSVIGSHIWRMTTIXWJSVIEW]
EGGIWWERHHVEKERHHVSTGSRZIRMIRGI
8LI7XERHEVHWERH7LEVIHGEXEPSKWEVIHIWMKRIHXSFIYWIHMRWYTTSVXSJXIEQ
TVSKVEQQMRKIRZMVSRQIRXW-RXLI4VIJIVIRGIWWIXXMRKW]SYGERHIWMKREXI
[LMGLHMVIGXSVMIW7502EZMKEXSVYWIW[LIRHMWTPE]MRK]SYV7XERHEVHWERH
7LEVIHGEXEPSKW
7502EZMKEXSVYWIVWGERRS[EGGIWWXIGLRMGEPXSTMGWIVVSVQIWWEKIW
TVIFYMPXERHXIWXIHGSHIWSPYXMSRWERHGSHIJSVQEXXMRKXIGLRSPSK]
/RS[PIHKI<TIVXTVSHYGXWEVIEZEMPEFPIEWSTXMSREPEHHSRQSHYPIWERH
EZEMPEFPIHMVIGXP]JVSQ]SYV5YIWX7SJX[EVIVITVIWIRXEXMZI

220

SQL Navigator Users Guide

Code Assistant window

To open the Code Assistant


'LSSWISRISJXLIJSPPS[MRKQIXLSHW
 'PMGOXLI'SHI%WWMWXERXXSSPFEVFYXXSR

 'LSSWIXLI'SHI%WWMWXERXMXIQSRXLI:MI[QIRY
-JXLI'SHI%WWMWXERXMWEPVIEH]STIRFYXLMHHIRER]SJXLITVSGIHYVIWPMWXIH
EFSZI[MPPFVMRKMXXSXLIJSVIKVSYRH=SYGEREPWSFVMRKER]7502EZMKEXSV
STIR[MRHS[XSXLIJSVIKVSYRHF]VMKLXGPMGOMRKXLIFEGOKVSYRHSJXLIQEMR
[MRHS[ERHGLSSWMRKXLI[MRHS[JVSQXLIWLSVXGYXQIRY

Chapter 5

Working with SQL statements and scripts

221

8LIMXIQGSYRXMRHMGEXSVMRXLIWXEXYWFEVFIPS[XLI[MRHS[HMWTPE]WXLI
RYQFIVSJMXIQWMREWIPIGXIHJSPHIV

To change Code Assistant preferences and display settings


8SGLERKI'SHI%WWMWXERXTVIJIVIRGIWGLSSWI:MI[ 4VIJIVIRGIW +IRIVEP 
'SHI%WWMWXERXXLIRWIPIGX]SYVTVIJIVIRGIW1ER]STXMSRWEVIEZEMPEFPIXS
LIPT]SYGYWXSQM^I]SYV[SVOIRZMVSRQIRX)\EQTPIWEVI
 %YXSWXEVX[MXL)HMXSVWERH)\TPEMR4PER[LMGLEPPS[W]SYXSWTIGMJ]
[LIXLIVSVRSXXSWXEVXXLI'SHI%WWMWXERX[LIRXLIGSHIIHMXSVWERHXLI
)\TPEMR4PEREVISTIRIH
 (MWTPE]4EKI,MRXWJSV'EXEPSKW[LMGLEYXSQEXMGEPP]HMWTPE]WXI\XYEP
HIWGVMTXMSRWSJEWIPIGXIHGEXEPSKMXIQ
 (MWTPE]IH4EKIW[LIVI]SYGERGLSSWI[LMGLGEXEPSKWEVIHMWTPE]IH
 ;LIXLIVXLI40:MWMSRGEXEPSKMWHMWTPE]IH

Automatically starting Code Assistant with editors


=SYGERWIX4VIJIVIRGIWWSXLEX'SHI%WWMWXERXSTIRWEYXSQEXMGEPP][LIRER
IHMXSVMWSTIRIH

To set the Autostart Code Assistant preference


1
2

-RXLI:MI[QIRYGLSSWIXLI4VIJIVIRGIW"+IRIVEP"'SHI%WWMWXERX
7IPIGX%YXSWXEVX[MXL)HMXSVWERH)\TPEMR4PER

Viewing information about catalog objects


8LI-RJSVQEXMSR[MRHS[MWEWITEVEXITERIMRXLI'SHI%WWMWXERXXLEXHMWTPE]W
MRJSVQEXMSREFSYXEWIPIGXIHSFNIGX

To show or hide the Information pane


 'PMGOXLI-RJSVQEXMSR
XSSPFEVFYXXSR
3V
 6MKLXGPMGOXLIFEGOKVSYRHSJXLI'SHI%WWMWXERX[MRHS[ERHWIPIGX
7LS[,MHI-RJSVQEXMSR;MRHS[JVSQXLIWLSVXGYXQIRY

222

SQL Navigator Users Guide

Adding, editing or deleting catalog items


=SYGEREHHIHMXSVHIPIXIMXIQWMRXLI'SHI%WWMWXERXGEXEPSKW
8LI%HHXS'EXEPSKERH)HMXHMEPSKWTVSZMHIXEFFIHTEKIWJSVQEREKMRKXLI
MRJSVQEXMSRXLEXMWXSFIHMWTPE]IHJSVERSFNIGXMRGPYHMRKGETXMSRXI\XLMRXW
MRJSVQEXMSRERHERMGSRXSMHIRXMJ]XLIWRMTTIXX]TI +IRIVMG*YRGXMSRSV
4VSGIHYVI 

To add, edit or delete catalog items


 'PMGOXLI%HH
)HMX
SV(IPIXI
FYXXSRWMRXLI'SHI
%WWMWXERXXSSPFEVXSEHHIHMXSVVIQSZIEGEXEPSKMXIQSVEJSPHIV
8LI%HHXS'EXEPSKERH)HMXHMEPSKWTVSZMHIXEFFIHTEKIWJSVQEREKMRKXLI
MRJSVQEXMSRXLEXMWHMWTPE]IHJSVERSFNIGXMRGPYHMRKGETXMSRXI\XLMRXW
MRJSVQEXMSRERHERMGSRXSMHIRXMJ]XLIWRMTTIXX]TI +IRIVMG*YRGXMSRSV
4VSGIHYVI 
8LI7RMTTIXXEFGSRXEMRWXLIGSHIWRMTTIXXI\XXSFIHVSTTIHMRXSERIHMXSV
8LI-RJSVQEXMSRXEFGSRXEMRWXLIXI\XXSFIHMWTPE]IHMRXLI'SHI%WWMWXERX
W
-RJSVQEXMSR[MRHS[8LI,MRXXEFGSRXEMRWXLIXI\XXSFIYWIHEWELMRXMRXLI
WXEXYWFEVEXXLIFSXXSQSJXLI'SHI%WWMWXERX[MRHS[8LI-QEKIXEFWIPIGXW
XLIMQEKIYWIHXSVITVIWIRXXLIWRMTTIXSVJSPHIVMRXLI'SHI%WWMWXERX
WXVII
ZMI[
%PXIVREXMZIP]]SYGERWIPIGXER]XI\XMRERIHMXMRK[MRHS[ERHQSZIMXMRXSE
GEXEPSKYWMRKXLI'ETXYVIFYXXSR8LI'ETXYVIXSSPFEVFYXXSRGETXYVIWXLI
WIPIGXIHMXIQXSXLIGPMTFSEVHJSVEHHMXMSRXSER]SJXLIGEXEPSKW


 XLI'ETXYVIFYXXSRSRXLI'SHI%WWMWXERXXSSPFEV
The following constraints apply:
You cannot delete top-level nodes of the tree.
You cannot rename the top-level folders in the
tree.

To rename a catalog item


'LSSWISRISJXLIWIQIXLSHW
 'PMGOXLIREQISJEWIPIGXIHMXIQXLIRX]TIERI[REQIERHTVIWW)RXIV
3V
 'LSSWI)HMXSRXLIXSSPFEVXLIRX]TIXLIRI[REQIMRXLI2EQIJMIPH

Chapter 5

Working with SQL statements and scripts

223

Use descriptive names for catalog items. Names


can be up to 35 characters long and contain
uppercase letters, lowercase letters, and any of
the following characters:
_ - & space < > / , ( ) ..

Saving your SQL statements and code in catalogs


=SYGERWEZI]SYVJVIUYIRXP]YWIH750WXEXIQIRXWERHGSHIJVEKQIRXWMRXLI
'SHIERH750'EXEPSK*SVI\EQTPI]SYGERWXSVI]SYVJVIUYIRXP]YWIH
GYVWSVHIGPEVEXMSRWSVZEVMEFPIHIGPEVEXMSRWMRXLIGEXEPSK
=SYGER
 %HHEGSHIWRMTTIXSV750WXEXIQIRX
 )HMXXLIWIPIGXIHMXIQ
 6IREQIEGEXEPSKMXIQ
 (IPIXIERMXIQ
=SYGERGVIEXIRI[MXIQWERHJSPHIVWHMVIGXP]MRXSXLIGEXEPSK
8LIGEXEPSKWSVXWXLIJSPHIVWERHMXIQWEPTLEFIXMGEPP]F]REQI=SYGERYWI
]SYVS[RREQMRKGSRZIRXMSRWSVTVIJM\IWXSKVSYTWMQMPEVWRMTTIXWXSKIXLIV
YRHIVXLIWEQIJSPHIVSVWYFJSPHIV
You can use the Code and SQL catalog to build
your own version of the Syntax catalog. Simply
add your own syntax items to the catalog and use
a consistent prefix to group the items together;
for example:
Syn- IF THEN ELSIF
Syn- WHERE clause
Syn- SQL - Correlated subquery
Etc.
Alternatively, you can add new items directly into
the Syntax catalog of the Code Assistant.

224

SQL Navigator Users Guide

Placing Items into the code catalogs


=SYGERTPEGIMXIQWMRXSXLIGSHIGEXEPSK
 &]GETXYVMRKGSHIJVSQERIHMXSV[MRHS[
 *VSQXLIGSHIGEXEPSK[MRHS[F]YWMRKXLI%HHFYXXSR

To add to the catalog from the editor window


1
2

7IPIGXXLIGSHIMRER]IHMXSV[MRHS[
-RXLI'SHI%WWMWXERXGPMGOXLI'ETXYVI'SHIXSSPFEVFYXXSR

 XLI'ETXYVI'SHI7RMTTIXXSSPFEVFYXXSR

 ;LIRTVSQTXIHIRXIVEREQIJSVXLIGSHIWRMTTIX
8LIWIPIGXIHXI\XMWTPEGIHMRXLIGEXEPSK
Use descriptive names for catalog items. Names
can be up to 35 characters long and contain
uppercase letters, lowercase letters, and any of
the following characters:
_ - & space < > / , ( ) ..

To add to the catalog from the code catalog window


1

'PMGOXLI%HHFYXXSRSJXLIGSHIGEXEPSKXSSPFEV


2

 XLI%HHFYXXSR
9WIXLIXEFFIHTEKIWXSVIGSVHMRJSVQEXMSREFSYXXLIMXIQ]SYEVIEHHMRK

To move a snippet from the catalog into the editor


1

*VSQERIHMXMRK[MRHS[STIR'SHI%WWMWXERX

2
3

4PEGIXLIXI\XGYVWSV[LIVI]SY[ERXXLIWRMTTIXXSFIMRWIVXIH
7IPIGXXLI7]RXE\'EXEPSKTEKI

4 )MXLIVHSYFPIGPMGOXLIWRMTTIXSVHVEKMXMRXSXLIIHMXSV
8LIWRMTTIXMWMRWIVXIHEXXLIGYVVIRXGYVWSVTSWMXMSR

Chapter 5

Working with SQL statements and scripts

225

Saving and re-using code


=SYGERWEZI]SYVJVIUYIRXP]YWIH750WXEXIQIRXWERHGSHIJVEKQIRXWMRXLI
'SHIERH750'EXEPSK
=SYGER
 %HHEGSHIWRMTTIXSV750WXEXIQIRX
 )HMXXLIWIPIGXIHMXIQ
 6IREQIEGEXEPSKMXIQ
 (IPIXIERMXIQ
'SHIGEXEPSKJYRGXMSRWEVIGSRWSPMHEXIHMRXLI'SHI%WWMWXERX[MRHS[[LMGL
TVSZMHIWIEW]EGGIWWXSGSHIWRMTTIXGEXEPSKWHVEKERHHVSTW]RXE\ERHXLI
/RS[PIHKI<TIVXGEXEPSKW
8LI/RS[PIHKI<TIVXKMZIW7502EZMKEXSVYWIVWEPMFVEV]SJQSVIXLER
TVIFYMPX40750VSYXMRIWXLEXGERIPMQMREXILSYVWSJPS[PIZIPGSHMRKERH
HIFYKKMRK[LMPIIRLERGMRKETTPMGEXMSRTIVJSVQERGIERHVIPMEFMPMX]

Viewing Describe information


;MXLXLMWZIVWMSRSJ7502EZMKEXSVXLI'SHI%WWMWXERXRSPSRKIVGSRXEMRWE
(IWGVMFI,MWXSV][MRHS[
8LI7502EZMKEXSVJYRGXMSRXLEXKMZIW]SYEUYMGOWYQQEV]SJEXEFPISV
ZMI[ERHEPPMXWGSPYQRREQIWERHHEXEX]TIWMWRS[TVSZMHIHMRXLI(IWGVMFI
ERH%YXS(IWGVMFI[MRHS[W
*SVQSVIMRJSVQEXMSRWII-RZSOMRKXLI(IWGVMFIGSQQERH

226

SQL Navigator Users Guide

Executing SQL and working with results


=SYGERI\IGYXIXLI750]SYLEZIGVIEXIHSVIHMXIHMRXLI750)HMXSVERH
]SYGERZMI[ERHQERMTYPEXIXLIVIWYPXWMREZEVMIX]SJ[E]W7502EZMKEXSV
EPWSEPPS[WPEVKIWGVMTXWSV750WXEXIQIRXWXSFII\IGYXIHMRXLIFEGOKVSYRH
EPPS[MRK]SYXSTIVJSVQSXLIVJYRGXMSRWSR]SYV4'WMQYPXERISYWP] 

Executing a SQL script


=SYGERWXEVXXLII\IGYXMSRSJER750WGVMTXJVSQER]TSWMXMSRMRXLI750
)HMXSV8LII\IGYXMSRWXEVXTSMRXSJXLIWGVMTXMWEP[E]WXLIPMRI[MXLXLI
GYVVIRXGYVWSVTSWMXMSR=SYGERQSZIXLIGYVVIRXI\IGYXMSRTSMRXSJXLIWGVMTX
WMQTP]F]WGVSPPMRKXLVSYKLXLIWGVMTXSVF]YWMRKXLIXSSPFEVFYXXSRWWYGLEW
7OMTXS2I\X7507XEXIQIRX
%PP750 4PYWOI][SVHWPMOI&8-80)'30912ERH7)8EVIMKRSVIH
XLIVIJSVI]SYGERVYR]SYV750 4PYWWGVMTXW[MXLJI[EPXIVEXMSRW
8LI750)HMXSVHSIWRSXI\IGYXIRIWXIH750WGVMTXW0MRIWFIKMRRMRK[MXLXLI
$GSQQERHSJ750 4PYWEVIMKRSVIH

Displaying results
8LISYXTYXSJIZIV]750WXEXIQIRXI\IGYXIHMWHMWTPE]IHMRE6IWYPXEVIE=SY
GERWIXTVIJIVIRGIWXLEXGSRXVSPLS[XLIVIWYPXWEVIHMWTPE]IHJSVI\EQTPI
 -RXLIPS[IVTERISJEWTPMXIHMXMRK[MRHS[
 3RWITEVEXIXEFFIHTEKIW
8LIVIGERFIQYPXMTPIVIWYPXWHMWTPE]WSRITIVWXEXIQIRXI\IGYXIH

Error descriptions
)VVSVWIRGSYRXIVIHMRXLII\IGYXMSRSJ750WXEXIQIRXWEVIHMWTPE]IHMRXLI
I\IGYXMSRWXEXYWTERIPSJXLI750)HMXSV(SYFPIGPMGOSRERIVVSVXSHMWTPE]
MXWHIWGVMTXMSR

Executing SQL statements


=SYGERI\IGYXIXLI750]SYLEZIGVIEXIHMRXLI750)HMXSVMRWIZIVEP[E]W
-J]SYLEZIQYPXMTPI750WXEXIQIRXWHMWTPE]IHMRXLI750)HMXSV[MRHS[]SY
GERI\IGYXIXLIQMRHMZMHYEPP]SVEPPXSKIXLIV 

Chapter 5

Working with SQL statements and scripts

227

Viewing processing status


8LII\IGYXMSRWXEXYWSJXLII\IGYXIH750UYIV]MWHMWTPE]IHMREWITEVEXITERI
EXXLIFSXXSQSJXLI750[MRHS[ 

To execute the SQL statements displayed in the SQL Editor


 4IVJSVQSRISJXLIJSPPS[MRK
 'PMGOXLI)\IGYXI750FYXXSRSRXLIIHMXSVXSSPFEV
XLI)\IGYXI750FYXXSR
SV
 6MKLXGPMGOMRXLIIHMXSV[MRHS[ERHGLSSWISRISJXLI)\IGYXISTXMSRW
JVSQXLIWLSVXGYXQIRY
SV
 4VIWW*

To execute an individual SQL statement


 4PEGIXLIGYVWSVSRXLIWXEXIQIRX]SY[ERXXSI\IGYXIERHTVIWW*

SQL Editor Execution Status pane


8LII\IGYXMSRWXEXYWTERISJXLI750[MRHS[HMWTPE]WMRJSVQEXMSREFSYXXLI
WXEXYWSJE750WXEXIQIRXSVWGVMTXXLEX]SYI\IGYXI-XMRGPYHIWER]IVVSVW
IRGSYRXIVIHMRXLII\IGYXMSRSJ750WXEXIQIRXW

To display an error description


 (SYFPIGPMGOSRERIVVSVPMWXIHMRXLII\IGYXMSRWXEXYWTERI

Changing the contents of the execution status pane


=SYGERGLERKIXLIGSRXIRXWSJXLII\IGYXMSRWXEXYWTERIF]GLSSWMRK[LIXLIV
XSHMWTPE]IVVSVW[EVRMRKWSVWXEXIQIRXVIWYPXW

To change the type of information displayed in the execution


status pane
 6MKLXGPMGOER][LIVIMRXLII\IGYXMSRWXEXYWTERIXSMRZSOIEWLSVXGYX
QIRYXLIRWIPIGXXLIX]TI W SJIVVSVWXSFIVITSVXIH IVVSVW[EVRMRKW
ERHWXEXIQIRXVIWYPXW 

228

SQL Navigator Users Guide

SQL window Status line


8LI7XEXYWPMRIHMWTPE]WXLIIHMXMRKWXEXYWSJXLIGYVVIRXWGVMTXWYGLEW-RWIVX
3ZIV[VMXI6IEH3RP]GYVVIRXPMRIGYVVIRXGSPYQR

Running multiple queries


-J]SYRIIHXSVYRQYPXMTPIUYIVMIWWMQYPXERISYWP]]SYGERSTIRERSXLIV
GSRRIGXMSRXSXLIWEQIHEXEFEWI
-XMWRSXTSWWMFPIXSVYRQYPXMTPIUYIVMIW[MXLMRXLIWEQIWIWWMSR
WMQYPXERISYWP]

Running the same script against different databases


)EGLWIWWMSRVIPEXIH[MRHS[ GSHIIHMXSVSFNIGXIHMXSVERHWSSR VIQIQFIVW
ERHEYXSQEXMGEPP]STIRWMRXLIETTVSTVMEXIHEXEFEWIWIWWMSR
-RXLI750)HMXSV]SYGERJVIIP]W[MXGLXSSXLIVWIWWMSRWERHGSRXMRYI
[SVOMRK[MXLMRXLIWEQI[MRHS[;LIR]SYXLIRVYRXLEX[MRHS[ I\IGYXI
XLI750SVGSQTMPIXLI40750GSHIJSVI\EQTPI 7502EZMKEXSV[MPP
TVSQTX]SYXSGLERKIXSXLIRI[ GYVVIRX WIWWMSR8LMWJIEXYVIIREFPIW]SYXS
VYRXLIWEQIWGVMTXEKEMRWXHMJJIVIRXHEXEFEWIW[MXLSYXXLIRIIHXSGST]MXMRXS
ERSXLIVMRWXERGISJ750)HMXSV-XEPWSEPPS[W]SYXSUYMGOP]GSVVIGXXLI
SZIVWMKLXSJSTIRMRKEJMPIMRXSXLI[VSRKWIWWMSR
8SGLERKIXLIWIWWMSREWWSGMEXIH[MXLEGYVVIRX750)HMXSV[MRHS[WMQTP]
WIPIGXXLISXLIVWIWWMSRJVSQXLI7IWWMSR8SSPFEVHVSTHS[R

The drop-down list on the Session Toolbar


8SW[MXGLXSERSXLIVWIWWMSRkW(&2EZMKEXSV[MRHS[WIPIGXXLIWIWWMSRERH
XLIRGPMGOXLI(&2EZMKEXSVFYXXSRSVTVIWW*

Executing updateable queries


=SYGERIHMXXLIHEXEVIXYVRIHF]7)0)'8WXEXIQIRXWMJXLI9THEXIEFPI5YIV]
STXMSRMWXYVRIHSR=SYGERXLIRGSQQMXXLIGLERKIWXSXLIHEXEFEWIYWMRK
XLI'SQQMXGSQQERH
8LIYTHEXIEFPIUYIV]MWEWTIGMEPM^IHX]TISJUYIV]XLEXPIXW]SYWIPIGXHEXE
JVSQEXEFPIIHMXXLIHEXEERHWEZIMXXSXLIHEXEFEWI

Chapter 5

Working with SQL statements and scripts

229

=SYGERI\IGYXIESELECTWXEXIQIRXSVWGVMTXERHIHMXXLIVIWYPXMRKHEXE
WLIIX8LMWJIEXYVIMWTEVXMGYPEVP]YWIJYPJSVGVIEXMRKXIWXHEXE
-JXLIUYIV]LEWFIIRHIJMRIHEW9THEXIEFPIMRXLI750[MRHS[]SYGERIHMX
XLIGSRXIRXWSJXLI6IWYPX[MRHS[ERHWEZIXLIQXSXLIHEXEFEWI
%JXIVI\IGYXMRKXLIUYIV]]SY[MPPRSXMGIXLIWXEXYWTERIPEXXLIFSXXSQSJXLI
6IWYPX[MRHS[VIEHW9THEXIEFPI VEXLIVXLER6IEH3RP]EWMWXLIGEWI
[MXLSXLIVUYIVMIW 
Updateable queries are slow to execute.
Turn off the Updateable Query option
unless you expect to update the data
returned.

To run an updateable query


1

'PMGO

)RXIVXLISELECTWXEXIQIRXMRXLI750XEFSJXLIIHMXSV7II6IWXVMGXMSRW
JSV9THEXIEFPI5YIVMIWFIPS[JSVKYMHIPMRIW
4VIWW*XSI\IGYXIXLI750
-JXLIVIWYPXMRKUYIV]MWYTHEXIEFPIXLIWXEXYWPMRIMRXLIPS[IVWIGXMSRSJ
XLI750)HMXSVHMWTPE]WXLI[SVH9THEXIEFPI
)HMXXLIHEXEMRXLI6IWYPX[MRHS[=SYGERYTHEXIHIPIXIERHMRWIVXRI[
VIGSVHW

3
4
5

MRXLI750)HMXSVXSSPFEVXSWIXXLI9THEXIEFPI5YIV]STXMSR

To save your changes to the database


 -RXLI7IWWMSRXSSPFEVGPMGOXLI'SQQMXFYXXSR


XLI'SQQMXFYXXSR

To undo your changes to the database


 -RXLI7IWWMSRXSSPFEVGPMGOXLI6SPPFEGOFYXXSR


XLI6SPPFEGOFYXXSR

230

SQL Navigator Users Guide

If the Commit and Rollback buttons on the


Session toolbar appear dimmed, then you
probably have the Immediately Commit Every
DML Statement preference selected. This means
that your changes to query results are
automatically being saved to the database.
To confirm or change this setting, choose
Preferences from the View menu and then open
the Session preferences.

Errors from updateable queries


-J]SYKIXERIVVSVQIWWEKIWYGLEWTOKEN:.(12121,2),]SYVUYIV]HSIW
RSXGSRJSVQXSXLIVIWXVMGXMSRWJSVYTHEXIEFPIUYIVMIW
-J]SYKIXERIVVSV[LMPII\IGYXMRK[MXLXLIYTHEXIEFPISTXMSRSRERHXLI
UYIV]W]RXE\MWGSVVIGXMRXLIUYIV]SRP]QSHIQSHMJ]XLIUYIV]XSWYMXXLI
W]RXE\VIWXVMGXMSRW WIIEFSZI SJXLI9THEXIEFPI5YIV]STXMSR

The Spool window


8LIWTSSP[MRHS[HMWTPE]WXLIVS[WVIXYVRIHJVSQE7)0)'8WXEXIQIRXMR
XI\XJSVQEX
-J)GLS750MWIREFPIHXLIWTSSP[MRHS[EPWSGSRXEMRWXLIXI\XSJXLI
I\IGYXIHWXEXIQIRX
=SYGERYWI750)HMXSVTVIJIVIRGIWIXXMRKXSGSRXVSPLS[QER]VIWYPXVS[W
EVIHMWTPE]IHMRXLI7TSSP[MRHS[

To display the text of the executed statement in the


Spool window
 6MKLXGPMGOMRXLI750[MRHS[ERHXLIRWIPIGX)GLS750

Chapter 5

Working with SQL statements and scripts

231

Spool window toolbar buttons


Button

Function
7EZI%W

7EZIXLIGSRXIRXWSJXLI7TSSP[MRHS[
XSEREQIHXI\XJMPI

'PIEV

(IPIXIXLIGSRXIRXWSJXLI7TSSP
[MRHS[

4VMRX

4VMRXXLIGSRXIRXWSJXLI7TSSP[MRHS[






Spool window shortcut menu commands


Menu Option

Function

7EZI0SK

7EZIXLIGSRXIRXWSJXLI7TSSPXEFXSE
REQIHXI\XJMPI

'PIEV

'PIEVXLIGSRXIRXWSJXLI7TSSPXEF

'ST]

'ST]WIPIGXIHXI\XXSXLI'PMTFSEVH

To display SQL statements in the Spool window


 6MKLXGPMGOMRXLI7TSSP[MRHS[ERHGLSSWI7TSSP3YXTYX

Retrieving previously executed SQL statements


=SYGERYWIXLI7TSSP[MRHS[XSOIITEPSKSJI\IGYXIH750WXEXIQIRXWERH
XSVIXVMIZII\IGYXIH750WXEXIQIRXW 

Spooling results as text


=SYGERGLSSWIXSHMWTPE]XLIVIWYPXWSJE750UYIV]EWXI\XMRXLI7TSSP
[MRHS[SJXLIIHMXSV=SYGERYWI750)HMXSVTVIJIVIRGIWIXXMRKXSGSRXVSP
LS[QER]VIWYPXVS[WEVIHMWTPE]IHMRXLI7TSSP[MRHS[ 

232

SQL Navigator Users Guide

To view results in text form


 &IJSVIVYRRMRKXLIUYIV]VMKLXGPMGOMRXLI750[MRHS[ERHXLIRGLSSWI
7TSSP3YXTYX
%JXIVVYRRMRKXLIUYIV]]SYGERZMI[XLIVIWYPXWMRXLI7TSSP[MRHS[ERH
GYXGST]ERHTEWXIXLSWIGSRXIRXWMRXSGSQTEXMFPIETTPMGEXMSRW 

To view results in text form


 &IJSVIVYRRMRKXLIUYIV]VMKLXGPMGOMRXLI750[MRHS[ERHXLIRGLSSWI
SRISJXLI)GLS750STXMSRW
%JXIVVYRRMRKXLIUYIV]]SYGERZMI[XLIVIWYPXWMRXLI7TSSP[MRHS[ERH
GYXGST]ERHTEWXIXLSWIGSRXIRXWMRXSGSQTEXMFPIETTPMGEXMSRW
=SYGERYWI750)HMXSVTVIJIVIRGIWIXXMRKXSGSRXVSPLS[QER]VIWYPXVS[W
EVIHMWTPE]IHMRXLI7TSSP[MRHS[ 

To view the text of a memo field


 -RXLI750)HMXSV6IWYPXKVMHHSYFPIGPMGO1IQS

Viewing results in the Result window


=SYGERWIXTVIJIVIRGIWXLEXGSRXVSPLS[XLIVIWYPXWSJI\IGYXIH750
WXEXIQIRXWEVIHMWTPE]IHJSVI\EQTPI
 -RXLIPS[IVTERISJEWTPMXIHMXMRK[MRHS[
 3RWITEVEXIXEFFIHTEKIW
8LIVIGERFIQYPXMTPIVIWYPXWHMWTPE]WSRITIVWXEXIQIRXI\IGYXIH 
3TXMSREPP]]SYGERGLSSWIXSHMWTPE]XLIVIWYPXWSJE750UYIV]EWXI\XMRXLI
7TSSP[MRHS[SJXLIIHMXSV
0SRKJMIPHWEVIHMWTPE]IHEW 1IQS =SYGERZMI[XLIXI\XSJEPSRKJMIPHMRE
TSTYTIHMXSV
8LITVSGIWWMRKWXEXYWSJI\IGYXIH750UYIVMIWMWHMWTPE]IHMREWITEVEXI
I\IGYXMSRWXEXYW[MRHS[

Result Display of the SQL Editor


8LISYXTYXSJIZIV]750WXEXIQIRXI\IGYXIHGERFIHMWTPE]IHMREVIWM^EFPI
6IWYPXEVIE=SYGERWIXTVIJIVIRGIWXLEXGSRXVSPLS[XLIVIWYPXWEVIHMWTPE]IH
JSVI\EQTPI

Chapter 5

Working with SQL statements and scripts

233

 -RXLIPS[IVTERISJEWTPMXIHMXMRK[MRHS[
 3RWITEVEXIXEFFIHTEKIW
8LIVIGERFIQYPXMTPIVIWYPXWHMWTPE]WSRITIVWXEXIQIRXI\IGYXIH

Working with query results


;LIR]SYI\IGYXIE7)0)'8WXEXIQIRXXLI6IWYPXWKVMH SVHEXEWLIIX 
HMWTPE]WXLIVS[WVIXYVRIHJVSQXLIWXEXIQIRX
9WMRKGSQQERHWMRXLIXSSPFEVEFSZIXLI6IWYPXWKVMH]SYGER
 1SZIXSJMVWXTVIZMSYWRI\XSVPEWXVIGSVH
 %YXSJSVQEXUYIV]VIWYPXW
 6IVYRUYIV]
4SMRXXSEXSSPFEVFYXXSRXSZMI[ELMRXHIWGVMFMRKMXWTYVTSWI
=SYGEREPWSYWIGSQQERHWJVSQXLIWLSVXGYXQIRYXS[SVO[MXLUYIV]
VIWYPXW

Editing query results


=SYGERIHMXXLIHEXEVIXYVRIHF]7)0)'8WXEXIQIRXWYWMRKXLI9THEXIEFPI
5YIV]STXMSRSRI\IGYXMSR=SYGERXLIRGSQQMXXLIGLERKIWXSXLIHEXEFEWI
YWMRKXLI'SQQMXGSQQERH

Exporting query results


=SYGERI\TSVXVIWYPXWMRERYQFIVSJJSVQEXWWYGLEW,810)\GIPERH
SXLIVW

To export query results


1
2

6MKLXGPMGOMRXLIVIWYPXWHMWTPE]ERHXLIRGLSSWI)\TSVXJVSQXLIWLSVXGYX
QIRY
-RXLI)\TSVXHMEPSKWTIGMJ]XLITEVEQIXIVWJSVXLII\TSVXSTIVEXMSRERH
GPMGO3/

Printing query results


=SYGERSYXTYXXLI6IWYPXWKVMHXSEPSGEPTVMRXIV

234

SQL Navigator Users Guide

To print query results


1
2
3
4

9RHIV:MI["4VIJIVIRGIW"+IRIVEP"4VMRXMRKWIXXLITVIJIVVIHSTXMSRWJSV
TVMRXMRK
-RXLI6IWYPXWKVMHWIXWSVXSTXMSRWGSPYQR[MHXLWERHSXLIVJSVQEXXMRK
EW]SY[ERXXLIQXSETTIEVSRXLITVMRXIHTEKI
*VSQXLI7502EZMKEXSV*MPIQIRYGLSSWI4VMRX4VIZMI[XSGLIGOXLI
JSVQEXXMRKSJXLISYXTYX
;LIR]SYEVIWEXMWJMIH[MXLXLITVIZMI[GLSSWI4VMRXJVSQXLIIHMXSV
XSSPFEVSVXLIWLSVXGYXQIRY

Viewing objects in table columns


To display the details of a selected record
 -RXLI750)HMXSV6IWYPX[MRHS[GPMGOXLI7MRKPIXEF

To display multiple rows in a data sheet format


 'PMGOXLI+VMHXEFEXXLIFSXXSQSJXLI750)HMXSV6IWYPX[MRHS[

To sort the data sheet


 -RXLI750)HMXSV6IWYPXKVMHVMKLXGPMGOER]GSPYQRLIEHIVERHXLIR
WIPIGXEWSVXSTXMSRJVSQXLIWLSVXGYXQIRY

To fetch sets of rows


 -RXLI750)HMXSV6IWYPXKVMHYWIXLIWGVSPPFEVWSVTVIWWXLI4EKI(S[R
ERH4EKI9TOI]W

Chapter 5

Working with SQL statements and scripts

235

Copying data from the Result window


=SYGERGST]XLIGSRXIRXWSJSRISVQSVIGIPPWVS[WSVGSPYQRWJSVTEWXMRK
MRXSGSQTEXMFPIETTPMGEXMSRW

To copy and paste selected data


1
2
3
4

6MKLXGPMGOMRXLI6IWYPX[MRHS[XSSPFEV
'LSSWI'YXSV'ST]HITIRHMRKSR[LIXLIV]SY[ERXXSVIQSZI 'YX XLI
WIPIGXIHHEXEJVSQXLI6IWYPXHEXEWLIIXSVGST]MX[MXLSYXVIQSZMRKMX
-J]SYEVIGST]MRKGSPYQRHEXEERH]SY[ERXXSEPWSGST]XLIGSPYQR
REQIGLSSWI'ST]'SPYQR,IEHMRK
6MKLXGPMGOMREHIWXMREXMSR[MRHS[ERHGLSSWI4EWXI

Switching between SQL code and results


-XMWIEW]XSW[MXGLFIX[IIRXLI750GSHI[MRHS[ERHXLIGSVVIWTSRHMRK
VIWYPXW 
For this SQL Editor window

Use this key

750

%PX5

7TSSP

%PX0

6IWYPXW

%PX6

-JQYPXMTPIVIWYPXWIXWEVITVSHYGIH]SYGERYWIXLIVIWYPXWIXRYQFIVW  EW


EGGIPIVEXSVOI]GSQFMREXMSRWJSVW[MXGLMRKXSXLIVIWYPXW*SVI\EQTPITVIWW
%PXXSZMI[VIWYPXWIX

Selecting, inserting and deleting results data


=SYGERQERMTYPEXIXLIUYIV]VIWYPXHEXEMREZEVMIX]SJ[E]W 

To select the entire data sheet


 6MKLXGPMGOMRXLI6IWYPX[MRHS[XSSPFEVERHXLIRGLSSWI7IPIGX%PP

To insert a new row into the data sheet before the current row
 6MKLXGPMGOMRXLI6IWYPX[MRHS[XSSPFEVERHXLIRGLSSWI-RWIVX6S[

236

SQL Navigator Users Guide

To delete the current row


 6MKLXGPMGOMRXLI6IWYPX[MRHS[XSSPFEVERHXLIRGLSSWI(IPIXI6S[

To jump between a query and its results page


 4VIWW'XVP*

To jump to the associated results tab


 'PMGOXLIKVMHMGSRMRKYXXIVXSXLIPIJXSJER]I\IGYXIH7)0)'8
WXEXIQIRX

6
Working with PL/SQL code

8LMWGLETXIVI\TPEMRWLS[XSYWIXLI7XSVIH4VSKVEQ)HMXSVXSHIZIPSTXLI
JSPPS[MRKX]TIWSJ40750TVSKVEQW 
 4VSGIHYVIW
 *YRGXMSRW
 3FNIGX8]TIW
 4EGOEKIW

In this chapter
Working with PL/SQL: Overview
Typical PL/SQL editing scenario
Working with packages
Tools and commands for editing stored programs
Database Source Code Search
Writing and editing stored programs
Executing stored programs
Optimizing stored programs: The PL/SQL Profiler
Debugging PL/SQL

238
240
240
242
267
268
275
280
295

238

SQL Navigator Users Guide

Working with PL/SQL: Overview


-R7502EZMKEXSV]SYYWIXLI7XSVIH4VSKVEQ)HMXSVXSHIZIPSTXLIJSPPS[MRK
X]TIWSJ40750TVSKVEQW 
 4VSGIHYVIW
 *YRGXMSRW
 3FNIGX8]TIW
 4EGOEKIW
7502EZMKEXSVTVSZMHIWEWITEVEXIIHMXSVJSVHEXEFEWIXVMKKIVW 
8LI7XSVIH4VSKVEQ)HMXSVLIPTWQEOI]SYV[SVO[MXLTVSGIHYVIWJEWXERH
IEW][MXLXLIJSPPS[MRKJIEXYVIW
 H]REQMGTEVWMRKERHW]RXE\GLIGOMRK
 H]REQMGLMKLPMKLXMRKSJQEXGLMRKTEMVWSJFVEGOIXWERHGSHIFPSGOW
 H]REQMGLMKLPMKLXMRKSJSFNIGXREQIWERHWMRKPIGPMGONYQTWXSXLISFNIGX
HIJMRMXMSR
 HSXPSSOYT
 WQEVXGSHIGSQTPIXMSR
 I\IGYXMSRGSHI[M^EVHJSVGVIEXMRKERSR]QSYWFPSGOW
 GYVWSVERHWMRKPIGPMGOREZMKEXMSRXSXLISFNIGXHIJMRMXMSR
=SYGERYWI7502EZMKEXSV
WWYMXISJMRXIKVEXIHHIZIPSTQIRXXSSPWXS
 FVS[WIXLI(&2EZMKEXSVXVII[LMGLHMWTPE]WXLIWXSVIHTVSKVEQW[MXLEPP
HITIRHIRXSFNIGXW
 ZMI[XLIWSYVGIGSHISJEPPTVSKVEQYRMXW
 GSQTMPIXLIGSHI
 WIXMRTYXTEVEQIXIVW
 VYRXLITVSKVEQ
 JM\IVVSVW
 XIWXXLIGSHI
 ZMI[VIWYPXWMRXLISYXTYX[MRHS[
 STXMQM^IXLIGSHI

Chapter 6

Working with PL/SQL code

239

Example
,IVI
WSRISJQER]TSWWMFPIWGIREVMSWJSPPS[IHF]KVETLMGEPI\EQTPIW
WLS[MRKXLIVIWYPXW
7XIT1

0SGEXIERHSTIREWXSVIHTVSGIHYVIMRXLI(&2EZMKEXSV

7XIT2

)HMXXLI40750MRXLI7XSVIH4VSKVEQ)HMXSV

7XIT3

7IXFVIEOTSMRXWERH[EXGLIWJSVI\IGYXMSRMRHIFYKQSHI

7XIT4

4VIWW*SVGPMGOEFYXXSRXSI\IGYXIXLIGSHI

7XIT5

7502EZMKEXSVGVIEXIWERERSR]QSYWFPSGOERHWYFQMXWXLIGSHI
JSVI\IGYXMSR8LI)\IGYXMSR'SHI[M^EVHPIXW]SYZMI[ERHQSHMJ]
XLII\IGYXMSRGSHI

7XIT6

%JXIVXLITVSGIHYVII\IGYXIW]SYGERZMI[XLIVIWYPXWMRXLI3YXTYX
[MRHS[

7XIT7

=SYGEREGXMZEXIXLI407504VSJMPIVXSEREP]^IGSZIVEKIERH
I\IGYXMSRXMQIW

240

SQL Navigator Users Guide

Typical PL/SQL editing scenario

Working with packages


;SVO[MXLTEGOEKIWMWJEWXERHIEW]MRXLI7XSVIH4VSKVEQ)HMXSV[MXLXLI
MRXIKVEXIH'SHI)\TPSVIV
8LI'SHI)\TPSVIVKVETLMGEPP]HMWTPE]WEXVIIWXVYGXYVIZMI[SJXLITEGOEKI
GYVVIRXP]MRXLIIHMXSV-XWLS[WZEVMEFPIWTEVEQIXIVWVIGSVHWXVYGXYVIWX]TIW
GYVWSVWERHWSSR
8LIXVIIZMI[MWW]RGLVSRM^IH[MXLXLIIHMXMRKGYVWSVMRXLIGSHIIHMXMRK
[MRHS[WS[LIR]SYGPMGOER]TEGOEKIGSQTSRIRXMRXLIXVIIZMI[]SYGER
WIIXLIGSVVIWTSRHMRK40750GSHIMRXLIIHMXMRK[MRHS[0MOI[MWIEW]SY
QSZIXLIGYVWSVMRXLIIHMXMRK[MRHS[XLIXVIIZMI[GLERKIWXSWLS[XLI
SFNIGXGSVVIWTSRHMRKXSXLI40750GSHIEXXLIGYVWSVPSGEXMSR

Chapter 6

Working with PL/SQL code

241

;LIR]SYZMI[ETEGOEKIMRXLI7XSVIH4VSKVEQ)HMXSV]SYGERGPMGOXLI7TIG
ERH&SH]XEFWXSW[MXGLFIX[IIRXLIWTIGMJMGEXMSRERHXLIFSH]8LIOI]FSEVH
IUYMZEPIRXMW%PX*
8SNYQTFIX[IIRXLIHIGPEVEXMSRERHMQTPIQIRXEXMSRSJXLIGYVVIRXTVSGIHYVI
[MXLMRETEGOEKITVIWW'XVP7LMJXHS[REVVS[
Sample view of a package in two synchronized panes

242

SQL Navigator Users Guide

Tools and commands for editing stored programs


=SYGERYWIXLIWEQIGSQQERHWERHXSSPWJSV[SVOMRK[MXLWXSVIHTVSKVEQW
EWJSV[SVOMRK[MXLSXLIVHEXEFEWISFNIGXWMR7502EZMKEXSV*SVI\EQTPI
XLIWXERHEVHHEXEFEWISFNIGXIHMXMRKGSQQERHWEVIEZEMPEFPISRXLI7XSVIH
4VSKVEQ)HMXSVXSSPFEV PMWXIHFIPS[ 
1ER]SXLIVGSQQERHWJSV[SVOMRK[MXLHEXEFEWISFNIGXWEVIEZEMPEFPIJSV
I\EQTPIXLSWIJVSQXLI3FNIGXQIRY[LIREWXSVIHTVSKVEQMWSTIRJSV
IHMXMRK
-REHHMXMSRXSXLIWXERHEVHSFNIGXIHMXMRKGSQQERHWXLIVIEVIWIZIVEPYRMUYI
ERHTS[IVJYPXSSPWJSVIHMXMRKWXSVIHTVSKVEQW
*SVGSRZIRMIRGIQIRYGSQQERHWGERFIPSSWIP]KVSYTIHEWJSPPS[W
GSVVIWTSRHMRKXSXLIWIZIRGSQQERHQIRYW]SY[MPPTVSFEFP]RIIHQSWX
SJXIR
Commands for

are found here

'SRXVSPPMRKXLIGSRXIRXWSJXLI7XSVIH
4VSKVEQ)HMXSV[MRHS[

7XSVIH4VSKVEQ)HMXSVXSSPFEV

1EREKMRKSFNIGXWMRWGLIQEW

3FNIGXQIRYERHXSSPFEV

,ERHPMRKXI\XERHGSHI

)HMXQIRYERHXSSPFEV

7IEVGLMRKJSVGSHISVSFNIGXW

7IEVGLQIRYERHXSSPFEV

%GGIWWXSZEVMSYW7502EZMKEXSV[MRHS[W
ERHXSSPW

:MI[QIRYERH*YRGXMSRW
XSSPFEV

1EREKMRKHEXEFEWIWIWWMSRW

7IWWMSRQIRYERH*YRGXMSRWXSSPFEV

%GGIWWXSEHHSRWMRXIKVEXIHETTPMGEXMSRW
ERHEHHMXMSREPXSSPW

8SSPWQIRYERH*YRGXMSRWXSSPFEV

Advanced editing features for stored programs


8LIJSPPS[MRK7502EZMKEXSVJIEXYVIW[MPPFIIWTIGMEPP]YWIJYPJSV7XSVIH
4VSKVEQHIZIPSTQIRX 

Smart code completion


.YWXWXEVXX]TMRKERMHIRXMJMIVERHXLIIHMXSVEYXSQEXMGEPP]HMWTPE]WEWIPIGXEFPI
PMWXSJQEXGLMRKW]QFSPW ZEVMEFPIWTEVEQIXIVWTVSGIHYVIWX]TIW MRXLI
GYVVIRXWGSTI

Chapter 6

Working with PL/SQL code

243

Dot-lookup
8]TIEHSXGLEVEGXIVEJXIVEREQISJZEVMEFPIXLIIHMXSVEYXSQEXMGEPP]HMWTPE]W
EWIPIGXEFPIPMWXSJQIQFIVWSJE40750VIGSVHGYVWSVTEGOEKISV
63;8=4)VIGSVH

Code Explorer
8LI'SHI)\TPSVIVHMWTPE]WELMIVEVGLMGEPPMWXSJEPPW]QFSPWMRXLITEGOEKISV
TVSGIHYVIERHLMKLPMKLXWXLITVSGIHYVIXLIGYVWSVMWGYVVIRXP]MR-XEPWS
EPPS[W]SYXSREZMKEXI[MXLMRXLITVSKVEQF]HSYFPIGPMGOMRKEW]QFSP

Customizable syntax highlighting for PL/SQL


8LIIHMXSVYWIWHMJJIVIRXGSPSVWXSLMKLPMKLXHMJJIVIRXW]RXE\IPIQIRXW[MXLMRE
TVSKVEQ=SYGERWTIGMJ]GSPSVTVIJIVIRGIWJSVXLMWJIEXYVI

Dynamic highlighting of matching pairs of brackets


;LIR]SYTPEGIXLIGYVWSVEXEFVEGOIX[MXLMRERI\TVIWWMSRXLIIHMXSV
EYXSQEXMGEPP]LMKLPMKLXWXLIQEXGLMRKFVEGOIXW

Dynamic highlighting of the closest encompassing block


4PEGIXLIGYVWSVRIEVEFPSGOTVSGIHYVIPSSTSV-*WXEXIQIRXERHXLIIHMXSV
EYXSQEXMGEPP]WLS[WXLIFIKMRRMRKERHIRHSJXLIFPSGOWXVYGXYVIYWMRKEVVS[
KP]TLWMRXLIKYXXIV

One-key switching between implementation and specification of


a packaged procedure
8SQSZIXLIGYVWSVFIX[IIRXLIHIGPEVEXMSRSJETVSGIHYVIMRXLIWTIGMJMGEXMSR
ERHMXWMQTPIQIRXEXMSRMRXLITEGOEKIFSH]YWI'XVP7LMJXHS[REVVS[ERH
'XVP7LMJXYTEVVS[

Hyperlinking
8SWIIXLIHIGPEVEXMSRSJERMHIRXMJMIVTVIWW'XVPGPMGO8LIXI\XGYVWSV
EYXSQEXMGEPP]NYQTWXSXLIHIGPEVEXMSRSJXLIW]QFSPMJMXkWHIJMRIH[MXLMRXLI
WEQITVSKVEQ-JMXkWEREQISJERI\XIVREPHEXEFEWISFNIGXER%YXS(IWGVMFI
STIRW8SVIXYVRXSXLISVMKMREPTSWMXMSRMRXLIXI\XTVIWW'XVP&EGOWTEGI

Syntax tooltips
8SWIIEXSSPXMTHIWGVMFMRKEORS[RW]QFSP ZEVMEFPITEVEQIXIVTVSGIHYVI
SVX]TI EPP]SYRIIHXSHSMWTSMRXXSMX

244

SQL Navigator Users Guide

Controlling what is displayed in the Stored Program


Editor
=SYYWIXLIGSQQERHWSRXLI7XSVIH4VSKVEQ)HMXSVXSSPFEVXSGSRXVSPXLI
GSRXIRXSJXLIIHMXMRK[MRHS[

Stored Program Editor toolbar commands


4MR9RTM
R

3TIREHHMXMSREP7XSVIH4VSKVEQ)HMXSV
[MRHS[W 4MR SVSTIREHHMXMSREP
SFNIGXWMRXLIWEQI[MRHS[ 9RTMR 

3TIR

3TIREHEXEFEWISFNIGXYWMRKXLI7IPIGX
(&3FNIGXWIEVGLXSSP

2I[

'VIEXIERI[WXSVIHTVSKVEQ

'PSRI

'VIEXI GPSRI ERI[WXSVIHTVSKVEQ


[MXLEHIJMRMXMSRMHIRXMGEPXSXLEXSJXLI
SRIGYVVIRXP]STIR



6IZIVX

'ERGIPIHMXMRKERHVIUYIV]XLI
HIJMRMXMSRSJXLITVSKVEQJVSQXLI
HEXEFEWI



750

(MWTPE]XLI750WGVMTXMREWITEVEXI
[MRHS[

7EZI

7YFQMXXLI40750XSXLIHEXEFEWI
GSQTMPIERHVITSVXIVVSVW

'SHI
)\TPSVIV

7LS[SVLMHIXLI'SHI)\TPSVIV
[MRHS[

7]RGLVS
RM^I

1ERYEPP]JSVGIW]RGLVSRM^EXMSRSJ
EHZERGIHIHMXMRKJIEXYVIWEJXIVQEOMRK
I\XIRWMZIGLERKIWXSGSHI EPWSORS[R
EWJYPPQERYEPTEVWI 1SVI
MRJSVQEXMSR












Chapter 6

Working with PL/SQL code

245

Managing stored programs as database objects


=SYYWIXLIGSQQERHWSRXLI3FNIGXQIRYERHXSSPFEVXS[SVO[MXLWXSVIH
TVSKVEQWERHSXLIVHEXEFEWISFNIGXWMRWGLIQEW 

Object menu and toolbar commands (stored procedure open)


6



246

SQL Navigator Users Guide

To

Use this command

'VIEXIERI[HEXEFEWISFNIGX

'VIEXI(&3FNIGX

3TIREHEXEFEWISFNIGXYWMRKXLI7IPIGX(&3FNIGX
WIEVGLXSSP

3TIR(&3FNIGX

3TIRXLIGYVVIRXP]WIPIGXIHWXSVIHTVSKVEQ

3TIR

(MWTPE]XLIEXXVMFYXIWQIXLSHWERHEVKYQIRXWSJ
XLIWXSVIHTVSKVEQ

(IWGVMFI

)\XVEGX((0JSVXLIWXSVIHTVSKVEQ

)\XVEGX((0

'SQTMPI6IFYMPHXLIWXSVIHTVSKVEQ

'SQTMPI

)\IGYXIXLITVSKVEQERHHMWTPE]VIWYPXW

)\IGYXI

+VERXSFNIGXTVMZMPIKIWJSVXLIWXSVIHTVSKVEQ

+VERX

6IZSOISFNIGXTVMZMPIKIWJSVXLIWXSVIHTVSKVEQ

6IZSOI

4SMRXXSXLIPSGEXMSRSJXLIWXSVIHTVSKVEQMRXLI
(&2EZMKEXSV[MRHS[

0SGEXIMR7GLIQE

7LS[XLITVSTIVXMIWSJXLIWXSVIHTVSKVEQ

4VSTIVXMIW

%HHXLIWXSVIHTVSKVEQXSXLI;SVOWTEGI

%HHXS[SVOWTEGI

Chapter 6

Working with PL/SQL code

247

Editing code in stored programs


=SYYWIXLIGSQQERHWSRXLI)HMXQIRYERHXSSPFEVJSVIHMXMRK]SYVTVSKVEQ
GSHI 

Edit menu and toolbar commands (stored procedure open)



248

SQL Navigator Users Guide

To

Use this command

6IZIVWISVVIETTP]XLITVIZMSYWIHMXMRK
EGXMSR

9RHS6IHS

6IQSZIWIPIGXIHXI\XERHTPEGIMXSRXLI
GPMTFSEVH

'YX


'ST]WIPIGXIHXI\XXSXLIGPMTFSEVH

'ST]

-RWIVXXLIGPMTFSEVHGSRXIRXW

4EWXI

7IPIGXEPPXI\XMRXLIMXIQFIMRKIHMXIH

7IPIGX%PP

-RHIRXXLIGYVVIRXPMRI

-RHIRX

9RMRHIRXXLIGYVVIRXPMRI

9RMRHIRX

)RGPSWIXLIWIPIGXIHXIWXMRWMHI40750
GSQQIRXQEVOW

'SQQIRX

6IQSZIXLI40750GSQQIRXQEVOWJVSQ
XLIWIPIGXIHXI\X

9RGSQQIRX

'SRZIVXWIPIGXIHXI\XXSYTTIVGEWI

9TTIV'EWI

'SRZIVXWIPIGXIHXI\XXSPS[IVGEWI

0S[IV'EWI

'SRZIVXEPPOI][SVHWERHVIWIVZIH[SVHWMR
XLITVSKVEQXSYTTIVGEWI

'SRZIVX/I][SVHWXS9TTIVGEWI

'SRZIVXEPPOI][SVHWERHVIWIVZIH[SVHWMR
XLITVSKVEQXSPS[IVGEWI

'SRZIVX/I][SVHWXS0S[IVGEWI

4PEGIXLIWIPIGXIHGSHIMRXLI750)HMXSV

3TIR7IPIGXIH8I\XMR750)HMXSV

-RWIVXEJMPIEXXLIGYVVIRXTSWMXMSR

-RWIVX4*MPI

-RWIVXE(&17C398498498C0-2)  
WXEXIQIRXEXXLIGYVVIRXTSWMXMSR 8LMW
TVSGIHYVIHMWTPE]WTVSKVEQSYXTYXEJXIV
I\IGYXMSR 

-RWIVX4(&17C398498498C0-2
)  

'VIEXIEHIFYKKMRKWXEXIQIRXJSVXLI
ZEVMEFPIEXXLIGYVVIRXGYVWSVTSWMXMSR

-RWIVX4(IFYK:EVMEFPI

9WI4EWXIXSTPEGIMXMRXSXLIGSHI 

=SYGEREPWSMRZSOIXLMWJYRGXMSRF]
TPEGMRKXLIGYVWSVSRXLIZEVMEFPI
ERHTVIWWMRK*

-RWIVXE'69(QEXVM\IRGPSWIHMRGSQQIRX -RWIVX4'69(1EXVM\
QEVOIVWEXXLIGYVVIRXTSWMXMSR 8LMW
TVSZMHIWEGSRZIRMIRXQIXLSHSJ
HSGYQIRXMRKETVSGIHYVI 

Chapter 6

Working with PL/SQL code

1SZIXSEWTIGMJMGPMRIRYQFIV

249

+SXS0MRI


1SZIXSXLISXLIVFVEGOIX[MXLMREKMZIR
TEMVSJFVEGOIXW

.YQTXS1EXGLMRK&VEGOIX

4PEGIEFSSOQEVOEXXLIGYVVIRXPMRI

8SKKPI&SSOQEVO

.YQTXSEFSSOQEVO

0MWX&SSOQEVOW

3TIRXLIHEXEFEWISFNIGXVIJIVIRGIHEXXLI
GYVVIRXGYVWSVTSWMXMSR

3TIR3FNIGXEX'YVWSV

7LS[()7'6-&)MRJSVQEXMSRJSVXLI
HEXEFEWISFNIGXVIJIVIRGIHEXXLIGYVVIRX
GYVWSVTSWMXMSR

(IWGVMFI3FNIGXEX'YVWSV

Automated coding assistance


8LI7XSVIH4VSKVEQIHMXSVKMZIW]SYEGGIWWXSXLIJSPPS[MRKGETEFMPMXMIW
'SHI%WWMWXERX+MZIW]SYMRWXERXEGGIWWXSE7]RXE\ERH;IF'EXEPSKE'SHI
ERH750'EXEPSKERH40:MWMSRGEXEPSKW-XEPPS[WYWIVWXSHVEKERHHVST
40750W]RXE\750JYRGXMSRWGSPYQRREQIWERHHEXEFEWISFNIGXREQIWMRXS
GSHIMRGPYHMRKEGGIWWXSXLI40:MWMSRGEXEPSKW
)\IGYXMSRGSHI[M^EVH1EOIWMXIEW]XSGVIEXIERSR]QSYWFPSGOW
7QEVXGSHIGSQTPIXMSR%YXSQEXMGEPP]HMWTPE]WETMGOPMWXSJQEXGLMRK
W]QFSPW ZEVMEFPIWTEVEQIXIVWTVSGIHYVIWX]TIW MRXLIGYVVIRXWGSTI[LIR
]SYWXEVXX]TMRKMRERMHIRXMJMIV
(SXPSSOYT%YXSQEXMGEPP]HMWTPE]WETMGOPMWXSJQIQFIVWSJE40750
VIGSVHGYVWSVTEGOEKISV63;8=4)VIGSVH[LIR]SYX]TIEHSXGLEVEGXIV
EJXIVEREQISJZEVMEFPI
'SHI)\TPSVIV+VETLMGEPP]HMWTPE]WTEGOEKIWERHH]REQMGEPP]TEVWIWERH
GLIGOWW]RXE\(MWTPE]WELMIVEVGLMGEPPMWXSJEPPW]QFSPWMRXLITEGOEKISV
TVSGIHYVIERHLMKLPMKLXWXLITVSGIHYVIXLIGYVWSVMWGYVVIRXP]MR(SYFPIGPMGO
SREW]QFSPXSREZMKEXI[MXLMRXLITVSKVEQ
'YWXSQM^EFPIW]RXE\LMKLPMKLXMRK,MKLPMKLXWYWMRKHMJJIVIRXGSPSVW40750
W]RXE\IPIQIRXW[MXLMRETVSKVEQ
(]REQMGLMKLPMKLXMRKSJTEMVIHFVEGOIXW;LIR]SYWIXXLIGYVWSVEXEFVEGOIX
[MXLMRERI\TVIWWMSRXLIQEXGLMRKFVEGOIXMWEYXSQEXMGEPP]LMKLPMKLXIH
'SHIFPSGOLMKLPMKLXMRK;LIR]SYTPEGIXLIGYVWSVMRSVEFPSGOTVSGIHYVI
PSSTSV-*WXEXIQIRX]SY[MPPWIIEVVS[WMRXLIKYXXIV XSXLIPIJXSJXLIGSHI
PMWXMRK XLEXQEVOXLIFIKMRRMRKERHIRHSJXLIFPSGO

250

SQL Navigator Users Guide

7[MXGLMRKFIX[IIRTEGOEKIMQTPIQIRXEXMSRERHWTIGMJMGEXMSR;LIRIHMXMRKE
TEGOEKIHTVSGIHYVI]SYGERYWI'XVP7LMJXTPYWXLIHS[RSVYTEVVS[XS
QSZIXLIGYVWSVFIX[IIRXLIWTIGMJMGEXMSRERHXLIFSH]
,]TIVPMRONYQTW-J]SY[ERXXSQSZIXLIXI\XGYVWSVXSXLIHIGPEVEXMSRSJE
W]QFSP SV%YXS(IWGVMFIMXMJMX
WXLIREQISJERI\XIVREPHEXEFEWI NYWXTVIWW
'XVPERHTSMRXXSXLIW]QFSP[MXLXLIQSYWITSMRXIV8SVIXYVRXSXLIJSVQIV
TSWMXMSRMRXLIXI\XTVIWW'XVP&EGOWTEGI
7]RXE\LMRXW8SVIEHEHIWGVMTXMSRSJEZEVMEFPITEVEQIXIVTVSGIHYVISV
X]TITSMRXXSMX[MXLXLIQSYWITSMRXIV

Searching for code or objects in the database


=SYYWIXLIGSQQERHWSRXLI7IEVGLQIRYXSJMRHGSHISVSFNIGXWWXSVIHMR
XLIHEXEFEWI 

Search menu commands



Chapter 6

Working with PL/SQL code

To

251

Use this command

*MRHEXI\XWXVMRKERHVITPEGIMX[MXL
ERSXLIV

*MRH6ITPEGI

*MRHXLIRI\XSGGYVVIRGISJXLIWIEVGL
WXVMRK

*MRH2I\X

+SFEGOXSXLITVIZMSYWSGGYVVIRGISJ
XLIWIEVGLWXVMRK

*MRH4VIZMSYW

*MRHWSYVGIGSHIMRXLIHEXEFEWIYWMRK
XLI(EXEFEWI7SYVGI'SHI7IEVGLXSSP

'SHI7IEVGL

*MRHSRISVQSVIHEXEFEWISFNIGXW
QEXGLMRKEWIEVGLEVKYQIRXYWMRKXLI
*MRH3FNIGXWHMEPSK

*MRH3FNIGXW

Using other SQL Navigator windows with the Stored


Program Editor
=SYYWIXLIGSQQERHWSRXLI:MI[QIRYJSVEGGIWWXSEZEVMIX]SJ750
2EZMKEXSV[MRHS[WERHHIZIPSTQIRXXSSPW
2SXIXLEXWSQI[MRHS[WJSVI\EQTPIXLI;SVOWTEGI[MRHS[ERHXLI'SHI
%WWMWXERXGERFITPEGIHSYXWMHISJXLIQEMRETTPMGEXMSR[MRHS[8LMWMWZIV]
GSRZIRMIRXFYXYRXMP]SYEVIYWIHXSMX]SYQE]XIQTSVEVMP]PSWIXVEGOSJ
[LEXMWSTIRERH[LIVIMXMW8LI2I\X;MRHS[ERH4VIZMSYW;MRHS[
GSQQERHW[MPPLIPT]SYJMRHEPSWXSVLMHHIR[MRHS[

252

SQL Navigator Users Guide

View menu commands



Chapter 6

Working with PL/SQL code

253

To

Use this command

&VMRKXLIRI\XSTIR[MRHS[XSXLIXST

2I\X;MRHS[

&VMRKXLITVIZMSYWSTIR[MRHS[XSXLIXST

4VIZMSYW;MRHS[

:MI[SVLMHIXLI;SVOWTEGI[MRHS[

;SVOWTEGI;MRHS[

:MI[SVLMHIXLI;SVOWTEGI[MRHS[

8EWO1EREKIV

:MI[SVLMHIXLI;SVOWTEGI[MRHS[

(&2EZMKEXSV

3TIRERI[MRWXERGISJXLI750)HMXSV

2I[750)HMXSV

3TIREHEXEFEWISFNIGXSJSRISJXLIWI
X]TIWMREZMWYEPSFNIGXIHMXSV

:MWYEP3FNIGX)HMXSV4

 'SRWXVEMRX
 (EXEFEWI0MRO
 -RHI\
 4VSJMPI
 6SPI
 7IUYIRGI
 7XSVIH4VSKVEQ
 7]RSR]Q
 8EFPI
 8VMKKIV
 :MI[

:MI[SVLMHIXLI3YXTYX;MRHS[

3YXTYX;MRHS[

:MI[SVLMHIXLI'SHI%WWMWXERX[MRHS[

'SHI%WWMWXERX

:MI[SVLMHIXLI%YXS(IWGVMFI[MRHS[

%YXS(IWGVMFI

3TIRXLI;SVOWTEGI[MRHS[

4VIJIVIRGIW

254

SQL Navigator Users Guide

Managing your editing session


=SYYWIXLIGSQQERHWSRXLI7IWWMSRQIRYERHXSSPFEVXSQEKIERH
GSRJMKYVI]SYVGSRRIGXMSRXSXLIHEXEFEWI

Chapter 6

Working with PL/SQL code

255

Session menu commands


To

Use this command

3TIRERI[HEXEFEWIWIWWMSR

2I[7IWWMSR

7[MXGLXSERSXLIVSTIRWIWWMSR

7IPIGX

%GXMZEXIWIVZIVSYXTYX

7IVZIV3YXTYX

%GXMZEXI40750(IFYKKMRKQSHI

40750(IFYKKMRK3R

-RGPYHIHIFYKKMRKMRJSVQEXMSRMRXLI
GSQTMPIHTVSGIHYVI

-RGPYHI(IFYK-RJS

7XEVXXLI3VEGPI;IFWIVZIVSTXMSR

[IFWYTTSVX

7IXYT3VEGPI;IFHIZIPSTQIRXWYTTSVX

;IF'SRJMKYVEXMSR

)\IGYXIXLIWXSVIHTVSKVEQ

6YR

7YWTIRHI\IGYXMSR

7YWTIRH

8IVQMREXII\IGYXMSRSJXLIWXSVIH
TVSKVEQ

7XST

'SQQMXER]GLERKIWXSHEXEXLEXLEZI
FIIRQEHIMRXLIGYVVIRXWIWWMSR

'SQQMX

7IIEPWSXLI-QQIHMEXIP]'SQQMX)ZIV]
(107XEXIQIRXSTXMSRMR7IWWMSR
4VIJIVIRGIW 

6SPPFEGOER]GLERKIWXSHEXEXLEXLEZI
FIIRQEHIMRXLIGYVVIRXWIWWMSR

6SPPFEGO

(MWGSRRIGXJVSQXLIGYVVIRXHEXEFEWI
WIWWMSR

(MWGSRRIGX

(MWGSRRIGXJVSQEPPHEXEFEWIWIWWMSRW

(MWGSRRIGX%PP

6IIWXEFPMWLXLIHEXEFEWIGSRRIGXMSR

6IGSRRIGX

'PSWIXLIGYVVIRXIHMXMRKWIWWMSR[MXLER
STXMSRXSWEZIER]GLERKIWQEHIMRXLI
GYVVIRXWIWWMSR

'PSWI

256

SQL Navigator Users Guide

Access to tools and add-ons for stored program


development
-REHHMXMSRXSXLI7IWWMSRQIRYERHXSSPFEVXLI*YRGXMSRWXSSPFEVERHXLI
8SSPWQIRYKMZI]SYEGGIWWXSE[MHIZEVMIX]SJTS[IVJYP7502EZMKEXSV
HIZIPSTQIRXXSSPWERHEHHSRW

Tools menu commands (stored procedure open)



Chapter 6

Working with PL/SQL code

257

For

Use this tool or add-on

%YXSQEXIHFYMPHMRKERHXIWXMRKSJUYIVMIW

5YIV]&YMPHIV

'VIEXIWXSVIERHFVS[WII\IGYXMSRTPERW

)\TPEMR4PER8SSP

%YXSQEXMGMQTEGXEREP]WMWJSVER]TVSTSWIH
WXVYGXYVEPHEXEFEWIGLERKIW

<TIVX8YRMRK
750-QTEGX5%
750-QTEGX;LIVI9WIH

+VETLMGEPEREP]WMWSJGSHII\IGYXMSR
MRGPYHMRKXLIRYQFIVSJXMQIWIEGLPMRI[EW
I\IGYXIHERHXLIXMQIVIUYMVIHJSVI\IGYXMSR

407504VSJMPIV

(VEKERHHVSTSTXMQM^IHVSYXMRIWHMVIGXP]
MRXSTVSKVEQGSHIJVSQEPMFVEV]SJQSVI
XLERTVIFYMPX40750VSYXMRIW

40:MWMSR'SRXVSP4ERIP

5YMGOEGGIWWXSORS[PIHKIFEWIWWYGLEW
/RS[PIHKI<TIVXJSV%GXMZI40750
(IZIPSTQIRXERH/RS[PIHKI<TIVXJSV
3VEGPI%HQMRMWXVEXMSR[MXLXLSYWERHWSJ
XIGLRMGEPXSTMGWERHLYRHVIHWSJVIYWEFPI
GSHII\EQTPIW

7IEVGL/RS[PIHKI<TIVX

'LSSWIJVSQEWIPIGXMSRSJVIEH]QEHI
HEXEFEWIVITSVXJSVQEXW

6ITSVX8VII

'SRZIVXER,810JMPIMRXSE40750WXSVIH
TVSGIHYVIXSFISYXTYXZMEXLI3VEGPI;IF
'EVXVMHKI

-QTSVX,810EW40750

(ITPS]E+9-HVMZIRJYPP]EYXSQEXIH
WGLIQEGLERKITVSGIWW[MXLJIEXYVIWJSV
XVEGOMRKZIVWMSRMRKERHEYHMXMRK

7GLIQE1EREKIV4VSJIWWMSREP

%GGIWWXLI3VEGPI.SF1EREKIVMRXIVJEGI

.SF1EREKIV

;SVO[MXL.EZESFNIGXW

.EZE1EREKIV

'SQTEVIX[SZIVWMSRWSJEWGVMTXSVSFNIGX

:MI[(MJJIVIRGI

-RWXEPPXLIWIVZIVWMHIGSQTSRIRXWSJ750
2EZMKEXSV

7IVZIV7MHI-RWXEPPEXMSR;M^EVH

)RXIVERI[EYXLSVM^EXMSROI]

4VSHYGX%YXLSVM^EXMSR

40*SVQEXXIV

258

SQL Navigator Users Guide

Synchronizing advanced editing features


1ER]JIEXYVIWSJXLI7502EZMKEXSV7XSVIH4VSKVEQ)HMXSVMRGPYHMRKXLI
'SHI)\TPSVIV[MRHS[GSHIGSQTPIXMSRXSSPXMTHMWTPE]SJTVSKVEQ
EVKYQIRXWFVEGOIXQEXGLMRKKYXXIVFPSGOQEVOIVWERHSXLIVWVIP]SR
EYXSQEXMGTEVWMRKSJXLI40750GSHIERHMRXIVREPP]KIRIVEXMRKEW]QFSP
XEFPI8LMWTEVWMRKSGGYVW[LIRXLIIHMXSVJMVWXPSEHWXLISFNIGXWERHMXEPWS
SGGYVWMRXLIFEGOKVSYRHMRSVHIVXSQEMRXEMRXLIW]QFSPXEFPIEWXLIYWIV
IHMXWXLIGSHI
=SYGERGSRXVSPXLISTIVEXMSRSJFEGOKVSYRHTEVWMRKSJXLIWXSVIHGSHI 7II
:MI["4VIJIVIRGIW"'SHI)HMXSVW"7XSVIH4VSKVEQ)HMXSV 
=SYGEREPWSQERYEPP]XVMKKIVEJYPPVITEVWMRK YTHEXMRKSJXLIMRXIVREPW]QFSP
XEFPI EXER]XMQIF]GPMGOMRKXLI7]RGLVSRM^IFYXXSRMRXLI7XSVIH4VSKVEQ
)HMXSV
XLI7]RGLVSRM^IFYXXSR

Viewing compiler errors


7502EZMKEXSVHMWTPE]WEPPGSQTMPEXMSRIVVSVWMREWITEVEXIWGVSPPEFPI[MRHS[
MRXLIPS[IVTSVXMSRSJXLI7XSVIH4VSKVEQ)HMXSV

Oracle error code explanation display


8SZMI[EJYPP]I\TERHIH3VEGPIIVVSVHIWGVMTXMSR]SYGERHSYFPIGPMGOSRER
IVVSVGSHIMRER]SJXLIIHMXSVWSVMRXLI4VSGIWWMRK3YXTYXEVIE
8LIVIWYPXMRKHMEPSKGSRXEMRWXLIIVVSVQIWWEKIHIWGVMTXMSRGEYWIERHEGXMSRW
NYWXEWXLI]ETTIEVMRXLI3VEGPIHSGYQIRXEXMSR

To view a full Oracle error description


 (SYFPIGPMGOERIVVSVGSHIMRER]IHMXSVSVMRXLI4VSGIWWMRK3YXTYXEVIE
SJ(&2EZMKEXSV

To view the source code corresponding to a listed error


1
2

-RXLIGSQTMPEXMSRIVVSV[MRHS[GPMGOXLIIVVSVXI\X8LIGYVWSVQSZIWXS
XLIGSVVIWTSRHMRKWSYVGIGSHI
8SEPXIVXLIWM^ISJXLIIVVSV[MRHS[HVEKXLIWTPMXXIVFEV

Chapter 6

Working with PL/SQL code

259

The Knowledge Xpert


8LI/RS[PIHKI<TIVXGSQTSRIRXWPIX7502EZMKEXSVYWIVWHVEKERHHVST
STXMQM^IHVSYXMRIWHMVIGXP]MRXSXLIMVTVSKVEQIHMXSV
/RS[PIHKI<TIVX JSVQIVP]6IZIEP2IX MWEPMFVEV]SJQSVIXLERTVIFYMPX
40750VSYXMRIW[VMXXIRF]WSQISJXLI[SVPHkWPIEHMRK40750I\TIVXWXLEX
GERFIMRXIKVEXIHMRXSXLIWXERHEVH40750IRZMVSRQIRX8LIGSQTPIXI
40750'SHI0MFVEV]GERIPMQMREXILSYVWSJPS[PIZIPGSHMRKERHHIFYKKMRK
[LMPIIRLERGMRKETTPMGEXMSRTIVJSVQERGIERHVIPMEFMPMX]

260

SQL Navigator Users Guide

PL/Vision Control Panel settings


Tab / Category

Setting

Result

(EXI*SVQEX1EWO

(MWTPE]WXLIZEPYIVIXYVRIHF]
XLITPZHEXIQEWOJYRGXMSRERH
GLERKMRKXLMWWXVMRKYWIWXLI
TPZWIXCHEXIQEWOTVSGIHYVIXS
WIXXLIIRXIVIHZEPYI

2YPP7YFWXMXYXMSR:EPYI

(MWTPE]WXLIZEPYIVIXYVRIHF]
XLITPZRYPPZEPJYRGXMSRERH
GLERKMRKXLMWWXVMRKYWIWXLI
TPZWIXCRYPPZEPTVSGIHYVIXSWIX
XLIIRXIVIHZEPYI

Exceptions

9WI'SRXI\

;LIRGLIGOIHXLI
40:I\G9WI'SRXI\XMWWIX

General
4IVXEMRWXSWIXXMRKWMRXLI40:
TEGOEKI

4IVXEMRWXSXLI40:)\IG
TEGOEKI


;LIRYRGLIGOIHXLI
40:I\G2S9WI'SRXI\XMWWIX


0SKKMRK

;LIRGLIGOIHXLI40:I\G0SK
MWWIX
;LIRYRGLIGOIHXLI
40:I\G2S0SKMWWIX

8VEGMRK

;LIRGLIGOIHXLI40:I\G8VG
MWWIX
;LIRYRGLIGOIHXLI
40:I\G2S8VGMWWIX

Chapter 6

Working with PL/SQL code

Tab / Category

Setting

261

Result

(IPMQMXIV4EH'LEV

(MWTPE]WXLIZEPYIWVIXYVRIHF]
XLITPZI\GHIPMQMXIVERH
TPZI\GTEHGLEVVIWTIGXMZIP]
'LERKMRKIMXLIVSJXLIWIZEPYI
YWIWXLITPZI\GWIXHIPMQ
TVSGIHYVIXSWIXXLIIRXIVIH
ZEPYIW

Logging

)REFPI

;LIRGLIGOIHXLI
40:0SK8YVRCSRMWWIX

4IVXEMRWXSXLI40:0SK
4EGOEKI


;LIRYRGLIGOIHXLI
40:0SK8YVRCSJJMWWIX


6SPPFEGO&IJSVI

;LIRGLIGOIHXLI
40:0SKHSCVSPPFEGOMWWIX
;LIRYRGLIGOIHXLI
40:0SKRSHSCVSPPFEGOMWWIX

0SK8]TI

(MWTPE]WXLIZEPYIVIXYVRIHF]
XLITPZ0SKPSKX]TIJYRGXMSR
ERHGLERKMRKXLMWWXVMRKLEWRS
IJJIGXSRXLIPMFVEV]TEGOEKIW
EXXLI3VEGPIWIVZIVIRH

'VIEXIH&]

(MWTPE]WXLIZEPYIVIXYVRIHF]
XLITPZ0SKGVIEXIH&]JYRGXMSR
ERHGLERKMRKXLMWWXVMRKYWIW
XLITPZ0SKGVIEXIH&]
TVSGIHYVIXSWIXXLIIRXIVIH
ZEPYI

(IPMQMXIV

(MWTPE]WXLIZEPYIVIXYVRIHF]
XLITPZ0SKHIPMQJYRGXMSRERH
GLERKMRKXLMWWXVMRKYWIWXLI
TPZ0SKWIXHIPMQTVSGIHYVIXS
WIXXLIIRXIVIHZEPYI

262

Tab / Category

SQL Navigator Users Guide

Setting

Result

Tracing

*SV40:8VG )\IGYXMSR8VEGI
*EGMPMX] 

)REFPI

;LIRGLIGOIHXLI
40:XVG8YVRCSRMWWIX

(IEPW[MXLXLI40:8VGERH
40:<QR4EGOEKIW

0SKKMRK

;LIRYRGLIGOIHXLI
40:XVG8YVRCSJJMWWIX
;LIRGLIGOIHXLI40:XVGPSK
MWWIX
;LIRYRGLIGOIHXLI
40:XVGRSPSKMWWIX

9WMRK40:\QR

;LIRGLIGOIHXLI
40:XVGYWI\QRMWWIX
;LIRYRGLIGOIHXLI
40:XVGRSYWI\QRMWWIX

(MWTPE]1SHI

;LIRGLIGOIHXLI
40:XVGHMWTPE]QSHIMWWIX
2SXI8LID0MRIWFIJSVICMR

TEVEQIXIVSJXLMWTVSGIHYVIMW
WIRXEWRYPPERHXLITVSGIHYVI
[MPPYWIXLIHIJEYPXZEPYISJ
2YPPXSWIXXLIPMRIWFIJSVICMR
ZEPYI
;LIRYRGLIGOIHXLI
40:XVGRSHMWTPE]QSHIMWWIX

9WI7XEGO

;LIRGLIGOIHXLI
40:XVGYWIWXEGOMWWIX
;LIRYRGLIGOIHXLI
40:XVGRSYWIWXEGOMWWIX

Chapter 6

Working with PL/SQL code

Tab / Category

Setting

263

Result

*SV40:\QR 8VEGI(IFYK
)ZEPYEXI*EGMPMX] 

;LIRGLIGOIHXLI
40:\QRHSWEZIMWWIX

%YXS'SQQMX

(MWTPE]

;LIRYRGLIGOIHXLI
40:\QRRSHSWEZIMWWIX
;LIRGLIGOIHXLI
40:\QRHMWTPE]MWWIX
;LIRYRGLIGOIHXLI
40:\QRRSHMWTPE]MWWIX

-KRSVI'EWI

;LIRGLIGOIHXLI
40:\QRMKRSVIGEWIMWWIX
;LIRYRGLIGOIHXLI
40:\QRRSMKRSVIGEWIMWWIX

6SPPSZIV

;LIRGLIGOIHXLI
40:\QRVSPPSZIVMWWIX
;LIRYRGLIGOIHXLI
40:\QRRSVSPPSZIVMWWIX
2SXIFSXLXLIDTVSGIWW

TEVEQIXIVERHXLIDVSPPSZIVCMR

TEVEQIXIVWEVIWIXEW2YPP

Data Conversion

*SV40:&SSPIER &SSPIER 

8VYI8VERWMXMSRZEPYI

(MWTPE]WXLIZEPYIVIXYVRIHF]
XLITPZFSSPXZEPJYRGXMSRERH
GLERKMRKXLMWWXVMRKYWIWXLI
TPZFSSPWIXXTVSGIHYVIXSWIX
XLIIRXIVIHZEPYI

4IVXEMRWXSXLI40:&SSPIER
ERH40:(EXI4EGOEKIW

264

Tab / Category

SQL Navigator Users Guide

Setting

Result

*EPWI8VERWMXMSRZEPYI

(MWTPE]WXLIZEPYIVIXYVRIHF]
XLITPZFSSPJZEPJYRGXMSRERH
GLERKMRKXLMWWXVMRKYWIWXLI
TPZFSSPWIXXTVSGIHYVIXSWIX
XLIIRXIVIHZEPYI

29008VERWMXMSRZEPYI

(MWTPE]WXLIZEPYIVIXYVRIHF]
XLITPZFSSPRZEPJYRGXMSRERH
GLERKMRKXLMWWXVMRKYWIWXLI
TPZFSSPWIXRTVSGIHYVIXSWIX
XLIIRXIVIHZEPYI

*SV40:(EXI (EXI 

9WI66

;LIRGLIGOIHXLI
40:HEXIYWI66MWWIX
;LIRYRGLIGOIHXLI
40:HEXIRSYWI66MWWIX

(IJEYPX(EXI*SVQEX

(MWTPE]WXLIZEPYIVIXYVRIHF]
XLITPZHEXIHIJJQXJYRGXMSR
'LERKMRKXLMWWXVMRKYWIWXLI
TPZHEXIWIXHIJJQXTVSGIHYVIXS
WIXXLIIRXIVIHZEPYI

Transaction Management

)REFPI

;LIRGLIGOIHXLI
40:GQXXYVRCSRMWWIX

4IVXEMRWXSXLI40:GQXERH
40:VF4EGOEKIW
*SV40:GQX 'SQQMX 

;LIRYRGLIGOIHXLI
40:GQXXYVRCSJJMWWIX


8VEGMRK

;LIRGLIGOIHXLI40:GQXXVG
MWWIX
;LIRYRGLIGOIHXLI
40:GQXRSXVGMWWIX

Chapter 6

Working with PL/SQL code

Tab / Category


Setting
0SKKMRK

265

Result
;LIRGLIGOIHXLI40:GQXPSK
MWWIX
;LIRYRGLIGOIHXLI
40:GQXRSPSKMWWIX

'SQQMX'SYRXIV

&S\HMWTPE]WVIXYVRZEPYIJVSQ
XLI40:GQXRYQGSQQMXW
JYRGXMSR
8LI-RMXFYXXSRVIWIXWGSYRXIV
FEGOXS^IVSERHVIWIXWPMFVEV]
ZEPYIZMEXLI
40:GQXMRMXCRYQ'SQQMXW
TVSGIHYVI
2SXI7IXXMRKXLIZEPYIMRXLI
FS\F]LERHLEWRSIJJIGXSR
XLIPMFVEV]'PMGOMRMXFYXXSRXS
VIMRMXMEPMWIGSYRXIV

*SV40:VF 6SPPFEGO 

)REFPI

;LIRGLIGOIHXLI
40:VFXYVRCSRMWWIX
;LIRYRGLIGOIHXLI
40:VFXYVRCSJJMWWIX

8VEGMRK

;LIRGLIGOIHXLI40:VFXVGMW
WIX
;LIRYRGLIGOIHXLI
40:VFRSXVGMWWIX

0SKKMRK

;LIRGLIGOIHXLI40:VFPSKMW
WIX
;LIRYRGLIGOIHXLI
40:VFRSPSKMWWIX

File I/O

7LS[0MRI2YQFIVW

;LIRGLIGOIHXLI
40:JMPIWLS[PMRIRYQWMWWIX

4IVXEMRWXSXLI40:JMPI4EGOEKI

;LIRYRGLIGOIHXLI
40:JMPIRSWLS[PMRIRYQWMWWIX

266

Tab / Category


SQL Navigator Users Guide

Setting
0SKKMRK

Result
;LIRGLIGOIHXLI40:JMPIPSK
MWWIX
;LIRYRGLIGOIHXLI
40:JMPIRSPSKMWWIX

8VEGMRK

;LIRGLIGOIHXLI40:JMPIXVG
MWWIX
;LIRYRGLIGOIHXLI
40:JMPIRSXVGMWWIX

1IVKI'LEVEGXIV

(MWTPE]WXLIZEPYIVIXYVRIHF]
XLITPZJMPIQIVKIGLEV
JYRGXMSR'LERKMRKXLMWWXVMRK
YWIWXLITPZJMPIWIXCQIVKIGLEV
TVSGIHYVIXSWIXXLIIRXIVIH
ZEPYI

(IPMQMXIV

(MWTPE]WXLIZEPYIVIXYVRIHF]
XLITPZJMPIHIPMQJYRGXMSR
'LERKMRKXLMWWXVMRKYWIWXLI
TPZJMPIWIXCHIPMQTVSGIHYVIXS
WIXXLIIRXIVIHZEPYI

(IJEYPX(MVIGXSV]

(MWTPE]WXLIZEPYIVIXYVRIHF]
XLITPZJMPIHMVJYRGXMSR
'LERKMRKXLMWWXVMRKYWIWXLI
TPZJMPIWIXCHMVTVSGIHYVIXSWIX
XLIIRXIVIHZEPYI

Knowledge Xpert
7502EZMKEXSVYWIVWGERRS[EGGIWWXIGLRMGEPXSTMGWIVVSVQIWWEKIW
TVIFYMPXERHXIWXIHGSHIWSPYXMSRWERHGSHIJSVQEXXMRKXIGLRSPSK]9WMRKXLI
'SHI%WWMWXERX]SYGERHVEKERHHVSTXLIWISTXMQM^IHVSYXMRIWHMVIGXP]MRXS
]SYVTVSKVEQIHMXSV
/RS[PIHKI<TIVXEVIEZEMPEFPIEWSTXMSREPEHHSRQSHYPIWERHEZEMPEFPI
HMVIGXP]JVSQ]SYV5YIWX7SJX[EVIVITVIWIRXEXMZI
'SHI%WWMWXERXKMZIW]SYUYMGOEGGIWWXSER]/RS[PIHKI<TIVXORS[PIHKI
FEWIWXLEX]SYLEZIMRWXEPPIH
*SVI\EQTPI

Chapter 6

Working with PL/SQL code

267

/RS[PIHKI<TIVXJSV3VEGPI%HQMRMWXVEXMSR%GSQTPIXIERHIWWIRXMEP
VIWSYVGIJSV3VEGPI(&%W
/RS[PIHKI<TIVXJSV%GXMZI40750'SQTVILIRWMZI40750ORS[PIHKI
GSQFMRIH[MXLERI\XIRWMZI40750GSHIPMFVEV]

Database Source Code Search


8LIHEXEFEWIWSYVGIGSHIWIEVGLYXMPMX]EPPS[W]SYXSWIEVGLJSVEGLEVEGXIV
WXVMRKMRXLIWSYVGIGSHISJEPPWXSVIHTVSKVEQWXVMKKIVWERHZMI[W=SYGER
YWIXLMWYXMPMX]XSTIVJSVQEUYMGO[LIVIYWIHMQTEGXEREP]WMW 

To search source code


1

*VSQXLI7IEVGLQIRYGLSSWI'SHI7IEVGL

)RXIVXLIWIEVGLWXVMRK

7IPIGXSTXMSRW
You can specify the search string, schema name,
and object name using wildcard characters "%"
and "_" (according to SQL LIKE operator
definitions).

'PMGO7IEVGL

To view information about the objects found


 6MKLXGPMGOSREVS[MRXLIVIWYPXWWIXXSWII(IWGVMFIMRJSVQEXMSRERH
SXLIVSTXMSRWJSV[SVOMRK[MXLXLISFNIGX

To open an object displayed in the results table


 (SYFPIGPMGOSREVS[MRXLIVIWYPXWWIX
7502EZMKEXSVSTIRWXLISFNIGXMRXLIGSVVIWTSRHMRKSFNIGXIHMXSVERHTPEGIW
XLIXI\XGYVWSVEXXLIPMRIGSRXEMRMRKXLIWIEVGLWXVMRK

To add a code location shortcut to a workspace


 (VEKXLIWIPIGXMSRJVSQXLIVIWYPXPMWXMRXLI7IEVGL7SYVGI'SHI[MRHS[
XSXLI;SVOWTEGI

268

SQL Navigator Users Guide

Writing and editing stored programs


Creating a new stored program
;LIR]SYGVIEXIERI[WXSVIHTVSKVEQ]SYWTIGMJ]XLIX]TISJSFNIGX]SY
[ERXXSGVIEXI
4VSGIHYVI
*YRGXMSR
4EGOEKI
4EGOEKI&SH]
 3FNIGX 8]TI
 3FNIGX 8]TI&SH]
7502EZMKEXSVTVSZMHIWEWITEVEXIIHMXSVJSVHEXEFEWIXVMKKIVW 
*SVIEGLSJXLIWI40750GSRWXVYGXW7502EZMKEXSVTVSZMHIWEVIEH]QEHI
XIQTPEXISVWLIPPXSQEOI]SYVGSHMRKIEWMIV
=SYGERQSHMJ]XLIWIXIQTPEXIW0SSOJSVXLIMVREQIWERHPSGEXMSRWMRXLI
STIRMRKGSQQIRXW[LIRXLIRI[SFNIGXMWGVIEXIH

To create a new stored program


1

-RXLI:MI[QIRYGLSSWI:MWYEP3FNIGX)HMXSV 7XSVIH4VSKVEQ)HMXSV

2
3

-RXLI7XSVIH4VSKVEQ)HMXSVXSSPFEVGPMGO
 XLI'VIEXI2I[7XSVIH
4VSKVEQFYXXSR 
-RXLI2I[7XSVIH4VSKVEQHMEPSKIRXIVEREQIJSVXLIRI[TVSKVEQ

4
5

7TIGMJ]XLIX]TISJWXSVIHTVSKVEQ]SY[ERXXSGVIEXIERHXLIRGPMGO3/
8]TISVMRWIVXXLI40750GSHIMRXLIIHMXMRK[MRHS[

8SGSQTMPIERHWEZIXLIWXSVIHTVSKVEQGPMGO
XLIWLSVXGYXQIRY

SVGLSSWI7EZIJVSQ

Modifying a stored program


=SYGERSTIRWXSVIHTVSKVEQWMRGPYHMRKTVSGIHYVIWTEGOEKIWJYRGXMSRW
ERHSFNIGXX]TIWJSVIHMXMRKJVSQEPQSWXER][LIVIMR7502EZMKEXSV

Chapter 6

Working with PL/SQL code

269

To open a stored program for editing


1

*MVWXHSYFPIGPMGOXLITVSKVEQ]SY[ERXXSIHMXMRXLI(&2EZMKEXSVSV
YWIER]SXLIVGSRZIRMIRXQIXLSHSJSTIRMRKEWGLIQESFNIGXGPMGOLIVI
JSVLMRXW
1EOI]SYVGLERKIWERHGLSSWI7EZIJVSQXLIWLSVXGYXQIRY

To insert a saved text file into the Stored Program Editor


1
2
3

3TIRXLI7XSVIH4VSKVEQ)HMXSVERHTPEGIXLIGYVWSV[LIVI]SY[ERXXLI
WEZIHXI\XJMPIXSFIMRWIVXIH
*VSQXLI)HMXQIRYGLSSWI-RWIVXERHXLIR*MPI %PXIVREXMZIP]]SYGER
TVIWW'XVP8 
4SMRXXSXLIJMPI]SY[ERXXSMRWIVXERHXLIRGPMGO3/

To modify stored programs


Be cautious when modifying stored programs in a
production database. Saving a program applies
the changes to the stored program on the server.
If there are compiler errors in the program code,
Oracle invalidates the program on the server.

2
3

'PMGO
XSGLSSWIETVSKVEQJVSQXLI7IPIGX(&3FNIGXHMEPSK

3V

(SYFPIGPMGOXLITVSKVEQ
WMGSRMRXLI(&2EZMKEXSV[MRHS[
1SHMJ]XLITVSKVEQEWRIIHIH
8SWYFQMXXLIGLERKIWXSXLIHEXEFEWIGPMGO
WLSVXGYXQIRY

SVGLSSWI7EZIJVSQXLI

Faster development using the Code Explorer


8LI7XSVIH4VSKVEQ)HMXSV[LMGL]SYYWIXSIHMX40750ERHSXLIVTVSKVEQ
GSHIMRGPYHIWE'SHI)\TPSVIVXSSPXLEXLIPTWQEOI]SYV[SVO[MXL
TEGOEKIWTVSGIHYVIWERHJYRGXMSRWQSVIIJJMGMIRXERHIVVSVJVII
8LI'SHI)\TPSVIV
 MWFEWIHSREREHZERGIHTEVWMRKXIGLRMUYIXLEXYRHIVWXERHW40750
W]RXE\
 HMWTPE]WHIXEMPIHMRJSVQEXMSREFSYXETEGOEKI
WGSQTSRIRXWWYGLEW
ZEVMEFPIWERHTEVEQIXIVWXLIMVX]TIWWXVYGXYVIERHGYVWSVW

270

SQL Navigator Users Guide









EYXSQEXMGEPP]LMKLPMKLXWXLITEGOEKIHTVSGIHYVI]SYEVIGYVVIRXP]MR
WYTTSVXWHVEKERHHVSTMRXSXLIIHMXSV
GSQFMRIWMRJSVQEXMSRJVSQXLIWTIGMJMGEXMSRERHFSH]
LMKLPMKLXWW]RXE\
HMWXMRKYMWLIWRSRTYFPMWLIHTVSGIHYVIWERHJYRGXMSRW[MXLEHMJJIVIRXMGSR
ZMWYEPP]QEVOWTVSGIHYVIWMRWMHIETEGOEKIXLEXGSRXEMRW]RXE\IVVSVW
PIXW]SYUYMGOP]NYQTFIX[IIRXLIMQTPIQIRXEXMSRERHHIGPEVEXMSRSJXLI
GYVVIRXTVSGIHYVIMRETEGOEKI 'XVP7LMJXYTEVVS[ERH'XVP7LMJXHS[R
EVVS[ 
 PIXW]SYUYMGOP]NYQTFIX[IIRXLIFIX[IIRXLIWTIGMJMGEXMSRERHXLIFSH]
%PX* 
8LI'SHI)\TPSVIVMGSRSRXLI7XSVIH4VSKVEQ)HMXSVXSSPFEVMWWLS[REXPIJX
'SHI)\TPSVIVXSSPMRXLI7XSVIH4VSKVEQ)HMXSV

Displaying the Code Explorer


;LIRIZIV]SY[ERXXSWIIELMIVEVGLMGEPZMI[SJEGSQTPI\GSHIPMWXMRKMRXLI
7XSVIH4VSKVEQ)HMXSVHMWTPE]XLI'SHI)\TPSVIV

To display the Code Explorer


 3RXLI7XSVIH4VSKVEQ)HMXSVXSSPFEVGPMGOXLI7LS[,MHIXLI'SHI
)\TPSVIVMGSR
 SV

Chapter 6

Working with PL/SQL code

271

6MKLXGPMGOMRXLI7XSVIH4VSKVEQ)HMXSV[MRHS[ERHXLIRGLSSWI'SHI
)\TPSVIV

Rapidly locating source code segments


-RXLI'SHI)\TPSVIVMWIEW]XSUYMGOP]PSGEXIXLIWSYVGIGSHIJSVETVSGIHYVI
SVJYRGXMSRERHWIXXLIXI\XGYVWSVSRMX

To quickly move the cursor to a procedure or function


 (SYFPIGPMGOXLITVSGIHYVISVJYRGXMSRREQIMRXLI'SHI)\TPSVIVXVII
ZMI[*SVEOI]FSEVHWLSVXGYXWIPIGXXLITVSGIHYVISVJYRGXMSRREQIERH
XLIRTVIWW)RXIV

Begin/End markers for loops and blocks


;LIR]SYTPEGIXLIGYVWSVMRWMHIE0334SVE&)+-2)2(FPSGOXLIIHMXSV
WLS[W]SYXLIFIKMRERHIRHTSMRXWF]QIERWSJQEVOIVWMRXLIPIJXQEVKMREW
WLS[RFIPS[



272

SQL Navigator Users Guide

Using bookmarks in source code


9WIEFSSOQEVOXSGSRZIRMIRXP]QEVOZEVMSYWPSGEXMSRWMRXLIWSYVGIGSHIERH
UYMGOP]QSZIEFSYXMRXLIXI\X[MXLSYXWIEVGLMRKXLVSYKLXLIGSHIERH
[MXLSYXPSWMRK]SYVGYVVIRXIHMXMRKPSGEXMSR=SYGERWIXYTXSXIRFSSOQEVOW
*SVI\EQTPI]SYGSYPHTPEGIFSSOQEVORYQFIVMRXLI()'0%6)WIGXMSR
ERHFSSOQEVORYQFIVEX]SYVGYVVIRXIHMXMRKPSGEXMSR8LIRXSUYMGOP]KS
XSXLI()'0%6)WIGXMSR]SY[SYPHTVIWW'XVP%JXIVPSSOMRKEX]SYV
ZEVMEFPISVGYVWSVHIGPEVEXMSRW]SY[SYPHVIXYVRXS]SYVIHMXMRKPSGEXMSRF]
TVIWWMRK'XVP
8SWIXEFSSOQEVOSVXSKSXSEFSSOQEVOXLEX]SYTVIZMSYWP]WIX]SYGER
YWIIMXLIVOI]FSEVHWLSVXGYXWSVWLSVXGYXQIRYW

To set a bookmark using a shortcut menu


1

6MKLXGPMGOMRXLI[MRHS[GSRXEMRMRKXLIWSYVGIGSHI

2
3

*VSQXLI)HMXQIRYWIPIGX8SKKPIFSSOQEVOW
*VSQXLIHVSTHS[RPMWXWIPIGXEFSSOQEVORYQFIVJVSQXS

To set a bookmark using a keyboard shortcut


 4VIWW'XVP7LMJX QEVOIVFSSOQEVORYQFIV"*SVI\EQTPIXSWIXQEVOIV
FSSOQEVORYQFIVTVIWW'XVP7LMJX

To list bookmarks
 *VSQXLI)HMXQIRYWIPIGX0MWX&SSOQEVOW

To go to a bookmark using a shortcut menu


1

6MKLXGPMGOMRXLI[MRHS[GSRXEMRMRKXLIWSYVGIGSHI

2
3

*VSQXLIWLSVXGYXQIRYWIPIGX+SXSFSSOQEVOW
*VSQXLIHVSTHS[RPMWXWIPIGXEFSSOQEVORYQFIVJVSQXS

To go to a bookmark using a keyboard shortcut


 4VIWW'XVP QEVOIVFSSOQEVORYQFIV"*SVI\EQTPIXSVIEGLQEVOIV
FSSOQEVORYQFIVTVIWW'XVP

Programmable keys for PL/SQL code


=SYGERWEZIXMQIF]YWMRKTVSKVEQQEFPIOI]WERHLSXOI]WJSVJVIUYIRXP]
YWIH40750GSHIMRGPYHMRKQYPXMPMRIWIKQIRXW 
3RXLI7502EZMKEXSV,IPTQIRYGPMGO7LSVXGYX *YRGXMSROI]W

Chapter 6

Working with PL/SQL code

273

Compiling a stored program


=SYGERGSQTMPIETVSKVEQXLEXMWWXSVIHMRXLIHEXEFEWI-J]SYEVIIHMXMRK
XLITVSKVEQMRXLIIHMXMRK[MRHS[]SYGERYWIXLI7EZIGSQQERHXSGSQTMPI
ERHWXSVIMX
8LI3YXTYX[MRHS[HMWTPE]WXLIWXEXYWSJXLIGSQTMPISTIVEXMSRMRGPYHMRK
RSXMJMGEXMSRSJER]IVVSVW

To compile a stored program from the Stored Program Editor


 *VSQXLI3FNIGXQIRYGLSSWI'SQTMPI

Customizing color highlighting for PL/SQL and SQL


keywords
'YWXSQM^IHGSPSVWIPIGXMSRJSV40750ERH750OI][SVHWXI\XERHGSQQIRXW
QEOIWGSHIQSVIVIEHEFPI 

Converting HTML into a PL/SQL stored procedure


8LI,810-QTSVXGETEFMPMX]PIXW]SYIEWMP]GSRZIVXER,810JMPIMRXSE
40750WXSVIHTVSGIHYVI8LIWXSVIHTVSGIHYVI[MPPMRXYVRSYXTYXXLI,810
GSHIZMEXLI3VEGPI;IF'EVXVMHKI 

Correcting syntax errors


;LIR]SYWEZIETVSKVEQXLEXGSRXEMRWW]RXE\IVVSVWXLIWXEXYWTERISJXLI
IHMXMRK[MRHS[HMWTPE]WIVVSVQIWWEKIW=SYGEREYXSQEXMGEPP]LMKLPMKLXXLI
GSHIWIKQIRXXLEXMWGEYWMRKEKMZIRIVVSVQIWWEKI8LMWQEOIWMXIEW]XS
PSGEXIERHGSVVIGXIVVSVW
=SYGEREPWSZMI[XLIJYPP3VEGPIIVVSVQIWWEKIERHWSPYXMSR

274

SQL Navigator Users Guide

To highlight the line containing an error


 -RXLIWXEXYWTERISJXLIIHMXMRK[MRHS[HSYFPIGPMGOXLIIVVSVQIWWEKI

Drag-and-drop PL/SQL editing


=SYGERWEZIERHVIYWIGSHIERHHVEK40750W]RXE\750JYRGXMSRWGSPYQR
REQIWERHHEXEFEWISFNIGXREQIWMRXS]SYVGSHI8LI'SHI%WWMWXERX
TVSZMHIWIEW]EGGIWWXSGSHIWRMTTIXWHVEKERHHVSTW]RXE\ERHXLI40:MWMSR
GEXEPSKW

Correcting typing errors


=SYGERGSVVIGXIVVSVWIEWMP][MXLZMVXYEPP]YRPMQMXIHPIZIPWSJ9RHSERH6IHS
JYRGXMSRW

Testing program code with debug statements


=SYGERMRGPYHI(&17C398498498C0-2)HIFYKKMRKWXEXIQIRXWMR]SYV
WXSVIHTVSKVEQGSHIERHZMI[XLISYXTYXMRXLI3YXTYX[MRHS[%RYQFIVSJ
XMQIWEZMRKWLSVXGYXWJSVTPEGMRK(&17C398498WXEXIQIRXWMR]SYVTVSKVEQ
EVIMRGPYHIH 
*SVQSVIMRJSVQEXMSRWII(IFYKKMRKWXSVIHTVSKVEQW

Chapter 6

Working with PL/SQL code

275

Executing stored programs


Executing stored programs
=SYGERI\IGYXIZEPMHWXSVIHTVSKVEQWMRGPYHMRKTVSGIHYVIWTEGOEKIW
JYRGXMSRWERHSFNIGXX]TIWJVSQEPQSWXER][LIVIMR7502EZMKEXSV
If you have the PL/SQL Debugger, you can set
breakpoints and watch variables before execution
in Debug mode.

;LIR]SYI\IGYXIEWXSVIHTVSKVEQ7502EZMKEXSVWXEVXWXLI)\IGYXMSR
'SHI[M^EVH[LMGLEPPS[W]SYXSWIXTEVEQIXIVWJSV[VETTMRKERERSR]QSYW
FPSGOEVSYRHXLIWXSVIHTVSKVEQ
-J]SY[ERXXSZMI['03&&03&ERH&*-0)EVKYQIRXWMRXLISYXTYXSV
3FNIGXERH'SPPIGXMSR8]TIWYWIFMRHZEVMEFPIW
8LI3YXTYX[MRHS[HMWTPE]WXLII\IGYXMSRWXEXYW
-J]SYEXXIQTXXSVYRERMRZEPMHSFNIGXEQIWWEKIMRXLI3YXTYX[MRHS[
EHZMWIW]SYXLEXXLIMRZEPMHSFNIGXGERRSXFIVYR

To execute a stored program


*MRHXLIWXSVIHTVSKVEQERHXLIRYWISRISJXLIJSPPS[MRKQIXLSHW
 7IPIGXXLIWXSVIHTVSKVEQERHXLIRGPMGOXLI
FYXXSRMRXLI7IWWMSR
XSSPFEV
 7IPIGXXLIWXSVIHTVSKVEQERHXLIRJVSQXLI7IWWMSRQIRYGLSSWI6YR
 7IPIGXXLIWXSVIHTVSKVEQERHXLIRTVIWW*
 -RXLI(&2EZMKEXSVVMKLXGPMGOXLIWXSVIHTVSKVEQERHXLIRGLSSWI
)\IGYXI
 -RXLI750)HMXSVVYRERERSR]QSYW40750FPSGO

Creating anonymous blocks


8LI)\IGYXMSR'SHI;M^EVHEWWMWXW]SYMRGVIEXMRKERSR]QSYW40750FPSGOW
XLEXGEPPWXSVIHTVSKVEQW 8LI)\IGYXMSR'SHI;M^EVHHSIWRSXWYTTSVX
XVMKKIVW 
-J]SYKIRIVEXIERERSR]QSYWFPSGOXLI;M^EVHEWWMKRWEJMPIREQIXS]SYV
FPSGOMRXLIJSPPS[MRKJSVQ

276

SQL Navigator Users Guide

<Schema name>.<procedure name>.STB


-JXLIERSR]QSYWFPSGOMWJSVETEGOEKIHTVSGIHYVIXLIRXLIEWWMKRIHREQI
LEWEREHHMXMSREPGSQTSRIRXXLIIRXV]TSMRX
8LI;M^EVHPSSOWJSVERI\MWXMRKI\IGYXMSRGSHIFPSGO[LIRIZIV]SYVYRE
WXSVIHTVSKVEQ
-JERIVVSVSGGYVW[LIRXV]MRKXSVYREKIRIVEXIHGSHIFPSGO JSVI\EQTPIHYI
XSEW]RXE\IVVSV XLIXI\XMWSTIRIHMRXLI750)HMXSV

To generate an execution code block


1

3TIREWXSVIHTVSKVEQMRXLI7XSVIH4VSKVEQ)HMXSV

6YRXLIWXSVIHTVSKVEQF]GPMGOMRK
SVGLSSWMRK6YRJVSQXLI
7IWWMSRQIRY
-JXLI6IYWISV'VIEXI'EPPMRK'SHI#HMEPSKETTIEVWMRHMGEXI]SYV
TVIJIVIRGI
-J]SYEVIGVIEXMRKERI[GSHIFPSGOWTIGMJ]MRXLI4VSJMPMRK(IXEMPWHMEPSK
[LIXLIV]SY[ERXXSMRGPYHIETVSJMPMRKVYRERHMJWSWIPIGXXLI4VSJMPMRK
HIXEMPW HIWGVMFIHFIPS[ 
-J]SYEVIGVIEXMRKERI[GSHIFPSGOYWIXLI7IX3TXMSRWHMEPSKXSWIX
TVIJIVIRGIW HIWGVMFIHFIPS[ JSVXLIGSHIFPSGO
4VIZMI[XLIKIRIVEXIHI\IGYXMSRGSHIFPSGOERHIMXLIVWYFQMXMXJSV
I\IGYXMSRSVSTIRMXMRXLI750)HMXSV

3
4

5
6

Profiling Details dialog options


Option

Description

)REFPI4VSJMPMRK

7IPIGXXLMWSTXMSRXSYWIXLI40750
4VSJMPIVJSVEREP]WMWERHXYRMRK

'SPPIGX7IWWMSR7XEXMWXMGW[LIR
'VIEXMRKXLI4VSJMPMRK6YR

;LIRWIPIGXIHWIWWMSRWXEXMWXMGWEVI
WXSVIHMREXEFPI

&IJSVI'VIEXMRKXLI4VSJMPMRK6YR|

;LIRYWMRKXLI4VSJMPIVJSV
TIVJSVQERGIQIEWYVIQIRXERH
XYRMRKWIPIGXMRKXLIWISTXMSRW[MPP
VIMRMXMEPM^IXLII\IGYXMSR
IRZMVSRQIRXEJXIVETVIZMSYWVYR
KMZMRK]SYEFIXXIVFEWMWJSV
GSQTEVMWSRFIX[IIRSRIVYRERH
ERSXLIV

Chapter 6

Working with PL/SQL code

277

Set Options dialog options


Option
9WIFMRHZEVMEFPIWXSTEWWEVKYQIRXW
XSZMI[VIWYPXWMREKVMH 

Description
;LIRWIPIGXIHIREFPIWTEWWMRKSJ
TEVEQIXIVWZMEFMRHZEVMEFPIW8LMW
QIERW]SYGERZMI[XLIZEPYIWSJ
398TEVEQIXIVWSJX]TIWWYGLEW
6)*'96736ERH'03&MRE
VIWYPXWKVMH
8LMWSTXMSRGERRSXFIYWIH[LIR
40750(IFYKKMRKMW3R HYIXS
3VEGPIPMQMXEXMSRW 

,S[HS]SY[ERX398TEVEQIXIVW
XSFILERHPIH#

398TEVEQIXIVWGERFIHMVIGXIHXS
(&17C398498498C0-2)
WXEXIQIRXWKIRIVEXIHTIVTEVEQIXIV
ERHHMWTPE]IHMRXLI3YXTYX[MRHS[
EJXIVI\IGYXMSR
8LMWSTXMSRMWQYXYEPP]I\GPYWMZI
[MXLXLI9WI&MRH:EVMEFPIWSTXMSR
EFSZI

(S]SY[ERXGLERKIWXSFI
GSQQMXXIH#

'SRXVSPW[LIXLIVXLI)\IGYXMSR
;M^EVHWLSYPHEHHE'311-8SV
6300&%'/WXEXIQIRXEXXLIIRHSJ
XLIERSR]QSYWFPSGO8LMWSTXMSRMW
YWIJYP[LIRXLITVSKVEQXSFIVYR
MWWYIW(10GSQQERHW -27)68
94(%8)()0)8) 

278

SQL Navigator Users Guide

Viewing results in the Output window


8LI3YXTYX[MRHS[HMWTPE]WXLIVIWYPXWSJTVSKVEQGSQTMPEXMSRERH
I\IGYXMSRMRGPYHMRKER]IVVSVW
-J]SYEXXIQTXXSVYRERMRZEPMHSFNIGXEQIWWEKIMRXLI3YXTYX[MRHS[
EHZMWIW]SYXLEXXLIMRZEPMHSFNIGXGERRSXFIVYR 

The Output window showing compile results with errors

Chapter 6

Working with PL/SQL code

279

Viewing an Oracle error description and solution


=SYGERZMI[EJYPP]I\TERHIH3VEGPIIVVSVHIWGVMTXMSRJSVER]IVVSVGSHI
HMWTPE]IHMRXLI3YXTYX[MRHS[
8LIVIWYPXMRKHMEPSKGSRXEMRWXLIIVVSVQIWWEKIHIWGVMTXMSRGEYWIERH
VIGSQQIRHIHEGXMSRWNYWXEWXLI]ETTIEVMR3VEGPIHSGYQIRXEXMSR

To view an Oracle error description


 -RXLI3YXTYX[MRHS[HSYFPIGPMGOSRXLIIVVSVGSHI]SY[ERXXSORS[
EFSYX
Editing window, Output window, and Oracle Error Information window

Stepping though stored programs


*PI\MFPI750IHMXMRKERHTVSGIWWMRKEPPS[WYWIVWXSWMRKPIWXITXLVSYKLGSHI
WOMTVI[MRHERHSXLIVIHMXMRKJYRGXMSRW

Running stored programs in Debug mode


9WMRKXLI(IFYK1SHI]SYGER[EXGLXLIVIWYPXZEPYIWHYVMRKVYRXMQI=SY
GERVYRWXSVIHTVSKVEQWMRTEVEPPIPF]STIRMRKEHHMXMSREPWIWWMSRW[MXLMR750
2EZMKEXSV9WMRK3VEGPIVYRERHHIFYKTVSGIHYVIW[MXLTEVEQIXIVWSJX]TI
407506)'36( 

280

SQL Navigator Users Guide

Optimizing stored programs: The PL/SQL Profiler


Optimizing stored programs with the
Profiler/Coverage tool
=SYGERYWIXLIMRXIKVEXIH'SZIVEKI4VSJMPMRKXSSPXSEREP]^IXLII\IGYXMSR
XMQIERHIJJMGMIRG]SJ]SYVWXSVIHTVSKVEQW 8LI4VSJMPIVMWEZEMPEFPIJSVYWI
[MXL3VEGPISVLMKLIV 

You can launch the Profiler from the Tools menu or the
Functions toolbar


8LI407504VSJMPIVTVSZMHIWIEW]XSYWITVSJMPMRKMRGPYHMRKI\IGYXMSRXMQI
WXEXMWXMGWERHGSZIVEKIEREP]WMWJSV40750HIZIPSTIVW9RPMOIXLITVSJMPMRK
YXMPMXMIWTVSZMHIH[MXL3VEGPIERHPEXIVXLI407504VSJMPIVXSSPMW
KVETLMGEPERHEPPS[WIEW]REZMKEXMSRERHHVMPPHS[RXLVSYKLXLIHEXE8LI
4VSJMPIVMWTEVXMGYPEVP]YWIJYPJSV
 JMRHMRKFSXXPIRIGOWMRWXSVIHGSHI
 UYEPMX]EWWYVERGIERHXIWXMRK
8LI4VSJMPIV[MPPWLS[]SYEPMRIF]PMRIEREP]WMWSJXLII\IGYXMSRMRGPYHMRK
XLIRYQFIVSJXMQIWIEGLPMRI[EWI\IGYXIHERHXLIXMQIVIUYMVIHJSV
I\IGYXMSR
=SYGERYWIXLI4VSJMPIVSRER]40750MRGPYHMRKWXSVIHTVSGIHYVIW
JYRGXMSRW FSXLWXERHEPSRIERHEWTEVXSJETEGOEKI XVMKKIVWX]TIQIXLSHW
ERHERSR]QSYWFPSGOW
8LI4VSJMPIV
 WXSVIWHEXEEFSYXIEGLGSHIYRMXI\IGYXIHHYVMRKEVYRHS[RXSXLIPIZIP
SJWSYVGIGSHIPMRIW
 HMZMHIWEPPXLIEZEMPEFPITVSJMPMRKHEXEMRXSLMIVEVGLMGEPP]SVKERM^IHPSKMGEP
MXIQW
 HMWTPE]WTVSJMPMRKERHGSZIVEKIWXEXMWXMGWEFSYXIEGLMXIQERHGSQTEVIW
XLIQ[MXLSXLIVW

Chapter 6

Working with PL/SQL code

281

8LI4VSJMPIVHMWTPE]WXLITVSJMPMRKHEXEEPSRKWMHIXLIEGXYEPWSYVGIGSHI 8LMW
JIEXYVIMWRSXEZEMPEFPIMJXLIWSYVGIGSHILEWGLERKIHWMRGIMX[EWPEWXXIWXIHMR
XLIGYVVIRXP]WIPIGXIHVYRSVMJMXMWRSXMHIRXMGEPEGVSWWXLIVYRWMREKVSYT 
=SYGERWSVXERHJMPXIVXLIVIWYPXHEXEEGGSVHMRKXSXLVIWLSPHWXLEX]SYGERWIX
8LMWQEOIWMXIEW]XSPMQMXXLIEQSYRXSJHEXEHMWTPE]IHSVXSMWSPEXIXLIQSWX
WMKRMJMGERXMXIQW*SVI\EQTPI]SYGERWIPIGXPMRIWXLEX[IVIRSXGEPPIHHYVMRK
XLIVYRSVVYRW[MXLXSXEPXMQIWLMKLIVXLEREZIVEKI*SVIEGLKVSYT]SYLEZI
XLISTXMSRSJHMWTPE]MRKXLIHEXEIMXLIVWITEVEXIP]F]VYRSV[MXLVYRW
GSQFMRIH

To open the Profiler


8SMRZSOIXLI407504VSJMPIVGLSSWISRISJXLIJSPPS[MRK
 'PMGOXLI4VSJMPIVMGSRSRXLIQEMRXSSPFEVERHXLIRTSMRXXSXLIWXSVIH
GSHIYRMX]SY[ERXXSSTXMQM^I
XLI4VSJMPIVMGSR
 *VSQXLI8SSPWQIRYGLSSWI407504VSJMPIVERHXLIRTSMRXXSXLI
WXSVIHTVSKVEQ]SY[ERXXSSTXMQM^I
 9WMRKIMXLIVXLI(&2EZMKEXSVXLI7XSVIH4VSKVEQ)HMXSVSVXLI7IEVGL 
*MRH3FNIGXW|HMEPSKJMVWXPSGEXIXLIWXSVIHGSHIYRMX]SY[ERXXSTVSJMPI
ERHXLIRI\IGYXIMX[MXLTVSJMPMRKIREFPIH 7IPIGX)REFPI4VSJMPMRKMRXLI
)\IGYXIHMEPSK 
Before using the Profiler, debug your stored
program, as there is no editing capability from
within the Profiler.

8LI407504VSJMPIVGSZIVEKIXSSPMWRS[QSVIXMKLXP]MRXIKVEXIHMRXSXLI
ETTPMGEXMSR
 =SYGEREGGIWWXLI0SGEXI3FNIGXMR(&2EZMKEXSVERH3TIRGSQQERHW
[LIREWXSVIHTVSKVEQMWWIPIGXIHMRXLI4VSJMPIV
W6YRWSV+VSYTWXVII
 =SYGERSTIRXLI7XSVIH4VSKVEQ)HMXSVERHNYQTXSEWIPIGXIHPMRISJ
WSYVGIGSHIF]HSYFPIGPMGOMRKMRXLI7SYVGI:MI[IV
 7GVSPPMRK QSZMRKXLIGYVWSVTSWMXMSR MRXLI7XSVIH4VSKVEQ)HMXSVWIPIGXW
XLIGSVVIWTSRHMRKPMRIMRXLITVSJMPIV7SYVGI:MI[IV
 8LIWIVZIVSYXTYXMWEYXSQEXMGEPP]VIXVMIZIHEJXIVXLIVYR
 7IWWMSRWXEXMWXMGWGERFIHMWTPE]IHSRXLIWYQQEV]TEKI[LIREVYRMW
WIPIGXIH
 8LI4VSJMPIVYWIWXLI3VEGPIWIWWMSRMX[EWEGXMZEXIHMR 4VIZMSYWP]MXYWIH
MXWS[RWIWWMSR 

282

SQL Navigator Users Guide

Viewing an open object in the DB Navigator


;LIREWXSVIHTVSKVEQMWWIPIGXIHMRXLI4VSJMPIV
W6YRWSV+VSYTWXVII]SY
GERYWIXLI0SGEXIMR(&2EZMKEXSVERH3TIRGSQQERHWXSNYQTXSXLI
PSGEXMSRSJXLISFNIGXMRXLI(&2EZMKEXSVXVII

Using the Locate in DB Navigator command

Chapter 6

Working with PL/SQL code

283

Result of the Locate in DB Navigator command

284

SQL Navigator Users Guide

Using the Profiler with the Stored Program editor


=SYGERSTIRXLI7XSVIH4VSKVEQ)HMXSVERHNYQTXSEWIPIGXIHPMRISJWSYVGI
GSHIF]HSYFPIGPMGOMRKMRXLI7SYVGI:MI[IV
7GVSPPMRK QSZMRKXLIGYVWSVTSWMXMSR MRXLI7XSVIH4VSKVEQ)HMXSVWIPIGXWXLI
GSVVIWTSRHMRKPMRIMRXLITVSJMPIV7SYVGI:MI[IV

Chapter 6

Working with PL/SQL code

285

PL/SQL Profiler quick-reference guide


8LIJSPPS[MRKMWEPMWXSJXLIEGXMSRW]SYGERTIVJSVQSRMXIQWMRXLIXVIIZMI[
Action

Node Type

Command

Shortcut

6IQSZIXLIVYRHEXE
TIVQERIRXP]

6YR

(IPIXI

(IP

'VIEXIERI[KVSYT
MRZSOIXLI+VSYT
4VSTIVXMIWHMEPSK 

%PP+VSYTW

'VIEXI

-RW

'VIEXIERI[KVSYT
MRZSOIXLI+VSYT
4VSTIVXMIWHMEPSK 

+VSYT

'VIEXI

-RW

-RZSOIXLI+VSYT
4VSTIVXMIWHMEPSKXS
QSHMJ]XLIGYVVIRXP]
WIPIGXIHKVSYT

+VSYT

4VSTIVXMIW

%PX*

4IVQERIRXP]VIQSZI
XLIKVSYT (SIWRSX
VIQSZIXLIEWWSGMEXIH
VYRHEXE 

+VSYT

(IPIXI

(IP

'VIEXIERI[6YRF]
TVSJMPMRKXLIWIPIGXIH
MXIQ

4VSGIHYVI
*YRGXMSR

4VSJMPI

%PX4

286

SQL Navigator Users Guide

8LIJSPPS[MRKEGXMSRWEVIMRHITIRHIRXSJXLIWIPIGXIHXVIIZMI[RSHI
Action

Command

Shortcut

9THEXIFSXLXVIIZMI[W[MXLXLIPEXIWX
TVSJMPMRKHEXE

6IJVIWL

%PX6

-RZSOIXLI*MPXIVW4VIJIVIRGIWHMEPSK

*MPXIVW
4VIJIVIRGIW

%PX*

-RZSOIXLI'LEVX4VMRX4VIZMI[
HMEPSKMJEGLEVXMWZMWMFPI

'LEVX4VMRX

%PX*

6IWIXSVMKMREPGLEVXFSYRHEVMIWMJE
GLEVXMWZMWMFPI

9RHS'LEVX
>SSQ

%PX9

PL/SQL Profiler: Basic concepts


Run
%VYRGSRXEMRWEPPGSHIYRMXWXLEXEVIGEPPIHHYVMRKI\IGYXMSR-JETVSGIHYVISV
JYRGXMSRMWETEVXSJETEGOEKIXLI[LSPITEGOEKIFIGSQIWTEVXSJXLIVYR
8LIWEQIVYPIETTPMIWXSX]TIQIXLSHW

Profiling data types


8LIVIEVIXLVIIKIRIVEPGEXIKSVMIWSJTVSJMPMRKHEXE+VSYT'SHIYRMX
)\IGYXEFPIPMRI

Group
=SYGVIEXIKVSYTWMRSVHIVXSPSKMGEPP]GSRRIGXGSHIYRMXWERHVYRW=SY
HIXIVQMRI[LMGLYRMXWERHVYRWFIPSRKXSEKVSYT=SYGERGSQFMRIHEXEJSVE
WMRKPIGSHIYRMXEGVSWWQYPXMTPIVYRWMRSVHIVXSHIXIVQMRIXLIVIEPGSZIVEKI
ERHI\IGYXMSRXMQIW8LMWMWYWIJYP[LIRXIWXMRKWXSVIHGSHIMRWIZIVEPHMJJIVIRX
VYRW[MXLHMJJIVIRXTEVEQIXIVW

Code Unit
%40750GSHIYRMXGERFIEWXERHEPSRITVSGIHYVISVJYRGXMSRETEGOEKI
FSH]EX]TIFSH]SVERERSR]QSYWFPSGO%TEGOEKIFSH]ERHX]TIFSH]
GSRXEMRWJYVXLIVTVSGIHYVIWERHJYRGXMSRW*SVETVSGIHYVISVJYRGXMSRMXMW
WSQIXMQIWTSWWMFPIXSHIXIVQMRILS[QER]XMQIWMXLEWFIIRGEPPIHHYVMRKE
VYRF]TEVWMRKXLIEZEMPEFPIWSYVGIGSHIERHGSQFMRMRKXLIHEXEEFSYXXLI
PMRIW[LIVIXLITVSGIHYVIJYRGXMSRMWGEPPIH

Chapter 6

Working with PL/SQL code

287

Executable Line
8LI4VSJMPIVHMWTPE]WHEXEEFSYXIEGLI\IGYXEFPIPMRISJEYRMX 8LMWHSIWRSX
MRGPYHIGSQQIRXPMRIWIQTX]PMRIWERHWSJSVXL 
=SYGERYWIXLMWHEXEXSGSQTEVIXMQIWERHGSZIVEKIZEPYIWEGVSWWXLIWEQI
X]TISJTVSJMPMRKHEXEMXIQ*SVI\EQTPIMXMWTSWWMFPIXSPSSOEXEPPVYRWERH
GSQTEVIXLIMVXSXEPI\IGYXMSRXMQIWGSQTEVIEPPYRMXWMREWMRKPIVYRSV
GSQTEVIEPPYRMXWMREKVSYTEGVSWWXLIKVSYTVYRW

Example: Identifying an execution bottleneck


8LIJSPPS[MRKMWXLITVSGIHYVI]SYQMKLXJSPPS[MRSVHIVXSMHIRXMJ]ER
I\IGYXMSRFSXXPIRIGO
1 'VIEXIERI[XIWXKVSYT
2 %HHXLIGSHIYRMX W XSXLIKVSYT
3
4
5
6

+IRIVEXISRISVQSVIERSR]QSYWFPSGOWIRXIVMRKXLIHIWMVIHTEVEQIXIVW
XSKIRIVEXISRISVQSVITVSJMPMRKVYRW
)\IGYXIXLIVYR W MRTVSJMPMRKQSHI
7IPIGXXLIKVSYTERHXLIRWIPIGXXLI8MQI7XEXMWXMGWXEFXSZMI[E
GSQTEVMWSRSJXLII\IGYXIHGSHIYRMXW
7IPIGXXLIYRMX[LMGLXSSOXLIPSRKIWXXMQI2SXIXLIPMRIRYQFIV-JXLMWMW
ETEGOEKIFSH]]SYGERZMI[WXEXMWXMGWJSVMXWTVSGIHYVIWERHJYRGXMSRW
7IPIGXXLITVSGIHYVIJYRGXMSR[LMGLXSSOQSWXXMQI
8SIHMXXLIGSHISTIRXLI7XSVIH4VSKVEQ)HMXSV

Example: Using the coveragefeature for quality assurance


8LIJSPPS[MRKMWXLITVSGIHYVI]SYQMKLXJSPPS[MRSVHIVXSIRWYVIXLEXEPP
PMRIWSJGSHILEZIFIIRI\IGYXIHHYVMRKEXIWXVYR
1 'VIEXIERI[XIWXKVSYT
2
3
4
5

%HHXLIGSHIYRMX W XSXLIKVSYT
+IRIVEXISRISVQSVIERSR]QSYWFPSGOWIRXIVMRKXLIHIWMVIHTEVEQIXIVW
XSKIRIVEXISRISVQSVITVSJMPMRKVYRW
)\IGYXIXLIVYR W MRTVSJMPMRKQSHI
7IPIGXXLIKVSYTERHXLIRWIPIGXXLI'SZIVEKIXEFXSZMI[XLIGSZIVEKI
WXEXMWXMGW'SZIVEKIMWQIEWYVIHEWEWMQTPITIVGIRXEKISJXLIWXSVIHGSHI
XLEXLEWFIIRI\IGYXIHHYVMRKEXIWX8LIKSEPMWXSGSZIVSJXLI
GSHIXSIRWYVIXLEXIEGLTSWWMFPITEXLLEWFIIRI\IGYXIHERHXLIVIMWRS
YRXIWXIHGSHI

288

SQL Navigator Users Guide

Installing the PL/SQL Profiler


407504VSJMPIVMWEZEMPEFPIEWITEVEXISTXMSR MXMWRSXEWXERHEVHGSQTSRIRX
SJ7502EZMKEXSV *SVMRJSVQEXMSRGSRXEGX]SYV5YIWX7SJX[EVI
VITVIWIRXEXMZI
;LIR]SYVYRXLI407504VSJMPIVMRWXEPPEXMSRTVSKVEQMXHIXIGXW750
2EZMKEXSVMRXLIW]WXIQERHMRWXEPPWRIGIWWEV]JMPIWMRXSXLIWEQI[SVOMRK
HMVIGXSVMIW
&IJSVIVYRRMRK407504VSJMPIVJSVXLIJMVWXXMQI]SY[MPPRIIHXSGVIEXI
WIZIVEPXEFPIWERHMRHI\IWMR]SYVS[RWGLIQEXLEX[MPPGSPPIGXTVSJMPMRKHEXE
8SHSXLMWVYRXLIWGVMTXJVSQJMPITVSJCMRWXEPPWUPPSGEXIHMRXLI@-RWXEPPWYF
HMVIGXSV]SJ7502EZMKEXSVLSQIHMVIGXSV]8SVIQSZIXLIXEFPIWERHMRHI\IW
GVIEXIHF]XLMWWGVMTX[LIR]SYRSPSRKIVRIIHXSYWI407504VSJMPIVVYRXLI
WGVMTXJVSQJMPITVSJCYRMRWXEPPWUP
8SVYRXLI407504VSJMPIVXLIJSPPS[MRKGSRHMXMSRWQYWXFIQIX
 XLIk(&17C463*-0)6kTEGOEKIRIIHWXSFIMRWXEPPIHYRHIV7=78LMWMW
HSIWRSXLETTIRF]HIJEYPXSRERI[MRWXERGI
 XSGSPPIGXWIWWMSRWXEXMWXMGWXLIYWIVWRIIHEGGIWWXS:7)77-32
:7)778%8ERH:78%82%1)8LEXQIERWXLI]LEZIXSLEZI7)0)'8
TVMZMPIKISRW]WXIQZMI[W:C7)77-32:C7)778%8ERH
:C78%82%1)
 XLITVSJMPIVWIVZIVWMHISFNIGXW-RWXEPPMRKCWIVZIVCWMHICSFNIGXW XEFPIWERH
WIUYIRGIW RIIHXSFIMRWXEPPIHYRHIVXLIWGLIQEWXLEXYWIXLITVSJMPIV

PL/SQL Profiler window


8LI407504VSJMPIV[MRHS[LEWX[SQEMREVIEWXLIREZMKEXMSRXVIIZMI[
EVIEERHXLIHEXEHMWTPE]EVIE

Tree views
8LIXVIIHMWTPE]WEPPXLITVSJMPMRKHEXEMREWXERHEVH[MRHS[WJSVQERH
TVSZMHIWEGSRZIRMIRXQIXLSHJSVREZMKEXMRKXLVSYKLXLIHEXE8LIVIEVIX[S
WITEVEXIXVIIZMI[WXLI+VSYTWZMI[ERHXLI6YRWZMI[

Runs view
8LIXSTPIZIPRSHISJXLI6YRWZMI[GSQFMRIWEPPXLIEZEMPEFPIVYRW)EGLVYR
MWEXVIIRSHILEZMRKMXWYRMXWEWGLMPHVIR8]TIERHTEGOEKIFSHMIWLEZIXLIMV
VSYXMRIWEWGLMPHVIR

Chapter 6

Working with PL/SQL code

289

Groups view
8LIXSTPIZIPRSHI+VSYTWZMI[GSQFMRIWEPPXLIEZEMPEFPIKVSYTW)EGLKVSYT
MWEXVIIRSHILEZMRKMXWYRMXWEWGLMPHVIR
8LIGETXMSRWSRXLIXVIIZMI[RSHIWHMWTPE]XLIVYRGSQQIRXJSVVYRWERHXLI
GSVVIWTSRHMRKREQIWJSVEPPXLISXLIVX]TIW WYGLEWETEGOEKIREQI 

To view the profiling data for an item in the tree view


 7IPIGXERSHIMRXLIXVIIZMI[F]GPMGOMRKMX

To select from a list of actions to perform


 6MKLXGPMGOXLIMXIQ

Interpreting PL/SQL Profiler result sets


=SYGERGLSSWIEQSRKWIZIVEPXEFFIHTEKIWJSVZMI[MRKTVSJMPIVVIWYPXWIXW
8LI]EVIIREFPIHSVHMWEFPIHHITIRHMRKSR[LEXX]TISJRSHIMWWIPIGXIHMRXLI
XVIIZMI[8LISRP]VIWYPXWIXXLEXMWEP[E]WEZEMPEFPIJSVEPPMXIQWMWXLI
D7YQQEV]
8LIJSPPS[MRKPMWXHIWGVMFIWXLIQIERMRKSJXLIHMJJIVIRXVIWYPXWIXW
JSVEPPEWWSGMEXIHXVIIZMI[RSHIX]TIW


290

SQL Navigator Users Guide

Node Type

Tab

Result Set Description

%PP6YRW

7YQQEV]

8SXEPWEGVSWWEPPXLIEZEMPEFPIVYRW

8MQI7XEXMWXMGW

)\IGYXMSRXMQIWJSVEPPXLIEZEMPEFPIVYRW

'SZIVEKI

'SZIVEKIZEPYIWJSVEPPXLIEZEMPEFPIVYRW

6YR

7YQQEV]

&EWMGVYRGLEVEGXIVMWXMGW GSQQIRXHEXIRYQFIVSJ
PMRIWIXG| XSXEPWEGVSWWEPPXLIVYRYRMXW

8MQI7XEXMWXMGW

)\IGYXMSRXMQIWJSVEPPXLIVYRYRMXW
%ZEMPEFPIMJXLID(MWTPE]0MRI(EXE(MVIGXP]
STXMSRMW
HMWEFPIH

'SZIVEKI

'SZIVEKIZEPYIWJSVEPPXLIVYRYRMXW
%ZEMPEFPIMJXLID(MWTPE]0MRI(EXE(MVIGXP]
STXMSRMW
HMWEFPIH

8MQI7XEXMWXMGW

)\IGYXMSRXMQIWJSVXLIVYRPMRIW
%ZEMPEFPIMJXLID(MWTPE]0MRI(EXE(MVIGXP]
STXMSRMW
IREFPIH

'EPP

2YQFIVSJI\IGYXMSRWJSVXLIVYRPMRIW

(MWXVMFYXMSR

%ZEMPEFPIMJXLID(MWTPE]0MRI(EXE(MVIGXP]
STXMSRMW
IREFPIH

%PP+VSYTW

7YQQEV]

8SXEPWEGVSWWEPPXLIKVSYTW

8MQI7XEXMWXMGW

)\IGYXMSRXMQIWJSVEPPXLIEZEMPEFPIVYRW

'SZIVEKI

'SZIVEKIZEPYIWJSVEPPXLIKVSYTW

+VSYT

7YQQEV]

&EWMGKVSYTGLEVEGXIVMWXMGWXSXEPWEGVSWWXLIKVSYTYRMXW
ERHVYRW

8MQI7XEXMWXMGW

)\IGYXMSRXMQIWJSVKVSYTYRMXWERHVYRW'SQFMRIWXLI
KVSYTVYRWMJXLID'SQFMRI6YRWMR+VSYT6IWYPX7IXW

STXMSRMWIREFPIH

'SZIVEKI

'SZIVEKIZEPYIWJSVKVSYTYRMXWERHVYRW'SQFMRIWXLI
KVSYTVYRWMJXLID'SQFMRI6YRWMR+VSYT6IWYPX7IXW

STXMSRMWIREFPIH

Chapter 6

Working with PL/SQL code

291

Node Type

Tab

Result Set Description

4VSGIHYVI*YRGXMSR
8VMKKIV&SH]

7YQQEV]

&EWMGGLEVEGXIVMWXMGWXSXEPWEGVSWWXLIVYRW'SQFMRIWXLI
KVSYTVYRWMJXLID'SQFMRI6YRWMR+VSYT6IWYPX7IXW

STXMSRMWIREFPIH

8MQI7XEXMWXMGW 

)\IGYXMSRXMQIWJSVEPPXLITVSGIHYVIJYRGXMSRPMRIW

%ZEMPEFPISRP]
w YRHIVEKVSYTMJXLIKVSYTVYRWEVIMHIRXMGEPERH
XLITVSGIHYVIJYRGXMSRLEWFIIRGEPPIHEXPIEWXSRGI
w YRHIVEVYR


'EPP(MWXVMFYXMSR 


2YQFIVSJI\IGYXMSRWJSVXLITVSGIHYVIJYRGXMSRPMRIW
%ZEMPEFPISRP]
w YRHIVEKVSYTMJXLIKVSYTVYRWEVIMHIRXMGEPERHXLI
TVSGIHYVIJYRGXMSRLEWFIIRGEPPIHEXPIEWXSRGI
w YRHIVEVYR

7SYVGI:MI[IV 

7SYVGIGSHISJXLITVSGIHYVIJYRGXMSR[MXLXLITVSJMPMRK
HEXE PMRIRYQFIVRYQFIVSJI\IGYXMSRWXSXEPXMQI %PP
PMRIWXLEX[IVII\IGYXIHEVIQEVOIH[MXLEKVIIRHSX

%ZEMPEFPISRP]
w YRHIVEKVSYTMJXLIKVSYTVYRWEVIMHIRXMGEPERHXLI
TVSGIHYVIJYRGXMSRLEWFIIRGEPPIHEXPIEWXSRGI
w YRHIVEVYR


8]TI&SH]4EGOEKI&SH]

7YQQEV]

&EWMGGLEVEGXIVMWXMGWXSXEPEGVSWWXLIVYRW'SQFMRIWXLI
KVSYTVYRWMJXLID'SQFMRI6YRWMR+VSYT6IWYPX7IXW

STXMSRMWIREFPIH

'SZIVEKI 

'SZIVEKIZEPYIWJSVXLITVSGIHYVIWJYRGXMSRWQIXLSHW

%ZEMPEFPIMJXLIWSYVGIGSHIMWZEPMHEGVSWWXLIVYRW
MHIRXMGEPERHEZEMPEFPI ERHXLID4EVWI4EGOEKIW*SV
7YFVSYXMRIW
STXMSRMWIREFPIHERHXLID(MWTPE]0MRI
(EXE(MVIGXP]
STXMSRMWHMWEFPIH


'EPP(MWXVMFYXMSR 


'EPPRYQFIVWJSVXLITVSGIHYVIWJYRGXMSRW
%ZEMPEFPIMJXLIWSYVGIGSHIMWZEPMHEGVSWWXLIVYRW
MHIRXMGEPERHEZEMPEFPI ERHXLID4EVWI4EGOEKIW*SV
7YFVSYXMRIW
STXMSRMWIREFPIHERHXLID(MWTPE]0MRI
(EXE(MVIGXP]
STXMSRMWHMWEFPIH

8MQI7XEXMWXMGW 


)\IGYXMSRXMQIWJSVXLITVSGIHYVIWJYRGXMSRWQIXLSHW
%ZEMPEFPIMJXLIWSYVGIGSHIMWZEPMHEGVSWWXLIVYRW
MHIRXMGEPERHEZEMPEFPI ERHXLID4EVWI4EGOEKIW*SV
7YFVSYXMRIW
STXMSRMWIREFPIHERHXLID(MWTPE]0MRI
(EXE(MVIGXP]
STXMSRMWHMWEFPIH

292

SQL Navigator Users Guide

Node Type

Tab

Result Set Description

7SYVGI:MI[IV 

7SYVGIGSHISJXLITEGOEKIX]TIFSH][MXLXLITVSJMPMRK
HEXE PMRIRYQFIVRYQFIVSJI\IGYXMSRWXSXEPXMQI %PP
PMRIWXLEX[IVII\IGYXIHEVIQEVOIH[MXLEKVIIRHSX

%ZEMPEFPIMJXLIWSYVGIGSHIMWZEPMHEGVSWWXLIVYRW
MHIRXMGEPERHEZEMPEFPI ERHXLID4EVWI4EGOEKIW*SV
7YFVSYXMRIW
STXMSRMWIREFPIHERHXLID(MWTPE]0MRI
(EXE(MVIGXP]
STXMSRMWHMWEFPIH


'EPP(MWXVMFYXMSR 


2YQFIVSJI\IGYXMSRWJSVXLITEGOEKIX]TIFSH]PMRIW
%ZEMPEFPIMJXLIWSYVGIGSHIMWRSXEZEMPEFPISVD4EVWI
4EGOEKIW*SV7YFVSYXMRIW
STXMSRMWHMWEFPIHSVD(MWTPE]
0MRI(EXE(MVIGXP]
STXMSRMWIREFPIH

8MQI7XEXMWXMGW 


)\IGYXMSRXMQIWJSVXLITEGOEKIX]TIFSH]PMRIW
%ZEMPEFPIMJXLIWSYVGIGSHIMWRSXEZEMPEFPISVD4EVWI
4EGOEKIW*SV7YFVSYXMRIW
STXMSRMWHMWEFPIHSVD(MWTPE]
0MRI(EXE(MVIGXP]
STXMSRMWIREFPIH

Chapter 6

Working with PL/SQL code

293

Setting PL/SQL Profiler filters and sort options


9WIXLI407504VSJMPIV*MPXIVW4VIJIVIRGIWHMEPSKXSWIXXLIHEXEJMPXIVSTXMSRW
WSVXMRKERHGLEVXHVE[MRKTVSTIVXMIW
Threshold and sorting works only if there is a
single series to be displayed in the Runs tree and
Combine Runs in Group Result Sets is enabled
for the Groups tree.

Data Filters tab options


For this result

Select this option

7IXXLIGLEVXWERHPMWXWXSHMWTPE]SRP]
XLIMXIQW[MXLXLIZEPYIWTIGMJMIHXLI
SXLIVGSRXVSPWMRXLID(EXE:EPYI*MPXIV

KVSYT

(MWTPE]SRP]MXIQW[MXLZEPYI

7IXXLIQIXLSHSJJMPXIVMRK

1SVIXLER0IWWXLER)UYEPXS>IVS
2SR^IVS

7IXXLI8LVIWLSPHZEPYI %GXMZISRP]
[LIRD1SVIXLER
ERHD0IWWXLER

STXMSRWEVIWIPIGXIH 

D
SVSXLIVZEPYI

8SXEP%ZIVEKI
7IXXLIZEPYIEKEMRWX[LMGLXLI
XLVIWLSPHZEPYIMWXSFIGSQTEVIH
%GXMZISRP][LIRD1SVIXLER
ERHD0IWW
XLER
STXMSRWEVIWIPIGXIH 
7IXXLIXVIIZMI[WXSHMWTPE]XLI
ERSR]QSYWFPSGOWI\IGYXIHHYVMRK
VYRW

7LS[%RSR]QSYW&PSGOW

7IXXLITVSJMPIVXSFVIEOTEGOEKIHEXE
HS[RXSHMWGVIXITVSGIHYVIWJYRGXMSRW

4EVWI4EGOEKIWJSV7YFVSYXMRIW

294

SQL Navigator Users Guide

For this result

Select this option

7IXXLIHEXEHMWTPE]WXSEP[E]WWLS[PMRI (MWTPE]0MRI(EXE(MVIGXP]
HEXEJSVXLIWIPIGXIHXVIIZMI[MXIQ*SV
I\EQTPI[LIREVYRMWWIPIGXIHXLI
GLEVXWPMWXW[MPPWLS[EPPXLIPMRIW
I\IGYXIHMRXLIVYRRSXXLIVYRYRMXW
)REFPIWSVXMRKSJXLIVIWYPXHEXEMRXLI
HMWTPE]7SVXMRKSRP][SVOWJSVXLI
D6YRW
XVIIRSXJSVXLIKVSYTW

7SVX6IWYPX7IXW

'SRXVSPXLISVHIVSJXLIWSVXMRK SRP]
EGXMZI[LIR7SVX6IWYPX7IXWMWIREFPIH 

(IWGIRHMRK3VHIVIXG

)REFPIXLIGSQFMRMRKSJHEXEJVSQ
HMJJIVIRX6YRWMRXLI+VSYT JSV
I\EQTPIXSSFXEMRGSVVIGXGSZIVEKI
ZEPYIEGVSWWXLI6YRW 

'SQFMRI6YRWMR+VSYT6IWYPX7IXW

Chart Options tab options


For this result

Select this option

)REFPI(PSSOJSVXLIGLEVXW

(

7IPIGXGSPSVKIRIVEXMSRQIXLSHJSVXLI
GLEVXWIVMIW[LIRHMWTPE]MRK+VSYTHEXE
+VSYTWXVIIZMI[ 

+VSYT'LEVX7IVMIW

7IPIGXGSPSVKIRIVEXMSRQIXLSHJSVXLI
GLEVXWIVMIW[LIRHMWTPE]MRK6YRHEXE
6YRWXVIIZMI[ 

6YR'LEVX7IVMIW

'SRXVSPXLIGLEVXFEGOKVSYRHGSPSV

'LEVX4ERIP

7IPIGX[LMGLGSPSVWEVIYWIH[LIRXLI
D+VEHMIRX
GSPSVKIRIVEXMSRQIXLSHMW
WIPIGXIHMRD|'LEVX7IVMIW
VEHMS
FYXXSR

7IVMIW'SPSV+VEHMIRX

7IPIGX[LMGLGSPSVWEVIYWIH[LIRXLI
D7IUYIRGI
GSPSVKIRIVEXMSRQIXLSHMW
WIPIGXIHMRD|'LEVX7IVMIW
VEHMS
FYXXSR

7IVMIW'SPSV7IUYIRGI

Chapter 6

Working with PL/SQL code

295

To select a color
1
2

'PMGOSRXLIGSPSVWIPIGXMSRVIGXERKPIW
7IPIGXEGSPSVJVSQXLI;MRHS[WWXERHEVHGSPSVWIPIGXMSRHMEPSK

Setting PL/SQL Profiler group properties


9WIXLI+VSYT4VSTIVXMIWHMEPSKXSWIXKVSYTREQIGSQQIRXYWIHYRMXWERH
VYRW8LID+VSYT9RMXW
ERHD+VSYT6YRW
PMWXFS\IWHMWTPE]XLIYRMXWVYRW
YWIHJSVEREP]WMWMRXLIKMZIRKVSYT=SYQYWXWTIGMJ]EXPIEWXSRIKVSYTYRMX 

Optimizing stored programs


=SYGERYWIXLIMRXIKVEXIH'SZIVEKI4VSJMPMRKXSSPXSEREP]^IXLII\IGYXMSR
XMQIERHIJJMGMIRG]SJ]SYVWXSVIHTVSKVEQW 8LI4VSJMPIVMWEZEMPEFPIJSVYWI
[MXL3VEGPISVLMKLIV 

To open the PL/SQL Profiler


 3RXLI*YRGXMSRWXSSPFEVGPMGO



Debugging PL/SQL
Debugging PL/SQL
7502EZMKEXSVTVSZMHIWX[SSTXMSRWJSVHIFYKKMRK40750
 XLI7502EZMKEXSV(IFYKKIVSTXMSR
 XLI(&17C398498TEGOEKI

The SQL Navigator Debugger option


*SVEZIVWEXMPIERHTS[IVJYPHIFYKKMRKXSSPWIXXLI7502EZMKEXSV(IFYKKIV
STXMSR EZEMPEFPIJVSQ5YIWX7SJX[EVIEWEWITEVEXISTXMSR MWVIGSQQIRHIH
40750(IFYKKIVLIPTW]SYHIFYKXVMKKIVWERHWXSVIHTVSKVEQWMRGPYHMRK
7502EZMKEXSV
W(IFYKKIVSTXMSRLIPTW]SYHIFYKWXSVIHTVSKVEQW
MRGPYHMRK

296

SQL Navigator Users Guide

 TVSGIHYVIW
 JYRGXMSRW
 TEGOEKIWERHTEGOEKIFSHMIW
 XVMKKIVW
 X]TIWERHX]TIFSHMIW
7502EZMKEXSV
W(IFYKKIVSTXMSRVIUYMVIWEWITEVEXIPMGIRWIEKVIIQIRX

The DBMS_OUTPUT package


%TEVXJVSQXLI(IFYKKIVSTXMSR7502EZMKEXSVTVSZMHIWHIFYKKMRKWYTTSVX
MRXLIJSVQSJXLI3YXTYX[MRHS[[LMGLGETXYVIWXLISYXTYXJVSQXLI
(&17C398498TEGOEKI
8LIDBMS_OUTPUTTEGOEKIMWEWXERHEVHTEGOEKITVSZMHIHF]3VEGPI
WTIGMJMGEPP]JSVXLITYVTSWISJHIFYKKMRKWXSVIHTVSKVEQW8LI7=7WGLIQE
S[RWXLMWTEGOEKI8SZMI[XLITVSGIHYVIERHTEVEQIXIVHIJMRMXMSRWSJXLMW
TEGOEKIIMXLIV
 HMWTPE]MXMRXLI7XSVIH4VSKVEQIHMXSV
SV
 TVMRXXLI7XSVIH4VSKVEQVITSVXJSVXLITEGOEKI

Using the DBMS_OUTPUT package as an aid to debugging


%GSQQSRP]YWIHQIXLSHSJHIFYKKMRKWXSVIHTVSKVEQWMWXSMRGPYHI
DBMS_OUTPUT.PUT_LINEWXEXIQIRXWXSHMWTPE]XLIGYVVIRXPSGEXMSRSJ
TVSKVEQI\IGYXMSRSVXLIZEPYIWSJTVSKVEQZEVMEFPIW
;LIRXLIWXSVIHTVSKVEQMWI\IGYXIHMREWIWWMSR[MXL3YXTYXSTXMSR32
3VEGPIWIRHWXLISYXTYXSJDBMS_OUTPUTWXEXIQIRXXSEFYJJIV750
2EZMKEXSVXLIRHMWTPE]WXLIGSRXIRXWSJXLMWFYJJIVMRXLI3YXTYX[MRHS[EX
XLIIRHSJWXSVIHTVSKVEQI\IGYXMSR
;LIR]SYI\IGYXIXLIWEQITVSGIHYVIMREWIWWMSR[MXLXLI3YXTYXSTXMSR
3**3VEGPIXVIEXWEPPGEPPWXSDBMS_OUTPUT.PUT_LINEEW234W 2S
STIVEXMSR ERHXLIVIMWRSSYXTYX8LIVIJSVIDBMS_OUTPUT.PUT_LINE
WXEXIQIRXMQTSWIWZIV]PMXXPISZIVLIEH[LIRXLITVSKVEQMWQMKVEXIHMRXSXLI
TVSHYGXMSRIRZMVSRQIRX

To insert a DBMS_OUTPUT.PUT_LINE debugging statement


4VIWWWLSVXGYXOI]'XVP(
8LMWTPEGIWXLIWXEXIQIRX
DBMS_OUTPUT.PUT_LINE( );

EXXLIGYVVIRXGEVIXTSWMXMSR

Chapter 6

Working with PL/SQL code

297

To produce a DBMS_OUTPUT statement for a variable


7IPIGXXLIZEVMEFPIERHIMXLIV
 GPMGOXLI(IFYK:EVMEFPIFYXXSR
SV
 WIPIGX(IFYK:EVMEFPIJVSQXLI)HMX"-RWIVXQIRY
7502EZMKEXSVTPEGIWXLIWXEXIQIRX
DBMS_OUTPUT(Value of <var name> = ||var_name);

MR]SYVGSHI

Examples of DBMS_OUTPUT statements used for debugging


8SWLS[XLEXXLII\IGYXMSRVIEGLIHEGIVXEMRTSMRX
DBMS_OUTPUT.PUT_LINE(Reached update employee statement);

8SHMWTPE]XLIZEPYISJTVSKVEQZEVMEFPIWYWISRISJXLIJSPPS[MRKX[S
QIXLSHW
 ;LIVIv_enameLEWFIIRHIGPEVIHEWEVARCHAR2ZEVMEFPI
DBMS_OUTPUT.PUT_LINE(Value of Employee name is
:||v_ename);

 ;LIVIv_empnoLEWFIIRHIGPEVIHEWENUMBERZEVMEFPI
DBMS_OUTPUT.PUT_LINE(Value of Emp number is
:||TO_CHAR(v_empno));

Viewing server output


8LI3YXTYX[MRHS[GETXYVIWXLISYXTYXSJXLIDBMS_OUTPUTTEGOEKI[LIR
WXSVIHTVSKVEQWEVII\IGYXIHMREWIWWMSR[MXLXLI3YXTYXSTXMSR328LI
SYXTYX[MRHS[GERFYJJIVYTXSPMRIWSJXI\X

Interpreting the output display


8LI3YXTYX[MRHS[HMWTPE]WTVSGIWWSVSYXTYXMRXLIJSPPS[MRKGSPSVWGLIQI
Color

Data type

&PYI

7IVZIVSYXTYX

6IH

)VVSV1IWWEKIW

&PEGO

3XLIVTVSGIWWMRKQIWWEKIW

To set the Output window buffer size


'PMGO:MI[ 4VIJIVIRGIW +IRIVEP 7IWWMSR (&173YXTYX&YJJIV

298

SQL Navigator Users Guide

Enabling Output for a database session


=SYGEREPPSGEXIEVYRXMQIFYJJIVSRXLI3VEGPIWIVZIVXSWXSVIXLISYXTYXSJ
XLIDBMS_OUTPUTTEGOEKI[LIRXLIWXSVIHTVSKVEQMWI\IGYXIH8LISYXTYX
JVSQXLIWXSVIHTVSKVEQI\IGYXMSRMWHMWTPE]IHMRXLI3YXTYX[MRHS[EJXIV
XLITVSGIHYVILEWJMRMWLIHI\IGYXMRK8LMWMWXLIHIJEYPXFILEZMSVSJXLI
DBMS_OUTPUTTEGOEKI
8SZMI[XLISYXTYXSJ(&17C398498JVSQEWXSVIHTVSKVEQWIXXLI3YXTYX
STXMSR32JSVXLIWIWWMSRMR[LMGL]SYEVIKSMRKXSI\IGYXIXLIWXSVIH
TVSKVEQ

To set the Output window option ON


;MXLXLIWIWWMSRWLS[MRKMRXLI%GXMZI7IWWMSRWPMWXGPMGOXLI3YXTYX[MRHS[
XSKKPIFYXXSRSRXLI7IWWMSRXSSPFEV






 8LI3YXTYX[MRHS[XSKKPIFYXXSR 7IWWMSRXSSPFEV 
7IXXMRKXLI3YXTYXSTXMSR32STIRWEWIVZIVSYXTYX[MRHS[MJSRIMWRSX
EPVIEH]STIR
'PSWMRKXLI3YXTYX[MRHS[HSIWRSXHMWEFPIXLI3YXTYXSTXMSR
8LI3YXTYX[MRHS[[MPPFIEYXSQEXMGEPP]VISTIRIHMJ]SYI\IGYXIEWXSVIH
TVSKVEQMREWIWWMSR[MXLXLI3YXTYXSTXMSR32
3YXTYXSTXMSRQYWXFIMRHMZMHYEPP]IREFPIHJSVXLIHEXEFEWIWIWWMSRW
)REFPMRKSYXTYXMRSRIHEXEFEWIWIWWMSRHSIWRSXEYXSQEXMGEPP]IREFPIMXMR
SXLIVGSRGYVVIRXHEXEFEWIWIWWMSRW
3YXTYXJVSQEPPWIWWMSRWMWHMWTPE]IHMRXLIWEQISYXTYX[MRHS[(IJEYPX
WM^ISJXLIVYRXMQIFYJJIVMWOF]XIW

To disable the Output window option for a database session


'PMGOXLI3YXTYXXSKKPIFYXXSRSRXLI7IWWMSRXSSPFEV[LIRXLIWIWWMSRMW
HMWTPE]IHMRXLI%GXMZI7IWWMSR
WPMWX
8MTWJSVHMWEFPMRKXLI3YXTYX[MRHS[

Chapter 6

Working with PL/SQL code

299

 -JXLI3YXTYXXSKKPIFYXXSRRI\XXSXLIGSQFSFS\MWEGXMZEXIHXLIR3YXTYX
MWIREFPIHJSVXLIGYVVIRXWIWWMSR-JXLI3YXTYXXSKKPIFYXXSRMWRSX
EGXMZEXIHXLIRXLI3YXTYXSTXMSRMWRSXIREFPIHJSVXLIWIWWMSR
 'PSWMRKXLI3YXTYX[MRHS[HSIWRSXHMWEFPIXLI3YXTYXSTXMSR=SYQYWX
GPMGOXLI3YXTYXFYXXSRXSKKPIXSW[MXGLSJJ3YXTYX
 8SHIXIVQMRI[LIXLIV3YXTYXLEWFIIRIREFPIHJSVEHEXEFEWIWIWWMSR
QEOIXLIHEXEFEWIWIWWMSREGXMZIF]WIPIGXMRKMXMRXLI%GXMZI7IWWMSR0MWX
GSQFSFS\ERHTEYWIXLITSMRXIVSZIVXLI3YXTYXFYXXSRXSZMI[XLI
GYVVIRXWXEXYW
 =SYGERGST]XI\XJVSQXLI3YXTYX[MRHS[4VIWW'XVP'XSGST]WIPIGXIH
XI\XERH'XVP:XSTEWXIXLIWIPIGXIHXI\X

Debugging Functions, Triggers and Packages


*SPPS[XLIWEQIWXITWEWJSVHIFYKKMRKETVSGIHYVI,S[IZIV[LIR
HIFYKKMRKXVMKKIVWXLII\IGYXISTXMSRMWRSXEZEMPEFPI=SYRIIHXSGVIEXIE
XVMKKIVMRKWXEXIQIRXQERYEPP]ERHVYRMXJVSQXLI750IHMXSV

Debugging PL/SQL with the SQL Navigator Debugger


8LI7502EZMKEXSVHIZIPSTQIRXIRZMVSRQIRXMRGPYHIWERSTXMSREPMRXIKVEXIH
40750(IFYKKIV8LIHIFYKKIVVIUYMVIWEWITEVEXIPMGIRWIEKVIIQIRX
;MXLXLI40750(IFYKKIV]SYGER
 -RMXMEXIHIFYKKMRKJVSQ[MXLMRERIHMXMRKWIWWMSR
 7IX[EXGLIWERHFVIEOTSMRXWFIJSVISVHYVMRKHIFYKKMRKHMVIGXP]JVSQXLI
GSHIIHMXSV
 )\IGYXIER]40750GSHIWXITF]WXITSVTSMRXXSTSMRX
 8VEGIMRXSQYPXMTPIPIZIPWSJTVSGIHYVIGEPPW
 )\EQMRIERHWIXZEVMEFPIWHYVMRKI\IGYXMSRSJTVSGIHYVIW
 :MI[XLIGEPPWXEGOERHZEPYIWSJ[EXGLIHZEVMEFPIWEXER]TSMRXHYVMRKXLI
HIFYKKMRKWIWWMSR
 %GGIWWEPPJYRGXMSRWSJ7502EZMKEXSVEJXIVEHIFYKWIWWMSRMWWXEVXIH
 (IFYK40750GSHIXLEXMWVYRJVSQERI\XIVREPGPMIRXWIVZIVETTPMGEXMSR
YWMRK7502EZMKEXSV
W.YWX-R8MQI(IFYKKMRKJIEXYVI

Overview
7502EZMKEXSV
W(IFYKKIVLIPTW]SYHIFYKWXSVIHTVSKVEQWMRGPYHMRK

300

SQL Navigator Users Guide

 TVSGIHYVIW
 JYRGXMSRW
 TEGOEKIWERHTEGOEKIFSHMIW
 XVMKKIVW
 X]TIWERHX]TIFSHMIW
9WMRKXLI(IFYKKIV]SYGERXVEGO]SYVETTPMGEXMSR
WJPS[SJI\IGYXMSR
QSRMXSVZEVMEFPIWERHIZIRGLERKIXLII\IGYXMSRPSKMGSRXLIJP]F]
QSHMJ]MRKZEPYIWSJTVSKVEQZEVMEFPIW
=SYGERWXITMRXSQYPXMTPIPIZIPWSJXLITVSGIHYVILMIVEVGL]WIXFVIEOTSMRXW
MRTVSGIHYVIWI\EQMRIERHWIXZEVMEFPIWHYVMRKI\IGYXMSRSJTVSGIHYVIWWIX
[EXGLZEVMEFPIWERHZMI[XLIGEPPWXEGOEXER]TSMRXHYVMRKXLIHIFYKKMRK
WIWWMSR
(IFYKKMRKMWERMRXIVEGXMZITVSGIWWERHYWYEPP]MRZSPZIWWYGLEGXMSRWEW
 WIXXMRKFVIEOTSMRXW
 HIJMRMRK[EXGLIHZEVMEFPIW
 VYRRMRKXLI40750GSHIWXITF]WXITSVYTXSEWTIGMJMIHFVIEOTSMRX
 )ZEPYEXMRKSVQSHMJ]MRKZEPYIWSJTVSKVEQZEVMEFPIWHYVMRKI\IGYXMSR


Chapter 6

Working with PL/SQL code

301

Debugger commands



Using the SQL Navigator debugger


7502EZMKEXSV
W(IFYKKIVMWMRXIKVEXIHMRXSXLIHIZIPSTQIRXIRZMVSRQIRX
(IFYKKMRKMWJYRGXMSREPSRP][LIR]SYEVIGSRRIGXIHXSER3VEGPIWIVZIVZMEE
750 2IXGSRRIGXMSR
-J]SYEVIYWMRKEPSGEPHEXEFEWIWYGLEW4IVWSREP3VEGPIYWIXLIPSSTFEGO
750 2IXGSRRIGXMSRXSTIVJSVQMRXIVEGXMZIHIFYKKMRK
=SYGERXSKKPIXLI(IFYK40750STXMSRERHYWIXLIHIFYKKIVXSTIVJSVQXLI
JSPPS[MRKJYRGXMSRW
 6YRXSXLIIRHSVXSXLIRI\XFVIEOTSMRX
 7XITSZIVGSHI
 7XITMRXSGSHI[LIRSXLIVTVSGIHYVIWEVIGEPPIHJVSQXLIGYVVIRXPMRI
 (MWTPE]XLII\IGYXMSRWXEGO
 :MI[ERHQSHMJ]ER]ZEVMEFPIZEPYI

302

SQL Navigator Users Guide

 7IX[EXGLZEVMEFPIW
 7IXERHVIQSZIFVIEOTSMRXSRXLIJP]EWXLIGSHIMWI\IGYXMRKI\GITXMRER
ERSR]QSYWFPSGO
 7XSTEVYRRMRKTVSGIHYVI
 7IXERSTXMSRXSIMXLIVWXSTI\IGYXMSRMJERI\GITXMSRSGGYVWSVMKRSVI
I\GITXMSRW
=SYGERSTIRQYPXMTPIIHMXSVWERHWIXFVIEOTSMRXWMRWIZIVEPWXSVIHTVSKVEQW
SVXVMKKIVWWMQYPXERISYWP]
-JXLITVSGIHYVIJEMPWXSGSQTMPIMXMWHMWTPE]IHMRVIHMRXLI(&2EZMKEXSV
8LITVSGIHYVIGERRSXFIHIFYKKIHFIGEYWIMXMWMRZEPMH
1MRMQYQTIVQMWWMSRWVIUYMVIHJSVYWMRKXLI(IFYKKIV
-RSVHIVXSYWIXLI(IFYKKIVEYWIVQYWXLEZIXLIJSPPS[MRKTIVQMWWMSRWEXE
QMRMQYQ
create session
alter session

To compile a stored program or trigger with debug information


8SFIEFPIXS[EXGLIZEPYEXISVQSHMJ]ZEVMEFPIWSJEWXSVIHTVSKVEQSV
XVMKKIV]SYLEZIXSGSQTMPIXLITVSKVEQ[MXLHIFYKMRJSVQEXMSR
%PXLSYKLWIXXMRKFVIEOTSMRXWSVWXITTMRKXLVSYKLEWXSVIHTVSKVEQHSRkX
VIUYMVIXLEXMXGSRXEMRHIFYKMRJSVQEXMSR]SY[MPPTVSFEFP]RIIHXS[EXGL
ZEVMEFPIWMRWMHIXLITVSKVEQ[LIRI\IGYXMSRTEYWIW
9WISRISJXLIJSPPS[MRKQIXLSHW
 1EOIWYVIXLI'SQTMPI;MXL(IFYK-RJSQSHIMW32 MR7IWWMSR"-RGPYHI
(IFYK-RJS XLIRGSQTMPI]SYVWXSVIHTVSKVEQSVXVMKKIV
 1EOIWYVI40750(IFYKKMRKQSHIMW32 GLSSWI7IWWMSR"40750
(IFYKKMRK3RSVGPMGOXLIFYXXSRSRXLI7IWWMSRXSSPFEV XLIRGSQTMPI
]SYVWXSVIHTVSKVEQSVXVMKKIV
=SYGERWIXFVIEOTSMRXWERH[EXGLIWEXER]XMQIFIJSVISVHYVMRKHIFYK
WIWWMSR=SYHSRSXLEZIXSVIGSQTMPI]SYVTVSKVEQEJXIV]SYWIXFVIEOTSMRXW
SV[EXGLIW

Debugging stored procedures


8LI40750(IFYKKIVQSHYPIQEOIWHIFYKKMRKWXSVIHTVSGIHYVIWIEW]=SY
GERZMI[XLIWSYVGIGSHISJER]TVSGIHYVISVTEGOEKIMRXLII\IGYXMSRXVII
=SYGERWXITMRXSQYPXMTPIPIZIPWSJXLITVSGIHYVILMIVEVGL]WIXFVIEOTSMRXW
MRTVSGIHYVIWI\EQMRIERHWIXZEVMEFPIWHYVMRKI\IGYXMSRSJTVSGIHYVIWWIX
[EXGLZEVMEFPIWERHZMI[XLIGEPPWXEGOEXER]TSMRXHYVMRKXLIHIFYKKMRK
WIWWMSR 

Chapter 6

Working with PL/SQL code

303

%RMRWXERX3VEGPIIVVSVHIWGVMTXMSRJIEXYVIKMZIW]SYEJYPPI\TPEREXMSR FEWIH
SR3VEGPIHSGYQIRXEXMSR NYWXF]HSYFPIGPMGOMRK[LIVIZIVER3VEGPIIVVSV
QIWWEKIETTIEVW
8LI(IFYKKIVMWMRXIKVEXIH[MXLXLI7502EZMKEXSVHIZIPSTQIRXIRZMVSRQIRX
IREFPMRKYWIVWXSMRMXMEXIHIFYKKMRKJVSQ[MXLMRERIHMXMRKWIWWMSRERHWIX
[EXGLIWERHFVIEOTSMRXWHYVMRKHIFYKKMRKHMVIGXP]JVSQXLIGSHIIHMXSV
=SYGERYWI7502EZMKEXSV
W.YWX-R8MQI(IFYKKMRKJIEXYVIXSHIFYK
40750WIVZIVWMHIGSHIXLEXMWVYRJVSQER]GPMIRXWIVZIVETTPMGEXMSR 8LMW
MRGPYHIWGSHI[VMXXIRMR:MWYEP&EWMG(IPTLM4S[IV&YMPHIV(IZIPSTIV
SVSXLIVETTPMGEXMSRW %PP7502EZMKEXSVJYRGXMSREPMX]VIQEMRWEZEMPEFPIEJXIV
EHIFYKWIWWMSRMWWXEVXIH
8LIJSPPS[MRKEVIWSQISJXLIHIFYKKMRKJIEXYVIWEZEMPEFPIMRXLMWZIVWMSRSJ
7502EZMKEXSV
 HIFYKKMRKGSQQERHW[LMGLFIGSQIEZEMPEFPI[LIREWXSVIH4VSKVEQ
)HMXSVMWEGXMZISVEHIFYKWIWWMSRLEWWXEVXIHF]GLSSWMRKXLI(IFYK
STXMSRSRXLI7IWWMSRQIRY
 E7XEXYW[MRHS[EZEMPEFPIHYVMRKEHIFYKWIWWMSR
 XLI&VIEOTSMRXW[MRHS[ERH;EXGLIW[MRHS[[LMGLPMWXEPPFVIEOTSMRXW
ERH[EXGLIWJSVXLIGYVVIRX(&GSRRIGXMSR
 E8SKKPI&VIEOTSMRXGSQQERHMRXLI7XSVIH4VSKVEQERH8VMKKIV)HMXSVW
 ER)ZEPYEXI1SHMJ]HMEPSKEGGIWWMFPIJVSQ7XSVIH4VSKVEQERH8VMKKIV
)HMXSVW
 XLI%HH;EXGLHMEPSKEGGIWWMFPIJVSQ7XSVIH4VSKVEQERH8VMKKIV)HMXSVW
 XLI;EXGL%VKYQIRXGSQQERHMR(&2EZMKEXSV
 XLI8SSPXMTIZEPYEXMSRJIEXYVISJXLI7XSVIH4VSKVEQERH8VMKKIV)HMXSVW
 XLI&VIEO'SRHMXMSRHMEPSKEGGIWWMFPIJVSQ&VIEOTSMRXW[MRHS[ERHXLI
&VIEOTSMRXWXEFSJXLI)\IGYXMSR7XEXYW[MHS[
(IFYKKMRKMWEZEMPEFPI[LIR]SYEVIGSRRIGXIHXSER3VEGPIWIVZIVZMEE
750 2IXSV2IXGSRRIGXMSR-J]SYEVIYWMRKEPSGEPHEXEFEWIWYGLEW
4IVWSREP3VEGPIYWIXLIPSSTFEGO750 2IXGSRRIGXMSRXSTIVJSVQMRXIVEGXMZI
HIFYKKMRK

304

SQL Navigator Users Guide

Oracle version requirements for the Debugger


(IFYKKMRKJIEXYVIWWYTTSVXF]3VEGPI
Feature


Supported in Oracle version?















:MI[WIXZEPYIWSJPSGEP
ZEVMEFPIW

=IW

=IW

=IW

=IW

=IW

:MI[WIXZEPYIWSJ
TEGOEKIKPSFEP
ZEVMEFPIW

2S

2S

=IW

=IW

=IW

:MI[GYVWSVZEVMEFPIW

2S

=IW 

=IW

=IW

=IW

-RJSVQEXMSRSR
TVSGIHYVIWSXLIVXLER
GYVVIRX

2S

=IW


=IW


=IW

=IW

:MI[WIXZEPYIWSJ
MRHI\IHZEVMEFPIW

2S

2S

=IW

=IW

=IW

7XSTI\IGYXMSR

=IW

=IW

=IW

=IW

=IW


EZEMPEFMPMX]ZEVMIWHITIRHMRKSRTPEXJSVQETEXGLQE]FIVIUYMVIH
VIUYMVIW3VEGPI7IVZIVMRMXMEPM^EXMSRTEVEQIXIV
&0%2/C86-11-2+!869)

Setting watched variables


=SYGERWIPIGXEWIXSJZEVMEFPIWXSFI[EXGLIH8LIZEPYIWSJ[EXGLIH
ZEVMEFPIWEVIHMWTPE]IHIZIV]XMQIXLIHIFYKKIVMWTEYWIHXLEXMWEX
FVIEOTSMRXWEJXIVIZIV]7XIT3ZIVSV7XIT-RXSERHHYVMRKXLIEYXSQEXIH
I\IGYXMSR
=SYGER[EXGLGSQTPI\TEVEQIXIVWPMOI6)'36(SV63;8=4)F]YWMRK
XLI;EXGLGSQQERHJVSQ(&2EZMKEXSV.YWXWIPIGXERSHIYRHIVXLI
TVSGIHYVIkWEVKYQIRXPMWXERHXLIWIPIGX;EXGLJVSQXLIWLSVXGYXQIRY750
2EZMKEXSVEHHWEPPGSQTSRIRXWSJXLITEVEQIXIVXSXLI[EXGLPMWX
*SVTEVEQIXIVWSJ8%&0)X]TI]SYRIIHXSEHHERMRHI\XSIEGLGSQTSRIRXkW
REQIMRXLI[EXGLPMWX2SXIXLEX]SYGEREP[E]WYWIXLIXSSPXMTIZEPYEXMSR
JIEXYVISVXLI)ZEPYEXI1SHMJ] 'XVP* GSQQERHSRER]GSQTPI\ZEVMEFPIWk

Chapter 6

Working with PL/SQL code

305

GSQTSRIRXWEWWSSREWXLI]EVIJYPP]WTIGMJMIH JSVI\EQTPI
my_record.field1SVmy_table(i).field1 
Increasing the number of variables in the watch
variable list may result in slower debugger
performance.

To add to the list of watched variables


1
2

4PEGIXLIGYVWSVSRXLIZEVMEFPISVLMKLPMKLXMX
6MKLXGPMGOERHGLSSWI%HH;EXGLJVSQXLIWLSVXGYXQIRY



3

3V
4VIWW'XVP*
-RXLI;EXGL4VSTIVXMIWHMEPSKQSHMJ]XLITVSTIVXMIWEWRIIHIHERHXLIR
GPMGO3/SVTVIWW)RXIV

To add arguments of a procedure to the list of watches


1

-RXLI(&2EZMKEXSVWIPIGXEREVKYQIRXYRHIVXLITVSGIHYVIRSHI %
RSHIGERFIEWMRKPIZEPYIHSVWGEPEVTEVEQIXIVSVEGSQTPI\
TEVEQIXIVLEZMRKWYFGSQTSRIRXWPMOIEVIGSVH 
6MKLXGPMGOERHGLSSWI;EXGLJVSQXLIWLSVXGYXQIRY
If a variable does not update as expected, place a
breakpoint on the next executable line after the
expected update The breakpoint pauses the
debugger and updates the variables values.

To remove a watched variable name


1

*VSQXLIQEMRQIRYGLSSWI(IFYK"0MWX%PP;EXGLIW

2
3

7IPIGXXLIZEVMEFPIREQIMRXLI[EXGLIHZEVMEFPIWPMWX
6MKLXGPMGOXLIRIMXLIV
 GLSSWI6IQSZIJVSQXLIWLSVXGYXQIRY
 3V
 TVIWW(IPIXI

306

SQL Navigator Users Guide

Displaying watch variables during execution


=SYGER[EXGLXLISYXTYXZEVMEFPIW[LIR]SYVTVSGIHYVIMWVYRRMRK
;EXGLIHZEVMEFPIWEVIHMWTPE]IHEYXSQEXMGEPP]MRXLI7XEXYW[MRHS[-JXLI
[MRHS[MWRSXHMWTPE]IH]SYGEREGXMZEXIMXF]QIERWSJXLI(IFYK"7LS[
7XEXYW;MRHS[GSQQERHJVSQXLIQEMRQIRY
-J]SYWMQTP]QSZIXLIGYVWSVXSEZEVMEFPIREQIHYVMRKEHIFYKVYRETSTYT
LMRX[MPPWLS[]SYXLIGYVVIRXZEPYISJXLEXZEVMEFPISVERIVVSVQIWWEKIMJXLI
ZEPYIGERRSXFIHIXIVQMRIH
8S[EXGLZEVMEFPIWSJETVSGIHYVISXLIVXLERXLIGYVVIRXTVSGIHYVIGPMGOER
IRXV]MRXLIGEPPWXEGOTERI 8LMWJIEXYVIQE]FIYREZEMPEFPISRGIVXEMR
W]WXIQWWII8VSYFPIWLSSXMRKXLI7502EZMKEXSV(IFYKKIV 

Handling out-of scope-variables


The debugger maintains separate watch lists for
each program unit. Therefore, if a watch is
defined correctly, it will not be displayed when it
is out of scope.

;EXGLIHZEVMEFPIWQE]KSSYXSJWGSTIEWXLIHIFYKKIVTVSGIIHWXLVSYKL
]SYVWXSVIHTVSKVEQ:EVMEFPIWXLEXEVIZEPMHSRP][MXLMRWYFFPSGOWSVGEPPIH
TVSGIHYVIW[MPPRSXHMWTPE]XLIMVGSVVIGXZEPYIYRXMPXLIHIFYKKIVVIXYVRWXSE
WGSTIMR[LMGLXLI]EVIZEPMH
*SVI\EQTPI[LIRHIFYKKMRKETVSGIHYVIXLEXGEPPWEJYRGXMSRWIXXMRKE
[EXGLSREZEVMEFPIHIGPEVIHMRXLITVSGIHYVIMWZEPMHSRP][LMPIXLIHIFYKKIV
MWMRXLEXTVSGIHYVI
7XITTMRKMRXSXLIGEPPIHJYRGXMSR[MPPQEOIXLITVSGIHYVIZEVMEFPISYXSJ
WGSTI3RGIXLIHIFYKKIVWXITWSYXSJXLIJYRGXMSRERHFEGOMRXSXLI
TVSGIHYVIXLITVSGIHYVIZEVMEFPI[MPPEKEMRFIMRWGSTIERH[MPPLEZIEZEPMH
ZEPYI
The Debugger distinguishes package variables
that belong to different namespaces:
Local
Specification
Body
You can specify the scope for a package variable
from the Watch Properties dialog.

Chapter 6

Working with PL/SQL code

307

Displaying the call stack


8LIGYVVIRXGEPPWXEGOMWHMWTPE]IHEYXSQEXMGEPP]MRXLI)\IGYXMSR7XEXYW
;MRHS[

A brief glossary of debugging terms


&VIEOTSMRX

%PMRI[MXLMREWXSVIHTVSKVEQQEVOIHF]XLI
YWIVEWETSMRX[LIVII\IGYXMSRWLSYPHFI
WYWTIRHIHF]XLIHIFYKKIV)ZIV]XMQITVSKVEQ
I\IGYXMSRVIEGLIWXLIPMRIQEVOIHEWFVIEOTSMRX
GSRXVSPVIXYVRWXSXLIYWIVFIJSVII\IGYXMRKXLI
40750GSHIEXXLMWPMRI8LIVIGERFIER]
RYQFIVSJFVIEOTSMRXWMREWXSVIHTVSKVEQ

'SRHMXMSREPFVIEOTSMRX

%FVIEOTSMRXXLEXMWEWWMKRIHEFVIEOGSRHMXMSR
XLEXMWEGSRHMXMSRXLEXMWIZEPYEXIHF]XLI
HIFYKKIVXSHIXIVQMRI[LIRI\IGYXMSRMWXSFI
WYWTIRHIHEXXLMWFVIEOTSMRX

;EXGLIHZEVMEFPISV
[EXGL

%TVSKVEQZEVMEFPIXLEXMWHIWMKREXIHF]XLIYWIV
XSFIEYXSQEXMGEPP]IZEPYEXIHERHMXWZEPYI
HMWTPE]IHEXER]TSMRX[LIRI\IGYXMSRMW
WYWTIRHIH

(IFYKMRJSVQEXMSR

)\XVEHEXEWXSVIHMRXLIHEXEFEWIXLEXEPPS[WXLI
7502EZMKEXSV(IFYKKIVXSEGGIWWXLIZEVMEFPIW
SJEWXSVIHTVSKVEQEXVYRXMQI

(IFYKQSHI

%WTIGMEPSTIVEXMSREPQSHISJEHEXEFEWI
GSRRIGXMSRXLEXGEYWIW7502EZMKEXSVXSMRMXMEXIE
HIFYKWIWWMSR[LIRIZIVER]40750GSHIMW
I\IGYXIH[MXLMRXLIGSRRIGXMSR

(IFYKWIWWMSR

4VSGIWWSJI\IGYXMRK40750GSHIYRHIVXLI
GSRXVSPSJEHIFYKKIV

8VMKKIVMRZSGEXMSRFPSGO

750(10WXEXIQIRX -27)6894(%8)SV
()0)8) XLEXXVMKKIVWXLIIZIRXEWWSGMEXIH[MXL
XLIXVMKKIV

308

SQL Navigator Users Guide

Initiating a debugging session


%HIFYKKMRKWIWWMSRSGGYVW[LIRIZIV]SYI\IGYXIE40750FPSGOSVXVMKKIV
MRZSGEXMSRFPSGOMR40750(IFYKKMRKQSHI=SYGERW[MXGLXS(IFYKKMRK
QSHII\TPMGMXP]F]GLSSWMRK7IWWMSR"40750(IFYKKMRKSVXLI40750
(IFYKKMRKXSSPFEVFYXXSR=SYGEREPWSW[MXGL(IFYKKMRKQSHIMQTPMGMXP]
WMQTP]F]YWMRKER]7502EZMKEXSVHIFYKKMRKJIEXYVI
;LIR40750(IFYKKMRKQSHIMW32XLI7IWWMSR"40750(IFYKKMRK
QIRYMXIQMWGLIGOIHERHXLI7IWWMSR"40750(IFYKKMRKFYXXSRSRXLI
XSSPFEVETTIEVWMRXLIHS[RTSWMXMSR

To initiate debugging
1
2
3

1EOIWYVI40750(IFYKKMRKQSHIMW32 YWMRK7IWWMSR"40750
(IFYKKMRKSVXLIFYXXSRSR(IFYKKIVXSSPFEV 
1EOIWYVIEPPWXSVIHTVSKVEQW]SYEVIKSMRKXSHIFYKLEZIFIIRGSQTMPIH
[MXLHIFYKMRJSVQEXMSR
7IXER]FVIEOTSMRXWERH[EXGLIWEWRIIHIH

7IPIGXXLI&VIEOSR)\GITXMSRSTXMSRMJ]SY[ERXI\IGYXMSRXSWXST[LIR
ERI\GITXMSRSGGYVW
8LIR
 )\IGYXIEWXSVIHTVSKVEQJVSQ(&2EZMKEXSVSVJVSQXLI7XSVIH4VSKVEQ
IHMXSVSV8VMKKIVIHMXSV
 3V
 )\IGYXIE40750FPSGOSVXVMKKIVMRZSGEXMSRFPSGOJVSQXLI750)HMXSV
 3V
 )\IGYXIE40750FPSGOSVXVMKKIVMRZSGEXMSRFPSGOJVSQERI\XIVREP
ETTPMGEXMSR [LMGLQYWXMRMXMEPM^IHIFYKQSHISRMXWWMHI 8LIRGLSSWI
(IFYK"%XXEGL)\XIVREP7IWWMSR
 3V
 ;LMPIE7XSVIH4VSKVEQSV8VMKKIVIHMXSVMWSTIRWIPIGXER]HIFYKKMRK
GSQQERH 6YR6YRXS'YVWSV8VEGI-RXS7XIT3ZIV%YXS8VEGI-RXS
%YXS7XIT3ZIV EZEMPEFPIJVSQXLI(IFYKQIRYSVXLI(IFYKKMRKXSSPFEV
4

Shortcuts
6MKLXGPMGOMRXLI7XSVIH4VSKVEQSV8VMKKIV)HMXSV[MRHS[JSVEGGIWWXSXLI
JSPPS[MRKWLSVXGYXW

Chapter 6

Working with PL/SQL code

To

309

Choose this option

3TIRXLI)ZEPYEXI1SHMJ]HMEPSK
XS)ZEPYEXISVQSHMJ]ER]
ZEVMEFPI[MXLMRXLITVSGIHYVI

)ZEPYEXI1SHMJ]SVTVIWW'XVP*

7IXSVGPIEVEFVIEOTSMRXEXXLI
GYVVIRXPMRI

8SKKPIFVIEOTSMRXSVTVIWW*

%HHE[EXGLZEVMEFPIXSXLI
PMWXJSVXLITVSGIHYVI

%HH[EXGLSVTVIWW'XVP*

Debugging code run from an external application


=SYGERYWI7502EZMKEXSV
W.YWX-R8MQI(IFYKKMRKJIEXYVIXSHIFYK750
2EZMKEXSVWIVZIVWMHIGSHIXLEXMWVYRJVSQER]GPMIRXWIVZIVETTPMGEXMSR 8LMW
MRGPYHIWGSHI[VMXXIRMR:&(IPTLM4S[IV&YMPHIV(IZIPSTIVSVSXLIV
ETTPMGEXMSRW 
.YWX-R8MQI(IFYKKMRKGERFII\XVIQIP]YWIJYP[LIRXLIETTPMGEXMSRGEPPWE
WXSVIHTVSKVEQ[MXLGSQTPI\TEVEQIXIVWWYGLEWGYVWSVWXLEXEVIRSXIEWMP]
WMQYPEXIHJVSQ7502EZMKEXSV6EXLIVXLERXV]MRKXSWMQYPEXIXLIGSQTPI\
IRZMVSRQIRX]SYGERWMQTP]GSRRIGXXSXLII\XIVREPETTPMGEXMSRERHXLIR
HIFYKXLIGSHI
6IUYMVIQIRXWJSVEXXEGLMRKXSERI\XIVREPETTPMGEXMSR
 8SMRMXMEPM^I(IFYKQSHIXLII\XIVREPETTPMGEXMSRQYWXI\IGYXIX[S
GSQQERHW
id := dbms_debug.initialize(SQLNAV)
dbms_debug.debug_on;

[LIVISQLNAVGERFIVITPEGIHF]ER]-(WXVMRK-JXLMWTEVEQIXIVMW
SQMXXIHXLIVIXYVRZEPYISJinitialize[MPPFIYWIHEWXLI7IWWMSR-(
 %JXIVXLII\XIVREPETTPMGEXMSRMWJMRMWLIHI\IGYXMRKXLIGSHIXLEXRIIHW
HIFYKKMRKMXWLSYPHI\IGYXIXLIGSQQERH
dbms_debug.debug_off

3XLIV[MWIEPPWYFWIUYIRX40750GSHIXLEXXLMWETTPMGEXMSRWYFQMXWJSV
I\IGYXMSR[MPPFIVYRMRHIFYKQSHI8LMW[MPPGEYWIXLIETTPMGEXMSRXSLERK
YRXMP7502EZMKEXSVEXXEGLIWXSMXEKEMR

310

SQL Navigator Users Guide

Attaching an external session for debugging


-RXLIJSPPS[MRKTVSGIHYVI7XITGERFIHSRIFIJSVI7XITFYXMXQE]XLIR
FIHMJJMGYPXXSTEWWXLI7IWWMSR-( YRPIWWMXMWLEVHGSHIH 8LIMQTSVXERX
XLMRKMWXLEXXLIETTPMGEXMSRERHHIFYKKIVEVIW]RGLVSRM^IHEXXLITSMRX[LIR
 8LIETTPMGEXMSRVYRW40750GSHIMRHIFYKQSHIERH
 8LI%XXEGLGSQQERHLEWFIIRMWWYIHJVSQ7502EZMKEXSV

To attach an external session for debugging


1
2

-R7502EZMKEXSVGSRRIGXXSXLIWEQI(&MRWXERGIEWXLII\XIVREP
ETTPMGEXMSR
7IX40750(IFYKKMRK32

-R7502EZMKEXSVJVSQXLI(IFYKQIRYWIPIGX%XXEGL)\XIVREP7IWWMSR
-RXLIHMEPSKXLEXGSQIWYTIRXIVXLIWEQI7IWWMSR-(EWTEWWIHXSSV
VIXYVRIHF]XLIinitializeWXEXIQIRX7502EZMKEXSV[MPPXLIR[EMXJSV
XLIETTPMGEXMSRXSI\IGYXI40750GSHI
5 *VSQXLIETTPMGEXMSRI\IGYXIXLI40750FPSGOXLEXGEPPWXLIWXSVIH
TVSKVEQXSFIHIFYKKIH7502EZMKEXSVHMWTPE]WXLI)\IGYXMSR7XEXYW
[MRHS[ERHIREFPIWEPPHIFYKKMRKGSQQERHW
;LIRI\IGYXMSRSJXLI40750GSHIMWGSQTPIXI7502EZMKEXSVHMWTPE]WXLI
QIWWEKIk)\IGYXMSRGSQTPIXIkERHXLII\XIVREPETTPMGEXMSRGSRXMRYIWMXW
RSVQEP[SVO
3
4

EXAMPLE
,IVIMWEHIQSRWXVEXMSRSJNYWXMRXMQIHIFYKKMRKYWMRKX[SMRWXERGIWSJ750
2EZMKEXSVSRISJ[LMGL 8%6+)8 [MPPFIYWIHXSPEYRGLEWXSVIHTVSGIHYVI
ERHXLISXLIV ()&9++)6 XSTIVJSVQEPPHIFYKKMRKEGXMSRWXVEGII\IGYXMSR
WXITF]WXIT[EXGLZEVMEFPIWERHWSSR -RTVEGXMGIXLI8%6+)8MRWXERGI
[SYPHFIVITPEGIHF]WSQIGPMIRXWIVZIVETTPMGEXMSRXLEXTIVJSVQWWMQMPEV
EGXMSRW 
;IJMVWXGVIEXIEWXSVIHTVSGIHYVIWE]8)78C463'XLEX[MPPFIVYRJVSQ
XLI8%6+)8WIWWMSR

CREATE OR REPLACE
PROCEDURE test_proc1(n NUMBER) IS
BEGIN
. . .
END;

Chapter 6

Working with PL/SQL code

311

2I\X[IVYRX[SMRWXERGIWSJ7502EZMKEXSVGSRRIGXIHXSXLIWEQIHEXEFEWI
[MXLXLIWEQIYWIVREQIWE]WGSXX$FIUPSGEP0IXkWHIRSXIXLIMRWXERGIWEW8
ERH( 8%6+)8ERH()&9++)6VIWTIGXMZIP] 
1 (7IPIGX(IFYK`40750(IFYKKMRKJVSQXLIQEMRQIRYSVTVIWWXLI2S
FYKWWTIIHFYXXSR
2 83TIR7MRKPI750)HMXSVERHX]TIMRERHI\IGYXI * XLIJSPPS[MRK
ERSR]QSYWFPSGO

DECLARE
id VARCHAR2(30);
BEGIN
id := dbms_debug.initialize(SQLNAV);
dbms_debug.debug_on;
END;




8LMWMRMXMEPM^IWXLIHIFYKQSHIJSVXLI8%6+)8WIWWMSR8LIWXVMRKTEWWIH
XS-2-8-%0->) k7502%:kMRXLII\EQTPI MWEVFMXVEV]FYXMXWLSYPHFI
YRMUYIMJ]SYVYRWIZIVEPHIFYKWIWWMSRWSRXLIWEQIWIVZIV
83TIRERSXLIV7MRKPI750)HMXSVERHX]TIMRERHI\IGYXI * XLI
JSPPS[MRKERSR]QSYWFPSGO
BEGIN
test_proc1(123);
dbms_debug.debug_off;
EXCEPTION
WHEN others THEN
dbms_debug.debug_off;
END;


4

;LIRI\IGYXMSRFIKMRWXLI8%6+)87502EZMKEXSVLERKW[EMXMRKJSV
XLI()&9++)6XSGSQIMRXSEGXMSR
(7IPIGX(IFYK`%XXEGL)\XIVREP7IWWMSRXLIRMRXLI)RXIV7IWWMSR-H
HMEPSKIRXIVXLIWEQIWXVMRKEWXLISRITEWWIHXS-2-8-%0->)EX7XIT
k7502%:kMRSYVI\EQTPI 

312

SQL Navigator Users Guide

8LI()&9++)6IWXEFPMWLIWGSQQYRMGEXMSR[MXLXLI8%6+)8ERH
WYWTIRHWI\IGYXMSRSJXLIERSR]QSYWFPSGOEXXLIJMVWXI\IGYXEFPIPMRI
*VSQXLMWTSMRXXLI)\IGYXMSR7XEXYW[MRHS[MWWLS[RMRXLI
()&9++)6ERHEPPHIFYKKMRKEGXMSRWFIGSQIEZEMPEFPI;LIRYWMRK
I\XIVREPETTPMGEXMSRW SXLIVXLER7502EZMKEXSV XLIWSYVGIGSHISJXLI
ERSR]QSYWFPSGOQE]RSXFIEZEMPEFPI2IZIVXLIPIWWTVIWWMRK*XSXVEGI
MRXSXLIWXSVIHTVSKVEQ[MPPFVMRKYTXLI7XSVIH4VSKVEQ)HMXSV [MXL
8)78C463'PSEHIHMRXSMX ERH[MPPLMKLPMKLXXLII\IGYXMSRTSMRX=SY
GERGSRXMRYIHIFYKKMRKEWMJ]SYLEHWXEVXIHXLITVSGIHYVIJVSQXLIWEQI
WIWWMSR 2SXIXLEXXLI8%6+)87502EZMKEXSV[MPPFILERKMRKYRXMPXLI
()&9++)6MRHMGEXIW)\IGYXMSR'SQTPIXIH 
8SHIFYKXLITVSKVEQVITIEXIHP]QSHMJ]XLIFPSGOGVIEXIHEX7XIT
BEGIN
dbms_debug.debug_on;
END




ERHI\IGYXIMXXLIRVITIEXWXITW QSHMJ]MRKXLIZEPYISJTEVEQIXIV
TEWWIHXS8)78C463'MJRIGIWWEV] 
;LIRYWMRKHMJJIVIRXETTPMGEXMSRWXLISRP]HMJJIVIRGIMWXLI[E]XLI
40750FPSGOWEVIWYFQMXXIHJSVI\IGYXMSR-RWXIEHSJX]TMRKERHVYRRMRK
XLIQJVSQ750)HMXSV]SY[MPPTVSFEFP]TVIWWEFYXXSRXLEX[MPPI\IGYXI
XLIFPSGO W 

Setting and viewing breakpoints


=SYGERWIX&VIEOTSMRXWIMXLIVFIJSVI]SYI\IGYXIETVSGIHYVIMRXLIHIFYKKIV
[MRHS[SVHYVMRKI\IGYXMSR
A new and useful feature in this version of SQL
Navigator is its one-click ability to set and modify
breakpoints within the Stored Program Editor.
If debug mode is enabled, clicking in the gutter on
the left side of the text-editing area displays a
Breakpoint properties dialog. Here you can
specify line numbers and break conditions, and
disable or enable breakpoints.

Chapter 6

Working with PL/SQL code

313

To set or clear breakpoints before executing a procedure


1

2
3

8SSTIREWXSVIHTVSKVEQ JSVI\EQTPIETVSGIHYVIJYRGXMSRSV
TEGOEKI PSGEXIXLITVSKVEQMRXLI(&2EZMKEXSV
WXVIIZMI[ERHHSYFPI
GPMGOXLIMGSRXSXLIPIJXSJXLITVSGIHYVIREQI8LITVSGIHYVIETTIEVWMR
ERIHMXMRK[MRHS[
8SWIXFVIEOTSMRXWMRWIZIVEPWXSVIHTVSKVEQWVITIEXWXITXSSTIR
QYPXMTPIIHMXMRK[MRHS[W
8SWIXEFVIEOTSMRXTSWMXMSRXLIGYVWSVSRXLIJMVWXPMRISJERI\IGYXEFPI
WXEXIQIRX
If you Toggle Breakpoint on a line ignored
by the compiler, such as a comment, the
breakpoint will not be set. The debugger
displays an "Unable to Set Breakpoint"
message when execution begins.

'PMGOXLI8SKKPI&VIEOTSMRXFYXXSR

MRXLIXSSPFEVSVTVIWW*

8SVIQSZIEFVIEOTSMRXTSWMXMSRXLIGYVWSVSRERI\MWXMRKFVIEOTSMRX
XLIRGPMGOXLI8SKKPI&VIEOTSMRXFYXXSRMRXLIXSSPFEV
5 'PMGO7EZIXSGSQTMPIXLITVSGIHYVI
;LIRERIHMXSVMWGPSWIHER]FVIEOTSMRXWWIX[MXLMRXLEX[MRHS[VIQEMR
&VIEOTSMRXWI\MWXYRXMP]SYGPIEVXLIQSVGPSWIXLIHEXEFEWIWIWWMSR
4

To set breakpoints during execution


1
2

-RXLIIHMXMRK[MRHS[TSWMXMSRXLIGYVWSVSRXLIJMVWXPMRISJERI\IGYXEFPI
WXEXIQIRX
'PMGOXLI8SKKPI&VIEOTSMRXFYXXSRMRXLIXSSPFEVSVTVIWW*

To display existing breakpoints


1
2

-RXLI(IFYKQIRYWIPIGX0MWX%PP&VIEOTSMRXWSVGPMGOXLI&VIEOTSMRXWXEF
MRXLI)\IGYXMSR7XEXYW[MRHS[
8SHMWTPE]XLIWSYVGIGSHIXLEXGSRXEMRWEWTIGMJMGFVIEOTSMRXHSYFPIGPMGO
XLIVS[MRXLIFVIEOTSMRXPMWX

314

SQL Navigator Users Guide

&VIEOTSMRXWEVIGSPSVIHEWJSPPS[W
 =IPPS[XSHMWXMRKYMWLXLIFVIEOTSMRXPMRIJVSQXLISXLIVPMRIWSJGSHI
 +VIIRJSVXLIFVIEOTSMRXXLEXMWGYVVIRXP]I\IGYXMRK
 +VI]JSVEHMWEFPIHSVMRZEPMHFVIEOTSMRX

Disabling breakpoints
=SYGERHMWEFPIEFVIEOTSMRX[MXLSYXHIPIXMRKMX(MWEFPIHFVIEOTSMRXWSV
MRZEPMHFVIEOTSMRXW XLSWIXLEXXLI(IFYKKIVJEMPIHXSWIX EVIHMWTPE]IHSRE
+VI]FEGOKVSYRHMRWXIEHSJ]IPPS[(MWEFPIHFVIEOTSMRXWEVIMKRSVIHF]XLI
HIFYKKIVHYVMRKI\IGYXMSR8LI]GERFIVIIREFPIHEXEPEXIVXMQI

To disable or enable a breakpoint (Debug menu)


1
2

'LSSWI(IFYK"0MWX%PP&VIEOTSMRXW
7IPIGXXLIFVIEOTSMRXERHXSKKPIXLI)REFPI(MWEFPIFYXXSR

To disable or enable a breakpoint (Execution Status window)


1
2

7IPIGXXLIFVIEOTSMRXMRXLI&VIEOTSMRXWXEFSJXLI)\IGYXMSR7XEXYW
[MRHS[
6MKLXGPMGOXLIRWIPIGXSVHIWIPIGX)REFPIH

Setting conditional breakpoints


2SVQEPP]WIXXMRKEFVIEOTSMRXWYWTIRHWI\IGYXMSRIZIV]XMQIXLIFVIEOTSMRXMW
VIEGLIH8LMWQE]FIMRGSRZIRMIRX[LIRYWIH[MXLMRPSSTWSVJVIUYIRXP]GEPPIH
TVSGIHYVIW8LI(IFYKKIVEPPS[W]SYXSHIJMRIEGSRHMXMSRJSVEFVIEOTSMRXXS
FIEGXMZEXIH*SVI\EQTPI]SYGERVIUYIWXXLEXI\IGYXMSR[MPPWXSTEXE
FVIEOTSMRXSRP][LIRXLIZEPYISJWSQIZEVMEFPII\GIIHWEGIVXEMRPMQMX

Chapter 6

Working with PL/SQL code

315

The breakpoint condition is evaluated before the


breakpoint statement is executed.
Example:
1 CREATE OR REPLACE PROCEDURE DEBUG_ME
AS
2 l_variable BINARY_INTEGER;
3 BEGIN
4 l_variable := 10;
5 END;
If the user sets up a breakpoint on line 4 with a
condition l_variable = 3, the debugger will break
on line 4 regardless of the condition. It does so
because at that point the statement l_variable :=
10 has not been executed, and the condition
l_variable = 3 will not be evaluated correctly

To define or change a conditional breakpoint


1
2
3

'LSSWI(IFYK"0MWX%PP&VIEOTSMRXWERHWIPIGXXLIFVIEOTSMRXJVSQXLI
PMWX
*VSQXLI&VIEOTSMRXQIRYGLSSWI'SRHMXMSR
-RXLI&VIEO'SRHMXMSRHMEPSKIRXIVXLIJSPPS[MRKZEPYIW
Option

Note

:EVMEFPI

7IPIGXSVIRXIVXLI[EXGLZEVMEFPIJSVXLIFVIEOTSMRX

6IPEXMSR

7IPIGXXLIGSQTEVMWSRSTIVEXSVWJVSQXLIHVSTHS[RPMWX
FS\

:EPYI

)RXIVXLIZEPYIXS[LMGLXLIZEVMEFPIMWXSFIGSQTEVIH

'PMGO3/

316

SQL Navigator Users Guide

Controlling code execution in the debugger


;LIRI\IGYXMSRSJETVSGIHYVIMWTEYWIH]SYGERGLSSWIJVSQERYQFIVSJ
STXMSRW 
 7XST GERGIP XLII\IGYXMSR
 7XITTMRKSZIVGSHI
 7XITTMRKMRXSGSHI
 7XITTMRKSYX
 6YRXSGEVIX

Stopping
Use caution when stopping execution. Any
uncommitted changes made by the program may
be lost.

;LIRXLIHIFYKKIVMWTEYWIH]SYGERWXSTXLII\IGYXMSRSJXLIWXSVIH
TVSKVEQEXER]XMQIF]GPMGOMRK7XST

Stepping over code


7XITTMRKSZIVGSHII\IGYXIWEGEPPIHJYRGXMSRSVTVSGIHYVI[MXLMRETVSGIHYVI
[MXLSYXHMWTPE]MRKSVWXSTTMRKEXIEGLPMRISJI\IGYXEFPIGSHIMRXLIWYF
TVSGIHYVI)\IGYXMSRLEPXWEXXLIJMVWXI\IGYXEFPIPMRIEJXIVXLIWYFTVSGIHYVI
=SYGERVIWYQII\IGYXMSRSJXLIVIWXSJXLITVSGIHYVIJVSQXLIVI
%YXSQEXMG7XIT3ZIVEYXSQEXIWXLII\IGYXMSRSJXLIHIFYKKIVF]VITIEXIHP]
TIVJSVQMRK7XITSZIVJYRGXMSREXMRXIVZEPWKSZIVRIHF]XLIZEPYISJHMWTPE]
MRXIVZEP=SYGERYWIXLMWJYRGXMSRXSEYXSQEXIXLII\IGYXMSRSJWXSVIH
TVSKVEQ
=SYGERTEYWIEYXSQEXMGI\IGYXMSRSJXLIHIFYKKIVEXER]XMQIF]GPMGOMRKSR
4EYWI

To step over code


1

2

*VSQXLI(IFYKQIRYSVXSSPFEVGPMGO7XIT3ZIV
%PPXLIGSHIMRXLIWYFTVSGIHYVIMWI\IGYXIHERHXLII\IGYXMSRTSMRX
QSZIWXSERHWXSTWEXXLIRI\XI\IGYXEFPIPMRISJGSHIEJXIVXLIFPSGO
'PMGO6YRXSVIWYQII\IGYXMSRSJXLITVSGIHYVI

Chapter 6

Working with PL/SQL code

317

Stepping into code


7XITTMRKMRXSGSHII\IGYXIWEGEPPIHJYRGXMSRSVTVSGIHYVI[MXLMRETVSGIHYVI
F]HMWTPE]MRKERHWXSTTMRKEXIEGLPMRISJI\IGYXEFPIGSHIMRXLIWYF
TVSGIHYVI=SYQMKLX[ERXXSWXITMRXSGSHIMRSVHIVPSGEXIETVSFPIQMRE
GIVXEMRPMRI=SYGERWXITMRXSGSHISRP]MJXLIWSYVGIGSHIMWEZEMPEFPIXSXLI
HIFYKKIV=SYGERVIWYQII\IGYXMSRSJXLIVIWXSJXLITVSGIHYVIJVSQXLIJMVWX
I\IGYXEFPIPMRIEJXIVEWYFTVSGIHYVI
%YXSQEXMG7XIT-RXSEYXSQEXIWXLII\IGYXMSRSJXLIHIFYKKIVF]VITIEXIHP]
TIVJSVQMRKXLI7XIT-RXSJYRGXMSREXMRXIVZEPWKSZIVRIHF]XLIZEPYISJHMWTPE]
MRXIVZEP=SYGERYWIXLMWJYRGXMSRXSEYXSQEXIXLII\IGYXMSRSJWXSVIH
TVSKVEQW
=SYGERTEYWIEYXSQEXMGI\IGYXMSRSJXLIHIFYKKIVEXER]XMQIF]GPMGOMRKSR
4EYWI

To step into code


1

*VSQXLI(IFYKQIRYSVXSSPFEVGPMGO7XIT-RXS

%PPGSHIMRXLIWYFTVSGIHYVIMWI\TERHIHERHHMWTPE]IHMRXLI(IFYKKIV
[MRHS[8LIHIFYKKIVTEYWIWEXXLIJMVWXPMRISJI\IGYXEFPIGSHIMRXLI
GEPPIHTVSGIHYVI
'PMGO6YRXSVIWYQII\IGYXMSRSJXLITVSGIHYVI

Stepping out
7XITTMRKSYXXEOIW]SYSYXSJXLIGYVVIRXTVSGIHYVIERHMRXSXLISYXIV
TVSGIHYVIXLEXGEPPIHMX

Run to caret
6YRXSGEVIXEPPS[W]SYXSTPEGI]SYVGEVIX XLIFPMROMRKGEVIXRSXXLIFPYI
GYVWSV SRERI\IGYXEFPIPMRIELIEHSJXLIGYVVIRXP]I\IGYXMRKPMRIERHEPPS[
XLITVSGIHYVIXSVYRXSXLEXPSGEXMSR-JXLIGEVIXMWTPEGIHSREPMRIXLEXMWRSX
I\IGYXEFPIWYGLEWEGSQQIRXXLII\IGYXMSR[MPPTEYWIEXXLIRI\XI\IGYXEFPI
PMRI

318

SQL Navigator Users Guide

Evaluating and modifying variables


;LIRI\IGYXMSRSJETVSGIHYVIMWTEYWIHEXEFVIEOTSMRX]SYGERIZEPYEXISV
QSHMJ]ER]WGEPEVZEVMEFPI[MXLMRTVSGIHYVIGSHI-J]SYGLERKIXLIZEPYISJE
ZEVMEFPI]SYGERGSRJMVQXLIRI[ZEPYISJXLIWGEPEVZEVMEFPIF]IZEPYEXMRK
XLIZEVMEFPIEKEMR
 ;LIR]SYIZEPYEXIEZEVMEFPIIRWYVIXLEXSRP]EWMRKPIWGEPEVZEVMEFPIMW
WIPIGXIH
 7IPIGXMRKERI\TVIWWMSR[MPPRSXHMWTPE]HEXEFYX[MPPSGGEWMSREPP]TVSZMHI
MRJSVQEXMSRXLEXQE]FIQMWPIEHMRK*SVI\EQTPIWIPIGXMRKEJYRGXMSR
HMWTPE]WXLIZEPYISJXLIJMVWXWGEPEVZEVMEFPIMRXLIEVKYQIRXPMWXFYXRSX
XLIZEPYISJXLIJYRGXMSR
 ;LIR]SYIZEPYEXIEZEVMEFPIMREGYVVIRXFVIEOTSMRXVIQIQFIVXLEXXLI
GYVVIRXFVIEOTSMRXLEWRSX]IXFIIRI\IGYXIH
 :EVMEFPIZEPYIWMRXLI[EXGL[MRHS[EVIYTHEXIHSRP]EXXLIFVIEOTSMRX
WSWXVEXIKMGEPP]TPEGIFVIEOTSMRXWEJXIVXLI[EXGLZEVMEFPI

To evaluate or modify a variable


 *VSQXLITVSKVEQIHMXMRK[MRHS[TPEGIXLIFPMROMRKGYVWSVSREZEVMEFPI
MRXLITVSGIHYVIGSHI
 'PMGO)ZEPYEXI1SHMJ]:EVMEFPISVTVIWW'XVP*8LIZEPYISJXLIZEVMEFPI
MWHMWTPE]IHMRETSTYT[MRHS[
 8SWIIELMWXSV]SJPEWXZEVMEFPIREQIWGPMGOXLIHVSTHS[RPMWXFS\
 8SQSHMJ]XLIZEPYIIRXIVXLIRI[ZEPYISJXLIZEVMEFPIMR2I[:EPYI
[MRHS[XLIRGPMGO1SHMJ]

Testing variables
8SXIWXXLIIJJIGXSJHMJJIVIRXZEVMEFPIWMR]SYVTVSGIHYVIYWIXLI
)ZEPYEXI1SHMJ]:EVMEFPI[MRHS[
*SVI\EQTPIMJXLITVSGIHYVITIVJSVQWEGSQTYXEXMSR]SYGERWXEVXXLI
TVSGIHYVIIRXIVEWXEVXMRKZEPYIERH[EXGLLS[XLITVSGIHYVILERHPIWXLI
VIWYPX-J]SY[ERXXSWIIE[LEXMJGSQTYXEXMSRIRXIVERI[ZEPYIMRXLI
)ZEPYEXI1SHMJ]:EVMEFPI[MRHS[4IVJSVQXLIWEQITVSGIHYVIERH[EXGLXLI
RI[VIWYPXW

To test the result of a variable


1
2

7IPIGXXLIZEVMEFPIMRXLIHVSTHS[RPMWXFS\
)RXIVERI[ZEPYIMRXLIFSXXSQTSVXMSRSJXLI[MRHS[

3
4

'PMGO+IX:EPYI
'PMGO1SHMJ]XSQSHMJ]XLIZEPYI

Chapter 6

Working with PL/SQL code

319

:MI[XLIVIWYPXSJXLIGSQTYXEXMSRMRXLIQMHHPITSVXMSRSJXLI[MRHS[
If you see an error such as "Not compiled with
debug info" instead of the variable value, you
need to recompile the procedure with the Debug
information and re-execute it in the debugger to
see the value of variables.

Watching CURSOR variables


;LIRIZEPYEXMRK[EXGLMRKEZEVMEFPISJ'96736X]TIMXWZEPYIMWHMWTPE]IH
MRXLIJSPPS[MRKJSVQEX
flags:FFF, rowcount:RRR.

;LIVI
RRR

HIXIVQMRIWXLIRYQFIVSJVIGSVHWJIXGLIHWSJEVF]XLI
I\EQMRIHGYVWSV

FFF

MWEGSQFMREXMSRSJGYVWSVWXEXYWJPEKW
%ISOPEN
%FOUND
%NOTFOUND

-JXLIYWIVIRXIVWXLI[EXGLIHZEVMEFPIREQIWEWC1%NOTFOUND, C1%FOUND,
C1%ISOPEN, C1%ROWCOUNTXLIHMWTPE]IHZEPYIMWXLIWEQIEW[SYPHVIWYPX
JVSQ[EXGLMRKXLIGYVWSVMXWIPJ

Troubleshooting the Debugger


(IFYKKIVTVSFPIQWERHWSPYXMSRW
=SYQE]FIEFPIXSWEZIXMQIXVSYFPIERHI\TIRWIF]VIEHMRKXLIJSPPS[MRK
MRJSVQEXMSRFIJSVIGEPPMRK8IGLRMGEP7YTTSVX

Oracle PL/SQL Error ORA-0600 when starting the Debugger


option
8LMWQE]FIWSPZIHF]MRWXEPPMRKETEXGLJVSQ3VEGPI8[SWGVMTXWEVITVSZMHIH
MRXLI'@463+6%1*-0)7@59)7873*8;%6)@7502EZMKEXSV@MRWXEPP
WYFHMVIGXSV][LMGL[MPPKMZI4%68-%0HIFYKKIVJYRGXMSREPMX]JSV9RM\
MRWXERGIW,S[IZIVXLIEFMPMX]XS[EXGLZEVMEFPIWMWRSXWYTTSVXIHTVMSVXS
9RM\3VEGPI

320

SQL Navigator Users Guide

To install Oracle Patches for Unix


7LYXHS[RXLIHEXEFEWI
-RZSOIXLIWIVZIVQEREKIV WZVQKVP GSRRIGXEWMRXIVREPERHVYR
(&174&40&ERH46:84&40&
6IWXEVXXLIHEXEFEWI

1
2
3

Debugging features support by Oracle


*IEXYVI











ERH
EFSZI

:MI[WIXZEPYIWSJPSGEPZEVMEFPIW

=IW

=IW

=IW

=IW

:MI[WIXZEPYIWSJTEGOEKIKPSFEP
ZEVMEFPIW

2S

2S

=IW

=IW

:MI[GYVWSVZEVMEFPIW

2S

=IW 

=IW

=IW

-RJSVQEXMSRSRTVSGIHYVIWSXLIV
XLERGYVVIRX

2S

=IW


=IW


=IW

:MI[WIXZEPYIWSJMRHI\IH
ZEVMEFPIW

2S

2S

=IW

=IW

7XSTI\IGYXMSR

=IW

=IW

=IW

=IW

EZEMPEFMPMX]ZEVMIWHITIRHMRKSRTPEXJSVQETEXGLQE]FIVIUYMVIH
VIUYMVIW3VEGPI7IVZIVMRMXMEPM^EXMSRTEVEQIXIV
&0%2/C86-11-2+!869)

Limitations of the Debugger option


8LI(IFYKKIVSTXMSRTVSZMHIWHIFYKKMRKGETEFMPMXMIWZMEXLI4VSFI%4-JVSQ
3VEGPI*SVXLMWVIEWSRXLI3VEGPIWIVZIVOIVRIPMWGSQTMPIHWITEVEXIP]JSV
IEGLTPEXJSVQ7SQITVSFPIQWMRXLIHIFYKKIV[MPPFITPEXJSVQWTIGMJMGWSMXMW
MQTSVXERXXSRSXIXLIWIVZIVZIVWMSRERHSTIVEXMRKW]WXIQ-REHHMXMSRXLI
JYRGXMSREPMX]MWTVSZMHIHF]XLI4VSFI%4-[IGERSRP]QSHMJ]XLI+9-
VITVIWIRXEXMSR

Chapter 6

Working with PL/SQL code

321

Prerequisites for running the Debugger option


*SV3VEGPIZIVWMSRSVLMKLIVGSRRIGXMSRXSXLIWIVZIVQYWXFI
IWXEFPMWLIHZME750 2IX\SV2IX-J]SYGSRRIGXXSEPSGEPHEXEFEWISR
;MRHS[WIWXEFPMWLXLIGSRRIGXMSRYWMRKPSSTFEGO8LIHIFYKKIVTEGOEKIW
4VSFI%4-QYWXFIMRWXEPPIHSRXLI3VEGPIWIVZIV[LMGLMWEYXSQEXMGEPP]
EZEMPEFPIJSVEPP3VEGPIZIVWMSRWERHLMKLIV

ORA-04068 and ORA-04067 error messages


8LIWIQIWWEKIWQIERLII\MWXMRKWXEXISJTEGOEKIWLEWFIIRHMWGEVHIHERHXLI
TEGOEKIFSH](&17C()&9+HMHRSXI\IGYXIMJXLIWIVZIVWMHISFNIGXW[IVI
RSXMRWXEPPIHMRXLI7=7WGLIQE'SRXEGX]SYV(&%XSHVST(&17C()&9+
JVSQXLIMRGSVVIGXWGLIQE QE]FIYRHIV7=78)1 ERHVIMRWXEPPYRHIV7=7

Setting up loopback connection on Personal Oracle7 for


Windows
8LI(IFYKKIVVIUYMVIWXLEX]SYGSRRIGXXS]SYV3VEGPIWIVZIVZMEERSR
FPSGOMRKGSRRIGXMSRYWMRK750 2IXZIVWMSRSVLMKLIV;LIRGSRRIGXMRKXS
4IVWSREP3VEGPIXLIGSRRIGXMSRMWYWYEPP]QEHIYWMRKEX[SXEWOGSRRIGXMSR
8LMWMWRSXWYMXEFPI[LIRYWMRKXLIHIFYKKIVWS]SYQYWXYWIEPSSTFEGO
GSRRIGXMSRYWMRK750 2IX*SPPS[XLIWIWXITW
Caution! The listener.ora file must be edited
exactly as shown. Changing the file format could
cause system problems that require additional
technical support.

To set up loopback connection on Personal Oracle7 for Windows


1

'SRJMKYVIXLI750 2IXPMWXIRIV

)HMXXLIPMWXIRIVSVEJMPI[LMGLMWEZEMPEFPIMRXLIRIX[SVOEHQMRHMVIGXSV]
8LIHIJEYPXHMVIGXSV]MW'@SVE[MR@RIX[SVO@EHQMR

322

SQL Navigator Users Guide

Example of the listener.ora:


LISTENER=
(ADDRESS_LIST (PROTOCOL = TCP)
(Host = 127.0.01)
(Port = 1521)
)
STARTUP_WAIT_TIME_LISTENER = 0
CONNECT_TIMEOUT_LISTENER = 10
TRACE_LEVEL_LISTENER = ADMIN
SID_LIST_LISTENER
(SID_LIST
(SID_NAME =ORCL)
)
)

)HMX]SYVXRWREQIWSVEJMPIXSHIJMRIXLIWIVZMGIREQIJSV43;I
VIGSQQIRHXLEX]SYYWI750 2IX)EW]'SRJMKYVEXMSRXSTIVJSVQXLMW
QSHMJMGEXMSR
PO7L.world (DESCRIPTION (ADDRESS_LIST
(COMMUNITY =tcp.world)
(PROTOCOL = TCP)
(Host = 127.0.0.1)
(Port = 1521)
)
)
(CONNECT_DATA = (SID = ORCL)
)
)

(SID_DESC

(ADDRESS

)RWYVIXLEXXLI7502)836%JMPIMWWEZIHMRXLIRIX[SVO@EHQMR
HMVIGXSV]9WYEPP]XLI7502)836%JMPI[MPPGSRXEMRXLIJSPPS[MRK
AUTOMATIC IPC = OFF
TRACE_LEVEL_CLIENT = OFF
Names.directory_path = (TNSNAMES)
Names.default_zone = world

5
6

7XEVXXLI750 2IXPMWXIRIV
3TIRE(37[MRHS[

8]TIPWRVGXPWXEVX=SYQYWXWXEVXXLIPMWXIRIVIEGLXMQI]SYVIFSSXXLI
QEGLMRI
3TIR7502EZMKEXSVERHGSRRIGXXS43ERHXLIGSRRIGXWXVMRK40
-J]SYIRGSYRXIVTVSFPIQWWXEVXMRKXLIPMWXIRIVSVGSRRIGXMRKXSXLIPSGEP
HEXEFEWIGLIGOXLIJSPPS[MRK

8
9

Chapter 6

Working with PL/SQL code

323

 )RWYVIXLEX]SYMRWXEPPIHXLI750 2IXGSQTSRIRXW[MXL4
 6YRXLI3VEGPIMRWXEPPIVERHGLIGOJSVXLIMRWXEPPIHGSQTSRIRXW
'LIGOJSVXLI750 2IX%HHSR\\ERH3VEGPI8'4-4EHETXIV
\\

Server-side packages supplied with SQL Navigator


3VEGPIERHLMKLIV(SRSXMRWXEPPXLIWYTTPMIHTEGOEKIWFIGEYWIXLI]EVI
TVIMRWXEPPIHSRXLIWIVZIV-J]SYI\IGYXIXLIWIWGVMTXWF]QMWXEOIVIWXSVIXLI
SVMKMREPTEGOEKIWF]I\IGYXMRKXLIWGVMTXWEZEMPEFPIMRXLIVHFQW@EHQMR
HMVIGXSV]SJ]SYV3VEGPIWIVZIVWYFHMVIGXSV]

Compatibility with PL/SQL


8LI(IFYKKIVSTXMSRMWGSQTEXMFPI[MXLXLIQSWXGYVVIRXZIVWMSRSJ40750

Evaluating and setting variable values


9WMRKXLI(IFYKKIV]SYGER)ZEPYEXIERHWIXYTZEVMEFPIZEPYIWJSVWGEPEV
ZEVMEFPIWHYVMRKWXSVIHTVSKVEQI\IGYXMSRMRGPYHMRK:EVGLEV'LEV2YQFIV
FMREV]CMRXIKIVHEXIIXG

To debug database objects owned by other schemas


9WIVWQYWXLEZIXLIJSPPS[MRKTIVQMWWMSRWXSYWIXLIHIFYKKIV
ALTER ANY PROCEDURE XSGSQTMPI 
CREATE ANY PROCEDURE XSIHMXWEZIVITPEGII\MWXMRKSFNIGXW 
ALTER SESSION
CREATE SESSION

Debugging with breakpoints, watches, evaluating variables


=SYGERYWIXLI7XSVIH4VSKVEQ)HMXSVXSWIXFVIEOTSMRXWERH[EXGLIWERHXS
)ZEPYEXISVQSHMJ]XLIZEPYISJZEVMEFPIWHYVMRKXLIHIFYKKMRKWIWWMSR

To turn on PL/SQL Debugging,


'PMGO
SRXLI7IWWMSRXSSPFEV
3V
'LSSWI40750(IFYKKMRK3RJVSQXLI7IWWMSRQIRY

324

SQL Navigator Users Guide

Debugger quick reference


8LMWKVSYTSJXSTMGWTVSZMHIWFEWMG,S[8SMRJSVQEXMSRJSVYWMRKXLI40750
(IFYKKIV

To continue execution to the first executable line of a procedure


or trigger (or to the next line of the current procedure)
 'PMGOXLI8VEGIMRXSFYXXSR



To debug code run from an external application


1

*MVWXXLII\XIVREPETTPMGEXMSRQYWXMRMXMEPM^I(IFYKQSHI

-R7502EZMKEXSVGSRRIGXXSXLIWEQI(&MRWXERGIEWXLII\XIVREP
ETTPMGEXMSR
7IX40750(IFYKKMRK32
-R7502EZMKEXSVJVSQXLI(IFYKQIRYWIPIGX%XXEGL)\XIVREP7IWWMSR

3
4
5

-RXLI%XXEGLHMEPSKIRXIVXLIWEQI7IWWMSR-(EWTEWWIHXSSVVIXYVRIHF]
XLIinitializeWXEXIQIRX7502EZMKEXSV[MPPXLIR[EMXJSVXLI
ETTPMGEXMSRXSI\IGYXI40750GSHI
*VSQXLIETTPMGEXMSRI\IGYXIXLI40750FPSGOXLEXGEPPWXLIWXSVIH
TVSKVEQXSFIHIFYKKIH7502EZMKEXSVHMWTPE]WXLI)\IGYXMSR7XEXYW
[MRHS[ERHIREFPIWEPPHIFYKKMRKGSQQERHW 

To display watches for a program unit


1

7IPIGXERMXIQMRXLI)\IGYXMSR7XEGOTERI 

*VSQXLI)\IGYXMSR7XEGOTERISTIRTVSKVEQWSYVGIMRXLI7XSVIH
4VSKVEQSV8VMKKIV)HMXSV
(SYFPIGPMGOSRERMXIQMR)\IGYXMSR7XEGOTERI8LMW[MPPWIXXLIXI\X
GYVWSVEXXLIPMRIWLS[RMRXLIGEPPWXEGO

To execute the current line without tracing into an associated


trigger trigger
 'PMGO7XIT3ZIV'SHIFYXXSR



Chapter 6

Working with PL/SQL code

325

To include debug information in the compiled procedure


1
2

7XEVXXLIHIFYKKIVERHXSKKPI-RGPYHI(IFYK-RJSSRXLI7IWWMSRQIRY
'LSSWISRISJXLIJSPPS[MRK
 ;MXLXLIHIFYKKIVWXEVXIHSTIRXLIWXSVIHTVSKVEQMRXLI4VSGIHYVI
IHMXSVERHWEZIMX
SV
 -RXLI(&2EZMKEXSV[MRHS[VMKLXGPMGOXLITVSGIHYVIXLIRWIPIGX
'SQTMPIJVSQXLIWLSVXGYXQIRY

To initiate debugging
 'LSSWISRISJXLIJSPPS[MRK
 'PMGOXLI40750(IFYKKMRK FYXXSRMRXLI7IWWMSRXSSPFEV
SV
 'LSSWIER]SJXLIHIFYKKMRKGSQQERHWEZEMPEFPIJVSQXLI
(IFYKKIVXSSPFEVSVXLI(IFYKQIRY[LMPIE7XSVIH4VSKVEQMW
STIR
SV
 -RXLI7XSVIH4VSKVEQ)HMXSVSVXLI(&2EZMKEXSVI\IGYXIEWXSVIH
TVSKVEQ[LIR40750(IFYKKMRKMWSR
SV
 *VSQXLI750)HMXSV[LIR40750(IFYKKMRKMWSRVYRER
ERSR]QSYW40750FPSGO WXYF SVEXVMKKIVMRZSGEXMSRFPSGO

To modify a variable
1
2

,MKLPMKLXSVWIXXLIGYVWSVEXXLIZEVMEFPIREQIMRXLIIHMXSV[MRHS[
'LSSWI)ZEPYEXI1SHMJ]:EVMEFPIJVSQXLIWLSVXGYXQIRY

To pause automatic execution


 'PMGOXLI4EYWIFYXXSR 

To repeatedly perform the Step over function at intervals


 7IXXLIZEPYISJXLIHMWTPE]MRXIVZEPERHGPMGOXLI%YXSQEXMG7XIT3ZIV
FYXXSR



326

SQL Navigator Users Guide

To repeatedly perform the Trace Into function at a set interval


 7IXXLIZEPYISJXLIHMWTPE]MRXIVZEPERH'PMGOXLI%YXSQEXMG8VEGI-RXS
FYXXSR



To run other sessions while debugging


 %JXIVWXEVXMRKEHIFYKWIWWMSRGSRXMRYIRSVQEP[SVOMR7502EZMKEXSV

To run to cursor location.


 4PEGIXLIFPMROMRKGYVWSVSRERI\IGYXEFPIPMRIELIEHSJXLIGYVVIRXP]
I\IGYXMRKPMRIXLIRGPMGOXLI6YRXS'YVWSVFYXXSR



To set a breakpoint in your code


 ;LIRXLI7XSVIHTVSKVEQSV8VMKKIVIHMXSVMWEGXMZIGPMGOXLI&VIEOTSMRX
XSSPFEVFYXXSR

To set breakpoints from an editor


 'LSSWI(IFYK"8SKKPI&VIEOTSMRXW

To set debugging options


 +SXS:MI[ 4VIJIVIRGIW +IRIVEPERHWIPIGXHIFYKKIVSTXMSRWSRXLI
7IWWMSRXEF

To set watches
 'LSSWISRISJXLIJSPPS[MRK
 -RXLI7XSVIH4VSKVEQ)HMXSVWIPIGXEZEVMEFPIXLIRGLSSWI%HH
;EXGL
SV
 -RXLI(&2EZMKEXSVWIPIGXEREVKYQIRXSJETVSGIHYVISVJYRGXMSR
ERHGLSSWI(IFYK"0MWX%PP;EXGLIW
SV
 -RXLI%GXMZI;EXGLIWTERISJXLI7XEXYW[MRHS[GLSSWI%HHSV
TVIWWXLI-RWOI]

Chapter 6

Working with PL/SQL code

327

To step out of the current procedure and into the outer


procedure that called it
 'PMGOXLI7XITTMRKSYXFYXXSR



To stop the execution of the stored program


 'PMGOXLI7XST)\IGYXMSRFYXXSRSRXLI7IWWMSRXSSPFEV[LIRXLIHIFYKKIV
MWTEYWIH



To view current execution point


 (SYFPIGPMGOXLIXSTMXIQSJXLIGEPPWXEGOMRXLI7XEXYW[MRHS[

To view current values of variables


 ;LIRI\IGYXMSRSJETVSGIHYVIMWTEYWIHEXEFVIEOTSMRXTPEGIXLIGYVWSV
SZIVXLIZEVMEFPI
WREQIMRXLIIHMXSV[MRHS[
8LIZEPYISJXLIZEVMEFPIETTIEVWMRELMRX[MRHS[FIPS[SVEFSZIXLIQSYWI
TSMRXIVERHEPWSMRXLIQEMR[MRHS[
WWXEXYWFEV

To view the current execution stack and all breakpoints and


watches
1
2

*VSQXLI7XSVIH4VSKVEQ)HMXSVSV8VMKKIV)HMXSVWXEVXE40750FPSGOMR
(IFYKQSHI
-JXLI)\IGYXMSR7XEXYW[MRHS[MWRSXWLS[RGLSSWI(IFYK"7LS[7XEXYW
;MRHS[

7
Working with HTML and Java

8LMWGLETXIVI\TPEMRWLS[]SYGERTVSHYGI,810SYXTYXFEWIHSRHEXEFEWI
GSRXIRXWF]KIRIVEXMRKTEGOEKIWGSRXEMRMRK,810GSHI[MXLIQFIHHIH
40750WXEXIQIRXW
-XEPWSI\TPEMRWLS[]SYGER[SVO[MXL.EZEWSYVGISFNIGXW

In this chapter
Creating HTML pages
Working with Java

330
337

330

SQL Navigator Users Guide

Creating HTML pages


Oracle Web Development
7502EZMKEXSV
W;IF(IZIPSTQIRXQSHYPITVSZMHIWERMRXIKVEXIH
HIZIPSTQIRXIRZMVSRQIRX[MXLEHZERGIHGSHMRKXIWXMRKERHZMI[MRKSJ
40750TVSKVEQWJSVXLI3VEGPI;IFWIVZIV-XMRGPYHIWE[IFWIVZIVW]RXE\
XSSPERMRXIKVEXIH,810FVS[WIVER,810XS40750GSRZIVXIVERH
GSRXI\XWIRWMXMZILIPTJSV[IFWIVZIVJYRGXMSRW8LMWEPPS[WYWIVWXSHIZIPST
XLI40750GSHIMRHITIRHIRXSJXLI[IFWIVZIVERHZMI[XLI,810MRER
MRXIKVEXIH[IFFVS[WIVXLIVIF]IPMQMREXMRKXLIRIIHXSW[MXGLJVSQXLIMV
GSHMRKIRZMVSRQIRXXSERI\XIVREPFVS[WIV
(IZIPSTMRK3VEGPI;IFWIVZIVETTPMGEXMSRWMRZSPZIWTVSKVEQQMRK[MXL
40750YWMRKXLI40750;IFXSSPOMXWYTTPMIH[MXL3VEGPI;IF7IVZIV
7502EZMKEXSV
W;IF(IZIPSTQIRXQSHYPIQEOIWMXTSWWMFPIJSV]SYXSGVIEXI
TEGOEKIWGSRXEMRMRK,810GSHI[MXLIQFIHHIH40750WXEXIQIRXW;LIRE
TEGOEKISJXLMWX]TIMWI\IGYXIHVIWYPXWIXWGERFIMRGPYHIHMRXLI,810
SYXTYX

Coding Web Server procedures


7502EZMKEXSVTVSZMHIWERMRXIKVEXIHWXSVIHTVSKVEQIHMXMRKIRZMVSRQIRX
XLEXMRGPYHIW
 ERIHMXSV[MXLW]RXE\LMKLPMKLXMRK
 TVSKVEQQEFPIOI]W
 HVEKERHHVSTGSHMRK[MXL40750W]RXE\
 HVEKERHHVSTGSHMRKJSV;IFXSSPOMXTEGOEKIWMRGPYHMRKLXTERHLXJ
MXIQW
%PWSEZEMPEFPIMWERMRXIKVEXIHGSQTMPIV[LMGLTVIGMWIP]MRHMGEXIWXLIPSGEXMSR
SJGSQTMPEXMSRIVVSVW

Integrated HTML viewer


=SYGERZMI[XLI,810MRERMRXIKVEXIHZMI[IVXLIVIF]IPMQMREXMRKXLIRIIH
XSW[MXGLJVSQ]SYVGSHMRKIRZMVSRQIRXXSERI\XIVREPFVS[WIV8LI
MRXIKVEXIHWIVZIVWMHI40750HIFYKKIVGERFIYWIHXSHIFYK;IFWIVZIV
TVSGIHYVIWERHPIXW]SYlWXITzXLVSYKLXLITVSGIHYVIW[LMPIXLI,810GSHI
MWKIRIVEXIH

Chapter 7

Working with HTML and Java

331

Viewing HTML output


3RGI;IF7YTTSVXMWIREFPIHIEGLXMQI]SYKIRIVEXI40750GSHIXLI
,810MWI\IGYXIHERHXLISYXTYXHMWTPE]IHMREFVS[WIV[MRHS[-JXLI
40750TVSGIHYVIMWVYRYRHIVXLIHIFYKKIVXLI,810SYXTYXMWRSXZMWMFPI
YRXMPXLITVSGIHYVIMWGSQTPIXI
=SYGEREPWSWIPIGXPMROWERHWYFQMXJSVQWJVSQXLIFVS[WIV[MRHS[-JXLI
PMROSVWYFQMXXEVKIXMWERSXLIV40750KIRIVEXIHTEKIXLIRXLEXTEKIETTIEVW
MRXLIFVS[WIV[MRHS[-JMXMWERI\XIVREPPMROERIVVSVQIWWEKI[MPPETTIEV
=SYQYWXWTIGMJ]]SYV;IF7IVZIVGSRJMKYVEXMSREWHIWGVMFIHMRXLMWWIGXMSR
YRHIV7IXXMRKYT0SGEP-QEKI(MVIGXSVMIWMRSVHIVJSVXLMWXS[SVOGSVVIGXP]

The external browser


-JXLI9WI)\XIVREP&VS[WIVSTXMSRMWWIPIGXIH7502EZMKEXSV[MPPWXEVX]SYV
;IFFVS[WIVERHHMWTPE]XLIKIRIVEXIHTEKIMR]SYVFVS[WIVMRWXIEHSJXLI
MRXIVREPTVIZMI[FVS[WIV
8LMWMWYWIJYPJSVXIWXMRKPMROWXSTEKIWXLEXEVIRSX40750KIRIVEXIH750
2EZMKEXSV[MPPQETMQEKIWEWHIJMRIHMRXLI;IF7YTTSVX'SRJMKYVEXMSRFYX
XLMWQETTMRK[MPPSRP]ETTP]XSXLIKIRIVEXIHTEKI%PPPMROWJVEQIWSYVGIW
ERH]SYVFVS[WIVERH;IFWIVZIVRSX7502EZMKEXSV[MPPLERHPIJSVQ
TSWXMRK
7502EZMKEXSVHIXIVQMRIW[LMGLFVS[WIVXSYWIF]XLITVSKVEQEWWSGMEXIH
[MXLD,81
I\XIRWMSRWMR]SYV;MRHS[WVIKMWXV]

Requirements for using SQL Navigator Web support


-RSVHIVXSYWI7502EZMKEXSVkW;IF7YTTSVX]SYQYWXMRWXEPPXLI40750
;IF8SSPOMXJSVXLIWGLIQEXLEX]SY[MPPFIYWMRK*SPPS[XLIWIWXITWXSMRWXEPP
XLI3VEGPI;IF7IVZIVXSSPOMX6IJIVXS]SYV3VEGPIHSGYQIRXEXMSRMJ]SY
VIUYMVIEHHMXMSREPLIPT
&IJSVI]SYFIKMR
 )RWYVIXLEX]SYV3VEGPIYWIVLEWCONNECTERHRESOURCETVMZMPIKIW
 )\IGYXIXLIOWAINS.SQLWGVMTX[LMGLGERFIJSYRHMRXLIEHQMR@S[W
HMVIGXSV]8LMW[MPPMRWXEPPEPPSJXLI40750;IF8SSPOMXTEGOEKIW
If the Web Toolkit packages have already been
installed for another user in your database, you
can save storage space and improve performance
by creating synonyms for the packages under
your schema. You can also grant execute
permission for your user from the schema in
which the Web toolkit packages are installed.

332

SQL Navigator Users Guide

Setting up Web Development support


-RSVHIVXSZMI[MQEKIWERHJSPPS[L]TIVPMROWMR]SYVHSGYQIRX]SYQYWX
IRXIVXLIHIXEMPWEFSYX]SYV;IFWIVZIV
WGSRJMKYVEXMSRMR7502EZMKEXSV

Enabling Web Development support


8LI(&173YXTYX[MRHS[MWRSXHMWTPE]IH[LIR;IF(IZIPSTQIRXWYTTSVX
MWJMVWXW[MXGLIHSRLS[IZIV(&173YXTYXMWIREFPIH
%HMEPSKETTIEVW[LIR;IF(IZIPSTQIRXWYTTSVXLEWFIIRIREFPIHMRXLI
GYVVIRXWIWWMSR

To set up Web Development support options


1

*VSQXLI7IWWMSRQIRYGPMGO;IF'SRJMKYVEXMSR

;LIRXLI;IF7YTTSVX'SRJMKYVEXMSRHMEPSKETTIEVWIRXIVXLI;IF
7IVZIV2EQI8LIWIVZIVREQIMWYWIHXSVIWSPZI960WERHJSVJMRHMRK
MQEKIWSRXLIWIVZIV
7TIGMJ]XLIPMWXIRMRKTSVXJSV]SYV;IF7IVZIVMJMXMWHMJJIVIRXJVSQXLI
HIJEYPX[LMGLMW
'PMGO-QEKIWSR0SGEP(VMZIXSYWIMQEKIWJVSQEPSGEPHVMZIVEXLIVXLER
JVSQ]SYV;IFWIVZIV8LMWEPPS[W]SYXSHIZIPSTTEKIWMRHITIRHIRXP]SJ
XLI;IF7IVZIVTVSZMHMRKXLI40750;IF8SSPOMXMWMRWXEPPIHMR]SYV
PSGEPHEXEFEWI
=SYQE]STXMSREPP]QETZMVXYEPMQEKIHMVIGXSVMIWXS]SYVPSGEPHVMZIF]
WIPIGXMRKXLI1ET-QEKI:MVXYEP4EXLWXS0SGEP(VMZISTXMSR8LIHVMZI
ERHHMVIGXSV]]SYWTIGMJ]JSVXLIPSGEPMQEKIHMVIGXSV][MPPFIYWIHEWXLI
FEWIJSVXLIWITEXLW-JXLMWSTXMSRMWRSXWIPIGXIHXLIMQEKIWWLSYPHVIWMHI
MRXLIXSTPIZIPSJXLMWHMVIGXSV]
7TIGMJ]XLIZMVXYEPTEXLWXLEX]SYEVIYWMRKJSVXLI40750EKIRXSR]SYV
;IFWIVZIVMR(IJMRIH40750:MVXYEP4EXLW7502EZMKEXSVYWIWXLIWIXS
VIWSPZI[LMGL960WVIJIVXS40750KIRIVEXIHTEKIW

3
4

Chapter 7

Working with HTML and Java

333

Setting Options
=SYGERYWIXLIFYXXSRWEXXLIFSXXSQSJXLI[MRHS[XSWEZIERHPSEH
GSRJMKYVEXMSRSTXMSRWERHWIXHIJEYPXSTXMSRW
Option

Description

7IXEW(IJEYPX

8LIGYVVIRXP]HIJMRIHSTXMSRW[MPPFIPSEHIH[LIR;IF
(IZIPSTQIRXWYTTSVXMWMRMXMEPM^IHMREREGXMZIWIWWMSR

6IWXSVI(IJEYPXW

9WIMJ]SYLEZIGLERKIHXLISTXMSRWERH[MWLXSVIXYVR
XSXLITVIZMSYWHIJEYPXZEPYIW8LIHIJEYPXZEPYIWEVI
WXSVIHMRXLI[IFSTXMSRGJKJMPIMRXLI7502EZMKEXSV
MRWXEPPEXMSRHMVIGXSV]=SYGEREPWSWEZIERHPSEHZEPYIW
JVSQYWIVHIJMRIHJMPIWXSGSRJMKYVI7502EZMKEXSVJSV
WIZIVEPHMJJIVIRX;IF7IVZIVGSRJMKYVEXMSRW

0SEHJVSQ*MPI

0SEHWXLIGSRJMKYVEXMSRHEXEJVSQETVIZMSYWP]WEZIH
JMPI

7EZIXS*MPI

7EZIWXLIGSRJMKYVEXMSRHEXEXSEYWIVHIJMRIHJMPI

Starting the Web Server


;LIR]SYJMVWXPSKMRXS7502EZMKEXSVXLI;IFWIVZIVMWRSXIREFPIHJSVYWI

To start the Web server


'PMGOXLI'ETXYVI;IF3YXTYXFYXXSRSRXLI7502EZMKEXSV7IWWMSRXSSPFEV
 'ETXYVI;IF3YXTYXFYXXSR
7502EZMKEXSVXLIRZIVMJMIWXLEXXLI;IF8SSPOMXMWMRWXEPPIHERHZMWMFPIXS
XLMWWGLIQEERHHMWTPE]WXLI3YXTYX[MRHS[

To generate HTML from a stored procedure


1
2


3

)REFPIXLI;IF7IVZIVSTXMSRF]GPMGOMRKXLI'ETXYVI;IF3YXTYXFYXXSR
SRXLI7IWWMSRWXSSPFEV
6MKLXGPMGOXLITVSGIHYVIREQIERHGLSSWI)\IGYXIJVSQXLIWLSVXGYX
QIRYSVTVIWW*SVGPMGOXLI)\IGYXI750FYXXSRXSVYR]SYVWGVMTX
8LIXVERWPEXIH,810TEKIETTIEVWMRXLI3VEGPI;IFFVS[WIV
9WIXLIHVEKERHHVSTJIEXYVIEW]SY[SYPHJSVER]WGVMTXHIZIPSTQIRX
8LI;IF7IVZIV7]RXE\EPPS[W]SYXSHVEK;IFWIVZIVW]RXE\HMVIGXP]MRXS
]SYVWGVMTX8LIVIWYPXWSJHVEKKMRKERHHVSTTMRKW]RXE\MRXS]SYV
TVSKVEQEVIHMWTPE]IH
'SQTMPIERHWEZI]SYVWGVMTX

334

SQL Navigator Users Guide

Saving an HTML source file


-JXLI;IFFVS[WIV[MRHS[MWEGXMZIXLIKIRIVEXIH,810GERFIWEZIHXSE
JMPI

To save an HTML file


1
2

*VSQXLI*MPIQIRYGPMGO7EZI%W
7IPIGXXLIJMPIREQI)RXIVXLIREQI[MXLXLI,81I\XIRWMSR

'PMGO3/

To view an HTML file


-RXLI;IF7YTTSVXQIRYGPMGO:MI[7SYVGI

Resolving URLs in the HTML Preview browser


8LI,810TVIZMI[FVS[WIVMWHIWMKRIHJSVTVIZMI[MRK40750KIRIVEXIH
TEKIW-XMWRSXHIWMKRIHJSVKIRIVEP-RXIVRIXFVS[WMRK-X[MPPEXXIQTXXS
VIWSPZIXLSWI960WXLEXVIJIVXSSXLIV40750KIRIVEXIHTEKIWERHHMWTPE]
XLSWITEKIWSRP]
SQL Navigator parses and manipulates generated
HTML to perform the mapping necessary for
image handling. To ensure that all relative links
will work, SQL Navigator will also add or
manipulate a <BASE> tag for pages generated for
viewing in the external browser.

7502EZMKEXSVYWIWXLIQIXLSHWHIWGVMFIHLIVI[LIRER]SJXLIJSPPS[MRK
SGGYVW
 -XEXXIQTXWXSVIWSPZI960WJSVJVEQIGSRXIRXW
 =SYGPMGOEL]TIVPMRO
(EXEMWTSWXIHJVSQEJSVQ

Resolving Relative URLs


8LIVIPEXMZI960HIWGVMFIWXLIPSGEXMSRSJXLIXEVKIXJMPI[MXLVIJIVIRGIXSXLI
JMPIGSRXEMRMRKXLEX960*SVI\EQTPIMRXLI960
http://www.quest.com/navigator_pro.html

XLIVIPEXMZI960MW
navigator_pro.html

Chapter 7

Working with HTML and Java

335

%VIPEXMZI960QE]EPWSGSRXEMRETEXLVIPEXMZIXSXLIHMVIGXSV]XLIGYVVIRX
HSGYQIRXMWMRSVSRXLIWEQIWIVZIVEWXLIGYVVIRXHSGYQIRX
-JXLIVIPEXMZI960VIJIVWXSEWMRKPIREQISVEUYEPMJMIHREQIXLEXQE]VIJIV
XSE40750TVSGIHYVISVTEGOEKI7502EZMKEXSV[MPPXV]XSVYRXLEX
TVSGIHYVIMRXLIWGSTISJXLIGYVVIRXWGLIQE-JXLIVIUYMVIHTVSGIHYVIMWRSX
JSYRHERIVVSV[MPPFIHMWTPE]IH
-RXLSWIVIPEXMZI960WXLEXMRGPYHIETEXL7502EZMKEXSV[MPPXV]XSVIXVMIZI
XLIHSGYQIRXSRP]MJXLITEXLQEXGLIWSRIPMWXIHMRXLIGSRJMKYVEXMSRJSV
(IJMRIH40750:MVXYEP4EXLW-JXLITEXLMWRSXHIJMRIHERIVVSVQIWWEKI[MPP
FIHMWTPE]IH

Resolving Absolute URLs


%REFWSPYXI960WLS[WXLIGSQTPIXITEXLXSXLIJMPIMRGPYHMRKXLITVSXSGSP
ERHWIVZIVREQIERHTSWWMFP]XLITSVX7502EZMKEXSV[MPPXV]XSVIWSPZIER
EFWSPYXI960SRP]MJMXVIJIVWXSXLIWIVZIVHIJMRIHMRXLIGSRJMKYVEXMSR
STXMSRW3XLIV[MWIERIVVSV[MPPFIHMWTPE]IH

Printing a Web page


;LIRXLIMRXIVREPFVS[WIV[MRHS[MWHMWTPE]IH]SYGERTVMRXXLIGYVVIRX
;IFTEKI 

To print a web page


1
2

'PMGOXLI*MPIQIRY
7IPIGX4VMRX8LIGYVVIRXTEKIMWTVMRXIHXS]SYVEWWMKRIHTVMRXIV

Converting an HTML file into a PL/SQL stored


procedure
7502EZMKEXSVGERGSRZIVXER,810JMPIMRXSE40750WXSVIHTVSGIHYVI
8LIWXSVIHTVSGIHYVI[MPPMRXYVRSYXTYXXLI,810GSHIZMEXLI3VEGPI;IF
'EVXVMHKI8LI;IF(IZIPSTQIRX1SHYPIGER 
 GETXYVIXLISYXTYXSJXLIIQFIHHIHLXTTEGOEKI[LIRXLI40750WXSVIH
TVSGIHYVIMWI\IGYXIH
 HMWTPE]XLMWMREGLSMGISJMRXIVREP,810PE]SYXGSQTSRIRXSVI\XIVREP
FVS[WIV
8SHSXLMWYWIXLI-QTSVX,810JMPIEW40750GSQQERHSRXLI8SSPW
QIRY 2SXIXLEX]SYQYWXLEZIXLI7502EZMKEXSV;IF(IZIPSTQIRX
1SHYPIIREFPIHERHXLI7XSVIH4VSKVEQ)HMXSVWLSYPHFISTIR

336

SQL Navigator Users Guide

8LIMQTSVXTVSGIWW[VETWIEGLPMRISJXLIMQTSVXIH,810JMPIMRWMHIXLI
htp.print ( ); QEVOIVW
40750WXEXIQIRXWGERFIIQFIHHIHMR,810GSHIMRWMHIGSQQIRXWJSV
I\EQTPI
<!--PLSQL a_random_plsql_statement; -->

8LIWIGSQQIRXWQYWXWXEVX[MXLXLIWXVMRK
<!--PLSQL

ERHIRH[MXL
-->

=SYGERTYXXLMRKWMRXLIHIGPEVEXMSRWIGXMSRSJXLITVSGIHYVI XSHIGPEVIE
GYVWSVJSVI\EQTPI F]IRWYVMRKXLI]GSQIJMVWXMRXLIJMPIFIJSVIXLIJMVWX
,810"XEK*SVI\EQTPI
<!PLSQL
CURSOR emp_cur IS
SELECT ename
FROM emp;

To convert HTML to a PL/SQL stored procedure


1
2
3
4

*VSQXLI:MI[QIRYGPMGO:MWYEP3FNIGX)HMXSVERHXLIRGLSSWI7XSVIH
4VSKVEQ)HMXSV
;MXLXLI7XSVIH4VSKVEQ)HMXSVSTIRVIXYVRXSXLIQEMRQIRYFEVERH
JVSQXLI8SSPWQIRYGLSSWI-QTSVX,810EW40750
-RXLI3TIR,810*MPI[MRHS[TSMRXXSXLI,810JMPI]SY[ERXXS
MQTSVX
;LIRXLI,810JMPIETTIEVWIQFIHHIHMRE40750WXSVIHTVSGIHYVI
]SYGERIHMXMX MJRIGIWWEV] ERHWEZIMX

Chapter 7

Working with HTML and Java

337

Working with Java


8LMWZIVWMSRSJ7502EZMKEXSVTVSZMHIWEGSRZIRMIRXWIXSJXSSPWJSV[SVOMRK
[MXL.EZEWSYVGIGSHI*SVKIRIVEPMRJSVQEXMSREFSYXYWMRK.EZE[MXL
3VEGPIMVIJIVXSXLIOracle8i Java Developers Guide[LMGLMWEGGIWWMFPI
SRPMRIXLVSYKLXLI3VEGPI;IFTEKIW
7502EZMKEXSV
W.EZEXSSPWIXQEOIMXIEWMIVJSV]SYXS
 :MI[.EZEVIPEXIHSFNIGXW WSYVGIWGPEWWIWVIWSYVGIW MRXLI(&2EZMKEXSV
[MRHS[
 (VST.EZEVIPEXIHSFNIGXWJVSQXLI(&2EZMKEXSV[MRHS[
 'SQTMPI.EZESFNIGXWJVSQXLI(&2EZMKEXSV[MRHS[
 )HMX.EZEWSYVGIWXSVIHMRXLIHEXEFEWIYWMRKE.EZE)HMXSV
 )\XVEGX750((0SJ.EZE7SYVGIZMEXLI)\XVEGX((0GSQQERH
 0SEH.EZEGPEWWIWYWMRKXLI3VEGPI0SEH.EZEYXMPMX]
 (VST.EZEGPEWWIWYWMRKXLI3VEGPI(VST.EZEYXMPMX]
 4YFPMWL.EZEXS40750YWMRKE[M^EVH
 0SEH.%6ERH>-4EVGLMZIWMRXSXLIHEXEFEWI

Using the Java Editor


8LI7502EZMKEXSV.EZE)HMXSVKMZIW]SYXLIJSPPS[MRKGETEFMPMXMIW 
 0SEHE.EZEWSYVGIJMPIJVSQXLIHEXEFEWIMRXSXLIIHMXSV
 'VIEXIERI[.EZEWSYVGIJMPI
 'PSRIERI\MWXMRK.EZEWSYVGI
 :MI[ERHIHMX.EZEWSYVGI[MXLGSPSVW]RXE\LMKLPMKLXMRK
 'SQTMPIXLI.EZESFNIGX
 7EZIXLI.EZEGPEWWXSXLIHEXEFEWI
8SWIIXSSPXMTWHIWGVMFMRKXLIXSSPFEVFYXXSRWWMQTP]TSMRXXSXLIQ

To open the Java Editor


 *VSQXLI:MI[QIRYGLSSWI:MWYEP3FNIGX)HMXSVERHXLIRGLSSWI.EZE
)HMXSV
SV
 3TIRE.EZEWSYVGISFNIGXJVSQXLIHEXEFEWI WII*MRHMRK3FNIGXW5YMGOP]
JSVHIXEMPW 

338

SQL Navigator Users Guide

Using the Java Manager to load and unload Java objects


8LI7502EZMKEXSV.EZE1EREKIVMWEGSRZIRMIRXEPXIVREXMZIXSYWMRKXLI
3VEGPI0SEH.EZEERH9RPSEH.EZEGSQQERHPMRIYXMPMXMIW=SYGERYWIXLI.EZE
1EREKIVXSPSEHERHYRPSEHQYPXMTPI.EZEWSYVGIJMPIWGPEWWIWVIWSYVGIWERH
EVGLMZIW 
=SYYWIXLI%HHERH6IQSZIFYXXSRWXSIHMXXLIPMWXSJXLISFNIGXWXSFI
PSEHIH
8LISXLIVSTXMSRWEZEMPEFPIVIPEXIXSXLIGSQQERHPMRIW[MXGLIWJSYRHMRXLI
3VEGPI0SEH.EZEERH9RPSEH.EZEGSQQERHPMRIYXMPMXMIW*SVHIXEMPWGSRWYPX
3VEGPIHSGYQIRXEXMSR

To open the Java Manager


*VSQXLI8SSPWQIRYGLSSWI.EZE1EREKIV

Publishing Java to PL/SQL


9WIXLI7502EZMKEXSV4YFPMWL.EZEXS40750[M^EVHXSGVIEXIE40750
TEGOEKIJVSQE.EZEGPEWWWXSVIHMRXLIHEXEFEWI8LMW[M^EVHKYMHIW]SY
XLSYKLGVIEXMRKE40750TEGOEKIGSRXEMRMRK.EZEGEPPWTIGMJMGEXMSRWJSVE
.EZEGPEWWWXSVIHMRXLIHEXEFEWI

To use the SQL Navigator Publish Java to PL/SQL wizard


1
2
3

-RXLI(&2EZMKEXSVSVXLI*MRH3FNIGXW[MRHS[WIPIGXE.EZE'PEWW
WXSVIHMRXLIHEXEFEWI
*VSQXLI3FNIGXSVXLIWLSVXGYXQIRYGLSSWI4YFPMWL.EZEXS40750
*SPPS[XLITVSQTXWXSKIRIVEXIE40750TEGOEKIXLEXWXSVIWXLI
TVSGIHYVIWERHJYRGXMSRWYWIHXSGEPP.EZEQIXLSHWJSVLERHPMRKXLIWXSVIH
SFNIGX
;LIRXLITEGOEKIMWKIRIVEXIHERHHMWTPE]IHMRXLI[MRHS[WTIGMJ]
[LIXLIV]SY[ERXXSSTIRMXJSVIHMXMRKFIJSVIWEZMRKMXXSXLIHEXEFEWISV
WEZIMXEWWLS[R

Extracting DDL from Java source


=SYGERYWIXLI7502EZMKEXSV)\XVEGX((0JYRGXMSRXSI\XVEGX.EZEWSYVGI
JVSQXLIHEXEFEWI 3VEGPIERHEFSZI  

8
Working with database objects

8LMWGLETXIVI\TPEMRWLS[]SYGERZMI[IHMXERHQEREKIHEXEFEWISFNIGXW
YWMRK7502EZMKEXSV
WZMWYEPIHMXMRKXSSPW

In this chapter
Visual editors for database objects
Visual editors for database objects
Finding and opening a database object
Oracle Data Dictionary views
Opening two or more instances of the same editing window
Creating, altering, or copying database objects

340
341
343
344
344
345

340

SQL Navigator Users Guide

Visual editors for database objects


7502EZMKEXSV
WIHMXMRKXSSPWJSVHEXEFEWISFNIGXWEVIZMWYEPXLI]KMZI]SYE
KVETLMGEPVITVIWIRXEXMSRSJEHEXEFEWISFNIGXHIJMRMXMSR8LMWQEOIWMXIEW]XS
WIIVIPEXMSRWLMTWERHTVSTIVXMIW
;MXLZMWYEPSFNIGXIHMXSVW]SYGERZMI[HEXEFEWISFNIGXHIJMRMXMSRWERHGVIEXI
SVEPXIVHEXEFEWISFNIGXWZMEETSMRXERHGPMGOMRXIVJEGIIPMQMREXMRKXLIRIIHXS
VIQIQFIV750W]RXE\ERH[VMXI750WXEXIQIRXWQERYEPP]
;LIR]SYGVIEXIEPXIVSVHVSTEHEXEFEWISFNIGXYWMRKXLIWIZMWYEPXSSPW750
2EZMKEXSVKIRIVEXIWXLI((0SVSXLIVHEXEFEWIGSHIEYXSQEXMGEPP]=SYGER
EPWSZMI[ERHIHMXXLIGSHIHMVIGXP]MJRIIHIH
7502EZMKEXSVTVSZMHIWZMWYEPIHMXSVWJSVXLIJSPPS[MRKWGLIQEERHRSR
WGLIQESFNIGXW
Schema objects

Non-schema objects

 -RHI\IW

 'SRWXVEMRXW

 (EXEFEWI0MROW

 9WIVW

 7IUYIRGIW

 6SPIW

 7XSVIH4VSKVEQW

 4VSJMPIW

 7]RSR]QW
 8EFPIW
 2IWXIHXEFPIW
 'PYWXIVW
 :EVVE]W
 8VMKKIVW
 :MI[W


8LI:MWYEP3FNIGX)HMXSVGSQQERHSRXLI:MI[QIRYKMZIW]SYUYMGOEGGIWW
XSEPPXLISFNIGXIHMXSVW
8LI.EZE)HMXSVMWEPWSEZEMPEFPIJVSQXLI:MI[QIRY
8LIVIEVIEPWSWIZIVEPSXLIV[E]WXSSTIR7502EZMKEXSVkWSFNIGXIHMXSVW
;LIRSTIRIHEZMWYEPSFNIGXIHMXSVGSRRIGXWXSXLIEGXMZIHEXEFEWIWIWWMSR EW
WLS[RMRXLI7IWWMSRXSSPFEV 

Chapter 8

Working with database objects

341

Visual editors for database objects


7502EZMKEXSV
WIHMXMRKXSSPWJSVHEXEFEWISFNIGXWEVIZMWYEPXLI]KMZI]SYE
ZMWYEPVITVIWIRXEXMSRSJEHEXEFEWISFNIGXHIJMRMXMSR:MWYEPSFNIGXIHMXSVW
EPPS[]SYXSZMI[HEXEFEWISFNIGXHIJMRMXMSRWERHGVIEXISVEPXIVHEXEFEWI
SFNIGXWZMEETSMRXERHGPMGOMRXIVJEGIIPMQMREXMRKXLIRIIHXSVIQIQFIV750
W]RXE\ERH[VMXI750WXEXIQIRXWQERYEPP]
8LI:MWYEP3FNIGX)HMXSVGSQQERHSRXLI:MI[QIRYKMZIW]SYUYMGOEGGIWW
XSEPPXLISFNIGXIHMXSVW

Opening an object editor from the View menu

=SYGEREPWSSTIRER]SFNIGXJSVIHMXMRKF]HSYFPIGPMGOMRKMXMRXLI(&
2EZMKEXSVXVII

342

SQL Navigator Users Guide

Opening an object editor from the DB Navigator tree



Chapter 8

Working with database objects

343

Finding and opening a database object


8LIVIEVIWIZIVEPGSRZIRMIRX[E]WXSSTIRSFNIGXIHMXSVW-J]SYORS[[LEX
X]TISJSFNIGX]SY[ERXXSIHMX]SYGERWIPIGXXLISFNIGXFIJSVISVEJXIV
STIRMRKXLIIHMXMRK[MRHS[
;LIRSTIRIHXLISFNIGXIHMXSVGSRRIGXWXSXLIEGXMZIHEXEFEWIWIWWMSR EW
WLS[RMRXLI7IWWMSRXSSPFEV 
-J]SYGEREPVIEH]WIIXLISFNIGX]SY[ERXXSSTIRMR]SYV[SVOWTEGIMRXLI
(&2EZMKEXSV[MRHS[SVMRERSFNIGXWIEVGLVIWYPXW[MRHS[]SYGERNYWX
HSYFPIGPMGOMXXSSTIRMXMRERIHMXSV
-J]SYLEZIWSQISJXLISFNIGX
WEXXVMFYXIWMRQMRHERH]SY
HVEXLIVPIX750
2EZMKEXSVWIEVGLJSVXLISFNIGX]SYGERYWIXLI7IPIGXE(&3FNIGXSVXLI*MRH
3FNIGXWHMEPSKXSLIPT]SYPSGEXIETEVXMGYPEVMXIQ=SYGERXLIRTMGOXLI
SFNIGXJVSQEPMWXSJWIEVGLVIWYPXW
 8LI7IPIGXE(&3FNIGXPIXW]SYWTIGMJ]EWGLIQEREQIERHSFNIGXX]TI
 8LI*MRH3FNIGXWHMEPSKPIXW]SYWTIGMJ]EWGLIQEREQISFNIGXX]TI
3FNIGX7XEXYWERH(EXI0EWX1SHMJMIH
You can use the SQL wildcard character % as part
of your search for object names. The wildcard by
itself will return all object names meeting the
criteria.

-J]SYORS[XLIX]TISJSFNIGX]SY[ERXXSIHMX]SYGERSTIRXLI
GSVVIWTSRHMRKIHMXSVJMVWXERHXLIRWIPIGXXLIMXIQJVSQEPMWXSJWGLIQE
SFNIGXWSJXLEXX]TI

To open the editor before selecting the object


1
2
3

*VSQXLI:MI[QIRYGLSSWI:MWYEP3FNIGX)HMXSVERHXLIRGLSSWIXLI
X]TISJSFNIGXIHMXSV]SY[ERXXSSTIRJVSQXLIPMWX
9WIXLI7IPIGXE(&3FNIGXHMEPSKXSWTIGMJ]WIEVGLGVMXIVMEJSVERSFNIGXSJ
XLIGSVVIWTSRHMRKX]TI
(SYFPIGPMGOER]SFNIGXMRXLIWIEVGLVIWYPXWXSSTIRMXMRERIHMXSV

To find the object before opening the object editor


'LSSWISRISJXLIJSPPS[MRK
 *VSQXLI3FNIGXQIRYGLSSWI3TIR(&3FNIGXERHXLIRYWIXLI7IPIGXE
(&3FNIGXXSWTIGMJ]WIEVGLGVMXIVMEJSVERSFNIGX
 6MKLXGPMGOEGSRRIGXMSRWLSVXGYXMR]SYV[SVOWTEGIERHXLIRYWIXLI
7IPIGXE(&3FNIGXXSWTIGMJ]WIEVGLGVMXIVMEJSVERSFNIGX

344

SQL Navigator Users Guide

 *VSQXLI7IEVGLQIRYGLSSWI*MRH3FNIGXWWTIGMJ]SFNIGXWIEVGLGVMXIVME
MRXLI*MRH3FNIGXWHMEPSKI\IGYXIXLIWIEVGLERHXLIRHSYFPIGPMGOER]
SFNIGXMRXLIWIEVGLVIWYPXW[MRHS[

Oracle Data Dictionary views


&]HIJEYPX7502EZMKEXSVKMZIW]SY97)6SFNIGXHEXEHMGXMSREV]ZMI[W
QIERMRK]SYGERWIISRP]SFNIGXW]SYS[RSVJSV[LMGL]SYLEZIFIIRKVERXIH
SFNIGXTVMZMPIKIW=SYGERWIPIGX)REFPIYWMRK(&%HMGXMSREV]ZMI[WYRHIV
:MI["4VIJIVIRGIW"7IWWMSRMJ]SY[ERXXSWIIEPPSFNIGXWEZEMPEFPIYRHIV]SYV
(&%YWIVTVMZMPIKIW(&%HMGXMSREV]ZMI[WEVIVIUYMVIHJSVIHMXMRK4VSJMPIW
6SPIWERH9WIVWSVJSVZMI[MRKXLIJSPPS[MRKRSHIWSJXLI(&2EZMKEXSVXVII
 6SPIW
 WSQIRSHIWYRHIV9WIVW
 (EXEJMPIWYRHIV8EFPIWTEGIW
 6IHS0SK+VSYTW
 6SPPFEGO7IKQIRXW

Opening two or more instances of the same editing


window
8LMWMRJSVQEXMSRETTPMIWXSXLIJSPPS[MRK[MRHS[W
 %REP]^I
 (IWGVMFI
 )\TPEMR4PER
 3FNIGX)HMXSVW
-J]SY[ERXXSSTIREREHHMXMSREPIHMXMRK[MRHS[[LMPIOIITMRKXLIGYVVIRX
SRISTIR]SYGERTMRXLIGYVVIRXIHMXSV[MRHS[STIRERHXLIRSTIREWIGSRH
IHMXSV[MRHS[8LMWQIERW]SYGERMRZSOIX[SSVQSVIMRWXERGIWSJXLIWEQI
X]TISJSFNIGXIHMXSV
-JXLI[MRHS[MWRSXTMRRIHXLIRMJ]SYSTIRERSXLIVSFNIGXSJXLIWEQIX]TI
XLEXSFNIGX[MPPVITPEGIXLIGYVVIRXSFNIGXHMWTPE]IHMRXLIIHMXMRK[MRHS[
You can change the default for any of these
windows in View > Preferences > General >
User Interface by selecting or clearing the Pin
at Start option.

Chapter 8

Working with database objects

345

Example
7YTTSWI]SYEVIIHMXMRKSVZMI[MRKXLIWIUYIRGI'978-(MRXLIWIUYIRGI
IHMXSV=SY[ERXXSZMI[ERSXLIVWIUYIRGIWYGLEW)14-(
If you want to

Then

/IITXLI'978-(IHMXMRK
[MRHS[STIR[LMPI]SYSTIRE
WIGSRHIHMXMRK[MRHS[

4MRXLI[MRHS[STIR
EGXMZEXIXLITMRMGSR 



7[MXGLXLIZMI[MRXLIIHMXMRK
[MRHS[JVSQXLI'978-(
SFNIGXXSXLI)14-(SFNIGX

9RTMRXLI[MRHS[
HIEGXMZEXIXLITMRMGSR 




Creating, altering, or copying database objects


7502EZMKEXSV
WZMWYEPSFNIGXIHMXSVWQEOIMXIEW]XS
 'VIEXIRI[SFNIGXW
 1SHMJ]I\MWXMRKSFNIGXW
 )\XVEGX((0JVSQSFNIGXW
 (VSTSFNIGXW

Creating new objects


8LIVIEVIWIZIVEP[E]WSJGVIEXMRKERI[HEXEFEWISFNIGX8LIQSWXGSQQSRP]
YWIHEVIXLIWI 
 -RXLI(&2EZMKEXSV[MRHS[VMKLXGPMGOERSFNIGXSJXLIX]TI]SY[ERXXS
GVIEXIGLSSWI'VIEXIJVSQXLIWLSVXGYXQIRYERHXLIRJSPPS[XLI
TVSQTXW
 -RXLI3FNIGXXSSPFEVGPMGO
 XLI'VIEXI(&3FNIGXMGSR ERHXLIR
JSPPS[XLITVSQTXW
 *VSQXLI3FNIGXQIRYGLSSWI'VIEXI(&3FNIGXWIPIGXXLIX]TISJSFNIGX
]SY[ERXXSGVIEXIJVSQIMXLIVXLI7GLIQE3FNIGXWXEFSVXLI2SR7GLIQE
XEFERHXLIRJSPPS[XLITVSQTXW
 -J]SY[ERXXSGVIEXIERI[XVMKKIV750UYIV]SVWXSVIHTVSKVEQ]SYGER
GPMGOXLIGSVVIWTSRHMRKMGSRWMRXLI*YRGXMSRWXSSPFEVERHXLIRGPMGOXLI
2I[MGSRMRXLIIHMXMRKXSSPFEV[LIRXLIIHMXSV[MRHS[STIRW

346

SQL Navigator Users Guide

To clone an object
1
2
3

-RERSTIRSFNIGXGPMGO'PSRI8LIREQIJMIPH[MPPFIGPIEVIHERHEPPSXLIV
JMIPHW[MPPVIXEMRXLIWEQIZEPYI
)RXIVXLIREQIJSVXLIRI[SFNIGX
8SWEZIXLIRI[SFNIGXXSXLIHEXEFEWIGPMGO7EZI

Automatically compile all dependent objects


=SYLEZIXLISTXMSRXSEYXSQEXMGEPP]GSQTMPIEPPHITIRHIRXSFNIGXW[LIR
WEZMRKERSFNIGXYWMRKXLISFNIGXIHMXSV8LMWIPMQMREXIWXLIRIIHXSJMRHERH
GSQTMPIEPPHITIRHIRXSFNIGXWXLEXFIGEQIMRZEPMH[LIREPXIVMRKETVSGIHYVI
XEFPISVSXLIVWXVYGXYVI 

Altering database objects


To modify a database object
1
2
3
4


3TIRXLISFNIGX
1EOIGLERKIWEWRIIHIH 'SRWYPX3VEGPIHSGYQIRXEXMSRJSVHIXEMPWEFSYX
WTIGMJMGSFNIGXEXXVMFYXIW 
-J]SY[MWLXSHMWGEVH]SYVGLERKIWERHVIUYIV]XLISFNIGXHIJMRMXMSR
JVSQXLIHEXEFEWIGPMGO6IZIVX
8SWYFQMXGLERKIWXSXLIHEXEFEWIGPMGO7EZI
7502EZMKEXSVKIRIVEXIWXLIGSHIERHWXSVIWXLIQSHMJMIHSFNIGXMRXLI
HEXEFEWI

Dropping a database object


9WIXLI(VSTGSQQERHXSHIPIXIERSFNIGXJVSQXLIHEXEFEWI

To drop a database object


 'LSSWISRISJXLIJSPPS[MRKQIXLSHW

Chapter 8

Working with database objects

If the object you want to drop is ...


7IPIGXIHMRXLI(&2EZMKEXSV[MRHS[

347

Then
3RXLI3FNIGXXSSPFEVGPMGOXLI
(VSTFYXXSRSVVMKLXGPMGOXLI
SFNIGXERHXLIRGLSSWI(VST
JVSQXLIWLSVXGYXQIRY
8LI(VSTFYXXSR
3FNIGXXSSPFEV 

3TIRMRERSFNIGXIHMXSV

3RXLI3FNIGXXSSPFEVGPMGOXLI
(VSTFYXXSR

7IPIGXIHMRE[SVOWTEGI[MRHS[

)MXLIVSTIRXLISFNIGXSVVMKLX
GPMGOMXERHGLSSWI0SGEXIMR(&
2EZMKEXSVXLIRYWISRISJXLI
X[SSTXMSRWEFSZI

Extracting DDL and other SQL statements from


objects
(ITIRHMRKSRXLIX]TISJSFNIGXSVEGGIWWGSRXVSP]SYEVI[SVOMRK[MXL]SY
GERI\XVEGXXLI((0SVSXLIV750WXEXIQIRXWXLEXHIJMRIXLISFNIGXSVEGGIWW
GSRXVSP)\XVEGX((0VYRWEWEFEGOKVSYRHXEWO=SYGERWIPIGXQYPXMTPI
SFNIGXWWXEVXERI\XVEGX((0XEWOERHOIITSR[SVOMRK[LMPIMXVYRW 

To extract the DDL for the current object and place it into the
SQL Editor
 'PMGO  XLI)\XVEGX((0FYXXSR MRXLI3FNIGXXSSPFEV

To extract the SQL for the current object and place it into the
SQL Editor
 'PMGOXLI750FYXXSRMRXLISFNIGXIHMXSV[MRHS[XSSPFEV

To select and extract DDL from multiple objects


=SYGERYWIXLI*MRH3FNIGXWHMEPSKSVXLI(&2EZMKEXSVJSVQYPXMTPI
WIPIGXMSRSJSFNIGXW

348

SQL Navigator Users Guide

Commands for working with database objects


=SYGERYWIGSQQERHWJVSQXLI3FNIGXQIRYJSVGSQQSRSTIVEXMSRWSR
WIPIGXIHHEXEFEWISFNIGXW
8LIEZEMPEFPIEGXMSRWZEV]HITIRHMRKYTSRXLIX]TISJSFNIGXWIPIGXIH8LIWI
EGXMSRWMRGPYHIWYGLGSQQSRJYRGXMSRWEWXLSWIPMWXIHFIPS[1SWXSJXLIWI
EGXMSRWEVIHIWGVMFIHMR3VEGPIHSGYQIRXEXMSRFYXEJI[EVIYRMUYIXS750
2EZMKEXSV1ER]SJXLIWIGSQQERHWEVIEPWSEZEMPEFPIXLVSYKLXLI3FNIGX
XSSPFEVERHXLIWLSVXGYXQIRY[LIRXLEXETTIEVW]SYVMKLXGPMGOEHEXEFEWI
SFNIGX0MOISXLIV7502EZMKEXSVXSSPFEVWXLI3FNIGXXSSPFEVMWGYWXSQM^EFPI
=SYGEREPWSYWIXLIFYXXSRWPSGEXIH[MXLMRXLI:MWYEP3FNIGX)HMXSV[MRHS[
%W[MXLSXLIVXSSPFEVWMR7502EZMKEXSVXLIFYXXSRWEZEMPEFPIGLERKI
HITIRHMRKSRXLIX]TISJSFNIGXFIMRKIHMXIH
 'VIEXI(&3FNIGX

 5YMGO&VS[WI

 3TIR(&3FNIGX

 )HMX(EXE

 3TIR
 (IWGVMFI

 %REP]^I
 8VYRGEXI

 6IREQI

 7XSVEKI %PPSGEXI(IEPPSGEXI
'SEPIWGI 

 (VST
 )\XVEGX((0
 :MI[(MJJIVIRGI
 4YFPMWL.EZEXS40750
 'SQTMPI
 )\IGYXI
 &VS[WI(EXE

 )REFPI
 (MWEFPI
 +VERX
 6IZSOI
 0SGEXIMR7GLIQE
 4VSTIVXMIW
 %HHXS;SVOWTEGI

Chapter 8

Working with database objects

349

Object editing command summary


To
'VIEXIERI[
HEXEFEWISFNIGX

Click this


JVSQXLI3FNIGXXSSPFEV
SV

Note



JVSQXLI)HMXSV
W
XSSPFEV
3TIRXLIWIPIGXIH
HEXEFEWISFNIGXMRER
IHMXMRK[MRHS[

7IPIGXERHSTIRE
HEXEFEWISFNIGXJVSQ
EPMWXFEWIHSR
WIPIGXMSRTEVEQIXIVW
MRGPYHMRKWGLIQE
SFNIGXX]TIERHE
REQIQEWO


JVSQXLI3FNIGXXSSPFEV

3TIR(&3FNIGXJVSQ
XLI3FNIGXQIRY

2SXEPPHEXEFEWI
SFNIGXWGERFI
EPXIVIH=SYQE]
RIIHXSHVSTXLI
SFNIGXERHGVIEXIE
RI[SRI
=SYGERWIXE
TVIJIVIRGIXSGSRXVSP
LS[7502EZMKEXSV
VIWTSRHWXSXLI3TIR
(&3FNIGXGSQQERH



(VSTEHEXEFEWI
SFNIGX



JVSQXLI3FNIGXXSSPFEV

'VIEXI GPSRI ERI[


SFNIGX[MXLE
HIJMRMXMSRWMQMPEVXS
XLEXSJXLIGYVVIRXP]
HMWTPE]IHSFNIGX


JVSQXLI)HMXSV
W
XSSPFEV

'ERGIPIHMX
STIVEXMSRWERHVI
UYIV]XLIHIJMRMXMSR
SJXLISFNIGXJVSQXLI
HEXEFEWI


JVSQXLI)HMXSV
W
XSSPFEV

6IXEMRWEPPJMIPHWERH
TVITEVIWXLIIHMXSVXS
EGGITXEREQIJSVXLI
RI[SFNIGX2SXIXLEX
XLIRI[SFNIGXMWRSX
WEZIHXSXLIHEXEFEWI
YRXMP]SYGPMGO 
7EZI 


350

SQL Navigator Users Guide

To
4VIZMI[XLI750
WGVMTXJSVXLIGYVVIRX
SFNIGX
7YFQMX]SYVIHMXWXS
XLIHEXEFEWIGSQTMPI
40750ERHVITSVX
IVVSVW
)\XVEGX((0JSVXLI
GYVVIRXSFNIGX
'SQTMPI6IFYMPHXLI
GYVVIRXSFNIGX
6IREQIXLIGYVVIRX
SFNIGX
+VERXSFNIGX
TVMZMPIKIWJSVXLI
GYVVIRXSFNIGX
&VS[WI(EXEMRE
XEFPISFNIGX
)HMX(EXEMREXEFPI
SFNIGX
'SPPIGXWXEXMWXMGW

8VYRGEXIEXEFPI

Click this


JVSQXLI)HMXSV
W
XSSPFEV

JVSQXLI)HMXSV
W
XSSPFEV


JVSQXLI3FNIGXXSSPFEV

JVSQXLI3FNIGXXSSPFEV
JVSQXLI3FNIGX
XSSPFEV

JVSQXLI3FNIGXXSSPFEV

JVSQXLI3FNIGXXSSPFEV

JVSQXLI3FNIGXXSSPFEV

JVSQXLI3FNIGXXSSPFEV


JVSQXLI3FNIGXXSSPFEV

Note
(MWTPE]WXLI750
WGVMTXMREWITEVEXI
[MRHS[
-RZEPMHEXIW7XSVIH
TVSKVEQWERH
8VMKKIVWMJXLIVIEVI
IVVSVWMRXLIGSHI


*SVHEXEFEWI
WXVYGXYVIWWYGLEW
XEFPIWGPYWXIVWERH
MRHI\IW
6IQSZIEPPVS[W
JVSQEXEFPIERHVIWIX
XLI7836%+)
TEVEQIXIVWXSXLI
ZEPYIW[LIRXLIXEFPI
SVGPYWXIV[EWGVIEXIH

Chapter 8

Working with database objects

To
0SGEXIERSFNIGX

7LS[XLITVSTIVXMIW
SJXLIGYVVIRXSFNIGX
%HHXLIGYVVIRX
SFNIGXXSXLI
;SVOWTEGI

351

Click this


JVSQXLI3FNIGXXSSPFEV

JVSQXLI3FNIGXXSSPFEV

JVSQXLI3FNIGXXSSPFEV

Note


Editing constraints
9WIXLI'SRWXVEMRX)HMXSVXSWTIGMJ]XEFPIGSRWXVEMRXW
-R3VEGPIEGSRWXVEMRXMWEVYPIETTPMIHXSERSFNIGXXLEXVIWXVMGXWXLIHEXE
EPPS[IHMRER]MRWXERGISJXLISFNIGX
7502EZMKEXSV
WZMWYEPGSRWXVEMRXIHMXSVMWMRXIRHIHXSFIYWIHSRP]JSVXEFPI
VIPEXIHGSRWXVEMRXW.
8LIGLEVEGXIVMWXMGWERHYWEKISJXLMWHEXEFEWISFNIGXEVIHIWGVMFIHMR3VEGPI
HSGYQIRXEXMSR

To create a constraint
1

2
3
4

-RXLIGSRWXVEMRXIHMXSVIRWYVIXLEXXLIVIUYMVIHWGLIQEERHXEFPIREQIW
ETTIEVMRXLI7GLIQEERH8EFPIJMIPHW=SYGERYWIXLIHVSTHS[RPMWXWXS
WIPIGXXLIGSVVIGXWGLIQEERHXEFPI
'PMGOXLI2I[FYXXSR
)RXIVEREQIJSVXLIGSRWXVEMRXMRXLI'SRWXVEMRXJMIPH
7TIGMJ]XLIGSRWXVEMRXX]TIMRXLI8]TIJMIPH8LITSWWMFPIX]TIWEVIPMWXIH
FIPS[

352

SQL Navigator Users Guide

Type

6
7
8

Purpose

4VMQEV]/I]

(IWMKREXIWEGSPYQRSVGSQFMREXMSRSJGSPYQRWEWE
XEFPI
WTVMQEV]OI]

9RMUYI

(IWMKREXIWEGSPYQRSVGSQFMREXMSRSJGSPYQRWEWE
XEFPI
WYRMUYIOI]

'LIGO

7TIGMJMIWEGSRHMXMSRXLEXIEGLVS[MRXLIXEFPIQYWX
WEXMWJ]

*SVIMKR/I]

(IWMKREXIWEGSPYQRSVGSQFMREXMSRSJGSPYQRWEWXLI
JSVIMKROI]

8SEHHGSPYQRWXSXLIGSRWXVEMRXYWIXLIEVVS[FYXXSRXSQSZISRISV
QSVIWIPIGXIHGSPYQRWJVSQXLI%ZEMPEFPI8EFPI'SPYQRWTERIXSXLI
'SRWXVEMRX'SPYQRWTERI8LIHSYFPIEVVS[EHHWEPPEZEMPEFPIGSPYQRWXS
XLIGSRWXVEMRX
-JXLIGSRWXVEMRXX]TIMW'LIGOIRXIVXLIGLIGOGSRHMXMSRJSPPS[MRK3VEGPI
W]RXE\GSRZIRXMSRW)\EQTPI (loc is not null)
-JXLIGSRWXVEMRXX]TIMW9RMUYI4VMQEV]/I]SV*SVIMKROI]HIWMKREXIXLI
GSPYQR W XSFIYWIHEWXLI9RMUYI4VMQEV]/I]SV*SVIMKROI]
-JXLIGSRWXVEMRXX]TIMW*SVIMKROI]
 (IWMKREXIXLI9RMUYISV4VMQEV]/I]MRXLI6IJIVIRGIJMIPH
 -JHIWMVIHWIPIGXXLI3R(IPIXI'EWGEHITVSTIVX]
Caution: Before selecting the On Delete
Cascade property, be sure you understand the
potential consequences of using this option. It
could result in lost data. Consult your Oracle
documentation for information about the DELETE
CASCADE command.

8S)\XVEGXXLI((0JSVXLIRI[GSRWXVEMRXERHTPEGIMXMRXSXLI750
)HMXSVGPMGOXLI750FYXXSR
0 8SYRHS]SYVIRXVMIW[MXLSYXWEZMRKXLIQGPMGOXLI6IZIVXFYXXSR
9

2SXI%JXIVWEZMRK]SYVGLERKIW]SY[MPPRSXFIEFPIXSYWIXLI6IZIVX
GSQQERH
1 8SWEZI]SYVRI[GSRWXVEMRXHIJMRMXMSRXSXLIHEXEFEWIGPMGOXLI7EZI
FYXXSR7502EZMKEXSVKIRIVEXIWXLI((0ERHGSQQMXWMXXSXLIHEXEFEWI

Chapter 8

Working with database objects

353

To modify a constraint
3RGIEGSRWXVEMRXLEWFIIRHIJMRIHERHWEZIHXSXLIHEXEFEWIMXGERRSXFI
EPXIVIHMRXLIGSRWXVEMRXIHMXSV8SGLERKIXLIGSRWXVEMRXMXMWRIGIWWEV]XS
HVSTMXERHXLIRXSGVIEXIERI[GSRWXVEMRX[MXLXLIRIGIWWEV]TVSTIVXMIW

To alter a constraint
1
2

0SGEXIXLIGSRWXVEMRXYWMRKXLI(&2EZMKEXSVSVXLI*MRH3FNIGXWHMEPSK
8SHVSTXLISFNIGXJVSQXLIHEXEFEWIIMXLIV

6MKLXGPMGOXLISFNIGXREQIERHGLSSWI(VSTJVSQXLIWLSVXGYXQIRY
SV
7IPIGXXLISFNIGXERHGPMGOXLI(VSTFYXXSR

To enable or disable a constraint


1

0SGEXIXLIGSRWXVEMRXYWMRKXLI(&2EZMKEXSVSVXLI*MRH3FNIGXWHMEPSK

6MKLXGPMGOXLIGSRWXVEMRXREQIERHGLSSWI)REFPISV(MWEFPIJVSQXLI
WLSVXGYXQIRY

Editing indexes
9WIXLI-RHI\)HMXSVXSGVIEXIEPXIVERHHVSTMRHI\IWERHXSWIXWXSVEKI
EPPSGEXMSR
%RMRHI\MWEWSVXIHQETSJWIPIGXIHGSPYQRWMREXEFPISVSFNIGX8LIVIJSVIER
MRHI\MWWMQMPEVXSEXEFPIERHXLIGSPYQRWMRERMRHI\VIJIVXSXLIVS[WERH
GSPYQRWSJXLIEWWSGMEXIHXEFPI&]MRHI\MRKGSPYQRWJVIUYIRXP]YWIHMR
UYIVMIW]SYGERMQTVSZIHEXEVIXVMIZEPTIVJSVQERGI
%RMRHI\GERFIIMXLIVYRMUYISVRSRYRMUYI
 %YRMUYIMRHI\ZEPMHEXIWIZIV]RI[SVGLERKIHVS[MREXEFPIJSVEYRMUYI
ZEPYIMRXLIGSPYQR W MRXLIMRHI\
 %RSRYRMUYIMRHI\EPPS[WHYTPMGEXIZEPYIWMRVS[W
%RSRYRMUYIMRHI\SJXIRIREFPIWJEWXIVUYIVMIW
3VEGPIWYTTSVXWEX]TISJMRHI\GEPPIHEFMXQETMRHI\%FMXQETMRHI\YWIWE
GSQTVIWWIHFMXWXVIEQWXSVEKIXIGLRMUYIXLEXEPPS[WZIV]JEWXVIXVMIZEP
8LIGLEVEGXIVMWXMGWERHYWEKISJXLMWHEXEFEWISFNIGXEVIHIWGVMFIHMR3VEGPI
HSGYQIRXEXMSR

354

SQL Navigator Users Guide

Editing views
9WIXLI:MI[)HMXSVXSGVIEXIEPXIVHIJMRIERHHVSTZMI[W
%ZMI[MWEUYIV]XLEXMWREQIHMRXLIHEXEFEWIWSXLEXMXGERFIYWIHEWMJMX
[IVIEXEFPI-XGERFIXLSYKLXSJEWEZMVXYEPXEFPIMRXLIHEXEFEWI[LSWI
GSRXIRXWEVIHIJMRIHF]XLI7IPIGXUYIV]
=SYGERYWIZMI[WXSVIEVVERKIJMPXIVERHWIPIGXXLI[E]]SYWIIHEXEMRXEFPIW
[MXLSYXGVIEXMRKER]GSTMIWSJXLEXHEXE:MI[WLIPTQEOIHEXEEGGIWWWMQTPIV
F]LMHMRKGSQTPI\MXMIW8LI]GEREPWSLIPTWITEVEXIHEXEJSVHMJJIVIRXYWIVWEW
EWIGYVMX]QIEWYVI
7502EZMKEXSV
WZMI[IHMXSVQEOIWMXIEW]XSGVIEXIERHEPXIVZMI[W%PXLSYKL
]SY[SR
XRIIHXSX]TIER]40750GSHI[LIRIHMXMRKZMI[WMR750
2EZMKEXSV]SYWLSYPHFIJEQMPMEV[MXL3VEGPIVYPIWERHKYMHIPMRIWJSVYWMRK
ZMI[W
8LIEXXVMFYXIWSJXLMWHEXEFEWISFNIGXEVIHIWGVMFIHMR3VEGPIHSGYQIRXEXMSR

Editing database links


9WIXLI(EXEFEWI0MRO)HMXSVXSGVIEXIHIJMRIERHHVSTHEXEFEWIPMROW
%HEXEFEWIPMROEPPS[WEGGIWWXSEYWIVREQISREVIQSXIHEXEFEWIXLVSYKLXLI
PSGEPHEXEFEWI%TYFPMGHEXEFEWIPMRO [LMGLSRP]E(&%GERGVIEXI EPPS[W
XLIVIQSXIHEXEFEWIEGGIWWXSEPPYWIVWSJXLIPSGEPHEXEFEWI
8LIGLEVEGXIVMWXMGWERHYWEKISJXLMWHEXEFEWISFNIGXEVIHIWGVMFIHMR3VEGPI
HSGYQIRXEXMSR
8LI7502EZMKEXSV(EXEFEWI0MROIHMXSV[MPPXV]XSEYXSQEXMGEPP]EHHXLI
HSQEMRREQI[LIRVIUYMVIHF]XLIWIVZIV,S[IZIVMJXLIYWIVGERRSXWIIXLI
ZMI[ZTEVEQIXIVXLIRXLIHSQEMRREQIMWRSXEYXSQEXMGEPP]EHHIH8LIYWIV
WLSYPHIRXIVEJYPP]UYEPMJMIHHEXEFEWIPMROREQIMRXLI2I[3FNIGXHMEPSK
Due to limitations in the Oracle Data Dictionary it
is not possible for Extract DDL to correctly apply
the SHARED and AUTHENTICATED clauses in a
CREATE DATABASE LINK statement

Chapter 8

Working with database objects

355

Editing sequences
9WIXLI7IUYIRGI)HMXSVXSGVIEXIEPXIVERHHVSTWIUYIRGIW
%WIUYIRGIMWER3VEGPISFNIGXXLEXHIPMZIVWEYRMUYIRYQFIVMRGVIQIRXIHF]
WSQIWTIGMJMIHEQSYRXIZIV]XMQIMXMWVIUYIWXIH7IUYIRGIWEVIYWYEPP]YWIH
XSKIRIVEXIETVMQEV]OI]JSVEXEFPISVJSVEWIXSJXEFPIW=SYGERYWIXLI
WIUYIRGIXSGVIEXIYRMUYIRYQFIVXLEX]SYGERYWIMR]SYVXEFPIWEWTVMQEV]
MHIRXMJMIVW
8LIGLEVEGXIVMWXMGWERHYWEKISJXLMWHEXEFEWISFNIGXEVIHIWGVMFIHMR3VEGPI
HSGYQIRXEXMSR

Editing synonyms
Use the Synonym Editor to create, alter, and drop synonyms.
%W]RSR]QMWEREPXIVREXIREQIJSVEXEFPISVZMI[%W]RSR]QGERFITVMZEXI
JSVYWISRP]F]MXWGVIEXSV SVTYFPMG JSVYWIF]ER]YWIV 4VMQEVMP]
W]RSR]QWIREFPIQYPXMTPIYWIVWXSVIJIVIRGIERSFNIGX[MXLSYXEHHMRKXLI
WGLIQEEWETVIJM\XSXLISFNIGX8LI]GEREPWSEPPS[HMJJIVIRXETTPMGEXMSRWXS
VIJIVIRGIXLIWEQISFNIGXYWMRKHMJJIVIRXREQIW
=SYGERQEOIW]RSR]QWJSVXLIJSPPS[MRKHEXEFEWISFNIGXW
 XEFPIW
 ZMI[W
 SXLIVW]RSR]QW
 JYRGXMSRW
 TEGOEKIW
 TVSGIHYVIW
 WIUYIRGIW
 HEXEFEWIPMROW
8LIGLEVEGXIVMWXMGWERHYWEKISJXLMWHEXEFEWISFNIGXEVIHIWGVMFIHMR3VEGPI
HSGYQIRXEXMSR

Editing profiles
9WIXLI4VSJMPI)HMXSVXSGVIEXIEPXIVERHHVSTTVSJMPIW
%TVSJMPIMWEWIXSJPMQMXWSRXLIYWISJHEXEFEWIVIWSYVGIWXLEXGERFIETTPMIH
XSEYWIV-J]SYEWWMKRXLITVSJMPIXSEYWIVXLEXYWIVGERRSXI\GIIHXLSWI
PMQMXW-JEYWIVI\GIIHWEPMQMX3VEGPIEFSVXWERHVSPPWFEGOXLIXVERWEGXMSR
ERHXLIRIRHWXLIWIWWMSR4VSJMPIWIXXMRKWMRGPYHIGSRRIGXXMQITEWW[SVH
PMJIXMQIERHVIYWIMHPIXMQIERHWMQMPEVVIWXVMGXMSRW

356

SQL Navigator Users Guide

8LIGLEVEGXIVMWXMGWERHYWEKISJXLMWHEXEFEWISFNIGXEVIHIWGVMFIHMR3VEGPI
HSGYQIRXEXMSR
8SIHMXTVSJMPIW]SYQYWXLEZIXLI'6)%8)463*-0)W]WXIQTVMZMPIKI%PWS
XLI(&%HMGXMSREV]ZMI[WSTXMSRQYWXFIWIPIGXIHMRXLI7IWWMSR4VIJIVIRGIW
HMEPSK

Editing users
9WIXLI9WIV)HMXSVXSGVIEXIHVSTERHKVERXSVVIZSOIVSPIWERHTVMZMPIKIWXS
YWIVWMRGPYHMRKJSVGMRKETEWW[SVHXSI\TMVI
-R3VEGPIE9WIVMWWMQTP]EYRMUYIPSKMRREQI%YWIV
WGETEFMPMXMIWMRWMHI
XLIHEXEFEWIEVIHIXIVQMRIHF]XLI9WIV
WVSPIEWWMKRQIRXW
8LIGLEVEGXIVMWXMGWERHYWEKISJXLMWSFNIGXEVIHIWGVMFIHMR3VEGPI
HSGYQIRXEXMSR
8SIHMXTVSJMPIW]SYQYWXLEZIXLI'6)%8)463*-0)W]WXIQTVMZMPIKI%PWS
XLI(&%HMGXMSREV]ZMI[WSTXMSRQYWXFIWIPIGXIHMRXLI7IWWMSR4VIJIVIRGIW
HMEPSK

Editing roles
9WIXLI6SPI)HMXSVXSGVIEXIERHHVSTVSPIW 
%6SPIMWEWIXSJTVMZMPIKIWXLEXGERFIEWWMKRIHXSSVVIQSZIHJVSQEYWIV
9WIXLI9WIV)HMXSVXSGVIEXIHVSTERHKVERXSVVIZSOIVSPIWERHTVMZMPIKIW
XSYWIVW 
8LIGLEVEGXIVMWXMGWERHYWEKISJXLMWHEXEFEWISFNIGXEVIHIWGVMFIHMR3VEGPI
HSGYQIRXEXMSR
8SIHMXTVSJMPIW]SYQYWXLEZIXLI'6)%8)463*-0)W]WXIQTVMZMPIKI%PWS
XLI(&%HMGXMSREV]ZMI[WSTXMSRQYWXFIWIPIGXIHMRXLI7IWWMSR4VIJIVIRGIW
HMEPSK

Editing VARRAYs
:%66%= SVZEVV]MRKEVVE] MWEGSPPIGXMSRX]TI]SYGERYWI[LIR]SY[ERX
XSVIXVMIZIIRXMVIGSPPIGXMSRWEWE[LSPI8LI]EVIFIWXWYMXIHJSVWQEPP
GSPPIGXMSRW-J]SYVIUYMVIEPEVKIIJJMGMIRXGSPPIGXMSR]SY[SYPHFIFIXXIVXS
YWIERIWXIHXEFPIGSPPIGXMSRX]TI WII)HMXMRKERIWXIHXEFPI 
9WIXLI:%66%=IHMXSVXSGVIEXI:%66%=GSPPIGXMSRW[LMGLGERFIYWIHXS
 PSSTXLVSYKLXLIIPIQIRXWMRSVHIV
 WXSVISRP]EJM\IHRYQFIVSJMXIQW
 VIXVMIZIERHQERMTYPEXIXLIIRXMVIGSPPIGXMSREWEZEPYI

Chapter 8

Working with database objects

357

=SYQYWXWIXEQE\MQYQRYQFIVSJIPIQIRXWJSVE:%66%=FYX]SYGER
GLERKIXLMWPMQMX
%:%66%=SFNIGXMWRSVQEPP]WXSVIHMRPMRIXLEXMWMRXLIWEQIXEFPIWTEGIEW
XLISXLIVHEXEMRMXWVS[
8LIGLEVEGXIVMWXMGWERHYWEKISJXLMWHEXEFEWISFNIGXEVIHIWGVMFIHMR3VEGPI
HSGYQIRXEXMSR

To alter a VARRAY
1

2
3

3TIRE:%66%=RSHIWIPIGXE:%66%=SFNIGXERHJVSQXLI%GXMSRW
QIRYGLSSWI%PXIV:%66%=8]TI SVWMQTP]HSYFPIGPMGOXLI:%66%=
SFNIGXREQI 
1SHMJ]XLIMRJSVQEXMSRSRXLIIHMXSVEWVIUYMVIH
'PMGO7EZIXSYTHEXIXLIHEXEFEWI[MXL]SYVGLERKIWSVGPMGO6IZIVXXS
VIQSZIEPPGLERKIWQEHIWMRGIXLIPEWXWEZI

To create a VARRAY
1

2
3
4

7IPIGXXLI:%66%=8]TIWRSHIERHJVSQXLI%GXMSRWQIRYGLSSWI'VIEXI
:%66%=8]TI
SV
-RERSTIR:%66%=IHMXSVVMKLXGPMGOERHWIPIGX2I[
-RXLI2I[:%66%=8]TI[MRHS[JVSQXLI7GLIQEPMWXWIPIGXEWGLIQE
XS[LMGLXLI:%66%=[MPPFIPSRK
-RXLI2EQIJMIPHX]TIEREQIJSVXLI:%66%=ERHXLIRGPMGO3/
3RXLI(IXEMPWXEFWIXXLISTXMSRWJSVXLI:%66%=X]TIEGGSVHMRKXSXLI
JSPPS[MRKHIWGVMTXMSR 

358

SQL Navigator Users Guide

7M^I

WIPIGXXLIQE\MQYQRYQFIVSJIPIQIRXWEPPS[IHMR
XLI:%66%=

(EXEX]TI
WGLIQE

WIPIGXIMXLIV
 7'%0%68=4)"MJ]SY[MWLXSYWIETVIHIJMRIH
3VEGPIX]TI
 SV
 XLIREQISJEWGLIQEXLEXGSRXEMRWEYWIVHIJMRIH
:%66%=X]TI

7M^I

WIPIGXXLIQE\MQYQRYQFIVSJIPIQIRXWEPPS[IHMR
XLI:%66%=

(EXEX]TI

WIPIGXXLIHEXEX]TIJSVXLIGSPPIGXMSRJSVI\EQTPI
()'-1%0-28)+)6',%6%'8)6

0IRKXL

WIXXLIQE\MQYQRYQFIVSJIPIQIRXWEPPS[IHMRXLI
:%66%=MJETTVSTVMEXI

7GEPI

WIXXLIGSPPIGXMSRHEXEX]TIWGEPIMJETTVSTVMEXI

9WISFNIGX
VIJIVIRGI

6)* rWIPIGXXLMWFS\MJXLI:%66%=HEXEX]TIMWXS
FIE6)*8LMWSTXMSRMWSRP]EZEMPEFPIMJEYWIV
HIJMRIHHEXEX]TIMWWIPIGXIHJVSQXLIHEXEX]TIHVST
HS[RPMWX-XMWRSXEZEMPEFPIJSVEWGEPEVHEXEX]TI

8SYTHEXIXLIHEXEFEWIGPMGO7EZI

Editing clusters
=SYYWIXLIGPYWXIVIHMXSVXSNSMRXEFPIWXLEXEVIGPSWIP]VIPEXIHJSVWXSVMRKSR
XLIWEQIEVIESJXLIHMWO8LMWPIXW]SYMRXIVPIEZIXLIVS[WSJX[SSVQSVI
XEFPIWXSKIXLIVMRXSEWMRKPIEVIEGEPPIHEGPYWXIV
8LIGPYWXIVOI]MWXLIGSPYQRSVGSPYQRWF][LMGLXLIXEFPIWEVIYWYEPP]
NSMRIHMREUYIV]=SYGERSRP]GPYWXIVXSKIXLIVXEFPIWXLEX]SYS[R
=SYGERGVIEXIIMXLIVERMRHI\GPYWXIVSVELEWLGPYWXIV;MXLERMRHI\IHXEFPI
SVMRHI\GPYWXIV3VEGPIPSGEXIWXLIVS[WMREXEFPIYWMRKOI]ZEPYIWXLEX3VEGPI
WXSVIWMREWITEVEXIMRHI\8SYWILEWLMRK]SYGVIEXIELEWLGPYWXIVERHPSEH
XEFPIWMRXSMX3VEGPITL]WMGEPP]WXSVIWXLIVS[WSJEXEFPIMRELEWLGPYWXIVERH
VIXVMIZIWXLIQEGGSVHMRKXSXLIVIWYPXWSJELEWLJYRGXMSR
8LIGLEVEGXIVMWXMGWERHYWEKISJXLMWHEXEFEWISFNIGXEVIHIWGVMFIHMR3VEGPI
HSGYQIRXEXMSR 

Chapter 8

Working with database objects

359

To create a cluster
7IPIGXXLI'PYWXIVWRSHIERHJVSQXLI%GXMSRWQIRYGLSSWI'VIEXI'PYWXIV
SV
-RERSTIRGPYWXIVIHMXSVVMKLXGPMGOERHWIPIGX2I[
2 -RXLI2I['PYWXIV[MRHS[JVSQXLI7GLIQEPMWXWIPIGXEWGLIQEXS
[LMGLXLIGPYWXIV[MPPFIPSRK
3 MRXLI2EQIJMIPHX]TIEREQIJSVXLIGPYWXIV
GLSSWIXLI2I[3FNIGX8]TI MRHI\LEWLSVMR3VEGPI-SRP]WMRKPIXEFPI
4 'PMGO3O
5 3RXLI(IXEMPWXEFWIXXLISTXMSRWJSVXLIGPYWXIVEGGSVHMRKXSXLI
JSPPS[MRKPMWXMRKW
1

'PYWXIVWM^I

7IPIGXXLIRYQFIVSJF]XIWVIUYMVIHXSWXSVIEPPVS[W
[MXLXLIWEQIGPYWXIVOI]SVLEWLZEPYI

,EWLOI]W

-J]SYEVIGVIEXMRKELEWLGPYWXIVWIPIGXXLIRYQFIV
SJOI]WXSFIYWIH

,EWL)\TVIWWMSR

-J]SYEVIGVIEXMRKELEWLGPYWXIVIRXIVZEPMH750
)\TVIWWMSRXLEX[MPPFIYWIHXSKIRIVEXIXLILEWL
ZEPYIWJSVXLIGPYWXIVJSVI\EQTPI
13( GSPYQRC'SPYQRC 

2EQI8]TI
0IRKXLERH7GEPI

)RXIVXLIHIXEMPWSJXLIXEFPIGSPYQRWJSVXLIGPYWXIV
8SEHHXEFPIGSPYQRWVMKLXGPMGOGLSSWI%HH
'SPYQRERHXLIRWTIGMJ]XLIGSPYQRHIXEMPW

3RXLI7XSVEKIXEFWIXXLIJSPPS[MRKSTXMSRW
 XLIPIZIPSJ4EVEPPIPTVSGIWWMRKJSVXLIGPYWXIV XLMWGERFIXLI(IJEYPX
ZEPYI234%6%00)0SVXLIZEPYIVITVIWIRXMRKXLIRYQFIVSJ
WGERRMRKSVWSVXMRKTVSGIWWIWWXEVXIHJSVEUYIV]EXSRIXMQI 
 WXSVEKI
 XLI7XSVEKI'PEYWISTXMSRWJSVXLIGPYWXIVWXSVEKI

8SYTHEXIXLIHEXEFEWIGPMGO7EZI

360

SQL Navigator Users Guide

To alter a cluster
1
2

3TIRE'PYWXIVWRSHI
7IPIGXEGPYWXIVSFNIGXJVSQXLIPMWX

3
4

6MKLXGPMGOERHWIPIGX%PXIV'PYWXIV|
1SHMJ]XLIMRJSVQEXMSRSRXLIIHMXSVEWVIUYMVIH

'PMGO7EZIXSYTHEXIXLIHEXEFEWI[MXL]SYVGLERKIWSVGPMGO6IZIVXXS
VIQSZIEPPGLERKIWQEHIWMRGIXLIPEWXWEZI 

Editing tables
9WIXLI8EFPI)HMXSVXSGVIEXIEPXIVHIJMRIERHHVSTXEFPIW
%PXLSYKL]SY[SR
XRIIHXSX]TIER]40750GSHI[LIRIHMXMRKXEFPIWMR750
2EZMKEXSV]SYWLSYPHFIJEQMPMEV[MXL3VEGPIVYPIWERHKYMHIPMRIWJSVYWMRK
XEFPIW
8LIGLEVEGXIVMWXMGWERHYWEKISJXLMWHEXEFEWISFNIGXEVIHIWGVMFIHMR3VEGPI
HSGYQIRXEXMSR
Be sure to place double quote marks around any
non-numerical data you enter in the default
column.
If non-numerical data is not enclosed in quotes,
then error message 'ORA-00984: column not
allowed here' is returned.

Shortcuts for editing tables


8LIVIEVIWIZIVEP[E]WMR[LMGL]SYGERIEWMP]QSZII\MWXMRKXEFPISVGSPYQR
HIJMRMXMSRWMRXS]SYVIHMXMRK[MRHS[=SYGERXLIRIHMXXLIVIWYPXMRKGSHIMJ
VIUYMVIH

Chapter 8

Working with database objects

To

361

Do this

:MI[XLIGSPYQRREQIWERHXLI
HEXEGSRXEMRIHMRERI\MWXMRK
XEFPIHMWTPE]IHMREKVMHJSVQEX
[MXLXLISTXMSRXSGST]ERHTEWXI
XLIGSPYQRWMRXSERIHMXSV

-RXLI(&2EZMKEXSVWIPIGXXLI
XEFPIXLIRGPMGOXLI5YMGO
&VS[WI(EXEXSSPFEVFYXXSR



:MI[XLIWXVYGXYVISJERI\MWXMRK
XEFPIERHHVEKXEFPIGSPYQR
HIJMRMXMSRWMRXSERIHMXMRK
[MRHS[

-RXLI(&2EZMKEXSVWIPIGXXLI
XEFPIXLIRGPMGOXLI(IWGVMFI
XSSPFEVFYXXSR



6IZIVWIIRKMRIIVERI\MWXMRK
XEFPIERHQSZIXLI((0MRXSXLI
IHMXMRK[MRHS[

-RXLI(&2EZMKEXSVWIPIGXXLI
XEFPIXLIRGPMGOXLI)\XVEGX
((0XSSPFEVFYXXSR

&YMPHEGSQTPI\UYIV]YWMRKXLI
HVEKERHHVSTJIEXYVIWSJXLI
5YIV]&YMPHIVXLIRTEWXIXLI
UYIV]MRXSERIHMXMRK[MRHS[

-RXLI(&2EZMKEXSVWIPIGXXLI
XEFPIXLIRGPMGOXLI&VS[WI
(EXEXSSPFEVFYXXSR



8VYRGEXIERI\MWXMRKXEFPIXLEX
MWVIQSZIEPPVS[WJVSQXLIXEFPI
ERHVIWIXXLI7836%+)
TEVEQIXIVWXSXLIZEPYIW[LIR
XLIXEFPISVGPYWXIV[EWGVIEXIH

-RXLI(&2EZMKEXSVWIPIGXXLI
XEFPIXLIRGPMGOXLI8VYRGEXI
XSSPFEVFYXXSR





Optimizing tables
=SYGERYWIXLI%REP]^IXSSPXSZMI[ERHGSPPIGXWXEXMWXMGWZEPMHEXIWXVYGXYVI
ERHPMWXGLEMRIHVS[WJSVHEXEFEWIXEFPIWGPYWXIVWERHMRHI\IW 

To analyze a table
 -RXLI(&2EZMKEXSVWIPIGXXLIXEFPIXLIRGPMGOXLI%REP]^IFYXXSR
SV
 -RXLI8EFPI)HMXSVGPMGOXLI:MI[FYXXSRXLIRGLSSWIXLIVIUYMVIHSTXMSR

Populating tables using Data Factory


(EXE*EGXSV]MWEXSSPJSVKIRIVEXMRKXIWXHEXEERHMRWIVXMRKMXMRXSEHEXEFEWI
(EXE*EGXSV]GERKIRIVEXIFSXLVERHSQERHQIERMRKJYPHEXE)\EQTPIWSJ
VERHSQHEXEMRGPYHIVERHSQRYQFIVWVERHSQGLEVEGXIVWERHVERHSQHEXIW

362

SQL Navigator Users Guide

)\EQTPIWSJQIERMRKJYPHEXEMRGPYHIJMVWXREQIWPEWXREQIWGMXMIWWXEXIWERH
^MTGSHIW 
-J]SYLEZI(EXE*EGXSV]MRWXEPPIH]SYGERPEYRGLMXJVSQXLI8SSPWQIRYSV
XLI*YRGXMSRWXSSPFEV
8LI(EXE*EGXSV]XSSPFEVMGSR

Browsing objects in tables


Object Viewer
=SYGERIEWMP]ZMI[EXXVMFYXIWSJSFNIGXX]TIWERHGSPPIGXMSRX]TIWMRGSPYQRW
MRVIPEXMSREPXEFPIW
8LMWZIVWMSRSJ7502EZMKEXSVMRGPYHIWER3FNIGXZMI[IVXLEXTVSZMHIWE
KVETLMGEPZMI[SJ3VEGPISFNIGXWMRXEFPIGSPYQRW
=SYGERPEYRGLXLI3FNIGX:MI[IVMRXLVII[E]W
 FVS[WMRKEXEFPIGSRXEMRMRKSFNIGXGSPPIGXMSRSVVIJIVIRGIGSPYQRW
 I\IGYXMRKEUYIV]MRXLI750)HMXSVXLEXVIXYVRWSFNIGXGSPPIGXMSRSV
VIJIVIRGIGSPYQRW
 I\IGYXMRKEWXSVIHTVSGIHYVIXLEXVIXYVRWSFNIGXGSPPIGXMSRSVVIJIVIRGI
GSPYQRW

To launch the Object Viewer from the results returned by a


stored procedure
1
2

-RXLI)\IGYXMSR'SHI[M^EVHWIPIGXXLI9WI&MRH:EVMEFPIWSTXMSR
-RXLIVIWYPXWIXJMRHXLIGIPPPEFIPIH 3FNIGX SV 6IJIVIRGI ERHXLIRGPMGO
XLIGIPP
WFYXXSR

LOB Viewer
8LIVIMWIRLERGIHWYTTSVXJSVZMI[MRKPEVKISFNIGXW 03&W =SYGERPEYRGLE
03&ZMI[IVJVSQXLI750)HMXSVSVXLI)\IGYXMSR'SHI[M^EVH'03&&03&
ERH&*-0)EVKYQIRXWEVIWYTTSVXIH EWEVI3FNIGXERH'SPPIGXMSR8]TIW MJ
]SYYWIFMRHZEVMEFPIWJSVXLISYXTYX

To launch the LOB Viewer from the table browser or SQL Editor
1
2

7IPIGXXLISFNIGXMRXLIXEFPI]SY[ERXXSZMI[
-RXLIKVMHHMWTPE]GPMGOXLIFYXXSRXLEXETTIEVWMRXLIGIPPGSRXEMRMRKXLI
SFNIGX

Chapter 8

Working with database objects

363

Viewing BFILE datatypes


1
2

0EYRGLXLIZMI[IVEWHIWGVMFIHEFSZI
8SXSKKPIFIX[IIR,)<ERHMQEKIVITVIWIRXEXMSRMRXLIZMI[IVGPMGOXLI
FYXXSRSRXLI3FNIGX:MI[IVXSSPFEV
SQL Navigator does not support working with
LOB or Object table columns when using an
Oracle 7 client connected to Oracle 8 database.
For full functionality, use an Oracle 8 client to
connect to an Oracle 8 database.

Editing nested tables


%RIWXIHXEFPIX]TIMWERYRSVHIVIHWIXSJIPIQIRXW8LIIPIQIRXWQE]FIFYMPX
MRHEXEX]TIWSVYWIVHIJMRIHX]TIW=SYGERZMI[ERIWXIHXEFPIEWEWMRKPI
GSPYQRXEFPISVMJXLIRIWXIHXEFPIMWERSFNIGXX]TIEWEQYPXMGSPYQRXEFPI
[MXLEGSPYQRVITVIWIRXMRKIEGLEXXVMFYXISJXLISFNIGXX]TI
9WIXLIRIWXIHXEFPIIHMXSV[LIR]SYVIUYMVIEPEVKIIJJMGMIRXGSPPIGXMSR
%RIWXIHXEFPIHIJMRMXMSRHSIWRSXEPPSGEXIWTEGI-XHIJMRIWEHEXEX]TI[LMGL
GERXLIRFIYWIHXSHIGPEVI
 GSPYQRWSJEVIPEXMSREPXEFPI
 SFNIGXX]TIEXXVMFYXIW
 40750ZEVMEFPIWTEVEQIXIVWERHJYRGXMSRVIXYVRZEPYIW
;LIRERIWXIHXEFPIETTIEVWEWXLIX]TISJEGSPYQRMREVIPEXMSREPXEFPISVEW
EREXXVMFYXISJXLIYRHIVP]MRKSFNIGXX]TISJERSFNIGXXEFPI3VEGPIWXSVIWEPP
SJXLIRIWXIHXEFPIHEXEMREWMRKPIXEFPI[LMGLMXEWWSGMEXIW[MXLXLIIRGPSWMRK
VIPEXMSREPSVSFNIGXXEFPI
8LIGLEVEGXIVMWXMGWERHYWEKISJXLMWHEXEFEWISFNIGXEVIHIWGVMFIHMR3VEGPI
HSGYQIRXEXMSR

To create a nested table


1

2
3
4

7IPIGXXLI2IWXIH8EFPIWRSHIERHJVSQXLI%GXMSRWQIRYGLSSWI'VIEXI
2IWXIH8EFPI8]TI|
SV
-RERSTIRRIWXIHXEFPIIHMXSVVMKLXGPMGOERHWIPIGX2I[
-RXLI2I[2IWXIH8EFPI8]TI[MRHS[JVSQXLI7GLIQEPMWXWIPIGXE
WGLIQEXS[LMGLXLIRIWXIHXEFPI[MPPFIPSRK
-RXLI2EQIJMIPHX]TIEREQIJSVXLIRIWXIHXEFPIERHXLIRGPMGO3/
-RXLI(IXEMPWXEFWIXXLISTXMSRWJSVXLIRIWXIHXEFPIX]TIEGGSVHMRKXSXLI
JSPPS[MRKPMWX

364

SQL Navigator Users Guide

(EXEX]TI
WGLIQE

WIPIGXIMXLIV
7'%0%68=4)"MJ]SY[MWLXSYWIETVIHIJMRIH
3VEGPIX]TI
SV
 XLIREQISJEWGLIQEXLEXGSRXEMRWEYWIVHIJMRIH
ZEVVE]X]TI

(EXEX]TI

WIPIGXXLIHEXEX]TIJSVXLIGSPPIGXMSRJSVI\EQTPI
()'-1%0-28)+)6',%6%'8)6

0IRKXL

WIXXLIQE\MQYQRYQFIVSJIPIQIRXWEPPS[IHMRXLI
RIWXIHXEFPIMJETTVSTVMEXI

7GEPI

WIXXLIGSPPIGXMSRHEXEX]TIWGEPIMJETTVSTVMEXI

8SYTHEXIXLIHEXEFEWIGPMGO7EZI

Editing triggers
9WIXLI8VMKKIV)HMXSVXSGVIEXIEPXIVHMWEFPIHVSTIREFPIERHGSQTMPI
XVMKKIVW
%XVMKKIVMWEWXSVIHWYFTVSKVEQI\IGYXIH[LIREWTIGMJMGSTIVEXMSRWYGLEW
MRWIVXMRKEVS[SGGYVWSREWTIGMJMGXEFPI
8VMKKIVWEVIWMQMPEVXSWXSVIHTVSKVEQWI\GITXJSVXLIJSPPS[MRKHMJJIVIRGIW
 8VMKKIVWEVIHIJMRIHSRP]JSVXEFPIW
 8VMKKIVWEVIMQTPMGMXP]I\IGYXIH[LIRXLIEWWSGMEXIHXEFPIMWQSHMJMIH
 8VMKKIVWGERFIJMVIHSRP]F]SRISJXLIJSPPS[MRKEGXMSRWSREXEFPI
Update
Insert
Delete

-R7502EZMKEXSVTVSGIHYVIWJSVMRZSOMRKERHIHMXMRKXVMKKIVWEVIWITEVEXI
JVSQXLSWIJSVWXSVIHTVSGIHYVIWJYRGXMSRWERHTEGOEKIHTVSGIHYVIW
=SYGERHIFYKXVMKKIVWYWMRKXLI7502EZMKEXSV(IFYKKIV
8LIGLEVEGXIVMWXMGWERHYWEKISJXLMWHEXEFEWISFNIGXEVIHIWGVMFIHMR3VEGPI
HSGYQIRXEXMSR

Timing of triggers
=SYGERWTIGMJ][LIXLIVEXVMKKIVMWE&IJSVIXVMKKIVSVER%JXIVXVMKKIVXLEX
MW[LIXLIVMXMWI\IGYXIHFIJSVISVEJXIVXLIXVMKKIVMRKIZIRX

Chapter 8

Working with database objects

365

 &IJSVIXVMKKIVWGERFIYWIHXSHIGMHI[LIXLIVEWXEXIQIRXWLSYPHGSQTPIXI
 %JXIVXVMKKIVWZEPMHEXIXLISTIVEXMSREJXIVXLIWXEXIQIRXLEWFIIRI\IGYXIH
ERHEPPS[VSPPFEGOSJXLIGLERKIWMJXLIVIEVII\GITXMSRW

Row or statement?
-REHHMXMSRXSXLIXMQMRK]SYGERWTIGMJ][LIXLIVXLIXVMKKIVSGGYVWFIJSVISV
EJXIVXLI6S[SVXLI7XEXIQIRX&]HIJEYPXXLIHEXEFEWIXVMKKIVJMVIWSRGITIV
XEFPI,S[IZIV]SYGERJSVGIXLIXVMKKIVXSJMVIJSVIZIV]VS[EJJIGXIHF]XLI
XVMKKIVMRKIZIRX*SYVTSWWMFMPMXMIWEVITIVQMXXIH
 &IJSVI6S[
 %JXIV6S[
 &IJSVI7XEXIQIRX
 %JXIV7XEXIQIRX
=SYGEREPWSVIWXVMGXEXVMKKIVXSJMVISRP]SREWIPIGXWIXSJVS[WF]YWMRKXLI
;,)2GSRHMXMSRXSWTIGMJ]EGSRWXVEMRXGLIGO

"Instead of" triggers


3VEGPITVSZMHIWERI[STXMSRJSVXVMKKIVWXLEXEPPS[WQSHMJ]MRKZMI[WXLEX
GERRSXFIQSHMJMIHHMVIGXP]XLVSYKL-RWIVX9THEXIERH(IPIXIWXEXIQIRXW
-RWXIEHXLIXVMKKIVTIVJSVQWXLI750STIVEXMSRWSRXLIYRHIVP]MRKXEFPIW8LMW
XVMKKIVSTXMSRMWGEPPIH-RWXIEHSJFIGEYWI3VEGPIJMVIWXLIXVMKKIVMRWXIEHSJ
I\IGYXMRKXLIXVMKKIVMRKWXEXIQIRXERHXLIXVMKKIVXEOIWGEVISJER]
QSHMJMGEXMSRWXSXLIXEFPIW

Setting trigger editor preferences


=SYGERYWIXLI)HMXSV4VIJIVIRGIWHMEPSKXSGYWXSQM^IXLIETTIEVERGIERH
FILEZMSVSJXLIXVMKKIVIHMXSV8LITVIZMI[EXXLIFSXXSQSJXLI[MRHS[
HMWTPE]WXLIVIWYPXWSJ]SYVGLSMGIW

To set preferences
 'LSSWI:MI["4VIJIVIRGIW")HMXSVWXLIRWIPIGX4VSGIHYVI8VMKKIV

366

SQL Navigator Users Guide

Default settings for Trigger edtor


7LS[WXEXYWTERIP

(MWTPE]WXLIWXEXYWTERIPEYXSQEXMGEPP]

;VETGYVWSVEXIRHSJ
PMRI

8I\XIHMXMRKJIEXYVI[VETWXI\XEYXSQEXMGEPP]EX
XLIIRHSJEPMRI

%YXSMRHIRX

%YXSQEXMGEPP]MRHIRXWXI\X

(SYFPIGPMGOTEWXIWMRXS
IHMXSV

4EWXIWGSHIMRXSXLIIHMXSV[LIR]SYHSYFPIGPMGO
XLIPIJXQSYWIFYXXSR

8EFWX]PI

9WIWWTEGIWMRWXIEHSJXLIXEFGLEVEGXIV

8EFWM^I

-RHMGEXIWXLIXEF[MHXL

*SRX

'PMGOXSSTIRXLIJSRXHMEPSKXSGLERKIXLIJSRX
WM^IWERHWX]PI

7]RXE\LMKLPMKLXMRK

(IJEYPXMWSRXSHMWTPE]XLIWX]PI 'PEWWMG
8[MPMKLXSV'YWXSQ XLEX[MPPGLERKIXLIGSPSVW
ERHWGLIQESJW]RXE\LMKLPMKLXMRKETTPMIHMRXLI
IHMXSV

7GER'SQQIRXW

8SKKPISRJSVWQEPPJMPIWERHSJJJSVPEVKIJMPIWXS
MRGVIEWIIHMXMRKWTIIH

Debugging triggers
=SYGERHIFYKXVMKKIVWYWMRKXLI(&17C398498TEGOEKISV]SYGERYWI
XLISTXMSREP40750HIFYKKIV
(IFYKKMRKXVMKKIVWMR7502EZMKEXSVVIUYMVIWHMJJIVIRXWXITWJVSQXLSWI
VIUYMVIHJSVHIFYKKMRK40750TVSGIHYVIWSVJYRGXMSRW
=SYGERRSXHMVIGXP]I\IGYXIEXVMKKIVEW]SYGERRSVQEPP]HS[MXL40750
TVSGIHYVIWERHJYRGXMSRW
=SYGERJMVIEXVMKKIVSRP]MRHMVIGXP]F]EGXMZEXMRKXLITEVXMGYPEV750(10
STIVEXMSR -27)68()0)8)SV94(%8) XLEXXLIXVMKKIV[EWHIWMKRIHXS
VIWTSRHXS=SYGERHSXLMWYWMRK-27)68()0)8)SV94(%8)WXEXIQIRXW
I\IGYXIHJVSQERERSR]QSYW40750FPSGO
)<%140)
begin
insert into tab1 values(1,2,3);
end;

Chapter 8

Working with database objects

367

%PXIVREXMZIP]]SYGEREGXMZEXIXLI750(10STIVEXMSRF]MRWIVXMRKYTHEXMRK
SVHIPIXMRKJVSQXLIUYIV]VIWYPXKVMHMRXLI750)HMXSV

To debug a trigger using the optional PL/SQL debugger


1
2

1EOIWYVI40750HIFYKKMRKMWSR
)\IGYXIXLIETTVSTVMEXI-27)6894(%8)SV()0)8)WXEXIQIRXJVSQ
ERERSR]QSYW40750FPSGO EWHIWGVMFIHEFSZI SVMRXLI7MRKPI750
)HMXSV

Interpreting compilation errors


;LIR]SYWEZIERSFNIGXYWMRKXLISFNIGXIHMXSV(&2EZMKEXSVEYXSQEXMGEPP]
GSQTMPIWHITIRHIRXSFNIGXWERHVITSVXWXLIWXEXYWGLERKI
;LIREGSQTMPEXMSRIVVSVMWIRGSYRXIVIHMRXLIXVMKKIVFSH]7502EZMKEXSV
LMKLPMKLXWXLIGSVVIWTSRHMRKGSHIMRXLIWSYVGIGSHIIHMXSV
;LIREGSQTMPEXMSRIVVSVMWIRGSYRXIVIHMRXLIXVMKKIVWTIGMJMGEXMSR XLEXMWMR
XLIWhenGPEYWI XLIIVVSVEPSRK[MXLXLI750XI\XMWHMWTPE]IHMRXLI3YXTYX
[MRHS[
Oracle does not save the trigger source into the
database if there are compilation errors.

ORA-4076 Invalid NEW or OLD Specification


;LIRXLIPSGEXMSRSJXLIIVVSVMWRSXETTEVIRXQEOIWYVIXLEX]SYGLIGOXLI
;,)2GPEYWI
%PPVIJIVIRGIWXSGSPYQRREQIWMRE;,)2GPEYWIQYWXFITVIJM\IHF]2);
SV30((SRSXTVIJM\XLI2);SV30([MXLEGSPSR  MRXLI;,)2
GPEYWI
NEW.SAL > OLD.SAL

ORA-904 Invalid Column Name


8LMWIVVSVSGGYVW[LIR]SYYWIERMRZEPMHGSPYQRREQIMRXLI;,)2GPEYWI
SVXLIFSH]SJXLIXVMKKIV-JXLIPSGEXMSRSJXLIIVVSVMWRSXETTEVIRXQEOI
WYVIXLEX]SYGLIGOXLI;,)2GPEYWI
Do not prefix the column name with a colon (:) in
the WHEN clause. Always prefix the column name
with a colon (:) in the trigger body, (that is, in the
PL/SQL block).

368

SQL Navigator Users Guide

ORA-4082 NEW or OLD Not Allowed in Statement Level Triggers


8LMWIVVSVSGGYVW[LIR]SYXV]XSYWIGSPYQRZEPYIWMRE78%8)1)28
XVMKKIVERHTVIJM\[MXL2);SV30(WTIGMJMGEXMSRW7MRGIXLI78%8)1)28
XVMKKIVI\IGYXIWSRP]SRGIJSVXLIXVMKKIVMRKWXEXIQIRXMXHSIWRSXLEZIEGGIWW
XSXLIMRHMZMHYEP63;ZEPYIW

PLS Errors
%PPIVVSVW[MXLXLI407JSVQEX JSVI\EQTPI407)VVSVPMRIGSP VIJIVXS
XLIFSH]SJXLIXVMKKIV8LIPMRIERHGSPYQRRYQFIVWQIRXMSRIHHSRSX
GSVVIWTSRHHMVIGXP]XSXLIPMRIERHGSPYQRSJXLIXVMKKIVFSH]MRXLIIHMXSV
7502EZMKEXSVEYXSQEXMGEPP]TPEGIWXLIGYVWSVEXXLITSWMXMSRGSVVIWTSRHMRK
XSXLIIVVSVQIWWEKI

9
Tools for analysis and tuning

8LMWGLETXIVI\TPEMRWLS[]SYGERXYRI]SYVHEXEFWIWXVYGXYVIWYWMRKXLI750
2EZMKEXSV
W%RE]^IERH)\TPEMR4PERXSSPW

In this chapter
Analyzing database structures
Using the Explain Plan tool

370
372

370

SQL Navigator Users Guide

Analyzing database structures


=SYYWIXLI%REP]^IXSSPXSZMI[ERHGSPPIGXWXEXMWXMGWZEPMHEXIWXVYGXYVIERH
PMWXGLEMRIHVS[WJSVHEXEFEWIWXVYGXYVIWWYGLEWXEFPIWGPYWXIVWERHMRHI\IW
7502EZMKEXSVTVSZMHIWYWIJYPXSSPWJSVXYRMRKERHHEXEFEWIQEREKIQIRX
8LIWIMRGPYHI
 XLI%REP]^IXSSP[LMGLPIXW]SYZMI[ERHGSPPIGXWXEXMWXMGWZEPMHEXI
WXVYGXYVIERHPMWXGLEMRIHVS[WJSVHEXEFEWIWXVYGXYVIWWYGLEWXEFPIW
GPYWXIVWERHMRHI\IW
 XLI)\TPEMR4PERXSSP[LMGLPIXW]SYGVIEXIWXSVIERHFVS[WI)\TPEMR
TPERW
8LI%REP]^IXSSPGERFIYWIHMRGSRNYRGXMSR[MXLXLI)\TPEMR4PERXSSP8LI
)\TPEMR4PER8SSPHSIWRSXEREP]^IXEFPIWMXWIPJTVMSVXSI\IGYXMRKXLI)\TPEMR
4PERFYXMXHSIWLEZIEXSSPFEVFYXXSRJSVQERYEPPEYRGLSJXLI%REP]^I8SSP
8LI%REP]^IXSSPKMZIW]SYEGGIWWXSXLIJSPPS[MRKGSQQERHW
 'SPPIGX7XEXMWXMGW
 :EPMHEXI7XVYGXYVI
 0MWX'LEMRIH6S[W

To open an object for statistical analysis


 -RXLI(&2EZMKEXSVWIPIGXEXEFPIGPYWXIVSVMRHI\RSHIXLIRGPMGOXLI
%REP]^IFYXXSR
SV
 7IPIGXERSHIMRXLI)\TPEMR4PERXSSPXLIRGPMGOXLI:MI['SPPIGX7XEXMWXMGW
XSSP

Chapter 9

Tools for analysis and tuning

371

To view and collect statistics

7IPIGXXLIWGLIQE]SY[ERXXS[SVO[MXL
-RXLI'SPPIGX7XEXMWXMGW[MRHS[WIPIGXXLISFNIGXX]TIMRXLI3FN8]TI
KVSYTFS\
7IPIGXXLISFNIGXJVSQXLI3FNIGXHVSTHS[RPMWX

7IPIGXEGSPPIGXMSRQIXLSHJVSQXLIJSPPS[MRKPMWX

1
2

Collection Method

Description

'SQTYXI7XEXMWXMGW

%RIRXMVISFNIGXMWWGERRIHXSKEXLIVHEXEEFSYX
XLISFNIGX8LIPEVKIVXLISFNIGXXLIPSRKIVMXXEOIW
XSGSQTPIXIXLIEREP]WMW'LSSWIXLMWSTXMSRSRP]MJ
XLISFNIGXMWWQEPP

)WXMQEXI7XEXMWXMGW

7EQTPIF]VS[WSVTIVGIRXEKISJXLISFNIGX
%GGYVEG]SJIWXMQEXIHWXEXMWXMGWHITIRHWSRXLI
VITVIWIRXEXMZIWSJXLIWEQTPMRK'LSSWIXLMWSTXMSR
JSVPEVKISFNIGXW

(IPIXI7XEXMWXMGW

8LMWSTXMSR[MPPHIPIXIXLIWXEXMWXMGWKEXLIVIHJSV
XLISFNIGX

'PMGOXLI'SPPIGX7XEXMWXMGWFYXXSR

Validating object structure


:EPMHEXMRKWXVYGXYVIZIVMJMIWXLIMRXIKVMX]SJXEFPIWMRHI\IWSVGPYWXIVW3VEGPI
VIXYVRWERIVVSVQIWWEKIMJMXIRGSYRXIVWGSVVYTXMSRMRXLIWXVYGXYVISJER
SFNIGX=SYGERHVSTERHVIGVIEXIXLISFNIGXXSJM\MX

To validate the structure of a table, cluster or index


1
2

'PMGOXLI:EPMHEXI7XVYGXYVIXEF
-RXLI3FN8]TIKVSYTFS\WIPIGXXLISFNIGXX]TIXEFPIGPYWXIVSVMRHI\

3
4

7IPIGXEXEFPIGPYWXIVSVMRHI\JVSQXLISFNIGXPMWX
8SGLIGOER]HITIRHIRXSFNIGXWWIPIGX'EWGEHI*SVI\EQTPIMJ]SY
ZEPMHEXIXLIWXVYGXYVISJEGPYWXIVERHWIPIGX'EWGEHI7502EZMKEXSV
GLIGOWEPPXEFPIWERHMRHI\IWMRXLIGPYWXIV

372

SQL Navigator Users Guide

Listing chained rows


8LI0MWX'LEMRIH6S[WYXMPMX]GVIEXIWEPMWXSJXEFPIWGPYWXIVWSVMRHI\IW[MXL
GLEMRIHVS[W8LMWTVSGIWWMWMQTSVXERXXSIRWYVIXMQIP]XEFPIEGGIWWERH
SZIVEPPHEXEFEWITIVJSVQERGI
8SYWIXLMWJIEXYVI]SYQYWXLEZIXEFPIWMRXLIHEXEFEWIXSWXSVIXLMW
MRJSVQEXMSR'LSSWI:MI["4VIJIVIRGIW"+IRIVEP"(IJEYPX8EFPIWXSWTIGMJ]
XLIWXSVEKIPSGEXMSR

To list chained rows in a table, cluster or index


1
2

'PMGOXLI0MWX'LEMRIH6S[WXEF
7IPIGXXLISFNIGXX]TIWXEFPIGPYWXIVSVMRHI\

3
4

*VSQXLIHVSTHS[R3FNIGXPMWXFS\WIPIGXXLISFNIGX
8STPEGIXLIGLEMRIHVS[HEXEMRXSEXEFPIX]TIXLIXEFPIREQIMRXLI0MWX
'LEMRIH6S[WJMIPH
'PMGO'VIEXI'LEMRIH6S[W8EFPI%QIWWEKIETTIEVW[LIRXLIXEFPIMW
GVIEXIHWYGGIWWJYPP]
8SZMI[XLIGLEMRIHVS[WSRP]GPMGO0MWX'LEMRIH6S[W

5
6

Using the Explain Plan tool


9WIXLI)\TPEMR4PER[MRHS[XSEREP]^I750WXEXIQIRXWF]KIRIVEXMRKER
3VEGPII\IGYXMSRTPERERHXSZMI[SVTVMRXWXSVIHI\IGYXMSRTPERWTVIZMSYWP]
KIRIVEXIH

To change default preferences for the Explain Plan tool


1 *VSQXLI:MI[QIRYGLSSWI4VIJIVIRGIW")\TPEMR4PER
2

7IXXLIHIJEYPXS[RIVERHREQIJSVXLIXEFPI]SY[ERXXSYWIXSWXSVI
I\IGYXMSRTPERW

To execute an Explain Plan for a SQL Statement


1 -RXLI750)HMXSVGPMGOXLI750XEFERHXLIRX]TISVPSEHXLI750
2

WXEXIQIRX]SY[ERXXSMRZIWXMKEXI
7IPIGX F]LMKLPMKLXMRK SRISVQSVIWXEXIQIRXWXSFIEREP]^IH
%PXIVREXMZIP]MJ]SYWIPIGXRSRIEPPWXEXIQIRXWMRXLIIHMXMRK[MRHS[[MPP
FIEREP]^IH
8SHVEKERHHVSTER]STXMQM^IVLMRXMRXS]SYV750WGVMTXYWIXLI'SHI
%WWMWXERX

Chapter 9

Tools for analysis and tuning

5
6
7
8
9

373

-J]SYEVIVIUYMVIHXSWTIGMJ]XLIXEFPISVMRHI\REQI]SYGERYWIXLI1]
8EFPIWERH-RHI\IW2EZMKEXSVJMPXIVXSHVEKERHHVSTXLIXEFPIERHMRHI\
REQI =SYGERYWIER]2EZMKEXSVJMPXIVXSTIVJSVQXLIHVEKERHHVST
STIVEXMSR 
-JVIUYMVIH]SYGERIRXIVE7XEXIQIRX-(XSMHIRXMJ]XLIWXEXIQIRX[MXLMR
XLIGYVVIRXTPERXEFPI
8SWEZIXLI750EPSRK[MXLXLIKIRIVEXIHTPERWIPIGX7EZI750XI\X
-J]SY[ERXXSLEZIEGSQQIRXEFSYXXLIKIRIVEXIHTPERHMWTPE]MRXLI
+IRIVEXIH4PER&VS[WIVIRXIVMXMRXLI'SQQIRXJMIPH
=SYGERIRXIVXLI4PER8EFPI3[RIVSVYWIXLIHIJEYPXPMWXIH
=SYGERIRXIVXLI4PER8EFPI2EQISVYWIXLIHIJEYPXPMWXIH-JWTIGMJ]MRKE
RI[TPERXEFPIYWIXLI'VIEXI8EFPIFYXXSRXSGVIEXIXLIXEFPI

10 'PMGO

MRXLI*YRGXMSRWXSSPFEVXSMRZSOIXLI)\TPEMR4PERXSSP8LI
WXEXIQIRXWIPIGXIHMRXLI750)HMXSVETTIEVWMRXLIXSSP
W+IRIVEXI4PER
[MRHS[
11 'PMGO)\TPEMR4PERXSZMI[XLI3VEGPII\IGYXMSRTPERJSVXLIWXEXIQIRX

Viewing the Explain Plan tree


8LIKIRIVEXIHI\IGYXMSRTPERMWHMWTPE]IHMRXLIPS[IVTEVXSJXLI)\TPEMR4PER
[MRHS[=SYGERGPMGOSRRSHIWXSI\TERHERHGSPPETWIXLIQ

Printing the Explain Plan tree


=SYGERYWIXLI4VMRXGSQQERHJVSQXLI*MPIQIRYSVXLI4VMRXFYXXSRSR)HMX
XSSPFEVXSSYXTYX)\TPEMR4PERXVIIHEXEXSXLITVMRXIV8LIJSPPS[MRKHEXEMW
TVMRXIH
 8LI7507XEXIQIRXJVSQ[LMGLXLII\TPEMRTPERXVII[EWHIVMZIH
 7XEXIQIRX-(8]TI'SWXERH8MQIWXEQT
 8LI)\TPEMR4PERXVIIMRGPYHMRKXLII\IGYXMSRWIUYIRGIRYQFIVWMR
FVEGOIXW
8STVIZMI[]SYVSYXTYXYWIXLI4VMRXTVIZMI[GSQQERHJVSQXLI*MPIQIRY
When an Explain Plan tree printout exceeds one
page, the headings (such as the SQL Text and
statement ID lines) are not repeated. This makes it
easy for you to tile multiple pages together to
display the explain plan tree as a single diagram

374

SQL Navigator Users Guide

Viewing an Operation Description


=SYGERZMI[ERI\TPEREXMSRGEPPIHER3TIVEXMSR(IWGVMTXMSRSJZEVMSYW
RSHIW]SYWIPIGXMRXLI)\TPEMR4PERXVII8LI3TIVEXMSR(IWGVMTXMSR[MRHS[
HMWTPE]WERI\TPEREXMSRSJLS[IEGL750STIVEXMSRMWI\IGYXIHMRVIPEXMSRMR
XLI)\TPEMR4PER
=SYYWIEGLIGOFS\MRXLI)\TPEMR4PER[MRHS[XSHMWTPE]XLI3TIVEXMSR
(IWGVMTXMSR8LIWIXXMRK]SYWIPIGX[MPPFIWXSVIHMRXLIVIKMWXV]ERHVIMRWXEXIH
IEGLXMQI]SYEGXMZEXIXLI)\TPEMR4PER[MRHS[;LIR]SYGPSWIXLI)\TPEMR
4PER[MRHS[XLI3TIVEXMSR(IWGVMTXMSRJSVQMWEPWSGPSWIH

To view the Operation Description


 -RXLI)\TPEMR4PER[MRHS[WIPIGXXLI7LS[(IWGVMTXMSRGLIGOFS\ERH
XLIRWIPIGXERSHIMRXLI)\TPEMRTPERXVII

Browsing saved plans


=SYGERFVS[WIWEZIHI\IGYXMSRTPERW

To use the saved plans browser


1 -RXLI)\TPEMR4PER[MRHS[GPMGOXLI&VS[WI7EZIH4PERWXEF
2
3
4
5

)RXIVXLITPERXEFPIREQIERHS[RIV
'PMGOXLI0SEH4PERWFYXXSRXSPSEHTPERWWEZIHMRXLITPERXEFPI
9WIXLIWGVSPPFEVWXSPSGEXIEWEZIHTPER
'PMGOXLIWEZIHTPERXSHMWTPE]MXMRXLITPER[MRHS[

10
Version Control and Team Coding

8LMWGLETXIVI\TPEMRWLS[XSYWI7502EZMKEXSV[MXLXLMVHTEVX]ZIVWMSR
GSRXVSPW]WXIQWERHLS[XSYWI7502EZMKEXSV
WMRFYMPX8IEQ'SHMRK
JIEXYVIWHIWMKRIHXSTVSXIGX]SYVJMPIWJVSQYRGSRXVSPPIHYTHEXIWF]QYPXMTPI
YWIVW

In this chapter
Overview
Installing Team Coding options
Configuring Team Coding Options
Team Coding File Extension Options
Team Coding General options
Using Code Control Groups
Installing third-party version control products

376
389
393
395
396
400
410

376

SQL Navigator Users Guide

Overview
7502EZMKEXSVTVSZMHIWI\XIRWMZIERHJPI\MFPIMRFYMPX8IEQ'SHMRKGSRXVSPW
ERHMRXIKVEXMSR[MXLXLMVHTEVX]ZIVWMSRGSRXVSPW]WXIQW
8LI7502EZMKEXSV8IEQ'SHMRKQSHYPI
 TVSZMHIW40750(IZIPSTIVW[MXLXLIEFMPMX]XSHIZIPSTWXSVIHTVSKVEQW
4VSGIHYVIW*YRGXMSRW4EGOEKIW8VMKKIVWERH:MI[W MREGSSTIVEXMZI
QERRIV
 TVIZIRXWQYPXMTPI7502EZMKEXSVYWIVWQSHMJ]MRKXLIWEQISFNIGXW
GSRGYVVIRXP]XLVSYKLEGLIGOMRGLIGOSYXQIGLERMWQ
8LIWIJIEXYVIWEVIEZEMPEFPIXSEPPYWIVW[LIXLIVSVRSXXLI]EVIYWMRKEXLMVH
TEVX]ZIVWMSRGSRXVSPTVSHYGX
7502EZMKEXSVEPWS[SVOW[MXLEXLMVHTEVX]ZIVWMSRGSRXVSPTVSHYGXXS
QEMRXEMRVIZMWMSRLMWXSVMIW8LMWLETTIRWEYXSQEXMGEPP]MRXLIFEGOKVSYRHWS
]SYHSR
XLEZIXSPIEZI7502EZMKEXSVXSYTHEXI]SYVZIVWMSRGSRXVSPVIZMWMSR
LMWXSVMIWNYWXYWIXLI:IVWMSR'SRXVSP&VS[WIVJIEXYVI

Team Coding menu and toolbar





Chapter 10

Version control and team coding

377

,IVIEVIWSQILMKLPMKLXW
 *PI\MFPI'SHI'SRXVSP+VSYTW ''+W LIPT]SYGSRXVSPSFNIGXWJVSQSRI
SVQSVIWGLIQEWYWMRKGYWXSQM^EFPIKVSYTMRKW
 =SYGERSVKERM^ISFNIGXWMRXS''+WF]YWMRKSFNIGXQEWOWVITVIWIRXMRK
FSXLWTIGMJMGHEXEFEWISFNIGXWERHGSPPIGXMSRWSJWMQMPEVSFNIGXW F]YWMRK
XLI3VEGPI[MPHGEVH =SYGEREPWSWIXYTI\GPYWMSRQEWOWXSI\GPYHI
WTIGMJMGSFNIGXWJVSQE''+
 (IZIPSTIVWGERVIQETXLIMVWGLIQEWXSER]''+XLI7502%:C%(1-2
YWIVTVMZMPIKIWEVIRSXVIUYMVIH
 )ZIR[MXLSYXEXLMVHTEVX]ZIVWMSRGSRXVSPTVSHYGX]SYGERYWI''+WWS
XLEXVIJIVIRGIHSFNIGXW[MPPFIXVEGOIHF]8IEQ'SHMRK XLSYKL[MXLSYX
VIZMWMSRLMWXSV] 
 7GVMTXWEVIWYTTSVXIHMR:IVWMSR'SRXVSP
 %PPGSRJMKYVEXMSRHEXEMWWXSVIHMRXLIHEXEFEWIYRHIV8IEQ'SHMRK
GSRXVSP-RHMZMHYEP[SVOWXEXMSRWHSRSXRIIHXSFIGSRJMKYVIH
 %JPI\MFPIWIGYVMX]QSHIPQEOIWJYPPYWISJ3VEGPIWIGYVMX]JIEXYVIW

Using Team Coding features


8LI8IEQ'SHMRKQIRYERHXSSPFEVKMZI]SYEGGIWWXSXLI'LIGO-RERH
'LIGO3YXERHSXLIVVIPEXIHGSQQERHW HITIRHIRXSRGSRJMKYVEXMSRERH
TIVQMWWMSRW 
8LI7XEXYWGSQQERHSRXLI8IEQ'SHMRKQIRYWLS[W]SY
 [LMGLJIEXYVIWEVIEZEMPEFPI
 XLITVMZMPIKIWKVERXIHXSXLIGYVVIRXYWIV
 [LMGLZIVWMSRGSRXVSPTVSHYGXWYTTSVX(00WEVIMRWXEPPIH
 [LMGLSRIMWGYVVIRXP]MRYWI
=SYGEREPWSVIZMI[ER]IVVSVGSRHMXMSRWXLEXQE]FIEJJIGXMRKSTIVEXMSRSJ
8IEQ'SHMRKJYRGXMSREPMX]

Viewing and changing status of objects under Team


Coding control
8LI8IEQ'SHMRK:MI[IVWLS[WHIXEMPWSJSFNIGXWYRHIV8IEQ'SHMRK
GSRXVSPMRGPYHMRK[LMGLSFNIGXWEVIGYVVIRXP]GLIGOIHSYXERH[LIRXLI][IVI
PEWXGLIGOIHMR'LIGOIHSYXSFNIGXWEVIJPEKKIH[MXLXLI'LIGO3YXMGSR 
8LI'LIGO3YXMGSR

378

SQL Navigator Users Guide

=SYGERGLIGOSYXSVGLIGOMRSFNIGXWHMVIGXP]JVSQXLMW[MRHS[ERH [MXL
ETTVSTVMEXITVMZMPIKIW ]SYGEREPWSJVII^ISFNIGXWWSXLEXXLI]GERRSXFI
QSHMJMIHF]SXLIVYWIVW
8LIPMWXSJSFNIGXWWLS[RMRXLI8IEQ'SHMRK:MI[IVGERFIPMQMXIHXSNYWX
XLSWIMR[LMGL]SYEVIMRXIVIWXIH9WIXLI8IEQ+VSYT*MPXIVHMEPSKXSWTIGMJ]
[LMGLSFNIGXWWLSYPHFIWLS[R



To open the Team Coding Viewer


*VSQXLI8IEQ'SHMRKQIRYGLSSWI8IEQ'SHMRK:MI[IV

To set a filter for the Team Coding Viewer


1
2

-RXLI8IEQ'SHMRK:MI[IVXSSPFEVGPMGOXLI*MPXIVFYXXSR
-RXLI8IEQ+VSYT*MPXIV[MRHS[TPEGIEGLIGOQEVORI\XXSXLIWGLIQE
SFNIGXX]TIW]SY[ERXXSFIWLS[RERHGPIEVXLISRIWXLEXWLSYPHRSXFI
WLS[R

Chapter 10

Version control and team coding

379

Table of Team CodingStatus descriptors

Status

Meaning

Editable?

Actions
allowed

k9RGSRXVSPPIHk

RSXYRHIV8IEQ'SHMRK
GSRXVSP

IHMXEFPI

2SRI

k%ZEMPEFPIk

EZEMPEFPIJSVGLIGOSYX

VIEH
SRP]

'LIGOSYX

IHMXEFPI

9RHS
GLIGOSYX

k'LIGOIH
3YXk

GLIGOIHSYXXS]SY

*VII^I

'LIGOMR
*VII^I
k0SGOIHk

GLIGOIHSYXXSERSXLIV
YWIV

VIEH
SRP]

*VII^I

k*VS^IRk

JVS^IR

VIEH
SRP]

9RJVII^I

k(MWEFPIHk

HMWEFPIHHYIXSE8IEQ
'SHMRKWTIGMJMGIVVSV

VIEH
SRP]

2SRI

Freezing and unfreezing objects


9WIVW[MXLXLI0)%()6VSPIGERJVII^IERHYRJVII^ISFNIGXWMRXLI8IEQ
'SHMRK:MI[IV

Deleting objects from the Team Coding Viewer list


9WIVW[MXLXLI0)%()6VSPIGERJVII^IERHYRJVII^ISFNIGXWMRXLI8IEQ
'SHMRK:MI[IV

Team Coding status in editor status bar


;LIR]SYSTIRERSFNIGXSVWGVMTXYRHIV8IEQ'SHMRKGSRXVSPMRERIHMXSV
XLIIHMXSVWXEXYWFEV RIEVXLIPS[IV[MRHS[FSVHIV WLS[WXLISFNIGX
W8IEQ
'SHMRKWXEXYW8LIJSPPS[MRKI\EQTPIWLS[WE4VSGIHYVISTIRMRXLI7XSVIH
4VSKVEQ)HMXSV8LI8IEQ'SHMRKXSSPFEVFYXXSRWERHXLI8IEQ'SHMRK
WXEXYWFS\MRHMGEXIXLEXXLITVSGIHYVIMWEZEMPEFPIXSFIGLIGOIHSYX

380

SQL Navigator Users Guide

8IEQ'SHMRKXSSPFEVFYXXSRW

8IEQ'SHMRKWXEXYWFS\
Team Coding terms and abbreviations
Term

Meaning

Description

4VSZMHIV

:IVWMSR'SRXVSP
4VSZMHIV

%XLMVH4EVX]:IVWMSR
'SRXVSPTVSHYGXWYGLEW
JSVI\EQTPI 4:'7
:IVWMSR1EREKIV

:'4

4VSZMHIV(00

%JMPIXLEXTVSZMHIW750
2EZMKEXSVWYTTSVXJSV
XLMVHTEVX]ZIVWMSRGSRXVSP
TVSHYGXW

''+

'SHI'SRXVSP+VSYT

7IXSJHEXEFEWISFNIGXWERH
WGVMTXQEWOWMHIRXMJ]MRK
[LMGLSFNIGXWEVIYRHIV
8IEQ'SHMRKGSRXVSP
[LMGL4VSZMHIVTVSNIGXXLI]
EVIVIPEXIHXS

Chapter 10

Version control and team coding

381

Checking objects and scripts in and out


8LIXIEQ'SHMRKERH:IVWMSR'SRXVSPQIRYERHXSSPFEVGSQQERHWEVI
EZEMPEFPISRWIPIGXIHSFNIGXWMRXLIJSPPS[MRK7502EZMKEXSV[MRHS[W
 (&2EZMKEXSV
 *MRH3FNIGXW
 :IVWMSR'SRXVSP&VS[WIV
 8IEQ'SHMRK:MI[IV
 3FNIGXIHMXMRK[MRHS[W
=SYGEREPWSEGGIWWXLI'LIGO-RERH'LIGO3YXGSQQERHWJVSQXLIWLSVXGYX
QIRYMRXLI(&2EZMKEXSVERHXLI*MRH3FNIGXW[MRHS[

Team Coding menu and toolbar



-JXLI%YXSQEXMG'LIGO-RERH%YXSQEXMG'LIGO3YXJIEXYVIWEVIIREFPIH
XLIR]SYEVIEYXSQEXMGEPP]TVSQTXIHXSGLIGOSYXXLIMXIQ[LIR]SYSTIRMX
ERHXSGLIGOMXMR[LIR]SYGPSWIMX
-JXLI%YXSQEXMG'LIGO-RERH%YXSQEXMG'LIGO3YXJIEXYVIWEVIRSXIREFPIH
]SYGERQERYEPP]MRMXMEXIXLIGLIGOMRSVGLIGOSYXZMEGSQQERHWSRXLI
8IEQ'SHMRKQIRY

382

SQL Navigator Users Guide

To check out an object or script when Automatic Check-Out is


enabled
1
2

3TIRXLISFNIGXSVWGVMTXMRXLISFNIGXIHMXSVSV750)HMXSV
;LIRXLI'LIGO3YXHMEPSKETTIEVWJSPPS[XLITVSQTXWXSGLIGOXLIMXIQ
SYXSVGLSSWI'ERGIPXSSTIRMXMRVIEHSRP]QSHI

To check in an object or script when Automatic Check-In is


enabled
1

'PSWIXLISFNIGXSVWGVMTXMRXLISFNIGXIHMXSVSV750)HMXSV

;LIRXLI'LIGO-RHMEPSKETTIEVWJSPPS[XLITVSQTXWXSGLIGOXLIMXIQ
MR

To check items in and out manually


1

3TIRXLISFNIGXSVWGVMTXMRXLISFNIGXIHMXSVSV750)HMXSV%PXIVREXMZIP]
WIPIGXXLISFNIGXMRER]SJXLIJSPPS[MRK7502EZMKEXSV[MRHS[W
 (&2EZMKEXSV
 *MRH3FNIGXW
 :IVWMSR'SRXVSP&VS[WIV
 8IEQ'SHMRK:MI[IV
 3FNIGXIHMXMRK[MRHS[W
*VSQXLI8IEQ'SHMRKQIRYSVXSSPFEVSVJVSQXLIWLSVXGYXQIRY
GLSSWI'LIGO-RSV'LIGO3YX=SYGEREPWSEGGIWWXLI'LIGO-RERH
'LIGO3YXGSQQERHWJVSQXLIWLSVXGYXQIRYMRXLI(&2EZMKEXSVERH
XLI*MRH3FNIGXW[MRHS[
=SYGERGLSSWI9RHS'LIGO3YXXSGERGIPXLIGLIGOSYXERHVIZIVWIER]
GLERKIW

Confirming the Undo action


;LIR]SYGLSSWIXSYRHSEGLIGOSYX]SYEVITVSQTXIHXSGSRJMVQXLEX]SY
[ERXXSVIWXSVIXLIWEZIHHEXEFEWIZIVWMSRSJXLIMXIQ EWMX[EWTVMSVXS
GLIGOSYX 



Chapter 10

Version control and team coding

383

-J]SYERW[IV2SERH]SYLEZIWEZIH]SYVGLERKIWXLIVIWYPX[MPPFIXLEXXLI
ZIVWMSRWEZIHMRXLI:'4VITSWMXSV][MPPFIHMJJIVIRXJVSQXLIZIVWMSRWEZIHMR
XLIHEXEFEWI

Getting the latest revision


;SVOMRKMREXIEQGSHMRKIRZMVSRQIRXMXMWSJXIRRIGIWWEV]JSV]SYXSIRWYVI
XLEX]SYEVI[SVOMRK[MXLXLIPEXIWXZIVWMSRSJERSFNIGXSVWGVMTXXLEXMWLIPH
MRXLI:'7VITSWMXSV]=SYGERYWIXLI+IX0EXIWX6IZMWMSRGSQQERHXS
TIVJSVQXLMWEGXMSR 
8LI+IX0EXIWX6IZMWMSRGSQQERHMWEZEMPEFPISRXLI8IEQ'SHMRKQIRYERH
XSSPFEV[LIRSFNIGXWEVIWIPIGXIHMRXLIJSPPS[MRK7502EZMKEXSV[MRHS[W
 (&2EZMKEXSV
 *MRH3FNIGXW
 :IVWMSR'SRXVSP&VS[WIV
 8IEQ'SHMRK:MI[IV
 3FNIGXIHMXMRK[MRHS[W
8LI+IX0EXIWX6IZMWMSRFYXXSR
Caution 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.

Entering comments with check-in or check-out


;LIR]SYGLIGOSFNIGXWMRSVSYX]SYGERIRXIVGSQQIRXWEFSYXXLI
QSHMJMGEXMSRMRXLI[MRHS[WLS[RLIVI

384

SQL Navigator Users Guide


8LIWIGSQQIRXWEVIZMWMFPIMRXLI8IEQ'SHMRK:MI[IV;LIREXLMVHTEVX]
:'4MWMRYWIXLIGSQQIRXWEVIEPWSPSKKIHEKEMRWXXLIRI[VIZMWMSRMRXLI
VITSWMXSV]
;LIRYWMRKE:'4XLI*SVGI6IZMWMSRSTXMSR[MPPFIEZEMPEFPIHYVMRKEGLIGO
MRSTIVEXMSR8LMWSTXMSREPPS[WSFNIGXWXLEXEVIYRGLERKIHXSFIYTHEXIHMR
XLIHEXEFEWIWSXLEXRI[SVGLERKIHGSQQIRXWGERFIWXSVIH

Browsing Version Control archives


=SYGERZMI[EPPZIVWMSRGSRXVSPEVGLMZIWMREPPTVSNIGXWYWMRKXLI750
2EZMKEXSV:IVWMSR'SRXVSP&VS[WIV
=SYGEREPWSZMI[HMJJIVIRGIWFIX[IIRVIZMWMSRWERHGLIGOSYXSFNIGXWERH
WGVMTXWYWMRKXLI:IVWMSR'SRXVSP&VS[WIV
8LMWFVS[WIVMWRSXEZEMPEFPIXSYWIVWSJ7''%4-8IEQ'SHMRKWYTTSVX
MRWXIEHWIPIGXMRKXLMWSTXMSRPEYRGLIWXLIYWIVMRXIVJEGISJXLIXLMVHTEVX]
TVSHYGXMRYWI

Chapter 10

Version control and team coding

385

To browse the version control repository


1
2

*VSQXLI8IEQ'SHMRKQIRYGLSSWI:IVWMSR'SRXVSP&VS[WIV
9WIXLI[MRHS[GSRXVSPWXSHVMPPHS[RXSER]VIZMWMSRSJER]JMPIZMI[
VIZMWMSRLMWXSVMIWGLIGOJMPIWMRSVSYXERHZMI[HMJJIVIRGIWFIX[IIR
VIZMWMSRW
 8SI\TERHERSHIGPMGOXLITPYWWMKRSVHSYFPIGPMGOXLIXI\XTSVXMSR
 8STIVJSVQEGXMSRWSRXLISFNIGXWIPIGXEGSQQERHJVSQXLIWLSVXGYX
QIRYSVXLI&VS[WIVXSSPFEV
 4SMRXXSER]XSSPFEVFYXXSRXSWIIEXSSPXMTHIWGVMFMRKMXWJYRGXMSR

Viewing differences between revisions


;LIR]SYGLSSWI:MI[(MJJIVIRGIWJVSQXLI&VS[WIVXSSPFEV]SYGERWIPIGX
JVSQXLIJSPPS[MRKSTXMSRW
 :MI[HMJJIVIRGIWFIX[IIRX[SWTIGMJMIHVIZMWMSRW
 :MI[HMJJIVIRGIWFIX[IIRXLIWIPIGXIHVIZMWMSRERHXLIHEXEFEWISFNIGX ZME
''+QETTMRK 
 :MI[HMJJIVIRGIWFIX[IIRXLIWIPIGXIHVIZMWMSRERHER]HEXEFEWISFNIGXSV
JMPIW]WXIQWGVMTX

To open an object in the tree


 'LSSWISRISJXLIJSPPS[MRK
 6MKLXGPMGOERSHIERHGLSSWI3TIRJVSQXLIWLSVXGYXQIRY
SV
 7IPIGXERMXIQMRXLIFVS[WIVERHGPMGOXLI3TIRFYXXSRMRXLIFVS[WIV
XSSPFEV

Viewing file differences


8LI(MJJIVIRGI:MI[IVHMWTPE]WXLIGSQTEVIHSFNIGXWMREWTPMX[MRHS[
(MJJIVIRGIWFIX[IIRXLISFNIGXWEVILMKLPMKLXIHERHXLIXSSPFEVWERHQIRYW
KMZI]SYEGGIWWXSGSRXVSPWJSVGYWXSQM^MRKXLIZMI[ERHGVIEXMRKVITSVXW
8LIXSSPFEVKMZIW]SYEGGIWWXSQER]YWIJYPJYRGXMSRW4SMRXXSEXSSPFEV
FYXXSRXSWIIE8SSPXMTHIWGVMFMRKMXWTYVTSWI

386

SQL Navigator Users Guide

8S|
7LS[EPPPMRIWSJXLIGSQTEVIHSFNIGXW
7LS[SRP]PMRIW[MXLHMJJIVIRGIW
7LS[SRP]PMRIW[MXLQENSVHMJJIVIRGIW
EWHIJMRIHMR4VIJIVIRGIWWIXXMRKWJSV
XLI(MJJIVIRGI:MI[IV 
7LS[SRP]QEXGLMRKPMRIW
+SXSXLIRI\XHMJJIVIRGI
+SXSXLITVIZMSYWHMJJIVIRGI
*MRHEXI\XWXVMRK

'PMGO|









*MRHXLIRI\XSGGYVVIRGISJXLIXI\X
WXVMRK



+SXSEWTIGMJMGPMRIRYQFIV



+IRIVEXIEVITSVXSJHMJJIVIRGIW
6IJVIWLXLISFNIGXWJVSQXLIHEXEFEWI
7LS[WTEGIGLEVEGXIVWYWMRKXMPHI b 
GLEVEGXIVW
8YVRSRSJJPMRIRYQFIVW
7LS[EXLYQFREMPZMI[SJXLIJMPI
IREFPMRK]SYXSUYMGOP]GLERKI
HMWTPE]IHWIGXMSRWSJXLIJMPI WII
HIWGVMTXMSRFIPS[ 
7LS[JYPPHIXEMPWSJXLIGYVVIRXPMRI
FIPS[XLIZMI[MRK[MRHS[ WS]SY
HSR
XLEZIXSWGVSPPXSWIIXLIIRXMVI
PMRI 









Chapter 10

Version control and team coding

'SRJMKYVIXLIGSQTEVMWSRVYPIW
'SRJMKYVIHMWTPE]STXMSRWJSVXLI
HMJJIVIRGIZMI[IV

387




Thumbnail view
8LIXLYQFREMPZMI[ XSXLIPIJXSJXLIZMI[MRK[MRHS[ MWEZMWYEPWYQQEV]SJ
HMJJIVIRGIW'SPSVIHPMRIWWLS[XLIVIPEXMZITSWMXMSRSJPMRIQMWQEXGLIW%
[LMXIVIGXERKPIVITVIWIRXWXLITEVXSJXLIXI\XGYVVIRXP]ZMWMFPIMRXLI(MJJIVIRGI
:MI[IV[MRHS[=SYGERGPMGOSRXLIXLYQFREMPZMI[XSTSWMXMSRXLIZMI[IVEX
XLEXTSMRX

Launching the Difference Viewer


=SYGERPEYRGLXLI(MJJIVIRGI:MI[IV
 JVSQXLI7502EZMKEXSV8SSPWQIRYVIKEVHPIWWSJ[LIXLIV8IEQ'SHMRK
MWIREFPIHSVRSX
 [LIR8IEQ'SHMRKMWIREFPIHJVSQXLI(MJJIVIRX*MPIWHMEPSKXLEXETTIEVW
[LIR]SYEXXIQTXXSSTIREGSRXVSPPIHSFNIGXSVWGVMTXERHXLIHEXEFEWI
ZIVWMSRHMJJIVWJVSQXLIZIVWMSRWEZIHXSXLI:'4VITSWMXSV]
 JVSQ[MXLMRXLI:IVWMSR'SRXVSP&VS[WIV

To view differences for selected objects


 4IVJSVQSRISJXLIJSPPS[MRK
 -RXLI:'7&VS[WIVWIPIGXEWGVMTXSVSFNIGXERHXLIRGPMGOXLI:MI[
(MJJIVIRGIFYXXSR SVXLIIUYMZEPIRXWLSVXGYXQIRYMXIQ 
 SV
 0SEHEWGVMTXMRXSXLI750)HMXSVERHXLIRWIPIGX:MI[(MJJIVIRGIJVSQ
XLI8SSPWQIRY
 SV
 7IPIGXERSFNIGXMRXLI(&2EZMKEXSVXLI*MRH3FNIGXW[MRHS[EZMWYEP
SFNIGXIHMXSVSVXLI;SVOWTEGIERHXLIRWIPIGX:MI[(MJJIVIRGIJVSQ
XLI8SSPWQIRY SVXLIIUYMZEPIRXWLSVXGYXQIRYMXIQ  

388

SQL Navigator Users Guide

Responding to the Different Versions dialog


;LIR]SYSTIRERSFNIGXSVWGVMTX8IEQ'SHMRKGSQTEVIWMX[MXLXLIPEXIWX
VIZMWMSRMRXLI:'4VITSWMXSV] YRPIWWMXMWGLIGOIHSYX ;LIRXLIHEXEFEWI
SFNIGXSVWGVMTXHMJJIVWJVSQXLIZIVWMSRWEZIHXSXLI:'4VITSWMXSV]8IEQ
'SHMRKEHZMWIW]SY[LIR]SYEXXIQTXXSSTIRXLIMXIQ
7YGLHMJJIVIRGIWQMKLXFIHYIXSERYQFIVSJJEGXSVWJSVI\EQTPI
 %RSXLIVXSSPQE]LEZIFIIRYWIHXSIHMXXLISFNIGX
 %WGVMTXQE]LEZIFIIRI\IGYXIHXLEXQSHMJMIHXLISFNIGX
 8LIEVGLMZIMRXLI:'4VITSWMXSV]QE]LEZIFIIRYTHEXIHF]WSQISXLIV
QIERW
=SYGERGLSSWISRISJXLIJSPPS[MRKSTXMSRWMRXLI(MJJIVIRX*MPIWHMEPSK 
Option

Description

:MI[(MJJIVIRGIW

0EYRGLXLI(MJJIVIRGI:MI[IVWSXLEX]SYGERGSQTEVIXLIX[S
SFNIGXW

3TIR(EXEFEWI
:IVWMSR

Load the database version into the VOE or Script


Editor in Read Only mode.

3TIR:'7
:IVWMSR

9THEXIXLIHEXEFEWI[MXLXLI:'4VITSWMXSV]ZIVWMSRERHPSERW
MRXSXLI:3)SV7GVMTX)HMXSVMR6IEH3RP]QSHI
'EYXMSR3TIRMRKXLIZIVWMSRJVSQXLIVITSWMXSV][MPPGEYWI
XLISFNIGXMRXLIHEXEFEWIXSFIYTHEXIH

1EOIIHMXEFPI

'LIGOXLIWIPIGXIHMXIQSYXJSVIHMXMRK

Viewing Team Coding user status


8LI8IEQ'SHMRK9WIV7XEXYW[MRHS[WLS[W]SY
 ;LEX8IEQ'SHMRKTIVQMWWMSRWEVIKVERXIHXSXLIGYVVIRXYWIV MRHMGEXIH
F]GLIGOQEVOW 
 ;LEXXLMVHTEVX]ZIVWMSRGSRXVSPWYTTSVXMWMRWXEPPIH
 ;LEXXLMVHTEVX]ZIVWMSRGSRXVSPWYTTSVXMWEGXMZIJSVXLIGYVVIRXMRWXERGI
MRHMGEXIHF]XLIEVVS[ 
8LIVIMWEPWSER)VVSVWFYXXSR]SYGERYWIXSZMI[ER]W]WXIQIVVSVWEJJIGXMRK
EGGIWWXS8IEQ'SHMRKJIEXYVIW

Chapter 10

Version control and team coding

389

To display the Team Coding User Status


1
2

*VSQXLI7502EZMKEXSVQIRYFEVGLSSWI8IEQ'SHMRKERHXLIRGLSSWI
4VSTIVXMIW
-JVIUYMVIHPSKSRXS]SYVZIVWMSRGSRXVSPVITSWMXSV]

Installing Team Coding options


Installing Team Coding options
8LIJSPPS[MRKEVIXLIQEMRWXITWVIUYMVIHXSWIXYTERHGSRJMKYVI8IEQ
'SHMRK 

Enabling Team Coding in the Oracle Instance


&IJSVIYWMRK8IEQ'SHMRKJIEXYVIWXLIRI[JIEXYVIWQYWXFIIREFPIHMRXLI
3VEGPIMRWXERGIF]EYWIVKVERXIHXLI%HQMRMWXVEXSVVSPI=SYYWIXLI
'SRRIGXMSR7IXXMRKWSTXMSRWMRXLI7502EZMKEXSV4VIJIVIRGIWHMEPSKXSIREFPI
8IEQ'SHMRK

Support for Version Control products


7502EZMKEXSVkW8IEQ'SHMRKJIEXYVIWHMVIGXP]WYTTSVXXLIJSPPS[MRKXLMVH
TEVX]TVSHYGXW
 1MGVSWSJX:MWYEP7SYVGI7EJI
 1IVERX4:'7:1
 1IVERX4:'7:1
8IEQ'SHMRKEPWSSTIVEXIW[MXLTVSHYGXWEHLIVMRKXS1MGVSWSJXkW7''%4-
8LITVSHYGXWXIWXIH[MXL7502EZMKEXSVMRGPYHI
 6EXMSREP'PIEV'EWI
 7XEVFEWI7XEV8IEQ
)EGLTVSHYGXQE]VIUYMVIEGYWXSQMRWXEPPEXMSRXSMRWXEPPXLI7''MRXIVJEGI
4PIEWIVIJIVXSXLIVIPIEWIRSXIWJSVXLIPEXIWXMRJSVQEXMSRSRZIVWMSR
GSQTEXMFMPMX]
9WIVWSJ:IVWMSR'SRXVSPTVSHYGXWXLEXMQTPIQIRXXLI7''MRXIVJEGI[MPPJMRH
XLIJSPPS[MRKSTIVEXMSREPHMJJIVIRGIWMRXLMWZIVWMSRSJ7502EZMKEXSV

390

SQL Navigator Users Guide

 8LI7502EZMKEXSV:IVWMSR'SRXVSP&VS[WIVMWRSXEZEMPEFPIMXMWVITPEGIH
F]XLIXLMVHTEVX]TVSHYGXkWS[RYWIVMRXIVJEGI
 8LIHMWTPE]SJXLITVSNIGXXVII[LIRGVIEXMRKERI['SHI'SRXVSP+VSYTMW
VITPEGIHF]XLIXLMVHTEVX]TVSHYGXkWS[RHMEPSK

Install server-side objects


&IJSVI]SYGERYWI8IEQ'SHMRKJIEXYVIW]SYRIIHXSMRWXEPPWIVZIVWMHI
SFNIGXWSRIEGL3VEGPIMRWXERGI[LIVIXLIWIJIEXYVIWEVIXSFIYWIH8LI
JSPPS[MRKWXITWEVIVIUYMVIH 
Action

Where performed

-RWXEPPXLIVIUYMVIHWGVMTXW

7IVZIV7MHI-RWXEPPEXMSR;M^EVH 8SSPW
QIRY 


7IPIGXQMKVEXMSRTVIJIVIRGIW

7IVZIV7MHI-RWXEPPEXMSR;M^EVH


'VIEXI8IEQ'SHMRKVSPIW

7IVZIV7MHI-RWXEPPEXMSR;M^EVH


=SYGERVYRXLI7IVZIV7MHI-RWXEPPEXMSR;M^EVHJVSQ7502EZMKEXSV
W8SSPW
QIRY
Users should close all sessions before running
the Server Side Installation wizard.

Install the required scripts


8IEQ'SHMRKVIUYMVIWMRWXEPPEXMSRSJXLI&EWI7502%:6ITSWMXSV]ERH8IEQ
'SHMRK7YTTSVXWGVMTXWJVSQXLI7502EZMKEXSV7IVZIV7MHI-RWXEPPEXMSR
[M^EVH 

Chapter 10

Version control and team coding

391


-RXLI[M^EVHWIPIGXXLI&EWI7502%:6ITSWMXSV]ERH8IEQ'SHMRK
7YTTSVXWGVMTXWTPYWER]SXLIVWGVMTX]SY[MWLXSMRWXEPPERHXLIRTVIWW
2I\X
3RXLIPSKSRWGVIIRGSRRIGXEWE(&%YWIVERHYWIER]TEWW[SVH]SY
[MWL 8LIYWIVMWGVIEXIHWMQTP]EWXLIS[RIVSJXLIZEVMSYWHEXEFEWI
SFNIGXWVIUYMVIHJSV8IEQ'SHMRKWYTTSVX 

Select migration preferences


-RXLI1MKVEXIJVSQ:'7XS8IEQ'SHMRKHMEPSKMJ]SYEVIRSX
QMKVEXMRKI\MWXMRK:'73TXMSRHEXEJVSQ7502EZMKEXSVXS750
2EZMKEXSVNYWXTVIWW2I\X
-J]SYEVIQMKVEXMRKI\MWXMRK:'73TXMSRHEXEWIPIGXEQMKVEXMSRTVIJIVIRGI
=SYGERPIEVREFSYXXLIQMKVEXMSRTVIJIVIRGIWF]VIEHMRKXLI6IEH1IJMPI
EZEMPEFPIZMEXLIFYXXSRMRXLI[MRHS[ ERHEPWSMRXLIHSGYQIRX
:'71MKVEXI[VMPSGEXIHMRXLI@(SGJSPHIV[MXLMRXLI7502EZMKEXSV
MRWXEPPEXMSRJSPHIV  

392

SQL Navigator Users Guide

Create Team Coding roles


8IEQ'SHMRKYWIW3VEGPIXEFPIERHGSPYQRTVMZMPIKIWXSGSRXVSPEGGIWW=SY
GERGVIEXIXLIJSPPS[MRKHIJEYPXVSPIWYWMRKWIXXMRKWXLEXVITVIWIRXXLIQSWX
PMOIP]HIWMVIHYWISJXLIWITVMZMPIKIW 
 %HQMRMWXVEXSV
 4VSNIGX1EREKIV
 8IEQ0IEHIV
*SVIEGLWIXSJTVMZMPIKIW]SYGERGLSSWIXSGVIEXIERI[VSPIYWIERI\MWXMRK
VSPI ]SYQE]EPVIEH]LEZIETTVSTVMEXIVSPIWJSV]SYVYWIVW KVERXXLIQXS
TYFPMGSVXSWOMTTVMZMPIKIEWWMKRQIRXGSQTPIXIP]
Caution If you skip the "Developer" role step,
Team Coding will be disabled for your users.

%JXIVGVIEXMRKXLIVSPIW]SYRIIHXSKVERXXLIQXSYWIVW



Default roles
8LIHIJEYPXVSPIWGVIEXIHF]XLI;M^EVHLEZIXLIJSPPS[MRK8IEQ'SHMRK
TVMZMPIKIW

Chapter 10

Version control and team coding

393

%HQMRMWXVEXSV'ERGSRJMKYVIXLIMRWXERGIXSHIJMRILS[8IEQ'SHMRK
STIVEXIW[LMGL:'4 MJER] MWYWIHIXG8LMWVSPIMWEYXSQEXMGEPP]EWWMKRIHXS
XLI7502%:YWIV
1EREKIV'ERGVIEXIERHHIPIXIGSHIGSRXVSPKVSYTW ''+W ERHVIPEXIXLIQ
XSE:'4TVSNIGX
0IEHIV'ERQSHMJ]''+WHIJMRMRK[LMGLSFNIGXWSVWGVMTXWEVIMRGPYHIHMR
XLIKVSYTERHJVII^ISFNIGXW'EREPWSHIPIXIVS[WJVSQXLI8IEQ'SHMRK
:MI[IV

Grant the roles


=SYGERYWIXLI7502EZMKEXSV9WIV)HMXSVSVXLI750)HMXSVXSKVERXXLI
8IEQ'SHMRKVSPIWGVIEXIHF]XLI7IVZIV7MHI-RWXEPPEXMSR;M^EVHXSMRHMZMHYEP
YWIVW=SYQYWXFIGSRRIGXIHEWE(&%YWIV 
*SVI\EQTPI
KVERX7502%:C%(1-2XS(&%
KVERX7502%:C1+6XS.3,2
KVERX7502%:C0(6XS%68,96
KVERX7502%:C0(6XS797%2

Configuring Team Coding Options


Enabling Team Coding in the Oracle Instance
&IJSVIYWMRK8IEQ'SHMRKJIEXYVIWXLIRI[JIEXYVIWQYWXFIIREFPIHMRXLI
3VEGPIMRWXERGIF]EYWIVKVERXIHXLI%HQMRMWXVEXSVVSPI=SYYWIXLI
'SRRIGXMSR7IXXMRKWSTXMSRWMRXLI7502EZMKEXSV4VIJIVIRGIWHMEPSKXSIREFPI
8IEQ'SHMRK8LISTXMSRWWIXMRXLI'SRRIGXMSR7IXXMRKWHMEPSKETTP]XSEPP
YWIVW 

Team Coding Basic Operation


*SVEGGIWWXSFEWMG8IEQ'SHMRKJYRGXMSRWIREFPIXLI8IEQ'SHMRK
)REFPIHSTXMSRMRXLI'SRRIGXMSR7IXXMRKWWIGXMSRSJXLI8IEQ'SHMRK
TVIJIVIRGIW 

394

SQL Navigator Users Guide

-RXLIFEWMGQSHISJSTIVEXMSRXLIJSPPS[MRKVYPIWETTP]
 )ZIV]WYTTSVXIHSFNIGXMRIZIV]WGLIQESRXLIHEXEFEWIQYWXFIGLIGOIH
SYXFIJSVIFIMRKIHMXIH
 7YTTSVXIHSFNIGXWEVI
 4VSGIHYVIW
 *YRGXMSRW
 4EGOEKIW
 8VMKKIVW
 :MI[W
 %RSFNIGXGERFIGLIGOIHSYXXSSRP]SRIYWIVEXEXMQI
 2S6IZMWMSR,MWXSV]MWQEMRXEMRIH
8LMWJYRGXMSREPMX]MWIUYMZEPIRXXSXLI8IEQ4VSKVEQQMRKJIEXYVIJSYRHMR
:IVWMSR8LI8IEQ'SHMRKJIEXYVIWMR:IVWMSR[MPP[SVOMR
GSRNYRGXMSR[MXL8IEQ4VSKVEQQMRKMR:IVWMSRFIGEYWIXLIWEQIWIVZIV
WMHIXEFPIMWYWIHXSXVEGOXLISFNIGXW

Using Code Control Groups


8LIQSWXWMKRMJMGERXIRLERGIQIRXMR7502EZMKEXSV8IEQ4VSKVEQQMRKMWXLI
YWISJ'SHI'SRXVSP+VSYTW 
%'SHI'SRXVSP+VSYT ''+ MWEWIXSJVIJIVIRGIWXSSFNIGXWYRHIV8IEQ
'SHMRKGSRXVSP8LIWIVIJIVIRGIWSVQEWOWMHIRXMJ][LMGL:'4 ZIVWMSR
GSRXVSPTVSZMHIV TVSNIGXXLISFNIGXWEVIVIPEXIHXS
''+WLIPT]SYSVKERM^I]SYVGSRXVSPPIHSFNIGXWMRXSKVSYTWEWWSGMEXIH[MXL
HIZIPSTQIRXTVSNIGXW*SVI\EQTPI]SYGERGVIEXIQYPXMTPI''+WJSVEWMRKPI
3VEGPIMRWXERGIIEGLGSRXEMRMRKVIJIVIRGIWJSVEPPWXSVIHTVSKVEQWVIPEXMRKXS
EGYWXSQIVETTPMGEXMSR
3RGI''+WLEZIFIIRGSRJMKYVIHYWIVWGERWXEVXYWMRK8IEQ'SHMRKJIEXYVIW
MQQIHMEXIP]EWSFNIGXWSVWGVMTXW[MPPFIEYXSQEXMGEPP]EHHIHXSXLI:'4
TVSNIGXEWXLI]EVIQSHMJMIH
When this option is used, objects not referenced
by a CCG are not under Team Coding control.

Using third-party version control


VH

8LI9WI 4EVX]:IVWMSR'SRXVSP'SRRIGXMSR7IXXMRKWSTXMSRIREFPIW
MRHMZMHYEP''+WXSFIVIPEXIHXSE:'7TVSNIGXMRXLIWIPIGXIHTVSZMHIV
W
ZIVWMSRGSRXVSPVITSWMXSV]8LMWSTXMSREPWSTIVQMXWWGVMTXWVIWMHMRKSRXLIJMPI

Chapter 10

Version control and team coding

395

W]WXIQXSFIQEREKIHF]8IEQ'SHMRK=SYGEREHHVIJIVIRGIWXSWGVMTXWXS
''+W

Applying Team Coding to all Objects


;LIRE:'4MWMRYWIXLI%TTP]8IEQ'SHMRKXSEPP3FNIGXW'SRRIGXMSR
7IXXMRKWSTXMSREPPS[WEPPSFNIGXWXSFIQEMRXEMRIHF]8IEQ'SHMRKVIKEVHPIWW
SJ[LIXLIVXLI]EVIVIJIVIRGIHF]E''+-RSXLIV[SVHW
 %PPWXSVIHTVSKVEQSFNIGXWEVIYRHIV8IEQ'SHMRKGSRXVSPERHQYWXFI
GLIGOIHSYXFIJSVIXLI]GERFIIHMXIH
 3FNIGXWVIJIVIRGIHF]E''+EVIRSXSRP]YRHIV8IEQ'SHMRKGSRXVSPFYX
EVIEPWSWXSVIHMRXLI:'4VITSWMXSV] 

Team Coding File Extension Options


8LI*MPI)\XIRWMSR3TXMSRWWTIGMJ]JMPIREQII\XIRWMSRWJSVHEXEFEWISFNIGXW
8LIWII\XIRWMSRWEVIYWIHXSGVIEXIXLI[SVOJMPIWXLEXEVIWXSVIHMRXLI:'4
TVSNIGX3FNIGXWEVIWXSVIHMRJMPIWREQIHEGGSVHMRKXSXLIJSPPS[MRK
GSRZIRXMSR 
 7',)1%2%1))<8
*SVI\EQTPIXLITVSGIHYVI1=463'MRWGLIQE():[SYPHFIWXSVIHMRE
JMPIMRXLI:'4VITSWMXSV]EW():1=463'46'
Caution
Do not change the file extensions
after exporting objects to a VCP repository

8LIVIMWKIRIVEPP]RSRIIHXSQSHMJ]XLIWIWIXXMRKW2SXIXLEXER]GLERKI[MPP
EPWSEJJIGX7502EZMKEXSVGPMIRXW EWXLIWEQIWIVZIVWMHIXEFPIMWYWIHXS
WXSVIXLMWMRJSVQEXMSRJSV:'7ERH8IEQ'SHMRK 
Caution
PVCS versions 5.2 through 6.0 will replace
the last character of the file extension with V when
creating its internal archive. For this reason, it is important
to ensure that:
The first two characters of the file extension are unique
(hence the default extensions for packages are not PKS
and PKB)
The character V is not used as an extension
(hence the default extension for views is not VEW)

396

SQL Navigator Users Guide

Configuring user settings


;LMPIXLIWIXXMRKWTVSZMHIHMRXLI'SRRIGXMSR7IXXMRKWHMEPSKEVIEZEMPEFPIXS
EPPYWIVWERYQFIVSJWIXXMRKWQE] STXMSREPP] FIWIXSRIEGLMRHMZMHYEP
[SVOWXEXMSRERHEVIWXSVIHMRXLI[SVOWXEXMSR
WVIKMWXV] 

To configure user settings


1

*VSQXLI:MI[QIRYGLSSWI4VIJIVIRGIW

-RXLI8IEQ'SHMRKWIGXMSRSJXLI4VIJIVIRGIW[MRHS[WIXTVIJIVIRGIW
EGGSVHMRKXSXLIHIWGVMTXMSRFIPS[
Option

Description

%YXSQEXMG'LIGO-R

0SGEPSZIVVMHIJSVIUYMZEPIRXKPSFEP
WIXXMRK

%YXSQEXMG'LIGO3YX

0SGEPSZIVVMHIJSVIUYMZEPIRXKPSFEP
WIXXMRK

0SGEP;SVOMRK(MVIGXSV]

3ZIVVMHIWKPSFEP;SVOMRK(MVIGXSV]
WIXXMRK MJ:'4HSIWRSXLEZIMXW
[SVOMRKHMVIGXSV]WIX 

7LS[7YGGIWW1IWWEKI

-JRSXWIXXLIVIMWRSZMWYEPMRHMGEXMSR
XLEXEGLIGOSYXSVGLIGOMRWYGGIIHIH
%JEMPYVI[MPPEP[E]WFIWLS[
VIKEVHPIWWSJXLMWWIXXMRK

Team Coding General options


8LI+IRIVEPSTXMSRWHIJMRILS[8IEQ'SHMRKWLSYPHLERHPISFNIGXWERH
WGVMTXW
Option

Description

7GVMTX*MPI)\XIRWMSRW

8IEQ'SHMRKEPPS[WWGVMTXWXSFI
EHHIHXSE''+8LI7GVMTX*MPI
)\XIRWMSRWSTXMSRMHIRXMJMIWXLIJMPI
I\XIRWMSRWXSFIVIGSKRM^IHEWWGVMTXW
&]HIJEYPXXLI750I\XIRWMSRMWYWIH

Chapter 10

Version control and team coding

397

;SVOMRK(MVIGXSV]

7TIGMJMIWEHIJEYPX[SVOWXEXMSR
HMVIGXSV]MR[LMGLXSWXSVI[SVOJMPIW
GLIGOIHSYXJVSQE:'4
%PSGEPTVIJIVIRGIMWEPWSEZEMPEFPIXS
SZIVVMHIXLMWWIXXMRK 

9THEXIHEXEFEWIEJXIV'LIGO-R

*SVGIWXLIHEXEFEWISFNIGXXSFI
YTHEXIHEJXIVEGLIGOMRWSXLEXMXMW
MHIRXMGEPXSXLIGLIGOIHMR[SVOJMPI

*SVGI6IZMWMSRJSVGSQQIRXW

%PPS[WEGSQQIRXWSRP]VIZMWMSR
XSFIGVIEXIHMRXLIVITSWMXSV]-R
SXLIV[SVHWEPPS[WERI[VIZMWMSRXS
FIGVIEXIHMRXLI:'4IZIRMJXLIVI
LEWFIIRRSGLERKIXSXLISFNIGXSV
WGVMTXMXWIPJFYXSRP]XSXLI
GSQQIRXW 8LIGLIGOMRHMEPSKEPWS
TVSZMHIWXLMWSTXMSRXLI+IRIVEP
STXMSRWWIXXMRKWMQTP]WIXWXLIHIJEYPX
FILEZMSV 

%YXSQEXMG'LIGO-R

-RMXMEXIWE'LIGO-R[LIRIZIVXLI
YWIVGPSWIWERIHMXSVJSVEQSHMJMIH
ERHGLIGOIHSYXSFNIGXSVWGVMTX

%YXSQEXMG'LIGO3YX

-RMXMEXIWE'LIGO3YX[LIRIZIVXLI
YWIVSTIRWERIHMXSVJSVERSFNIGXSV
WGVMTX

9WI8VMKKIV(IWGVMTXMSRJSV((0

;LIRYWMRK8IEQ'SHMRK[MXL
XVMKKIVW)<86%'8((0MWYWIHXS
WXSVIXLI((0SJXLISFNIGXMRXLI
:'4VITSWMXSV]*SVXVMKKIVW
XLSYKLXLIVIEVIX[S[E]WXLMWXI\X
GERFIGVIEXIH8LIJMVWX[E] ERHXLI
HIJEYPX[E] MWXSGSRWXVYGXXLI((0
JVSQXLI(EXE(MGXMSREV]8LI
WIGSRH[E]MWXSYWIXLIGSQTPIXI
((0JVSQXLIHIWGVMTXMSRJMIPHMRXLI
(EXE(MGXMSREV]
7III\EQTPIWFIPS[

398

SQL Navigator Users Guide

EXAMPLES
1 =SYX]TI
CREATE OR REPLACE TRIGGER sqlnav.testtrg1 BEFORE INSERT ON
sqlnav.test1
begin
null;
end;

8LMW[E][MPPGSRWXVYGXXLI((0ERHTVSHYGIXLIJSPPS[MRKVIWYPX RSXIXLI
WTEGMRKERHXLIEHHMXMSREPPMRI 
CREATE OR REPLACE TRIGGER sqlnav.testtrg1
BEFORE INSERT
ON sqlnav.test1
REFERENCING NEW AS NEW OLD AS OLD
begin
null;
end;

2 8LIWIGSRH[E]XLSYKL[MPPTVIWIVZIXLISVMKMREP[E]MX[EWIRXIVIH
CREATE OR REPLACE TRIGGER sqlnav.testtrg1 BEFORE INSERT ON
sqlnav.test1
begin
null;
end;

8LIX[SVIWYPXWEVIEPQSWXMHIRXMGEPMRXI\XFYXXLIJSVQEXMWHMJJIVIRX8LI
VIEWSR[L]]SYQE][ERXXSYWIXLIWIGSRH[E]MWMJ]SYYWIGSQQIRXWFIJSVI
XLIFSH]SJ]SYVXVMKKIV7SJSVI\EQTPI
CREATE OR REPLACE TRIGGER test1 --this is a comment not in
the trigger body
BEFORE INSERT ON sqlnav.test1
begin
null;
end;

1IXLSH[MPPDJSVKIX
XLMWGSQQIRXQIXLSH[SR
X

Chapter 10

Version control and team coding

399

If you are using SQL Navigator version 3


with version 4.1
*SVZIVWMSRZIVWMSRGSQTEXMFMPMX]1IXLSH[MPP[SVOJMRI-J]SYWIPIGX
1IXLSH2EZMKEXSVZIVWMSR[MPPGSRWXERXP]VIQMRH]SYXLEXXLIHEXEFEWI
ZIVWMSRSJXLIXVMKKIVMWHMJJIVIRXJVSQXLI:'7ZIVWMSR
9RPIWW]SYEVIYWMRKGSQQIRXWFIJSVIXLIFSH]SJXLI8VMKKIVYWI1IXLSH
XLEXMWHSRSXWIPIGXXLI9WI8VMKKIV(IWGVMTXMSRJSV((0STXMSR

To configure Team Coding settings for the current


connection
1
2

*VSQXLI:MI[QIRYGLSSWI4VIJIVIRGIW
-RXLI8IEQ'SHMRKWIGXMSRSJXLI4VIJIVIRGIW[MRHS[GPMGOXLI

'SRRIGXMSR7IXXMRKW  IPPMTWMW FYXXSR


3 9WMRKXLI'SRJMKYVEXMSR*MPI)\XIRWMSR3TXMSRWERH+IRIVEPXEFWMRXLI
8IEQ'SHMRK7IXXMRKWJSVHMEPSKWIPIGXSTXMSRWEWRIIHIHEGGSVHMRKXS
XLIJSPPS[MRKHIWGVMTXMSR
'SRJMKYVEXMSRXEF
Option

Description

8IEQ'SHMRK)REFPIH

)REFPIW'LIGOMRERH'LIGOSYXJSVEPP
WXSVIHTVSKVEQWMREPPWGLIQEW[MXLSYX
VIZMWMSRLMWXSV]
7II&EWMG3TIVEXMSR

9WI'SHI'SRXVSP+VSYTW

)REFPIWXLIYWISJ'SHI'SRXVSP+VSYTW
''+WLIPT]SYSVKERM^I]SYVGSRXVSPPIH
SFNIGXWMRXSKVSYTWEWWSGMEXIH[MXL
HIZIPSTQIRXTVSNIGXW7II9WMRK'SHI
'SRXVSP+VSYTW

9WIVH4EVX]:IVWMSR'SRXVSP

0MQMXWGSRXVSPPIHSFNIGXWXSXLSWIHIJMRIH
MR''+W7II9WMRKXLMVHTEVX]ZIVWMSR
GSRXVSP

%TTP]8IEQ'SHMRKXSEPP3FNIGXW

%PPS[WXLSWISFNIGXWRSXHIJMRIHMRE
''+XSEPWSFIGSRXVSPPIH FYX[MXLSYX
VIZMWMSRLMWXSV] 7II%TTP]MRK8IEQ
'SHMRKXSEPPSFNIGXW

400

SQL Navigator Users Guide

Option

Description

4VSZMHIVW

7IPIGXWXLIXLMVHTEVX]ZIVWMSRGSRXVSP
TVSHYGX(00 W XSFIYWIH
3TXMSREFSZIQYWXEPWSFIIREFPIH
8LIPMWXMRGPYHIWSRP]XLSWI:'4WMRWXEPPIH
HYVMRK7502EZMKEXSVMRWXEPPEXMSR
2SXI -RWXEPPEXMSRERHWIPIGXMSRSJE
:'4HSIWRSXMRMXWIPJEPPS[JSV
QEMRXIRERGISJVIZMWMSRLMWXSVMIW8LI
XLMVHTEVX]ZIVWMSRGSRXVSPTVSHYGXQYWX
EPWSFIMRWXEPPIHSRXLIGPMIRX

7YFTVSZMHIVW

;LIVIE:'4WYTTSVXWQSVIXLERSRI
TVSHYGX WYGLEWXLI7'':'4 TIVQMXW
WIPIGXMSRSJXLIWTIGMJMGTVSHYGXXSYWI

*MPI)\XIRWMSR3TXMSRWXEF
7TIGMJ]XLIJMPII\XIRWMSRWXSFIYWIHJSV:MI[W4VSGIHYVIW*YRGXMSRW
4EGOEKIW4EGOEKI&SHMIWERH8VMKKIVW
+IRIVEPXEF
7TIGMJ]LS[8IEQ'SHMRKWLSYPHLERHPISFNIGXWERHWGVMTXW

Using Code Control Groups


How do CCGs work?
7502EZMKEXSV
WGSHIGSRXVSPKVSYTW ''+W EVIXLIQSWXTS[IVJYPERH
JPI\MFPIJIEXYVISJ8IEQ'SHMRK*SPPS[MRKEVII\EQTPIWSJLS[''+WGERFI
YWIJYP

Example 1: A Single Application


7YTTSWI]SYLEZIEWGLIQEGSRXEMRMRKWXSVIHTVSKVEQWXLEXEPPVIPEXIXSE
WMRKPIETTPMGEXMSRSR]SYV3VEGPIMRWXERGI=SYGERIEWMP]GVIEXIE''+XLEX
MRGPYHIWEPPSFNIGXWMRXLEXWGLIQEERHQETMXXSE:IVWMSR'SRXVSPTVSNIGXMR
]SYVTVSZMHIV
WVITSWMXSV]

Chapter 10

Version control and team coding

401

Example 1 Using CCGs to map objects from multiple schemas to


one VCP Project



Excluding objects
-JXLIWGLIQEEPWSGSRXEMRWWSQISFNIGXWXLEX]SYHSRSX[ERXGSRXVSPPIH JSV
I\EQTPI]SYQE]LEZIWSQIXIWXTEGOEKIW[LMGLHSR
XJSVQTEVXSJ]SYV
ETTPMGEXMSR MXMWEWMQTPIQEXXIVXSEHHERI\GPYWMSRVIJIVIRGI 3FNIGX1EWO 
MR]SYV''+7II7TIGMJ]MRK''+SFNIGXQEWOW

Including certain types and schemas


-J]SYVETTPMGEXMSRGSRXEMRWWSQISFNIGXWPSGEXIHMREHMJJIVIRXWGLIQEMXMW
IEW]XSQSHMJ]XLI''+XSMRGPYHIXLSWISFNIGXW8SXEOIXLMWEWXITJYVXLIV
]SYGEREPWSGSRJMKYVI]SYV''+WSXLEXMXGSRXEMRWER]SJXLIJSPPS[MRK
 SFNIGX1EWOWFEWIHSRETEVXMGYPEVWGLIQESVWGLIQEQEWO WYGLEW
463( 
 WXSVIHTVSKVEQWSJER]X]TISVETEVXMGYPEVX]TI WYGLEW8VMKKIV 
 SFNIGXWSJER]REQISVYWMRKEREQIQEWO WYGLEW%''C 
%R]SFNIGXQEWOGERYWIHXSI\GPYHIEW[IPPEWMRGPYHIWS]SYGERVIEHMP]
MRGPYHIEKVSYTSJSFNIGXWFYXI\GPYHI JSVMRWXERGI EPPSFNIGXWSJREQIPMOI
(&+C

402

SQL Navigator Users Guide

Scripts
-J]SYVETTPMGEXMSRMRZSPZIWERGMPPEV]WGVMTXW]SYGERMRGPYHIVIJIVIRGIWXS
XLIWIWGVMTXWMR]SYV''+%W[MXLSXLIVSFNIGXW]SYGERYWI[MPHGEVHQEWOW
ERHI\GPYWMSRW

Example 2: Multiple Applications


-J]SYWYFWIUYIRXP]WXEVXHIZIPSTQIRXSJEWIGSRHETTPMGEXMSRYWMRKSFNIGXW
WXSVIHMRXLIWEQIWGLIQEEWXLISRIYWIHJSVXLIJMVWXETTPMGEXMSR]SYGER
XLIRWMQTP]GVIEXIEWIGSRH''+8LMWRI[''+[SYPHGSRXEMRSFNIGXQEWOW
JSVXLIWXSVIHTVSKVEQWXLEXEVIVIPEXIHXS]SYVRI[ETTPMGEXMSRERH]SY
[SYPHEWWSGMEXIXLIRI[''+XSEHMJJIVIRXTVSNIGXMR]SYVZIVWMSRGSRXVSP
VITSWMXSV]
*SVI\EQTPIMJWIGSRHETTPMGEXMSRMWQEHIYTSJTVSGIHYVIW[LSWIREQIWEPP
FIKMR[MXLEGSQQSRTVIJM\WYGLEW%'']SYVWIGSRH''+[SYPH
GSRXEMRER3FNIGXQEWOJSVEPPTVSGIHYVIWMRXLIWGLIQE[MXLEREQIPMOI
%''8IEQTVSKVEQQMRKEYXSQEXMGEPP]VIGSKRM^IWSFNIGXW[MXLREQIW
QEXGLMRKXLIRI[SFNIGXQEWOERHQETWXLIQXSXLIWIGSRH:'4TVSNIGX
VEXLIVXLERXLIJMVWX

Example 2 Using CCGs to map objects from one schema to


different VCP projects



Chapter 10

Version control and team coding

403

To view or modify a CCG


1
2

*VSQXLI7502EZMKEXSVQIRYFEVGLSSWI8IEQ'SHMRKERHXLIRGPMGO
'SHI'SRXVSP+VSYTW
-RXLI'SHI'SRXVSP+VSYTW[MRHS[WIPIGXEKVSYTJVSQXLIPMWXERHXLIR
GPMGOXLI3TIR+VSYTXSSPFEVFYXXSR 

To enable Code Control Groups


1

*VSQXLI:MI[QIRYGLSSWI4VIJIVIRGIW

-RXLI8IEQ'SHMRKWIGXMSRSJXLI4VIJIVIRGIW[MRHS[STIRXLI
'SRRIGXMSR7IXXMRKWSTXMSRWERHXLIR9WI'SHI'SRXVSP+VSYTW
8SIREFPI'SHI'SRXVSP+VSYTWWIPIGXXLI9WI'SHI'SRXVSP+VSYTW
;LIRXLMWSTXMSRMWYWIHSFNIGXWRSXVIJIVIRGIHF]E''+EVIRSXYRHIV8IEQ
'SHMRKGSRXVSP 
2

When this option is used, objects not referenced


by a CCG are not under Team Coding control.

3RGI''+WLEZIFIIRGSRJMKYVIHYWIVWQE]WXEVXYWMRK8IEQ'SHMRKJIEXYVIW
MQQIHMEXIP]EWSFNIGXWSVWGVMTXW[MPPFIEYXSQEXMGEPP]EHHIHXSXLI:'4
TVSNIGXEWXLI]EVIQSHMJMIH

To create a Code Control Group

*VSQXLI7502EZMKEXSVQIRYFEVGLSSWI8IEQ'SHMRKERHXLIRGPMGO
'SHI'SRXVSP+VSYTW
-RXLI'SHI'SRXVSP+VSYTW[MRHS[GPMGOXLI%HH+VSYTXSSPFEVFYXXSR

3
4

-JEPSKMR[MRHS[ETTIEVWTVSZMHIXLIRIIHIHMRJSVQEXMSR
-RXLI2I[+VSYTHMEPSKIRXIVEHIWGVMTXMZIREQIJSVXLI+VSYT

-J]SYEVIYWMRKE:'4WIPIGXE:'4TVSNIGXF]JSPPS[MRKXLITVSQTXWMR
XLIHMEPSKWXLEXETTIEV[LMGLZEV]HITIRHMRKSRXLITVSHYGXMRYWI
;LIRXLI'SHI'SRXVSP+VSYT[MRHS[ETTIEVW WLS[RFIPS[ GVIEXI
2I[3FNIGXERHWGVMTXQEWOHIJMRMXMSRWJSVXLIGYVVIRX''+

404

SQL Navigator Users Guide



Specifying file server scripts for a CCG


=SYYWIXLI1EWO4VSTIVXMIWHMEPSK WLS[RFIPS[ XSWTIGMJ]EKVSYTSJJMPI
WIVZIVWGVMTXW SVEWTIGMJMGWGVMTX XSMRGPYHIMRE''+ 

To specify CCG server scripts


7IPIGXJVSQXLIJSPPS[MRKSTXMSRW

Chapter 10

Version control and team coding

7GVMTX4EXL2EQI

405

8]TIXLITEXLXSEWTIGMJMGWGVMTXJMPISVFVS[WI
ERHWIPIGX=SYGERYWIXLI [MPHGEVHGLEVEGXIV
XSWTIGMJ]EKVSYTSJWGVMTXW;LIRYWMRK
[MPHGEVHW]SYGERSQMXXLIJMPII\XIRWMSR8IEQ
'SHMRKEWWYQIWXLII\XIRWMSRWEVIEWWTIGMJMIH
SRXLIWIVZIVZMEXLI4VIJIVIRGIWWIXXMRKW
'SRRIGXMSR7IXXMRKW
*SVI\EQTPI
'@1]7GVMTXW@ 

)\GPYHIH

7IPIGX)\GPYHIHXSI\GPYHIER]WGVMTXWQEXGLMRK
XLMWSFNIGXQEWOJVSQXLI''+

Specifying CCG object masks


=SYYWIXLI1EWO4VSTIVXMIWHMEPSK WLS[RFIPS[ XSWTIGMJ]ERSFNIGXSV
KVSYTSJSFNIGXWXSFIMRGPYHIHMRE''+
3FNIGXQEWOWEVIXLIW]QFSPMGVIJIVIRGIWXLEXHIJMRIEGSHIGSRXVSPKVSYT
''+ ;LIR8IEQ'SHMRKTVSGIWWIWE''+MXEWWSGMEXIWEGIVXEMRVEROMRK
[MXLSFNIGXQEWOWMRSVHIVXSHIXIVQMRI[LMGLHEXEFEWISFNIGXWFIPSRKXSXLEX
''+ 

7IPIGXJVSQXLIJSPPS[MRKSTXMSRW



406

SQL Navigator Users Guide

3FNIGX8]TI

'LSSWIJVSQ:MI[4VSGIHYVI*YRGXMSR4EGOEKI
4EGOEKI&SH]SV%PP

7GLIQE

4MGOEYWIVJVSQXLIPMWXSVX]TIEWGLIQEREQI
=SYGERYWIXLI[MPHGEVHGLEVEGXIV

3FNIGX2EQI

=SYGERX]TIERSFNIGXREQIMRGPYHMRKXLI
[MPHGEVH%PXIVREXMZIP]]SYGERPEYRGLXLI3TIR
(&3FNIGXHMEPSKXSGLSSWIERSFNIGXQEXGLMRKXLI
3FNIGX8]TIERH7GLIQEWIXXMRKW

)\GPYHIH

7IPIGX)\GPYHIHXSI\GPYHIER]SFNIGXWQEXGLMRKXLMW
SFNIGXQEWOJVSQXLI''+

Remapping a CCGs project association


=SYGERGLERKIXLIEWWSGMEXMSRFIX[IIRE''+ERHE:'4TVSNIGX*SV
I\EQTPIMJ]SYSVMKMREPP]GSRJMKYVIHE''+[MXLSYXE:IVWMSR'SRXVSP
TVSHYGX :'4 ERHXLIRWYFWIUYIRXP]HIGMHIHXSYWISRI]SYGERYWIXLI
VIQETTMRKJIEXYVIXSEWWSGMEXIXLI''+ERHXLI:'4TVSNIGX

To remap a CCG
1
2

*VSQXLI7502EZMKEXSVQIRYFEVGLSSWI8IEQ'SHMRKERHXLIRGPMGO
'SHI'SRXVSP+VSYTW
-RXLI'SHI'SRXVSP+VSYTW[MRHS[GPMGOXLI6IQETXSSPFEVFYXXSR

Object mask ranking


3FNIGXQEWOWEVIVEROIHFEWIHSRXLIRYQFIVSJ[MPHGEVHWXLI]GSRXEMR
,MKLIWXVEROMRKMWKMZIRXSXLIQSWXWTIGMJMGQEWOERH[LIRXLIVIEVI
HYTPMGEXIQEXGLMRKQEWOWSJHMJJIVIRXVEROMRKXLILMKLIWXVEROMRKQEWOXEOIW
TVIGIHIRGI3RP][LIRHYTPMGEXIQEWOWSJXLIWEQIVEROMRKEVIIRGSYRXIVIHMW
MXRSXTSWWMFPIXSVIWSPZIXLISFNIGXXSXLI''+JSV[LMGLMXFIPSRKW
8LIQEWOVEROMRKWEVIJVSQLMKLIWXXSPS[IWX
7TIGMJMGSFNIGXVIJIVIRGI
Trigger SCHEMA.NAME

3RI[MPHGEVHSRP]
Any Type SCHEMA.NAME
Trigger SCHEMA%.NAME
Trigger SCHEMA.NAME%

Chapter 10

Version control and team coding

407

8[S[MPHGEVHW
Any Type SCHEMA%.NAME
Any Type SCHEMA.NAME%
Trigger SCHEMA%.NAME%

8LVII[MPHGEVHW
Any Type SCHEMA%.NAME%

Mapping a user to a CCG


8IEQ'SHMRKEPPS[WHIZIPSTIVWXSEWWSGMEXIXLIMVS[RWGLIQEW[MXLTEVXMGYPEV
'SHI'SRXVSP+VSYTW ''+W 8LMWQIERWXLEX]SYSTIRERSFNIGXMR]SYV
S[RWGLIQE7502EZMKEXSVWIEVGLIWJSVXLISFNIGXMRXLIQETTIH''+ERH
STIRWMXNYWXEWMJEWMJ]SYLEHSTIRIHXLISFNIGXJVSQXLISVMKMREPWGLIQE-J
]SYGLIGOSYXXLISFNIGXXLIEVGLMZIJSVXLISVMKMREPWGLIQEMWGLIGOIHSYX
ERHXLIHEXEFEWISFNIGXMWPSGOIHJSVFSXLWGLIQEW 
8LMWMWYWIJYPMRGEWIW[LIVI]SYSJXIR[SVOMR]SYVS[RWGLIQESRTVSNIGXW
GSRXEMRMRKSFNIGXWXLEXEGXYEPP]I\MWXMRERSXLIVWGLIQESV[SVOSRQSVIXLER
SRITVSNIGXSZIVEWLSVXTIVMSH
-RIWWIRGIQETTMRKEYWIVXSE''+MWIUYMZEPIRXXSGVIEXMRKERI[''+
MHIRXMGEPXSXLIQETTIH''+FYX[MXLEPP3FNIGXQEWOWVIJIVVMRKXSE
TEVXMGYPEVYWIVWGLIQE8LIWEQI:'4EVGLMZIMWWLEVIHFIX[IIRXLIYWIV
WGLIQEERHXLISXLIV TVSHYGXMSRSVHIZIPSTQIRX WGLIQE

To map a user to a CCG


1

0SKSRXSXLI3VEGPIMRWXERGI

2
3

3TIRXLI'SHI'SRXVSP+VSYTW[MRHS[
7IPIGXXLIETTVSTVMEXI''+ERHXLIRGPMGOXLI1ET9WIVXSSPFEVFYXXSR

-JXLI''+GSRXEMRW3FNIGX1EWOWJSVQYPXMTPIWGLIQEWJSPPS[XLI
TVSQTXWXSWIPIGXXLIWGLIQE]SY[ERX
-JVIUYMVIHTIVJSVQER-QTSVXXSYTHEXIXLISFNIGXWMR]SYVWGLIQE

Displaying all Mapped Users


=SYGERYWIEXSSPFEVFYXXSRSRXLI'SHI'SRXVSP+VSYTW[MRHS[XSSPFEVXS
WII[LMGLYWIVWEVIQETTIHXSETEVXMGYPEV''+
8LMWHMEPSKHMWTPE]WEPPQETTMRKWJSVXLIWIPIGXIH''+-JXLI''+GSRXEMRW
3FNIGX1EWOWJSVQYPXMTPIWGLIQEWXLIWIPIGXIHWGLIQEMWEPWSHMWTPE]IH

408

SQL Navigator Users Guide

Importing objects from your repository


=SYGERYTHEXI]SYV3VEGPIMRWXERGIJVSQXLIZIVWMSRGSRXVSPTVSNIGXJSVE
WIPIGXIH''+YWMRKXLI-QTSVXJIEXYVI

To import objects from your repository


1
2

3RXLI'SHI'SRXVSP+VSYTW[MRHS[XSSPFEVGPMGOXLI-QTSVXFYXXSR
*SPPS[XLITVSQTXWMRXLI-QTSVXHMEPSKXSWIPIGX ERHI\GPYHI SFNIGXWJSV
MQTSVX8LI-QTSVXPMWXMRKMWTSTYPEXIHFEWIHSRI\MWXMRKEVGLMZIW
GSRXEMRIHMRXLI:'4VITSWMXSV] SFNIGXWHSRSXLEZIXSI\MWXSRXLI
3VEGPIMRWXERGI FYXJMPXIVIHHS[RXSSRP]XLSWISFNIGXWHIJMRIHMRXLI
''+
8LIJSPPS[MRKSTXMSRWEVIEZEMPEFPI
Option

Description

9THEXISVMKMREP
WGLIQE

'VIEXISVYTHEXISFNIGXWMRXLISVMKMREPPSGEXMSRMR
XLI3VEGPIMRWXERGIEWTIVXLI''+ERHEVGLMZI
JMPIREQIW

9THEXIERSXLIV
WGLIQE

'LSSWIEREPXIVREXIHIWXMREXMSRWGLIQE%PP
SFNIGXW[MPPFIGVIEXIHMRXLMWWGLIQEVIKEVHPIWWSJ
XLISVMKMREPSFNIGXJSV[LMGLXLIEVGLMZI[EW
GVIEXIH
=SYQYWXLEZIXLIETTVSTVMEXITVMZMPIKIWXSGVIEXI
SFNIGXWMRXLIHIWXMREXMSRWGLIQE

*SVGI6IZMWMSR

'VIEXIERI[VIZMWMSRMRXLI:'4VITSWMXSV]JSV
IEGLEVGLMZIYWMRKXLIGSQQIRXIRXIVIHLIVIXS
MRHMGEXIXLIVIEWSRJSVXLIRI[VIZMWMSR

-RXLI-QTSVX3TXMSRWHMEPSKGLSSWIXLIHIWXMREXMSRJSVMQTSVXIHSFNIGXW

Exporting objects to the repository


3RGI]SYLEZIGSRJMKYVIHGSHIGSRXVSPKVSYTW ''+W ]SYGERGSRWXVYGXE
JMVWXVIZMWMSRSJERETTPMGEXMSRHIZIPSTQIRXTVSNIGXMR]SYVZIVWMSRGSRXVSP
VITSWMXSV]YWMRKXLI)\TSVXJIEXYVI
=SYGEREPWSYWIXLI)\TSVXJIEXYVIXSGVIEXIERI[VIZMWMSRMR]SYVVITSWMXSV]
JSVEPPSFNIGXWJSVI\EQTPI[LIR]SYLEZIGSQTPIXIH]SYVTVSNIGXERH
YTHEXIH]SYVTVSHYGXMSRWIVZIV

Chapter 10

Version control and team coding

409

-RSVHIVXSTIVJSVQXLIWISTIVEXMSRW]SYWLSYPHLEZIEGGIWWXSEPPXLISFNIGXW
VIJIVIRGIHF]XLI''+3XLIV[MWIXLITVSGIWW[MPPRIIHXSFIPEYRGLIH
QYPXMTPIXMQIWF]EPPXLIHMJJIVIRXS[RIVWSJXLISFNIGXW

To export objects to your repository


1
2
3

3RXLI'SHI'SRXVSP+VSYTW[MRHS[XSSPFEVGPMGOXLI)\TSVXFYXXSR
*SPPS[XLITVSQTXWMRXLI)\TSVXHMEPSKXSWIPIGX ERHI\GPYHI SFNIGXWJSV
I\TSVX
-RXLI)\TSVX3TXMSRWHMEPSKWIPIGXJVSQXLIJSPPS[MRKSTXMSRW
Option

Desciption

%HHSFNIGXWRSXI\MWXMRKMR
XLIVITSWMXSV]

%PPS[WRI[WXSVIHTVSKVEQWXSFIEHHIH
XSXLI:'4VITSWMXSV]%R]SFNIGXWJSV
[LMGLXLIVIEVIEPVIEH]:'4EVGLMZIW[MPP
RSXFIYTHEXIH

'VIEXIERI[VIZMWMSRJSV
I\MWXMRKSFNIGXW

*SVGIWEPPI\MWXMRKEVGLMZIW[MXLMRXLI
VITSWMXSV]XSFIYTHEXIHEW[IPPEW
EHHMRKRI[EVGLMZIWJSVER]RI[
HEXEFEWISFNIGXW

'VIEXIEVIZMWMSRSRP]MJXLI
SFNIGXLEWGLERKIH

'SQTEVIWXLISFNIGXMRXLIHEXEFEWI[MXL
XLIEVGLMZIMRXLIVITSWMXSV]YTHEXMRKMX
SRP]MJMXHMJJIVW8LMWMWYWIJYP[LIR
SFNIGXWLEZIFIIRQSHMJMIHF]EXSSP
SXLIVXLER7502EZMKEXSV

4VSQTXMRHMZMHYEPP]JSVEPP
I\MWXMRKSFNIGXW

4IVQMXWXLI]SYXSGLSSWIJSVIEGLSFNIGX
XLEXEPVIEH]I\MWXWMRXLIVITSWMXSV]
[LIXLIVSVRSXMX[MPPFIYTHEXIH

'SQQIRX

0IXW]SYIRXIVEGSQQIRXXSFIETTPMIH
XSEPPRI[VIZMWMSRWGVIEXIHMRXLI
VITSWMXSV]

-JVIUYMVIHWEZISVTVMRXXLIWXEXYWVITSVXYWMRKXLIFYXXSRWTVSZMHIH

410

SQL Navigator Users Guide

Installing third-party version control products


7502EZMKEXSVJSV3VEGPIZIVWMSRTVSZMHIWTS[IVJYPGYWXSQM^EFPI
MRXIKVEXMSR[MXLXLMVHTEVX]ZIVWMSRGSRXVSPW]WXIQW :'7 8LMWHSGYQIRX
TVSZMHIWFEWMGLMRXWJSVMRWXEPPMRKWSQISJXLIFIWXORS[R:'7TVSHYGXWWS
XLEXXLI]GERFIYWIH[MXL7502EZMKEXSV*SVHIXEMPIHMRJSVQEXMSRSV
XIGLRMGEPWYTTSVXTPIEWIVIJIVXSXLIYWIVHSGYQIRXEXMSRTVSZMHIH[MXLXLI
:'7TVSHYGX]SYEVIEXXIQTXMRKXSYWI
4PIEWIRSXIXLEX]SYGERMRWXEPPXLIXLMVHTEVX]:'7WSJX[EVIIMXLIVFIJSVISV
EJXIVMRWXEPPMRK7502EZMKEXSV*SV7502EZMKEXSVMRXIKVEXMSR[MXLXLMVH
TEVX]:'7TVSHYGXW]SYQYWXMRWXEPPXLI7502EZMKEXSV8IEQ'SHMRK
WYTTSVXJSVXLIXLMVHTEVX]:'7TVSHYGX W ]SY[MPPFIYWMRK8SMRWXEPPXLI
7502EZMKEXSV8IEQ'SHMRKJIEXYVIWVYRXLI7IVZIV7MHI-RWXEPPEXMSR;M^EVH
JVSQXLI7502EZMKEXSV8SSPWQIRYERHWIPIGXXLI8IEQ'SHMRK7YTTSVX
WGVMTX

Installing Rational Clearcase


1

2
3

6YRXLI6EXMSREP'PIEVGEWIWIXYTTVSKVEQERHGLSSWIXLI)ZEPYEXMSR
-RWXEPPEXMSRSJ'PIEVGEWI 8LI7MXI4VITEVEXMSRWXITMWRSXVIGSQQIRHIH
JSVFIKMRRMRKYWIVW 
=SYGEREGGITXXLIHIJEYPXWIXXMRKWJSVQSWXMRWXEPPEXMSRSTXMSRW
3RGI'PIEVGEWIMWMRWXEPPIHVYRXLIXYXSVMEP8LMW[MPPWIXYTE:3&ERH
ZMI[XLEXGERFIYWIH[MXL7502EZMKEXSVERH[MPPTVSZMHI]SY[MXLXLI
UYMGOIWX[E]XSWII7502EZMKEXSV[SVOMRK[MXL'PIEVGEWI

To run the tutorial


1
2
3

Start up the Clearcase Home Base.


Choose the Getting Started tab, and then click on the tutorial.
Choose the Base Clearcase Tutorial.

;LIRTVSQTXIHGPMGOSRXLIFYXXSRXSGVIEXIE:3&ERH:MI[

3RGI]SYLEZIE:3&ERHZMI[]SYGERUYMXXLIXYXSVMEPERHFIKMRYWMRK
2EZMKEXSV[MXLXLMW:3&:MI[

Installing Microsoft Visual SourceSafe


1
2

6YRXLI1MGVSWSJX:MWYEP7SYVGI7EJIWIXYTTVSKVEQ
;LIRTVSQTXIHJSVX]TISJMRWXEPPEXMSRGLSSWI7XERHEPSRI=SYGER
EGGITXXLIHIJEYPXWIXXMRKWJSVEPPSXLIVSTXMSRW

Chapter 10

Version control and team coding

411

Installing StarBase StarTeam


1

-RWXEPPXLIWIVZIVF]VYRRMRKXLI7XEV&EWI7XEV8IEQWIXYTTVSKVEQ

'LSSWI'YWXSQ-RWXEPPEXMSR=SYGEREGGITXXLIHIJEYPXGSQTSRIRXWFYX
FIWYVIXSMRGPYHIXLI'PMIRX7IXYTGSQTSRIRX8LMW[MPPMRWXEPPEGPMIRX
TEGOEKIWS]SYGERVYRXLIWIXYTSRXLIGPMIRX4'W
%JXIVXLIWIVZIVMWMRWXEPPIHMRWXEPPXLIGPMIRXWSJX[EVI*MRHXLI@'PMIRX
7IXYTHMVIGXSV]YRHIVXLIHMVIGXSV][LIVI]SYMRWXEPPIHXLIWIVZIV
WSJX[EVI
'LSSWI'YWXSQ-RWXEPPEXMSR=SYGEROIITXLIHIJEYPXGSQTSRIRXWFYXFI
WYVIXSMRGPYHIXLI:&ERH(IZIPSTIV7XYHMS-RXIKVEXMSRXSMRWXEPPXLI7''
MRXIVJEGI
;LIRTVSQTXIHXSGLSSWI[LIXLIV]SY[ERX7XEV8IEQXSFI]SYVHIJEYPX
TVSZMHIV]SYGERERW[IV=IWSV2SRIMXLIVSTXMSR[MPPEJJIGXXLI[E]
7XEV8IEQ[SVOW[MXL7502EZMKEXSV
;LIR7XEV&EWI7XEV8IEQGPMIRXWIXYTMWGSQTPIXI]SYRIIHXSWXEVXXLI
WIVZIVFIJSVI]SYGERGSRRIGXXSMX
7IPIGXXLI7IVZIVJVSQXLI7XEVXQIRY'LSSWIXLIHIJEYPXWIVZIV 7XEV(VE[
6ITSWMXSV] ERHGPMGO7XEVX7IVZIV
3RGIXLI7IVZIVLEWWXEVXIH]SYGERGSRRIGXXSMXZME7502EZMKEXSV

6
7
8

Installing Merant PVCS


8LMWETTPMIWXSZIVWMSRERHEFSZI 
1 6YRXLI1IVERX4:'7WIXYTTVSKVEQ=SYGEREGGITXXLIHIJEYPXWIXXMRKW
JSVQSWXSTXMSRW
2 ;LIRTVSQTXIHXSWIPIGX[LMGLGSQTSRIRXWXSMRWXEPPWIPIGXIZIV]
GSQTSRIRXMRGPYHMRKXLI4:'7(IZIPSTIVkW8SSPOMXEWXLMWMRWXEPPWXLI
7''MRXIVJEGIJSV4:'7
3 3RGI4:'7MWMRWXEPPIHWXEVX4:'7
4
5

;LIRXLIWTPEWLWGVIIRETTIEVWGLSSWIXSSTIRXLITVIZMSYWHEXEFEWI
8LMW[MPPSTIRXLIWEQTPIHEXEFEWI
6MKLXGPMGOSRXLITVSNIGXHEXEFEWIERHGLSSWIXSGVIEXIERI[TVSNIGX
3RGIXLITVSNIGXLEWFIIRGVIEXIH]SYGERXLIRYWIXLMWTVSNIGX[MXL750
2EZMKEXSV

11
SQL Navigator reports

8LMWGLETXIVI\TPEMRWLS[XSKIRIVEXI7502EZMKEXSVHEXEFEWIVITSVXW

In this chapter
SQL Navigator reports

414

414

SQL Navigator Users Guide

SQL Navigator reports


7502EZMKEXSVSJJIVWEWIPIGXMSRSJTVIHIWMKRIHHEXEFEWIVITSVXJSVQEXW
7502EZMKEXSVGSRXEMRWJPI\MFPIVITSVXMRKXSSPWXLEXPIX]SYTVMRXVITSVXWSR
EPPSVWIPIGXIHSFNIGXWMREHEXEFEWI=SYGERKIRIVEXIVITSVXWJVSQEPP
HEXEFEWIMRWXERGIWSVJVSQWIPIGXIHHEXEFEWIWERH]SYGERWTIGMJ]GVMXIVMEXS
PMQMXXLIVITSVXXSGIVXEMRXEFPIWSVGSPYQRW
(S^IRWSJVITSVXXIQTPEXIWEVITVSZMHIHJSVTVMRXMRKVITSVXWSJWIPIGXIHSFNIGXW
JVSQSRISVQSVIHEXEFEWIW



Chapter 11

SQL Navigator reports

415

To generate a database report


1

*VSQXLI8SSPWQIRYFEVGLSSWI6ITSVX8VII

-RXLI6ITSVX8VIIHSYFPIGPMGOXLIREQISJXLIVITSVX]SY[ERX
;LIRXLIVITSVXTEVEQIXIVWIXYT[MRHS[ETTIEVW]SYGEREGGITXXLI
HIJEYPXZEPYIWSVIRXIVRI[TEVEQIXIVW=SYGERYWI[MPHGEVHWWYGLEW
TIVGIRXWMKRJSVQYPXMTPIGLEVEGXIV[MPHGEVH ERHC YRHIVWGSVIJSVWMRKPI
GLEVEGXIV[MPHGEVH XSVIJMRI]SYVVITSVXWIPIGXMSR
4 'PMGO3/
%JXIV7502EZMKEXSVKIRIVEXIWXLIVITSVXMXHMWTPE]WXLIVITSVXMRXLI4VMRX
4VIZMI[[MRHS[
2
3

Print preview options


8LIJSPPS[MRKGSQQERHWEVIEZEMPEFPIMRXLI4VMRX4VIZMI[[MRHS[XSSPFEV
 8SEHZERGIXSEWTIGMJMGTEKI]SY[MWLXSZMI[FIJSVITVMRXMRKGPMGOXLI
*MVWX4VMSV2I\X0EWXFYXXSRWSVX]TIERYQFIVMRXLITEKIRYQFIVW
FS\
 8SIRLERGI]SYVZMI[SJXLITEKIGPMGOXLI;LSPI4EKI;MHXL
FYXXSRWXS^SSQXLITEKIWM^ISVX]TIXLITIVGIRXEKIMRXLI[MRHS[XS
^SSQXLITEKIXSXLEXTIVGIRXEKI
 8SWIRHXLIVITSVXXSEXI\XJMPIJSVPEXIVYWIGPMGO4VMRXXS8I\X*MPI
 8SWIRHXLIVITSVXXSXLITVMRXIVGPMGO4VMRX

12
Customizing SQL Navigator

8LMWGLETXIVI\TPEMRWLS[XSGYWXSQM^IQIRYWERHXSSPFEVWERHLS[XSWIX
TVIJIVIRGIWJSVXLISTIVEXMSRSJ7502EZMKEXSV
In this chapter
Customizing menus and toolbars
Setting SQL Navigator preferences
To display the Preferences dialog
General preferences
User interface preferences
Dockable Output Window
Drop and Truncate safety options
Session preferences
Default Tables preferences
Drag and drop coding preferences
Explain Plan preferences
Code Assistant preferences
Printing preferences
Object editor preferences
Debugger preferences
Extract DDL preferences
Extract DDL Table/View Specific preferences
Extract DDL/Partitioning preferences
Workspace preferences
Code Editor preferences
SQL Editor Preferences
Stored Program Editor Preferences
General Code Editor Preferences
LOB Viewer preferences
Difference viewer preferences
Team Coding preferences

418
419
419
420
420
421
421
422
424
425
425
425
427
428
428
429
431
431
432
433
433
434
435
437
438
439

418

SQL Navigator Users Guide

Customizing menus and toolbars


1IRYWERHXSSPFEVWEVIGSQTPIXIP]GYWXSQM^EFPI=SYGER
 EHHSVVIQSZIQIRYERHXSSPFEVFYXXSRWERHGSQQERHW
 EHHSVVIQSZIXSSPFEVWERHQIRYWXLIQWIPZIW
 GVIEXIRI[QIRYWERHXSSPFEVW
%R]GYWXSQM^EXMSRMWWEZIHTIVQERIRXP]MRXLIW]WXIQVIKMWXV]ERHVIWXSVIH
EYXSQEXMGEPP]RI\XXMQI7502EZMKEXSVMWVYR
;LIR7502EZMKEXSVMWJMVWXMRWXEPPIHIEGLSJMXWXSSPFEVWGSRXEMRWSRP]EJI[
XSSPFEVFYXXSRWJEVJI[IVXLERXLIRYQFIVXLEXEVIEZEMPEFPIJSVYWI
=SYYWIXLI'YWXSQM^IHMEPSKXSGLERKIXLIGSRXIRXWSJIZIV]XSSPFEVXSWYMX
]SYV[E]SJ[SVOMRK

To open the Customize dialog


1





3REHSGOIHXSSPFEVGPMGOXLI1SVI&YXXSRWFYXXSRERHXLIRGPMGO%HH
SV6IQSZI&YXXSRW
SV
3REJPSEXMRKXSSPFEVVMKLXGPMGOXSHMWTPE]XLIWLSVXGYXQIRY

WKH0RUH%XWWRQVEXWWRQ
2 'LSSWI'YWXSQM^I
3 -RXLI'SQQERHWXEFWIPIGXE'EXIKSV]XSZMI[XLIEZEMPEFPIXSSPFEV
FYXXSRWMRXLEXGEXIKSV]
4 8LI'SQQERHWPMWXJSVIEGLGEXIKSV]GSRXEMRWEPPXLIEZEMPEFPIFYXXSRW


7SQIFYXXSRWEVIEZEMPEFPISRP]JSVWTIGMJMIHXSSPFEVW*SVI\EQTPI(&
2EZMKEXSVFYXXSRWEVIEZEMPEFPISRP]JSVXLI(&2EZMKEXSVXSSPFEV

To reset toolbars to the default settings


1
2
3
4

3RXLIJEVVMKLXSJXLIQEMRQIRYFEVSVSJER]XSSPFEVGPMGOXLI  1SVI
&YXXSRW FYXXSR
'LSSWI%HHSV6IQSZI&YXXSRW
7IPIGXXLIMXIQWXSFIVIWIXERHXLIRGPMGO6IWIX8SSPFEV2SXIXLEXER]
TVIZMSYWGYWXSQM^EXMSRW[MPPFIPSWX
'SRJMVQXLITVSQTXXSVIWIXXLIWIPIGXIHXSSPFEVW

Chapter 12

Customizing SQL Navigator

419

To display or hide individual toolbars


1
2
3

3RXLIJEVVMKLXSJXLIQEMRQIRYFEVSVSJER]XSSPFEVGPMGOXLI  1SVI
&YXXSRW FYXXSR
'LSSWI%HHSV6IQSZI&YXXSRWERHXLIRGPMGOXLI'YWXSQM^IXEF
7IPIGXEXSSPFEVREQIXSQEOIXLEXXSSPFEVETTIEVMRXLI7502EZMKEXSV
ETTPMGEXMSR[MRHS[SVGPIEVXLIWIPIGXMSRXSLMHIMX

To add or remove individual commands


1

-RXLIQEMRQIRYFEVSRXLIJEVVMKLXGPMGOXLI  1SVI&YXXSRW FYXXSR

2
3

'LSSWI%HHSV6IQSZI&YXXSRWERHXLIRGPMGOXLI'YWXSQM^IXEF
8SVIQSZIMXIQWJVSQ7502EZMKEXSVQIRYWERHXSSPFEVW]SYGERWMQTP]
HVEKXLIQSJJXLIXSSPFEVSVQIRY[LMPIXLI'YWXSQM^IHMEPSKMWEGXMZI
8SEHHMXIQWXS7502EZMKEXSVQIRYWERHXSSPFEVW]SYGERWMQTP]HVEK
XLIQJVSQXLIGSQQERHPMWXWMRXLI'YWXSQM^IHMEPSKXSXLIXSSPFEVSV
QIRY[LIVI]SY[ERXXLIQXSFIZMWMFPI

Setting SQL Navigator preferences


8LI4VIJIVIRGIWHMEPSKVITVIWIRXWTVIJIVIRGIWYWMRKELMIVEVGLMGEPX[SGSPYQR
KVMH
3ZIVSRILYRHVIHTVIJIVIRGIWIXXMRKWEVIEZEMPEFPIJSV]SYXS[SVO[MXL 

To display the Preferences dialog


 'LSSWISRISJXLIJSPPS[MRK
 -RXLI:MI[QIRYGLSSWI4VIJIVIRGIW
 SV
 6MKLXGPMGOMRE[MRHS[ERHXLIRGLSSWI4VIJIVIRGIW 
=SYGERYWIOI]FSEVHWLSVXGYXWXS[SVO[MXLXLITVIJIVIRGIWHMEPSKW

420

SQL Navigator Users Guide

General preferences
The subcategories under General preferences include the following, which are
described under their respective headings:
 9WIV-RXIVJEGI
 l(VSTzERHl8VYRGEXIzWEJIX]STXMSRW
 7IWWMSR
 (IJEYPX8EFPIW
 (VEKERH(VSTGSHMRKTVIJIVIRGIW
 )\TPEMR4PER
 'SHI%WWMWXERX
 4VMRXMRK`
 3FNIGX)HMXSVW

User interface preferences


Tutorial Messages
;LIRWIPIGXIHHMWTPE]WXYXSVMEPQIWWEKIWEYXSQEXMGEPP]JSV[MRHS[W*MVWX
XMQIYWIVWQE]JMRHXLIWIQIWWEKIWIWTIGMEPP]LIPTJYP

Hints
)REFPISVHMWEFPI8SSP8MTWXLIPEFIPWXLEXTSTYT[LIR]SYTSMRXXSE
FYXXSRSVSXLIVGSRXVSP

Font
8LIJSRXJSVXI\XMR7502EZMKEXSV[MRHS[W

Date Displayed Format


7TIGMJMIWXLIWX]PIXSFIYWIHJSVHMWTPE]MRKHEXIW

Time Displayed Format


7TIGMJMIWXLIWX]PIXSFIYWIHJSVHMWTPE]MRKXMQIW

Chapter 12

Customizing SQL Navigator

421

Display time in DATE fields


7TIGMJMIW[LIXLIV(%8)JMIPHWWLSYPHMRGPYHIXLIXMQI

Bold Folders in DB Navigator Tree


'SRXVSPW[LIXLIVXLIJSPHIVWEVIHMWTPE]IHEWFSPHSVRSXFSPHMRXLIXVII
1EOMRKXLIJSPHIVWETTIEVMRFSPHQE]LIPTGPEVMJ]XLIWXVYGXYVISJEGSQTPI\
XVII

Pin at Start
8LI4MREX7XEVXSTXMSRGSRXVSPWXLIHIJEYPXFILEZMSVSJWIPIGXIHIHMXMRK
[MRHS[W[LIR]SYSTIRQYPXMTPISFNIGXW
;LIRXLIIHMXMRK[MRHS[MWTMRRIH]SYGERSTIRX[SSVQSVIMRWXERGIWSJ
XLIWEQIX]TISJSFNIGXIHMXSVEXXLIWEQIXMQI
-JXLI[MRHS[MWRSXTMRRIHXLIRMJ]SYSTIRERSXLIVSFNIGXSJXLIWEQIX]TI
XLEXSFNIGX[MPPVITPEGIXLIGYVVIRXSFNIGXHMWTPE]IHMRXLIIHMXMRK[MRHS[
8LMWTVIJIVIRGIWIXWXLIHIJEYPXFILEZMSVJSVXLIWIPIGXIH[MRHS[W3RGIE
[MRHS[SJXLIWIPIGXIHX]TIMWSTIR]SYGERTMRSVYRTMRMXEXER]XMQI

Dockable Output Window


8LI7502EZMKEXSV3YXTYX[MRHS[LEWXEFFIHTEKIWJSVSYXTYXJVSQ
HMJJIVIRXWIWWMSRWTPYWSRITEKIJSVKIRIVEPQIWWEKIWRSXVIPEXIHXSE
TEVXMGYPEVWIWWMSR8LI3YXTYX[MRHS[GERFIQEHIHSGOEFPIIMXLIVF]XLMW
TVIJIVIRGIWIXXMRKSVF]QIERWSJEWLSVXGYXQIRYSTXMSR;LIRHSGOEFPIXLI
[MRHS[MWEP[E]WZMWMFPIXLEXMWEP[E]WSRXST

Drop and Truncate safety options


No Drop or Truncate for Table/Cluster
(MWEFPIXLIHVSTERHXVYRGEXIJYRGXMSRWJSVXEFPIWERHGPYWXIVW

No Drop or Truncate for Stored Programs/Triggers


(MWEFPIWXLIHVSTERHXVYRGEXIJYRGXMSRWJSVWXSVIHTVSKVEQWERHXVMKKIVW

422

SQL Navigator Users Guide

Session preferences
Show Logon Dialog at startup
;LIRWIPIGXIHHMWTPE]WXLI3VEGPI0SKSRHMEPSK[LIR]SYPEYRGL750
2EZMKEXSV 

Immediately Commit Every DML Statement


6ITPEGIWXLIJSVQIV%YXS'SQQMXSTXMSR 
;LIRWIPIGXIHIZIV]750(10WXEXIQIRX WYGLEW9THEXI-RWIVXERH(IPIXI 
I\IGYXIHMRXLI750)HMXSVIMXLIVHMVIGXP]SVMRHMVIGXP]EWTEVXSJ40750
WXSVIHGSHIMWMQQIHMEXIP]GSQQMXXIHXSXLIHEXEFEWI

Default Date Format


)RXIVXLIHIJEYPXHEXIJSVQEXJSVI\EQTPI11((=====SYGERGPMGOXLI
EVVS[MRXLIHVSTHS[RPMWXFS\XSWIIEPMWXSJEZEMPEFPIJSVQEXW
7502EZMKEXSVYWIWXLI(IJEYPX(EXI*SVQEXSRP][LIRXLIYWIVVIUYIWXW
HEXIXSWXVMRKGSRZIVWMSRI\TPMGMXP]JSVI\EQTPIMR
 SELECT TO_CHAR(SYSDATE) FROM DUAL
3XLIV[MWIXLMWZIVWMSRSJ7502EZMKEXSVYWIWFMREV]JSVQEXJSVHEXIXMQI
LERHPMRKERHVITVIWIRXWHEXIXMQISRWGVIIRYWMRKXLIGPMIRXQEGLMRI
W
6IKMSREP7IXXMRKW EWWIXMRXLI;MRHS[W'SRXVSP4ERIP 

Auto run script at logon


)RXIVXLIREQISJXLIER]WGVMTX]SY[MWLXSVYREYXSQEXMGEPP][LIR]SY
GSRRIGXXSEHEXEFEWIYWMRK7502EZMKEXSV

Enable using DBA dictionary views


&]HIJEYPX7502EZMKEXSVKMZIW]SY97)6SFNIGXHEXEHMGXMSREV]ZMI[W
QIERMRK]SYGERWIISRP]SFNIGXW]SYS[RSVJSV[LMGL]SYLEZIFIIRKVERXIH
SFNIGXTVMZMPIKIW=SYGERWIPIGX)REFPIYWMRK(&%HMGXMSREV]ZMI[WMJ]SY
[ERXXSWIIEPPSFNIGXWEZEMPEFPIYRHIV]SYV(&%YWIVTVMZMPIKIW(&%
HMGXMSREV]ZMI[WEVIVIUYMVIHJSVIHMXMRK4VSJMPIW6SPIWERH9WIVWSVJSV
ZMI[MRKXLIJSPPS[MRKRSHIWSJXLI(&2EZMKEXSVXVII

Chapter 12

Customizing SQL Navigator







423

6SPIW
7SQIRSHIWYRHIV9WIVW
(EXEJMPIWYRHIV8EFPIWTEGIW
6IHS0SK+VSYTW
6SPPFEGO7IKQIRXW

Required privileges
*SVEGGIWWXS(&%HMGXMSREV]ZMI[WEYWIVQYWXLEZISRISJXLIJSPPS[MRK
VSPIWSVTVMZMPIKIW
 (&%6SPI
 7)0)'8C'%8%03+C630)6SPI
 7)0)'8%2=8%&0)4VMZMPIKI
(&%VSPIERH7)0)'8C'%8%03+C630)VSPIQYWXFIHIJMRIHEWXLIHIJEYPX
VSPIWMR3VEGPI
-REHHMXMSRXSXLI7)0)'8%2=8%&0)TVMZMPIKI3VEGPIMQE]EPWSVIUYMVI
XLIYWIVXSLEZIXLI7)0)'8%2=(-'8-32%6=TVMZMPIKIMJXLI
3C(-'8-32%6=C%'')77-&-0-8=MRMXMEPM^EXMSRTEVEQIXIVMWWIXXS*%07)

How SQL Navigator handles DBA views


;LIR(&%HMGXMSREV]ZMI[WEVIWIPIGXIH7502EZMKEXSVMRXIVVSKEXIWXLIHEXE
HMGXMSREV]HMJJIVIRXP]
 6IKEVHPIWWSJ(&%:MI[WIXXMRK7502EZMKEXSVYWIW97)6CZMI[WJSV
XLIPSKKIHSRYWIVkWSFNIGXW
 ;MXLSYX(&%:MI[W7502EZMKEXSVYWIW%00CZMI[WJSVSXLIVYWIVkW
SFNIGXW
 ;MXL(&%:MI[W7502EZMKEXSVYWIW7=7(&%CZMI[WJSVSXLIVYWIVkW
SFNIGXW
Using DBA dictionary views may affect
performance for some Oracle instances,
depending on the number of users and objects, as
well as other environmental factors.

DBMS Output buffer (bytes)


8LIRYQFIVSJF]XIWXLEXXLIHEXEFEWIEPPSGEXIWXSXLI(&17SYXTYX
*SVMRJSVQEXMSRWII8SHMWTPE]XLI3YXTYX[MRHS[

424

SQL Navigator Users Guide

Cache Capacity
8LIRYQFIVSJHEXEFEWISFNIGXWXLEXGERFITPEGIHMRXLIGEGLIFIJSVIXLI
GEGLIVIJVIWLIWMXWIPJERHEGGIWWIWXLIHEXEFEWI

Read Buffer Size


8LIRYQFIVSJVIGSVHWXLEX7502EZMKEXSVVIEHWTIVHEXEFEWIVIUYIWX

Trace Enable
8SPSKEPPXVERWEGXMSRW[MXLXLIHEXEFEWIXSEJMPI9WIJYPJSVHIFYKKMRK
TYVTSWIW

Trace Level
8LIX]TISJQIWWEKIWXLEXXLIXVEGIJMPI[MPPVIGSVH

Immediate load in Open Object dialog


7IPIGXXLMWTVIJIVIRGIMJ]SY[ERX7502EZMKEXSVXSEYXSQEXMGEPP]FYMPHE
TMGOPMWXSJEPPEZEMPEFPIHEXEFEWISFNIGXW[LIR]SYGLSWI3TIR(&3FNIGXJVSQ
XLI3FNIGXQIRY'PIEVXLMWTVIJIVIRGIMJ]SY[ERXXSWEZIXMQIERHVIWSYVGIW
F]WTIGMJ]MRKWIPIGXMSRTEVEQIXIVWFIJSVIPSEHMRKXLITMGOPMWX

Default Tables preferences


Exception Table Owner
2EQISJXLIWGLIQE[LIVIXLII\GITXMSRXEFPIMWXSFIWXSVIH 

Exception Table
2EQISJXLII\GITXMSRXEFPI

Chained Rows Table Owner


2EQISJXLIWGLIQE[LIVIXLIGLEMRIHVS[WEVIXSFIWXSVIH

Chapter 12

Customizing SQL Navigator

425

Chained Rows Table


2EQISJXLIGLEMRIHVS[WXEFPI

Drag and drop coding preferences


Drag and Drop arguments with procedure
-JWIPIGXIH[LIR]SYTEWXISVHVEKTVSGIHYVIWERHJYRGXMSRWMRXSERIHMXSV
XLIEVKYQIRXW[MPPFIMRGPYHIH

Explain Plan preferences


Explain Plan Table Owner
9WIVREQISJXLIS[RIVSJXLIHIJEYPXTPERXEFPI

Explain Plan Table


2EQISJXLIHIJEYPXTPERXEFPI

Save SQL with Explain Plan


;LIRWIPIGXIHWEZIWXLI750WGVMTX[LIR]SYWEZIXLI)\TPEMR4PER

Code Assistant preferences


8LI'SHI%WWMWXERXKMZIW]SYMRWXERXEGGIWWXSE7]RXE\ERH;IF'EXEPSKE
'SHIERH750'EXEPSKERH40:MWMSRGEXEPSKW-XEPPS[WYWIVWXSHVEKERH
HVST40750W]RXE\750JYRGXMSRWGSPYQRREQIWERHHEXEFEWISFNIGX
REQIWMRXSGSHIMRGPYHMRKEGGIWWXSXLI40:MWMSRGEXEPSKW

Auto Start with Editors and Explain Plan


3TIRW'SHI%WWMWXERXEYXSQEXMGEPP][LIRERIHMXSVSVXLI)\TPEMR4PERMW
STIRIH

426

SQL Navigator Users Guide

Displayed Pages Syntax Catalog


7LS[XLI7]RXE\'EXEPSKMRXLI'SHI%WWMWXERX

Displayed Pages Web Catalog


7LS[XLI;IF'EXEPSKMRXLI'SHI%WWMWXERX

Displayed Pages Code Catalog


7LS[XLI'SHI'EXEPSKMRXLI'SHI%WWMWXERX

Displayed Pages SQL Catalog


7LS[XLI750'EXEPSKMRXLI'SHI%WWMWXERX

Displayed Pages Standards Catalog


7LS[XLI7XERHEVHW'EXEPSKMRXLI'SHI%WWMWXERX

PL / Vision Catalog PL / Vision Lite


7LS[XLI40:MWMSR0MXI'EXEPSKMRXLI'SHI%WWMWXERX

PL / Vision Catalog PL / Vision Professional


7LS[XLI40:MWMSR4VSJIWWMSREP'EXEPSKMRXLI'SHI%WWMWXERX

Standards Catalog Directory


8LIHMVIGXSV]TEXLJSVXLI7XERHEVHW'EXEPSK

Shared Catalog Directory


8LIHMVIGXSV]TEXLJSVXLI7LEVIH'EXEPSK

Chapter 12

Customizing SQL Navigator

427

Printing preferences
8LITVMRXMRKTVIJIVIRGIWGSRXVSPXLIETTIEVERGISJTVMRXIVSYXTYXJVSQZEVMSYW
7502EZMKEXSV[MRHS[WHMEPSKWERHVITSVXW

Measurement units
7IPIGXXLIQIEWYVIQIRXYRMX]SY[ERXXSYWIJSVWTIGMJ]MRKQEVKMR[MHXLERH
SXLIVTVMRXWIXXMRKW

Header and Footer


)REFPISVHMWEFPILIEHIVWERHJSSXIVWSRTVMRXIHSYXTYX7TIGMJMGLIEHIVERH
JSSXIVTVSTIVXMIWEVIWTIGMJMIHMREWITEVEXIRSHISJXLI4VIJIVIRGIWXVII WII
FIPS[ 

Font
7IPIGXXLIJSRXXSFIYWIHJSVTVMRXMRK7502EZMKEXSVSYXTYX

Margins
7TIGMJ]XLI[MHXLSVLIMKLXSJXLITEKIQEVKMRWYWMRKXLI1IEWYVIQIRX9RMXW
WTIGMJMIHEFSZI

Header
7TIGMJ]XLITVSTIVXMIWJSVXLITEKILIEHIV&IWYVIXSIREFPIXLI,IEHIVERH
*SSXIVGLIGOFS\YRHIV4VMRXMRKMRXLI4VIJIVIRGIWXVIIMJ]SY[ERXLIEHIVWERH
JSSXIVWXSFITVMRXIH

Footer
7TIGMJ]XLITVSTIVXMIWJSVXLITEKIJSSXIV&IWYVIXSIREFPIXLI,IEHIVERH
*SSXIVGLIGOFS\YRHIV4VMRXMRKMRXLI4VIJIVIRGIWXVIIMJ]SY[ERXLIEHIVWERH
JSSXIVWXSFITVMRXIH

Editors
8LITVIJIVIRGIWYRHIVXLI)HMXSVWRSHIETTP]XSSYXTYXTVMRXIHJVSQER
IHMXMRK[MRHS[JSVI\EQTPIXLI8VMKKIV)HMXSVXLI750)HMXSVSVXLI7XSVIH
4VSGIHYVI)HMXSV

DB Navigator
8LITVIJIVIRGIWYRHIVXLI(&2EZMKEXSVRSHIETTP]XSSYXTYXTVMRXIHJVSQ
XLI(&2EZMKEXSV[MRHS[

428

SQL Navigator Users Guide

Orientation
If you choose a printer orientation setting other
than Default, your setting will override any setting
made in the Print Setup dialog when you print.

Object editor preferences


8LIWITVIJIVIRGIWETTP]XSXLIFILEZMSVSJXLI:MWYEP3FNIGX)HMXSVW

Auto Recompile Dependants


;LIRWIPIGXIHEYXSQEXMGEPP]VIGSQTMPIWHITIRHIRXSFNIGXW[LIRERSFNIGXMW
EPXIVIH8LIHIJEYPXMWSJJXSJSVGIEQERYEPVIGSQTMPISJHITIRHIRXSFNIGXW
FEWIHSR]SYVTVIJIVIRGI

Auto Recompile Invalid Only


;LIRWIPIGXIHEYXSQEXMGEPP]VIGSQTMPIWSRP]XLIHITIRHIRXSFNIGXWXLEXLEZI
EWXEXYWSJMRZEPMH(MWEFPIXLMWSTXMSRMJ]SY[ERXXSJSVGIEPPHITIRHIRX
SFNIGXWXSVIGSQTMPIEYXSQEXMGEPP][LIRYWMRKXLIHIFYKKIVJIEXYVI

Pinned at start
;LIRXLIIHMXMRK[MRHS[MWTMRRIH]SYGERSTIRX[SSVQSVIMRWXERGIWSJ
XLIWEQIX]TISJSFNIGXIHMXSVEXXLIWEQIXMQI
-JXLI[MRHS[MWRSXTMRRIHXLIRMJ]SYSTIRERSXLIVSFNIGXSJXLIWEQIX]TI
XLEXSFNIGX[MPPVITPEGIXLIGYVVIRXSFNIGXHMWTPE]IHMRXLIIHMXMRK[MRHS[
=SYGERTMRSVYRTMRERSTIR[MRHS[EXER]XMQI8LMWTVIJIVIRGIWIXWXLI
HIJEYPXFILEZMSVJSVSFNIGXIHMXSV[MRHS[W

Debugger preferences
Tooltip Evaluation
;LIRMRHIFYKKMRKQSHISJETVSGIHYVIXLIYWIVQE]TPEGIXLIGYVWSVSZIV
ER]ZEVMEFPIERHXLIZEPYISJXLEXZEVMEFPI[MPPETTIEVEWEXSSPXMT

Chapter 12

Customizing SQL Navigator

429

Time Out
8LITIVMSHSJXMQIXLEXXLIHIFYKKIV[MPP[EMXJSVEVIWTSRWIJVSQXLIWIVZIV
[LIRTIVJSVQMRKEHIFYKKMRKEGXMSR

Auto Step Interval (x 100mS)


8LIYWIVGERWTIGMJ]LS[JEWXXLI][MWLXLIEYXSWXITXSKSXLVSYKLIEGLPMRI
SJXLITVSGIHYVI
4-(C()&9+C%98378)4!
7EZIH0SEHIH=IW
-QTPIQIRXIH=IW

Extract DDL preferences


Keywords case
'LSSWIXLIGEWIYWIHJSVOI][SVHWMRXLI((0

Names case
'LSSWIXLIGEWIYWIHJSVREQIWMRXLI((0

Show options before each Extract DDL


7LS[WXLITVIJIVIRGIWFIJSVIXLI((0MWI\XVEGXIHJVSQXLISFNIGX

Generate Comments
7LS[WTVIKIRIVEXIHGSQQIRXWMRXLI((0'ERFILIPTJYPXSMHIRXMJ]
HMJJIVIRXTEVXWSJXLIWGVMTX

Prefix with Schema Name


%R]3FNIGX2EQIXLEXMWHMWTPE]IH[MXLMRXLI((0MWTVIJM\IH[MXLXLI
7GLIQE2EQI

Include DROP
-RGPYHIWXLIHVSTWXEXIQIRXEXXLIFIKMRRMRKSJXLI((0XSHVSTXLISFNIGX
JMVWX

430

SQL Navigator Users Guide

Use "CREATE OR REPLACE"


%HHW'VIEXISV6ITPEGIXSXLIWXEVXSJXLISFNIGXVEXLIVXLERNYWXLEZMRK
'VIEXI

Exclude default values


)\GPYHIWHIJEYPXZEPYIWJVSQXLI((0WXEXIQIRX

Include "Tablespace name"


-RGPYHIWXLI8EFPIWTEGIREQIMRXLI((0

Include "Storage clause"


-RGPYHIWXLI7XSVEKIGPEYWIMRXLI((0

Include "Grants"
-RGPYHIWXLI+VERXWMRXLI((0

Body and Spec for Packages/Objects


-RGPYHIW((0JSVFSXLXLIFSH]ERHXLIWTIGMJMGEXMSR[LIRI\XVEGXMRKJVSQ
TEGOEKIWSVSFNIGXW8LITEGOEKIWTIGMJMGEXMSRHIGPEVIWTVSGIHYVIWJYRGXMSRW
GYVWSVWERHZEVMEFPIW8LITEGOEKIFSH]GSRXEMRWXLIMQTPIQIRXEXMSRSJXLI
TYFPMGTVSGIHYVIWERHJYRGXMSRWXSKIXLIV[MXLMRXIVREPERHTVMZEXITVSKVEQW
ERHZEVMEFPIW

Show Trigger Snapshot


8LI3VEGPI(EXE(MGXMSREV]WXSVIWXLI((0YWIHXSGVIEXIEXVMKKIVMRXLI
EPPCXVMKKIVWCZMI[EPSRK[MXLEPPXLISXLIVXVMKKIVTEVEQIXIVW2SVQEPP]750
2EZMKEXSVGSRWXVYGXW((0JVSQERSFNIGX
WTEVEQIXIVW,S[IZIV[LIRXLMW
TVIJIVIRGIMWWIPIGXIH7502EZMKEXSVI\XVEGXWXLI((0EWWXSVIHMRXLI
EPPCXVMKKIVWCZMI[
8LIEHZERXEKISJYWMRKXLMWSTXMSRMWXLEXER]YWIVGSQQIRXWWXSVIHMRXLI
((0EVIVIXEMRIH[LIRI\XVEGXMRK((0
-JXLMWSTXMSRMWRSXWIPIGXIH7502EZMKEXSV[MPPGSRWXVYGXXLI((0JVSQXLI
SFNIGX
WTEVEQIXIVWERHER]YWIVGSQQIRXW[MPPRSXFIVIXEMRIH

Extract DDL to the same Editor


;LIRWIPIGXIHEPP((0MWI\XVEGXIHXSXLIWEQIIHMXSVJSVXLIGYVVIRXWIWWMSR
8LMWMWEWTIV7502EZMKEXSV 
;LIRRSXWIPIGXIH((0MWI\XVEGXIHXSWITEVEXIIHMXSVW

Chapter 12

Customizing SQL Navigator

431

Extract DDL Table/View Specific preferences


Include "Constraints"
-RGPYHIWER]GSRWXVEMRXWJSVXLISFNIGXMRXLI((0

Disable "Constraints"
+IRIVEXI((0[MXLGSRWXVEMRXWMREHMWEFPIHWXEXI

Include "Triggers"
-RGPYHIWER]XVMKKIVWJSVXLISFNIGXMRXLI((0

Include "Indexes"
-RGPYHIWER]MRHI\IWJSVXLISFNIGXMRXLI((0

Include "Comments"
-RGPYHIWER]GSQQIRXWJSVXLISFNIGXMRXLI((0

Include "Primary Key" in Table Definition


-RGPYHIWXLI4VMQEV]/I]JSVXLIXEFPIMRXLI((0

Include "Synonyms"
-RGPYHIWER]7]RSR]QWJSVXLISFNIGXMRXLI((0

Exclude default values


)\GPYHIWEPPHIJEYPXZEPYIWJSVXLISFNIGXJVSQXLI((0

Extract DDL/Partitioning preferences


Include "Storage Clause" for Partitions
-RGPYHIWER]4EVXMXMSRWIXXMRKWJVSQXLI7XSVEKI'PEYWIJSVXLISFNIGXMRXLI
((0 

Include "storage Clause" for Index Partitions


-RGPYHIWER]-RHI\4EVXMXMSRWIXXMRKWJVSQXLI7XSVEKI'PEYWIJSVXLISFNIGXMR
XLI((0

432

SQL Navigator Users Guide

Include "Tablespace name" for Partitions


-RGPYHIWXLI8EFPIWTEGIREQIWER]4EVXMXMSRJSVXLISFNIGXMRXLI((0

Exclude Partition List for Local Index


)\GPYHIW0SGEP-RHI\4EVXMXMSRWJSVXLISFNIGXMRXLI((08LMWSTXMSRMW
MKRSVIHMJ-RGPYHIWXSVEKI'PEYWIJSV-RHI\4EVXMXMSRW EFSZI MWWIPIGXIH

Include "Tablespace Name" for Index Partitions


-RGPYHIWXLI8EFPIWTEGIREQIWMRER]-RHI\IH4EVXMXMSRJSVXLISFNIGXMRXLI
((0

Workspace preferences
Auto Hide Window
,MHIXLI;SVOWTEGIEYXSQEXMGEPP] 

Workspace: Auto Add Items to Workspace preferences


On Connect
3RGIEGSRRIGXMSRLEWFIIRQEHIWYGGIWWJYPP]EHHXLIGSRRIGXMSRXSXLI
[SVOWTEGI

On Create/Open object
3RGIERSFNIGXLEWFIIRGVIEXIHSVSTIRIHMXMWEHHIHXSXLI[SVOWTEGI
;MRHS[

On Create/Open file
3RGIEJMPILEWFIIRGVIEXIHSVSTIRIHMXMWEHHIHXSXLI;SVOWTEGI[MRHS[

On Browse/Edit Data
-JXLIYWIVFVS[WIWHEXEMREXEFPIXLIRXLIXEFPIMWEHHIHXSXLI;SVOWTEGI
;MRHS[

On Describe object
-JXLIYWIVGLSSWIWXSHIWGVMFIERSFNIGXXLIRMXMWEHHIHXSXLI[SVOWTEGI
EYXSQEXMGEPP]

Chapter 12

Customizing SQL Navigator

433

On Execute object
-JXLIYWIVI\IGYXIWETVSGIHYVISVJYRGXMSRXLIRMXMWEHHIHEHHIHXSXLI
[SVOWTEGIEYXSQEXMGEPP]

Code Editor preferences


'SHI)HMXSVTVIJIVIRGIWEVIKVSYTIHEWJSPPS[W
750)HMXSV4VIJIVIRGIW
7XSVIH4VSKVEQ)HMXSV4VIJIVIRGIW
+IRIVEP'SHI)HMXSV4VIJIVIRGIW

SQL Editor Preferences


Confirm DB updates in Grid
;LIRXLIYWIVGLERKIWEZEPYIMRXLI6IWYPXWKVMHERHXLIRWIPIGXWERSXLIVVS[
SVGSPYQR7502EZMKEXSVHMWTPE]WEHMEPSKEWOMRKJSVGSRJMVQEXMSRSJXLI
TVIZMSYWYTHEXI

Previous SQL Limit


'SRXVSPWXLIRYQFIVSJ750WXEXIQIRXWHMWTPE]IHMRXLI7507XEXIQIRX6IGEPP
HMEPSKMRXLI750)HMXSV

Spool Output
;LIRWIPIGXIHVIXYVRIHVIWYPXWEVIWIRXXSXLIWTSSPTERISJXLI750)HMXSVSR
UYIV]I\IGYXMSR

Default Rows Displayed


7TIGMJMIWLS[QER]VS[WSJVIXYVRIHVIWYPXWEVIWIRXXSXLIWTSSPTERISJXLI
750)HMXSVSRUYIV]I\IGYXMSR

Fetch All
3R
3RUYIV]I\IGYXMSRVIXVMIZIEPPVIWYPXWERHHMWTPE]MR[MRHS[
3JJ
3RUYIV]I\IGYXMSRVIXVMIZIXLIRYQFIVSJVIWYPXVS[WWTIGMJMIHMR
XLI(IJEYPX6S[W(MWTPE]IHWIXXMRK EFSZI 

434

SQL Navigator Users Guide

Split Window to Display Results


3R
5YIV]VIWYPXWEVIHMWTPE]IHMREWITEVEXIVIWM^EFPITERIFIPS[XLI
750IHMXMRKEVIE8LIUYIV]ERHXLIVIWYPXWGERFIZMI[IHEXXLIWEQIXMQI
3JJ
5YIV]VIWYPXWEVIHMWTPE]IHSRXEFFIHTEKIWMRXLIWEQITERIEWXLI
750IHMXMRKEVIE8LIUYIV]ERHXLIVIWYPXWGERRSXFIZMI[IHEXXLIWEQIXMQI
FYXXLMWEVVERKIQIRXJVIIWYTQSVIWGVIIREVIESYXWMHIXLIIHMXMRK[MRHS[

Show SQL for Quick Browse/Edit Data


Multiple Result Sets
;LIRI\IGYXMRKQYPXMTPI7)0)'8WXEXIQIRXWSTIRWQYPXMTPIVIWYPXWKVMHWMR
XEFFIHTEKIW'PIEVXLMWSTXMSRXSHMWEFPIVIWYPXWKVMHWERHSYXTYXEPPUYIV]
VIWYPXWXSXLIWTSSPTERISJXLI750)HMXSV 8LI7TSSP3YXTYXSTXMSR
HIWGVMFIHEFSZIQYWXFIWIPIGXIHXSZMI[UYIV]VIWYPXW 

Default Directory
8LIHIJEYPXHMVIGXSV]XLEX750)HMXSVTSMRXWXSJSVXLI3TIRERH7EZIHMEPSKW

Allow session switching


;LIRWIPIGXIHEPPS[W]SYXSW[MXGLWIWWMSRWJSVERSTIRIHMXSV8LMWQIERW
]SYGERIEWMP]VYRXLIWEQI750WXEXIQIRX W EKEMRWXQYPXMTPIHEXEFEWIW-J
XLMWSTXMSRMWRSXWIPIGXIH]SY[MPPRIIHXSSTIRQYPXMTPIIHMXMRK[MRHS[WXS
EGGSQTPMWLXLMWXEWO

Stored Program Editor Preferences


Open Package Body with Spec
%YXSQEXMGEPP]STIRWXLI4EGOEKIWTIGMJMGEXMSRERH4EGOEKIFSH]EXXLIWEQI
XMQI

Automatic Full Parse


1ER]JIEXYVIWSJXLI7502EZMKEXSV7XSVIH4VSKVEQ)HMXSVMRGPYHMRKXLI
'SHI)\TPSVIV[MRHS[GSHIGSQTPIXMSRXSSPXMTHMWTPE]SJTVSKVEQ
EVKYQIRXWFVEGOIXQEXGLMRKKYXXIVFPSGOQEVOIVWERHSXLIVWVIP]SR
EYXSQEXMGTEVWMRKSJXLI40750GSHIERHMRXIVREPP]KIRIVEXMRKEW]QFSP
XEFPI8LMWTEVWMRK EPWSVIJIVVIHXSEWW]RGLVSRM^EXMSRSJEHZERGIHIHMXMRK
JIEXYVIW SGGYVW[LIRXLIIHMXSVJMVWXPSEHWXLISFNIGXWERHMXEPWSSGGYVWMR

Chapter 12

Customizing SQL Navigator

435

XLIFEGOKVSYRHMRSVHIVXSQEMRXEMRXLIW]QFSPXEFPIEWXLIYWIVIHMXWXLI
GSHI
8LITVIJIVIRGIWYRHIV%YXSQEXMG*YPP4EVWIGSRXVSP[LIXLIVEYXSQEXMGJYPP
TEVWMRKSGGYVWERHLS[SJXIRXLI]EPWSGSRXVSPXLIWEQITEVEQIXIVWJSV
MRGVIQIRXEPMRGVIQIRXEPVITEVWI MIHIPE]FIJSVIVITEVWMRKGYVVIRXPMRI SVE
JYPPVITEVWISGGYVW 7II:MI[4VIJIVIRGIW'SHI)HMXSVW7XSVIH4VSKVEQ)HMXSV 
4IVMSHMGVITEVWMRKXLIGSHIJSVPEVKITEGOEKIWXLMWGERLEZIERSXMGIEFPI
MQTEGX[LMPIIHMXMRK*SVTIVJSVQERGIVIEWSRW]SYQE]TVIJIVXSHMWEFPI
EYXSQEXMGFEGOKVSYRHTEVWMRK

Automatic Full Parse Delay (msec)


(IPE]FIJSVIJYPPVITEVWI

Incremental Parse
%YXSQEXMGEPP]VITEVWIGYVVIRXPMRISRP]

Incremental Parse Delay (msec)


(IPE]FIJSVIVITEVWMRKGYVVIRXPMRI

General Code Editor Preferences


8LI+IRIVEPTVIJIVIRGIWETTP]XSEPPGSHIIHMXSVW

Find Text at Cursor


%YXSQEXMGEPP]TPEGIXLI[SVHEXXLIGYVVIRXGYVWSVTSWMXMSRMRXSXLI*MRHFS\

Font
8LIJSRXYWIHMRXLI'SHI)HMXSV[MRHS[

Code Convention lowercase


4EWXISFNIGXWMRPS[IVGEWIMRXSXLIIHMXSV%PWSEJJIGXWGSPYQRREQIWMRXLI
HVSTHS[RPMWXEWTEVXSJGSHIGSQTPIXMSRMRER]SJXLIXI\XIHMXSVWEWYTTIV
SVPS[IVGEWI[LIR]SYX]TIMREXEFPIREQI[MXLXLIkkSTIVEXSV
8LITVIJIVIRGI[EWTVIZMSYWP]ORS[REW(VEKERH(VST3FNIGXWXS
0S[IVGEWI

436

SQL Navigator Users Guide

Auto Indent
4SWMXMSRXLIGYVWSVYRHIVXLIJMVWXRSRFPEROGLEVEGXIVSJXLITVIGIHMRK
RSRFPEROPMRI[LIRYWIVTVIWWIW)RXIV

Indent Size
-RHIRX7M^IYWIH[LIR-RHIRXMRKWIPIGXIHXI\XYWMRK'860-

Use TAB Characters


-JWIPIGXIHMRWIVXXEFGLEVEGXIVW-JRSXWIPIGXIHMRWIVXWTEGIGLEVEGXIVW-J
7QEVX8EFMWIREFPIHXLMWSTXMSRMWSJJ

Use TAB Characters Tab Size


8LILSVM^SRXEP[MHXLSJXLI8EFWTEGIMRRYQFIVSJGLEVEGXIVW

Smart Tab
8EFXSXLIJMVWXGLEVEGXIVMRXLITVIGIHMRKPMRI-J9WI8EF'LEVEGXIVMW
IREFPIHXLMWSTXMSRMWSJJ

Smart Fill
&IKMRWIZIV]EYXSMRHIRXIHPMRI[MXLXLIQMRMQYQRYQFIVSJGLEVEGXIVW
TSWWMFPIYWMRKXEFWERHWTEGIWEWRIGIWWEV]

Keywords to Uppercase
'SRZIVXEPPXLI/I][SVHWXSYTTIVGEWIEWXLI]EVIX]TIHMRXSXLIIHMXSV

Syntax Highlighting
)REFPIXLILMKLPMKLXMRKSJW]RXE\[MXLMRXLIIHMXSV

Syntax Highlighting Highlighting Style


(IJEYPX7X]PIW[MXLGSPSVWGLIQIWJSVW]RXE\LMKLPMKLXMRK

Syntax Highlighting Colors


7IXEGYWXSQWX]PIJSVW]RXE\LMKLPMKLXMRK%PWSWIXXLILMKLPMKLXMRKWX]PIXS
GYWXSQ

Column Track
7IXXLIGYVWSVXSQSZIWXVEMKLXYTSVHS[RSVXSJSPPS[XLI)30SJIEGLVS[

Chapter 12

Customizing SQL Navigator

437

Allow Cursor after EOL


)MXLIV
%PPS[XLIYWIVXSQSZIXLIGYVWSVFI]SRHXLIIRHSJXLIGYVVIRXPMRIF]
EYXSQEXMGEPP][VETTMRKXSERI[PMRI
SV
7XSTXLIGYVWSVEXXLIIRHSJEPMRIERHFIIT

Show Gutter
;LIR]SYTPEGIXLIGYVWSVMRWMHIE&)+-2)2(-*)2(-*SV
0334)2(0334FPSGOXLI7502EZMKEXSVGSHIIHMXSVWWLS[]SYXLIFIKMR
ERHIRHTSMRXWF]QIERWSJDKP]TLW
 QEVOIVW MRXLIDKYXXIV
 PIJXQEVKMR 

Show Right Margin


Code Completion
7QEVXGSHIGSQTPIXMSREYXSQEXMGEPP]HMWTPE]WEDTMGO
PMWXSJQEXGLMRKW]QFSPW
ZEVMEFPIWTEVEQIXIVWTVSGIHYVIWX]TIW MRXLIGYVVIRXWGSTI[LIR]SYWXEVX
X]TMRKMRERMHIRXMJMIV

Templates

LOB Viewer preferences


=SYGERWTIGMJ]LS[7502EZMKEXSVHMWTPE]W03&W PEVKISFNIGXHEXEX]TIW 

Hex Dump Mask


-RHMGEXIW[LIXLIVXSWLS[ MJRSXWIPIGXIH SVLMHI MJWIPIGXIH LMKL%7'--
GLEVEGXIVWXLSWIGLEVEGXIVWFIX[IIRERH

LOB Save Path


8LIHIJEYPXHMVIGXSV]JSVXLI*MPI7EZIHMEPSKYWIH[LIR]SYGPMGOIMXLIVXLI
7EZISV7EZIERH:MI[MGSRWSRXLIXSSPFEV

Text Font
8LIJSRXYWIHMRXLI03&:MI[IV[LIRHMWTPE]MRKXLI03&EWXI\X

438

SQL Navigator Users Guide

Fixed Font
8LIJSRXXSYWIMRXLIZMI[IV[LIRHMWTPE]MRKXLI03&EWELI\HYQT 3RP]
JM\IH[MHXLJSRXWEVIEZEMPEFPIMRXLIJSRXWIPIGXMSRHMEPSK 

Difference viewer preferences


8LI(MJJIVIRGI:MI[IVPIXW]SYGSQTEVIHEXEFEWISFNIGXWMREWTPMX[MRHS[
(MJJIVIRGIWFIX[IIRXLISFNIGXWEVILMKLPMKLXIHERHXLIXSSPFEVWERHQIRYW
KMZI]SYEGGIWWXSGSRXVSPWJSVGYWXSQM^MRKXLIZMI[ERHGVIEXMRKVITSVXW*SV
QSVIMRJSVQEXMSRWII:MI[MRKHMJJIVIRGIW
8LI(MJJIVIRGI:MI[IVTVIJIVIRGIWPIX]SYWTIGMJ]XLI[E]7502EZMKEXSV
HMWTPE]WXLIWMQMPEVMXMIWERHHMJJIVIRGIWFIX[IIRX[SJMPIWSVX[SZIVWMSRWSJE
JMPI
8SVIXYVRXSXLIHIJEYPXWIXXMRKWGPMGO6IWXSVI(IJEYPXW

Rules
Synchronization Settings
8LI7]RGLVSRM^EXMSR7IXXMRKWGSRXVSPXLI[SVOMRKWSJXLIGSQTEVMWSRIRKMRI
XLEXVITSVXWHMJJIVIRGIWERHWMQMPEVMXMIWFIX[IIRXLIX[SJMPIW=SYGERWIXXLI
W]RGLVSRM^EXMSRTEVEQIXIVWPS[XSEPPS[QSVIIJJMGMIRXWIEVGLIWJSVWQEPP
HMJJIVIRGIWSVLMKLIVJSVLERHPMRKPEVKIVJMPIWSVJMPIW[MXLPEVKIHMJJIVIRGIW
9RPIWW]SYEVII\TIVMIRGIHMRQERMTYPEXMRKGSQTEVMWSRW]RGLVSRM^EXMSR
EPKSVMXLQW]SY[MPPTVSFEFP]JMRHXLEXXLIHIJEYPXWIXXMRKW[SVO[IPPIRSYKL
JSVQSWXWMXYEXMSRW
-RMXMEP1EXGL6IUYMVIQIRXVITVIWIRXWXLIQMRMQYQRYQFIVSJPMRIWXLEXRIIH
XSQEXGLMRSVHIVJSVXI\XW]RGLVSRM^EXMSRXSSGGYV
7OI[8SPIVERGIMWXLIRYQFIVSJPMRIWXLI(MJJIVIRGI:MI[IV[MPPWIEVGL
JSV[EVHSVFEGO[EVH[LIRWIEVGLMRKJSVQEXGLIW7QEPPIVRYQFIVWMQTVSZI
TIVJSVQERGI
7YTTVIWW6IGYVWMSRVIJIVWXSXLIQIXLSHYWIHXSWGERJSVQEXGLIW6IGYVWMSR
MQTVSZIWXLIEFMPMX]XSQEXGLYTPEVKIVEW[IPPEWWQEPPIVWIGXMSRWSJXI\XFYX
MXGERXEOIPSRKIV

Define Minor Differences


=SYGERLEZIXLIGSQTEVMWSRIRKMRIIMXLIVLMKLPMKLXSVMKRSVIQMRSV
HMJJIVIRGIWWYGLEWGSQQIRXWSVWTEGMRKGLEVEGXIVWERHXEFW8LMWKMZIW]SY
LEZIXLISTXMSRSJJSGYWMRKSRP]SRWMKRMJMGERXHMJJIVIRGIWSVEPXIVREXMZIP]
VIZMI[MRKIZIRQMRSVHMJJIVIRGIWFIX[IIRZIVWMSRW4PEGIEGLIGOQEVORI\XXS

Chapter 12

Customizing SQL Navigator

439

XLIMXIQWXLEX]SY[ERXXSGPEWWMJ]EWQMRSVHMJJIVIRGIW8LIRYRHIVXLI
+IRIVEPGEXIKSV]]SYGERWIPIGXSVGPIEVXLI-KRSVI1MRSV(MJJIVIRGIW
GLIGOFS\

General
9WIXLI-KRSVI1MRSV(MJJIVIRGIWGLIGOFS\XSEGXMZEXISVHIEGXMZEXIXLI
LMKLPMKLXMRKSJQMRSVHMJJIVIRGIWMRXLI(MJJIVIRGI:MI[IV[MRHS[ %W
I\TPEMRIHEFSZI]SYWTIGMJ][LEXGSRWXMXYXIWQMRSVHMJJIVIRGIWMRXLI6YPIW
STXMSRWYRHIV(IJMRI1MRSV(MJJIVIRGIW 
=SYGEREPWSWIXXLI[MHXLSJ8EF7XSTWHMWTPE]IHMRXLI(MJJIVIRGI:MI[IV

Options
=SYGERWIXXLIGSPSVWERHSXLIVZMWYEPGLEVEGXIVMWXMGWYWIHXSXLIJSPPS[MRK
IPIQIRXWMRXLI(MJJIVIRGI:MI[IV
 1EXGLMRKXI\X
 7MQMPEVXI\X
 (MJJIVIRXXI\X
 ,SVM^SRXEPPMRIWFIX[IIRQMWQEXGLIW
 *MRHXI\X
 1MWWMRKXI\X
8LI7LS[;LMXIWTEGIWSTXMSRHMWTPE]WXMPHIGLEVEGXIVW b MRTPEGISJFPEROWXS
WLS[XLITVIWIRGISJWTEGIGLEVEGXIVW
8LI7LS[0MRI2YQFIVWSTXMSRHMWTPE]WPMRIRYQFIVWJSVXLIGSQTEVIH
SFNIGXW
8LI7LS[8LYQFREMPSTXMSRHMWTPE]WEXLYQFREMPZMI[SJXLIJMPIERHE
PSGEXSVPIXXMRK]SYUYMGOP]GLERKIPSGEXMSRW[MXLMRXLIZMI[MRK[MRHS[
8LI7LS[0MRI(IXEMPSTXMSRHMWTPE]WXLIIRXMVIPMRIGYVVIRXP]WIPIGXIHMRE
WTIGMEPEVIEFIPS[XLIGSQTEVMWSR[MRHS[VIQSZMRKXLIRIIHJSVWGVSPPMRKXS
VIEHXLIIRXMVIPMRI

Team Coding preferences


8LIVIEVIX[SKIRIVEPGEXIKSVMIWSJ8IEQ'SHMRKTVIJIVIRGIWXLSWIXLEXETTP]
XSXLIGYVVIRXYWIVSRP]ERHXLSWIXLEXETTP]XSEPPYWIVWSJXLIGYVVIRX
HEXEFEWIGSRRIGXMSR8LSWIXLEXETTP]XSEPPYWIVWEVIPEFIPPIH'SRRIGXMSR
7IXXMRKWMRXLI4VIJIVIRGIWHMEPSKERHSRP]XLI7502EZMKEXSV%(1-2VSPI
GERGLERKIXLIWI

440

SQL Navigator Users Guide

User settings
8LIJSPPS[MRKWIXXMRKWGERFIGLERKIHF]ER]YWIVERHETTP]XSXLIGYVVIRX
YWIVSRP]

Automatic Check In
Automatic Check Out
8LIWITVIJIVIRGIWGSRXVSP[LEXLETTIRW[LIR]SYSTIRERSFNIGXSVWGVMTX
XLEXMWYRHIV8IEQ'SHMRKGSRXVSP
-JXLI%YXSQEXMG'LIGO-RERH%YXSQEXMG'LIGO3YXJIEXYVIWEVIIREFPIH
XLIR]SYEVIEYXSQEXMGEPP]TVSQTXIHXSGLIGOSYXXLIMXIQ[LIR]SYSTIRMX
ERHXSGLIGOMXMR[LIR]SYGPSWIMX
-JXLI%YXSQEXMG'LIGO-RERH%YXSQEXMG'LIGO3YXJIEXYVIWEVIRSXIREFPIH
]SYGERQERYEPP]MRMXMEXIXLIGLIGOMRSVGLIGOSYXZMEGSQQERHWSRXLI
8IEQ'SHMRKQIRYSJXLIIHMXSV

Confirm Check-In
8LMWSTXMSRMWYWIJYPSRP]JSVYWIVWSJ6EXMSREP'PIEVGEWI;LIRERYRQSHMJMIH
JMPIMWGLIGOIHMR6EXMSREP'PIEVGEWIQE]JEMPXLIGLIGOMR[MXLSYXRSXMJ]MRK
7502EZMKEXSV8LI'SRJMVQ'LIGO-RSTXMSRJSVGIW7502EZMKEXSVXS
TIVJSVQERI\XVEWXITXSZIVMJ]XLEXIEGLGLIGOMRMWWYGGIWWJYP-JRSXMX
EYXSQEXMGEPP]TIVJSVQWER9RHSSJXLIGLIGOMRXSIRWYVIXLEX7502EZMKEXSV
ERH'PIEVGEWIVIQEMRMRW]RGLVSRM^EXMSR8LIVIQE]FIETIVJSVQERGIMWWYI
[LIRXLMWSTXMSRMWMRYWI
8LMWGSRJMVQEXMSRMWRSXRIGIWWEV][MXL:'7TVSZMHIVWSXLIVXLER6EXMSREP
'PIEVGEWI

Connection Settings
8LISTXMSRWWIXMRXLI'SRRIGXMSR7IXXMRKWHMEPSKETTP]XSEPPYWIVWSJXLI
GYVVIRXHEXEFEWIGSRRIGXMSR

Local Working Directory


7IXWXLI[SVOMRKHMVIGXSV]JSVXLIGYVVIRXYWIV

Prompt for Check-in All


4VSQTXW]SYXSGLIGOMREPPGLIGOIHSYXJMPIW[LIR]SYGPSWIEWIWWMSR

Show in DB Navigator
%HHW8IEQ'SHMRKJYRGXMSRWXSXLI(&2EZMKEXSVWLSVXGYX VMKLXGPMGO QIRY
1E]LEZIETIVJSVQERGIMQTEGX

13
Installing server-side objects

'IVXEMRJIEXYVIWSJ7502EZMKEXSVEVIEZEMPEFPISRP]MJXLIVIUYMVIHWIVZIVWMHI
SFNIGXWEVIMRWXEPPIH

In this chapter
Installing server-side objects

442

442

SQL Navigator Users Guide

Installing server-side objects


;LIRMRWXEPPMRK7502EZMKEXSV]SYLEZIXLISTXMSRXSMRWXEPPXLIWIVZIVWMHI
GSQTSRIRXW'IVXEMRSTXMSRWSJ7502EZMKEXSV REQIHFIPS[ EVIEZEMPEFPI
SRP]MJXLIVIUYMVIHWIVZIVWMHISFNIGXWEVIMRWXEPPIH
-J]SYTVIJIV]SYGERWOMTXLMWWXITSJXLITVSHYGXMRWXEPPEXMSRERHMRWXEPPXLI
WIVZIVWMHIGSQTSRIRXWPEXIV=SYGEREP[E]WEGGIWWXLI7IVZIV7MHI
-RWXEPPEXMSR;M^EVHJVSQXLI8SSPWQIRY[MXLMR7502EZMKEXSV
Users should close all sessions before running
the Server Side Installation wizard.

To install the server-side components


1

6YRXLI7502EZMKEXSV7IVZIV7MHI-RWXEPPEXMSR;M^EVHIMXLIVEWTEVXSJ
XLITVSHYGXMRWXEPPEXMSRVSYXMRISVEJXIV[EVHWJVSQXLI8SSPWQIRY8S
VYRXLIWXERHEPSRIWIVZIVWMHIMRXEPPEXMSR[M^EVHJMVWXGSRRIGXEWE(&%
YWIV
;LIRTVSQTXIHWIPIGXXLIMRWXEPPEXMSRWGVMTXW]SY[ERXXSVYR*SPPS[MRK
EVIFVMIJHIWGVMTXMSRWSJXLIMRWXEPPEXMSRWGVMTXSTXMSRW *SVQSVIHIXEMPIH
MRJSVQEXMSREFSYXXLIMRWXEPPEXMSRWGVMTXWWIIXLIWEQTPIWGVMTXWMRXLI
-RWXEPPWYFHMVIGXSV] 

Chapter 13

Installing server-side objects

443

Option

Description

&EWI7502%:
6ITSWMXSV]

8LMWWGVMTX[LMGLMWVIUYMVIHGVIEXIWEYWIVREQIH
7502%:[MXLXLIVSPI7502%:C%(1-2-XEPWS
GVIEXIWXLIWGLIQEERHSXLIVFEWMGWIVZIVWMHISFNIGXW
7502EZMKEXSVRIIHWXSVYR7IIWEQTPIWGVMTX
GVXYWIVWUP

)\TPEMR4PER7YTTSVX

8LMWWGVMTXTPEGIWER)\TPEMR4PERXEFPIMRXLI750
2EZMKEXSVWGLIQE8LI)\TPEMR4PERJYRGXMSR[SR
X
[SVO[MXLSYXMX7IIWEQTPIWGVMTXGVXWUPXFWUP

%VKYQIRXW:MI[

-RWXEPPXLMWWGVMTXSRP]MJ]SYEVIVYRRMRK3VEGPI
SVIEVPMIV8LMWWGVMTXEHHWWYTTSVXRIIHIHJSV750
2EZMKEXSVXSVIXVMIZIEVKYQIRXWJSV7XSVIH4VSKVEQW
-XMWIWWIRXMEPJSVXLIGSVVIGXSTIVEXMSRSJXLI
HIFYKKIV7IIWEQTPIWGVMTXGVXZMI[WUP
=SYQYWXFIGSRRIGXIHEW7=7XSVYRXLMWWGVMTX

8IEQ'SHMRK7YTTSVX

-J]SY[MPPFIYWMRK8IEQ'SHMRKSVZIVWMSRGSRXVSP
JIEXYVIWMRWXEPPXLI8IEQ'SHMRK7YTTSVXWGVMTXW
*SVQSVIMRJSVQEXMSRWIIl-RWXEPPMRK8IEQ'SHMRK
STXMSRWzTEKI


7IPIGXEHEXEFEWIERHPSKSR
*VSQXLIHVSTHS[RPMWXWIPIGXEXEFPIWTEGI[MXLIRSYKLJVIIWTEGIJSVXLI
7502EZMKEXSVJMPIW'SRXEGX]SYV(&%JSVLIPTMJ]SYEVIRSXWYVI[LMGL
XEFPIWTEGIXSYWI
%JXIVWYGGIWWJYPGSRRIGXMSRXSXLIHEXEFEWIIRXIVXLITEWW[SVHHIJMRIHJSV
XLI7502%:YWIVXLEX[MPPFIGVIEXIH
8SFIKMRXLIMRWXEPPEXMSRTVSGIWWGPMGO-RWXEPP

;LIRXLIMRWXEPPEXMSRMWGSQTPIXIGPMGO*MRMWLIH

4
5

14
The SQL Navigator add-on modules

8LMWGLETXIVHIWGVMFIWSTXMSREPQSHYPIWJSV7502EZMKEXSVXSMRGVIEWI]SYV
HIZIPSTQIRXTS[IVERHQYPXMTP]]SYVTVSHYGXMZMX]

In this chapter
PL/SQL Debugger
Formatter Plus
Knowledge Xpert for Active PL/SQL Development
Knowledge Xpert for Oracle Administration
Application Tuning and Expert Advice
DataFactory for application testing

446
446
446
447
447
447

446

SQL Navigator Users Guide

8LIJSPPS[MRKSTXMSREPQSHYPIWEVIEZEMPEFPIJSV7502EZMKEXSV9WIXLIWI
STXMSREPEHHSRQSHYPIWXSMRGVIEWI]SYVHIZIPSTQIRXTS[IVERHQYPXMTP]
]SYVTVSHYGXMZMX]

PL/SQL Debugger
8LI7502EZMKEXSV(IFYKKIVQSHYPIPIXW]SYGSHIERHHIFYKXLI[E]]SY
[SVOPMRIF]PMRIERHWXEXIQIRXF]WXEXIQIRX[MXLSYXLEZMRKXSGLERKI
RSVQEPETTPMGEXMSRI\IGYXMSREZSMHMRKVYHMQIRXEV]HIFYKKMRK[SVOEVSYRHW
;MXL7502EZMKEXSV]SYGERWXITXLVSYKLGSHISRIPMRIEXEXMQIEWMX
I\IGYXIWSRXLIWIVZIVWIXGSRHMXMSREPFVIEOTSMRXW[EXGLERHQSHMJ]
ZEVMEFPIWERHZMI[XLII\IGYXMSRWXEGO 

Formatter Plus
7502EZMKEXSVMRXIKVEXIW[MXL*SVQEXXIV4PYWEYRMUYIYXMPMX]JSV
VIJSVQEXXMRKI\MWXMRK40750750ERH750 4PYWWSYVGIGSHI*SVQEXXIV
4PYWL]TIVJEWXVIJSVQEXXMRKMRWXERXP]MQTVSZIWXLIQEMRXEMREFMPMX]SJGSHIF]
IPMQMREXMRKGSRJPMGXMRKGSHMRKWX]PIWERHI\TSWMRKXLIYRHIVP]MRKPSKMGEP
WXVYGXYVISJXLIGSHI*SVQEXXIV4PYWEPWSTVSJMPIW]SYVGSHIXSMHIRXMJ]ZIVWMSR
HITIRHIRGMIWHIKVIIWSJQSHYPEVM^EXMSRGSRJSVQERGI[MXLWXVYGXYVIH
TVSKVEQQMRKFIWXTVEGXMGIWTEXXIVRWSJ750YWEKIERHSXLIVWMKRMJMGERX
GLEVEGXIVMWXMGW

Knowledge Xpert for Active PL/SQL Development


7EZIXMQIIPMQMREXIKYIWW[SVOERHFYMPHI\GIPPIRGIMRXS]SYVTVSKVEQW[MXL
XLI%GXMZI40750ORS[PIHKIFEWI8LMWTVSHYGXGSZIVWXLIIRXMVIPMJIG]GPISJ
40750HIZIPSTQIRX[MXLGSHMRKMRWMKLXWFIWXTVEGXMGIWHMEKVEQWERH
VIYWEFPII\EQTPIW3ZIVXSTMGWEVIMRWXERXP]EGGIWWMFPIHIPMZIVMRKE
[IEPXLSJXMQIXIWXIHI\TIVMIRGIHMVIGXP]XS]SYVHIWOXST/RS[PIHKI<TIVX
JSV%GXMZI40750(IZIPSTQIRXEPWSMRGPYHIWEGSHIPMFVEV]XLEXTVSZMHIWSZIV
TVSHYGXMSRVIEH]40750JYRGXMSRWERHTVSGIHYVIWXLEXI\XIRHXLI
GETEFMPMXMIWSJXLI40750PERKYEKI9WIXLIGSHIPMFVEV]JSVWXVMRKTEVWMRK
I\GITXMSRLERHPMRKHEXIEVMXLQIXMGERHLYRHVIHWSJSXLIVTVSGIHYVIW7MRKPI
PMRITVSGIHYVIGEPPWVITPEGIXLSYWERHWSJPMRIWSJPS[PIZIPGYWXSQGSHMRK
(IZIPSTIVWLEZIJYPPEGGIWWXSWSYVGIGSHI

Chapter 14

The SQL Navigator add-on modules

447

Knowledge Xpert for Oracle Administration


-RWXERXP]EGGIWWERW[IVWXSTIVGIRXSJ]SYVHEMP]XIGLRMGEPUYIWXMSRW
JVSQHMVIGXP][MXLMR7502EZMKEXSV[MXLXLI3VEGPI%HQMRMWXVEXMSR
ORS[PIHKIFEWI8LMWORS[PIHKIFEWITVSZMHIWXLILS[XSXIGLRMUYIWERH
MRWMKLXWGSZIVMRKQSVIXLERXSTMGW*VSQFEGOYTERHVIGSZIV]MWWYIWXS
RIX[SVOGSRJMKYVEXMSRERHHEXEFEWIXYRMRK]SY[MPPJMRHXLITVIFYMPX
QIXLSHWERHWSPYXMSRW]SYRIIHXSKIXXLINSFHSRIUYMGOP]ERHEGGYVEXIP]

Application Tuning and Expert Advice


8LI<TIVX8YRMRKSTXMSRWYTTPIQIRXW3VEGPIXYRMRKWOMPPWJSVHIZIPSTIVW
XEOMRKXLIMVETTPMGEXMSRXYRMRKGETEFMPMXMIWXSXLIRI\XPIZIP8LI<TIVX8YRMRK
QEOIWSFWIVZEXMSRWEFSYXEWIPIGXIH750WXEXIQIRXERHXLIYRHIVP]MRK
HEXEFEWIIRZMVSRQIRXXLIRVIGSQQIRHWWIZIVEPSTXMSRWXSMQTVSZI
TIVJSVQERGI9WIVWGERXLIRZMI[XLIPSKMGFILMRHXLIEHZMGIMQTPIQIRXXLI
VIGSQQIRHEXMSRETTP]MXXSXLIHEXEFEWIERHWIIXLIVIWYPXW8LI<TIVX
8YRMRKQSHYPIEYXSQEXMGEPP]TVSHYGIWEPPRIGIWWEV]750XSIJJIGXXLI
GSVVIWTSRHMRKGLERKI

DataFactory for application testing


5YIWX7SJX[EVISJJIVW(EXE*EGXSV]ETS[IVJYPHEXEKIRIVEXSVXLEXEPPS[W
HIZIPSTIVWERH5%TIVWSRRIPXSIEWMP]TSTYPEXIXIWXHEXEFEWIW[MXLQMPPMSRWSJ
VS[WSJQIERMRKJYPW]RXEGXMGEPP]GSVVIGXXIWXHEXE[MXLNYWXEJI[GPMGOWSJXLI
QSYWI(EXE*EGXSV][MPPVIEHEHEXEFEWIWGLIQEERHHMWTPE]HEXEFEWISFNIGXW
WYGLEWXEFPIWERHGSPYQRWERHYWIVWGERXLIRTSMRXGPMGOERHWTIGMJMGEPP]
HIJMRILS[XSTSTYPEXIXLIXEFPI 

15
About Quest Software
Business Runs Better on Quest
5YIWX7SJX[EVIXLIPIEHIVMRETTPMGEXMSRQEREKIQIRXKMZIW]SYGSRJMHIRGIMR
]SYVETTPMGEXMSRMRJVEWXVYGXYVI8LMWGSRJMHIRGIMWHIPMZIVIHMRXLIJSVQSJ
VIPMEFPIWSJX[EVITVSHYGXWXLEXIRWYVI]SYKIXXLIQSWXJVSQ]SYVI\MWXMRK
ETTPMGEXMSRMRZIWXQIRXWrXLIFIWXTSWWMFPITIVJSVQERGIERHXLILMKLIWXPIZIPW
SJEZEMPEFMPMX]3YVYRH]MRKJSGYWSRXLIETTPMGEXMSREPWSHVMZIWHS[R]SYV
XSXEP-8STIVEXMRKGSWXW7MQTP]TYXSTXMQM^IHWSJX[EVIQIERWPIWWLEVH[EVI
MRGPYHMRKJI[IVYTKVEHIWERHHIPE]IHWXSVEKITYVGLEWIW
;IRSXSRP]LIPT]SYKIXQSVIJVSQ]SYVETTPMGEXMSRW[IEPWSLIPT]SYKIX
QSVISYXSJ]SYV-8WXEJJ;IIUYMT-8TVSJIWWMSREPW[MXLIEW]XSYWIXSSPW
IQFIHHIH[MXLXLIORS[PIHKISJSYV[SVPHVIRS[RIHI\TIVXWXLEXEYXSQEXI
HEMP]XEWOWERHWMQTPMJ]GSQTPI\SRIW%WEVIWYPX]SYV-8SVKERM^EXMSR[MPPFI
EFPIXSTVSEGXMZIP]TVIZIRXTIVJSVQERGITVSFPIQWERHHS[RXMQIEW[IPPEW
VIEGXUYMGOP]XSVIWSPZIXLIYRJSVIWIIR2SSXLIVWSJX[EVITVSZMHIVSJJIVWE
QSVIGSQTVILIRWMZIETTVSEGLXSETTPMGEXMSRQEREKIQIRX
8SHE]WSQISJXLIQSWXTVIWXMKMSYWSVKERM^EXMSRWXLVSYKLSYXXLI[SVPHLEZI
WIPIGXIH5YIWX7SJX[EVIEWXLIMVETTPMGEXMSRQEREKIQIRXWSPYXMSRTVSZMHIV
FIGEYWIFYWMRIWWVYRWFIXXIVSR5YIWX

450

SQL Navigator Users Guide

Contacts
Product information
Phone
(USA and Canada): (949) 754-8000
Fax
(USA and Canada): (949) 754-8999
E-mail
Sales & Marketing: info@quest.com
Web page:
www.quest.com
Mail:
8001 Irvine Center Drive, Irvine, CA 92618
International offices
UK:
+44 (1628) 601000
Germany:
+49 (211) 770967 0
Australia:
+61 (3) 9811-8000
Canada:
+01 (905) 804-9480
Technical support
Hours:
MondayFriday 5 A.M5 P.M. Pacific Standard Time
(GMT minus 8 hours)
Phone:
(949) 754-8000
Please be prepared to provide all pertinent information to support
operators so we may properly log your support request.
Fax:
(949) 754-8999
Please include all pertinent information regarding the problem you are
reporting.
E-mail:
support@quest.com
Online support: Visit www.quest.com to register for online support and to submit a
support request

Index

 750[MPHGEVHGLEVEGXIV  
63;8=4) 


W]QFSP  

$
$GSQQERHSJ750 4PYW 

%
%HHXS;SVOWTEGI  
%HH;EXGL 
%HH;EXGLHMEPSK  
%HZERGIHIHMXMRKJIEXYVIWJSVWXSVIHTVSKVEQW 
%00CZ  
%PPS['YVWSVEJXIV)30 
%PPS[WIWWMSRW[MXGLMRK 
EPXIVMRKHEXEFEWISFNIGXW  
%REP]^I  
STIRMRKX[SSVQSVI[MRHS[W 
%REP]^IXSSP 
EREP]^MRKHEXEFEWIWXVYGXYVIW  
ERSR]QSYWFPSGOW 
ERSR]QSYW40750FPSGOW  
ETTPMGEXMSRXIWXMRK  
%TTP]8IEQ'SHMRKXSEPP3FNIGXW  
EVKYQIRXW  
TEWXMRKSVHVEKKMRKJYRGXMSRWERHTVSGHYVIW
%VVERKI%PP  
%XXEGL)\XIVREP7IWWMSR 
%YXS'SQQMX  
%YXS-RHIRX 
%YXS6IGSQTMPI  
%YXS6IGSQTMPI(ITIRHERXW  
%YXS6IGSQTMPI-RZEPMH3RP] 
%YXSVYRWGVMTXEXPSKSR  

EYXSVYRWGVMTXSRGSRRIGXMRKXSHEXEFEWI
%YXS7XEVX[MXL)HMXSVWERH)\TPEMR4PER 
%YXS7XIT-RXIVZEP 
%YXS7XIT3ZIV
%YXS(IWGVMFI
%YXSQEXIHGSHMRKEWWMWXERGI 
%YXSQEXIHUYIV]FYMPHMRK
%YXSQEXMG'LIGO-R 
%YXSQEXMG'LIGO3YX 
%YXSQEXMG*YPP4EVWI 
EYXSQEXMGWEZISRI\MX
%YXSQEXMGEPP]GSQTMPIEPPHITIRHIRXSFNIGXW 
%ZEMPEFPI 

&
FEXGLWIPIGXMSRERHYTHEXI
&IKMR)RHQEVOIVWJSVPSSTWERHFPSGOW
&*-0)W
FMRHZEVMEFPIW 
&03&W
FPSGO 
FPSGOLMKLPMKLXMRK
&SH]ERH7TIGJSV4EGOEKIW3FNIGXW
&SPH*SPHIVWMR(&2EZMKEXSV8VII
FSSOQEVOW 
MR750GSHI
MRWXSVIHTVSKVEQW 
FVEGOIXW
TEMVIH
&VIEO'32(-8-32(MEPSK 
FVIEOSRI\GITXMSR 
&VIEO3R)\GITXMSR 
&VIEOTSMRX
FVIEOTSMRXW  
WIXXMRK
ZMI[MRK
&VS[WI(EXE
FVS[WMRKXEFPIHEXE 

452

SQL Navigator Users Guide

FYJJIVWM^IJSVHEXEFEWIVIEHW 

'
GEGLIGETEGMX] 
GEPPWXEGO 
GEPPMRKGSHIFPSGO
'ETXYVI;IF3YXTYX
GEXEPSKSFNIGXW
GEXEPSKW  
''+
'LEMRIH6S[W8EFPI 
'LEMRIH6S[W8EFPI3[RIV 
'LIGOIH3YX 
'LIGO-R  
'LIGO3YX  
'PIEV7TSSPSR6YR
'PIEVGEWI
'03&W 
'PSWI 
'PYWXIV)HMXSV
GPYWXIVW  
EPXIVMRK
GVIEXMRK 
IHMXMRK 
'SEPIWGI 
'SHI%WWMWXERX  
'SHIFPSGOLMKLPMKLXMRK 
GSHIFSSOQEVOW
WEZMRKMR;SVOWTEGI
'SHI'EXEPSK 
GSHIGEXEPSKW
GSHIGSQTPIXMSR 
'SHI'SRXVSP+VSYT 
'SHI'SRXVSP+VSYTW
IREFPMRK 
YWIWJSV
'SHI'SRXVSP+VSYTW
'SHI'SRZIRXMSRPS[IVGEWI 
GSHIIHMXSVW 
'SHI)\TPSVIV 
'SHI7IEVGL  
GSHIWRMTTIXW

GSHIXIQTPEXIW 
'SHI8IQTPEXIW
'SHIXIQTPEXIWERHWLSVXGYXW 
GSHIYRMX 
GSPPIGXMSRX]TIW 
GSPPIGXMSRWMRXEFPIGSPYQRW 
GSPSV
GSPSVLMKLPMKLXMRKSJOI][SVHW 
GSPYQRREQIW
MRWIVXMRKMRXSGSHI 
'SPYQR8VEGO 
GSQQERHW 
'SQQIRX 
GSQQIRXW 
MR((0JSVXVMKKIVW 
'SQQMX 
GSQTEVMRKJMPIW 
GSQTEVMRKZIVWMSRW
GSQTEXMFMPMX] 
GSQTMPEXMSR 
'SQTMPI
GSQTMPIERSFNIGX
'SQTMPI(ITIRHIRGMIW
GSQTMPIIVVSVW
'SQTMPI6IFYMPH
GSQTMPMRKHITIRHIRXSFNIGXW 
GSQTPI\TEVEQIXIVW
'SRHMXMSREPFVIEOTSMRX 
'SRJMVQ'LIGO-R
'SRJMVQ(&YTHEXIWMR+VMH
GSRRIGX
GSRRIGXWXVMRKW
GSRRIGXXMQI 
GSRRIGXMRKXSXLI3VEGPI(EXEFEWI
'SRRIGXMSR7IXXMRKWSTXMSRW 
GSRRIGXMSRWLSVXGYXW
GSRRIGXMSRW
'SRWXVEMRX)HMXSV
GSRWXVEMRXW
GVIEXMRK 
IHMXMRK 
IREFPMRKERHHMWEFPMRK 

Index

453

'SRXIRXW  


'SRXMRYI  
'SRZIVX/I][SVHWXS0S[IVGEWI  
'SRZIVX/I][SVHWXS9TTIVGEWI  
'SRZIVXMRKEWXSVIHTVSGIHYVIMRXS,810  
'ST]  
'ST]WIPIGXIHXI\XXSGPMTFSEVH  
'SVVIGXMRKW]RXE\IVVSVW 
'SVVIGXMRKX]TMRKIVVSVW  
GSZIVEKI 
'SZIVEKI4VSJMPMRKXSSP  
'VIEXI(&3FNIGX  
'6)%8)366)40%')  
'VIEXI7YTTSVX&YRHPI  
GVIEXMRKHEXEFEWISFNIGXW 
'VIEXMRKRI[SFNIGXW  
'69(QEXVM\ 
MRWIVXMRKMRGSHIEWGSQQIRX  
'69(1EXVM\  
GYVWSV 
'YWXSQM^EFPIW]RXE\LMKLPMKLXMRK 
GYWXSQM^EFPIW]RXE\LMKLPMKLXMRKJSV40750  
GYWXSQM^MRK 
'YX 

(
HEXE 
FVS[WMRK  
IHMXMRK 
IHMXMRKUYIV]VIWYPXW  
HEXEHMGXMSREV]ZMI[W  
(EXE*EGXSV]  
HEXE 
(EXEFEWI0MRO)HMXSV  
HEXEFEWIPMROW 
IHMXMRK 
HEXEFEWISFNIGXW  
GSQTMPMRK  
ZMWYEPIHMXSVWJSV  
(EXE*EGXSV]  
(EXEJMPIW 
HEXEWLIIX 

(EXI(MWTPE]IH*SVQEX
HEXIJSVQEX
(&2EZMKEXSV 
JMPXIVW 
UYMGOVIJIVIRGI  
XSSPFEV 
(&2EZMKEXSV[MRHS[ 
(IXEMPWTERIP
(&2EZMKEXSV 
(&%HMGXMSREV]ZMI[W
(&%6SPI 
(&%YWIV
(&%W
(&17 
(&17SYXTYXFYJJIV
GLERKMRKFYJJIVWM^I
(&17C.3&7 
(&17C398498498C0-2) 
(&17C398498498C0-2)WXEXIQIRXW 
((0 
I\XVEGXMRKJVSQSFNIGXW 
(IEPPSGEXI 
(IFYKMRJSVQEXMSR 
(IFYKQIRY 
(IFYKQSHI 
(IFYKWIWWMSR
(IFYK:EVMEFPI 
(IFYKKIV 

GSRXVSPPMRKI\IGYXMSRMR
MRMXMEXMRK
3VEGPIZIVWMSRVIUYMVIQIRXW 
TVIJIVIRGIW 
XVSYFPIWLSSXMRK 
HIFYKKMRK
I\XIVREPETTPMGEXMSR
JYRGXMSRW 
WIVZIVWMHIGSHI 
WXSVIHTVSKVEQW 
ZEVMEFPIWMR750)HMXSV 
HIFYKKMRKI\XIVREPETTPMGEXMSRW
(IFYKKMRK40750

454

HIFYKKMRK 
HIGPEVEXMSR 
HIGPEVEXMSRSJERMHIRXMJMIV 
(IJEYPX(EXI*SVQEX 
(IJEYPX(MVIGXSV] 
(IJMRI1MRSV(MJJIVIRGIW 
(IJMRI:EVMEFPIW
(IPIXMRKSFNIGXWJVSQXLI8IEQ'SHMRK:MI[IVPMWX 

HITIRHIRXSFNIGXW
(IWGVMFI  
STIRMRKX[SSVQSVI[MRHS[W 
(IWGVMFIGSQQERH 
(IWGVMFI3FNIGXEX'YVWSV 
HMGXMSREV]ZMI[W 
(MJJIVIRGI:MI[IV 
GSPSVW 
TVIJIVIRGIW 
HMJJIVIRGIWFIX[IIRZIVWMSRW
HMVIGXSV]
(MWEFPI  
(MWEFPIH 
(MWGSRRIGX  
(MWTPE]XMQIMR(%8)JMIPHW 
(MWTPE]MRKERSFNIGXWTPEGIMRXLIWGLIQE
(10WXEXIQIRX 
HSGOMRK[MRHS[W 
(SXPSSOYTJSVVIGSVHQIQFIVW 
(SXPSSOYT 
(VEKERH(VSTEVKYQIRXW[MXLTVSGIHYVI 
(VEKERH(VST3FNIGXWXS0S[IVGEWI
(VEKERHHVST40750IHMXMRK
HVEKKMRKSFNIGXREQIWMRXSGSHI
(VST 
HMWEFPMRK
(VST(&3FNIGX 
(VST 
HVSTTMRKHEXEFEWISFNIGXW 
HVSTTMRK.EZESFNIGXW 
H]REQMGLMKLPMKLXMRKSJQEXGLMRKTEMVWSJFVEGOIXW 


SQL Navigator Users Guide

H]REQMGLMKLPMKLXMRKSJXLIGPSWIWXIRGSQTEWWMRK
FPSGO 

)
)GLS750 
)HMX(EXEGSQQERH
)HMXQIRY
IHMXXLIVIWYPXWSJ750UYIVMIW 

)HMX8SSPFEV
IHMXMRK
GSRWXVEMRXW
HEXEFEWIPMROW 
MRHI\IW 
SFNIGXW 
WIUYIRGIW 
750GSHI
WXSVIHTVSKVEQW
W]RSR]QW 
XEFPIW
XI\X 5YMGO6IJIVIRGI  
YWIVW 
ZMI[W 
)HMXMRK'PYWXIVW 
)HMXMRKGSHIMRWXSVIHTVSKVEQW 
IHMXMRKHEXE
MR6IWYPXWKVMH
IHMXMRKHEXEVIXYVRIHJVSQEUYIV] 
IHMXMRKHEXEFEWISFNIGXW 
)HMXMRKRIWXIHXEFPIW 
)HMXMRK6SPIW 
IHMXMRKXEFPIHEXE 
IHMXMRKXEFPIW 
)HMXMRKZEVVE]W 
IHMXMRK  

IHMXSVW 
JSVHEXEFEWISFNIGXW 
)HMXSVW
)REFPI 
)REFPIYWMRK(&%HMGXMSREV]ZMI[W 
)RXIVMRKQYPXMTPI750WXEXIQIRXW
)RXIVMRK40750FPSGOW

Index

455

IVVSVQIWWEKI  


)VVSV7SPYXMSRHMEPSK 
IVVSVW  
)ZEPYEXI1SHMJ]HMEPSK  
IZEPYEXMRKERHQSHMJ]MRKZEVMEFPIW  
)\GIP  
I\TSVXMRKUYIV]VIWYPXWXS 
)\GITXMSR8EFPI  
)\GITXMSR8EFPI3[RIV  
)\GPYHIHIJEYPXZEPYIW 
I\IGYXEFPIPMRI 
)\IGYXI  
)\IGYXMRKE750WGVMTX 
I\IGYXMRKWXSVIHTVSKVEQW  
I\IGYXMSR  
)\IGYXMSR'SHI[M^EVH  
I\IGYXMSRWXEVXTSMRX  
I\IGYXMSRWXEXYW 
)\IGYXMSR7XEXYW[MRHS[  
I\IGYXMSRXMQI 
)\TPEMR4PER 
HIJEYPXTPERXEFPI  
JSVXEFPIW 
STIRMRKX[SSVQSVI[MRHS[W 
TVIJIVIRGIW  
WEZMRK750MR 
)\TPEMR4PER8SSP  
)\TPEMR4PER 
)\TSVX(EXE7LIIX  
I\TSVXMRK  
HEXE 
UYIV]VIWYPXW 
)\XVEGX750  
I\XVEGXMRK((0
JVSQ.EZE  
TEVXMXMSRMRKTVIJIVIRGIW 
TVIJIVIRGIW  
XSXLIWEQIIHMXSV 

*
*IXGL%PP  
JMPII\XIRWMSRW 

JMPIW 
STIRMRKMR750)HMXSV
JMPXIVWMR407504VSJMPIV 
*MRH3FNIGXW 
*MRH3FNIGXWHMEPSK 
*MRH4VIZMSYW
*MRH750
*MRH8I\XEX'YVWSV
*MRH6ITPEGI
JMRHMRKSFNIGXWF]WIEVGLEVKYQIRX
JMRHMRKWSYVGIGSHI
JSPHIVW 
HMWTPE]MRKMRFSPH 
JSRX 
7502EZMKEXSVMRXIVJEGI
*SRX 
*SSXIV 
*SVGI6IZMWMSRJSVGSQQIRXW
*SVGI6IZMWMSRSTXMSR
*SVQEXXIV4PYW
*SVQEXXIV8SSPW 
*SVQEXXMRK3TXMSRW
JSVQEXXMRKWSYVGIGSHI 
*VII^MRKERHYRJVII^MRKSFNIGXW 
*VS^IR 
JYPPQERYEPTEVWI
JYRGXMSROI]W 
JYRGXMSRW 

+
+IRIVEP
+IRIVEXI'SQQIRXW 
+IX0EXIWX6IZMWMSR 
+SXSEWTIGMJMIHPMRIMRXLIXI\X 
+SXS0MRI 
+SXS&SSOQEVOW 
+VERX 
+VERX3FNIGX4VMZMPIKIW
+VERXW 
KVMHW 
KVSYTW 
407504VSJMPIV 

456

SQL Navigator Users Guide

KYXXIVQEVOIVWMRGSHIIHMXSVW 

,
,IEHIV 
,IEHIVERH*SSXIV 
LIPT 
,I\(YQT 
LMRXW 
,810 
I\TSVXMRKUYIV]VIWYPXWXS
,810TEKIW
TVMRXMRK 
,810  

-
MHPIXMQI 
-KRSVI1MRSV(MJJIVIRGIW 
-QQIHMEXIPSEHMR3TIR3FNIGXHMEPSK 
-QQIHMEXIP]'SQQMX)ZIV](107XEXIQIRX 
MQTEGXEREP]WMW
MQTPIQIRXEXMSRERHWTIGMJMGEXMSRSJETEGOEKIH
TVSGIHYVI 
-QTSVX,810EW40750 
-RGPYHI(634
-RGVIEWISVHIGVIEWIXLIMRHIRXSJWIPIGXIHXI\X 
-RGVIQIRXEP4EVWI 
-RHIRX7M^I
MRHIRXEXMSR
-RHI\%REP]WMW
-RHI\)HMXSV 
MRHI\IW  
IHMXMRK 
-RJSVQEXMSR[MRHS[ 
-RWIVXE'69( 'VIEXI9THEXI(IPIXI QEXVM\EW
GSQQIRXXI\X 
-RWIVXGSHIWXSVIHGSHIWRMTTIXW 
-RWIVXMRKEXI\XJMPI
-RWIVXMRKVIEH]QEHIGSHIWIKQIRXWZMEWLSVXGYX
OI]W
-RWXEPPMRK1IVERX4:'7
-RWXEPPMRK1MGVSWSJX:MWYEP7SYVGI7EJI
-RWXEPPMRKXLMVHTEVX]ZIVWMSRGSRXVSPTVSHYGXW

MRXIKVMX]SJXEFPIW
MRHI\IWSVGPYWXIVW 
MRZEPMHSFNIGXW

.
.EZE
HVSTTMRK
PSEHMRK 
.EZEGPEWWIW 
.EZE)HMXSV 
.EZE1EREKIV 
.EZEWSYVGI 
.EZE 
.SF1EREKIV
NSFTVSTIVXMIW 
NSFW 
FVSOIR
HMWEFPMRK
.SFW 
GVIEXMRK 
IHMXMRK 
.YQTXS1EXGLMRK&VEGOIX
.YWX-R8MQI(IFYKKMRK

/
OI]FSEVHWLSVXGYXW 
/I][SVHW 
/I][SVHWGEWI 
/I][SVHWXS9TTIVGEWI 
/RS[PIHKI<TIVX
/RS[PIHKI<TIVXJSV%GXMZI40750(IZIPSTQIRX

/RS[PIHKI<TIVXJSV3VEGPI%HQMRMWXVEXMSR 

0
PEVKISFNIGXW
PE]SYXW
PMROW 
IHMXMRK 
0MWX%PP;EXGLIW 
0MWX&SSOQEVOW 
PSEHMRK.EZESFNIGXW

Index

457

0SEH.EZE 
03&ZMI[IV  
03&W 
0SGEP;SVOMRK(MVIGXSV]  
0SGEXIMR7GLIQE  
0SGOIH  
PSKKMRKHEXEFEWIXVERWEGXMSRW 
0SKSR  
PSKSRWGVMTX  
0SSTFEGO750 2IX  
0S[IV'EWI  

1
1EREKMRK
NSFW  
1EREKMRKWXSVIHTVSKVEQWEWHEXEFEWISFNIGXW
1EREKMRK]SYVIHMXMRKWIWWMSR  
QERYEPTEVWI 
QEVKMR  
1EVKMRW  
1(-[MRHS[  
1IEWYVIQIRXYRMXW 
QIQSJMIPHW 
QIRYWERHXSSPFEVW  
1IVERX4:'7 
QIWWEKIW  
1MGVSWSJX:MWYEP7SYVGI7EJI 
QMKVEXMSR
ZIVWMSRGSRXVSP  
QYPXMTPIUYIVMIW 
1YPXMTPI6IWYPX7IXW  

2
2EQIW 
RIWXIH750WGVMTXW 
RIWXIHXEFPIW 
GVIEXMRK  
IHMMRK  
2IX 
2I[  
2I[7IWWMSR  
RYQIVMGERHGLEVEGXIVZEVMEFPIW  

3
3FNIGX)HMXSVW 
STIRMRKX[SSVQSVI[MRHS[W 
3FNIGXQIRY
3FNIGX8]TIW 
SFNIGXW  
EPXIVMRK
EREP]^MRK 
GPSRMRK 
GST]MRK
GST]MRKJVSQSRIWGLIQEXSERSXLIV 
GVIEXMRK 
GVIEXMRKJVSQ(&2EZMKEXSV 
()7'6-&)GSQQERH
HVEKERHHVST 
HVSTTMRK
HVSTTMRK HIPIXMRK  
IHMXMRK 
IHMXMRKQYPXMTPI 
I\XVEGXMRK((0ERH750JVSQ 
JMRHMRK
MRXEFPIW
PSGEXMRKMRWGLIQE 
QSHMJ]MRK 
STIRMRK 
STIRMRKJVSQXLI(&2EZMKEXSV 
TIVJSVQMRKEGXMSRWSRMR(&2EZMKEXSV
VIREQMRK 
VIZIVWIIRKMRIIVMRK 
WIPIGXMRKQYPXMTPI
ZMI[MRKTVSTIVXMIW 
SFNIGXWMRXEFPIGSPYQRW
ZMI[MRK
SFNIGXW  
3R'SRRIGX
SRPMRILIPT
3TIR 
3TIR(&3FNIGX
PSEHMRKXLIPMWXSJSFNIGXW 
3TIR*MPI
3TIR3FNIGXEX'YVWSV 

458

SQL Navigator Users Guide

STIRMRKX[SSVQSVIIHMXSV[MRHS[W 
3TIRMRKX[SSVQSVIMRWXERGIWSJXLIWEQIIHMXMRK
[MRHS[ 
STXMQM^MRK
WXSVIHTVSKVEQW 
STXMQM^MRKXEFPIW 
3VEGPI0SKSR 
3VEGPIZIVWMSRVIUYMVIQIRXW 
3VMIRXEXMSR 
398TEVEQIXIVW 
SYXSJWGSTIZEVMEFPIW
3YXTYX[MRHS[

4
4EGOEKI  
TEGOEKIFSH] 
TEGOEKIWTIGMJMGEXMSR
TEGOEKIW 
HIFYKKMRK 
TEVEQIXIV
XSSPXMT 
TEVWI 
TEVWIV 
TEVWMRK 
TEVXMXMSRW
TVIJIVIRGIWJSVI\XVEGXMRK((0 
TEWW[SVHW 
I\TMVMRK
4EWXI
4EYWI%YXS7XITTMRK
TIVJSVQERGI 
TIVQMWWMSRW 
4IVWSREP3VEGPI 
4MR
4MREX7XEVX 
4MRRIHEXWXEVX 
40:MWMSR0MXI 
40:MWMSR4VSJIWWMSREP
40750FPSGOW 
40750(IFYKKIV 
40750)HMXSV 


40750TEGOEKIJVSQE.EZEGPEWW 
407504VSJMPIV
FEWMGGSRGITXW
GLEVXSTXMSRW 
JMPXIVW 
KVSYT
KVSYTTVSTIVXMIW 
KVSYTW 
MRWXEPPMRK
5YMGO6IJIVIRGI 
VIWYPXWIXW
VYR 
VYRWZMI[
WSVXSTXMSRW 
XVIIZMI[W 
[MRHS[ 
407504VSJMPIVUYMGOVIJIVIRGI
407504VSJMPIV[MRHS[
407504VSJMPIV 
40750W]RXE\IVVSVW 
40750W]RXE\GLIGOMRK
40:MWMSR
GEXEPSK

GSRXVSPTERIP 
40:MWMSR'SRXVSP4ERIP 
40:MWMSR
TPEGMRKXLII\IGYXMSRTSMRX
TVIJIVIRGIW
TVIJIVIRGIW
4VIJM\[MXL7GLIQE2EQI
4VIZMI[MRKWSYVGIGSHI
4VIZMSYW7500MQMX 
4VMRX(EXE7LIIX
4VMRX*MPI
4VMRX7IXYT
TVMRXIVSVMIRXEXMSR 
TVMRXMRK
UYIV]VIWYPXW 
TVMZMPIKIW 
TVSGIHYVI 
TVSGIHYVIW 

Index

459

4VSJMPI)HMXSV 
TVSJMPIW 
IHMXMRK 
4VSJMPIW 
(&%ZMI[VIUYMVIH 
TVSJMPMRKHEXEX]TIW  
TVSKVEQQMRKWLSVXGYXOI]W 
4VSQTXJSV'LIGOMR%PP 
4VSTIVXMIW 
4VSZMHIV0SKSR  
4VSZMHIVW 
4YFPMWL.EZEXS40750  
4YFPMWL.EZEXS40750[M^EVH  
4:'7  

5
UYEPMX]EWWYVERGI 
UYIVMIW  
FYMPHMRK 
FYMPHMRKEYXSQEXMGEPP] 
YTHEXIEFPI  
ZMI[MRKVIWYPXWSJ  
[SVOMRK[MXLVIWYPXW 
5YIV]&YMPHIV 

GYWXSQM^MRK 
[MRHS[ 
UYIV]VIWYPXW 
5YMGO&VS[WI 

6
6EXMSREP'PIEV'EWI  
6IEH&YJJIV7M^I  
6IEH3RP] 
6IGEPP750 
6IGEPP750GSQQERH 
6IGEPPMRKETVIZMSYWP]I\IGYXIHWXEXIQIRX  
6IHS0SK+VSYTW 
(&%ZMI[VIUYMVIH 
6)*'96736 
VIJIVIRGIGSPYQRW 
VIPEXMSREPXEFPIW 

6IREQI 
6IREQI(&SFNIGX
VIREQMRKHEXEFEWISFNIGXW 
VITEVWMRK 
6ITSVX8VII 
VITSVXMRKXSSPW
VITSVXW
6IWYPX[MRHS[ 
GSQQERHWERHXSSPFEVW
ZMI[MRKVIWYPXWMR
VIWYPXWKVMH
6IWYPXWTERI 
6IXVMIZMRKTVIZMSYWP]I\IGYXIH750WXEXIQIRXW
6IZIEP2IX
ORS[PIHKIFEWIW
VIZIVWIIRKMRIIVMRKHEXEFEWISFNIGXW 
6IZSOI 
6SPIIHMXSV 
VSPIW 
6SPIW 
(&%ZMI[VIUYMVIH 
6SPPFEGO
6SPPFEGO7IKQIRXW 
(&%ZMI[VIUYMVIH 
6YR 
6YRRMRKWXSVIHTVSKVEQWMR(IFYKQSHI
6YRRMRKXLIWEQIWGVMTXEKEMRWXHMJJIVIRXHEXEFEWIW


7
WEJXI]STXMSRW 
7EZI*MPI 
7GER(IJMRIW 
WGLIQESFNIGXW
PMWXMRK 
7GVIIR0E]SYX
7GVMTX*MPI)\XIRWMSRW 
WGVMTXW
VYRRMRK
7IEVGL/RS[PIHKI<TIVX 
7IEVGLSV6ITPEGIMR8I\X
7IEVGLMRKJSVGSHISVSFNIGXWMRXLIHEXEFEWI

460

7IPIGXE(&3FNIGXHMEPSK 
7)0)'8%2=8%&0)4VMZMPIKI 
7)0)'8'%8%03+6SPI 
7)0)'8WXEXIQIRXW 
7IUYIRGI)HMXSV 
WIUYIRGIW  
IHMXMRK 
WIVZIVSYXTYX 
WIVZIVWMHISFNIGXW
7IWWMSRQIRY
7IWWMSRTVIJIVIRGIW 
WIWWMSRW 
W[MXGLMRK
7IXEFSSOQEVO 
7LEVIH'EXEPSK(MVIGXSV] 
7LS[7XEXMWXMGW 
7LS[8VMKKIV7RETWLSX
7MRKPI7XIT
7OI[8SPIVERGI 
7OMTXS&SXXSQ 
7OMTXS2I\X
7OMTXS4VIZMSYW 
7OMTXS8ST 
7QEVXGSHIGSQTPIXMSR 
7QEVX*MPP 
7QEVX8EF 
WSVXSTXMSRWMR407504VSJMPIV 
WSYVGIGSHI 
7SYVGI'SHIWIEVGLIW 
7SYVGI4VIZMI[ 
7SYVGI7EJI
WTEGIGLEVEGXIVW 
7TPMX;MRHS[XS(MWTPE]6IWYPXW 
7TSSP3YXTYX  
7TSSPXEF
7TSSP[MRHS[ 
7TSSP;MRHS[ 
7TSSPMRKSYXTYXEWXI\X
750
750'EXEPSK 
750GSHI

SQL Navigator Users Guide

IHMXMRK 
750GSHI
750)HMXSV
FSSOQEVOW 
GYWXSQM^MRKXSSPFEVW
JSVQEXXMRK 
MRWIVXMRKGSHI 
QEVOWMRKYXXIV 
W[MXGLMRKWIWWMSRW 
750)HMXSVXSSPFEV
750)HMXSV 

750-QTEGX 
750-QTEGX*MRH750 
750-QTEGX;LIVI9WIH 
7502EZMKEXSVZIVWMSR[MXLZIVWMSR 
7504PYW 
7507GVMTX
750WGVMTXW 
XYRMRK
7507XEXIQIRX6IGEPP 
750WXEXIQIRXW
I\IGYXMRK 
WEZMRKERHVIYWMRK 
[SVOMRK[MXLSYXTYX
750[MRHS[ 
750[MRHS[I\IGYXMSRWXEXYWTERI 
750[MRHS[WLSVXGYXQIRYGSQQERHW 
750[MRHS[XSSPFEVFYXXSRW 
750 4PYW
GSQQERHW 
750 4PYWGSQQERHWYTTSVX 
750 4PYWOI][SVHW
750 4PYW 
750EF 
7XERHEVHW'EXEPSK 
7XERHEVHW'EXEPSK(MVIGXSV]
7XEVFEWI7XEV8IEQ 
7XEVXXLII\IGYXMSRSJ750WXEXIQIRXW 
7XEV8IEQ
7XEXIQIRX6IGEPP 
WXEXMWXMGEPEREP]WMW 

Index

461

7XEXYW  


SJSFNIGXWYRHIV8IEQ'SHMRK 
7XEXYWGSQQERHSRXLI8IEQ'SHMRKQIRY 
WXEXYWSJSFNIGXWYRHIV8IEQ'SHMRK 
WXE]SRXST[MRHS[W 
7XIT3ZIV  
WXITTMRKSZIVGSHI 
7XITTMRKXLSYKLWXSVIHTVSKVEQW  
7XST  
7XSTSR)VVSV  
7XSVEKI 
7XSVEKIGPEYWI 
WXSVIHTVSGIHYVIW  
WXSVIHTVSKVEQHIZIPSTQIRX 
7XSVIH4VSKVEQ)HMXSV  

FSSOQEVOW 
QEVOWMRKYXXIV 
WXSVIHTVSKVEQW  

GSQTMPMRK  
GVIEXMRK  
HIFYKKMRK  
IHMXMRK 
7YFTVSZMHIVW  
WYFWXMXYXMSRZEVMEFPIW  
7YWTIRH 
W[MXGLMRKWIWWMSRW 
W]RGLVSRM^EXMSRSJEHZERGIHIHMXMRKJIEXYVIW  
7]RGLVSRM^EXMSR7IXXMRKW  
7]RGLVSRM^I 
W]RSR]QW  
IHMXMRK 
7]RXE\'EXEPSK 
7]RXE\,MKLPMKLXMRK  
7]RXE\LMRXW  

8
XEFGLEVEGXIVW 
8EFPI)HMXSV 
XEFPIW  


EREP]^MRK 
FVS[WMRKHEXEMR
HVEKKMRKMRXSUYIVMIW 
IHMXMRK 
IHMXMRKHEXEMR 
I\XVEGXMRK((0 
STXMQM^MRK 
TVIJIVIRGIW 
8EFPIW
8EFPIWTEGIREQI 
8EFPIWTEGIW 
(&%ZMI[VIUYMVIH 
8IEQ'SHMRK 

GSRRIGXMSRWIXXMRKW 
IVVSVW 
KIRIVEPSTXMSRW 
-RWXEPPMRK 
TIVQMWWMSRW
TVIJIVIRGIW 
VSPIWERHTVMZMPIKIW 
8IEQ'SHMRK
JMPII\XIRWMSRW
TVIJIVIRGIW 
8IEQ'SHMRK)REFPIH 
8IEQ'SHMRKQIRY 
8IEQ'SHMRKTVIJIVIRGIW 
8IEQ'SHMRKWXEXYWMRIHMXSVWXEXYWFEV
8IEQ'SHMRK7YTTSVXWGVMTXW 
8IEQ'SHMRK9WIV7XEXYW 
8IEQ'SHMRK 


8IEQ'SHMRK7XEXYWHIWGVMTXSVW 
XIQTPEXIW 
8IWX[MRHS[
8IWXMRKTVSKVEQGSHI
XI\X
IHMXMRKGSQQERHW 
XI\XJMPIW
MRWIVXMRKMRXSGSHI 
XI\X

462

SQL Navigator Users Guide

8MPI,SVM^SRXEP
8MPI:IVXMGEP 
8MQI(MWTPE]IH*SVQEX 
8MQI3YX 
8SKKPI&SSOQEVO
8SKKPI&SSOQEVOW 
8SKKPI&VIEOTSMRX
XSSPFEVFYXXSRWJSVIHMXMRKHEXEFEWISFNIGXW 
XSSPFEVW 
8SSPFEVW
8SSPWERHGSQQERHWJSVIHMXMRKWXSVIHTVSKVEQW 

8SSPXMT)ZEPYEXMSR 
XSSPXMTW
EGXMZEXMRKERHHIEGXMZEXMRK 
WIXXMRKHIPE] 
8VEGI)REFPI 
8VEGI0IZIP 
8VEGI-RXS 
XVEGMRKHEXEFEWIXVERWEGXMSRW
XVERWEGXMSRPSKKMRK
8VMKKIV)HMXSV 
XVMKKIVIHMXSVTVIJIVIRGIW 
8VMKKIVMRZSGEXMSRFPSGO 
XVMKKIVW  

HIFYKKMRK
IHMXMRK 
8VYRGEXI
HMWEFPMRK
8VYRGEXI
XYRMRK 
750WGVMTXW
8YXSVMEP1IWWEKIW 
X]TI 
XSSPXMT 

9
9RGSQQIRX
9RGSRXVSPPIH 
9RHS 
9RHS'LIGOSYX

9RHSSV6IHSERIHMXMRKSTIVEXMSR
9RPSEH.EZE
9RTMR 
9THEXIHEXEFEWIEJXIV'LIGO-R 
9THEXIEFPI 
YTHEXIEFPIUYIVMIW 
9TTIV'EWI 
9WIVH4EVX]:IVWMSR'SRXVSP
9WI'SHI'SRXVSP+VSYTW 
9WI8%&'LEVEGXIVW 
9WI8VMKKIV(IWGVMTXMSRJSV((0
9WIVIHMXSV
97)6CZMI[W
YWIVHIJMRIHX]TIW 
YWIVW 
IHMXMRK 
9WIVW 
(&%ZMI[VIUYMVIH 

:
ZEPMHEXIXLIW]RXE\SJ750WXEXIQIRXW 
ZEPMHEXMRKSFNIGXWXVYGXYVI 
:EPMHEXMRKW]RXE\
ZEVMEFPIW  

HIFYKKMRK
IZEPYEXMRKERHQSHMJ]MRK 
XSSPXMT 
[EXGLIH
:%66%=)HMXSV
ZEVVE]W 
GVIEXMRK 
:%66%=W 
EPXIVMRK 
GVIEXMRK 
ZEVV]MRKEVVE]W 
:'4
:'7
:'71MKVEXI[VM 
ZIVWMSRGSRXVSP


Index

463



:IVWMSR'SRXVSP&VS[WIV 
:IVWMSR'SRXVSPTVSHYGXW 
:IVWMSR'SRXVSPVITSWMXSV] 
ZIVWMSRGSRXVSPW]WXIQW  
ZIVWMSRW 
GSQTEVMRK 
:MI[)HMXSV 
ZMI[MRKSFNIGXW 
:MI[MRKVIWYPXWMRXLI3YXTYX[MRHS[  
ZMI[W 
HVEKKMRKMRXSUYIVMIW 
IHMXMRK 
ZMWYEPSFNIGXIHMXSVW 
:MWYEP7SYVGI7EJI  

;
;EXGLIHZEVMEFPI  




[EXGLIHZEVMEFPIW 
;IF'EXEPSK 
;IF'SRJMKYVEXMSR
[IFHIZIPSTQIRXWYTTSVX
;IF7IVZIV 
VIUYMVIQIRXWJSVYWMRK
WXEVXMRK
;,)6)GPEYWIW 
[MPHGEVHGLEVEGXIV
[MPHGEVHGLEVEGXIVW 
;SVOMRK(MVIGXSV] 

;SVOWTEGI[MRHS[ 
[SVOWTEGIW 
TVIJIVIRGIW 

<
<TIVX8YRMRK 

Potrebbero piacerti anche