Toad for MySQL 7.

9
Release Notes
Wednesday, July 13, 2016

Contents
About Toad for MySQL
New in This Release
Resolved Issues and Enhancements
Known Issues
Third Party Known Issues
System Requirements
Product Licensing
Global Operations
Getting Started
For More Information

About Toad for MySQL

With Toad for MySQL, developers and database administrators can use a familiar, proven tool to manage
databases. Toad empowers developers and administrators, of varying skill levels, to rapidly create and execute
queries, automate database object management and develop SQL more efficiently.
Toad for MySQL also provides utilities to compare, extract and search for objects, manage projects,
import/export data and administer the database, while increasing your productivity and delivering access to an
active user community.
Back to Top

Toad for MySQL 7.9

Release Notes

New Features
This release of Toad for MySQL includes the following new features and enhancements.

Automation
Run Automation Script Activity - Open Child Script

You can now open the child script directly from the Run Automation Script activity. Click the Open Script
button in Activity Input tab to open the child script in a new window.

Automation Script Settings

When you elect to send an email when a script errors, the script name is now included in the Subject line
of the error email.

Entering settings in an Email activity now auto-populates the same fields in the script's error email if those
fields are empty. The values in the To and From fields and in the Email Server Settings are the values sent
to the error email. Entering new values overrides the auto-populated settings.

You can now define a root path in both Test settings and Production settings. Then use the ROOT_PATH
variable in your script wherever you want to apply the path. The path applied depends on the setting you
select, Test or Production.

Set Variable Activity - Link SQL File

In the Set Variable activity, if you use a file to specify a SQL query for selecting values to populate a SQL
type variable, you now have the option to link the file to the activity. Select the Link SQL file check box.

Toad for MySQL 7.9

Release Notes

Loop Dataset Activity - Link SQL File

In the Loop Dataset activity, if you use a file to specify the driving query, you now have the option to link
the file to the activity. Select the Link SQL file check box.

Unique Default Variable Name

When you add an activity, then rename it, and then add another activity of the same type, the second
activity now has a unique default name for its built-in variable.

Individual Script Logs Display in Log Tab

The Log tab in each Automation script window now displays only the execution log for that individual
script, even if multiple script windows (documents) are open and executing.

Publish File Activity

This release includes a new Automation activity which allows you to publish one or more files to
Intelligence Central. You can publish files produced by previous activities in the Automation script, or you
can publish other existing files.

To use this activity, drag it to the script design area from the Automation toolbox.

Click Manage Files to select the files to publish. Click Publishing Wizard to select an Intelligence Central
connection and specify publishing options.

Toad for MySQL 7.9

Release Notes

Query Development
Editor
Automatic Syntax Checking Options

If you enable automatic syntax checking, you can now enable or disable displaying syntax errors in the
Results pane. Go to Tools | Options | Editor | Tools and select (or deselect) Show syntax check
messages in Results.

You can also instruct Toad to identify the lines with errors in the Editor. Go to Tools | Options | Editor |
Tools and select Highlight invalid lines in Editor.

Table Hint

In the Editor, you can place the cursor over a table name in a SQL statement to display the list of columns
in the table.

Toad for MySQL 7.9

Release Notes

Group Execute Pane. You can now specify a default setting to show or hide the Group Execute pane in the Editor
window. Go to Tools | Options | Editor | Tools and select Show Group Execute to show the pane by default.

Data Management
Pivot Grid

You now have the option to print the chart or graph when you print the pivot grid. After you right-click the
pivot grid and select Print, Toad prompts you to include the pivot grid's chart/graph.

Import and Export

Import Wizard

Import a table. In the Import Wizard, you can now select a table (or other database object) to import as a
new or existing table in the same datasource. Select the Add Table option in the Add Import Source page
of the wizard.

Optimize block size. When importing data, you can allow Toad to determine the optimal block size. In the
Import Wizard, select the Optimize block size option on the Select Target page. You can use this option as
an alternative to specifying a processing row count.

Toad for MySQL 7.9

Release Notes

Connections
Specify Active Connection on Startup

