Quest® SQL Optimizer for Oracle

Version 8.8.1

Release Notes

August 09, 2013


Contents

Welcome to Quest SQL Optimizer

New in This Release

Resolved Issues and Enhancements

Known Issues

System Requirements Global Operations Getting Started For More Information

Welcome to Quest SQL Optimizer for Oracle

Quest SQL Optimizer for Oracle automates the SQL optimization process and maximizes the performance of your SQL statements. SQL Optimizer analyzes, rewrites, and evaluates SQL statements located within database objects, files, or collections of SQL statements from Oracle's System Global Area (SGA). Once SQL Optimizer identifies problematic SQL statements, it optimizes the SQL and provides replacement code that includes the optimized statement.

SQL Optimizer also provides a complete index optimization and plan change analysis solution. It provides index recommendations for multiple SQL statements or a SQL workload, simulates index impact analysis, and generates SQL execution plan alternatives.


New in This Release

This release of SQL Optimizer includes the following new features and enhancements.

New in Release 8.8.1

Support for New Oracle Database 12c Features

This release of SQL Optimizer includes support for the following new Oracle Database 12c features.

Optimize SQL

Integration with Toad for Oracle

User Interface

New in Release 8.8

Optimize SQL

New Rules and Syntax Support

Scan SQL

Analyze Impact

General

Execution Plan

Options

 

See Resolved Issues and Enhancements for a more complete list of issues resolved and enhancements implemented in this release.


Learn More

Remember, you can find blogs, videos, and forums at the SQL Optimizer for Oracle Community.


Resolved Issues and Enhancements

The following is a list of issues addressed and enhancements implemented in this release of SQL Optimizer.

Resolved Issues and Enhancements in Release 8.8.1

Feature Resolved Issue Defect ID
Analyze Impact The data point values on the Estimated Improvement graph now display correctly when all Reduced values are small and at least one Increased value is relatively very large. ST108002
Analyze Impact In the breadcrumb navigation (Summary > Impacted SQL), the first drop-down list displays correctly and the breadcrumb arrow no longer disappears after clicking it. ST109254
Analyze Impact The breadcrumb navigation has been enhanced to include a drop-down list to navigate directly to one of the other SQL list pages, such as "Number of cost difference only SQL." ST109258
Batch Optimize SQL The following issue has been resolved. When inputting the variable values for multiple bind variable statements, the following error displayed: "The given key was not present in the dictionary." ST110563
Connections The following issue has been resolved. When deleting a connection in the Connection Manager, all connections below the selected connection were unexpectedly deleted. ST109970
Manage Plans An issue that resulted in an "Object reference not set to an instance of an object" error while switching between Oracle 11g sessions after migrating a baseline plan has been resolved. ST109351
Optimize Indexes The following issue has been resolved: When defining an AWR workload, if the first connection is a non-12c database, an ORA-00904 error was encountered after selecting a 12c database as the second connection. ST109164
Optimize Indexes The auto-generated index names are now displayed in-full in the generated report. ST109190
Optimize SQL When optimizing a statement that includes a bind variable, in the Setting Bind Variables dialog if you add a function column, you can successfully assign a data type and variable value by double-clicking the function column value in the Data Browser pane. ST104613
Optimize SQL An issue that caused a "Failed to create new tuning lab" or "Failed to modify scenario" error after clicking the Close button when user has an unsaved (and not optimized) session open has been resolved. ST107591
Optimize SQL An issue that generated an "ORA-28605: bitmap indexes cannot be reversed" error when executing an index set that contains a Bitmap type index and an index with the Compress option specified has been resolved. ST109272
Optimize SQL This release supports SQL statements that include Oracle 12c row pattern matching syntax. ST107651
Optimize SQL The algorithm used to determine batch run order has been enhanced to increase the likelihood of finding the best alternative as quickly as possible. ST110356
Optimize SQL The following issue has been fixed: An "Object reference not set to an instance of an object" error displays when an account other than the one used to install SQL Optimizer is used and the user attempts to select a connection schema. ST110032
Scan SQL The following issues has been resolved. When scanning the SQL from an Inspect SGA job, the Status column displays "Scanning 1%" during the entire scanning process. ST109253
User Interface Instructions and input forms now display correctly in the left pane of the Support Bundle window when the Help improve SQL Optimizer for Oracle link is displayed. ST110230
User Interface This release includes several enhancements to accessibility in the SQL Optimizer user interface, including improved navigation using the Tab key, improved accessibility to links and drop-down lists, and implementation of shortcut keys. n/a

 

