Teradata SQL Assistant for Microsoft Windows. User Guide

Transcription

1 Teradata SQL Assistant for Microsoft Windows User Guide Release B K February 2013

2 The product or products described in this book are licensed products of Teradata Corporation or its affiliates. Teradata, Active Enterprise Intelligence, Applications-Within, Aprimo, Aprimo Marketing Studio, Aster, BYNET, Claraview, DecisionCast, Gridscale, MyCommerce, Raising Intelligence, Smarter. Faster. Wins., SQL-MapReduce, Teradata Decision Experts, "Teradata Labs" logo, "Teradata Raising Intelligence" logo, Teradata ServiceConnect, Teradata Source Experts, "Teradata The Best Decision Possible" logo, The Best Decision Possible, WebAnalyst, and Xkoto are trademarks or registered trademarks of Teradata Corporation or its affiliates in the United States and other countries. Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc. AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc. Apache, Apache Hadoop, Hadoop, and the yellow elephant logo are either registered trademarks or trademarks of the Apache Software Foundation in the United States and/or other countries. Axeda is a registered trademark of Axeda Corporation. Axeda Agents, Axeda Applications, Axeda Policy Manager, Axeda Enterprise, Axeda Access, Axeda Software Management, Axeda Service, Axeda ServiceLink, and Firewall-Friendly are trademarks and Maximum Results and Maximum Support are servicemarks of Axeda Corporation. Data Domain, EMC, PowerPath, SRDF, and Symmetrix are registered trademarks of EMC Corporation. GoldenGate is a trademark of Oracle. Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company. Hortonworks, the Hortonworks logo and other Hortonworks trademarks are trademarks of Hortonworks Inc. in the United States and other countries. 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 is a registered trademark 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. NetVault is a trademark or registered trademark of Quest Software, Inc. in the United States and/or other countries. Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries. Oracle, Java, and Solaris are registered trademarks of Oracle and/or its affiliates. QLogic and SANbox are trademarks or registered trademarks of QLogic Corporation. Red Hat is a trademark of Red Hat, Inc., registered in the U.S. and other countries. Used under license. SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc. SPARC is a registered trademark of SPARC International, Inc. 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 registered trademark of Unicode, Inc. in the United States and other countries. 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 teradata-books@lists.teradata.com. 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 by Teradata Corporation. All Rights Reserved.

3 Preface Purpose This book provides information about Teradata SQL Assistant for Microsoft Windows which is a Teradata Tools and Utilities product. Teradata Tools and Utilities is a group of products designed to work with the Teradata Database or other database. Teradata SQL Assistant is a Windows-based information discovery tool designed to retrieve, manipulate, and store data from ODBC-compliant database servers. Audience This book is intended for use by: SQL proficient users who know how to formulate queries for processing on the Teradata Database or other ODBC-compliant systems Relational Database developers Supported Releases This book supports the following releases: Teradata Database Teradata Tools and Utilities Teradata SQL Assistant Note: See To display information about SQL Assistant on page 36 to verify the Teradata SQL Assistant version number. To locate detailed supported release information: 1 Go to 2 Under Online Publications, click General Search. 3 Type 3119 in the Publication Product ID box. 4 Under Sort By, select Date. 5 Click Search. 6 Open the version of the Teradata Tools and Utilities ##.##.## Supported Platforms and Product Versions spreadsheet associated with this release. Teradata SQL Assistant for Microsoft Windows User Guide 3