When you designate connections to automatically open when Toad starts, now you can designate one of
those as the active connection. In the Connection/Navigation Manager, right-click the connection and
select Properties. In the Connection Properties dialog, select Connect on Startup and then select Make it
the active connection on startup.
The last connection you specify in this manner overrides any connection you previously specified.

Idea Pond

Idea Pond is a site where you can submit your ideas to improve Toad and vote or comment on other
people's ideas. Toad's development has always been driven by our customers, and now it is even easier for
you to tell us what changes are most important. This site is free for all customers.

Got a great idea for a new Toad for MySQL feature or enhancement? Share it with the Development Team
and the Community by posting it on Idea Pond.

Visit Toad for MySQL Idea Pond where you can submit your ideas. You can also read and vote on the
enhancement ideas submitted by other users.

Back to Top

Toad for MySQL 7.9

Release Notes

Resolved Issues and Enhancements

The following is a list of issues addressed and enhancements implemented in this release of Toad for MySQL.
Feature

Resolved Issue or Enhancement

Defect ID

Automation

Enhancement: When you add an activity, then rename it, then add another activity
of the same type, the second activity now has a unique default name for its built-in
variable.

QAT-4193

Automation

An issue is resolved that prevented successful execution of a script when the script
includes an Export template that uses a query file with inline comments.

QAT-6905

Automation

Enhancement: In the Set Variable activity, when you use a SQL file to specify a
query to use for selecting values for a SQL-type variable, you can now link the SQL
file.

QAT-4917

Automation

Enhancement: The Log tab in each Automation script window now displays only the
execution log for that individual script, even if multiple script windows (documents)
are open and executing.

QAT-4342

Automation

Enhancement: In the Run Automation Script activity, you can now open the child
script from the Run Automation Script activity.

QAT-4789

Automation

In the Export Wizard activity, if the Export Wizard file uses an Automation variable
in the file name of the export file, the Export Wizard generates a file name without
unwanted single quotes, as expected.

QAT-6946

Automation

Enhancement: In the Loop Dataset activity, if you load SQL from a file, you can now
link the SQL file to the activity.

QAT-7016

Automation

Enhancement: When you select to send an email on script error, the script name is
now included in the Subject line of the error email.

QAT-3164

Automation

An issue that intermittenly caused one script to hang during compile when multiple
scripts execute is now resolved.

QAT-7199

Automation

Enhancement: You can now specify different root paths to be used in the Test and
Production script execution environments.

QAT-4919

Automation

An issue that caused an error when using the Set Variable Value activity in the Loop
Dataset activity is resolved.

QAT-7158

Connections

Enhancement: When several connections are specified to connect on startup, you

can now specify one as the active connection.

QAT-3814

Connections

Added a more informative message when a connection is lost and re-established by

Toad.

QAT-7483

Connections

Corrected an issue that resulted in an error when attempting to connect to a MySQL

database using a password that contains the double quote (") character.

TMY-64

Data
Compare

A WHERE clause added to the Data Compare document is now saved with the file as
expected. Applied formatting is now saved when results are exported to Excel.

QAT-7340

Data
Compare

Upon opening a saved Data Compare file, you now have the option to run the
comparison immediately or not.

QAT-7363

Data
Compare

Corrected an issue that prevented the user from opening a Data Compare file
created in a previous version of Toad for MySQL.

TMY-52

Editor

By default, syntax errors do not show in the Message tab of the Results pane. To
instruct Toad to show syntax errors in the Messages tab, select Tools | Options |
Editor | Tools.

TDB-2783

Toad for MySQL 7.9

Release Notes

Feature

Resolved Issue or Enhancement

Defect ID

Editor

With multiple Editor windows open, the show window list button now works as
expected.

QAT-7311

Export
Wizard

Resolved an issue that caused an "Incorrect syntax" error when running an Export
Wizard template in an Automation script.

QAT-7734

Export
Wizard

When exporting from a query or query file to a Fixed Column Width output,
specifying a fixed width size now works as expected.

QAT-7830

Export
Wizard

Exporting data to an existing Excel file containing a Pareto chart now works as
expected.

QAT-7338

Job Manager

In a Windows 7 or Windows 8 environment, enabling/disabling tasks from the Job

Manager window now works as expected.

QAT-6773

Library

When you open the Library window, it no longer associates to the active connection.

QAT-7075

Object
Explorer

In the Alter Table dialog Columns page, the Collation field for a column now displays
the current collation setting and the list of available collations, as expected.

QAT-7735,
TMY-66

Options

For users without Administrator privileges, selecting Tools | Options | Environment |

Extensions no longer causes a continuous series of messages that make the
application inaccessible.

QAT-6964

Pivot Grid

Enhancement: When printing a pivot grid, you how have the option to include the
chart or graph.

QAT-3143

Pivot Grid

When exporting to Excel from the Pivot Grid or a Toad Pivot Grid activity in an
Automation script, formatting is now retained.

QAT-7721

Query
Builder

Enhancement: After you click on a join in the diagram, Toad now gives you the
opportunity to confirm the action before analyzing the join and opening the Analyze
Join pane. This gives you the option to cancel an analysis which might take time to
process.

QAT-7334

Query
Builder

Retrieving the Explain Plan now works as expected.

QAT-7903,
TMY-63

Query
Builder

Enhancement: If an aggregate function is selected from the Query Builder column

drop-down, Toad now adds an alias to the column if one does not exist.

QAT-7069

Query
Builder

An issue that resulted in an incorrect WHERE clause after adding a table alias is now
resolved.

QAT-7276

Query
Builder

Resolved an issue that caused the Query Builder to add extra quotes to an alias after
adding an alias and then Visualizing the query.

QAT-7640

Schema
Compare

Corrected an issue that resulted in a "Filter string you provided is not valid" error
when attempting to save a Schema Compare file.

TMY-51

Schema
Compare

Attempting to use Schema Compare and connect to the database using an SSH
connection type now works as expected.

TMY-21,
QAT-8040

Session
Monitor

Corrected an issue that resulted in an error when attempting to select "Active" in

the drop-down list in the Session Monitor window.

TMY-25

Toad Views

Executing a Toad View that was saved in a subfolder now works as expected.

QAT-7290

User
Interface

Resolved several text display issues encountered when text size is set to 150% in
Windows. This resolution involves the Import Connections, Settings Migration, and
Options dialogs.

QAT-5915

User
Interface

Improved text displayed in the Where Condition dialog in the Query Builder when
using extended DPI settings.

QAT-6854

User
Interface

Improved display of text and options in the Export Wizard when using extended DPI
settings.

QAT-6851

Toad for MySQL 7.9

Release Notes

Feature

Resolved Issue or Enhancement

Defect ID

User
Interface

Print settings are now retained between sessions without requiring the user to open
the Page Setup dialog.

QAT-6051

User
Interface

If the Navigation Manager is minimized, it does not open after creating and saving a
new Export Template through the Automation activity, if "Save input files to project
manager" is not selected.

QAT-7764

User
Interface

Panes in auto-hide mode now collapse as expected when you click within an empty
window (no document open).

QAT-6784

Back to Top

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

Known Issue

Defect
ID

Installation

For some languages (languages using double-byte character encoding) specified using
the Current language for non-unicode programs option in the Windows Region and
Language dialog, the trademark symbols do not display correctly in the installer.

TDB-645

Schema
Compare

The timestamp column does not show differences when tables are updated.

ST95642

Data
Compare

Views do not display in the New Comparison Wizard.

ST95575

Debugger

When you debug a stored procedure, Toad inserts its own statement in the user's
Declare Cursor in both Procedure and Function causing a SQL error.

ST93716

Automation

There are some problems with Toad for MySQL running as administrator on Windows
7/Vista systems with UAC turned on and Outlook running.

ST80857

Workaround:
Either run Toad not as administrator or turn UAC off or close Outlook while opening
Automation and also every time you add Send Email activity in the designer.
Import
Wizard

Attempting to import data that was exported to an Excel instance where the fractional
seconds were truncated results in an error.

N/A

Library

A UAC setting at the highest level might interfere with the ability to drag a file to the
Library window (from Windows Explorer) to add it to the Library.

N/A

Workaround: Set UAC to the default level to enable adding a file by dragging it to the
Library window.

Back to Top

Toad for MySQL 7.9

Release Notes

Third Party Known Issues

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

Known Issue

Defect ID

Automation

Automation in MySQL 7.0 or later requires .NET Framework 4.5. If you are using .NET
Framework 4.0 without .NET Framework 4.5 (such as in Windows XP), you may
encounter the following:

N/A

After running a scheduled Automation script, Toad generates an error message

even though the script executes successfully.

Workaround: Upgrade your Windows OS to Windows 7 and install .NET Framework 4.5.
Currently, Korean characters are not supported.

ST41612

If the value of a TIME data type is greater than 24-hours, the value does not display
correctly.

N/A

Currently, geometry data types are not supported.

ST70327

Import
Wizard

Importing large data sets from Excel (approximately 650,000 rows) is not recommended
because of the amount of time it may take. This issue occurs because the Excel import
component maintains the output in memory until the import completes. This can cause
performance issues depending on the available system resources.

ST219754

Export
Wizard

To export to an Office 2003 or 2007 Excel instance, the Office Primary Interop
Assemblies (PIAs) must be installed. You can install the PIAs from one of the following
locations:

ST219754

Data

2003 PIAs:
http://www.microsoft.com/downloads/details.aspx?FamilyID=3c9a983a-ac14-41258ba0-d36d67e0f4ad&DisplayLang=en
2007 PIAs:
http://www.microsoft.com/downloads/details.aspx?familyid=59DAEBAA-BED4-4282A28C-B864D8BFA513&displaylang=en
Export
Wizard

Avoid using Excel for exporting if your data has numeric values that require a high
precision because Excel's precision is limited to 15 digits. If you export numbers with
more precision, the values are rounded. If you export boundary numbers (max, min),
rounded numbers will exceed the data type limit.

N/A

System Requirements
Client Requirements
Before installing Toad, ensure that your client system meets the following minimum hardware and software
requirements:
Requirement

Details

Platform

1 GHz minimum

Toad for MySQL 7.9

Release Notes

10

Requirement

Details

Memory

512 MB of RAM minimum, 1 GB recommended

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

Hard Disk
Space
Operating
System

Applications that are running on your system when using Toad for MySQL

Size and complexity of the database

Amount of database activity

Number of concurrent users accessing the database

800 MB to install Toad for MySQL

Windows Server 2008 R2 (64-bit)

Windows 7 (32-bit or 64-bit)
Windows 8 (32-bit and 64-bit)
Windows 8.1 (32-bit and 64-bit)
Important: Toad uses the Microsoft Distributed Transaction Coordinator (DTC) when opening a
SQL file to get Full-Text Search status, but DTC is disabled by default on Windows Vista,
Windows Server 2008 and Windows 7. If you are using either operating system, ensure that
Network DTC access is enabled on the Toad client. See http://technet.microsoft.com/enus/library/cc753510(WS.10).aspx for more information about enabling DTC access.

.NET
Framework

The Microsoft .NET Framework is required. The version is dependent on the operating system.
.NET 4.5

Windows Vista SP2, Windows 7, Windows 8, Windows Server 2008 (SP2 or

earlier), Windows Server 2008 R2, Windows Server 2012

.NET 4.0

Windows XP, Windows Vista (SP1 or earlier), Windows Server 2003

Notes:

Additional
Requirements

This information is provided to aid installation. Toad for MySQL is not

tested on Windows XP. Windows Vista (SP1 or earlier), and Windows
Server 2003.

The .NET Framework 4 Client Profile is not supported.

Web Browser
Microsoft Internet Explorer 6.0 or later

Server Requirements
Before installing Toad, ensure that your server meets the following minimum hardware and software requirements:
Requirement

Details

Database Server

MySQL 4.1, 5.0, 5.1, 5.5, 5.6

Clustrix 5.2
MariaDB 5.5.5

Cloud Database
Service

Toad for MySQL can manage Amazon RDS and any other cloud or service offering compatible
with MySQL, including Amazon Aurora.

Toad for MySQL 7.9

Release Notes

11

Virtualization Support
Requirement

Details

Application
Virtualization

Limited testing has been performed for Citrix XenApp 5.0 on Windows Server 2003 and
Citrix XenApp 6.5 on Windows Server 2008 R2.
Limited testing has been performed for Citrix support on Windows Server 2003 Enterprise
Server (Service Pack 2) using the MetaFrame Presentation Server 5.0 and Citrix Presentation
Server Clients 10.2.

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

User Requirements
User Requirements to Install Toad
Only Windows Administrators and Power Users can install Toad.
If an Administrator installs Toad, the Administrator can share the Toad shortcut icon on the desktop and menu
items with any usera Power User, Restricted User, Vista standard useron the computer.
If a Power User installs Toad, a Restricted User cannot do the following:

Associate file extensions.

View the Toad shortcut icon on the desktop or the Toad menu options in the Windows Start menu. As a
workaround, Restricted Users can create a shortcut to Toad from the install directory and place the
shortcut on their desktop.

User Requirements and Restrictions for Running Toad

The following describes the requirements and restrictions for users who launch and run Toad:

To create or modify the QuestSoftware.ToadSecurity table to enable Toad Security, the user who maintains
this table must have privileges to create, insert, update, and delete it. All other users need only the ability
to read the QuestSoftware.ToadSecurity table to use Toad Security features.

Back to Top

Product Licensing
This product does not require licensing.

Toad for MySQL 7.9

Release Notes

12

Getting Started
Contents of the Release Package
The Toad for MySQL release package contains the following products:
1.

Toad for MySQL

2.

Product Documentation, including:

Installation Guide

Online Help

Release Notes

Installation Instructions
For installation instructions, see the "Toad for MySQL Installation Guide" found at:
http://documents.software.dell.com/toad-for-mysql/

Globalization
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.
This release has the following known capabilities or limitations: No known limitations.

For More Information

Get the latest product information, find helpful resources, and join a discussion with the Toad for MySQL team and
other community members. Join the Toad for MySQL Community at http://www.toadworld.com/products/toadfor-mysql/default.aspx.
To view Release Notes for previous versions, visit http://documents.software.dell.com/toad-for-mysql/.

Contact Dell
Dell listens to customers and delivers worldwide innovative technology, business solutions and services they trust
and value. For more information, visit www.software.dell.com.
For sales or other inquiries, visit http://software.dell.com/company/contact-us.aspx or call 1-949-754-8000.

Technical Support Resources

Please be advised before installing: Toad for MySQL is an official Dell Software Inc. Freeware Product. This license
does not entitle Licensee to receive technical support from Dell .
Get the latest product information and find helpful resources at the Toad for MySQL Community at
http://toadformysql.com/index.jspa.
Toad for MySQL 7.9
Release Notes

13

 2016 Dell Inc.

ALL RIGHTS RESERVED.
This product is protected by U.S. and international copyright and intellectual property laws.
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 purchasers personal use without the written permission of Dell Inc.
The information in this document is provided in connection with Dell 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 Dell products. EXCEPT AS SET FORTH IN THE TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT
FOR THIS PRODUCT, DELL 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 DELL 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 DELL HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES. Dell 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. Dell 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:
Dell Inc.
Attn: LEGAL Dept
4 Polaris Way
Aliso Viejo, CA 92656
Refer to our web site (software.dell.com) for regional and international office information.
Trademarks
Dell, the Dell logo, Quest, SQL Navigator, vWorkspace, and Toad are trademarks of Dell Inc. and/or its affiliates.
Microsoft, Windows, Windows Server, Windows Vista, Visual Studio, SharePoint, Access and Excel are either
registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Oracle
is a trademark or registered trademark of Oracle and/or its affiliates in the United States and other countries.
Citrix and XenApp are trademarks of Citrix Systems, Inc. and/or one or more of its subsidiaries, and may be
registered in the United States Patent and Trademark Office and in other countries. MySQL is a registered
trademark of MySQL AB in the United States, the European Union and other countries. Subversion is a trademark of
the Apache Software Foundation. Other trademarks and trade names may be used in this document to refer to
either the entities claiming the marks and names or their products. Dell disclaims any proprietary interest in the
marks and names of others.

Back to Top

Toad for MySQL 7.9

Release Notes

14