Dell 4.1 Toad Data Point Installation Guide
Toad Data Point 4.1 is a powerful database development and administration tool that provides a comprehensive set of features for managing your databases. This document provides instructions for installing Toad Data Point on your system, including required system and database server requirements.
Advertisement
Advertisement
Toad™ Data Point 4.1
Installation Guide
© 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 purchaser’s 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.
Patents
This product includes patent pending technology.
Trademarks
Dell, the Dell logo, Quest, LiteSpeed, SQL Navigator, vWorkspace, and Toad are trademarks of Dell Inc. and/or its affiliates. Microsoft, Windows, Windows Server, Windows
Vista, Visual Studio, SQL Server, 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. SAP is the registered trademark of SAP AG in
Germany and in several other countries. IBM and DB2 are registered trademarks of
International Business Machines Corporation. MySQL is a registered trademark of MySQL
AB in the United States, the European Union and other countries. Google and Google
Analytics are registered trademarks of Google Inc. PostgreSQL is a registered trademark of the
PostgreSQL Community Association of Canada. 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.
Toad Data Point 4.1
Installation Guide
Wednesday, November 09, 2016
Table of Contents
Installation
System Requirements
Install Toad
Troubleshoot Installation Errors
Specify Application Data Directory Location
Read-Only Installation
Additional Considerations and Limitations of Read-Only Install
Install Toad Silently
Determine Which Installer to Use
Silent Installation Prerequisites
Silent Installation Using the Executable
Silent Installation Using the Microsoft Installer
Install Toad on Citrix® Systems
Upgrade Toad
Upgrade Automation Scripts and Scheduling Tasks
Upgrade Automation Scripts to Newer Version of Toad
Migrate Scheduling Tasks to Newer Version of Toad
Files Migrated During Upgrades
Uninstall Toad
Licensing
Notes for Toad Data Point Users
Configure Toad Layout
7
14
15
7
17
18
25
26
26
28
30
31
32
Toad Data Point Installation Guide
Table of Contents
Create Connections
Understand Toad Connections
Sharing a Connection Among Windows
Create Access Connections
Considerations and Limitations
Create SAP Business Objects Connections
Configure DB2 Client Connections
If You Previously Used the Toad DB2 Client
Configure DB2 Client Connections
Maintain DB2 Client Connections
Configure DB2 LDAP Support
Create Toad Connection Profiles for DB2
If You Previously Used the Toad DB2 Client
Create Excel Connections
Considerations and Limitations
Create Google Analytics Connections
About Google Analytics Connections
Create Google Analytics Connections
Create Hive Connections
Create a Connection to Intelligence Central
Limitations of Using Windows Authentication
Create MySQL or MariaDB Connections
Create ODBC Connections
4
52
55
43
51
59
61
38
38
39
41
63
67
68
Toad Data Point Installation Guide
Table of Contents
Configure Oracle LDAP Support
Create Oracle Connections
Client Connection or Direct Connection
Configure the Oracle Instant Client
Create Oracle Business Intelligence Connections
Create Salesforce Connections
Important Notes about Salesforce Connections
Create SQL Server and SQL Azure Connections
Create SQL Server Analysis Services Connections
Connect to SQL Server Analysis Services
Create SAP Connections
Create SAP HANA Connection
Create Teradata Connections
Troubleshoot Connections
Troubleshoot Access Issues
Missing Functionality and Object Information
Troubleshoot Excel® Issues
Opening Excel Files in Toad Document Window
Troubleshoot DB2 LUW Issues
Troubleshoot DB2 z/OS Issues
5
81
82
83
85
88
91
88
88
94
71
71
75
76
79
Toad Data Point Installation Guide
Table of Contents
Missing Functionality or Object Information
Troubleshoot Informix Issues
Troubleshoot MySQL Issues
Missing Functionality or Object Information
Troubleshoot Oracle Issues
Missing Functionality and Object Information
Troubleshoot SQL Server® Issues
Troubleshoot SAP Issues
Missing Functionality or Object Information
Configure Version Control
Version Control for Toad Files
About Dell
Contact Dell
Technical Support Resources
Index
6
100
102
98
99
97
103
103
107
107
107
109
1
Installation
System Requirements
Review the following client and database server requirements for Toad™ Data Point.
Client Requirements
Before installing Toad, ensure that your client system meets the following minimum hardware and software requirements:
Requirement
Platform
Memory
Hard Disk
Space
Operating
System
Details
2 GHz Processor (recommended minimum)
4 GB of RAM minimum, 8 GB recommended
Additional RAM Requirements: Using Local Storage, Cross-
Connection Query, Business Intelligence connections, or NoSQL connections can require an additional 500 MB of RAM. These features start processes (mysqld.exe, hubproxy.exe) which persist for the Toad session.
Note: The memory required may vary based on the following: l
Applications that are running on your system when using Toad l
Size and complexity of the database l
Amount of database activity l
Number of concurrent users accessing the database
800 MB to install Toad
450 MB to run Toad
Windows Server® 2008 (32-bit or 64-bit)
Windows Server® 2012
Windows Server® 2012 R2
Windows® 7 (32-bit or 64-bit)
Windows® 8 (32-bit and 64-bit)
Windows® 8.1 (32-bit and 64-bit)
Windows® 10
Toad Data Point Installation Guide
Installation
Requirement
.NET
Framework
Additional
Software
Details
The Microsoft® .NET Framework is required. The version is dependent on the operating system.
.NET 4.5 or later
.NET 4.5
Windows 10
.NET 4.0
Windows Vista SP2, Windows 7, Windows 8,
Windows Server 2008 (SP2 or earlier), Windows
Server 2008 R2, Windows Server 2012
Windows XP, Windows Vista (SP1 or earlier),
Windows Server 2003
Notes:
l
This information is provided to aid installation. Toad is not tested on
Windows XP. Windows Vista (SP1 or earlier), and Windows Server 2003.
l
The .NET Framework 4 Client Profile is not supported.
Teradata® .NET Data Provider
You must install the Teradata .NET Data Provider (13.10 or later) to use a Teradata native connection in Toad.
Note: To use a Teradata connection in a cross-connection query, you must also install a Teradata (13.10 or later) ODBC driver.
Visual C++ Redistributable for Visual Studio 2015. This software is required. It is included in installation using the .exe installer. If using the .msi installer, ensure that this software is installed prior to installation. See Visual C++ Redistributable for VS 2015 .
Prerequisites for the 2015 Redistributable—If you encounter a
"Microsoft Visual C++ 2015 Redistributable is not installed correctly" error during Toad installation, do the following:
1. Uninstall the Microsoft Visual C++ 2015 Redistributable using the Control Panel.
2. Install the missing prerequisite software. See Universal C
Runtime Update Prerequisites or use one of the following links: l
For Windows 7 or Windows Server 2008 R2, install
Service Pack 1: https://support.microsoft.com/enus/kb/976932 .
l
For Windows RT 8.1, Windows 8.1, or Windows Server
2012 R2, install the April 2014 update:
8
Toad Data Point Installation Guide
Installation
Requirement
Database
Client
Additional
Requirements
Details
https://support.microsoft.com/en-us/kb/2919355 .
l
For Windows Vista or Windows Server 2008, install
Service Pack 2: https://support.microsoft.com/enus/kb/948465 .
3. Run the ToadInstaller.exe again.
DB2® Client
Toad no longer installs a DB2 Client along with the Toad application.
For full functionality when connecting to a DB2 database, ensure that you have a DB2 Client installed. Toad supports DB2 Client versions
9.7.6 through 10.5.
Oracle® Client
Toad can connect to Oracle using Direct Connect (no Oracle Client required) or using an Oracle Client or Oracle Instant Client. However, if you want to use LDAP, you must install an Oracle Client. Toad supports 9i or later Oracle Clients and Oracle Instant Clients.
Notes:
l
You cannot use Oracle Direct Connection in a crossconnection query.
l
To use an Oracle connection in a cross-connection query, you must install an Oracle Client (full install) or you must install the Oracle Instant Client plus the Oracle ODBC driver.
Web Browser
Microsoft® Internet Explorer® 6.0 or later
Screen
Toad supports screen resolutions up to 3200 x 1800 and display DPI settings up to 150%.
Server Requirements
Before installing Toad, ensure that your server meets the following minimum hardware and software requirements:
Requirement
Native
Database
Server
Details
Toad supports the following databases:
Oracle 9i, 10g, 11g, 11g R2, 12c
Toad has been tested on Oracle Exadata 2.0 running Oracle database
11g R2.
Limited support of SQL Server® 2000 (Service Pack 3 or later)
9
Toad Data Point Installation Guide
Installation
Requirement
ODBC
Database
Server
Details
SQL Server 2005 (Service Pack 2 or later) and SQL Server 2005
Express
SQL Server 2008 and SQL Server 2008 Express
SQL Server 2008 R2 and SQL Server 2008 R2 Express
SQL Server 2012 and SQL Server 2012 Express
SQL Server 2014 Enterprise and SQL Server 2014 Express
Notes:
l
SQL Server Compact Edition is not supported.
l
Storage Management is not available on SQL Server Express.
IBM DB2 for LUW 9.5, 9.7, 10.1, 10.5, 10.5.0.5
IBM DB2 for z/OS 9, 10, 11
Note: Toad may support IBM DB2 Express and SWE in addition to listed above servers, but note that no testing was performed on it.
Note: Windows 8, 10 and Windows Server 2012 require the following
Fix Pack in order to ensure registration of DLLs in Global Assembly
Cache:
IBM DB2 LUW 10.5 Fix Pack 4
IBM DB2 LUW 10.1 Fix Pack 4
IBM DB2 LUW 9.7
Fix Pack 10
MySQL 4.1, 5.0, 5.1, 5.5, 5.6
MariaDB 5.5.5 (using MySQL provider)
SAP ASE 12.5.4, 15.0.2, 15.0.3, 15.5, 15.7, 16
SAP IQ 15, 16
SAP SQL Anywhere 12
SAP HANA SPS 08, SPS 09, SPS 10, SPS 11
Teradata 12.0, 13.0, 13.10, 14, 15
Access® 2003, 2007, 2010, 2013, 2016
Note: To use Access 2016 64-bit to connect to an Access database in
Toad, the Microsoft Access Database Engine is required and might not be included in the Access installation. The engine must match the architecture (bitness) of Toad.
Excel® 2003, 2007, 2010, 2013, 2016
Note: To use Excel 2016 64-bit to connect to an Excel or .csv file in
Toad, the Microsoft Access Database Engine is required and might not be included in the Excel installation. The engine must match the architecture (bitness) of Toad.
Toad Data Point allows you to create a connection to a database that supports an ODBC 3.0 or later driver. ODBC connectivity provides basic querying capability, but may not be as full-featured as a native
10
Toad Data Point Installation Guide
Installation
Requirement
Cloud
Database
Service
Business
Intelligence
Connections
NoSQL
Connections
Details
connection in Toad. Toad has been tested on the following databases, using an ODBC connection: l
DB2 for i5/OS V5R4 and IBM i 6.1
l
Greenplum® Database l
Informix Dynamic 10.00, 11.0 (limited testing) l
Ingres Community Edition 2006 R2 on Windows 32-bit
(limited testing) l
Netezza Data Warehouse Appliance 4.6.6, 6.0, 7.0
l
PostgreSQL® 8.3.4
l
Vertica 4.1, 5.0, 5.1 (with 4.0, 4.1 ODBC driver), 6.0 (with 6.0
ODBC driver), 6.1, 7.0
Note: For a list of databases that are not supported, see Known Issues in the Release Notes.
Oracle databases running on Amazon EC2
SQL Azure
Note: To be able to utilize a majority of Toad functionality, please grant VIEW DEFINITION on the SQL Azure databases you want to work with.
SQL Server databases running on Amazon EC2
Toad can manage Amazon RDS and any other cloud or service offering compatible with MySQL.
Toad has been tested with, and supports, the following Business
Intelligence platforms:
SAP Business Objects XI 3.0, 3.1, 4.1
Oracle Business Intelligence Enterprise Edition 10g, 11g
Salesforce.com®
Microsoft SQL Server Analysis Services
Google Analytics™
Azure Data Market
OData
SharePoint®
Toad has been tested with, and supports, the following NoSQL platforms:
Azure Table Services
Apache Cassandra™
Amazon DynamoDB
11
Toad Data Point Installation Guide
Installation
12
Requirement Details
Apache HBASE™
Apache Hive™
Cloudera Impala—Toad Data Point has been certified by Cloudera.
MongoDB™
Virtualization Support
Requirement
Application
Virtualization
Details
Limited testing has been performed for Citrix® XenApp™ 5.0 on
Windows Server 2003 and Citrix XenApp 6.5 on Windows Server
2008 R2.
See "Install Toad on Citrix® Systems" (page 25) for more information.
Toad has been tested with vWorkspace™ 7.0 running on Windows
XP Professional 32-bit (Service Pack 2).
Desktop
Virtualization
(VDI)
Server
Virtualization
Toad has been tested with the following: l
Oracle VM 3.1 running on Red Hat Enterprise Linux 64-bit with Oracle 11gR2 l
Oracle VM 2.2 running on Windows 2008 32-bit with Oracle
11gR2
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.
Note: The following exceptions exist for Power Users: l
A Power User cannot install Toad on a computer running Windows Vista Enterprise.
This is a Windows limitation because Vista does not support Power User mode.
l
(DB2 only) A Power User can install Toad as long as this user belongs to the
DB2ADMNS or DBUSERS group.
If an Administrator installs Toad, the Administrator can share the Toad shortcut icon on the desktop and menu items with any user—a Power User, Restricted User, Vista standard user— on the computer.
Toad Data Point Installation Guide
Installation
13
If a Power User installs Toad, a Restricted User cannot do the following: l
Associate file extensions.
l
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: l
(DB2 only) A Windows Power User or Restricted User must belong to the
DB2ADMNS or DB2USERS group. To add the user to one of these groups, select
Start | Control Panel | Administrative Tools | Computer Management | System
Tools | Local Users and Groups | Groups | DB2ADMNS or DB2USERS.
l
(DB2 only) A Windows Vista user must be either an administrator or a standard user that belongs to an Vista Administrators group. Additionally, to enable full functionality in Toad when Vista’s User Access Control security feature is turned on, the standard user must run Toad as an administrator. (Right-click the Toad icon on the
Vista desktop and select Run as administrator.) l
(DB2 only) A Windows Power User or Restricted User does not have the authority to add or remove DB2 catalog entries using the Toad Client Configuration wizard.
However, these users can use the Import Profile function in the Toad Client
Configuration wizard to import catalog entries to Toad.
l
(DB2 only) To take full advantage of Toad for DB2 LUW functionality, the user ID specified in the Toad connection profile for each DB2 for LUW database connection requires the authorizations listed in the following document:
ToadDB2LUWAuthorizations.xls
l
(DB2 only) As a minimum requirement to manage a DB2 for z/OS subsystem in Toad, the user ID defined in the Toad connection profile for the subsystem must either have
SYSADM privileges or SELECT privileges on the DB2 catalog tables. For a complete list of authorizations (and corresponding GRANT statements) a user requires to take full advantage of Toad for DB2 z/OS functionality, refer to the following document:
ToadDB2zOSAuthorizations.doc
l
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.
Toad Data Point Installation Guide
Installation
14
Install Toad
Beginning with release 3.2, Toad™ Data Point is available in two editions: Base and
Professional.
Beginning with release 4.1, Toad Data Point is available in a 64-bit version, as well as a 32bit version.
To install Toad
1. Run the ToadInstaller.exe.
For individual installation, the .exe file is recommended. The Microsoft Visual C++
2015 Redistributable is required by Toad. This software is included in the installation when using the .exe file, but not when using the .msi file. Please ensure Visual C++
Redistributable for VS 2015 is installed prior to installation using the .msi file. See
MSI Prerequisites (page 21) for more information.
For help with installation errors, see Troubleshoot Installation Errors (page 15).
2. If you are running the combined installer in a 64-bit environment, on the Choose
Installer page, select the version to install: 32-bit or 64-bit.
Note: Install 32-bit Toad if you intend to use a 32-bit ODBC driver.
3. Complete the wizard. Review the following for additional information.
Install Wizard
Page
Destination
Folder
Install Type
Description
Select a destination folder or use the default.
Typical Install—Select to install Toad normally.
Read-only Install—Select to install Toad as a read-only
application. See "Read-Only Installation" (page 17) for more information.
Side-by-side Installation
Toad Data Point 4.1 (or later) supports side-by-side installation of versions with different architecture (bitness) as long as they are also different releases (e.g., 4.0 and 4.1) or different editions (e.g., Commercial and Beta).
For example, you could install the following side-by-side: l
A 32-bit 4.1 Commercial edition and a 64-bit 4.1 Beta edition l
A 32-bit 4.0 Commercial edition and a 64-bit 4.1 Commercial edition
Toad Data Point Installation Guide
Installation
15
Troubleshoot Installation Errors
Error Message: The Microsoft Visual C++ 2015 Redistributable is not installed correctly
You might encounter this error if the prerequisites for the Microsoft Visual C++ 2015
Redistributable are not installed prior to installing Toad. If you encounter this error, do the following:
1. Uninstall the Microsoft Visual C++ 2015 Redistributable using the Control Panel.
2. Install the missing software. See Universal C Runtime Update Prerequisites or use one of the following links: l
For Windows 7 or Windows Server 2008 R2, install Service Pack 1: https://support.microsoft.com/en-us/kb/976932 .
l
For Windows RT 8.1, Windows 8.1, or Windows Server 2012 R2, install the
April 2014 update: https://support.microsoft.com/en-us/kb/2919355 .
l
For Windows Vista or Windows Server 2008, install Service Pack 2: https://support.microsoft.com/en-us/kb/948465 .
3. Run the ToadInstaller.exe again.
Specify Application Data Directory Location
Toad Data Point 4.1 stores settings files in the user's Application Data directory. The default location cannot be modified from within the application. Toad provides two methods to change the default location: by using a Registry setting or by using a command switch in a
Toad shortcut.
Use the Registry setting method to change the application data directory from Roaming to
Local. Use the command switch method to change the location to any new path.
To change Toad Application Data directory location from Roaming to Local
In the Registry under Toad Data Point (Computer\HKEY_CURRENT_USER\Software\Quest
Software\Toad Data Point\4.1), add LOCALSETTINGS with a value of 1.
See the following table for default (Roaming) and resulting (Local) directory path.
Toad Data Point Installation Guide
Installation
16
Caution: All current Toad settings will be lost after applying this Registry setting unless you manually copy the settings files from the default location (Roaming directory) to the new location (Local directory). Copy the settings files BEFORE you add the Registry setting and
BEFORE opening Toad.
Operating System
Default Location
Windows Vista
Windows Server 2008
Windows 7
Windows 8
C:\Users\username\
AppData\Roaming\Quest
Software\Toad Data Point
4.1
New Location when
LOCALSETTINGS = 1
C:\Users\username\
AppData\Local\Quest
Software\ Toad Data Point
4.1
To change Toad Application Data directory location using a command-line switch
You can override the default Application Data directory by running Toad with the command switch:
Toad.exe --datadir="YourNewDirPath"
To instruct Toad to always use the new directory path, add the command switch and the new directory path to a Toad desktop shortcut. Then use the desktop shortcut when opening Toad.
1. To add the command switch, right-click the Toad shortcut and select Properties.
2. Enter the command switch and add the directory path in quotes (replace
"YourNewDirPath" with your directory path).
Toad Data Point Installation Guide
Installation
17
Read-Only Installation
During installation, you can select an option to install Toad as a read-only application. This lets you query data and view objects using Toad, but all actions that can impact the database
(Create, Alter, Drop, Insert, Update, etc.) are disabled or hidden. This ensures that you can use
Toad without worrying about committing a change to a sensitive production instance. The following image shows an example of the differences between a typical and a read-only installation:
To install a read-only version of Toad Data Point
1. During installation, select the Read-only option.
To change an existing installation to read-only
1. Reinstall Toad and select Read-only Install on the Install Type page.
Additional Considerations and Limitations of Read-Only
Install
Review the following additional considerations/limitations before using a Toad read-only installation.
Toad Data Point Installation Guide
Installation
18
Consideration/Limitation
Additional limitations for IBM DB2 z/OS connections
When using an IBM DB2 z/OS connection in a read-only install of Toad, please note the following additional limitations: l
The Dependencies, Grants, and Script tabs in the Database Explorer
(Viewer) are not available.
l
The Clone Tables node/tab in the
Object Explorer is not available.
l
The user does not have SQL access to
SYS<xxx>AUTH tables.
Install Toad Silently
Silent installation provides a convenient method for deploying Toad to multiple machines.
With some customization, you can also deploy the license key and settings at the same time.
Determine Which Installer to Use
Before performing a silent installation, review the following to determine which installer to use:
Installer
Executable file (.exe)
Microsoft
Installer file
(.msi)
Advantages
Silent installation using the .exe
file has the following advantages: l
Verifies whether the prerequisite software is installed, and if not, redirects you to the download location.
Supports deployment of Toad settings files and license keys.
Disadvantages
Silent installation using the .exe
file has the following disadvantages: l
Cannot deploy custom
Toad settings files or license keys.
l
Installer automatically exits if the prerequisite software is not installed.
Silent installation using the .msi
file has the following disadvantages: l
Requires manual verification and download of any prerequisite software.
Toad Data Point Installation Guide
Installation
19
Installer Advantages Disadvantages
l
Requires a manual uninstall of the previous version of Toad using
Add/Remove Programs.
Silent Installation Prerequisites
Before you can perform a silent installation, the following software must be installed on every computer where you are installing Toad: l
Microsoft .NET Framework 4.5
l
(Installation using .msi Microsoft installer only) Visual C++ Redistributable for Visual
Studio 2015. See Visual C++ Redistributable for VS 2015 for downloads. See
KB2999226 - Update for Universal C Runtime in Windows for additional information.
Silent Installation Using the Executable
Use the executable file to perform a silent install to the default directory (or to a different directory) and to specify options such as logging installation messages.
To perform a silent install using the executable file
1. At a Windows command prompt, switch to the drive or directory where the executable for Toad is located. (This file can be downloaded from the Dell Software
Web site or can be found on the Toad installation CD-ROM.)
2. For a standard installation with all features enabled, enter the following command:
“ToadInstaller.exe” /S
For a read-only installation with create, alter, and drop functionality disabled, enter the following command:
“ToadInstaller.exe” /S READONLY=TRUE
You can customize MSIEXEC command-line options and overrides for your installation similar to the following command:
“ToadInstaller.exe” /S /Lx “C:\temp\installLog.txt”
INSTALLDIR=”Drive:\your_install_path” USERNAME=”some_user”
COMPANYNAME=”your_company” ALLUSERS=1
Use the following descriptions to customize the command-line options and overrides for your installation.
Toad Data Point Installation Guide
Installation
Command-Line Options
The following MSIEXEC command-line options are used in this example:
Option
/L “C:\temp\
installLog.txt”
Description
(Optional) Write installation messages to the specified log.
You can append other options, such as x for debug (used in the previous example) or v for a verbose log. See the log section at http://msdn2.microsoft.com/enus/library/aa367988.aspx
for more information about additional logging options.
Also, substitute “C:\temp\installLog.txt” in the example with the fully qualified name of the log file. Enclose this value in double quotations. The installation process creates this file if it does not exist. Otherwise, the existing file is overwritten.
Toad Default Installation Option Overrides
You can specify the following values to override Toad’s default installation options.
Enclose each value in double quotations.
Option
INSTALLDIR
ALLUSERS
USERNAME
Description
(Optional) Specify the absolute path for the directory in which you want to install Toad. If you do not include this path, the installation program defaults to:
C:\Program Files (x86)\Dell\Toad Data Point4.1.
(Optional) Specify one of the following: l
For a per-machine installation, specify 1. This value allows any user to use the Toad shortcut on the desktop after the installation completes.
l
For a per-user installation, enter the empty string value (“”) This value allows only the user specified for USERNAME (and the user that installed Toad) to see the Toad shortcut on the target desktop. If USERNAME is omitted, only the user that installed Toad sees the shortcut.
Note: If you do not specify this property, the installation program defaults to a per-user installation.
(Optional) Specify the user that intends to use Toad on the target computer.
20
Toad Data Point Installation Guide
Installation
21
Option Description
Notes:
l
If ALLUSERS is omitted or defined with the empty string value (""), only the user specified here (and the user that installed Toad) can see the
Toad shortcut on the desktop after the installation completes.
l
If ALLUSERS is omitted or defined with the empty string value ("") and you omit the
USERNAME option, only the user that installed
Toad sees the Toad shortcut on the desktop.
l
If ALLUSERS is 1, the USERNAME value is ignored during installation.
COMPANYNAME (Optional) Specify the name of the company that owns this installation.
Notes:
l
All default installation option overrides are case-sensitive.
l
Enclose all values (except for the ALLUSERS value) in double quotations.
Silent Installation Using the Microsoft Installer
MSI Prerequisites
Visual C++ Redistributable for Visual Studio 2015 is required by Toad, however it is not installed when you use the Microsoft (.msi) installer. Ensure that this software is installed prior to performing an install using the .msi installer. For downloads, see Visual C++
Redistributable for VS 2015 . For related information, see KB2999226 - Update for Universal
C Runtime in Windows .
If your operating system is 32-bit, install vc_redist.x86.exe. If your operating system is 64bit, install both vc_redist.x86.exe and vc_redist.x64.exe.
This software is required to enable some features in Toad Data Point, such as Local Storage.
This software is included in installation when using the executable (.exe) installer.
Perform Silent Installation Using MSI
To perform a silent install using msi
1. At a Windows command prompt, switch to the drive or directory where the msi installer for Toad is located.
2. For a standard installation with all features enabled, enter the following command:
Toad Data Point Installation Guide
Installation msiexec /i “ToadInstaller.msi” /q
For a read-only installation with create, alter, and drop functionality disabled, enter the following command: msiexec /i “ToadInstaller.msi” /q READONLY=TRUE
You can customize command-line options and overrides for your installation similar to the following: msiexec /i “ToadInstaller.msi” INSTALLDIR= “Drive:\your_install_
path” /q USERNAME=”someone” COMPANYNAME=”your_company” ALLUSERS=1
Command-Line Options
The following MSIEXEC command-line options are used in this example:
Option
/i
/q
Description
Run the installation.
Specify the user interface (UI) that displays during installation.
You can append other options, such as n to hide the UI or b to hide the Cancel button during the installation.
Note: All command-line options are case-insensitive. See http://msdn2.microsoft.com/en-us/library/aa367988.aspx
for a complete list of command-line options.
Toad Default Installation Option Overrides
You can specify the following values to override Toad’s default installation options.
Enclose each value in double quotations.
Option
INSTALLDIR
ALLUSERS
Description
(Optional) Specify the absolute path for the directory in which you want to install Toad. If you do not include this path, the installation program defaults to:
C:\Program Files (x86)\Dell\Toad Data Point4.1.
(Optional) Specify one of the following: l
For a per-machine installation, specify 1. This value allows any user to use the Toad shortcut on the desktop after the installation completes.
22
Toad Data Point Installation Guide
Installation
23
Option Description
l
For a per-user installation, enter the empty string value (“”) This value allows only the user specified for USERNAME (and the user that installed Toad) to see the Toad shortcut on the target desktop. If USERNAME is omitted, only the user that installed Toad sees the shortcut.
Note: If you do not specify this property, the installation program defaults to a per-user installation.
USERNAME (Optional) Specify the user that intends to use Toad on the target computer.
Notes:
l
If ALLUSERS is omitted or defined with the empty string value (""), only the user specified here (and the user that installed Toad) can see the
Toad shortcut on the desktop after the installation completes.
l
If ALLUSERS is omitted or defined with the empty string value ("") and you omit the
USERNAME option, only the user that installed
Toad sees the Toad shortcut on the desktop.
l
If ALLUSERS is 1, the USERNAME value is ignored during installation.
COMPANYNAME (Optional) Specify the name of the company that owns this installation.
Notes:
l
All default installation option overrides are case-sensitive.
l
Enclose all values (except for the ALLUSERS value) in double quotations.
Create Transform (MST) Files
You can create a Microsoft transform (.mst) file that deploys the license key, custom settings, and connections for users when performing a silent install using the .msi file. You can also use the .msi file to perform a basic silent install using the default directory (or install to a different directory) and to specify command-line options and default installation overrides.
See "Perform Silent Installation Using MSI" (page 21) for more information if you are not
creating a transform file.
Toad Data Point Installation Guide
Installation
24
Note: (MSI installs on Windows Vista and 7) If you are using MSI to install Toad on
Windows Vista or 7 with UAC enabled, you can install a file that adds a "Run as administrator" option when right-clicking the MSI file: http://www.symantec.com/connect/downloads/msi-run-administrator-context-menu-vista .
Note: The installer does not verify that system requirements have been met before installing.
If you do not want to manually verify system requirements, you should use the .exe file for the silent install.
The following procedure uses the Wise Installer to create the transform file.
To create a transform file that includes custom Toad settings
1. Save and install the ToadInstaller.msi file on a computer where the Wise for Windows
Installer is installed. After customizing Toad settings, you will use the Wise Installer to create the transform file.
2. Open Notepad, and do the following: a. Enter the license key in the first line.
b. Enter the site message in the second line.
c. Save the file with license.key as the file name in the Toad install directory.
Make sure the file extension is .key not .txt.
3. Launch Toad. The application should open without prompting you to enter a license key.
4. Select Tools | Configuration Wizard from the Toad menu and complete the
Configuration wizard. This wizard creates an initial settings file (Settings.xml).
5. Select Tools | Options from the menu in Toad to open the Options window.
6. Select each page in the window and set any options you want to deploy. These options create a module settings folder and files.
7. Select View | Connection Manager from the menu in Toad to open the
Connection Manager.
8. Create any connections you want to deploy.
9. Exit Toad. Upon exiting, a Connections file is created.
10. Create the Microsoft Transform file, using any appropriate tool. The following steps describe how to use the Wise for Windows Installer to create the file. a. Select File | New.
b. Select Custom Templates under Categories, and then select the Transform template in the New Installation File window.
c. Select the ToadInstaller.msi file in the Select the .MSI file to base this transform on window.
d. Save the project.
e. Select Files from the Feature Details view.
Toad Data Point Installation Guide
Installation
25 f. Locate the following files and click Add to add them to the project:
File to Add
Settings.xml
Windows Vista, Windows Server 2008, Windows 7,
Windows 8
C:\Users\ username\AppData\Roaming\ Quest
Software\Toad Data Point 4.1.
ModuleSettings folder and files
C:\Users\username\AppData\Roaming\ Quest
Software\Toad Data Point 4.1\ModuleSettings.
Connections.xml
C:\Users\username\AppData\Roaming\ Quest
Software\Toad Data Point 4.1.
g. Save the project and compile it to create the transform (MST) file.
Install Toad on Citrix
®
Systems
Toad must be installed on the Citrix server by the Citrix administrator. Users then connect to this instance through their Citrix login.
Note: Limited testing has been performed for Citrix XenApp™ 5.0 support on Windows
Server
®
2003 and for Citrix XenApp 6.5 on Windows Server 2008 R2.
To install Toad on a Citrix system
1. Connect to the Citrix Environment as an administrator.
2. Copy Toad to the Citrix server, if needed.
3. Start the Toad installation process.
4. During installation, select the Anyone who uses this computer checkbox when prompted.
5. Repeat steps 2 through 4 for each server in the Citrix farm.
Note: Although you must install Toad on every server in the Citrix farm, you only need to publish Toad once.
6. Review the following considerations regarding licensing: l
A license supplied by an administrator always overrides a user-supplied license in a Citrix environment.
l
If you need to provide the same Toad functionality to all users, you can enter the default license key for all users.
Toad Data Point Installation Guide
Installation
26
Upgrade Toad
To upgrade Toad
1. Run the ToadInstaller.exe installation program from the DVD or downloaded file.
2. Select Uninstall Toad and continue with install.
3. Complete the wizard.
If you are upgrading from a previous version of Toad, you are prompted to migrate your settings the first time you start Toad. The settings files include database connections, layout customizations, shortcut keys, and options customized in the Options pages.
To migrate the settings again, remove or rename the current version's Application Data folder and migrate the files from the previous version's Application Data folder.
Note: Local Storage databases and database objects persist between versions (releases) of
Toad Data Point.
Upgrade Automation Scripts and Scheduling
Tasks
If you upgrade to a newer version of Toad, Automation scripts created in a previous version must be upgraded before you can open them in the newer version. Toad prompts you to automatically upgrade a script when you attempt to open it in a newer version.
In addition, scheduled scripts are scheduled to run using the version of Toad in which they were created. After upgrading Toad, those previously-created, scheduled scripts will not execute in the newer version until you migrate each script's scheduling task. Toad prompts you to migrate scheduling tasks when you initially launch the application after installation.
Upgrade Automation Scripts to Newer Version of Toad
An automation script is compatible with the version of Toad in which the script was created.
If you want to open and/or modify a script using a newer version of Toad, you must upgrade the script. Toad automatically prompts you to upgrade the script the first time you open it in the newer version.
Toad Data Point Installation Guide
Installation
To upgrade an Automation script
1. Open the script in Toad. Toad prompts you to upgrade the script.
27
2. To upgrade the script, select Yes.
Caution: If you upgrade an automation script, it will no longer be compatible with earlier versions of Toad.
3. Select No (and do not elect to save the script), to keep the script compatible with the previous version.
4. If you selected Yes, Toad upgrades your script and saves a backup copy of the original script in the following location:
<application data directory>\Automation\bak\
5. If the script you upgraded is also scheduled, you must migrate the scheduling task, otherwise the upgraded script will fail to run.
Migrate Scheduling Tasks to Newer Version of Toad
Each scheduled Automation script uses a Windows scheduling task. The scheduling task specifies which version of Toad to use by specifying the version's application path. Toad provides you with two easy ways to migrate your scheduled scripts' scheduling tasks when you upgrade Toad. First, Toad prompts you to migrate scheduling tasks upon initial launch of the application after installation. Next, you can migrate scheduling tasks at any time using the Job Manager.
Notes:
l
If you upgrade a previously-created script by opening it in a newer version of Toad, you must also migrate the scheduling task to the newer version.
l
If you install the newer version of Toad side-by-side with the older version, previously-created, scheduled scripts will continue to execute using the older version, until you migrate the scheduling tasks (provided that you do not open the scripts in the newer version).
Toad Data Point Installation Guide
Installation
To migrate scheduling tasks upon initial launch
1. After upgrading Toad, and upon initial launch of the application, the Migrate
Scheduled Tasks dialog opens.
2. Select the scheduled tasks (scheduled Automation scripts) to migrate to the new version of Toad.
3. Click OK to close the dialog.
4. Toad immediately prompts you for your Windows password. Enter your password to migrate the scheduled tasks.
To migrate scheduling tasks using the Job Manager
1. Select Tools | Administer | Job Manager.
2. Click on the Job Manager toolbar.
3. Select the scheduled tasks to migrate and click OK.
Note: Only currently-scheduled tasks (enabled or disabled) are listed in the Migrate
Scheduled Tasks dialog.
4. Toad immediately prompts you for your Windows password. Enter your password to migrate the scheduled tasks.
Manually Edit Scheduling Tasks
On occasion you may need to modify the application path in a Windows scheduling task.
You can do this by manually editing the scheduling task using the following procedure.
To manually edit a scheduling task
1. In the Job Manager (Tools | Administer | Job Manager), right-click a task and select Edit Task.
2. To change the version of Toad used to run the script, in the Actions tab, change the folder name in the toad.exe path.
Files Migrated During Upgrades
When upgrading to a new version of Toad, the following files can be migrated from the previous version's Application Data Directory (click the Application Data Directory link in
Help | About to open the directory).
Caution! Migrating settings from a previous version of Toad may overwrite new settings files, implemented for the current release (for example, updated reports templates, layouts, etc).
28
Toad Data Point Installation Guide
Installation
File Description
Action.log
Connections.xml
ConnectionTrace.log
ExceptionTrace.log
FTPConnection.log
Tracks your usage within Toad. If you agree to share this data, the file is automatically sent to Dell on a periodic basis.
Contains all connections stored in the Navigation
Manager or the New Connection window.
Contains the SQL Output connection trace log file if you select Tools | Execution Trace from the menu.
Contains a log of all exceptions encountered while running Toad.
Contains a log of exceptions encountered when attempting to connect to FTP servers.
FTPConnections.xml
Contains connections to FTP servers stored in the
FTP Connections window.
Quest.PersistentCache.xml
Contains the private object annotation cache options
(object notes, Lookup tables, and hidden columns). You can share these options with other Toad users in Tools
| Options | Database | Cache.
Settings.xml
Contains many of the global configuration settings.
SqlServerPlanPrefs.xml
ToadSupportBundle.zip
Used to generate SQL Server execution plans.
Contains the last support bundle you generated.
Folder
Automation (temporary folder)
Cache
Description
Used by automation when executing automation scripts.
Context
Used to spool cache database metadata to disk if enabled. The data is in binary format and can always be recreated by fetching it from the database.
Contains settings that depend on the context within
Toad including the following: l
Adapter—Custom data editing statements.
l
Filter—Unnamed filters defined in the Object
Explorer or Database Explorer.
l
Named Filter—Named filters defined in the
Object Explorer or Database Explorer.
29
Toad Data Point Installation Guide
Installation
Document Recovery
Keyboard
Layouts
ModuleSettings
Plugins
Session
SQLFormatter
SQLRecall
Templates l
TYPE—Tabs that display on the right when you select an object in the Object Explorer or
Database Explorer.
Contains backup copies of Editor, Query Builder, and
Database Diagram files saved if you have enabled
Document Recovery in Tools | Options | Environment |
General.
Contains custom keyboard shortcut layouts.
Contains layouts for some areas in Toad, such as tool windows that automatically display in the Editor and column layouts for the Messages tab.
Contains general settings for various components in
Toad, such as whether the data grid defaults to readonly, displays not null indicators, etc.
Used by Toad plugin components.
Contains desktop configurations, including toolbar customizations and tool window locations.
Contains pre-set and user created templates for formatting SQL, and the SQL statement used to preview formatting changes in the Formatting Options page.
Contains the SQL statements saved by SQL Recall.
Contains the following templates: l
Code Templates—Templates used to define default values when creating new objects in the
Object Explorer or Database Browser.
l
Scripts—Startup scripts to run when connecting.
l
Snippets—Code Snippet entries.
l
Reports—Report entries.
Uninstall Toad
If you uninstall Toad, it may not uninstall completely. When you use Toad, you create new files such as SQL scripts, data output, or temp files, etc. The following types of files are not removed when you uninstall:
30
Toad Data Point Installation Guide
Installation
31 l
Any new files you create l
Any copies of files you make for backup purposes l
Settings files
You can uninstall Toad Data Point by using the Installer or by using the Windows
Add/Remove Programs (or Uninstall a program) feature. Using the Installer is the preferred way to uninstall Toad Data Point.
To uninstall Toad
1. Run the ToadInstaller.exe.
2. Select Uninstall Toad Data Point only.
3. Complete the wizard.
Licensing
To enter your license key
1. Select Help | Licensing from the menu (ALT+H+L).
2. Review the following for additional information:
Authorization key
Site message
Enter the license key for Toad.
Enter the site message included with the license key.
Note: Your license key determines the edition of Toad (Base, Pro, etc.) and will enable the functionality accordingly. In many cases, if functionality is disabled within
Toad, you may not have an appropriate license to use it. When Toad is running, you can see which components are licensed by selecting Help | About. For complete list of features shipped with your Toad edition see http://software.dell.com/ .
Notes for Toad Data Point Users
Trial Keys
The commercial version of Toad Data Point comes pre-installed with a trial license key for your convenience. This allows you to use the application while waiting for your commercial key to be delivered.
The trial license key remains active for the designated trial period, even after you enter your commercial license key (the splash screen may continue to indicate your application is a trial version). This is helpful if you are previewing an upgrade or an advanced module.
If you entered your commercial license key and do not require the trial version, you can delete the trial key.
Toad Data Point Installation Guide
Installation
32
Important: If you delete the Trial key, any advanced features not included in your purchased edition will be disabled.
To delete a trial key
1. Select Help | Licensing.
2. In the Toad Licensing dialog, find the License tab for the trial license key and click
Delete License to delete the trial key.
View Intelligence Central License Information
If you have a Toad Intelligence Central connection, you can view some license information, specifically the list of modules currently licensed to that Intelligence Central server. You can use the list of modules to determine what functionality is enabled on the server.
l
To display a list of currently-licensed modules (functionality) for an Intelligence
Central server, in the Connection/Navigation Manager place your cursor over the connection (connection must be open). The list of enabled modules is displayed along with other connection information.
Configure Toad Layout
Toad can emulate the layout and settings of other products. Use the Configuration Wizard to select a pre-defined layout that matches Toad™ for Oracle ® , SQL Navigator, or your native database tool. The Configuration Wizard also allows you to specify a skin and grid color.
If you want to group documents using Toad's built-in workflow: Understand, Query, Report, and Automate, select the Toad for Data Analysts (Original) option. Then open the
Configuration Wizard again and select Custom to configure Toad behavior, such as
Toad Data Point Installation Guide
Installation
33 showing/hiding windows, or opening and grouping documents according to the selected workflow group.
You can also manually rearrange windows and panes to customize the Toad workspace. See
"Customize Your Toad Workspace" (page 36) for more information.
To configure Toad layout using the Configuration Wizard
1. Select Tools | Configuration Wizard (ALT+T+F).
2. To match the look of another product, select a layout option and click Finish.
Review the following layout options before selecting:
Layout and Settings Page
Layout options: l
Toad Data Point 3.0—Applies shortcut keys used by Toad Data Point, opens default windows, and adds the Wizard toolbar.
l
Toad for Oracle—Applies shortcut keys used by Toad™ for Oracle
® and automatically opens the Project
Manager, Editor, SQL Recall, and
Output windows.
l
MS Query Analyzer—Applies shortcut keys used by Query Analyzer and automatically opens the Object
Explorer, Code Snippets, and Editor windows.
l
MS Management Studio—Applies shortcut keys used by Management
Studio and automatically opens the
Connection Manager and Editor windows.
l
SQL Navigator—Applies shortcut keys used by SQL Navigator and automatically opens the Navigation
Manager, Object Explorer, Editor, and
Code Snippets windows.
l
Toad for Data Analysts (Original)—
Applies shortcut keys used by Toad for Data Analysts. This option also displays the Grouping (Toad workflow) toolbar and Wizard toolbar.
l
Custom—Applies shortcut keys used
Toad Data Point Installation Guide
Installation by Toad Data Point. This option allows you to select skin and grid styles, as well as Database Explorer display options.
Use this option to customize the Toad
for Data Analysts layout if you have previously selected it.
Tip: You can set or modify individual keyboard shortcuts in Keyboard Options in
Tools | Options | Environment | Keyboard.
Note: If you select a new layout, you may need to restart Toad to see the changes to the
Grouping and Wizard toolbars.
3. To customize your layout, select Custom and click Next. Then specify options on each page of the wizard. Review the following for additional information:
Page
Look and Feel
Database Explorer Style
Quick Guide
Options
Select a skin and grid style.
l
Skin—Applies the skin style you select to document windows, tool windows, and modal dialogs.
l
Grid style—Applies the grid style you select to the data grid only.
A preview of the selected style is automatically displayed in the wizard and in the grid.
Tip: You can change the skin and grid style later in Tools | Options | Environment |
Interface.
Specify how objects display in the Object
Explorer window.
Tip: Click in the Object Explorer at any time to switch to a different view style.
Displays a Quick Start Guide that lets you quickly launch frequently used features and tutorials until you are more familiar with the application.
Tips:
34
Toad Data Point Installation Guide
Installation
Page
Group Documents
Group Document Defaults
Options
l
To view this window at anytime, select View | Quick Guide from the menu.
l
To hide this window when starting
Toad, select the Do not show on start
up checkbox at the bottom of the
Quick Guide window.
Applies to the Toad for Data Analysts
(Original) layout. Select this layout option prior to customizing.
Specify one or more of the following options: l
Use document groups—Associates each open document with its respective group in the Groupings
(Toad workflow) toolbar.
l
Hide windows per group—Displays only those windows that are associated with the selected group in the Groupings toolbar. For example, if the Query group is selected and a
Query Builder window is open, it will be hidden when you select the Report group.
Note: Unless the Hide windows per
connection checkbox is selected, any connections that have a window open for this group display.
l
Hide windows per connection—
Displays only those windows for the current connection that are associated with the selected group.
Tip: To hide the Grouping toolbar, select
Tools | Customize, and then deselect the
Grouping toolbar in the Toolbar tab.
Applies to the Toad for Data Analysts
(Original) layout. Select this layout option prior to customizing.
Select the default window to open when selecting a group from the Grouping toolbar.
Understand
l
Database Diagram—Easily identify
35
Toad Data Point Installation Guide
Installation
Page
Wizard Bar
Connection Documents
Additional Settings
Options
l
Database Explorer—Drill-down to details for each object.
Query
relationships between tables via foreign keys.
l
Query Builder—Quickly create complex queries and subqueries using a graphical interface.
l
SQL Editor—Powerful editor for writing SQL queries and scripts.
Report
l
Excel—Automatically export query results and open them in Excel.
l
Toad Report—Send query results to the Toad Data Report wizard.
Select to display the Wizard bar, a toolbar containing frequently-used actions for the currently open window. It displays along the bottom of the Toad window.
Tip: To modify this option later, use the
Configuration Wizard.
Specify which type of new document to automatically open when a new database connection is created.
Tip: You can modify this option later in
Tools | Options | Database | General.
Specify whether to automatically add files to the Project Manager when saving, executing, or sending the files to a report. This option can help you locate and manage your work.
4. Click Finish when you are done customizing.
Customize Your Toad Workspace
You can customize your Toad workspace by re-arranging windows and panes. For docked panes selected from the View menu, Toad remembers the configuration of your last open session and displays it when you re-launch the application.
36
Toad Data Point Installation Guide
Installation
37
To rearrange windows and panes
1. Open a Toad pane by selecting it from the View menu.
2. Drag the pane to a new location in the Toad workspace.
3. Drop the pane into the desired section of the workspace when it becomes highlighted.
4. To move an open window, drag it to the desired area of the workspace and drop it into a highlighted section.
2
Create Connections
Understand Toad Connections
Review this topic to learn about open database connections in Toad.
Toad Open Connections
In Toad, an open connection in the Connection/Navigation Manager represents one or more actual connections to the database or data source. When you open a database connection in Toad: l
Toad creates an initial database connection for general use.
l
Toad also creates a separate database connection for each Editor (the first time you execute a statement) and for each Data tab in the Database Explorer (the first time you select the tab and query data).
The connection associated with the window (or tab) remains open until you close the window. If a window has an associated connection, but a statement is not currently executing, the connection is in an inactive state.
To view information for an open connection
l
To view the number of actual database connections that exist for a Toad connection, including the number of active connections, place the cursor over the connection in the Connection/Navigation Manager pane or in the connection drop-down list.
To use the Background Processes pane
l
When a statement is executing, a progress bar displays in the Status bar located at the bottom of the Toad application window. Click the executing progress bar to open the
Background Processes pane.
Toad Data Point Installation Guide
Create Connections
39 l
To cancel statement execution, use the Background Processes pane.
Note: It is recommended that you cancel only your own processes, because terminating Toad activities could cause unexpected behavior.
Sharing a Connection Among Windows
You can instruct Toad to share an open connection among windows. In this way, the Editor windows and Data tabs can share the same connection when the connection is inactive.
To share a database connection among windows in Toad
1. Select Tools | Options | Editor | General.
2. Clear the checkbox for the Use individual connection for each open editor option.
3. When this option is not selected, Toad attempts to use a single connection for any new windows or query execution. For example, if you share a database connection, you can execute a query in the Editor, execute another query in a new Editor, and then select the Data tab from the same connection.
If the single connection is in use when Toad attempts to execute it, the following occurs: l
(DB2 and Oracle only) If your database supports executing multiple queries simultaneously on a shared connection, the query is placed in a queue and executes as soon as the current operation completes.
l
If your database does not support executing multiple queries on a shared connection, a dialog prompts you to either permanently associate the window with a new database connection, cancel the previous operation, or add the query to a queue until the current operation completes, and the execute it. If you place multiple queries in the queue, each one executes in the order that it was added to the queue.
Note: Although you can share a database connection, any commits apply to the selected window only.
Create Access Connections
Although this connection uses the ODBC driver, it is easier and faster to connect using this
method. See "Troubleshoot Access Issues" (page 88) for more information about
troubleshooting connection issues.
Notes:
l
The Toad Sample Database and established connection that comes pre-loaded in Toad
Data Point is an Access database. The connection information for this database is:
Toad Data Point Installation Guide
Create Connections
Database file = C:\Program Files\Dell\ToadInstallDirectory\Plugins\Odbc\Sample
Database\Quest_Stage.mdb
Additional sample files for this database are available in the Project Manager.
To create an Access connection
1. Click on the toolbar (ALT+F+N).
2. Select Access from the Group list box.
3. Review the following for additional information:
Database file
MDW file
Password
Category
Select the database to use when connecting.
Select the MDW file that is linked to the database.
Enter the password to use when connecting.
Tip: After connecting, you can set a master password to further secure your connection in Tools | Options| Environment |
Security.
Select or create a category if you want to color code Editor tabs for a specific connection. This can help differentiate between development and production databases. You can also set an option to color code the Object Explorer pane and object editor windows (Create, Alter, Drop, etc.).
Click here to view a video of this feature.
4. Click Connect to connect immediately while saving the connection information.
Optionally, click Save to save the connection without connecting.
Considerations and Limitations
Consideration/Limitation
Microsoft Access 2016 64-bit
Office 365 64-bit
Description
To successfully create a connection to an Access database using Microsoft Access 2016 64-bit, the
Microsoft Access Database Engine is required and might not have been included in the Access installation. In addition, the architecture (bitness) of the engine must match the bitness of Toad.
If using 64-bit Toad, the 64-bit version of
Microsoft Access Database Engine is required.
If using 32-bit Toad, the 32-bit version of
Microsoft Access Database Engine is required.
1. You can download the 64-bit or 32-bit
Microsoft Access Database Engine
40
Toad Data Point Installation Guide
Create Connections
Consideration/Limitation Description
components at: https://www.microsoft.com/enus/download/details.aspx?id=13255 .
2. Be sure to select the appropriate version
(64-bit or 32-bit) of the
AccessDatabaseEngine.exe installer to match the bitness of Toad.
Tip: Connections are stored in the connections.xml file and can be found by clicking the
Application Data Directory link in Help | About.
Click here to view a video about creating connections in Toad Data Point
Create SAP Business Objects Connections
Toad allows you to connect to SAP
®
Business Objects through the Query as a Web Service
(QaaWS) component to view and query data in QaaWS Queries.
Note: This feature is available in the Toad Data Point Professional Edition only.
To create a Business Objects connection
1. Click on the Connections toolbar (ALT+F+N).
2. Select SAP Business Objects from the Group list.
3. Enter the connection information in the Create New Connection dialog. Review the following for additional information:
URL
Password
Enter the Business Objects URL to which you want to connect.
This is the URL to the Query as a Web Service component of
Note: The URL should be in the following format: http://<server>:<port>/dswsbobje/qaawsservices
Enter the password to use when connecting.
Tip: After connecting, you can set a master password to further secure your connection in Tools | Options| Environment |
Security.
Category (Optional) Select an existing category or create a new one.
Note: In NoSQL and Business Intelligence connections, Toad automatically saves
41
Toad Data Point Installation Guide
Create Connections
42 the password in the connections.xml file as obfuscated text, as well as in Toad.
To add additional password security, use Toad's Master Password feature.
4. Click Connect to connect immediately while saving the connection information.
Optionally, click Save to save the connection without connecting.
5. Upon creating an initial connection, Toad automatically maps the data source objects.
This process runs in the background, and until it is finished, you may experience a delay when attempting to access these objects.
Important Information about Business Objects Connections
To create a Business Objects connection in Toad, you must connect to the Query as a Web
Service component in Business Objects. The connection URL should have the format: http://<server>:<port>/dswsbobje/qaawsservices
Where <server> corresponds to your web server address, and <port> corresponds to the port where you set up in your web server. (dswsbobje is the default name of the
Query as a Web Service web application.)
An example URL is http://server01:8080/dswsbobje/qaawsservices.
For more information about the Business Objects component, Query as a Web Service, see the documentation at http://help.sap.com/businessobject/product_guides/xir2PP/en/qaaws.pdf
.
Tips:
l l
To specify a default value for a column parameter, select a Query and click .
Connections are stored in the connections.xml file and can be found by clicking the
Application Data Directory link in Help | About.
l
You can specify a proxy server to use for Business Intelligence and NoSQL connections at Tools | Options | Database | Data Services.
Toad Data Point Installation Guide
Create Connections
43
Configure DB2 Client Connections
Setting up connections to the DB2 for LUW databases and DB2 for z/OS subsystems that
Toad will manage requires two main steps.
Step 1. Configure DB2 client connections - Before you can create a connection profile, each of the databases or subsystems must be cataloged on the DB2 client. This topic helps you with that process.
Step 2. Create connection profiles - Step 2 involves creating Toad connection profiles for the cataloged DB2 databases or subsystems. Each profile contains the information that Toad needs to connect to the system, such as the user ID and
password, DB2 registry settings, and the default schema. See "Create Toad Connection
Profiles for DB2" (page 52) for more information.
Note: You must have a DB2 client installed before you can configure client connections and create connection profiles. Beginning with Toad Data Point 3.6, a DB2 client is no longer included in the product installation. Refer to IBM for information regarding a DB2 client download, http://www-01.ibm.com/software/data/db2/linux-unix-windows/downloads.html
, or consult your organization's IT department. For a list of supported DB2 client versions, see the Toad Data Point Release Notes.
If You Previously Used the Toad DB2 Client
If you previously used the Toad DB2 client installed with earlier versions of Toad Data
Point, you may need to do the following: l
Install a DB2 client from IBM and set it as the default. Because Toad no longer installs a client along with the product, you must now have a DB2 client from IBM installed to use your DB2 connections.
l
Transfer the catalog from the previous Toad DB2 client to your current default DB2 client. If you used the Toad DB2 client in a previous version of Toad, install a default
DB2 client from IBM, and then transfer the catalog from the Toad client to the new
default DB2 client. See Transfer a Catalog Any Time After Initial Setup (page 44).
To check default client
l
You may want to check that the correct client is set as the default, before you import a catalog to it. The default client is identified as such in the Start menu (Start | All
Programs | IBM DB2). The default client has “(Default)” after the client name.
To specify default client
l
You can specify the default client using the Database Client Interface Selection
Wizard (Start | All Programs | IBM DB2 client name | Database Client Interface
Selection Wizard).
Toad Data Point Installation Guide
Create Connections
44
Configure DB2 Client Connections
Use one of the following methods to catalog each of the databases or subsystems on the DB2 client.
Transfer a Catalog Any Time After Initial Setup
Use this method to transfer a catalog from another DB2 client on your machine to your default DB2 client. If you previously used the Toad DB2 client installed with the product in prior versions, use this method to transfer the catalog from the previous Toad DB2 client to your current default DB2 client.
To transfer a catalog any time after initial setup
1. In the Connection Manager, click in the toolbar.
Note: If the Client Configuration Wizard opens, Toad found only one DB2 client installed.
2. From the DB2 Client list, select the name of the DB2 client whose catalog you want to transfer to your default DB2 client.
This list contains all current previously installed DB2 clients on your computer, including the default DB2 client instance and any Toad DB2 client installations.
3. Click OK.
4. To create a connection in Toad for any of the transferred catalog entries, see Create
Toad Connection Profiles for DB2 (page 52).
Import a DB2 catalog previously exported to a file
To import an exported catalog profile
1. In the Connections (or Create New Connection) window, click beside the
Database alias drop-down list to open the Client Configuration wizard.
2. On the Welcome page, select Import Profile.
3. Click Next.
4. Click in the Profile name field to browse for and select the exported profile you want to import. When you select the profile, its contents display in the text pane.
5. Complete the wizard.
Once you close the wizard, the Database alias drop-down list in the
Connections window includes all the DB2 databases and subsystems whose catalog entries you imported.
Note: DB2 does not automatically export catalog entries for the local DB2 instance and its databases on the computer from which the export is run (unless these entries
Toad Data Point Installation Guide
Create Connections
45 already exist in the catalog). Therefore, the profile you are importing might not include these node entries. To add the missing entries to your DB2 client catalog, you must manually catalog the databases. If these databases are local to your computer,
catalog them as remote databases. See "Manually catalog DB2 for LUW databases "
(page 45) for more information.
6. Proceed to catalog entries as needed. See "Create Toad Connection Profiles for DB2"
(page 52) for more information.
Manually catalog DB2 for LUW databases
To manually catalog a DB2 for LUW database
1. In the Connections (or Create New Connection) window, click beside the
Database alias drop-down list to open the Client Configuration wizard. The Welcome page displays, showing the DB2 client's existing catalog configuration in a tree view.
2. If the host and node names for the database you want to configure are listed in the tree, select them. These selections pre-fill certain fields required later in the wizard process. If these names are not listed, you must provide the necessary host and node information later in the wizard.
3. Click Add Catalog Entry.
4. Review the following for additional information:
Add a Host
Operating system
Host name
Port number
Security type
Description
Select the operating system for the server on which the DB2 for LUW instance containing the DB2 database you are cataloging resides. For a list of supported server platforms, see the release notes.
Enter the TCP/IP address or the system name for the server on which the DB2 database resides.
Enter the port number for the server on which the DB2 database resides.
Select a secure protocol to handle TCP traffic for this connection.
Description Specify an
Instance
Node name Enter a user-defined name for the DB2 instance containing the database you are cataloging.
If you selected the node name from the tree on the Welcome page, this information is pre-filled (but you can update it as
Toad Data Point Installation Guide
Create Connections
46
Instance name
Comment
Add a Database
Database name
Database alias
Authentication
Target principal needed).
Enter the real name of the DB2 instance.
Enter a descriptive comment for the instance, if needed.
Description
Enter the real name of the DB2 database.
Enter a unique nickname to identify the database on your system.
Select the authentication method that is required to connect to the database.
Enter the service account name for server's service where the database resides.
Note: This option is available only when Kerberos is selected as the authentication method.
5. Complete the wizard.
The Database alias drop-down list in the Connections window shows the alias for the newly cataloged database. To complete the Toad connection setup, you must create a
Toad connection profile for the database. See "Create Toad Connection Profiles for
DB2" (page 52) for more information.
Toad Data Point Installation Guide
Create Connections
47
Manually catalog DB2 for z/OS subsystems
Note: If you connect directly to a DB2 for z/OS subsystem, you cannot take advantage of
Sysplex. If you want to use Sysplex, catalog an entry to a DB2 Connect gateway instead. See
"Manually catalog DB2 Connect gateways " (page 48) for more information.
To manually catalog a DB2 for z/OS subsystem
1. In the Connections (or Create New Connection) window, click beside the
Database alias drop-down list to open the Client Configuration wizard. The Welcome page displays, showing the DB2 client's existing catalog configuration in a tree view.
2. If the host name for the DB2 subsystem you want to configure is listed in the tree, select it. This selection pre-fills certain fields required later in the wizard process. If the host name is not listed, you must provide the necessary host information later in the wizard.
3. Click Add Catalog Entry.
4. Review the following for additional information:
Add a Host
Operating system
Host name
Description
Select z/OS for the server operating system.
Enter the TCP/IP address or the system name for the server on which the DB2 subsystem resides.
Enter the port number of the service for the DB2 subsystem.
Port number
Enable
SOCKS security
Add a DB2
Subsystem
Location name
Database alias
Select this checkbox to enable the SOCKS secure protocol to handle TCP traffic for this connection. SOCKS adds an authentication mechanism for additional security.
Description
Enter the location name of the DB2 subsystem as defined during the DB2 installation.
Enter a unique, user-defined alias to identify the DB2 subsystem on your system. You can use the same name you used in the previous Location name field, as long as it does not already exist in the list aliases in the DB2 client.
Toad Data Point Installation Guide
Create Connections
48
5. Complete the wizard. A message informs you whether the entry was added successfully.
The Database alias drop-down list in the Connections window shows the alias for the newly cataloged subsystem. To complete the Toad connection setup, create a Toad
connection profile for the database. See "Create Toad Connection Profiles for DB2"
(page 52) for more information.
Manually catalog DB2 Connect gateways
In order to connect to a DB2 for z/OS subsystem, you need to catalog two entries. First, you need to catalog the DB2 subsystem on the DB2 Connect gateway. During this process, you define an alias for the DB2 subsystem. Second, you need to catalog this DB2 subsystem alias in Toad. The procedure below describes both cataloging events.
To manually catalog an entry to a DB2 Connect gateway
1. Catalog the DB2 subsystem on the DB2 Connect gateway. See the IBM DB2 for z/OS documentation for more information.
2. In the Connections (or Create New Connection) window in Toad, click
Database alias drop-down list to open the Client Configuration wizard.
3. Click Add Catalog Entry.
4. Review the following for additional information: beside the
Add a Host
Operating system
Host name
Port number
Enable
SOCKS security
Specify an
Instance
Node name
Description
Select the operating system for the server on which the DB2
Connect gateway resides.
Enter the TCP/IP address or the system name for the server on which the DB2 Connect gateway resides.
Enter the port number of the service for the DB2 Connect gateway.
Select this checkbox to enable the SOCKS secure protocol to handle TCP traffic for this connection. SOCKS adds an authentication mechanism for additional security.
Description
Instance name
Enter an alias for the user-defined node name you specify in the Instance name field.
Enter a user-defined name for the gateway node or use the
Toad Data Point Installation Guide
Create Connections
49
Add a Database
Database name
Database alias
Authentication same value entered in the Node name.
Note: This name does not point to an actual node on the gateway system, but is needed to continue the cataloging process.
Description
Enter the database alias name for the DB2 subsystem.
Note: This alias name must match the alias cataloged on the
DB2 Connect gateway.
Enter a unique, user-defined alias for the DB2 Connect gateway. You can use the same alias you used in the previous Database name field, as long as it does not exist in the list of Toad for DB2 aliases.
Select the authentication method that matches the method specified for the DB2 subsystem on the DB2 Connect gateway.
5. Complete the wizard.
The Database alias drop-down list in the Connections window shows the name for the newly cataloged DB2 subsystem. To complete the Toad connection setup, you
must create a Toad connection profile for the subsystem. See "Create Toad Connection
Profiles for DB2" (page 52) for more information.
Note: Toad for DB2 supports LDAP connections. See "Configure DB2 LDAP Support" (page
Maintain DB2 Client Connections
Additionally, Toad provides functionality to perform the following maintenance on the catalog you set up for the current DB2 client:
Edit DB2 catalog entries
To edit a DB2 catalog entry
1. In the Connections (or Create New Connection) window, click beside the
Database alias drop-down list to open the Client Configuration wizard.
2. In the catalog configuration tree for the DB2 client, select the catalog entry for the
DB2 database or subsystem that you want to edit.
3. Click Edit Catalog Entry.
4. On the Edit Catalog Entry page, update the catalog properties as needed. For a description of the catalog properties, see the following links:
Toad Data Point Installation Guide
Create Connections
50 l
Manually catalog DB2 for LUW databases (page 45)
l
Manually catalog DB2 for z/OS subsystems (page 47)
l
Manually catalog DB2 Connect gateways (page 48)
5. Click Next to open the Catalog Script Review window.
6. Review and modify the script in the preview pane as needed.
7. Click Finish. A message window displays, informing you whether the updates to the catalog entry completed successfully.
Remove DB2 catalog entries
To remove a DB2 catalog entry
1. In the Connections (or Create New Connection) window, click beside the
Database alias drop-down list to open the Client Configuration wizard.
2. In the catalog configuration tree for the DB2 client, expand one or more nodes, and select the catalog entries that you want to remove. (Press CTRL+click to select multiple entries.)
Note: You can remove a node by selecting all database entries for that node.
3. Click Remove Catalog Entry.
4. On the Catalog Script Review page, modify the script in the preview pane as needed.
5. Click Finish. A message window displays, informing you whether the removals completed successfully.
Export the catalog for the current DB2 client
Toad Data Point provides functionality to export your current DB2 client catalog to a file, called an export profile. You can then import this profile to set up the catalog for another
DB2 client.
To create the export profile containing the current DB2 client catalog, Toad executes the
DB2 Connectivity Configuration Export Tool command db2cfexp
. If you want to export the catalog of a remote or local DB2 client (other than your current DB2 client), you must manually execute this command. For more information, see the following IBM documentation: http://publib.boulder.ibm.com/infocenter/db2luw/v8/index.jsp?topic=/ com.ibm.db2.udb.doc/core/r0002442.htm
.
To export the DB2 client catalog
1. In the Connections (or Create New Connection) window, click
Database alias drop-down list.
beside the
2. Click Export Profile in the Welcome window of the Client Configuration wizard.
(You might need to click
Toad Data Point Installation Guide
Create Connections
51 this button.)
3. Click Next.
4. Click in the Profile name field to browse for and select the path for the profile in which to export the current DB2 client catalog.
5. Select the type of profile you want to create: l
Template to create a profile used as a template for other DB2 clients (default for exporting a DB2 catalog) l
Backup to create a profile used to back up a DB2 database instance l
Maintain to create a profile that contains only database or node information required for updating other instances
For more information about these profile types, see the IBM documentation (as cited previously) describing the db2cfexp command.
6. Complete the wizard. A message window displays, informing you whether the export completed successfully.
Note: DB2 does not automatically export catalog entries for the local DB2 instance and its databases installed on your computer unless these entries already exist in the catalog you are exporting. If you later import the export catalog to a DB2 client, you
must manually catalog the missing local-node databases as remote databases. See
"Manually catalog DB2 for LUW databases " (page 45) for more information.
After you have set up the catalog on the current DB2 client, you can proceed to the second phase of the Toad connection setup. This phase involves creating Toad connection profiles
for the cataloged DB2 databases or subsystems. See "Create Toad Connection Profiles for
DB2" (page 52) for more information.
Configure DB2 LDAP Support
You can create DB2 Lightweight Directory Access Protocol (LDAP) connections when the
DB2 client installed with Toad is configured for LDAP. Configuring the client consists of enabling LDAP support and specifying the host name and port number of the LDAP server.
Once the client is configured, Toad retrieves names from your LDAP server and displays them in the Database Alias list in the Connections window.
Notes:
l
You must configure LDAP support for the DB2 client installed with Toad regardless of whether an existing DB2 client on the computer is already configured to support LDAP.
Toad Data Point Installation Guide
Create Connections
52 l
Currently, Toad for DB2 supports only the access of DB2 LDAP catalog entries. Toad does not support the management of these entries.
To configure the DB2 client for LDAP
1. Open the Command Window for the DB2 client installed with Toad by selecting
Start | All Programs | IBM DB2 | <ToadCom, ToadEval, or ToadFree> |
Command Line Tools | Command Window.
2. Enter the following command to enable LDAP support: db2set DB2_ENABLE_LDAP=YES
3. Enter the following command to specify the TCP/IP host name and port number of the
LDAP server: db2set DB2LDAPHOST=<hostname[:port]>
The port number defaults to 389 (default LDAP port) if you leave the port number blank.
4. Exit the Command window.
5. Launch Toad and open the Connections window.
Databases on the LDAP server should be available from the Database alias dropdown list in the Connections window. To complete the Toad connection setup, you
must create a Toad connection profile for each database. See "Create Toad Connection
Profiles for DB2" (page 52) for more information.
Create Toad Connection Profiles for DB2
Setting up connections to the DB2 for LUW databases and DB2 for z/OS subsystems that
Toad will manage requires two main steps.
Step 1. Configure DB2 client connections - Before you can create a connection profile, each of the databases or subsystems must be cataloged on the DB2 client. See
Configure DB2 Client Connections (page 43) to learn how to catalog
databases/subsystems.
Step 2. Create connection profiles - Step 2 involves creating Toad connection profiles for the cataloged DB2 databases or subsystems. Each profile contains the information that Toad needs to connect to the system, such as the user ID and password, DB2 registry settings, and the default schema. This topic helps you create connection profiles.
Note: You must have a DB2 client installed before you can configure client connections and create connection profiles. Beginning with Toad Data Point 3.6, a DB2 client is no longer included in the product installation. Refer to IBM for information regarding a DB2 client download, http://www-01.ibm.com/software/data/db2/linux-unix-windows/downloads.html
,
Toad Data Point Installation Guide
Create Connections
53 or consult your organization's IT department. For a list of supported DB2 client versions, see the Toad Data Point Release Notes.
Click here to view a video about creating connections in Toad Data Point
If You Previously Used the Toad DB2 Client
If you previously used the Toad DB2 client installed with earlier versions of Toad Data
Point, you may need to do the following: l
Install a DB2 client from IBM and set it as the default client. Because Toad no longer installs a client along with the product, you must now have a DB2 client from IBM installed to use your DB2 connections.
l
Transfer the catalog from the previous Toad DB2 client to your current default DB2 client. If you used the Toad DB2 client in a previous version of Toad, install a default
DB2 client from IBM, and then transfer the catalog from the Toad client to the new
default DB2 client. See "Configure DB2 Client Connections" (page 43) for more information.
Create Connection Profiles
Use one of the following methods to create Toad connection profiles: l
Import Toad connection profiles previously exported to an XML file
(See "Export connection profiles to an XML file" (page 55) for more information
about exporting a profile that you can later import.)
Note: The connection profiles are not usable unless you have also created entries in the DB2 catalog for the DB2 databases and subsystems to which these profiles
correspond. See "Configure DB2 Client Connections" (page 43) for more information.
To import connection profiles
1. In the Connections (or Create New Connection) window, click toolbar, and select Connection file.
on the
2. From the Import Connections window, browse for and select the XML file containing the connection profiles you want to import.
3. Click Open.
4. Select DB2 and click OK to complete the import.
The connections whose profiles you imported are listed on the
Connections window.
l
Manually define Toad connection profiles.
Toad Data Point Installation Guide
Create Connections
54
To create a Toad connection profile for a DB2 database or subsystem
1. In the Connections (or Create New Connection) window, click on the toolbar (ALT+F+N).
2. Select IBM DB2 LUW or IBM DB2 z/OS from the Group list box.
3. Review the following for additional information:
Database alias
Default schema/auth
ID
Category
Select the alias for the DB2 database or subsystem. This alias was defined when you cataloged this DB2 database
or subsystem on the DB2 client. See "Configure DB2
Client Connections" (page 43) for more information if the
alias does not display in the list.
Tip: Click to refresh the alias list. Normally, Toad caches the DB2 catalog the first time you open this window in your Toad session and continues to read from cache each time you subsequently open this window. This button forces Toad to reread the DB2 catalog to list any new systems that might have been cataloged externally during the caching period.
Enter the SET SCHEMA value (DB2 for LUW) or the
SET SCHEMA or SET CURRENT SQLID value (DB2 for z/OS) for this connection.
Select or create a category if you want to color code
Editor tabs for a specific connection. This can help differentiate between development and production databases. You can also set an option to color code the
Object Explorer pane and object editor windows (Create,
Alter, Drop, etc.).
Click here to view a video of this feature.
4. Select the Advanced tab to define special register values that are then in effect each time Toad connects to the DB2 database or subsystem.
5. Click Connect to save the connection and immediately connect to the database.
or
Click Save to save the connection without connecting to the database.
Manage Connections
After you have completed both phases for configuring Toad connections to DB2 databases or subsystems, the Connections window lists all the configured connections, allowing you to perform the following:
Toad Data Point Installation Guide
Create Connections
55 l
Connect to and manage a DB2 database or subsystem through Toad l
Export connection profiles to an XML file
Toad for DB2 provides functionality to export one or more of your current Toad connection profiles to an XML file. You can then import these exported connection
To export connection profiles
1. In the Connections (or Create New Connection) window, select the connections whose profiles you want to export.
2. Click on the toolbar, and select Connection file.
3. On the Export Connections window, review the selected connections, and click OK.
4. Browse for and select the path for the file in which to export the selected profiles.
l
Import missing connections defined on the Toad client
You can import all connection entries currently defined in the DB2 client catalog but missing from your current list of Toad connections.
Note: The imported connection entries might be associated with incorrect or missing
DB2 catalog or Toad connection profile information, making them currently invalid.
To re-instate any of these connections, you might need to provide accurate DB2 catalog and Toad profile information.
To import missing connections
» In the Connections or Connections Manager window, click .
l
Troubleshoot connection issues
Note: Click to open the Client Configuration Wizard. See "Configure DB2 Client
Connections" (page 43) for more information.
Tip: Connections are stored in the connections.xml file and can be found by clicking the
Application Data Directory link in Help | About.
Create Excel Connections
Connecting to an Excel file is easy. To create the connection, simply open the Excel file from the Create New Connection dialog .
Toad Data Point Installation Guide
Create Connections
To create an Excel connection
1. Click on the Navigation or Connection Manager toolbar.
2. Select Excel from the Group list.
3. Browse to and select the Excel file.
4. Complete the Create New Connection dialog. Review the following for additional information:
General Tab
Category
Advanced Tab
Enable import mode
Show system tables
Automatically create ranges
Hide named ranges
Description
Select a category if you want to color code your connection.
Tip: The color is applied in the Connection Manager and other connection dialogs. You can also create a new category for your connection.
Description
Select this checkbox to set IMEX=1 in the connection string, which converts intermixed data to text.
Select to display worksheets as system tables. Toad uses the worksheet name suffixed with a dollar sign ($).
Select this option if you want Toad to automatically create named ranges. Toad creates one named range in each worksheet (unless the Toad name, AutoRange_<worksheet name>, already exists).
Note: Toad does not overwrite the user defined named ranges. The Toad-created named ranges and the user defined named ranges are both visible in the Object Explorer after connecting.
Deselect this option if the Excel file contains user defined named ranges and you do not want Toad to create additional named ranges.
Important: If you deselect this option, and your Excel file does not contain named ranges, Toad is unable to create tables from your data.
The feature is selected by default.
Select the named ranges to hide.
Note: Named ranges are not displayed until after a connection is created (in the Connections or Connection
Properties dialog). In Excel 2007 files, named ranges are not displayed for active connections.
56
Toad Data Point Installation Guide
Create Connections
57
Open in
Excel
Click to open the selected file in Excel. This is useful if you want to modify your file or define named ranges before connecting.
4. Click Connect to connect immediately while saving the connection information.
Optionally, click Save to save the connection without connecting.
Understand how Toad creates data tables from an Excel file
Toad uses Excel named ranges (regions) to define the data to include in a table. Therefore, any data that you want to display and easily query in Toad must be included in an Excel named range (region).
You can create named ranges using one of the following methods: l
Preferred method: You can ask Toad to automatically create named ranges when you create the connection to the Excel file. Toad creates one table from each worksheet and includes the contents of every formatted cell.
l
If you do not want to include a worksheet's entire contents in one named range, or if a worksheet contains more than one table, then define the named ranges ahead of time in Excel.
To create a named range in Excel
1. In the Excel file, select the data that you want to include in the table (including column headings). Then define a named range.
» In Excel 2003, select Insert | Name | Define.
» In Excel 2007, right-click the data and select Name a Range.
2. Save your Excel file. In Toad, create a new connection to the file. In the New
Connection dialog, deselect Automatically create ranges.
To allow Toad to automatically create named ranges
» When creating a new connection to the Excel file, in the New Connection dialog, select Automatically create ranges. Toad creates one named range for each worksheet and includes the contents of every formatted cell.
Tip: For an Excel file with an existing connection, in the Navigation Manger, right-click the file and select Properties. On the Advanced tab, select Automatically create ranges. Toad creates the named ranges the next time you reconnect to this file.
To hide named ranges
You can hide an Excel file's named ranges so that they do not display as tables in the
Object Explorer.
Toad Data Point Installation Guide
Create Connections
58
1. In the Navigation Manager, right-click an Excel file connection and select Properties.
Note: In Excel 2007 files, the connection must be inactive for the named ranges to display.
2. On the Advanced tab, select the named ranges to hide.
To view or modify connection properties
To view an Excel connection's properties, do one of the following: l
Right-click an Excel file connection in the Navigation or Connection Manager and select Properties.
l
Select on the Connections toolbar to open the Connections dialog. Select the Excel file connection in the left pane to view the connection properties in the right pane.
Considerations and Limitations
Consideration/Limitation
Excel 2016 64-bit or
Office 365 64-bit
Description
To successfully create a connection to an Excel file using Excel 2016 64-bit, the Microsoft Access
Database Engine is required and might not have been included in the Excel installation. In addition, the architecture (bitness) of the engine must match the bitness of Toad.
If using 64-bit Toad, the 64-bit version of
Microsoft Access Database Engine is required.
If using 32-bit Toad, the 32-bit version of
Microsoft Access Database Engine is required.
1. You can download the 64-bit or 32-bit
Microsoft Access Database Engine components at: https://www.microsoft.com/enus/download/details.aspx?id=13255 .
2. Be sure to select the appropriate version
(64-bit or 32-bit) of the
AccessDatabaseEngine.exe installer to match the bitness of Toad.
Note: This requirement applies only to connections to Excel, not to the Toad functionality of importing/exporting to Excel.
See "Troubleshoot Excel® Issues" (page 88) for more information about troubleshooting
Excel connection issues.
Click here to view a video about creating connections in Toad Data Point
Toad Data Point Installation Guide
Create Connections
59
Tip: Connections are stored in the connections.xml file and can be found by clicking the
Application Data Directory link in Help | About.
Create Google Analytics Connections
Toad allows you to create connections to your Google Analytics data. A connection in Toad allows you to access the Google Analytics accounts and data that are available to you from your Google user account.
If you have multiple Google user accounts, you can create a separate Google Analytics connection in Toad for each account. For an explanation of Google accounts, see the following: https://developers.google.com/analytics/resources/concepts/gaConceptsAccounts
Note: This feature is available in the Toad Data Point Professional Edition only.
About Google Analytics Connections
When you create a Google Analytics connection in Toad, you log in to Google using your
Google account. During the connection creation process, you also grant Toad access to the
Google Analytics data accessible from that Google account.
Toad provides you with an interface to the Google log-in and authorization pages and displays these pages within the Create New Connection (and Connection Properties) dialog.
The Google pages displayed are independent of Toad. The log-in process is the same as you normally encounter with your other Web-based Google log-in procedures. The only difference is that by creating a connection in Toad, you are giving Toad permission to access your Google Analytics data. This is accomplished when you click Accept in the Google authorization page.
Create Google Analytics Connections
To create a Google Analytics connection
1. Click on the Connections toolbar (ALT+F+N).
2. In the Group list, select Google Analytics. The Google log-in page immediately displays within the Create New Connection dialog.
3. Enter the credentials (email address and password) for your Google account and click Sign in.
Note: If you have multiple Google accounts and have previously logged in to Google
(or connected through Toad), the Google log-in page may display the last Google account used. To specify a different Google account for the new connection, use the
Google links/menu to select another account.
4. (optional) You can enter a name for your new account and select a category. You can also make these modifications later using the Connection Properties dialog.
5. In the Google authorization page that displays, click Accept to allow Toad access to
Toad Data Point Installation Guide
Create Connections
60 your Google Analytics data. Toad then attempts to establish a connection to Google
Analytics. If the connection is successful, the Create New Connection dialog closes.
6. Upon creating an initial connection, Toad automatically maps the data source objects.
This process runs in the background, and until it is finished, you may experience a delay when attempting to access these objects.
Reauthorizing a Connection
If you encounter an error message when attempting to connect using your Google Analytics connection, Toad's authorization (access) to the Google account for that connection may have been lost. Use the following procedure to re-establish authorization for the connection.
You can also use this procedure to specify a different Google log-in account for a connection.
To Reauthorize
1. In the Navigation Manager, disconnect from the connection. You must disconnect before you can re-authorize.
2. After disconnecting, right-click the connection and select Properties.
3. In the Connection Properties dialog, click Reauthorize.
l
If you are no longer logged in to Google, the Google log-in page displays.
l
To reauthorize using the same Google account, re-enter your Google account credentials and click Sign-in. Then click Accept on the authorization page.
l
To specify a different Google account for this connection, use the
Google links to switch the account just as you normally would in the
Google Web site. Once you specify a different account, this is the
Google account associated with this connection in Toad. Click Sign-in.
Then click Accept on the authorization page.
l
If you are still logged in to Google, the Google page for granting Toad access to your Google Analytics data displays.
l
To reauthorize using the same Google account, click Accept.
l
To specify a different Google account for this connection, use the
Google menu or links to switch the Google account just as you normally would in the Google Web site. Once you specify a different account, this is the Google account associated with this connection in
Toad. Click Sign-in. Then click Accept on the authorization page.
Notes:
l
You can specify a proxy server to use for Business Intelligence and NoSQL connections at Tools | Options | Database | Data Services.
Toad Data Point Installation Guide
Create Connections
Create Hive Connections
Toad allows you to connect to a Hive data warehouse system. Apache Hive is one of the
NoSQL data sources supported by Toad.
Note: This feature is available in the Toad Data Point Professional Edition only.
To create a Hive connection
1. Click on the Connections toolbar (ALT+F+N).
2. Select Apache Hive from the Group list.
3. Enter the connection information in the Create New Connection dialog. Review the following for additional information:
Server tab
Host
Port
Schema
Server type
Use SSL
HTTP mode
Session
Initialization
Category
Authentication tab
(HiveServer1)
Enter the host name or IP address of the Hive data source.
Enter the port number.
Enter a Hive schema to open upon connection.
(HiveServer2 only) After connecting, you can select a different available schema in the Object Explorer.
Select the version of HiveServer the host uses, HiveServer1 or HiveServer2.
(HiveServer2 only) Select to use SSL to connect to Hive.
(HiveServer2 only) Select to connect to HiveServer2 running in HTTP mode. Then enter the service endpoint.
The default is cliservice.
(HiveServer1 only) Enter any Hive session initialization commands.
These commands will be executed once, at the start of each connection.
(Optional) Select an existing category or create a new one.
61
Toad Data Point Installation Guide
Create Connections
Connect with
SSH
SSH user
SSH port
Authenticate with a key file
Authenticate with a password
Select to use SSH to connect to Hive. Then enter a user name and select an authentication method (key file or password).
Enter the user name to log in when using SSH.
Select the SSH port number. The default is 22.
Select if the host uses a key file to authenticate the SSH user field.
Private key path—Enter the absolute path (including file name) to the private key file on the host (not the client).
Pass phrase—Enter your passphrase.
Select if the host uses a password to authenticate the SSH user field.
Password—Enter the password to log in using SSH.
Authentication tab
(HiveServer2)
Authentication
Username
Hive host realm
Select an authentication method.
To enter only a user name, select the Username and
password method.
Enter the user name to use for this connection.
If using Kerberos authentication, enter your user name in the following format: user@REALM or domain\user.
(Kerberos only) Enter the Kerberos realm of the HiveServer2 host.
Note: If necessary, contact your IT department to obtain this information.
Before you can successfully connect to Hive using Kerberos authentication, the Toad client computer must have a
Kerberos Key Distribution Center (KDC) address entry for the Hive host realm. To define the KDC entry, use the following procedure.
Open a Windows Command Prompt as Administrator and enter the following command: ksetup /addkdc <REALM> <KDC name>
You only need to run this command once for the given realm. To confirm the setting, enter the following command: ksetup
. This command should return both the name of the
Hive host realm and the KDC name you specified.
62
Toad Data Point Installation Guide
Create Connections
63
Hive host FQDN
(Kerberos only) Enter the fully-qualified domain name
(FQDN) of the HiveServer2 host.
Note: If necessary, contact your IT department to obtain this information.
Service name (Kerberos only) Enter the service name of the Hive server.
The default is hive.
Note: In NoSQL and Business Intelligence connections, Toad automatically saves the password in the connections.xml file as obfuscated text, as well as in Toad.
To add additional password security, use Toad's Master Password feature.
4. Click Connect to connect immediately while saving the connection information.
Optionally, click Save to save the connection without connecting.
5. Upon creating an initial connection, Toad automatically maps the data source objects.
This process runs in the background, and until it is finished, you may experience a delay when attempting to access these objects.
Tips:
l
Connections are stored in the connections.xml file and can be found by clicking the
Application Data Directory link in Help | About.
l
You can specify a proxy server to use for Business Intelligence and NoSQL connections at Tools | Options | Database | Data Services.
Create a Connection to Intelligence Central
Toad allows you to create a connection to a Toad Intelligence Central server.
The purpose of Toad Intelligence Central (TIC) is to give Toad Data Point users a place to store and share data. After creating a connection to an Intelligence Central instance, not only can you view data that is made available to you, you can publish data from other sources in the form of snapshots, views, and datasets.
Note: This feature is available in the Toad Data Point Professional Edition only.
About Toad Intelligence Central Connections
To create a new TIC connection, you must provide the TIC server name and then register with TIC by creating a new user account for yourself. The new user name and password will be used by TIC to identify you from among the group of TIC users and to manage the objects you create and are granted access to on the TIC server.
A TIC connection displays in the Navigation Manager in the format: username@server. The
username is the name of the new user you create when you create a new TIC connection.
Toad Data Point Installation Guide
Create Connections
64
To create an Intelligence Central connection
1. Click on the Connections toolbar (ALT+F+N).
2. Select Intelligence Central from the Group list.
3. Select the Register New User tab.
4. Register New User. Use this tab to register with Intelligence Central by creating your own account (user name and password). Review the following for additional information:
Note: If you are creating a connection to a Intelligence Central instance for which you already have a user account, do not fill in this tab again. Skip ahead to the next step
(Login tab).
Register New
User
Use Windows
Authentication
Host
User Name
Password
Verify
Password
Full Name
Select to create a new user account using your Windows credentials. Toad automatically populates the fields with
your account information. See Limitations of Using
Windows Authentication (page 66).
Enter the name of the Intelligence Central host server. Click to display a list of Intelligence Central servers currently active on the network.
Create a new user name for this connection.
This is the name you will be logged in with. The objects you create will be linked to this user name. All your TIC rights (like sharing) will be linked to this user name. This user name will display in your connection in the Navigation
Manager in the format:
username@server
Note: User names must be lower case only. When you enter a user name, all upper-case characters are automatically converted to lower-case.
Create a password.
Re-enter the password to confirm.
Enter your full name.
This name, along with your user name, displays on the
Sharing tab of the Publishing dialog and in the Alter
Visibility dialog. Your full name will help users identify you when they select users with which to share an object.
Toad Data Point Installation Guide
Create Connections
65
Email Address
Port
Enter your email address.
Enter the port number for the App Server.
5. Login as Existing User tab. Use this tab to create a new connection to a TIC server for which you already have a user account. (When you open an existing connection, this tab displays your user account information.)
Login as
Existing User
Host
User
Password
Data Source
Port
Category
Enter the name of the Intelligence Central host server. Click to display a list of Intelligence Central servers currently active on the network.
Enter an existing server user name.
Enter the existing password for the user name.
(Optional) Enter the name of a default data source to open upon connection.
Enter the port number for the App Server.
(Optional) Select an existing category or create a new one.
6. Advanced tab. (Optional) Use the Advanced tab to specify ODBC drivers to use when publishing to this TIC server. You can also modify the logging level
(debug mode).
Note: Specify an ODBC driver only if you are having difficulty publishing to this
TIC instance from a particular database type.
Advanced
ODBC Drivers Specify an ODBC driver for each database type that you are having difficulty publishing from. That ODBC driver will be used when publishing from this database type using this connection.
Run in Debug
Mode
Select this option to increase the logging level for logs generated by this Intelligence Central instance, including the
App Server, Scheduler, and Hub logs. Use this option for debugging purposes.
Important: Selecting this option can generate very large log files and impact performance. Additionally, the log files are included in the support bundle of other Toad Data Point users with this Intelligence Central connection. Consider
Toad Data Point Installation Guide
Create Connections
66 clearing this option after debugging.
Tip: You can set the logging level for the Scheduler separately. See Configure Automation Script Scheduler for more information.
7. (Optional) Select Save Password to save your password with this connection.
8. Click Connect to connect immediately and save the connection information.
Optionally, click Save to save the connection without connecting.
To change your Intelligence Central user password
You can change your password for your Intelligence Central user account at any time.
Note: You cannot use this procedure to change the password for a Intelligence Central account that uses Windows Authentication.
1. In the Navigation Manager, right-click the Intelligence Central connection and select
Change Password.
2. Enter the old password and then enter the new password. Enter the new password a second time to confirm.
To switch your TIC user account to a Windows Authentication account
You can switch your current Intelligence Central account to a Windows Authentication account if both accounts have the same user name.
1. In the Connection Manager, right-click your current TIC account connection and select Properties.
2. In the Register New User tab, select Use Windows Authentication. Toad prompts you to switch your account.
Limitations of Using Windows Authentication
Consideration/Limitation Description
Windows Authentication connection and crossconnection query
Publishing data objects from a Windows
Authentication connection is not supported
Cross-connection query using a Windows Authentication
Intelligence Central connection is not supported.
Workaround: To use an Intelligence Central connection in a cross-connection query, log-in using a standard
Intelligence Central user account, not a Windows
Authentication account.
You cannot publish a data object (view or snapshot) from one Intelligence Central instance, TIC1, to another, TIC2, if you are connected to TIC1 using Windows
Authentication.
Workaround: To publish a data object from Intelligence
Toad Data Point Installation Guide
Create Connections
67
Consideration/Limitation Description
Central, please connect to TIC using a standard
Intelligence Central user account, not a Windows
Authentication account.
Tip: Connections are stored in the connections.xml file and can be found by clicking the
Application Data Directory link in Help | About.
Create MySQL or MariaDB Connections
You can create a new connection, or connect to an existing connection from the Create New
Connection window. See "Troubleshoot MySQL Issues" (page 98) for more information about
troubleshooting MySQL connection issues.
To create a MySQL or MariaDB connection
1. Click on the toolbar (ALT+F+N).
2. Select either MySQL or MariaDB from the Group list box.
3. Review the following for additional information:
Login Tab
Connection type
Host
Description
Select the protocol to use when connecting.
Password
Connection timeout
SSL
Enter the name of the host computer where the database is installed.
Enter the password to use when connecting.
Tip: After connecting, you can set a master password to further secure your connection in Tools | Options| Environment |
Security.
Enter the number of seconds to wait when connecting before the application times out. The default is 15 seconds.
If you selected SSL as the connection type, review the following for additional information: l
Private key—browse to the location of the SSL key file to use when connecting.
l
CA cert—browse to the location of the trusted certificate
Toad Data Point Installation Guide
Create Connections
68
Compress
Use
MySQL libraries
Category authority to use when connecting.
l
Cert—browse to the location of the SSL certificate file to use when connecting.
Select this checkbox to compress the value of any strings and return binary values.
Select this checkbox to use an embedded MySQL library instead of the MySQL .NET provider.
Note: If you select this option, you must specify libMySQL.dll in the path.
Select or create a category if you want to color code Editor tabs for a specific connection. This can help differentiate between development and production databases. You can also set an option to color code the Object Explorer pane and object editor windows (Create, Alter, Drop, etc.).
Click here to view a video of this feature.
Description Advanced
Tab
ODBC driver
Select an ODBC driver to use when executing cross-connection queries using this connection.
Tip: You can specify the ODBC driver to use for all connections for this database provider in Tools | Options
| Database | MySQL.
4. Click Connect to save the connection and immediately connect to the database.
or
Click Save to save the connection without connecting to the database.
Tip: Connections are stored in the connections.xml file and can be found by clicking the
Application Data Directory link in Help | About.
Click here to view a video about creating connections in Toad Data Point
Create ODBC Connections
Toad Data Point allows you to create a connection to a database that supports an ODBC 3.0
or later driver. ODBC connectivity provides basic querying capability, but may not be as full-featured as a native connection in Toad. For a list of databases tested with the ODBC provider, see the Release Notes.
This form of connectivity allows connections to databases such as Netezza, IBM iSeries,
Ingres, and Vertica.
Toad Data Point Installation Guide
Create Connections
69
Note: Distinct values are not available in Code Completion for ODBC connections.
DSN Architecture (Bitness) Must Match Toad
To create a successful ODBC connection, the architecture (bitness) of the driver in the specified DSN must match the architecture (bitness) of Toad. For example, 64-bit Toad requires an applicable 64-bit driver and 32-bit Toad requires an applicable 32-bit driver.
To create an ODBC connection
1. Click on the toolbar (ALT+F+N+O).
2. Select ODBC Generic from the Group list box.
3. Click
4. Click Add.
in the Data Source Name field.
5. Select an ODBC driver from the list, and click Finish.
Note: If creating an Oracle ODBC connection, select the ODBC driver provided by
Oracle. The Microsoft ODBC for Oracle driver has less functionality than the driver provided by Oracle.
6. Specify the configuration properties required for the database in the windows configuration dialog.
Notes:
l
If you have an Oracle database with Unicode data, make sure to select Force
SQL_WCHAR Support on the Workarounds tab of the windows Oracle ODBC
Configuration dialog. If you do not, you will not be able to see the data.
l
If creating a MySQL ODBC connection to use in a cross-connection query, you must specify a database in the Windows MySQL ODBC
Configuration dialog.
7. Specify the connection properties in the Create New Connection dialog. Review the following for additional information:
General
Use data source name
Data source name
Select to display the Data source names.
Do not select this option if you want to display the driver names.
Select the driver or data source name you added in the previous steps.
Toad Data Point Installation Guide
Create Connections
User
Password
Database
Enter the user name to use when connecting.
Enter the password to use when connecting.
Tip: After connecting, you can set a master password to further secure your connection in Tools | Options| Environment |
Security.
Select a database or schema. Click to create a temporary connection and display available databases/schemas in the dropdown list.
Information
Data
Source
Name
Driver
Advanced
Default
Table
Column
Displays the selected driver or data source name.
Displays the ODBC driver associated with the data source.
Advanced
Options
Category
Specify default options to use when creating a new table.
Column type—Select the default data type to use when creating a table.
Column length—For the selected column type, enter a default column length to use.
Block Cursor Size—Specify the number of rows to return in a single fetch of data from the result set.
Disable multi-threading—Multi-threading is disabled by default. Enable multi-threading only if supported by the driver.
Multi-threading can improve performance, but can also result in unpredictable behavior if not supported by the driver.
Default: Selected
(Optional) Select an existing category or create a new one.
8. Click Connect to connect immediately while saving the connection information.
Optionally, click Save to save the connection without connecting.
Tip: Connections are stored in the connections.xml file and can be found by clicking the
Application Data Directory link in Help | About.
Click here to view a video about creating connections in Toad Data Point
70
Toad Data Point Installation Guide
Create Connections
71
Configure Oracle LDAP Support
You can create Oracle Lightweight Directory Access Protocol (LDAP) connections when your Oracle client is configured for LDAP. Once the client is configured, Toad retrieves names from your LDAP server and displays them in the Database Name list in the Create
New Connection window.
Notes:
l
To connect using LDAP, you must install an Oracle client on the computer.
l
Toad supports a 9i, 10g, and 11 client and the Oracle Instant client. If you want to use
the instant client, you must configure it to work with Toad. See "Configure the Oracle
Instant Client" (page 72) for more information.
To configure the Oracle client for LDAP
1. Obtain the LDAP.ORA file from your database administrator.
2. Copy the LDAP.ORA file to the folder where the SQLNET.ORA file for your Oracle client is located. The default folder is: ORACLE_HOME\network\admin
3. Open the SQLNET.ORA file and enter "(LDAP)" as the value for the
NAMES.DIRECTORY_PATH as follows:
NAMES.DIRECTORY_PATH= (LDAP)
Note: If you are using multiple naming methods, add the (LDAP) value to existing parameter values. For example, if you are using both the TNSNAMES and LDAP naming methods, add LDAP to TNSNAMES as follows:
NAMES.DIRECTORY_PATH= (TNSNAMES, LDAP)
4. Save the SQLNET.ORA file.
5. Launch Toad and select File | New | Connection.
6. Create an LDAP connection following the procedure in Create Oracle Connections
(page 71). In step 3, select a database on the LDAP server from the Database Name
list. Toad retrieves the list of LDAP names from the LDAP server once per Toad session. To refresh the list, click .
Create Oracle Connections
You can create a new connection, or connect to an existing connection from the Create New
Connection window.
Click here to view a video about creating connections in Toad Data Point
Toad Data Point Installation Guide
Create Connections
72
Tip: You can configure Toad Data Point to accept connection information from Toad for Oracle.
Client Connection or Direct Connection
You can connect to your database using a native Oracle database provider in Toad using one of the following methods:
Connection Method
Client connection
Client tab—Uses an installed Oracle Client or
Oracle Instant Client to establish a connection to the database from Toad.
Advantages
Supports LDAP
Disadvantages
Requires an Oracle client
Note: Toad supports Oracle clients and Oracle Instant clients using version 9i or later.
Direct connection
Direct Connect tab—
Uses TCP/IP to connect directly to the database.
Does not require an installed Oracle
Client
Recommended for connecting to
Oracle 8i databases
This method only supports common data types. Some advanced Oracle object types cannot be retrieved when connecting using this method.
This method does not support
LDAP. (To connect using LDAP, use the Client Connection method instead.)
This method cannot be used in a cross-connection query.
Note: Dell recommends using one of the methods described in this table to connect to
Oracle rather than an ODBC driver. Because ODBC connectivity is generic, it is not fullfeatured and may not be as robust as the fully exploited native database provider.
Configure the Oracle Instant Client
The Oracle Instant client installs only those files needed to connect to your database using
OCI. Because this client does not write to the registry (no ORACLE_HOMES) or add to the environmental path, you must manually set environment variables so the client can be used with Toad.
To configure the Oracle Instant Client to work with Toad
1. Save the Oracle Instant Client files in any location on the computer where Toad is installed.
2. On your Windows desktop, right-click My Computer and select Properties.
3. Select the Advanced tab and click Environment Variables.
Toad Data Point Installation Guide
Create Connections
4. Click New under System Variables and complete the following:
Variable name
PATH
Variable Value
<Path where Instant Client is installed>;%PATH%
For Example: C:\Program Files\OracleInstantClient;%PATH%
<Path where tnsnames.ora file is installed>
TNS_
ADMIN
5. To use the Oracle Instant Client connection in a cross-connection query, you must also install an Oracle ODBC driver. (While the Oracle Client full install includes an
ODBC driver, the Oracle Instant Client does not.)
Note: You cannot use an Oracle Direct Connection in a cross-connection query.
Create an Oracle Connection
To create an Oracle connection
1. Click on the toolbar (ALT+F+N).
2. Select Oracle from the Group list box.
3. Review the following for additional information:
Login Tab
Database name
Password
Connect as
Description
Select the alias to use when connecting. This list displays aliases from LDAP, as well as any local tnsnames.ora file.
When you initially open the connection dialog, Toad retrieves the list of LDAP names from the LDAP server. Toad caches this list and displays it upon subsequent requests, within one Toad session. To refresh the list, click .
Note: If you do not select a database, Toad uses the ORACLE_
SID for the selected home. If an ORACLE_SID value does not exist and you do not specify a database, you cannot connect.
Enter the password to use when connecting.
Tip: After connecting, you can set a master password to further secure your connection in Tools | Options| Environment |
Security.
Select whether to connect as either SYSDBA or SYSOPER if you have the appropriate permissions. Otherwise, use the default.
73
Toad Data Point Installation Guide
Create Connections
Schema
Explain plan table
Category
Save password
Oracle
Client Tab
Current home
TNSNames
Editor
Select a schema if you frequently work in a different schema than the one associated with your user name.
(Optional) Specify the location of an existing explain plan table to use instead of Toad automatically creating one for you when you execute a statement. This is useful if you do not have necessary permissions to create explain plan tables or want to use an existing table.
Select or create a category if you want to color code Editor tabs for a specific connection. This can help differentiate between development and production databases. You can also set an option to color code the Object Explorer pane and object editor windows (Create, Alter, Drop, etc.).
Click here to view a video of this feature.
Select this checkbox if you plan to use Automation to generate reports.
Description
Modify the Oracle home to use, if needed.
SQLNET
Editor
Direct Tab
SID
Advanced
Tab
ODBC driver
Click this button to edit your local TNSNames file.
Tip: You can press CTRL+F to open the Find/Replace window to locate entries in the TNS Names Editor. Pressing F3 locates the next entry that matches your criteria.
Click this button to edit SQLNET.ORA parameters. Before editing this file, you should create a backup copy. See
SQLNET.ORA Profile Parameters in the Oracle documentation for more information.
Description
Enter the ORACLE_SID value for the database. This value is specified in the registry under each installed home.
Description
If an Oracle Client is installed, the default is the Oracle ODBC driver.
If an Oracle Client is not installed, the default is the Microsoft
Access ODBC driver.
Tip: You can specify the ODBC driver to use for all
74
Toad Data Point Installation Guide
Create Connections connections for this database provider in Tools | Options
| Database | Oracle.
4. Click Connect to connect immediately while saving the connection information.
Optionally, click Save to save the connection without connecting.
Tip: Connections are stored in the connections.xml file and can be found by clicking the
Application Data Directory link in Help | About.
Create Oracle Business Intelligence Connections
Toad allows you to connect to the presentation layer of an Oracle Business Intelligence
Enterprise Edition (OBIEE) data source.
Note: This feature is available in the Toad Data Point Professional Edition only.
To create an Oracle Business Intelligence Enterprise connection
1. Click on the Connections toolbar (ALT+F+N).
2. Select Oracle BI Enterprise from the Group list.
3. Enter the connection information in the Create New Connection dialog. Review the following for additional information:
URL
Password
Row Limit
Enter the URL to the Oracle Business Intelligence Enterprise data source to which you want to connect.
Note: You must include the port number in the URL as in the following examples: format—http://<server path>:<port>/analytics/saw.dll
example—http://server01.mycompany.com:80/analytics/saw.dll
Enter the password to use when connecting.
Tip: After connecting, you can set a master password to further secure your connection in Tools | Options| Environment |
Security.
Select a row limit to enforce for query results.
default = 500,000
Category (Optional) Select an existing category or create a new one.
Note: In NoSQL and Business Intelligence connections, Toad automatically saves the password in the connections.xml file as obfuscated text, as well as in Toad.
To add additional password security, use Toad's Master Password feature.
4. Click Connect to connect immediately while saving the connection information.
75
Toad Data Point Installation Guide
Create Connections
76
Optionally, click Save to save the connection without connecting.
5. Upon creating an initial connection, Toad automatically maps the data source objects.
This process runs in the background, and until it is finished, you may experience a delay when attempting to access these objects.
Important Information about Oracle BI Connections
You must incorporate the port into the OBIEE database connection URL in the following format: http://<server name>:<port>/analytics/saw.dll
An example URL is http://server01.mycompany.com:80/analytics/saw.dll
Tips:
l
Connections are stored in the connections.xml file and can be found by clicking the
Application Data Directory link in Help | About.
l
You can specify a proxy server to use for Business Intelligence and NoSQL connections at Tools | Options | Database | Data Services.
Create Salesforce Connections
Toad allows you to connect directly to Salesforce.com, one of the business intelligence data sources supported by Toad. Toad supports authentication using either a Salesforce security token or single sign-on with your corporate credentials.
Note: This feature is available in the Toad Data Point Professional Edition only.
To create a Salesforce connection
1. Click on the Connections toolbar (ALT+F+N).
2. Select Salesforce from the Group list. The Create New Connection dialog opens.
3. To create a Salesforce connection using your Salesforce email login, select the
Credentials tab.
a. Enter the connection information. Review the following for additional information:
URL
Username
Enter the Salesforce.com URL to which you want to connect.
Note: An example is https://login.salesforce.com.
Enter your email login.
Note: You must have a Salesforce email login to create this type of connection to Salesforce.com from
Toad Data Point Installation Guide
Create Connections
77
Password
Security token
Category
Toad.
Enter the password to use when connecting.
Tip: After connecting, you can set a master password to further secure your connection in Tools
| Options| Environment | Security.
Enter your Security Token provided by Salesforce.
Note: You must have a Salesforce security token to create this type of Salesforce.com connection from
Toad. See "Important Notes about Salesforce
Connections" (page 78) for more information.
(Optional) Select an existing category or create a new one.
b. After entering the connection information, click Connect to connect immediately while saving the connection information. Optionally, click Save to save the connection without connecting.
4. To create a Salesforce connection using your corporate credentials (single sign-on), select the Corporate Credentials tab.
a. Enter your company's custom Salesforce URL. An example is https://company.my.salesforce.com or http://salesforce.servername.
Note: If you authenticate and request login to Salesforce through your company's server (e.g., http://salesforce.servername), you may need to contact your IT department to obtain the full URL to enter in this step.
b. If the Salesforce log-in page displays, enter your corporate credentials (user name and password) and click Log in to Salesforce.
Note: The Salesforce log-in page does not display when authenticating through your company's server.
c. The Salesforce consent page displays. Click Allow to allow Toad access to your Salesforce data.
5. Upon creating an initial connection, Toad automatically maps the data source objects.
This process runs in the background, and until it is finished, you may experience a delay when attempting to access these objects.
Note: In NoSQL and Business Intelligence connections, Toad automatically saves the password in the connections.xml file as obfuscated text, as well as in Toad. To add additional password security, use Toad's Master Password feature.
Manual Single Sign-On
Use the manual single sign on method when you want to create a Salesforce connection using your corporate credentials but you are having problems accessing Salesforce from Toad,
Toad Data Point Installation Guide
Create Connections
78 for example, if Toad does not have access to the Internet.
Create a Salesforce.com connection - manual single sign-on
1. In the Create New Connection dialog, select the Manual Single Sign On tab.
2. Log-in to your Salesforce.com account using your browser. After you log-in, copy the full URL from the browser's address bar and paste it into the text box under Step 1 in the Manual Single Sign On tab.
3. A URL appears in the text box under Step 2. Copy this URL and then paste it into the address bar in your browser.
4. The Salesforce consent page displays. Click Allow.
5. A page displays containing the authorization code. Copy the code and paste it into the text box under Step 3. Then click Connect.
Reauthorizing a Connection (If Using Corporate Credentials)
If you encounter an error message when attempting to connect to Salesforce using your corporate credentials connection, Toad's authorization (access) to Salesforce may be lost. Use the following procedure to re-establish authorization for the connection.
To Reauthorize
1. In the Navigation Manager, disconnect from the connection. You must disconnect before you can re-authorize.
2. After disconnecting, right-click the connection and select Properties.
3. In the Connection Properties dialog, click Reauthorize in the Corporate
Credentials tab.
4. If the Salesforce log-in page displays, re-enter your corporate credentials.
Note: The Salesforce log-in page does not display when authenticating through your company's server.
Important Notes about Salesforce Connections
l
If you connect to Salesforce using a proxy, you must define the proxy server in Toad.
See Data Services Options for more information.
l
A Security Token is required to log on to Salesforce.com from Toad, using your
Salesforce email login.
l
For information about how to generate a new security token, see the Salesforce documentation at https://login.salesforce.com/help/doc/en/user_security_token.htm
.
l
You may need to have your IP address included in your organization's list of trusted
IP addresses. For more information, see the Salesforce documentation at http://www.salesforce.com/us/developer/docs/api/Content/sforce_api_concepts_ security.htm
.
Toad Data Point Installation Guide
Create Connections
79
Tips:
l
Connections are stored in the connections.xml file and can be found by clicking the
Application Data Directory link in Help | About.
l
You can specify a proxy server to use for Business Intelligence and NoSQL connections at Tools | Options | Database | Data Services.
Create SQL Server and SQL Azure Connections
You can create a new connection, or connect to an existing connection from the Create New
Connection window. See "Troubleshoot SQL Server® Issues" (page 100) for more information
about troubleshooting connection issues.
Click here to view a video about creating connections in Toad Data Point
Note: For SQL Azure connections: l
To be able to utilize majority of Toad functionality please grant VIEW DEFINITION on the SQL Azure databases you want to work with.
l
You can login to Windows Azure Platform by selecting Tools | Cloud Computing |
SQL Azure Portal and providing your credentials.
l
Make sure that no Azure firewall rule restricts your IP address from having access to
Azure server. See "Create and Alter Azure Firewall Rules" in the online help for more information.
To create a new connection
1. Click on the toolbar (ALT+F+N).
2. Select Microsoft SQL Server or Microsoft SQL Azure from the Group list box.
3. Review the following for additional information:
Login Tab
Server name
Password
Description
Enter the name of the server to use when connecting.
Click to display any servers running SQL Server that are currently active on the network.
Notes:
l
For SQL Azure connections, enter
InstanceName.database.windows.net in this field.
l
For named instances, enter the
MachineName\InstanceName in this field.
Enter the password to use when connecting.
Toad Data Point Installation Guide
Create Connections
Category
Encrypt connection
Advanced Tab
Network protocol
Parameter
Name/Value
OBDC driver
Tip: After connecting, you can set a master password to further secure your connection in Tools
| Options| Environment | Security.
Select or create a category if you want to color code Editor tabs for a specific connection. This can help differentiate between development and production databases. You can also set an option to color code the Object Explorer pane and object editor windows (Create, Alter, Drop, etc.).
Click here to view a video of this feature.
Select this option to enable encryption for the current connection provided that the certificate has been already installed on the server.
Description
Select one of the following: l
Shared Memory l
TCP/IP l
Named Pipes
Note: When establishing Named Pipes connection
"Poll service status in connection list" option should be cleared.
You can add parameters to the connection. Toad includes the Application Name parameter with value Toad Data
Point by default.
Select an ODBC driver to use for this connection when creating cross-connection queries.
Tip: You can specify the ODBC driver to use for all connections for this database provider in Tools | Options
| Database | SQL Server.
4. Click Connect to save the connection and immediately connect to the database.
or
Click Save to save the connection without connecting to the database.
Tip: Connections are stored in the connections.xml file and can be found by clicking the
Application Data Directory link in Help | About.
80
Toad Data Point Installation Guide
Create Connections
81
To import connections (including Central Management Server connections)
1. Click .
2. Specify the location where the connections currently reside.
Note: Review the following for additional information on CMS connections: l
To import CMS connections, select a server from the list where the CMS is registered. The connection to this SQL Server instance should be created beforehand.
l
CMS is available beginning with Microsoft SQL Server 2008.
l
User should have an appropriate login (Windows Authentication and grant to connect to selected server are required) created on the server to which he connects via CMS.
3. Select the connections to be imported.
Create SQL Server Analysis Services Connections
Through Toad you can create a connection to a Microsoft SQL Server Analysis Services
(SSAS) data source. An SSAS connection in Toad allows you to access the multi-dimensional cubes from the data source.
Note: This feature is available in the Toad Data Point Professional Edition only.
Configure HTTP Access
Before connecting to SQL Server Analysis Services from Toad Data Point, you must configure the IIS Web server (to be used for connecting) for HTTP access to SSAS. See the following instructions from Microsoft: http://msdn.microsoft.com/en-us/library/gg492140
(v=sql.105).aspx
.
Connect to SQL Server Analysis Services
To create a SQL Server Analysis Services connection
1. Click on the Connections toolbar (ALT+F+N).
2. Select Microsoft SQL Server Analysis Services (SSAS) from the Group list.
3. Enter the connection information in the Create New Connection dialog. Review the following for additional information:
URI Enter the URL for the Analysis Services data source to which you want to connect.
Note: Toad connects to Analysis Services via http access. The
Toad Data Point Installation Guide
Create Connections
82
URL should have the following format: format—http://<server path>/msmdpump.dll
example—http://server01/olap/msmdpump.dll
Database
Username
Enter the name of the Analysis Services database to which you want to connect.
Enter the user name for the user account to be used in this connection.
Enter the password for the user account specified in Username.
Password
Category (Optional) Select an existing category or create a new one.
Note: In NoSQL and Business Intelligence connections, Toad automatically saves the password in the connections.xml file as obfuscated text, as well as in Toad.
To add additional password security, use Toad's Master Password feature.
4. Click Connect to connect immediately and also save the connection information.
Optionally, you can click Save to save the connection without connecting.
5. Upon creating an initial connection, Toad automatically maps the data source objects.
This process runs in the background, and until it is finished, you may experience a delay when attempting to access these objects.
Tips:
l
Connections are stored in the connections.xml file and can be found by clicking the
Application Data Directory link in Help | About.
l
You can specify a proxy server to use for Business Intelligence and NoSQL connections at Tools | Options | Database | Data Services.
Create SAP Connections
You can create a new SAP IQ, SAP SQL Anywhere, or SAP ASE connection, or connect to
an existing connection from the Create New Connection window. See "Troubleshoot SAP
Issues" (page 102) for more information about troubleshooting connection issues.
Click here to view a video about creating connections in Toad Data Point
Note: This topic focuses on information that may be unfamiliar to you. It does not include all step and field descriptions.
To create an SAP connection
1. Click on the toolbar (ALT+F+N).
2. Select SAP ASE, SAP IQ, or SAP SQL Anywhere from the Group list.
3. Enter the login information. Review the following for additional information:
Toad Data Point Installation Guide
Create Connections
Login Tab
Host
Password
CharSet
Category
Description
Enter the host name for the connection.
Note: This field is only available when you select an SAP IQ or
SAP SQL Anywhere connection.
Enter the password to use when connecting.
Tip: After connecting, you can set a master password to further secure your connection in Tools | Options| Environment |
Security.
Enter the client character set such as UTF-8 in this field if it differs from the default character set. This helps you avoid connection issues.
Notes:
l
This field is not case sensitive.
l
This field is only available when you select an SAP ASE connection.
Select or create a category if you want to color code Editor tabs for a specific connection. This can help differentiate between development and production databases. You can also set an option to color code the Object Explorer pane and object editor windows (Create, Alter, Drop, etc.).
Click here to view a video of this feature.
Description Advanced
Tab
ODBC driver
Select an ODBC driver to use for this connection when creating cross-connection queries.
Tip: You can specify the ODBC driver to use for all connections for this database provider in Tools | Options
| Database | Oracle.
4. Click Connect to save the connection and immediately connect to the database.
or
Click Save to save the connection without connecting to the database.
Tip: Connections are stored in the connections.xml file and can be found by clicking the
Application Data Directory link in Help | About.
Create SAP HANA Connection
Note: This feature is available in the Toad Data Point Professional Edition only.
83
Toad Data Point Installation Guide
Create Connections
To create a SAP HANA connection
1. Click on the toolbar (ALT+F+N).
2. Select SAP HANA from the Group list box.
3. Specify the connection properties in the Create New Connection dialog. Review the following for additional information:
General tab
Host
Instance
Number
User
Password
Mode
Current
Schema
Description
Enter IP address (or the master host name).
Note: Enter the master host name. Host names for distributed systems are determined automatically. If the specified host is not available, the connection is established through one of the other hosts.
Enter a two-digit instance number.
Note: The communication port number is defined by: n
<instance> xy, where n is either 3 or 5, <instance> is a twodigit number representing the instance number of the SAP
HANA appliance, and xy represents a consecutive number.
Toad users only enter the instance number.
Enter the user name to use when connecting.
Enter the password to use when connecting.
Tip: After connecting, you can set a master password to further secure your connection in Tools | Options| Environment |
Security.
Select the database mode. SAP HANA supports numerous isolated databases in a single HANA system. Although each database in a multiple-container system is isolated, cross-queries can be performed and all databases share the same installation, resources, and administration.
Single-container — Select for single-container systems. These can be converted to multiple-container systems.
Multiple-container — Select for multiple-container systems.
These systems always have one system database, which is used for administration, and any number of tenant databases.
Select whether you want to connect to the System or Tenant
database. Users connect to a specific tenant database within the system using its database name.
Select a database schema. Click to create a temporary connection and display available schemas in the drop-down list.
84
Toad Data Point Installation Guide
Create Connections
85
Category Select or create a category if you want to color code Editor tabs for a specific connection. This can help differentiate between development and production databases. You can also set an option to color code the Object Explorer pane and object editor windows (Create, Alter, Drop, etc.).
Click here to view a video of this feature.
Description
(Optional) Select the default isolation level for this connection.
Options tab
Isolation
Level
Lifetime
(Optional) Specify a maximum value for connection lifetime by entering the length of time in seconds. The default value is 0, which specifies no maximum.
4. Click Connect to connect immediately while saving the connection information.
Optionally, click Save to save the connection without connecting.
Note: An SAP HANA ODBC driver is installed along with Toad Data Point and is required if using a HANA connection in a cross-connection query.
Tip: Connections are stored in the connections.xml file and can be found by clicking the
Application Data Directory link in Help | About.
Create Teradata Connections
Toad allows you to create a full-featured, native Teradata connection. This type of connection provides complete Query Builder, Query Editor, and Database Explorer functionality.
Notes:
l
You must have a Teradata .NET Data Provider installed before you can create a
Teradata connection.
l
To use a Teradata connection in a cross-connection query, you must have a Teradata
ODBC driver installed.
To install the Teradata data provider
» Download and install the Teradata .NET Data Provider from the Teradata Web site.
Use the version supported by your database version.
To create a Teradata connection
1. Click on the Connections toolbar (ALT+F+N).
2. Select Teradata from the Group list.
Toad Data Point Installation Guide
Create Connections
3. Enter the connection information in the Create New Connection dialog. Review the following for additional information:
Login
Server name
Use Single
Sign On
Password
Session mode
Use data encryption
Response buffer size
Enter the name of the server hosting the database to which you want to connect.
Select if the user is using a single sign-on authentication system.
Enter the password to use when connecting.
Tip: After connecting, you can set a master password to further secure your connection in Tools
| Options| Environment | Security.
Displays the session mode, which is always Teradata in a
Toad Teradata connection.
Default database
Category
Advanced
(Optional) Enter a default Teradata database for the connection.
(Optional) Select an existing category or create a new one.
Mechanism
(Optional) Select an authentication mechanism from the list.
Parameter
(Optional) Enter the parameters required by the selected authentication mechanism. See your system administrator for these values.
Account string
(Optional) Enter a new account string.
Character set Select a character set.
Note: When querying or viewing data in a column defined with GRAPHIC or CHARACTER SET GRAPHIC data type, you must specify a Character set of UTF-16 for the session.
Select if using data encryption.
Specify a Response Buffer Size (in bytes). This allows you to govern the number of rows returned in a single response.
To increase the number of rows per response, increase the response buffer size. This strategy might help to improve performance with larger data sets.
The default value in Toad is set to the maximum, 1040000 bytes.
86
Toad Data Point Installation Guide
Create Connections
87
4. Click Connect to connect immediately while saving the connection information.
Optionally, click Save to save the connection without connecting.
Tip: Connections are stored in the connections.xml file and can be found by clicking the
Application Data Directory link in Help | About.
To install a Teradata ODBC driver
» Download and install a Teradata ODBC driver from the Teradata Web site. For a list of supported Teradata ODBC drivers, please see the Release Notes for your version of
Toad Data Point.
Notes:
l
Toad does not support the Teradata multi-statement request.
l
You can specify which Teradata Data Directory views to use, X views or Non-X views, in Tools | Options | Database | Teradata.
Troubleshoot Connections
Troubleshoot Access Issues
Review the following solutions to help troubleshoot Access issues pertaining to missing functionality and object information and other problems in Toad.
See "Create Access Connections" (page 39) for more information about Access connections.
Missing Functionality and Object Information
Issue
Some queries display in the
View tab of the Object Explorer, but do not display in the Query tab.
Primary key information is unavailable.
Cause/Solution
The Access ODBC driver handles saved queries in the following manner: l
If the stored query does not contain parameters, it is treated as a view and displays in the View tab.
l
If the stored query contains parameters, it is treated as a stored procedure and displays in the Query tab.
The Microsoft Access ODBC driver does not return primary key information for databases. However, in some cases, Toad can obtain this information through additional methods.
Other Issues
Issue
A delay occurs between writing a value to a database via one connection and seeing the updated value via another connection.
Cause/Solution
This delay is the default when you are writing and reading data between two different Jet connections.
The delay occurs even if the two connections reside in the same client process.
Solution:
Use a single connection when updating data.
Troubleshoot Excel
®
Issues
Review the following to help troubleshoot and solve issues involving Excel files.
3
Toad Data Point Installation Guide
Troubleshoot Connections
See "Create Excel Connections" (page 55) for more information about Excel connections.
Excel Connections
Issue
Tables are limited to
256 columns and
65536 rows.
Column names longer than 64 characters are truncated and the remaining characters display as null.
Columns that include text values or special characters as part of a numeric value, as well as entries with straight numeric values, result in one of the value sets displaying as null.
Column names that contain an exclamation point (!) are not supported.
Cause/Solution
This is a known limitation with Excel worksheets.
This is a known limitation with Excel worksheets.
When you connect to Excel, the driver automatically scans the first eight rows in a column and applies the data type used in a majority of those rows to all rows in the column.
Any rows that do not meet the majority data type display as null values.
Solution 1: Reformat worksheet column and values as text.
1. Open the worksheet in Excel.
2. Format the column that contains mixed data types as
Text.
3. You can now connect to this spreadsheet from Toad without any null values displayed.
Solution 2: Create an ODBC connection.
You can force the ODBC driver to read all rows as Text to avoid null values; however, this can result in issues if you attempt to insert data.
1. Open the Create New Connection window and select
ODBC from the Group list.
2. Complete the fields as described in Create ODBC
3. Enter "IMEX=1", in quotations, in the
ExtraParameters field.
4. Click Connect.
The exclamation point character has a special meaning in
Excel. If a column name contains an exclamation point, it is internally converted to a dollar sign ($) character.
89
Toad Data Point Installation Guide
Troubleshoot Connections
Issue
Tables cannot be altered.
Cause/Solution
Tables cannot be altered when the Excel connection is Read-
Only.
Solution: Deselect Read-Only Connection in the Connection
Properties dialog.
Excel is a spreadsheet, and does not support primary and foreign keys so these tabs are always blank.
The Primary Keys and
Foreign Keys tabs are blank in the Database
Explorer.
Indexes cannot be created or dropped.
Unable to query Excel files without named ranges (regions).
The Excel ODBC driver does not support this functionality.
Attempting to connect to or create a new
Excel connection results in No user
tables could be found
message.
Unable to query data using an empty string or null value.
The worksheet you are querying does not have named ranges
(regions) defined.
Solution:
You can query the worksheet from the Editor by entering a dollar sign ($) followed by a cell range to limit the results similar to the following statement:
Select * from (MyWorksheet$A1:C10)
You can also query the entire worksheet by entering a dollar sign ($) after the worksheet name. However, this may also return the worksheet's empty rows and columns.
The Excel file does not have named ranges (regions) defined.
If you click OK to close the message, the new connection is created, but no user tables display in Object Explorer.
(System tables are displayed, if you selected to show these.)
Solution 1: In the Excel file, create named ranges.
Solution 2: Ask Toad to automatically create named ranges.
1. Disconnect from the file.
2. In Navigation Manager, right-click the file and select
Properties | Advanced.
3. Select Automatically create ranges.
The next time you connect, Toad automatically creates named ranges, which are then displayed as tables.
See "Create Excel Connections" (page 55) for more information.
The underlying data format cannot differentiate between an empty string and null data, so a query with a search condition that contains an empty string does not match any
90
Toad Data Point Installation Guide
Troubleshoot Connections
Issue
Unable to update or delete rows in a table.
Attempting to insert data results in Cannot
expand named range
error.
Cause/Solution
empty strings in the table. This occurs because the empty string is treated as a null value, and a null value never matches anything, not even another null value.
The Excel ODBC driver does not support this functionality.
While it is possible to update values, DELETE statements do not remove a row from a table. Basically, you can only insert data in a table.
This error occurs if you have more than one named range
(region) in the same worksheet, and the named ranges are not separated by blank rows.
Solution 1: You must add blank rows between named ranges.
Add as many blank rows as you have new records to insert.
Solution 2: Include only one named range in each worksheet.
Opening Excel Files in Toad Document Window
Issue
Excel menus do not display when you open Excel files in a Toad document window.
When two or more instances of
Excel are open in Toad document windows, toolbars are active for only one instance.
Cause/Solution
The Toad document window cannot display all
Excel menus.
Solution:
Right-click the Excel toolbar and add the equivalent toolbar for the missing menu or functionality.
Toad document windows support one Excel instance at a time. Opening more than one Excel file disables the Excel toolbars for the additional files.
Solution:
Open only one Excel file at a time.
Troubleshoot DB2 LUW Issues
Review the following solutions to help troubleshoot DB2 LUW issues pertaining to Toad installation and database connections.
Installation Issues
The following table describes issues related to installing Toad for DB2.
91
Toad Data Point Installation Guide
Troubleshoot Connections
Issue
System.IO.FileNotFoundException -
File or assembly name
DB2AdminWrapper, or one of its dependencies was not found
Error: "Could not load file or assembly 'IBM.Data.DB2.9.1.0,
Version=9.1.0.2, Culture=neutral,
PublicKeyToken=7c307b91aa13d208' or one of its dependencies. The system cannot find the file specified."
Cause/Solution
You are not a member of the DB2ADMIN or
DB2USERS group. To install Toad, you must be a member of either group.
Solution:
Ensure that you have been added to one of these groups.
You installed a commercial version of Toad for DB2 after uninstalling the freeware version.
Solution:
You must remove run time information for the freeware version of Toad from the .NET
system.config file.
To remove run time information
1. Exit Toad.
2. Navigate to the following .NET
framework directory:
C:\WINDOWS\Microsoft.NET\
Framework\v2.0.50727\
CONFIG
3. Create a backup copy of the system.config file.
4. Open the system.config file in Notepad.
5. Locate the <runtime> tag delete everything between the runtime tags
(including <runtime> and </runtime>).
6. Save the file.
7. Restart Toad.
Connection Issues
Issue
ERROR [08001] [IBM]
SQL1336N The remote host was not found. SQLSTATE=08001
ERROR [58031] [IBM]
Cause/Solution
You are attempting to connect to a database version that is not supported in Toad.
Solution:
Review the list of supported databases in the
Release Notes or Installation Guide.
Catalog entries have not been imported or defined
92
Toad Data Point Installation Guide
Troubleshoot Connections
Issue
SQL1031N The database directory cannot be found on the indicated file system.
SQLSTATE=58031
"The type initializer for
'IBM.Data.DB2.DB2Connection' threw an exception." or
"SUCCESS - unable to allocate an environment handle."
Cause/Solution
for the connection.
Solution:
See "Configure DB2 Client Connections" (page 43) for more information to determine the best method
for cataloging a database.
A settings file might be corrupt.
Solution:
Rename your local settings directory so a new one can be recreated.
To rename your local setting directory
1. Exit Toad.
2. Navigate to the following settings directory: l
Windows Vista, Windows Server
2008, Windows 7—
C:\Users\username\AppData\
Roaming\Quest Software\
3. Rename the Toad for DB2 version# folder to
"Toad for DB2 OLD".
4. Restart Toad and try to connect.
Notes:
l
Make sure you can view hidden folders in
Windows Explorer.
l
To navigate to this directory quickly, click the Application Data Directory link in the
About dialog (Help | About).
Other Issues
Issue
Unable to capture Container
Information in DB2 for LUW
Multi-Partition Databases
Cause/Solution
Certain Toad functions require that the DFT_
MON_BUFPOOL database manager configuration parameter be set to ON to capture information on containers used in DB2 for LUW databases.
Additionally, to capture container information across all partitions in a multi-partition database, the snapshot monitor requires that all database partitions be active. To activate all database partitions (and keep them active), execute the DB2
93
Toad Data Point Installation Guide
Troubleshoot Connections
Issue Cause/Solution
command ACTIVATE DATABASE real_
database_name on the server before connecting
Toad to the database. See your IBM DB2 for Linux,
Unix, and Windows documentation for more information about this command.
Troubleshoot DB2 z/OS Issues
Review the following solutions to help troubleshoot DB2 z/OS issues in Toad.
Installation Issues
Issue
Error: "Could not load file or assembly 'IBM.Data.DB2.9.1.0,
Version=9.1.0.2, Culture=neutral,
PublicKeyToken=7c307b91aa13d208' or one of its dependencies. The system cannot find the file specified."
Cause/Solution
You installed a commercial version of Toad for DB2 after uninstalling the freeware version.
Solution:
You must remove run time information for the freeware version of Toad from the .NET
system.config file.
To remove run time information
1. Exit Toad.
2. Navigate to the following .NET
framework directory:
C:\WINDOWS\Microsoft.NET\
Framework\v2.0.50727\
CONFIG
3. Create a backup copy of the system.config file.
4. Open the system.config file in Notepad.
5. Locate the <runtime> tag delete everything between the runtime tags
(including <runtime> and </runtime>).
6. Save the file.
7. Restart Toad.
94
Toad Data Point Installation Guide
Troubleshoot Connections
Connection Issues
Issue
ERROR [08001] [IBM]
SQL1336N The remote host was not found. SQLSTATE=08001
ERROR [58031] [IBM]
SQL1031N The database directory cannot be found on the indicated file system.
SQLSTATE=58031
Cause/Solution
You are attempting to connect to a database version that is not supported in Toad.
Solution:
Review the list of supported databases in the
Release Notes or Installation Guide.
You do not have any catalog entries defined for the connection.
Solution:
See "Configure DB2 Client Connections" (page 43) for more information to determine the best method
for cataloging a database.
You do not have SYSADM privileges for the DB2 for z/OS subsystem.
Solution:
Ensure that you are granted SELECT permissions on the DB2 catalog tables.
ERROR [42501] [IBM][DB2]
SQL0551N "UserName" does not have the privilege to perform operation "SELECT" on object
"SYSIBM.SYSSTMT".
SQLSTATE=42501
ERROR [] [IBM] SQL1460N
The environment variable
"SOCKS_NS" required for
SOCKS server name resolution is not defined or not valid.
When using the Time-Sharing Option (TSO) to connect, the user ID, port number, or IP address entered may be incorrect.
Solution:
Ensure that you use the following for TSO connections: l
DB2 user ID for the DB2 subsystem l
Port number that DB2 listens on, for remote connections, via the DB2 DDF address space l
IP address for the z/OS subsystem
95
Toad Data Point Installation Guide
Troubleshoot Connections
Issue
ERROR [56038] [IBM][DB2]
SQL0969N There is no message text corresponding to SQL error
"-4700" in the message file on this workstation.' when connecting to compatibility mode database.
-or-
After connecting, some objects do not display properly or some functionality does not work as designed.
Cause/Solution
In general, Toad does not support a z/OS subsystem running in Compatibility mode.
Solution:
If possible, switch the subsystem's operating mode to Full Function mode.
If this is not possible, Toad now provides a message when you connect to subsystem, informing you of that the subsystem is running in compatibility mode and that some features might not be available.
Missing Functionality or Object Information
Issue
Unable to browse databases in
DB2 for z/OS 8 or later.
Cannot edit data in compatibility mode.
Cause/Solution
The DB2 installation job DSNTISG defines a set of
DB2 procedures that the ODBC driver uses. The installation assigns these procedures (namely, those beginning with SYSIBM.SQL*) to a specific Work
Load Manager (WLM) environment, which currently might not exist or be defined properly.
Solution:
Be sure that you have correctly set up and enabled the WLM environment to which the procedure definitions point.
In compatibility mode, the ODBC driver does not return enough information for the CommandBuilder to correctly generate update or insert statements.
Solution:
No solution exists. However, when you connect to a subsystem running in compatibility mode, Toad now provides a message, informing you of this condition and warning you that some features might not be available.
Other Issues
Issue
Poor performance when
Cause/Solution
User-defined indexes on specific system catalog
96
Toad Data Point Installation Guide
Troubleshoot Connections
Issue
browsing DB2 for z/OS objects in Toad. Indexes are populated slowly.
Encountering the S378 Abend when running IBM DB2 z/10 subsystem in Conversion mode with older versions of Toad.
Cause/Solution
tables can improve performance when you are browsing DB2 for z/OS objects in Toad. The following link contains the DDL for indexes that can optimize Toad performance on your DB2 for z/OS subsystem. Keep in mind that the creation of these indexes is a recommendation only. The indexes can have different results in different environments, depending on the number of DB2 objects and the amount of data involved. To create these indexes, edit and run the DDL contained in the following file:
ToadDB2zOSIndexes.txt
Additionally, if the schema drop-down lists in the
Object Migration wizard populate slowly, consider creating an index on the SCHEMA and CREATOR columns in the catalog table for each object type.
Here is a list of some of the object-type tables:
SYSIBM.SYSSYNONYMS
SYSIBM.SYSSEQUENCES
SYSIBM.SYSROUTINES
SYSIBM.SYSTABLES
SYSIBM.SYSDATATYPES
SYSIBM.SYSINDEXES
SYSIBM.SYSTRIGGERS
SYSIBM.INDEXES
This issue appears because the Toad z/OS
Component tries to reference the
QUEST.QC200ZPARM function.
Solution:
DROP the QUEST.QC200ZPARM function from your DB2 z/OS 10 subsystem. This will eliminate the possibility of the function being called into the
WLM environment procedure and causing the S378 abend.
We do not recommend that you to just STOP the
QUEST.QC200ZPARM function on the mainframe side, without actually dropping it, because that may case Toad or the batch process (QCEXEC – remote job execution) to hang. Dropping the
QUEST.QC200ZPARM function is recommended.
Troubleshoot Informix Issues
Review the following solutions to help troubleshoot Informix issues in Toad.
97
Toad Data Point Installation Guide
Troubleshoot Connections
98
Issue
Unable to view all available databases.
Cause/Solution
The InformixODBC driver does not return information about every available database.
Troubleshoot MySQL Issues
Review the following solutions to help troubleshoot MySQL connection issues pertaining to database connections and missing functionality or object information in Toad.
Connection Issues
Issue
"InvalidCastException" error when connecting to MYSQL
4.1.14-nt database
"System.IO.DirectoryNot
FoundException"error occurs each time you attempt to connect after installing Toad into a directory other than the default directory.
Cause/Solution
This is a known issue in MySQL.
Solution:
Review the known issue and download a patch from: http://bugs.mysql.com/bug.php?id=12771
Solution:
1. Exit Toad.
2. Locate the MySQL.xml file in the
C:\Documents and Settings\username\Local
Settings\ Application Data\Quest Software\
Toad for MySQLversion\ ModuleSettings
3. Rename or delete the MySQL.xml file.
4. Restart Toad.
Missing Functionality or Object Information
Issue
Views tab in Object Explorer is unavailable when connecting to
MySQL using the ODBC driver
Using a MySQL ODBC connection in a cross-connection query results in an error
Cause/Solution
You are attempting to connect using the 3.51
ODBC driver. This driver is hard-coded to reply that the database does not support views because it needs to connect to MySQL databases prior to version 5.
Solution:
Use the native MySQL provider included in Toad.
Attempting to execute a cross-connection query using a MySQL ODBC connection (not a native connection) results in the following error: "The
Toad Data Point Installation Guide
Troubleshoot Connections
Issue Cause/Solution
table <table name> can not be mapped."
Solution:
To use a MySQL ODBC connection in a crossconnection query, you must specify a database for the connection.
To specify a database for an existing MySQL
ODBC connection
1. In the Connection/Navigation Manager, right-click the existing MySQL ODBC connection and select Properties.
2. Click beside the Data source name drop-down list. The ODBC Data Source
Administrator dialog opens.
3. On the User DSN tab, select (highlight) the connection's MySQL ODBC driver and then click Configure. The MySQL ODBC
Configuration dialog displays.
4. Select a database from the Database list.
Notes:
l
Specifying a database using the Connection
Properties Database field does not result in a solution. You must follow the procedure above.
l
You can repeat this procedure at any time to specify a different database.
Troubleshoot Oracle Issues
Review the following solutions to help troubleshoot Oracle connection issues pertaining to database connections and missing functionality and object information in Toad.
Connection Issues
Review the following to help troubleshoot Oracle:
Issue
Attempting to connect when
Oracle Instant Client is installed results in a
Cause/Solution
Solution:
In order to connect using the Oracle Instant Client,
99
Toad Data Point Installation Guide
Troubleshoot Connections
100
Issue
System.NullReferenceException
error
An error occurs when attempting to connect to Oracle Rdb using an ODBC driver.
Cause/Solution
the directory for the Instant Client must be included in the environmental path, or you must copy the client files for the instance to the root install directory of Toad Data Point.
You can also connect to the database without using an Oracle client or TNSNames file by selecting the
Direct tab in the Create New Connection window.
Toad does not support Oracle Rdb at this time.
Missing Functionality and Object Information
Issue
Some schemas are not available from the Schema drop-down list in the Object Explorer.
Unable to view table data on the
Data tab; SQLFetch generates an access violation.
Cause/Solution
The Oracle ODBC driver cannot display schemas that do not have any tables.
The Oracle ODBC driver is accessing unallocated memory.
Solution:
Update the Oracle ODBC driver: l
For 9i drivers, update to 9.2.0.7.0 or later.
l
For 10g drivers, update to 10.1.0.3.0 or later.
Troubleshoot SQL Server
®
Issues
Connection Issues
Review the following solutions to help troubleshoot SQL Server connection issues in Toad.
Issue
Cannot specify a port number when connecting
Cause/Solution
Currently, Toad does not have a separate field for specifying a port number.
Solution:
You can connect if you know the port number for the instance by entering the following in the Server name field
Toad Data Point Installation Guide
Troubleshoot Connections
101
Issue
Cannot connect to a remote instance in SQL
Server 2005
"Path is not of a legal form" error message when connecting or
"Could not find a part of the path
C:\Program Files\Dell
\Toad Data
Point\Template\Scripts\
InitialSqlServer.Sql" error message when connecting
Cause/Solution
on the New Connection window:
ServerName,Port or
IPAddress,Port
For example:
10.1.29.129,1234 (where 1234 is the port number of the instance)
Remote connections may not be enabled in SQL Server
2005. Also, named instances are configured to use dynamic ports and select an available port once the SQL Server
Service starts. If you are connecting to a named instance through a firewall, configure the Database Engine to listen on a specific port, so that the appropriate port is opened in the firewall.
Note: Remote connections are disabled by default in the
Express and Developer editions of SQL Server 2005.
Solution:
To enable remote connections, see "How to configure SQL
Server 2005 to allow remote connections" at: http://support.microsoft.com/kb/914277
You attempted to migrate settings from a previous install of
Toad to the current install, but the settings file
(InitialSqlServer.Sql) for the previous install was either removed, moved, or corrupt.
You may also receive this error if you installed Toad and migrated settings from a previous version, and later uninstalled the previous version.
Solution:
You must specify a valid location for the InitialSqlServer.Sql
file in Toad.
To specify a valid location
1. Open the SQL Server options page under Tools |
Options | Database | SQL Server.
2. Specify the location for the new install's
InitialSqlServer.Sql file in the Run Script on new
connection field.
By default, this file is located in the following directory:
C:\Program Files\Dell\Toad Data Point version
\Templates\Scripts
Toad Data Point Installation Guide
Troubleshoot Connections
102
Issue
Cannot establish
Named Pipes connection
Cannot establish Azure connection
Cannot access some functionality when working with Azure connection.
Cause/Solution
Note: Clicking may result in a "Path not found error". If you receive this error, manually enter the location in the field.
If you are trying to connect to the server using Named Pipes,
"Poll service status in connection list" option should be cleared.
Solution:
1. Open the options page under Tools | Options |
Database | General.
2. Clear Poll service status in connection list checkbox.
Failing to establish Azure connection may indicate that your
IP address is restricted from having access to the Azure server.
Solutions:
1. Select Tools | Cloud Computing | SQL Azure Portal to login to Azure Portal.
2. Create a firewall rule on the master database, enabling access to current IP address or range. See "Create and
Alter Azure Firewall Rules" in the online help for more information.
To utilize majority of Toad functionality VIEW
DEFINITION grant is required for those databases you want to work with.
Troubleshoot SAP Issues
Review the following solutions to help troubleshoot SAP issues pertaining to the following in Toad:
Connection Issues
Issue
Unable to connect to the database. The following message displays: "The ODBCMDA procedures have not been installed on this database..."
Cause/Solution
Stored procedures that the ODBC driver requires currently do not exist on the server.
Solution:
Install the required procedures.
Toad Data Point Installation Guide
Configure Version Control
103
Missing Functionality or Object Information
Issue
Unable to view or export data for objects with non-standard names.
Unable to view linked tables.
Cause/Solution
The ASE ODBC driver has issues handling nonstandard names for objects.
Solution:
When setting up an ASE connection in Toad, select
Use quoted identifiers on the Connection tab in the
Adaptive Server Enterprise window to enable the use of quotations in identifiers.
Linked tables store DSN connection information.
Solution:
Set up the DSN connection information exactly the same on all machines that access the database.
Other Issues
Issue
DBMS name showing as SQL
Server.
Cause/Solution
Older versions of the ASE ODBC driver return SQL
Server as the DBMS name.
Solution:
Upgrade to the latest version of the ODBC driver, which correctly returns Adaptive Server Enterprise as the DBMS name.
Configure Version Control
Version Control for Toad Files
Toad can integrate with your existing version control system allowing you to maintain multiple versions of Toad files. After you integrate Toad with your version control system, you can perform version control tasks directly from within Toad, such as commit file changes and retrieve revisions.
Toad supports the following version control systems for managing Toad files: l
Apache Subversion™—Toad has been tested with Subversion 1.7.5 and 1.8.
The following types of files can be managed using version control from within Toad: Editor
(.tef, .sql, .txt), Query Builder (.tsm), ER Diagram (.ter), and Automation (.tas).
Toad Data Point Installation Guide
Configure Version Control
104
To configure version control for Toad files
1. Ensure that an Apache Subversion client is installed on the same computer as Toad.
2. In Toad, open one of the supported file types. Then right-click the document window tab and select File Version Control | Version Control Wizard. This action opens the Version Control Wizard which allows you to configure Toad for your version control system.
3. Use the wizard to provide information about your version control system to Toad.
Review the following for additional information:
Field/Button
Version Control System
Page
Type
Properties
Server
Login and Password
Select Subversion.
Click the Properties button and enter the path to the Subversion executable (svn.exe) on the client computer. For example, if using
TortoiseSVN, the path might be:
C:\Program Files\TortoiseSVN\bin
Note: Do not include svn.exe in the path.
Enter the URL for the Subversion repository on the Subversion server.
Enter the user name and password for your
Subversion account.
Default Version Control
Settings Page
Version Control Folder
Working Folder
Select the folder on the Subversion server where you want to check in files.
If you currently have files under version control, select the folder on the server where these files are located.
Select a folder on the client computer to use as the root working folder. This is the location into which you will check out files.
If you currently have files under version control, select your existing working folder.
Toad Data Point Installation Guide
Configure Version Control
105
To add a file to version control
1. After configuring version control for files, you can start adding files to version control from within Toad. Right-click a document window tab and select File Version
Control | Add file to working folder.
2. Select a location in your working folder in which to save the file. Click Save.
3. In the Commit dialog, enter a comment and click OK to add the file to version control.
To browse the repository
1. Right-click the document window tab (of one of the supported file types) and select
File Version Control | Repository Browser.
2. In the Repository Browser you can right-click a file to perform one of the following actions. Available actions depend on the file's status.
Action
Open
Commit
Undo Changes
Get Latest Version
Description
Open the file in Toad.
Commit your changes. Available for Modified or
Untracked files.
Discards your changes and reverts to the previous revision of the file (previous commit). Available when the file status is Modified.
Check out the latest revision from the remote repository. Available when the file status is
OutOfDate.
To commit your changes
l
After modifying a file, right-click the document window tab and select File Version
Control | Commit.
To compare revisions (Editor files only)
l
After modifying and saving an Editor file, you might want to compare your changes to the remote copy (last commit) before committing your changes. Right-click the document tab and select File Version Control | Diff with latest revision.
l
You can compare two revisions of an Editor file (.tef, .sql, or .txt) by using the History dialog.
1. To open a file's History dialog, right-click the document tab and select File
Version Control | Show history.
2. Select two revisions to compare. Then right-click the revisions and select
Compare revisions.
Toad Data Point Installation Guide
Configure Version Control
106
3. For an OutOfDate file, right-click the latest revision in the History dialog and select Compare with working copy to compare the remote file to your working copy.
To check file status
l
The status of a currently open file displays in the status bar of the document window.
You can also place the cursor over the document tab to display status.
l
You can check the status of one or more files by using the Repository Browser.
To update file status in the Repository Browser, right-click a folder and select
Update folder.
l
Review the following file status definitions.
File Status
Untracked
UpToDate
Modified
OutOfDate
Unknown
Deleted
Definition
The file has not been added to version control. Right-click the file in the Repository Browser and select Commit to add it to version control.
The file in your working folder is synchronized with the file in the remote repository. No changes are detected. No action is required.
The working copy of this file was modified. The changes are stored in the working folder only. Commit this file to add the changes to the remote repository.
A more recent revision of this file exists in the remote repository. To update your working copy, check out the latest revision from the remote repository (right-click the file and select Get Latest Version).
The file is under version control, but its status cannot be determined.
The file was under version control, but it was dropped or renamed in the working folder and exists only in the remote repository.
Additional Actions
l
To open the folder where a file is located, open the file and then right-click the document tab and select File Version Control | Open in Windows Explorer.
About Dell
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
Technical support is available to customers who have purchased Dell software with a valid maintenance contract and to customers who have trial versions. To access the Support Portal, go to http://software.dell.com/support/ .
The Support Portal provides self-help tools you can use to solve problems quickly and independently, 24 hours a day, 365 days a year. In addition, the portal provides direct access to product support engineers through an online Service Request system.
The site enables you to: l
Create, update, and manage Service Requests (cases) l
View Knowledge Base articles l
Obtain product notifications l
Download software. For trial software, go to Trial Downloads .
l
View how-to videos l
Engage in community discussions l
Chat with a support engineer
Toad Data Point Installation Guide
Contacting Dell
108
Toad Community
Get the latest product information, find helpful resources, and join a discussion with the Toad
Data Point team and other community members. Join the Toad Data Point community at http://www.toadworld.com/products/toad-data-point/default.aspx
.
Index
A
Access
automation
B
Business Objects (SAP)
C
Citrix
connections
create MariaDB 67 create MySQL 67
create SAP IQ 82 create SAP SQL Anywhere 82
create SQL Azure 79 create SQL Server 79
create SQL Server Analysis
create Toad Intelligence Central 63
share for all session windows 39
customize
Toad Data Point Installation Guide
Index
D
DB2
Dell
E
Excel
create connections 55 ranges 55
G
Google Analytics
H
Hive
I
Intelligence Central
L
LDAP
look and feel configuration 32
M
MySQL
O
OBIEE
ODBC
Oracle
R
requirements
S
Salesforce.com
110
Toad Data Point Installation Guide
Index
shortcut keys configure to match other
SQL Azure
SQL Server
SQL Server Analysis Services
Sybase
T
Teradata
troubleshoot
tutorials
U
V
111
Download
Public link updated
The public link to your chat has been updated. You may view and manage your chat links after registration here.
Document public link
Advertisement
Key features
Database development and administration
Management of databases
Comprehensive set of features
Supports various databases
Installation and configuration steps
Frequently asked questions
The minimum requirements are a 2 GHz processor, 4 GB of RAM, and 800 MB of hard drive space. Refer to the Installation Guide's System Requirements section for more details.
You can perform a silent installation using either the executable file or the Microsoft Installer file. Refer to the Installation Guide's Install Toad Silently section for specific instructions and command-line options.
Toad Data Point supports various databases like Oracle, SQL Server, IBM DB2, MySQL, SAP ASE, SAP IQ, SAP SQL Anywhere, SAP HANA, Teradata, Access, Excel, and more. Refer to the Installation Guide's Server Requirements section for a complete list.