4 Preface Prerequisites The spreadsheet includes supported Teradata Database versions, platforms, and product release numbers. Prerequisites The following prerequisite knowledge is required for this product: Teradata SQL, or the SQL of another ODBC compliant database Relational Database Management Systems Microsoft Windows operating system ODBC connectivity software In addition, the following might be helpful to review prior to using Teradata SQL Assistant: This document... Windows Help file contains this information... Online help, accessible from the Teradata SQL Assistant main window by clicking on the toolbar. Changes to this Book The following changes were made to this book in support of the current release. Changes are marked with change bars. For a complete list of changes to the product, see the Teradata Tools and Utilities Release Definition associated with this release. Table i: Changes to this Book Date August Description This release included the following changes: [Optional] Display Join Indexes and Triggers in the Database Explorer Tree. See Setting Database Tree Preferences on page 46. Specify whether a RowNumber column should be included when exporting data to a Microsoft Access table. See Exporting to Access - Formats and Data Types on page 126. Specify whether a Byte Order Mark should be written to unicode export files. See Setting Export Options on page 128. Specify whether a Byte Order Mark should be written to CLOB files. See Setting Data Format Options on page 117. Added support for the Teradata XML data type. See Understanding Large Object Support on page Teradata SQL Assistant for Microsoft Windows User Guide

5 Preface Additional Information Additional Information Additional information that supports this product and Teradata Tools and Utilities is available at the web sites listed in the table that follows. Table ii: Additional Product Information Type of Information Description Source Release Overview Late Information Additional product information CD-ROM images Use the Release Definition for the following information: Overview of all of the products in the release Information received too late to be included in the manuals Operating systems and Teradata Database versions that are certified to work with each product Version numbers of each product and the documentation for each product Information about available training and the support center Use the Teradata Information Products web site to view or download specific manuals that supply related or additional information to this manual. Access a link to a downloadable CD-ROM image of all customer documentation for this release. Customers are authorized to create CD-ROMs for their use from this image. 1 Go to 2 Under Online Publications, click General Search. 3 Type 2430 in the Publication Product ID box. 4 Click Search. 5 Select the appropriate Release Definition from the search results. 1 Go to 2 Under the Online Publications subcategory, Browse by Category, click Data Warehousing. 3 Do one of the following: For a list of Teradata Tools and Utilities documents, click Teradata Tools and Utilities, then select an item under Releases or Products. Select a link to any of the data warehousing publications categories listed. Specific books related to Teradata SQL Assistant for Microsoft Windows User Guide are as follows: ODBC Driver for Teradata User Guide B Teradata Query Scheduler User Guide B Teradata Visual Explain User Guide B Go to 2 Under the Online Publications subcategory, Browse by Category, click Data Warehousing. 3 Click CD-ROM Images. 4 Follow the ordering instructions. Teradata SQL Assistant for Microsoft Windows User Guide 5

6 Preface Additional Information Table ii: Additional Product Information (continued) Type of Information Description Source Ordering information for manuals General information about Teradata Use the Teradata Information Products web site to order printed versions of manuals. The Teradata home page provides links to numerous sources of information about Teradata. Links include: Executive reports, case studies of customer experiences with Teradata, and thought leadership Technical information, solutions, and expert advice Press releases, mentions and media resources 1 Go to 2 Under Print & CD Publications, click How to Order. 3 Follow the ordering instructions. 1 Go to Teradata.com. 2 Select a link. 6 Teradata SQL Assistant for Microsoft Windows User Guide

7 Table of Contents Preface Purpose Audience Supported Releases Prerequisites Changes to this Book Additional Information Chapter 1: Getting Started Introduction What is Teradata SQL Assistant? How Teradata SQL Assistant Works Teradata SQL Assistant Features Defining a Data Source Defining an ODBC Data Source Defining a.net Data Provider for Teradata Data Source Defining a.net Data Provider for Oracle Data Source Starting Teradata SQL Assistant Connecting to and Disconnecting from a Data Source Connecting to an ODBC Data Source Connecting to.net for Teradata Connecting to.net for Oracle Connecting to Multiple Data Sources Re-Connecting to a Data Source Displaying a Color Bar in the Query Window Changing the Database Password Main Window Menu Bar Hiding Toolbars Using the Status Bar Tabbing Windows Cascading Windows Teradata SQL Assistant for Microsoft Windows User Guide 7

