Toad® for Data Analysis

Version 2.0.0 

Release Notes

September 12, 2008


Contents

Welcome to Toad for Data Analysis

New in This Release Resolved Issues and Enhancements

Known Issues

Third Party Known Issues

System Requirements

Global Operations

Installation

For More Information

 


Welcome to Toad for Data Analysis

Toad for Data Analysis is a multi-platform database query tool built for anyone who needs to access data, understand data relationships, and quickly produce reports.

With Toad for Data Analysis, you can:

Toad for Data Analysis provides a full featured ER Diagrammer, Database Browser, Query Builder, and Editor for the following databases:

Most companies have additional databases that they need to connect to and query. To help achieve this, Toad provides basic connectivity, querying, and reporting functionality using the Microsoft Excel, Microsoft Access, and ODBC providers. The inclusion of these additional providers should address the reporting requirements for most companies.

The purpose of the ODBC provider is to offer basic connection and querying capabilities to any database that supports an ODBC 3.0 or later driver. For a list of databases tested with the ODBC provider, see the System Requirements. This form of connectivity allows connections to databases such as Teradata, Netezza, IBM iSeries, and Ingres. Because this form of connectivity is generic, it is not full-featured and may not be as robust as the fully exploited providers for the other databases.


New in This Release

Review the following sections for updates in this release and new features:

General

 Understand

DELETE

Opens a Drop object window.

F2

Renames an object without opening a Rename object window.

Query

General:

You can now reverse engineer queries from the Editor or Query Builder. For more information, see Reverse Engineer Queries in the help.

Query Builder:

Editor:

You can specify the backup interval in Tools | Options | Environment | General.

Code completion options are located in Tools | Options | Editor | Code Completion.

2005 MSSCCI Provider:  http://www.microsoft.com/downloads
/details.aspx?FamilyID=87e1ffbd-a484-4c3a-8776-d560ab1e6198&DisplayLang=en

 

2008 MSSCCI Provider:  http://www.microsoft.com/downloads/
details.aspx?familyid=FAEB7636-644E-451A-90D4-7947217DA0E7&displaylang=en

For more information about configuring TFS, see Configuration Prerequisites and in the help.

Report

General:

 

Export Data:

Import Data:

Automate

Select to File

Execute an existing SQL script or Query Builder query and export the results to an Excel, HTML, or CSV file.  You can then use additional activities to add the exported result file to a zip file, attach the file to an email, or copy the file.

Note: Bind variables are not supported for this activity. If bind variables are detected, a message alerts you during the test run of the automation script.

Execute SQL

Execute an existing SQL script or Query Builder query.

Note: Bind variables are not supported for this activity. If bind variables are detected, a message alerts you during the test run of the automation script.

Select to Editor with Results

Execute an existing SQL script or Query Builder query and save it and any results sets in a Toad editor file (.tef).

This file format is useful for building scripts that have large result sets that you do not want to continue executing or for saving results when you have not finished building a script.

Export Wizard

Export data from databases, tables, views, or query into a CSV, Excel, or other file. You can save the export settings as a template that you can use for scheduled automation scripts.

Import Wizard

Import data from a CSV, Excel, or other file into a new table or append to an existing table. You can save the import settings as a template that you can use for scheduled automation scripts.

Toad Pivot Grid

Refresh an existing Toad pivot grid and export results to a report. You can then use additional activities to add the pivot grid to a zip file, attach it to an email, or copy it.

Delete File

Delete one or more files from a specified location.

 

Tools

You can also save a result set and later use it for comparison. This is useful from the Database Explorer's Data tab when, over time, the data might be changing and can then be compared against this data that was saved.

 


Resolved Issues and Enhancements

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

Feature

Platform

Resolved Issue

Defect

Installation/
Upgrade

DB2

If you have multiple versions of Toad for DB2 or Toad for Data Analysis installed and you uninstall the product that was installed first, an error no longer occurs when you start up the other Toad products.

ST#42863

CR#228164

Connections

Access

You can now connect to an Access 2007 database (.accdb).

ST#48756

Automation

All

In some instances, a scheduled automation script indicated that an email was sent, but it was never received. Emails activities are now sent correctly in scheduled scripts.

