New Analysis Wizard: Abstract Plan
View New Analysis Wizard - Abstract Plan
In the New Analysis wizard, the Abstract Plan page is used to include the abstract plan with SQL statements.
Baseline Plan
Dump abstract plan
Specify whether to retrieve the abstract plan for the SQL statement from the system you are migrating from. The abstract plan displays in the right pane for SQL statements. This retrieves a new abstract plan even if one was saved with the original SQL. It is important to use this option if you original saved the SQL statement and abstract plans in version 12.5.0.3 or earlier of Adaptive Server and are now using Adaptive Server 15.0 or later since the format of the abstract plan has changed.
Note: This option is disabled if you have selected Using existing query plan saved with the SQL on the Select SQL page.
Group name
Specify the abstract plan group name where the abstract plans are saved. The default group names in Adaptive Server are: ap_stdout and ap_stdin. These groups are usually used by the Database Administrator to enable server-wide abstract plan capturing and retrieving.
ap_stdout is used by default to capture an abstract plan.
ap_stdin is used by default to retrieve the abstract plan associated with a SQL statement during the execution of the SQL statement.
Abstract Plan Manager button
Opens the Abstract Plan Manager window to view, create, and modify abstract plan group.
Scenario
Dump abstract plan
Specify whether to retrieve the abstract plan for the SQL statement from the system you are migrating to. The abstract plan displays in the right pane for SQL statements.
Group name
Specify the abstract plan group name where the abstract plans are saved. The default group names in Adaptive Server are: ap_stdout and ap_stdin. These groups are usually used by the Database Administrator to enable server-wide abstract plan capturing and retrieving.
ap_stdout is used by default to capture an abstract plan.
ap_stdin is used by default to retrieve the abstract plan associated with a SQL statement during the execution of the SQL statement.
Abstract Plan Manager button
Opens the Abstract Plan Manager window to view, create, and modify abstract plan group.
View Migration Analysis Details
The Migration Analysis Details window displays information about the retrieve of the query plan for each SQL statement.
The Migration Analysis Details window displays after the batch run process is completed unless the Show details on next batch run checkbox in the Migration Analysis Details window is unchecked.
To view the Migration Analysis Details window after an analysis
-
Select View | Show Migration Analysis Details.
-
Review this information to see if an error occurred during the retrieval of the query plan. Errors may occur if the selected SQL statements are from one database and user and you have set another database and user in the drop-down boxes at the bottom left of the main window.
Migration Analysis Results
Upon completion of the migration analysis process, a summary of the analysis is the Migration Analysis Details window, which tells if any of the query plans retrieval failed for any of the SQL in the Scenario. The comparison of the query plans, estimated I/O cost, abstract plans, Trace On information, and SQL Classification displays in the right pane of the Migration Analyzer window.
Once the analysis is complete, the best way to compare the behavior of the SQL in the analysis is to select the Scenario from the left tree structure.
Properties Button
The initial view is of the Properties of the Scenario and it gives a basic summary of the analysis including the configuration parameters that were specified as different between the databases.
Prognosis Button
The Prognosis section of an analysis is the best way to analyze the results to see how the performance of the SQL statements will be affected by the migration. The Prognosis has two tabs in the top pane that provide the overview of the impact of the migration on SQL performance: Chart and Summary. Specific information about the individual SQL statements displays in the middle and bottom panes.
Click any portion of the chart and the SQL statements represented are highlighted in the grid below the charts.
Chart Tab
Total Cost Chart
This chart shows the overall Estimated I/O cost differences of the SQL statements when connected to the current Adaptive Server instance and when connected to the destination Adaptive Server instance.
SQL with Cost Change Chart
This chart represents those specific statements whose query plans undergo a change in Estimated I/O cost. Click any portion of the chart and the SQL statements represented are highlighted in the grid below the charts.
SQL with Plan Structure Change Chart
This chart represents those statements that experience a structure change in their query plan, regardless of any cost changes.
Classification Changes Chart
This chart indicates any SQL statements whose query plans undergo a change in classification (Simple, Complex, and Problematic). The statements that experience degradation in performance would be the best statements to work with to optimize before migrating to the new Adaptive Server instance, since they are the statements that could potentially cause performance problems.
SQL Classification Chart
This chart gives the aggregate view of the classifications of the SQL statements in the analysis.
Summary Tab
Presents a summary of the analysis in text format showing the statistics that are used in the charts.
Configuration Parameters Button
Displays the configuration parameters for the destination Adaptive Server instance. For each parameter it displays current value and the old parameter value before the analysis. The Configuration Parameters pane is only displayed if changes to configuration parameters were specified for the destination instance during the migration analysis.
Apply Changes
Displays the script for making the configuration parameters changes on Adaptive Server. Press Execute
Add a Scenario
After creating a migration analysis, you can add more Scenarios to it. A Scenario can be added in two ways:
To add a Scenario
Method One
-
In the left pane, right-click the analysis and select Add Scenario.
-
In the Add Scenariowizard, click the Migration page and set the user connection information.
-
Click the Destination Configuration page and set the new database parameters.
Method Two
-
In the left pane, right-click and select New Analysis.
-
In the New Analysis wizard, select the Continuing an existing Analyzer using the Analyzer’s select SQL option.
-
From the Select Analyzer field, click the Analyzer name.
-
Click the Migration page and set the user connection information
-
Click the Destination Configuration page and set the new database parameters.