Teradata SQL Assistant Java Edition

Teradata SQL Assistant Java Edition Release Definition

Release 13.11 B035-2036-050C

May 2011

The product or products described in this book are licensed products of Teradata Corporation or its affiliates.

Teradata, BYNET, DBC/1012, DecisionCast, DecisionFlow, DecisionPoint, Eye logo design, InfoWise, Meta Warehouse, MyCommerce, SeeChain, SeeCommerce, SeeRisk, Teradata Decision Experts, Teradata Source Experts, WebAnalyst, and You’ve Never Seen Your Business Like This Before are trademarks or registered trademarks of Teradata Corporation or its affiliates. Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc. AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc. BakBone and NetVault are trademarks or registered trademarks of BakBone Software, Inc. EMC, PowerPath, SRDF, and Symmetrix are registered trademarks of EMC Corporation. GoldenGate is a trademark of GoldenGate Software, Inc. Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company. Intel, Pentium, and XEON are registered trademarks of Intel Corporation. IBM, CICS, RACF, Tivoli, and z/OS are registered trademarks of International Business Machines Corporation. Linux is a registered trademark of Linus Torvalds. LSI and Engenio are registered trademarks of LSI Corporation. Microsoft, Active Directory, Windows, Windows NT, and Windows Server are registered trademarks of Microsoft Corporation in the United States and other countries. Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries. QLogic and SANbox are trademarks or registered trademarks of QLogic Corporation. SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc. SPARC is a registered trademark of SPARC International, Inc. Sun Microsystems, Solaris, Sun, and Sun Java are trademarks or registered trademarks of Sun Microsystems, Inc., in the United States and other countries. Symantec, NetBackup, and VERITAS are trademarks or registered trademarks of Symantec Corporation or its affiliates in the United States and other countries. Unicode is a collective membership mark and a service mark of Unicode, Inc. UNIX is a registered trademark of The Open Group in the United States and other countries. Other product and company names mentioned herein may be the trademarks of their respective owners.

THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROVIDED ON AN “AS-IS” BASIS, WITHOUT

WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF

MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SOME

JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION

MAY NOT APPLY TO YOU. IN NO EVENT WILL TERADATA CORPORATION BE LIABLE FOR ANY INDIRECT, DIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS OR LOST

SAVINGS, EVEN IF EXPRESSLY ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

The information contained in this document may contain references or cross-references to features, functions, products, or services that are not announced or available in your country. Such references do not imply that Teradata Corporation intends to announce such features, functions, products, or services in your country. Please consult your local Teradata Corporation representative for those features, functions, products, or services available in your country. Information contained in this document may contain technical inaccuracies or typographical errors. Information may be changed or updated without notice. Teradata Corporation may also make improvements or changes in the products or services described in this information at any time without notice. To maintain the quality of our products and services, we would like your comments on the accuracy, clarity, organization, and value of this document. Please e-mail: [email protected] Any comments or materials (collectively referred to as “Feedback”) sent to Teradata Corporation will be deemed non-confidential. Teradata Corporation will have no obligation of any kind with respect to Feedback and will be free to use, reproduce, disclose, exhibit, display, transform, create derivative works of, and distribute the Feedback and derivative works thereof without limitation on a royalty-free basis. Further, Teradata Corporation will be free to use any ideas, concepts, know-how, or techniques contained in such Feedback for any purpose whatsoever, including developing, manufacturing, or marketing products or services incorporating Feedback. Copyright © 2006-2011 by Teradata Corporation. All Rights Reserved.

mailto:%[email protected]

Teradata SQL Assistant Java Edition 3 Release Definition

Preface

The Teradata® SQL Assistant Java Edition Release Definition provides an overview of the product, installation requirements, and product dependencies. It also includes information on contacting customer support.

Purpose

Teradata SQL Assistant Java® Edition (SQLA JE) is an information discovery tool that enables users to retrieve data from Teradata Databases, manipulate the data, and store data on the desktop.

The key features of Teradata SQLA JE 13.11 are:

• Built on the Eclipse® Rich Client Platform (RCP), taking advantage of the RCP framework for building and deploying native GUI applications.