ST#42974

All

You can now include execution steps in the body of the email or attach a log file to the email if logging is enabled.

ST#42943

CR#228671

All

Toad reports that require bind variable inputs are now supported.

ST#42253

CR#218790

All

If the user who scheduled an automation script is dropped, Toad now displays the task list so you can edit it. If the task list is incorrect, Toad now displays an error message and opens the Edit Task window.

ST#49282

Data Compare

 

 

All

You can now compare large sets of data, such as two million rows in a table, without running out of memory and receiving an error message.

ST#41609

CR#158211

Oracle

On an Oracle 9.2 client with NLS_LANG set to UTF8 only, Unicode characters are now supported.

ST#42241

CR#218641

Oracle

Attempting to synchronize data that contains a LONG RAW data type no longer results in a "System.OutOfMemoryException" error.

ST#42519

CR#223458

Database Browser/ Object Explorer

 

All

You can now right-click a selection of records, select Print, and the selection is properly printed.

ST#42578

CR#224949

All

Help no longer displays advanced topics that are not available in Toad.

ST#42917

DB2

Selecting options in Tools | Options | Explorer | Objects now works correctly. Previously, you could set options on this page initially, but subsequent changes resulted in an error.

ST#51101

ODBC-Sybase

When selecting the Data tab for a View, an error no longer displays.

ST#43592

ODBC- Informix

Expanding Views when connected to some Informix databases using ODBC no longer results in "An entry with the same key already exists" error.  

ST#50632

Oracle

If a function or procedure contains invalid columns, selecting the Function tab or the Procedure tab no longer results in an error.

ST#52025

Editor

All

The Apply to editor checkbox in Tools | Options | Database | General is now documented in the help. If you select this checkbox, any limitations you set for fetching data in the Data tab are also applied to the editor and Query Builder. By default, the editor and Query Builder fetch all data.

ST#47989

DB2

You can now execute the RUNSTATS command from the editor. 

ST#48131

Oracle

Attempting to execute a script using the Execute SQL Script in External Application icon on the toolbar no longer results in a QSR expired error.

Note: If you still receive this error, close Toad and rename your settings folder in C:\Documents and Settings\user\Local Settings\Application Data\Quest Software\Toad for Data Analysis 2.0. This issue should be resolved the next time you open Toad.

ST#46051

Oracle

You can now select SQL (Oracle) as the auto-replace language file in Tools | Options | Editor | Auto-Replace.

ST#44080

Export Wizard/ One Click Export

All

You can now export large data sets (tested with two million rows) to Excel.

ST#42321

CR#219754

ODBC

You can now use One Click Export to export to an Excel linked query.

ST#43035

ST#43425

ST#44078

Help

All

The link referencing the Custom Date and Time Format Strings topic on the Microsoft MSDN web site has been changed to the general web page so it does not break if the page location changes.

ST#49283

Query Builder

All

When sending a query that contains encrypted passwords to the editor, the passwords now execute correctly in the editor.

ST#44734

All

When a partially visible object is selected,  the diagram no longer refreshes so the entire object is visible.

ST#42801

CR#227645

All

Saving a query as a .tsm file, opening it, and then adding a table from another connection to create a heterogeneous query no longer results in an error.

ST#49072

DB2

Oracle

When you set the DateTime, Number, or Integer format in Tools | Options | Environment | Grid, it is now applied to the data grid.

ST#49068

ODBC

Executing a query to a PostgreSQL 8.0 database in the Query Builder no longer results in an error.

ST#49839

ODBC- SQL Server and Access

You can now create a heterogeneous query between an Access database and an ODBC connection to a SQL Server database that is case-sensitive.

ST#42770

CR#227341

Oracle

You can now add a Where clause on a calculated field in the Query Builder.

ST#51397

Oracle

Limited users can now specify an explain plan table to use when creating a new connection or by right-clicking an existing connection in the Navigation Manager and selecting Properties.

ST#43035

Oracle

You can now add Oracle synonyms to the Query Builder

ST#43933

Oracle

The NOT IN operator now adds parenthesis around the list of values or columns in a Where clause.

ST#52325

ST#51283

SQL Server