Resolved Issues and Enhancements in Release 8.8

Feature Resolved Issue Defect ID
Analyze Impact Index Impact: An issue that caused SQL with FAST DUAL step to be incorrectly identified as impacted SQL has been resolved. ST104645
Analyze Impact Impacts page: Data displayed below the Estimated Improvements chart include hyperlinks directly to SQL List. The breadcrumb on the SQL List page now includes a drop-down menu for easy navigation to other SQL lists. ST107836
Batch Optimize SQL After sending SQL from SQL Navigator to SQL Optimizer, the batch name in the Batch Optimize SQL window is now correctly displayed as "SQL Navigator." ST90079
Batch Optimize SQL This issue has been resolved: SQL statement sent to Optimize SQL from Batch Optimize SQL was not identical to the original. Occurred for certain statements. ST69981
Batch Optimize SQL An issue that did not allow Batch Optimize SQL to send SQL with a status of No alternative satisfied execution criteria to Optimize SQL has been resolved. ST104611
Batch Optimize SQL Batch Optimize, Scan SQL, and Inspect SGA: Right-click menu correctly includes Send to Analyze Impact option. ST104995
Connections Required privileges are now listed in a drop-down list in the Privileges column for each connection listed in the Connection Manager. You can click on a privilege in the list to view a description. ST102293
General An issue that resulted in an error when some users attempted to visit the download page when prompted by SQL Optimizer to update has been resolved. ST106212
General An issue that resulted in an error message when attempting to open the Check for Updates dialog (Help | Check for Updates) has been resolved. ST107058
General An issue that resulted in the error message "Input string was not in correct format" during application startup has been resolved. ST107448
General An issue that resulted in the error message "quest.tuning.oracle.common.tparacomm threw an exception " during application launch has been resolved. ST107168
Licensing For a license key that includes Exadata, the Exadata information now displays in License Details in the Licensing dialog. ST102604
Licensing The Retrieve License Key link in the Licensing dialog now has the correct URL. ST106756
Optimize Indexes The Projected Workload graph using Projected Actual Statistics view now displays correctly for Windows Locale/Regional settings that use something other than a decimal point. ST104648
Optimize SQL SQL Rewrite - You now have the option to instruct SQL Optimizer to rewrite SQL statements using the same JOIN syntax as the source SQL (this is now the default setting). ST40228
Optimize SQL When optimizing a SQL statement, SQL Optimizer will now rewrite a SELECT statement that is in a Set clause. ST51039
Optimize SQL An issue that prevented the user from sending SQL back to SQL Navigator in certain circumstances (after SQL was deleted in SQL Navigator or after SQL was sent once from SQL Optimizer) has been resolved. ST67219
Optimize SQL SQL Rewrite - The tool tip of the Send Back button has been modified to better describe its function: to send the selected SQL statement back to the original program. ST68455
Optimize SQL SQL Rewrite - After optimizing SQL, on the Compare tab, the best alternative is now correctly selected and highlighted green. And only the best alternative is highlighted green. ST104481
Optimize SQL SQL Rewrite - When deploying an outline from a SQL Rewrite alternative, the plan differences are clearly highlighted in the Deploy Outline dialog. ST104484
Optimize SQL SQL Rewrite - When creating a user Index (or Index for user-defined alternative), if you rename the index, the change is immediately reflected in the Index Script. ST104486
Optimize SQL SQL Rewrite - When deploying an outline from a SQL Rewrite alternative, in the Deploy Outline dialog, the plan view option buttons for each plan are now in-sync. ST104490
Optimize SQL In the Optimization settings (Options | Optimize SQL | Optimizer | Optimization), the Transform view to inline view options are correctly disabled if the option is not selected. ST104491
Optimize SQL After successfully executing valid SQL, the Actual Plan tab correctly displays the message "No Actual Plan available" when the SQL is modified to create an invalid SQL statement and then re-executed. ST104513
Optimize SQL SQL Optimizer supports execution (using the Run on Server option) of SQL statements that include columns with the XML Type data type. ST40234
Optimize SQL SQL Optimizer supports execution (using the Run on Server option) of SQL statements that include columns with the Object data type. ST40463
Optimize SQL You can now include multiple SQL alternatives in the Optimize SQL Resolution Report. In the Report window, click the Current Settings button to select which alternatives to include. ST100400
Optimize SQL Enhancement: Support for the function LNNVL in SQL statements. ST101518
Optimize SQL An issue that caused a mismatch between Number of Hints settings in the Intelligence and the Quota pages in Options | Optimizer SQL | Optimizer has been resolved. ST104548
Optimize SQL For SQL statements with multiple sub-queries, multiple sub-queries can be rewritten in an alternative SQL. Previously, only one sub-query could be rewritten. ST105654
Optimize SQL Rule: Move out conditions that are actually from outer level and not related to inner query. ST64397
Options The Join Tables syntax options can be modified when using the Predefined Intelligence Level. ST40300
Reports When using Simplified Chinese language setting for generated reports, the chart legends now display text in Simplified Chinese. ST102734
Scan SQL (Scan SQL and Inspect SGA) You can now successfully enter and save a comment using the User Comments column in the Group Manager dialog. ST69095
Scan SQL You can now change the name of each SQL statement in a group and add a comment for each statement. ST98304

 


