Versions Compared

Key

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

This section includes the following topics:

Anchor
AbouttheSQLtab
AbouttheSQLtab
About the SQL tab

The SQL tab lets you analyze execution plans and explain results so that you can tune statements and achieve optimal results.

...

Table 7-1 Launch in-context to following entities

Tab    Entities

Dashboard    Statement

...

TabEntities
DashboardStatement
CurrentStatement, Active or Current Session that is currently executing a statement.

...

ActivityStatement
What-

...

IfStatement that is affected by one or more index evaluations.

...

Info

If the SQL tab is opened with no statement in-context, the following error message is displayed:

No statement in context. Please open a statement.

In the Current tab, 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.

...

There can be statements with many execution plans. See “About the Dashboard tab” on page 23.See , “About the Current tab” on page 30. See , “About the Activity tab” on page 39. See , and “About the Objects tab” on page 67.

Anchor
HowtheSQLtabisstructured
HowtheSQLtabisstructured
How the SQL tab is structured

The following sections explain how to view information and navigate through the SQL tab:

Anchor
Aboutviewingtheexecutionplanofastatement
Aboutviewingtheexecutionplanofastatement
About viewing the execution plan of a statement

The Plan Tree area displays the execution plan of a statement and related information, such as statistics, referenced objects, and operations performed in the execution plan. It lets you assess and tune statements based on real information.

Two types of execution plans are available when launching to the SQL tab:

Virtual execution

...

plan. The plan which was collected from DB2 V$ tables. Additional real-time statistics are available for these plans. For example, you can view a breakdown of In DB2 time for a plan as compared to other plans, or a breakdown of its I/O when accessing DB2 objects.
When launching to the SQL tab with a specific SQL statement in context, Precise for DB2 presents actual execution plan information, including actual plan steps, and information and statistics for multiple plans. For example, if a statement has several different execution plans, all are displayed.

Estimated execution

...

plan. Depending upon the version of DB2 running on your system, you may be only able to generate and run an estimated execution plan. At times, real execution plan information is lost (as when they are removed from the system before Precise for DB2 could access them). If this happens, all real-time statistics (such as, I/O, and In DB2) are considered to belong to other plans.

The Plan view is divided into three panes. The Plan Tree area and the Text View area are displayed in the left pane. The Details area is displayed in the right pane. The information displayed in the Details area is controlled by the information tabs (Highlights, Objects, Operators, Text, and Recommendations) that are located at the top of this area.

...

Table 7-2 Information tabs

Information

...

TabsDescription
HighlightsThe default tab, it displays the statement’s Optimized text. When opening a new plan tree or when clicking on the root of the tree, the original text is displayed (Text tab). When an operator is clicked, the text will be switched to the optimized text of the statement.

...

ObjectsDisplays information on all referenced objects in the execution plan, including their tables, indexes, and columns. Statistical and general details are displayed for each object.

...

OperatorsDisplays information on all operators in the Execution plan tree. When you sort a table, you can locate operators by their total cost or by any other column in the table.
Text

...

Displays the Original text of the statement.
Recommendations

...

Displays new index recommendations for the statement. These are additional indexes that can improve the statement.

Info

...

This tab is only displayed after you generate Recommendations (by clicking the

...

Recommend button or clicking Actions>Recommend.

About the Execution Plan tree

The Execution Plan tree displays both the Virtual execution plan and the Estimated execution plan, of the specified statement.

The execution plan's text appears both in the Text View area (Text tab) at the bottom of the execution plan tree and at the top of the Details area (also a Text tab). The text that relates to the selected step in the Plan tree is highlighted. This lets you view the text of the statement, the execution plan, and additional information, such as the objects referenced by the statement, all at once. In the Text View area you can also view two additional tabs displaying Optimized Text and Remote Query Text.

Actions that can be performed on the tree

You can perform the following actions on the execution plan tree:

  • The Playback controls, located at the top of the tree, enable you to freely move within the execution plan of an explained statement (step by step).
  • By moving the pointer over the execution plan steps, you can view a ToolTip that contains statistical information, such as Estimated Cost, Estimated Rows, and Estimated I/O Cost, and a description of the specified step.
  • Selecting a specific step (operator) highlights nested steps and affects the information displayed in the Detail tabs: the relevant Optimized text is shown on the Highlights tab; the referenced tables, indexes, and columns are shown on the Objects tab; the operators and predicates are shown on the Operators tab; and the Original text is shown on the Text tab. The Recommendations tab, only displayed when you generate recommendations, shows index details and the DDL for creating the indexes.
  • Clicking the hatchet mark (    ), located at the bottom of the tree, displays the Tree View area with three tabs allowing you to select which statement text to view:
    • Optimized Text
    • Original Text
    • Remote Query Text

...

Info

When launching to the SQL tab, the Highlights tab in the Details area and the Text tab in the Text View area are selected by default.

Anchor
AboutinterpretingtexthighlightingontheHighlightstab
AboutinterpretingtexthighlightingontheHighlightstab
About interpreting text highlighting on the Highlights tab

The Highlights tab displays the statement’s Optimized text as generated by the DB2 optimizer. Depending upon the operator selected on the Tree, the text will have different colors highlighting relevant tables, columns, and predicates.

...

Note: Not all operators include color fonts. Color fonts are used only when relevant for performance tuning.

Anchor
Aboutviewingwhichobjectsarereferencedbytheexecutionplan
Aboutviewingwhichobjectsarereferencedbytheexecutionplan
About viewing which objects are referenced by the execution plan

The Objects tab displays three tables (Tables used in Plan, Indexes on Table, Columns in Table) that list all referenced objects in the execution plan, including their indexes and columns. Statistical details and general details are displayed for each object and its sub-entities.

...

Key Number    The position within the chosen index.

Anchor
AboutviewinginformationonalloperatorsandpredicatesintheExecutionplan
AboutviewinginformationonalloperatorsandpredicatesintheExecutionplan
About viewing information on all operators and predicates in the Execution plan

The Operators tab displays information on all operators in the Execution plan tree. When you sort a table, you can locate operators by their total cost or by any other column in the table.

...

Sub Select    Indicates when the subquery used in this predicate is evaluated.

Anchor
Aboutviewingthestatementtext
Aboutviewingthestatementtext
About viewing the statement text

The Text tab displays the statement’s original text.

Anchor
Aboutviewingrecommendedindexesforastatement
Aboutviewingrecommendedindexesforastatement
About viewing recommended indexes for a statement

The Recommendations tab displays the output of the Recommend algorithm. The Recommendations tab is divided into three areas:

...

The Details area displays statistical information of the recommended index. The DDL area displays the create index statement.

Anchor
Aboutviewingadditionalexecutionplandetails
Aboutviewingadditionalexecutionplandetails
About viewing additional execution plan details

You can view additional execution plan details by hovering over a specific execution plan row with the mouse. A ToolTip is displayed showing some of the following details, depending upon which row you are hovering over:

  • Operator Type
  • Description
  • Estimated Total Cost
  • First row cost
  • Estimated I/O cost
  • Estimated CPU cost
  • Estimated communication cost
  • Contribution Ratio
  • Estimated total cost
  • Operator Arguments such as:
    • MAXPAGES=ALL
    • PREFETCH=NONE
    • ROWLOCK=EXCLUSIVE
    • SCANDIR=FORWARD
    • TABLOCK=INTENT EXCLUSIVE

Anchor
Abouttuningactions
Abouttuningactions
About tuning actions

Use the Actions menu to perform the following operations:

...