• Extends the Eclipse Data Tools Platform (DTP) to enhance Teradata Database access.

• Based on Eclipse release 3.6.2 and DTP release 1.8.2.

• Runs on Windows®, Linux®, and Mac® OSX platforms.

Teradata SQLA JE is a Java based analogue to the Windows-based Teradata SQL Assistant. It is not a replacement for Teradata SQL Assistant.

Audience

This book is intended for use by:

• System administrators

• Analysts

• Engineers

• Other specialists who retrieve data from the Teradata Database

• Teradata SQL Assistant users

Prerequisites

There are no prerequisites for this product.

Preface

4 Teradata SQL Assistant Java Edition Release Definition

Additional Information

Go to http://www.info.teradata.com for additional information that supports this product. Click Data Warehousing under Online Publications>Browse by Category. For a list of Teradata Tools and Utilities documents, click Teradata Tool and Utilities, and then select an item under Releases or Products.

Go to http://developer.teradata.com/ for additional information regarding Teradata SQLA JE.

http://www.info.teradata.com/

http://developer.teradata.com/


Table of Contents

Preface .................................................................................3

Purpose ...................................................................................................................................... 3

Audience.................................................................................................................................... 3

Prerequisites .............................................................................................................................. 3

Additional Information.............................................................................................................. 4

Release Information .............................................................8

Supported Operating Systems ................................................................................................... 8

Supported Teradata Database Versions..................................................................................... 9

Release Notes ............................................................................................................................ 9 Eclipse Open Issues ............................................................................................................ 9 SQL Assistant Java Edition Open Issues .......................................................................... 10 Problems Resolved by SQL Assistant Java Edition ......................................................... 10

Product Information ...........................................................11

Teradata SQLA JE New Features ........................................................................................... 11 Connection Handling of Expired Passwords .................................................................... 11 Execute SQL Files from Project Explorer ........................................................................ 11 Explain SQL Shortcut Key ............................................................................................... 12 Import/Export SQL History .............................................................................................. 12 Import SQL Assistant (original) History .......................................................................... 12 LOB Support..................................................................................................................... 12 Row Count Menu option................................................................................................... 12 Schema Cache Option....................................................................................................... 13 Support for Oracle, IBM DB2, and SQL Server Database Connections .......................... 13 Manual Option for JDBC Properties................................................................................. 13

Installation.........................................................................15

Migration................................................................................................................................. 15

Installing Java Runtime Environment ..................................................................................... 16

Table of Contents


Downloading Teradata SQLA JE............................................................................................ 16

Installing SQLA JE on Windows ............................................................................................ 16

Installing SQLA JE on Linux.................................................................................................. 16

Installing SQLA JE on MAC .................................................................................................. 17

Changing the Workspace directory location ........................................................................... 18

Configuring Teradata SQLA JE .............................................................................................. 20 Create a Teradata Connection Profile ............................................................................... 20 Create an SQL File ........................................................................................................... 21

Customer Assistance ..........................................................23

Customer Education.......................................................................................................... 23 Customer Support ............................................................................................................. 23


List of Tables

Table 1: Teradata SQLA-JE Platform Requirements............................................................. 8

Table 2: Eclipse issues unresolved in Eclipse 3.6.2/DTP 1.8.2 ............................................. 9

Table 3: SQLA JE issues unresolved release 13.11............................................................. 10

Table 4: Issues resolved in SQLA JE 13.11......................................................................... 10

Table 5: Default SQLA JE workspace locations by operating system ................................ 15


CHAPTER 1

Release Information

This chapter provides release information for the Teradata SQLA JE 13.11.

Supported Operating Systems

The table below lists the operating systems for which the Teradata SQLA JE is supported.

Table 1: Teradata SQLA-JE Platform Requirements

Operating System Platform

Windows 2000 Microsoft® Windows 2000, 32-bit

Windows XP Professional Microsoft Windows XP Professional, 32-bit and 64-bit

Windows Server Microsoft Windows Server 2003, 32-bit and 64-bit

Microsoft Windows Server 2008, 32-bit and 64-bit

Windows Vista™ Microsoft Windows Vista, 32-bit and 64-bit

Windows 7 Microsoft Windows 7, 32-bit and 64-bit

Red Hat® Enterprise Linux® Red Hat Advanced Server 2.1, 3.0, and 4.0, 32-bit

Red Hat Advanced Server 4.0, 64-bit

Red Hat Advanced Platform 5.0, 32-bit and 64-bit

Novell® SUSE® Linux Enterprise SUSE Linux Enterprise 9, 32-bit and 64-bit

SUSE Linux Enterprise 10, 32-bit and 64-bit

Apple® Mac OS X 10.5 and 10.6

CHAPTER 1 Release Information


Supported Teradata Database Versions

Teradata SQLA JE 13.11 is supported for use with the following Teradata Database versions:

• Teradata Database 13.10



• Teradata Database V2R6.2

• Teradata Database V2R6.1

Release Notes

Eclipse Open Issues The table below lists the open issues against Eclipse 3.6.2 and DTP 1.8.2.

Table 2: Eclipse issues unresolved in Eclipse 3.6.2/DTP 1.8.2

Bugzilla Number Open Issues

200140 Problems with DSE filters. [Filtered] tag not displayed on Tables and Stored Procedures folders when filter created at Connection properties.

258149 When running a stored procedure or macro, [JFace]Null Pointer Exception in Configure Parameters dialog when you click on the Value field to enter a value.

267428 SQLEditorStorage encoding/decoding of string contents problem is causing the display of Kanji characters as question marks.

Workaround: Change the Text file encoding setting on the Workspace Preferences Page (click Window>Preferences>General>Workspace) to UTF8 or UTF16 and click Apply. Close the SQL Editor window and re-display the data.

298549 <error> is displayed in place of a Decimal column value in the Table Data Editor.

CHAPTER 1 Release Information


SQL Assistant Java Edition Open Issues The table below lists the open issues against SQLA JE 13.11.

Table 3: SQLA JE issues unresolved release 13.11

JIRA Number Open Issues

IDE-3701 Can’t ‘Run SQL’ from SQL Query Builder, causing Null Pointer Exception

Workaround: You can run the SQL created in SQL Query Builder back in the original SQL Editor window. Once you have created your SQL statement in the SQL Query Builder, click OK. The SQL statement will be copied to the SQL Editor/Scratchpad window. Right click and select Execute All to run the SQL statement.

Problems Resolved by SQL Assistant Java Edition The following table lists issues resolved in SQLA JE 13.11.

Table 4: Issues resolved in SQLA JE 13.11

JIRA Number Description

IDE-3199 Teradata View is not functioning properly when schema gets filtered in DSE.

IDE-3208 SQL History Result Error not showing JDBC SQL Exception – Next Exception string

IDE-3210 NullPointerException when ‘Execute SQL File’ from Project Explorer. A new option ‘Teradata Execute SQL File’ has been added to support executing a SQL file from the Project Explorer.

IDE-3383 Display Teradata data types instead of JDBC data types when Aggregates option is invoked

IDE-3461 Finish and Test connection button is disabled when password field is empty.

IDE-3497 Warning shows up stating JRE 1.5 or higher required for SQLA JE even if JRE 1.6 is installed

IDE-3665 Workspace preference page not available in Window>Preferences>General

IDE-3690 SQL History hanging on large SQL queries


CHAPTER 2

Product Information

Teradata SQLA JE New Features

Teradata SQLA JE 13.11 includes the following new features:

• Connection Handling of Expired Passwords

• Execute SQL Files from Project Explorer

• Explain SQL Shortcut Key

• Import/Export SQL History

• Import SQL Assistant (original) History

• LOB Support

• Row Count menu option

• Schema Caching option

• Support for Oracle, IBM DB2, and SQL Server Database Connections

• Manual Option for JDBC Properties

Connection Handling of Expired Passwords Passwords can expire. In many cases the original password is a temporary password and the user is expected to change it when logging on for the first time. It is now recognized when a password expires (SQL Warning error code: 3032) and the user is prompted for the new password. The connection is retried with the JDBC property ‘NEW_PASSWORD’ set to the new password and the new password is saved in the profile.