After opening a saved .tsm file that includes a view and a Where clause, attempting to edit the Where clause no longer results in an error.

ST#49693

Reports

All

You can now make minor changes to the underlying query in a Toad pivot grid. To edit the query, right-click in the data area of the pivot grid and select Edit Underlying Query.

ST#44732


Known Issues

The following is a list of issues known to exist at the time of Toad for Data Analysis release.

Feature

Platform

Known Issue

Defect

Installation/ Upgrade

All

Customized options selected in the Configuration wizard are not applied if you are running Toad as a Restricted user.

Workaround:
Customize these settings in the Options pages in Toad (Tools | Options from the menu).

CR#216699

ST#42154

Startup

All

(Windows Vista on Toad client only) If you initially start Toad when logged in as a standard user and enter a license key, the license key should be saved to:

C:\Program Files\Quest Software\Toad for SQL Server 2.0

However, a standard user does not have write privileges in Vista to C:\Program Files so the key is saved to the following directory instead: C:\Users\username\AppData\Local\VirtualStore\Program Files\Quest Software\Toad for SQL Server 2.0

If you later start Toad as an administrator, you are prompted to enter the key again because it is not in the C:\Program Files directory.

N/A

DB2

(Windows Vista on Toad client only) From the Client Configuration Wizard, when exporting the DB2 catalog profile as a standard user, the profile should be saved to:

C:\Program Files\Quest Software\Toad for Data Analysis 2.0

However, a standard user does not have write privileges in Vista to C:\Program Files so the catalog profile is saved to the following directory instead:

C:\Users\db2admin\AppData\Local\VirtualStore\Program Files\Quest Software\Toad for Data Analysis 2.0.

ST#52732

Connections DB2

On a multi-partitioned LUW database, although you specify a connection to a Coordinator node in the New Connection window, Toad connects the editor and Query Builder to the System Catalogue node instead.

Workaround:

  1. Locate the db2cli.ini configuration file in the DB2 Client directory, which sets defaults for the DB2 client. By default, the file is located in:
    C:\Program Files\Quest Software\Toad for Data Analysis 2.0\DB2 Client.

  2. Add the following to the db2cli.ini file:

    1. Add a semicolon to comment out the following node in the [COMMON] section:

[COMMON]
;ConnectNode = SQL_CONN_CATALOG_NODE

  1. Add the following line to the [COMMON] section:

[COMMON]
ConnectNode = SQL_CONN_COORDINATOR_NODE

Note: For more information, see "db2cli.ini initialization file" in the IBM DB2 LUW documentation.

ST#53860

Data Compare

Excel 2007

When comparing an Excel 2007 spreadsheet with another spreadsheet or database, the DateTime values indicate that they are different if the display format does not match because Excel 2007 DateTimes are loaded as string data.

ST#51743

Data Reports

All

Currently, you cannot crate a Label Report in the Toad Data Report wizard.

CR#215945

ST#42133

Export Wizard/ One Click Export

All

Binary data types cannot be exported in this release.

CR#170430

ST#41665

All

Currently, Excel is the only data export format that supports all national characters.

Workaround:

For export formats other than Excel, you must set the Default O/S character set to UTF-8 and set the File encoding field in the Export wizard to Unicode.

ST#49830

Import Wizard

 

All

Currently, you cannot import Excel 2007 files because they are saved using an xlsx format.

Workaround:
Save the Excel 2007 file as a 2003 compatible file before importing it.

CR#221667

ST#42416

All

Currently, Excel is the only data import format that supports all national characters.

Workaround:

For import formats other than Excel, you must set the Default O/S character set to UTF-8 and set the File encoding field in the Import wizard to Unicode.

ST#49831

Query Builder

All

When reverse engineering a query from the Query tab or the Editor, consider the following:

  • If the statement contains an Inner Join, when you click Visualize Query in the toolbar to open the Diagram tab, and then select the Query tab again, the Inner Join is changed to a Cross Join. This issue occurs because the parser returns an incorrect join type.

  • The Diagram tab does not support a SELECT clause where the columns are qualified with the database name.
    Workaround:
    When you visualize the query to display in the Diagram tab, Toad automatically creates calculated columns for the columns qualified with a database name. This allows you to execute the query and return the correct result set.

  • The Diagram tab does not correctly model a Group by clause on a calculated column. Instead, it applies the Group by clause to the original column.