Known Issues

The following is a list of issues known to exist at the time of this release.

Feature Known Issue Defect ID
General

If you select a non-default schema for a SQL statement in Quest SQL Optimizer and send it to Benchmark Factory, the default schema is preserved in the SQL statement and an error occurs when it is executed.

Workaround:

Select the appropriate schema in Benchmark Factory.

ST68829
Scan SQL and
Batch Optimize
When scanning a Performance Analysis repository, Scan SQL only extracts SQL statements with the resolution_type of 3 in the repository. ST77286
When you select the "Include Dependants" option while scanning database objects, only first level dependents are retrieved instead of all dependents. ST40625
Connecting
to Database

When the directory where Quest SQL Optimizer is installed has a directory path which contains parenthesis, connecting to Oracle fails when using a pre-11g client.

This is a known Oracle issue that we cannot fix. This problem is more common in 64-bit environment because the default directory for 32-bit applications is "C:\Program Files (x86)\".

Workaround:

Install Quest SQL Optimizer in a directory that does not have parenthesis or upgrade the Oracle client to 11g.

ST63421
Installation If you install SQL Optimizer version 8.8.1 (or later) and then do a side-by-side install of version 8.8.0, version 8.8.0 will fail to launch after it is successfully installed. ST111404
Installation

If you install SQL Optimizer 8.8.0 (or later) side-by-side with version 8.7.0, then uninstall version 8.7.0, version 8.8.0 (or later) will no longer integrate with other Toad products. This issue is found in side-by-side installations of 8.8 and either 8.5.0, 8.6.0, 8.7.0, or 8.7.1 that are of the same edition (i.e., both Commercial edition) and the same bitness (i.e., both 32-bit).

Workaround 1: Launch SQL Optimizer 8.8.0 (or later) from the short-cut on the Start menu.

Workaround 2: Uninstall SQL Optimizer 8.8.0 (or later) and reinstall it.

ST109347
Installation

Background: SQL Optimizer 8.7 (or later) does not support an upgrade from the 32-bit version to the 64-bit version (or 64-bit version to 32-bit version). If you attempt to upgrade by using the Quest Installer, you will receive the appropriate warning message and the installation will not proceed.

Issue: If you attempt to upgrade from the 32-bit version of SQL Optimizer to the 64-bit version (or from the 64-bit version to the 32-bit version) by using the .msi installer, you will not receive a warning message and the installation will appear to proceed. However, you will encounter an error upon launching the upgraded application.

Workaround:

To upgrade to a newer version of SQL Optimizer that has a different "bitness" (i.e., from 32-bit to 64-bit), you must first uninstall the previous version.

ST102226
Installation

A shortcut is not created in the Metro UI on Windows 8 and Windows Server 2012 for limited users in the following cases (when application is installed "for everyone"):

  • For a user that has never previously logged-in
  • For a new user created after installation
ST105153
Installation

A shortcut is not created in the Windows Start menu for limited users when upgrading or performing a side-by-side installation of Quest SQL Optimizer 8.5 or later.

Workaround:

Launch Quest SQL Optimizer from Windows Explorer.

ST76887
Installation

The CPM product key is not automatically entered when upgrading or performing a side-by-side installation of Quest SQL Optimizer 7.5 or later.

Workaround:

Manually enter CPM product key in licensing window.

ST73191
Installation

You cannot do a silent installation on a Windows Vista computer if the User Account Control (UAC) is set to ON.

Workaround:

Set the User Account Control to OFF.

  1. Log on to Vista with an Admin user.
  2. Select Start | Control Panel | User Accounts.
  3. Select Turn User Account Control on or off.
  4. Clear Use User Account Control (UAC) to help protect your computer.
  5. Restart the computer.
  6. Select Start | Run and enter cmd. Click OK.
  7. Enter msiexec /i "path to msi file\QuestSQLOptimizer_Oracle_version.msi" /qn.
  8. Follow steps 1-3 and then check Use User Account Control (UAC) to help protect your computer.

Note: On Windows 7 and 2008 64 bits R2, set the UAC level to Never Notify me When.

ST66341
Report

Unicode characters do not display correctly in the generated report.

Workaround:

For PDF: Select a font that contains the specific Unicode characters. Do this by modifying the font settings that apply to data grids and generated reports.

  1. Select Options | General | Appearance.
  2. Under Font Settings, in the Other Data drop-down list, select a font that contains the Unicode characters (for example, Arial Unicode MS).

For HTML and MHT: When exporting the report, select a Character set that contains the Unicode characters.

For CSV and Text: When exporting the report, select an Encoding option that supports the Unicode characters.

ST102639
Help Currently, you cannot enter Unicode characters in the Index or Search fields of the online help. ST71331
When searching the online help for information using the Search bar in Quest SQL Optimizer, topics display in the help window for exact matches found but the related index entry is not highlighted. ST71433

System Requirements

Before installing Quest SQL Optimizer for Oracle, ensure your system meets the following minimum hardware and software requirements:

Platform

1 GHz Processor

Memory

512 MB of RAM minimum, 768 MB of RAM recommended

Note: The memory required may vary based on the following:

  • Applications that are running on your system
  • Size and complexity of the database
  • Amount of database activity
  • Number of concurrent users accessing the database

Hard Disk Space

90 MB of disk space for installation

Note: The disk space required may vary based on options selected for installation.

Operating System

Microsoft Windows Server 2003 32-bit and 64-bit

Microsoft Windows XP Professional 32-bit and 64-bit

Microsoft Windows Vista 32-bit and 64-bit

Microsoft Windows Server 2008 32-bit and 64-bit

Microsoft Windows 7 32-bit and 64-bit

Microsoft Windows 8 32-bit and 64-bit

Microsoft Windows Server 2012

.NET Framework

Microsoft .NET Framework 4.0

Browser Microsoft Internet Explorer 6.0 or later
PDF Viewer Adobe Acrobat Reader 7.0 or later (for viewing the Installation Guide)
Database Client

Oracle SQL*Net

Oracle v8 Client (Net8)

Oracle v9 Client (Net9)

Oracle v10 Client (Net10)

Oracle v11 Client (Net11)

Oracle 12c Client

Oracle Instant Client

Database Server

Oracle 8.1.7, 9i, 10g, 11g R1, 11g R2, 12c

SQL Optimizer has been tested on Oracle Exadata 2.0 running Oracle database 11g R2.

Cloud Database Service Oracle databases running on Amazon EC2

Virtualization Support

Before installing SQL Optimizer, review the following for virtualization support:

Application Virtualization

SQL Optimizer has been tested with the following:

  • Citrix XenApp 5.0 on Windows Server 2003 (Service Pack 2) using the Citrix Presentation Server 4.0
  • Citrix XenApp 6.5 on Windows Server 2008 R2
Desktop Virtualization (VDI) SQL Optimizer has been tested with Quest vWorkspace 7.0 running on Windows XP Professional 32-bit (Service Pack 2).
Server Virtualization

SQL Optimizer has been tested with the following:

  • VMWare ESX Server 2.0.2 running on Windows XP Professional 32-bit (Service Pack 2) with Oracle 9i and 10g R2
  • Oracle VM 2.2.0 running on Oracle Enterprise Linux 5 Update 2 64-bit with Oracle 10g R2
  • Oracle VM 2.2.0 running on Oracle Enterprise Linux 5 Update 3 32-bit with Oracle 11g R1
  • Oracle VM 3.1.1 running on Windows Server 2008 R2 with Oracle 11g R2
  • Oracle VM 3.2.2 running on Oracle Linux Release 6 Update 4 Media Pack v1 for x86 (32-bit) with Oracle 10g R2.
  • Oracle VM 3.2.2 running on Windows Server 2008 R2 64-bit with Oracle 11g R1.
  • Oracle VM 3.2.2 running on Oracle Linux Release 6 Update 4 for x86_64 (64-bit) with Oracle 11g R2.

Note: SQL Optimizer may work in virtualization environments other than the ones in which it was tested.


Global Operations

This section contains information about installing and operating this product in non-English configurations, such as those needed by customers outside of North America. This section does not replace the materials about supported platforms and configurations found elsewhere in the product documentation.

This release is Unicode-enabled and supports any character set. It supports simultaneous operation with multilingual data. This release is targeted to support operations in the following regions: North America, Western Europe and Latin America, Central and Eastern Europe, Far-East Asia, Japan.

The release is localized to the following languages: Chinese (Simplified), Japanese, Korean.


Getting Started

Contents of the Release Package

The Quest SQL Optimizer for Oracle release package contains the following products:

  1. Quest SQL Optimizer for Oracle
  2. Product Documentation, including:

Installation Instructions

Refer to the Installation Guide for installation instructions.

Upgrade from Previous Release

SQL Optimizer 8.7 (or later) does not support an upgrade from the 32-bit version to the 64-bit version (or 64-bit to 32-bit). To upgrade from the 32-bit version of SQL Optimizer to the 64-bit version, please uninstall the previous 32-bit version. See ST102226 in the Known Issues section for more information.

Note: SQL Optimizer 8.7 (or later) supports side-by-side installation of versions with different "bitness" as long as they are also different releases (e.g., 8.6 and 8.7) or different editions (e.g., Commercial and Trial).


For More Information

Contact Quest Software

Email

info@quest.com

Mail

Quest Software, Inc.

World Headquarters

5 Polaris Way

Aliso Viejo, CA 92656 

USA

Web site

www.quest.com

See our web site for regional and international office information.

Contact Quest Support

Quest Support is available to customers who have a trial version of a Quest product or who have purchased a Quest product and have a valid maintenance contract. Quest Support provides unlimited 24x7 access to our Support Portal at www.quest.com/support.

From our Support Portal, you can do the following:

View the Global Support Guide for a detailed explanation of support programs, online services, contact information, policies and procedures. The guide is available at: www.quest.com/support.

Quest SQL Optimizer Community

Get the latest product information, find helpful resources, and join a discussion with the Quest SQL Optimizer team and other community members. Join the SQL Optimizer community at http://www.toadworld.com/products/sql-optimizer-for-oracle/default.aspx.


© 2013 Quest Software, Inc.
ALL RIGHTS RESERVED.

This guide contains proprietary information protected by copyright. The software described in this guide is furnished under a software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the applicable 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 purchaser’s personal use without the written permission of Quest Software, Inc.

The information in this document is provided in connection with Quest products. No license, express or implied, by estoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of Quest products. EXCEPT AS SET FORTH IN QUEST'S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT, QUEST ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL QUEST BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF QUEST HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Quest makes no representations or warranties with respect to the accuracy or completeness of the contents of this document and reserves the right to make changes to specifications and product descriptions at any time without notice. Quest does not make any commitment to update the information contained in this document.

If you have any questions regarding your potential use of this material, contact:

Quest Software World Headquarters
LEGAL Dept
5 Polaris Way
Aliso Viejo, CA 92656
email: legal@quest.com

Refer to our Web site (www.quest.com) for regional and international office information.

Patents

SQL Optimizer for Oracle contains patent pending technology.

Trademarks

Quest, Quest Software, the Quest Software logo, Simplicity at Work, Benchmark Factory, Foglight, LeccoTech, Quest vWorkspace, SQLab, Toad and T.O.A.D. are trademarks and registered trademarks of Quest Software, Inc. For a complete list of Quest Software’s trademarks, please see http://www.quest.com/legal/trademark-information.aspx. Other trademarks are property of their respective owners.