Execute SQL Files from Project Explorer This feature provides the ability to execute one or more SQL files from within the Project Explorer. The user can select the SQL file(s) and right click and choose the Execute Teradata SQL Files option. If multiple SQL files are selected, a dialog is displayed to confirm the connection profile for the SQL file. If a parameterized query is contained within the SQL files, the user is prompted for the parameter values.

CHAPTER 2 Product Information

Explain SQL Shortcut Key This feature provides the ability to generate the Database EXPLAIN results from a SQL statement by pressing the F6 key or clicking in the toolbar. The EXPLAIN results are displayed in the Teradata View window.

Import/Export SQL History This feature provides the ability to export and import the history information from the Teradata SQL History to an external file. This ability allows SQL statements, which are part of the SQL History, to be shared between installations of Teradata IDE. New Export and Import menu items are provided as part of the Teradata SQL History View toolbar.

Import SQL Assistant (original) History This feature provides the ability to import the history information from the original Teradata SQL Assistant. The original SQL Assistant, which is a Windows-only client utility, had its own SQL History format. This feature allows users of the original SQL Assistant to import the history, which includes previously run SQL statements. This further supports migration from the original SQL Assistant to SQL Assistant Java Edition.

LOB Support LOB support includes the ability to view LOBs within the Result Set Viewer, include LOBs as parameters when running parameterized queries, and load and extract LOBs from tables in the database.

When a query result is being processed and a result column contains an LOB, a dialog appears. The dialog requests information about where the LOB values are to be stored on the file system, what the base name of the files is to be (initially the column’s name), what the file extension should be, whether the contents of the image files are to be shown as images in the result set view, and whether image files are to be saved when the images are displayed in the result set view.

When LOBs are needed for parameters to a query, the Configure Parameters dialog prompts the user for the location of the LOB file. When loading and exporting the contents of a table, LOB support has been added so that LOB values can be extracted and loaded from file locations.

Row Count Menu option This feature provides a Row Count menu option when a table is selected from the Data Source Explorer. Select the table from the Data Source Explorer and click Data>Row Count. A dialog with the number of rows for the table appears.

Teradata SQL Assistant Java Edition Release Definition12


Schema Cache Option The Schema Cache option allows the user to designate particular schemas (databases/users) to be cached. A schema cache file that contains the metadata for the schema is created. The metadata describes all of the information about the schema, such as its tables, columns, constraints, indexes, macros, parameters, stored procedures, user defined functions, user defined types, views, and so forth. The schema cache is associated with the connection profile. If the connection profile is deleted, so is the schema cache list and any schema cache files that were created. The schema cache files are stored in the workspace/metadata directory.

When the user first connects to the database and opens the Schemas folder, the schema cache file is created in a background job. Once the cache is created, if the user refreshes the list of schemas (by clicking the Refresh menu option on the Schemas folder), the cached schemas are loaded from the schema cache file. The schema is then highlighted within the Data Source Explorer with .

Note: Any modifications made to objects of a cached schema are not reflected in the cache. The user must refresh the schema cache for those changes to take effect.

Support for Oracle, IBM DB2, and SQL Server Database Connections This feature allows you to create connection profiles for Oracle, IBM DB2, and SQL Server databases. Support is provided by the standard Eclipse Data Tools Platform functionality.

Note: SQL result set data is displayed in the SQL Results View instead of the Teradata View, used only for Teradata Database connections.

Manual Option for JDBC Properties This feature provides an option for users to manually enter a JDBC property and its value. This is useful when non-standard JDBC properties are required for the Teradata connection. In the drop down list of JDBC Properties, scroll down to the bottom and select the USER_ENTERED_PROPERTY option. A dialog appears for you to enter your JDBC property name and its value. The name/value pair is then stored and passed to the JDBC driver when creating a connection to the Teradata Database.



CHAPTER 3

Installation

This chapter contains information on installing Teradata SQLA JE 13.11 and its dependent products.

Migration

If upgrading from a previous version of Teradata SQLA JE , you can migrate the existing workspace and connection profiles to the new installation. In most cases, the SQLA JE workspace is created in a separate location from the SQLA JE program installation directory.

Table 4 lists the default SQLA JE workspace location by operating system.

Table 5: Default SQLA JE workspace locations by operating system

Operating System Default Workspace Location

Windows User’s Home directory (i.e. C:\Documents and Settings\<User> directory)

Windows 7 User’s Home directory (i.e. C:\Users\<User>)

Linux Created in the location where you launched SQLA JE from.

Mac Documents folder.

Note: If you install the new SQLA JE 13.11 in the same location as the previously installed version of SQLA JE, then SQLA JE 13.11 uses the existing workspace. If you wish to run with a different workspace than the default location, refer to the section on Changing the Workspace Directory Location.

Note: If you wish to start with a clean workspace, delete the current workspace directory before you launch SQLA JE.

CHAPTER 3 Installation


Installing Java Runtime Environment

SQLA JE requires the Java Runtime Environment 6.0 or greater. To download and install the Java Runtime Environment, go to the Java SE Downloads web site.

Downloading Teradata SQLA JE

To download Teradata SQLA JE:

1 Go to the Teradata Developer Exchange web site, and then click Downloads.

2 Locate the SQL Assistant Java Edition 13.11 specific to your operating system, and then click its title to access its corresponding Downloads page.

3 On the Downloads page, click the SQL Assistant Java Edition 13.11 link. The zip file downloads to your local file system.

Installing SQLA JE on Windows

To install SQLA JE on Windows:

1 Unzip the Teradata SQLA JE package to your local file system.

2 Run setup.exe to launch Teradata SQLA JE installation.

3 Provide the path to the install directory for Teradata SQLA JE. The default location is C:\Program Files\Teradata\Client\13.11\Teradata SQL Assistant Java Edition.

When SQLA JE is started, a ‘workspace’ directory is created in your home directory (i.e. C:\Documents and Settings\<user>\workspace). This directory contains workspace files, including the SQL project folder and log file.

Installing SQLA JE on Linux

To install SQLA JE on Linux:

1 Unzip and untar the Teradata SQLA JE package to your local file system.

gunzip teradatasqla__linux_i386.13.11.00-1.tar.gz

tar –xvf teradatasqla.13.11.00.tar

2 Change directories (CD) to the teradatasqla.13.11.00 directory.

cd teradatasqla.13.11.00

http://java.sun.com/javase/downloads/index.jsp

http://developer.teradata.com/



3 Switch to Super User or Root and execute the RPM (Package Management) command to install SQLA JE on Linux.

su

/sqlajeinstall teradatasqla-13.11.00-1.i386.rpm

4 Provide the path to install Teradata SQLA JE. The default location is /opt/teradata. When SQLA JE is started, a ‘workspace’ directory is created in the location from where you launched SQLA JE (sqla). This directory contains workspace files, including the SQL project folder and log file.

Note: To verify that Teradata SQLA JE is installed, run the following command:

rpm -qa teradatasqla

To uninstall SQLA JE from Linux:

To remove the Teradata SQLA JE product from your Linux system, run the following command:

rpm -e teradatasqla

Installing SQLA JE on MAC

To install SQLA JE on Mac:

1 Unzip the Teradata SQLA JE package to your local file system.

2 Double click teradatasqla.pkg to invoke the SQLA JE installer.

3 Choose the install location, or install to the default install location (Applications/teradatasqla).

When SQLA JE is started, a SQLA folder is created in the Documents folder. This folder contains the workspace files, including the SQL project folder and log file.


18

Changing the Workspace directory location To have SQLA JE use a workspace directory other than the default "workspace" described above, the –data command-line argument must be used when launching SQLA JE.

To change the Workspace directory location on Windows:

1 Modify the shortcut that launches the program by adding the following string to the end of the shortcut "Target" field:

-data workspaceLocation

2 Right click on the Teradata SQL Assistant Java Edition shortcut on the desktop and select the Properties option.

3 Append the –data option and new location for the workspace to the end of the Target field.




To change the Workspace directory location on Linux:

Include –data workspaceLocation in the command line when executing the program. For example:

./opt/teradata/teradatasqla/sqlaje –data /home/guestUser/SQLAWorkspace

To change the Workspace directory location on Mac:

1 Bring up the Terminal application.

2 Run SQLA JE with the –data workspaceLocation appended to the end (all one line):

/Applications/teradatasqla/Teradata\ SQL\

Assistant.app/Contents/MacOS/sqlaje –data

/Users/guestUser/Documents/SQLAWorkspace



Configuring Teradata SQLA JE

After downloading and installing Teradata SQLA JE, create a Teradata connection profile for Teradata Database, and then create an SQL file. The connection profile stores frequently used database and logon information.

Create a Teradata Connection Profile

To create a Teradata connection profile:

1 Right-click the Databases folder, and then click New. The New Connection Profile Wizard displays a list of connection profile types.

2 Select Teradata Database from the list of connection profile types, enter a Name and Description for the Teradata connection profile, and then click Next. The wizard defaults to the Teradata Embedded JDBC Driver.

3 [Optional] To use a different Teradata JDBC driver:

a Click New Driver Definition.

b Select the Teradata External JDBC Driver template, and then click the Jar List tab.

c Click Add JAR/Zip to locate the JDBC Driver JARs.

d Click OK.

4 Enter the Database Server Name, User Name, Password, Authentication Mechanism, and Database information for a typical password protected logon situation. These options include but are not limited to LDAP, Kerberos (KRB5), and PASSWORD_PROTECTED.

5 Select Save Password to save your password to disk or leave it unselected to be prompted for the password when you connect the profile.

6 [Optional] To add or modify the JDBC connection properties:

• Click Add, select the JDBC property from the dropdown list, and then select the property value.

• To remove a property, select it, and then click Remove.

7 Click Test Connection to test the connection.

8 Click Finish to complete the Teradata connection profile. The Teradata Database database folder, Schemas, Tables, and other objects are ready to browse.



Create an SQL File

To create an SQL file with SQLA JE:

1 Click the Project Explorer tab.

2 Right click on the SQL project and click New>SQL File.

3 Enter a file name, and then select a database server type, connection profile name, and database name from the drop down lists.

4 Click Finish. A new SQL file is created in the SQL Editor for you to enter your SQL statement.

5 After you enter one or more SQL statements, right click in the SQL Editor and select an Execute option. The SQL results display in the SQL Results View below the SQL Editor window.

CHAPTER 3

22

Installation



CHAPTER 4

Customer Assistance

To help you make the most of your Teradata system, trained professionals are available to assist you. There are a number of training and support centers you can contact to learn more about Teradata applications or to get help with your Teradata system. Assistance is also available at Teradata Customer Services web site.

Customer Education Teradata Customer Education delivers training for your global workforce—from scheduled public courses and customized on-site training to the latest E-learning solutions. For information on the latest classes, schedules, and the Teradata Certification Program, go to the Teradata Customer Education web site.

Customers and Teradata associates can enroll in classes online at the Teradata Customer Education web site or by contacting the representative for your region. To find the representative for your region, use the Contact Us link at the bottom of the Teradata Education Network page.

Customer Support Customer support is available 24 hours per day, 7 days a week. Trained professionals at a Remote Services Center (RSC) are available to assist you. To learn more about Teradata Customer Services, go to the Teradata Customer Services web site.

Note: RSCs were formerly named MSCs (Managed Service Centers).

If you purchased an ESS (Enterprise System Support) support contract, a customized support plan was created for you. Please refer to your support plan for contact information. In addition, a unique PIN (Personal Identification Number) was given to your site. If you are an ESS customer, you must contact the regional RSC to request support, and you must use your PIN.

Note: PINs are not published. If you misplace your PIN, contact your account representative.

http://www.teradata.com/t/at-your-service/

http://www.teradata.com/t/ten-lander.aspx?id=5690



http://www.teradata.com/t/at-your-service/

CHAPTER 4

24

Customer Assistance


Teradata SQL Assistant Java Edition

Documents

Transcript of Teradata SQL Assistant Java Edition