For a complete list of considerations and limitations, see Reverse Engineer Queries in the help.

ST#52569

ST#49731

ST#48258

 


Third Party Known Issues

The following is a list of third party issues known to exist at the time of Toad for Data Analysis release.

Feature

Platform

Known Issue

Defect

Connections

Oracle

(Oracle 10.2.0.1 client only) Attempting to connect to an Oracle database From Toad using the 10.2.0.1 Oracle client results in the following error: “ORA-24909: call in progress. Current operation cancelled”. This is a known issue with this Oracle client (http://www.dbmotive.com/oracle_error_codes.php?errcode=24909).

Workaround:
Upgrade your Oracle client to a later version and connect to the Oracle database.

N/A

Oracle 11 only

When connecting to Oracle 11, you must enter the password in the proper case because passwords are case-sensitive.

CR#224546

Data Grid

ODBC- DB2 z/OS

In compatibility mode, the ODBC driver does not return enough information for the CommandBuilder to correctly generate update or insert statements.

N/A

Excel

All

If an Excel file is open in Toad, you cannot open the same file in a separate Excel instance. To review this and other limitations when using Excel in the Web Browser, see "Considerations When Using the WebBrowser Control" at: http://support.microsoft.com/kb/304662

CR#222833

ST#42486

Export Wizard/
One Click Export

All

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:  

2003 PIAs:

http://www.microsoft.com/downloads/details.aspx?FamilyID=3c9a983a-ac14-4125-8ba0-d36d67e0f4ad&DisplayLang=en
 

2007 PIAs:

http://www.microsoft.com/downloads/details.aspx?familyid=59DAEBAA-BED4-4282-A28C-B864D8BFA513&displaylang=en
 

CR#138239

Query Builder

 

Access and Excel

Currently, you cannot create a heterogeneous query between and Access database and an Excel spreadsheet. This is a known limitation of the component used. For a complete list of limitations when using heterogeneous queries, see Create Heterogeneous Queries in the help.

N/A

Excel

Currently, you cannot create a heterogeneous query between two or more Excel spreadsheets. This is a known limitation of the component used. For a complete list of limitations when using heterogeneous queries, see Create Heterogeneous Queries in the help.

N/A

 


System Requirements

Client Requirements

Before installing Toad for Data Analysis, ensure your client system meets the following minimum hardware and software requirements:

Platform 1 GHZ minimum
Memory

512 MB of RAM minimum, 1 GB recommended

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

  • Applications that are running on your system when using Toad
  • Size and complexity of the database
  • Amount of database activity
  • Number of concurrent users accessing the database
Hard Disk Space 204 MB of disk space to run Toad
Operating System

Windows 2000

Note: The Automation feature requires the .NET Framework 3.0, which is not supported on Windows 2000.

Windows 2003

Windows XP Professional (x86)

Windows Vista (x86)

Additional Software

.NET Framework
Microsoft .NET Framework 2.0 or later

Notes: Consider the following:

  • To run Toad, the .NET security policy must be set to unrestricted. For more information, see User Privilege Requirements.
  • To use the Automation feature, the .NET Framework 3.0 must be installed.

Web Browser
Microsoft Internet Explorer 6.0 or later


PDF Viewer

Adobe Acrobat Reader 7.0 or later (for viewing the Installation Guide)


Existing DB2 client support (DB2 native provider only)
Toad installs a DB2 9 client as part of the installation process. The DB2 9 client can co-exist with an existing DB2 8 client; however, it is incompatible with a DB2 7 client. If a DB2 7 client is already installed on the system, the Toad installation stops and cannot complete. You must upgrade to the DB2 8 client and restart the Toad installation to avoid losing functionality in some DB2 native tools.

Server Requirements

Before installing Toad for Data Analysis, ensure your server meets the following minimum hardware and software requirements:

Database Operating System

Oracle Native Provider

  • IBM AIX 5.1, 5.2, 5.3

  • HP-UX 11i 1.5, 2 (x86 or x64)

  • Red Hat Enterprise Linux AS release 3 and 4 (x86 or x64)

  • Solaris 7, 8, 9, 10 (x86 or x64)

  • SuSE 7, 8, 9

  • Windows 2003 (including x64)

  • Windows XP

SQL Server Native Provider

  • Windows 2000 Server with SP4 or later

  • Windows 2000 Professional Edition with SP4 or later

  • Windows 2003 Server (x86 or x64 with SP1 or later)

  • Windows XP (x86 with SP2 or later; x64)

  • Windows Vista (x86 or x64)

DB2 UDB for z/OS Native Provider

  • z/OS (V1R6 Base Services [5694-A01] or later)

DB2 UDB for LUW Native Provider

  • IBM AIX 5.1, 5.2, 5.3

  • HP-UX 11i 1.5, 2 (x86 or x64)

  • Red Hat Enterprise Linux AS release 3 and 4 (x86 or x64)

  • Solaris 7, 8, 9, 10 (x86 or x64)

  • SuSE 7, 8, 9

  • Windows 2000, 2003 (including x64), XP

MySQL Native Provider

  • Windows 2000 with SP4 or later

  • Windows 2003

  • Windows XP

Tested Databases Although Toad for Data Analysis supports connecting to almost any database via native and ODBC connections, only the following databases have been tested in this release.


Important: Toad supports ODBC database connections that use ODBC 3.0 driver specifications.

 

Oracle Native Provider

  • Oracle 9i
  • Oracle 10G
  • Oracle 11

SQL Server Native Provider

  • SQL Server 2000 with SP3
  • SQL Server 2005 with SP2

Note: Microsoft SQL Server Compact Edition is not supported.

DB2 UDB for z/OS Native Provider

  • DB2 UDB for z/OS 8.1 or later

Note: Toad supports DB2 for z/OS running in Full Function mode, but does not support DB2 running in Compatibility mode at this time.

DB2 UDB for LUW Native Provider

  • DB2 UDB for LUW 8.1.5 or later
  • DB2 UDB for LUW 9.0

MySQL Native Provider

  • MySQL 4.1.22
  • MySQL 5.0.41

Sybase ASE Native Provider

  • Sybase ASE 12.5
  • Sybase ASE 15.0.2

Access Provider

  • Access 2003
  • Access 2007

Excel Provider

  • Excel 2003
  • Excel 2007

DB2 for i5/OS ODBC

  • V5R4 (limited testing)

Informix ODBC

  • Informix Dynamic 10.00 (limited testing)

Ingres ODBC

  • Ingres Community Edition 2006 R2 (limited testing)

Teradata ODBC

  • V2R6.1 (limited testing)

Citrix Requirements

Toad has been tested for Citrix support on Windows Server 2003 Enterprise Server SP2 using the MetaFrame Presentation Server 4.0 and Citrix Presentation Server Clients 10.2. For information about installing Toad in a Citrix environment, see "Install Toad on Citrix Systems" in the Toad for Data Analysis Installation Guide.

User Privilege Requirements

The following user privileges are required for installing and running Toad for Data Analysis:

  1. From the Windows Start menu, select Settings | Control Panel.

  2. Double-click Administrative Tools.
  3. Double-click Microsoft .NET Framework 2.0 Configuration.
  4. Click + to expand My Computer, and then select the Runtime Security Policy node. A list of tasks for the node display in the right panel.
  5. Click Evaluate Assembly from the list of tasks in the right panel. An Evaluate an Assembly window displays.
  6. Browse to the location of Toad.exe in the File field.
  7. Click Next to view permissions for Toad.exe.
  8. Set the permission to Unrestricted.

 


Global Operations

For more information, see http://tda.inside.quest.com/shares/tda/sbin/docs/GlobalOps.htm

 


Installation

Contents of the Release Package

The Toad for Data Analysis release package contains the following products:

Installation Instructions

See the Toad for Data Analysis Installation Guide available from the Windows Start menu under Program Files | Quest Software | Toad for Data Analysis 2.0 | Documentation for important installation information. For information about installing Toad silently, see "Install Toad Silently" in the Toad for Data Analysis Installation Guide.

Notes: