Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The following table lists the tabs and entities from which you can launch the SQL tab.

Table 8- 1 Launching the SQL tab in context

TabEntities
DashboardStatement
CurrentStatement, Active or Current Session that is currently executing a statement.
ActivityStatement, PL/SQL
ObjectsStatement, PL/SQL
What-IfStatement that is affected by one or more index evaluations.

In the Current, Activity, and Objects tabs, you can either launch the SQL tab by clicking the SQL tab button when the selected entity in the Main area is a statement, or by selecting a statement in the Association area and clicking the Tune icon that appears before the SQL text.

...

The following table describes the information displayed in the Plan view.

Table 8- 2 Information tabs

Information TabsDescription
HighlightsDisplays the execution plan's formatted text and findings that enable you to identify the most probable cause of the problem your statement is experiencing.
Expanded TextShows all views and synonyms expanded inline allowing you to match the access steps to the version of SQL that Oracle is actually executing.
ObjectsDisplays information on all referenced objects in the execution plan, including their indexes and columns. Statistical details and general details are displayed for each object.
More ...

Shows the following additional information for a plan:

  • Statistics view. Displays statistical information on all steps in the execution plan tree
  • Workshop view. Displays details on the execution plan, where the statement is stored, and the SQL text of the statement
Info

If you use the Oracle rule-based Optimizer, cost information is not available. If tables and indexes are not analyzed, statistics changes are not available.

...

The following table describes the information displayed for the tables that are accessed in the execution plan.

Table 8- 3 Information on tables used in the plan

ColumnDescription
Image Modified
Launches the Objects tab so that you can focus on the specified table.
Image Modified
Locates and highlights all the steps in the execution plan that access the specified table.
UsedIndicates whether the specified table is used in the selected step in the execution plan tree.
Table

Displays the table name. A ToolTip displays the full name in the following format:

Owner.Table_Name.

RowsNumber of rows in the table based on data dictionary statistics.
BlocksTotal number of blocks in the table.
Non-Empty BlocksNumber of used blocks in the table.
Chained RowsNumber of chained rows in the table.
PartitionedIndicates whether the table is a partitioned table.
Index OrganizedIndicates whether the table is an index organized table.
TemporaryIndicates whether the table is a temporary table.
Object IDID of the object.
OwnerOwner of the table.
I/O WaitTime of IO wait in the specific plan.

About the indexes defined for the selected table

...

The following table describes the information displayed for the indexes that are used to access the selected table.

Table 8- 4 Information on the indexes used to access the selected table

ColumnDescription
Image Modified
Launches the Objects tab so that you can focus on the specified index.
Image Modified
Locates and highlights all the steps in the execution plan that access the specified index.
UsedIndicates whether the specified index is used in the selected step in the execution plan tree.
IndexIndex name. A ToolTip gives the full name, such as Owner.Index_name.
UniqueIndicates whether the index is unique.
TypeIndex type, such as Normal (B*Tree), Bitmap, and so on.
PartitionedIndicates whether the index is a partitioned index.
blocksTotal number of blocks in the index.
Leaf BlocksNumber of leaf blocks in the index.
Distinct KeysNumber of distinct keys or values in the index.
B-LevelDepth of a B*Tree index.
Clustering Factor

Clustering factor of the index.

The clustering factor is an important factor in determining how efficiently an index range scan will retrieve data from the table. It measures the degree to which the data in the index and its table are in the same order or, put another way, the probability that the next row to be fetched from the table is in the same block as the current row. It can vary between the number of blocks in the table (the best case because they are in the same order) and the number of rows in the table (the worst case because they are completely out of sync). The clustering factor tends to become worse over time as data is inserted and deleted. Note that the clustering factor makes no difference for a unique index lookup.

I/O WaitTime of IO wait for index in the specific plan.
Last AnalyzedTime when the table was last analyzed.
Object IDID of the Object.
OwnerOwner of the table.
LocalityIndicates if the index is local or global.

About the columns in table or index

...

The following table describes the information displayed for the columns of the table.

Table 8- 5 Information on the columns of a table