8 Table of Contents Tiling Windows Arranging Windows Changing the text size in a child window Using Online Help Using Shortcut Menus and Commands Database Explorer Tree Viewing Object Types Opening and Closing the Database Explorer Tree Navigating to the Database Explorer Tree Changing the Width of the Tree Area Moving the Explorer Tree Window Dragging Object Names to the Query Pane Dragging Multiple Objects Using Quick Paste Adding Double Quotes around Object Name Adding Object Types Displaying Object Definitions Displaying Data Source Information Generating SQL for use with an Object Editing Table Data Working with the Edit Table Dialog Box Adding Databases Removing Databases Refreshing the Database Explorer Tree Displaying the Shortcut Menu Setting Database Tree Preferences Favorites and Examples Pane Opening and Closing the Favorites Pane Navigating to the Favorites Pane Changing the Width of the Favorites Pane Moving the Favorites Pane Window Listing All Tables or Views In a Database Listing All Columns In a Table or View Setting General Program Preferences Setting Default File Paths Using Page Setup Using Print Preview Support for Unicode and UTF Displaying Unicode Data Exporting Unicode Data Importing Unicode Data Support for the Visually Impaired Teradata SQL Assistant for Microsoft Windows User Guide

9 Table of Contents Text Size Color scheme Audible support Limitations Teradata.NET Specific Limitations Oracle.NET Specific Limitations ODBC Specific Limitations Chapter 2: The Query Window Introduction to the Query Window Using the Query Window Using SQL, DDL, and DML Statements Displaying the Query Window Toolbar Allowing Multiple Queries Splitting the Query Window into Two Windows Selecting Text and Inserting Bookmarks Using the Query Window Margin Creating Statements (Single and Multi) Parameterized Queries Magnifying the Query Window Setting Query Options Setting Code Editor Options Entering and Executing Queries Entering a Query Using Conditional Logic in a Query Using Code Completion Customizing Code Completion Lists Executing a Query Using Transactions Running Multiple Queries Executing Multiple Statements in Parallel Submitting Part of a Query Aborting a Query in Progress Executing a Query Saved To a File Automatically Minimizing the Teradata SQL Assistant Window Renaming a Query Tab Deleting a Query Tab Working With SQL Text in the Query Window Copying SQL from Previous History Record to the Query Window Copying SQL from Next History Record to the Query Window Teradata SQL Assistant for Microsoft Windows User Guide 9

10 Table of Contents Preventing Queries from Being Saved in the History Window Undoing or Redoing Query Window Changes Setting Repeat Count Recording and Executing Query Window Macros Saving a Query Performing a Quick Save Adding a Query to Favorites Opening a Query from a File Copying a Query to Notepad Printing a Query Adding Comments to Queries Highlighting a block of Text Showing Whitespace Converting Tabs to Spaces Indenting Lines in a Query Using the Right-to-Left Editor for Queries Deleting Blank Lines from a Query Finding a Text String in the Query Window Replacing a Text String in the Query Window Displaying an Explain Plan of a Query Displaying a Visual EXPLAIN Plan Displaying a Textual EXPLAIN Plan Query Builder Overview SQL Statements Procedure Builder <User Defined> Using Query Builder Supported Databases for Query Builder Creating Custom SQL Sets Scheduling Queries for Later Execution Before Scheduling Queries Scheduling Queries for Later Execution Formatting a Query Indentation Language Definition Files Importing Data Before You Begin Importing Data from a File Exiting from Import Mode Types of Import Operations Import Rules Defining the Null Value for an Import Operation Teradata SQL Assistant for Microsoft Windows User Guide

11 Table of Contents Generating Multiple Reports From a Single Query Using the Query Window Shortcut Menu Displaying the Shortcut Menu Functions in the Query Window Chapter 3: The Answerset Window Introduction to the Answerset Window Using the Answerset Window Viewing Your Results Adjusting Row Height Adjusting Column Width Re-arranging Column Order Keeping Selected Columns From Scrolling Out of View Viewing Long Strings of Text Within Cells Closing Answerset Windows Before Submitting a New Query Selecting All Answerset Rows Merging Cells in the Answerset Displaying the SQL That Generated an Answerset Hiding Columns/Showing All Columns Closing All Answersets Hiding Column Headers Hiding Row Headers Displaying Totals for Numeric Columns Displaying Aggregate Values Finding a Text String in the Results Grid Naming an Answerset Window Naming an Answerset Tab Deleting an Answerset Tab Opening a Saved Answerset Saving an Answerset to a File Saving as XML Copying an Answerset to Notepad Printing an Answerset Using Print Preview Cancelling Print Jobs Sorting an Answerset Filtering the Answerset Grouping the Answerset Setting Answerset Options Teradata SQL Assistant for Microsoft Windows User Guide 11

12 Table of Contents Setting Data Format Options Changing the Font for the Entire Window Zooming the Answerset Window Charting Answerset data Working with Charts Formatting an Answerset Formatting a Block of Cells Formatting a Single Cell Formatting a Single Row or Column Formatting Multiple Rows or Columns Formatting the Entire Spreadsheet Displaying Commas to Mark Thousand Separators Displaying Numbers in Scientific Notation Displaying Decimal Places Exporting a Resultset Exporting Results Single-Clicking to Display the Export File Saving Multiple Answersets Exporting to Access - Formats and Data Types Setting Export/Import Options Setting Export Options Setting Import Options Understanding Large Object Support Using Answerset Shortcut Menus Chapter 4: The History Window Introduction to the History Window The Columns of the History Window Using the History Window Opening the History Window Closing the History Window Viewing the Result Message Viewing DBS Error Messages Viewing the History Rows Rearranging History Columns Filtering the History Rows Copying SQL from Previous History Record to the Query Window Copying SQL from Next History Record to the Query Window Selecting All History Rows Teradata SQL Assistant for Microsoft Windows User Guide

13 Table of Contents Sorting the History Records Finding a Text String in the History Table Cleaning up the History table Magnifying the History Window Setting History Window Options Editing History Records Displaying and Navigating the Edit History Dialog Box Editing a History Record Compacting History Adding or Change a Note in a History Record Saving, Copying, and Printing History Saving History Rows Copying Rows to the Clipboard Copying Rows to Notepad Printing the Contents of the History Window Cancelling Print Jobs Storing History Files Changing the Location of History Files The History Window Shortcut Menu Appendix A: Startup Parameters and Default Preferences Startup Parameters Default Preferences (Options) Miscellaneous and General Default Preference Settings Query Default Preference Settings Code Editor Tab Default Preference Settings Data Format Tab Default Preference Settings Answerset Tab Default Preference Settings Export/Import Tab Default Preference Settings History Tab Default Preferences and Descriptions Database Tree Default Preferences and Descriptions File Paths Tab Default Preference Settings Page Setup Default Preferences and Settings Appendix B: Menus, Toolbars and Shortcuts Using Toolbars and Buttons Teradata SQL Assistant for Microsoft Windows User Guide 13

14 Table of Contents The Main Toolbar The Answerset Toolbar The Query Toolbar Toolbar Button Descriptions Customizing Menus and Toolbars Adding a Command to a Menu or Toolbar Menu Commands Only Removing a Command from a Menu or Toolbar Moving a Command Adding or Removing a Break Between Commands Changing the Name for a Command Assigning or Changing a Keyboard Shortcut Changing Menu Behavior Showing Recently Used Commands First Resetting the Default Menu Bar Hiding the Toolbars Showing or Hiding Toolbar Screen Tips Adding, Removing, Renaming, or Resetting a Toolbar General Command Shortcut Keys Query Specific Shortcut Keys Window Control Shortcut Keys Answer / History Specific Shortcut Keys Appendix C: Configuration Files UserOptions.config Toolbars.config DataSources.config DockMgr.config Vendors.config Glossary Index Teradata SQL Assistant for Microsoft Windows User Guide