ColumnDescription
Image Modified
Launch the Objects tab so that you can focus on the specified column.
ColumnColumn name.
TypePhysical storage type of the column.
Distinct ValuesNumber of distinct values.
Key NumberPosition of the column in the index selected in Indexes of Table; otherwise blank.
Asc/DescIndicates whether the column is part of the selected index and whether it is sorted in ascending or descending order.
In ClauseLocation of the column in the statement. The column may appear in the Select clause, Where clause, Group by clause, Having clause, and Sort by clause.
IndexableIndicates whether the column could be used as part of an index. A column may be indexable even though it is not currently part of any index. Alternatively, a column may not be indexable, even though it is currently part of an index, if the column does not appear within the where clause (or group by, or order by clauses) or there is a function on the column (and there is no function-based index). The Optimizer will not be able to use an index if the leading columns in the index are non-indexable (unless it can employ a skip-scan search).
IndexesList of indexes in which the column is used.

About statistical information on all operators in the execution plan

...

The following table shows the information displayed in statistics table for the execution plan.

Table 8- 6 Execution plan statistics

ColumnDescription
Image Modified
Locates and highlights the step in the Execution Plan tree that matches the selected step in the grid.
Step IDDisplays the number of the explain plan step.
StepProvides a short description of the explain plan step.
Estimated CostEstimated cost of the current operation. A high cost value may indicate a problem in the current implementation of the operation. Check the Estimated I/O cost and Estimated CPU cost values to determine whether the operation is an I/O consuming operation or a CPU consuming operation (or both).
Estimated RowsEstimated number of rows returned by this step.
Estimated BytesEstimated number of bytes returned by this step.
Estimated CPU CostThe estimated CPU cost of the current operation. A high cost value may indicate a problem in the current implementation of the operation.
Estimated I/O CostEstimated I/O cost of the current operation. A high cost value may indicate a problem in the current implementation of the operation.
Partitioned IDName of the table or index partition, if the step involves a partitioned table or index.
Partition StartLow value of the partition key.
Partitioned StopHigh value of the partition key.
Access PredicatesPredicates used to locate rows in an access structure; for example start or stop predicates for an index range scan (as defined in Oracle documentation).
Filter PredicatesPredicates used to filter rows before producing them (as defined in Oracle documentation).
#Step #.
In OracleIn Oracle time for the specific step.
CostCost for the specific step.
Other TagData as seen in Oracle for specific step.
Plan HashPlan hash value.

About information on statement plan, location, and text

...

The following table describes how the information on the Workshop tab is structured.

Table 8- 7 Structure of information on the Workshop tab

ItemDescription
Explained onDate the latest explain plan was first generated.
CostEstimated cost calculated by the Oracle cost-based Optimizer.
Parsing UserIn the case of an imported or manually saved statement, this is the Oracle user that was specified at the time; in the case of an automatically captured statement, it is the first Oracle user that the Precise for Oracle Collector found running the statement.
CabinetCabinet where the statement is stored.
FolderFolder within the cabinet where the statement is stored.
Origin

Source of the statement. The Precise for Oracle Collector will automatically capture most statements when they are executing in Oracle, but some may be imported from source files or saved manually. Possible values are:

  • Automatically collected
  • Generated as related SQL
  • Predicted plan (What-If)
  • Entered by user
  • Imported from source file
  • Generated as related SQL by user
Saved onDate that the statement was saved.
Parsing InformationIndicates whether Precise for Oracle has performed an extra level of parsing above that performed by Oracle to support more detailed analysis and syntax color highlighting.
CommentUser-defined comment that can be entered against a statement when it is saved. See “Editing the properties of a statement” on page 31.

About the Recommend button

...

The following table describes the information displayed for the alternative statements.

Table 8- 8 Alternative Statements

ColumnDescription
Image Modified
Launches to the Plan view with the statement in context and lets you view the statement's execution plan, in the Highlights tab.
Image Modified
Lets you compare the alternative statement with the original statement.
StatusDisplays whether or not the statement was successfully run, or whether it is still running or has timed out.
Name

The information displays for the following statement names:

  • For an alternative statement, it displays the alternative statement's name.
  • For the original statement, it displays the original statement's name.
  • For an alternative run of a statement, it displays the name of the alternative or statement used as a base for running the alternative statement.
TimestampDisplays the time the statement was run.
Plan Hash ValueDisplays the hash value for the plan associated with the selected statement.
Statement IDDisplays the statement ID.
Duration (Avg.)Displays how long the statement ran.
CostDisplays the average cost of the plan.
Logical I/O (Avg.)Displays the average number of logical I/O operations per executed statement.
Physical ReadsNumber of physical reads from disk.
Hit RatioNumber of physical reads or logical reads, expressed as a percentage.
Table ScansNumber of full table scans performed.
Write RequestsNumber of requests to write data to disk, usually of temporary data during joins and sorts.
SortsNumber of sorts performed.
Sorted RowsTotal number of sorted rows.
Table Scans by Row IDNumber of accesses to a table by Row ID. A Row ID contains the address of a row in a table and is the fastest way to gain access to an individual row, although not necessarily to multiple rows. Access via Row ID usually follows an index scan, because Row IDs are stored in the leaf blocks of an index.
Table Scan Rows GottenNumber of rows retrieved from tables.
Table Scan BlocksNumber of blocks fetched from tables.
Recursive CallsNumber of recursive SQL calls that Oracle made to the data dictionary while executing the statement.
Processed RowsNumber of rows processed during the execution. This includes rows retrieved from tables, indexes, and temporary segments. It may be many more than are returned.
Host NameDisplays the host name of the server that the statement is running on.

Description

If you chose to run an alternative of the statement, this field displays the description assigned to the run in the Run Statement dialog box.
Attempted ExecutionsNumber of executions started.
Actual ExecutionsNumber of executions completed.

About the text of an alternative statement

...

The following table describes the additional statistics information displayed for each alternative.

Table 8- 9 Extended Statistics table

ColumnDescription
#Displays the sequential number of the step.
Step IDDisplays the number of the explain plan step.
StepProvides a short description of the explain plan step.
RowsDisplays the number of rows returned by this step.
TimeDisplays when the alternative statement was last run.
BlocksDisplays the total number of blocks in the alternative statement.
ExecutionsDisplays the number of executions of the alternative statement.

About the History view of resource consumption

...

The Overview, in the SQL tab, displays the following overtime graphs:

Table 8- 10 Graphs

GraphDescription
In Oracle (Avg.)Illustrates the average resource consumption of the statement over time; does not detail the states or substates.
CostDisplays the estimated cost calculated by the Oracle cost-based optimizer over time. This information is generated whenever you explain the statements using Precise for Oracle.
Changes

Marks significant events that affect the statement and the objects that it accesses over time, namely analyze statistics changes, schema changes, and execution plan changes.

The execution plan changes information is generated whenever you explain the statements using Precise for Oracle, either using the PMDB process or the SQL tab.

The statistics changes information is generated whenever you run the PMDB process Collect Schema Changes. It scans all the objects referenced by the statement.

The schema changes information is generated whenever you run the PMDB process Collect Schema Changes. It scans all the objects referenced by the statement. See “About the Change History area” on page 143.

ExecutionsDisplays the number of executions of the selected statement over time.

About the text of a statement in the History view

The Text view, in the SQL tab, displays the full SQL text of the statement and information on the statement and execution plan, as follows:

Table 8- 11 Text view display

InformationDescription
CabinetThe cabinet where the statement is stored.
FolderThe folder within the cabinet where the statement is stored.
Origin

The source of the statement. The Precise for Oracle Collector automatically captures most statements when they are executing in Oracle, but you can also import statements from source files or save them manually.

A statement can be automatically collected, generated as related SQL, part of a predicted plan in the What-If tab, entered by users, imported from a source file, or generated as a related SQL by a user.

Saved onThe date that the statement was saved.
Parsing Information

Indicates whether Precise for Oracle has performed an extra level of parsing above that performed by Oracle to support more detailed analysis and syntax color highlighting.

For statements that are explained in the background, parsing must be enabled in the Explain Statements PMDB process in AdminPoint (see the Precise Administration Guide) for statements that are explaining in the background. For statements that you explain in the SQL tab, parsing must be enabled from Settings>General Settings>SQL.

By default, parsing is enabled. Some statements cannot be parsed. See the Precise Administration Guide. See “About SQL settings” on page 27.

Explained onThe date the latest explain plan was generated.
CostThe estimated cost calculated by the Oracle cost-based optimizer.
Parsing UserIn the case of an imported or manually saved statement, the Oracle user that was specified at the time; in the case of an automatically captured statement, the first Oracle user that the Precise for Oracle Collector found running the statement.

About the Change History area

...

The following table describes the information displayed in the All Changes table.

Table 8- 12 All Changes table

ColumnDescription
Image Modified
Switches to the Plan view and displays the first access plan that was created by the Explain Statements process after the specified change was detected.
Image Modified
If the object that was changed is one of the entities in the Objects tab (table, view, index, or column), this icon will launch the Objects tab with the selected object in context. Also, if the change type is Access Plan Changed, the icon will launch the Compare view with the specified access plan compared to the last access path, as detected by the Explain Statements process.
TimestampIndicates the date that the change was detected.
Change Type

Displays the type of change detected. Can be one of the following values:

  • Table Created
  • Table Dropped
  • Table Altered
  • Index Created
  • Index Dropped
  • Index Altered
  • Table Statistics Changed
  • Initial Execution Plan
  • Different Execution Plan
ObjectIndicates the object that was changed, such as table or index.
Change DetailsDisplays information about the change that was made. For example, if the Change Type is Different Execution Plan, the Change Details column gives the estimated cost.

About schema changes

The Schema Changes view displays a list of all schema type changes made.

The following table describes the information displayed in the Schema Changes table.

Table 8- 13 Schema Changes table

ColumnDescription
Image Modified
Switches to the Plan view and displays the first access plan that was created by the Explain Statements process after the specified change was detected.
Image Modified
If the object that was changed is one of the entities in the Objects tab (table, view, index, or column), this icon will launch the Objects tab with the selected object in context.
TimestampIndicates the date the change was detected.
Change Type

Displays the type of change detected. It can be one of the following values:

  • Table Created
  • Table Dropped
  • Table Altered
  • Index Created
  • Index Dropped
  • Index Altered
ObjectIndicates the object that was changed, such as table or index.
ColumnsIndicates the columns in the object that were affected by the change.

About statistics changes

The Statistics Changes view displays a list of changes made to Oracle statistics on tables, indexes, and columns. The following table describes the information displayed in the Statistics Changes table.

Table 8- 14 Statistics Changes table

ColumnDescription
Image Modified
Switches to the Plan view and displays the first access plan that was created by the Explain Statements process after the specified change was detected.
Image Modified
Launches the Objects tab with the selected instance.
TimestampIndicates the date the change was detected.
ObjectIndicates the object that was changed, such as table or index.
TypeDisplays the type of object, such as table or index.
RowsA change in the number of rows.
Non-Empty BlocksA change in the number of non-empty blocks.
Free Space (Avg.)A change in the average free space in a block.
Chained RowsA change in the number of chained rows.
Distinct KeysA change in the number of distinct keys in an index.
Leaf BlocksA change in the number of leaf blocks in an index.
Clustering Factor

A change in the clustering factor of an index.

The clustering factor is an important factor in determining how efficiently an index range scan will retrieve data from the table. It measures the degree to which the data in the index and its table are in the same order or, put another way, the probability that the next row to be fetched from the table is in the same block as the current row. It can vary between the number of blocks in the table (the best case because they are in the same order) and the number of rows in the table (the worst case because they are completely out of sync). The clustering factor tends to become worse over time as data is inserted and deleted. Note that the clustering factor makes no difference for a unique index lookup.

About execution plan changes

...

The following table describes the information displayed in the Execution Plan Changes table.

Table 8- 15 Execution Plan Changes table

ColumnDescription
Image Modified
Switches to the Plan view and displays the first access plan that was created by the Explain Statements process after the specified change was detected.
Image Modified
Opens the access plan in the Compare view and lets you compare the specified access plan with the last access plan, as detected by the Explain Statements process.
TimestampIndicates the date the specified access plan was detected by the Explain Statements process.
CostEstimated cost calculated by the Oracle cost-based Optimizer.
Nested LoopsNumber of nested loop operations performed.
Hash JoinsNumber of hash joins performed.
Merge JoinsNumber of merge joins performed.
SortsNumber of sorts performed.
Table ScansNumber of full table scans performed.
Index ScansNumber of index scans performed.
StepsBar graph showing the number of steps in the execution plan and a visual breakdown of the different types of operations performed.

About the run statistics history

...

The following table explains the information shown on the General tab.

Table 8- 16 Information shown on the General tab

ColumnDescription
TimestampDisplays when the statement was run.
DurationHow long the statement took to run.
Processed RowsNumber of rows processed during the execution. This includes rows retrieved from tables, indexes, and temporary segments. It may be many more than are returned.
Physical ReadsNumber of physical reads from disk.
Attempted ExecutionsNumber of executions started.
Actual ExecutionsNumber of executions completed.
Timed OutDenotes whether the timeout specified in the Run dialog was reached. The timeout is for all executions.
Timeout (Sec.)Timeout in seconds that was specified in the Run dialog box.
StatusOne of the following states: Started, Completed, or an error message if an error has occurred.

The following table explains the information shown on the Statistics tab.

Table 8- 17 Information shown on the Statistics tab

ColumnDescription
TimestampWhen the statement was run.
Logical ReadsNumber of logical reads.
Hit RatioNumber of physical reads or logical reads, expressed as a percentage.
Write RequestsNumber of requests to write data to disk, usually of temporary data during joins and sorts.
SortsNumber of sorts performed.
Sorted RowsTotal number of sorted rows.
Table ScansNumber of full table scans performed.
Table Scans by Row IDNumber of accesses to a table by Row ID. A Row ID contains the address of a row in a table and is the fastest way to gain access to an individual row, although not necessarily to multiple rows. Access using Row ID usually follows an index scan, because Row IDs are stored in the leaf blocks of an index.
Table Scan Rows GottenNumber of rows retrieved from tables.
Table Scan BlocksNumber of blocks fetched from tables.
Recursive CallsNumber of recursive SQL calls that Oracle made to the data dictionary while executing the statement.

Comparing execution plans

...

The following table describes the information displayed in the All Plans table.

Table 8- 18 All Plans table

ColumnDescription
Image Modified
Launches to the SQL tab with the selected plan in context.
Image Modified
Launches to the Compare view so that you can compare the current plan and the selected plan.
Plan Hash ValueDisplays the plan's hash value, as computed by Oracle.
Plan Type iconIndicates whether a plan is a real or estimated execution plan.
First Detected

For actual plans, displays when the plan was first encountered.

For estimated plans, displays when the statement was first explained and the plan was produced.

Last Detected

For actual plans, displays when the plan was last encountered.

For estimated plans, displays when the statement was last explained and the plan was produced.

In OracleDisplays the total time spent in Oracle by statements which were using this plan during the selected time frame.
Duration (Avg.)Displays the average amount of time it took the plan to run.
CostDisplays the last cost retrieved for the plan.
ExecutionsDisplays the number of times the plan was executed, during the selected time frame.

About the all plans overview

...

The following information is displayed for each bind set in the Bind Variables table in the left pane:

Table 8- 19 Bind set

Bind SetDescription
Plan Match iconIcon that indicates whether the plan's hash value matches the hash value of the real execution plan.
Estimated CostDisplays the estimated cost of the plan.
Best Plan Hash ValueDisplays the best hash value of the selected plan. This information is displayed after you run Get Best Plan. If different hash values are displayed, this may indicate that there is a matching problem.
Date Last CapturedDisplays the date and time the bind set was last captured.
Bind Variables (B1B50)Displays the values of bind variables B1 through B50. Precise for Oracle can display up to 50 bind variables.
Duplicated SetsThe number of times this specific bind set was collected.

Viewing information displayed for a particular bind set

You can view the text of a particular bind set, and copy an estimation of the text to another tool, in the Details area (right pane) of the Bind Variables view. You can view the following text for a bind set:

Table 8- 20 Bind set

Bind SetDescription
Text, with bind variables replacedDisplays source text with bind variables replaced by the actual values run by the statement.
Text for EstimationDisplays source text and hints that instruct Oracle how to sample the table's data and create an optimal plan for the same bind variables.
Bind variables metadataDisplays additional information for the bind variables of the selected bind set (such as, bind name and type, and column name and type). This information can be useful in cases where the same bind name is used for different columns, with different data types.

To view the text of a bind set, with variables replaced

...

The following table describes the Findings table.

Table 8- 21 Findings table

ColumnDescription
Severity

 Indicates the severity alert that occurred during the sampled execution plan. Severity is displayed using the following colors:

  • Red. Top findings.
  • Orange. Medium findings.
  • Yellow. Other findings.
Info

An orange or yellow finding in an execution plan with many findings, may become a red finding in an execution plan with minimum findings because it becomes one of the top findings.

Image Modified
Launches to a tab in context with the chosen object.
TypeIndicates the type of operation. Notice that the given type may be underlined. This indicates a live link ToolTip. Select the live link type to view ToolTip recommendations to better access the execution plan and improve the performance of the statement.
ObjectLists the object in the type of operation that is referenced by the execution plan.
Impact (%)Indicates the maximum theoretical saving, expressed as a percentage of the total In Oracle time consumed. Note that the actual saving that can be made depends on the activity.
In OracleIndicates the time used to perform this operation In Oracle for this execution plan.

About the Expanded view

The Expanded view displays recommendations that the Oracle Optimizer can use to create a better access plan and improve the performance of the statement.

...

The following table describes the information displayed on the Details tab.

Table 8- 22 Details tab information

ColumnDescription
Image Modified
Switches to Plan view, in context with the selected related SQL statement.
Image Modified
Available for related SQL statements but not for the original statement.
NameName of the statement.
Statement IDID of the statement.
TimestampLast run date and time of the statement.
CostBar graph showing the Oracle Optimizer cost for the statement.
Plan Hash ValueDisplay plan hash value.
Duration (Avg.)Average time of how long the statement took to run.
Logical I/O (Avg.)Number of average logical I/Os from the disk.
Physical ReadsNumber of physical reads from disk.
Hit RatioNumber of physical reads or of logical reads, expressed as a percentage.
Table ScansNumber of full table scans performed.
Write RequestsNumber of requests to write data to disk, usually of temporary data during joins and sorts.
SortsNumber of sorts performed.
Sorted RowsNumber of sorted rows.
Table Scans by Row IDNumber of accesses to a table by Row ID. A Row ID contains the address of a row in a table and is the fastest way to gain access to an individual row, although not necessarily to multiple rows. Access using Row ID usually follows an index scan, because Row IDs are stored in the leaf blocks of an index.
Table Scan Rows GottenNumber of rows retrieved from tables.
Table Scan BlocksNumber of blocks fetched from tables.
Recursive CallsNumber of recursive SQL calls that Oracle made to the data dictionary while executing the statement.
Processed RowsNumber of rows processed during the execution. This includes rows retrieved from tables, indexes, and temporary segments. It may be many more than are returned.
Host NameName of the host.
DescriptionDescription
Attempted ExecutionsNumber of executions started.
Actual ExecutionsNumber of actual executions performed.

About the SQL text for each alternative

...

It is possible to perform the following tuning actions:

Table 8- 23 Tuning actions

ActionDescription
OpenOpen an existing statement.
NewCreate a new statement.
Edit PropertiesEdit the properties on an existing statement. See “Editing the properties of a statement” on page 31.
Edit TextEdit an existing statement.
RunRun a statement.
Re-ExplainRe-explain a statement.
RecommendGenerate new recommendations.
Generate AlternativesGenerate new alternatives.
Get Best PlanGet the best plan according to collected bind sets.

Opening an existing statement

...

The alternate SQL has no function around the C_LAST column. Therefore, Oracle is able to use the index CUSTOMER_I2 index to more efficiently access the records in the CUSTOMER table.

 

...

.

...