15 List of Figures Figure 1: The Default Main Toolbar Figure 2: The Default Answerset Toolbar Figure 3: The Default Query Toolbar Teradata SQL Assistant for Microsoft Windows User Guide 15

16 List of Figures 16 Teradata SQL Assistant for Microsoft Windows User Guide

17 List of Tables Table 1: ODBC Data Source Types Table 2: ODBC Driver Setup for Teradata Database Dialog Box: Field Descriptions Table 3: Description of the Teradata.NET Connection Dialog Box Table 4: Description of the Oracle.NET Connection Dialog Box Table 5: Sub Folders Created When Objects Are Added Table 6: Generate SQL Sub Menus Table 7: Explorer Tree Shortcut Menu Commands Table 8: Options Dialog Box, DB Tree Tab Table 9: Options Dialog Box, GeneralTab Table 10: Description of the File Paths Options Table 11: Description of the Page Setup Dialog Box and Print Preview Window Table 1: The Query Tab in the Options Dialog Box Table 2: Code Editor Tab in the Options Dialog Box Table 3: Query Builder Statements Table 4: Query Builder Icon Descriptions and Right-Click Options Table 5: The Query Window Shortcut Menu Commands and Descriptions Table 6: Clipboard Support - Edit Commands Table 1: Find Dialog Box Table 2: Answerset File Format Types Table 3: Answerset Tab in the Options Dialog Box Table 4: Data Format Tab in the Options Dialog Box Table 5: Chart Definition Dialog Box Table 6: Chart Menus and Shortcut Keys Table 7: How SQL Assistant Maps Teradata Data Types to Access Data Types Table 8: Import/Export Tab in the Options Dialog Box Table 9: Export Tab in the Options Dialog Box Table 10: Import Tab in the Options Dialog Box Table 11: The Answerset Window Shortcut Menu Commands and Descriptions Table 1: The History Window Column Descriptions Table 2: Description of History Window Filter Options Table 3: Find Dialog Box Table 4: Description of Cleanup History Options Teradata SQL Assistant for Microsoft Windows User Guide 17

18 List of Tables Table 5: History Tab in the Options Dialog Box Table 6: History File Format Types Table 7: The History Window Shortcut Menu Commands and Descriptions Table 8: Startup Parameters Table 9: Miscellaneous and General Default Preferences and Descriptions Table 10: Query Default Preferences and Descriptions Table 11: Code Editor Tab Default Preferences and Descriptions Table 12: Data Format Tab Default Preferences and Descriptions Table 13: Answerset Tab Default Preferences and Descriptions Table 14: Export/Import Tab Default Preferences and Descriptions Table 15: History Tab Default Preferences and Descriptions Table 16: Database Tree Default Preferences and Descriptions Table 17: File Paths Tab Default Preferences Table 18: Page Setup Defaults and Descriptions Table 1: Toolbar Button Descriptions Table 2: Adding, Deleting, Renaming and Resetting a Toolbar Table 3: Shortcut Keys Table 4: Query Specific Shortcut Keys Table 5: Window Control Shortcut Keys Table 6: Answer / History specific Shortcut Keys Table 1: Properties Described by the Vendors.config File Teradata SQL Assistant for Microsoft Windows User Guide

19 CHAPTER 1 Getting Started The topics in this chapter provide the basic information required to get started using Teradata SQL Assistant: Introduction Defining a Data Source Starting Teradata SQL Assistant Connecting to and Disconnecting from a Data Source Main Window Database Explorer Tree Favorites and Examples Pane Listing All Tables or Views In a Database Listing All Columns In a Table or View Setting General Program Preferences Support for Unicode and UTF-8 Support for the Visually Impaired Limitations Note: This document uses the term database as the term for table qualifier (the object that contains data tables). This term varies depending on the database vendor, and might be referred to as owner, schema or catalog in the vendor s own documentation. Introduction This topic provides basic information about Teradata SQL Assistant and a brief overview of its features. What is Teradata SQL Assistant? How Teradata SQL Assistant Works Teradata SQL Assistant Features What is Teradata SQL Assistant? Teradata SQL Assistant is an information discovery tool designed for Windows XP and Windows 7. Teradata SQL Assistant retrieves data from any ODBC-compliant database server. The data can then be manipulated and stored on a desktop PC. Teradata SQL Assistant for Microsoft Windows User Guide 19

20 Chapter 1: Getting Started Defining a Data Source How Teradata SQL Assistant Works Teradata SQL Assistant combines the data retrieved from ODBC databases with desktop applications such as Excel to create consolidated reports or to analyze the merged data. Teradata SQL Assistant records all SQL activity, complete with source identification, timings, row counts and notes. This is especially useful in data mining because the historical record can be used to build scripts from the SQL that produced positive results. Teradata SQL Assistant Features Teradata SQL Assistant provides several key functions: Creates reports from Teradata or any Relational Database that provides an ODBC interface. Exports data from the database to a file on a PC Imports data from a PC file directly to the database Uses an import file to create many similar reports (query results or Answersets). For example, display the DDL (SQL) that was used to create a list of tables. For more information, see Generating Multiple Reports From a Single Query on page 96. Sends queries to any supported database or send the same query to many different databases Creates a historical record of the submitted SQL with timings and status information such as success or failure Uses SQL syntax examples to tailor statements Uses the Database Explorer Tree to easily view database objects Uses a procedure builder that provides a list of valid statements for building the logic of a stored procedure Limits data returned to prevent runaway queries Defining a Data Source When connecting to a database, select either ODBC, the.net Data Provider for Teradata, or the.net Data Provider for Oracle. Connection to any other database must be made through an ODBC connection. In order to use the ODBC connection, a vendor specific ODBC driver must be installed. In order to use a.net Data Provider, that provider must be downloaded and installed. See also the following sections: Defining an ODBC Data Source Defining a.net Data Provider for Teradata Data Source Defining a.net Data Provider for Oracle Data Source Note: The.NET providers only appear in the dropdown list if they have been installed on the client system. 20 Teradata SQL Assistant for Microsoft Windows User Guide

21 Chapter 1: Getting Started Defining a Data Source Defining an ODBC Data Source An ODBC-based application like Teradata SQL Assistant accesses the data in a database through an ODBC data source. After installing Teradata SQL Assistant on a workstation, start Teradata SQL Assistant. Then define a data source for each database. The Microsoft ODBC Data Source Administrator maintains ODBC data sources and drivers and can be used to add, modify, or remove ODBC drivers and configure data sources. An About Box for each installed ODBC driver provides author, version number, module size, and release date. Use the Microsoft ODBC Data Source Administrator program installed on the workstation to define a data source in one of two ways. To define an ODBC data source 1 Do one of the following: From the Windows desktop, select Start > Control Panel > Administrative Tools > Data Sources (ODBC). From the Windows desktop, select Start > Programs > Teradata SQL Assistant After Teradata SQL Assistant launches, select Tools > Define Data Source. 2 In the ODBC Data Source Administrator dialog box, decide what type of data source to create. Table 1 describes the data source types. Table 1: ODBC Data Source Types Data Source Description User DSN System DSN File DSN Explanation An ODBC user data source stores information about how to connect to the indicated data provider. An ODBC system data source stores information about how to connect to the indicated data provider. A system data source is visible to all users on this machine, including NT services. An ODBC file data source connects to a data provider. File DSNs can be shared by users who have the same drivers installed. Note: File DSN is not recommended. 3 After selecting the DSN type, click Add. For example, in the ODBC Data Source Administrator dialog box, click the System DSN tab to bring to the front. Click Add, then click OK. 4 In the Create New Data Source dialog box, select the appropriate driver and click Finish. For example, locate the Teradata driver under the column Name. Click to select the driver and click Finish. Teradata SQL Assistant for Microsoft Windows User Guide 21

22 Chapter 1: Getting Started Defining a Data Source 5 A dialog box appears for the selected database. This dialog box requests information that defines the location of the database and the connection parameters to be used when establishing a connection. The parameters vary from one vendor database to another. Table 2 describes the basic parameters used to connect to a database. Table 2: ODBC Driver Setup for Teradata Database Dialog Box: Field Descriptions Select This Field... Name Description Name(s) or IP address(es) Do not resolve alias name to IP address Use Integrated Security Mechanism Parameter Username Password To... Enter a name that identifies this data source. For example, in some cases there is more than one Teradata server to connect to or a user might have more than one logon depending on the function the user performs. Enter a description. This is solely a comment field to describe the data source name used. Enter the name(s) or IP address(es) of each LAN-connected node in the system, one per line. Entering only the first node name or IP address causes the client to communicate only with that node or IP address and can decrease system performance significantly. Define any names entered here in either Domain Name Services (DNS) or the local hosts file. The hosts file is located in the system32\drivers\etc subdirectory of the directory in which Windows is installed. Enter the name(s) or IP address(es) of the Teradata system. Note: Never enter both a name and an IP address. When this option is selected, setup routine does not attempt to resolve alias names entered into the Name(s) and IP address(es) box at setup time. Instead it is resolved at connect time. When cleared, the setup routine automatically appends COPn (where n = 1, 2, 3,..., 128) for each alias name entered. This causes other IP addresses associated with this server to be located, until a break in the sequence is detected. Select this option if logging on using integrated security measures. Leave this field blank to use the default mechanism. The authentication parameter is a password required for the selected mechanism. Enter a user name. Enter a password to be used for the connection if using Teradata SQL Assistant in an unattended (batch) mode. Entering a password here is not secure. 22 Teradata SQL Assistant for Microsoft Windows User Guide

23 Chapter 1: Getting Started Defining a Data Source Table 2: ODBC Driver Setup for Teradata Database Dialog Box: Field Descriptions (continued) Select This Field... Default Database (optional) Account String (optional) Session Character Set To... Enter the default database name. If the Default Database is not entered, the Username is used as the default. All tables, views, and macros are assumed to be in this default database unless explicitly prefixed by a database name in the query. Enter one of the accounts that the DBA assigned to the Username when it was created. Use the drop down menu to choose the character set. The default is ASCII. Teradata SQL Assistant is ready to use. For more information about using Microsoft ODBC Data Source Administrator, refer to the ODBC Data Source Administrator Help system. Note: The SQL Assistant option Allow use of ODBC SQL Extensions in queries no longer exists. Clear the ODBC DSN option Disable Parsing to allow the use of ODBC SQL Extensions in queries. ODBC Driver Before using Teradata SQL Assistant to access the data in the database, first install an ODBC driver on the PC. Each database requires a driver that is designed specifically for that database system. Obtain the appropriate driver from an database vendor or from a third-party supplier. Compatibility Teradata SQL Assistant is certified to run with any Level 2 compliant 32-bit ODBC driver. The product also works with Level 1 compliant drivers, but might not provide full functionality. Consult the ODBC driver documentation to determine the driver s conformance level. Most commercially available ODBC drivers conform to Level 2. Defining a.net Data Provider for Teradata Data Source Use the Connection Information dialog box to create, edit, and delete data sources for.net Data Provider for Teradata. The dialog box is also used to connect to existing Teradata.Net data sources. Data source definitions are saved to a file named DataSources.config. This file is located in \Users\<username>\AppData\Teradata\SQL Assistant on Windows 7 or \Documents and Settings\<username>\Application Data\Teradata\SQL Assistant otherwise. Additionally, system level data sources can be defined. These are stored in a file of the same name, located in \Users\All Users\AppData\Teradata\SQL Assistant on Windows 7 or \Documents and Settings\All Users\Application Data\Teradata\SQL Assistant otherwise. When a System level data source is selected, a padlock icon appears to the right of the data source name. For a Windows user with Standard rights, many of the properties within such a Teradata SQL Assistant for Microsoft Windows User Guide 23