Teradata Studio Express

Transcription

1 Teradata Studio Express User Guide Release April 2018 B K

2 Copyright and Trademarks Copyright by Teradata. All Rights Reserved. All copyrights and trademarks used in Teradata documentation are the property of their respective owners. For more information, see Trademark Information. Product Safety Safety type NOTICE CAUTION WARNING Indicates a situation which, if not avoided, could result in damage to property, such as to equipment or data, but not related to personal injury. Indicates a hazardous situation which, if not avoided, could result in minor or moderate personal injury. Indicates a hazardous situation which, if not avoided, could result in death or serious personal injury. Warranty Disclaimer Except as may be provided in a separate written agreement with Teradata or required by applicable law, 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 noninfringement. 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. The information contained in this document may be changed or updated by Teradata at any time without notice. Teradata may also make changes in the products or services described in this information at any time without notice. Feedback To maintain the quality of our products and services, your comments on the accuracy, clarity, organization, and value of this document to: teradata-books@lists.teradata.com Any comments or materials (collectively referred to as "Feedback") sent to Teradata Corporation will be deemed nonconfidential. Without any payment or other obligation of any kind and without any restriction of any kind, Teradata and its affiliates are hereby free to (1) reproduce, distribute, provide access to, publish, transmit, publicly display, publicly perform, and create derivative works of, the Feedback, (2) use any ideas, concepts, know-how, and techniques contained in such Feedback for any purpose whatsoever, including developing, manufacturing, and marketing products and services incorporating the Feedback, and (3) authorize others to do any or all of the above.

3 Contents Chapter 1: Getting Started With Studio Express 5 About Teradata Studio Express 5 Launching the Workbench 5 Workbench 6 Views 9 Data Source Explorer 10 Chapter 2: Database Connectivity 15 About Connection Profiles 15 Maximum Connections per Profile Preference 16 Adding a New Driver Definition 16 Teradata Database Connectivity 16 Aster Database Connectivity 21 Hadoop Connectivity 33 Oracle, DB2, and SQL Server Connections 41 Chapter 3: Teradata Data Lab 42 About Data Lab 42 About the Data Lab View 42 Data Lab Copy Wizard 44 Chapter 4: Query Development 48 Data Tools for Query Development 48 Teradata SQL Editor 48 About Teradata SQL Query Builder 65 Result Set Viewer 66 SQL History View 75 Filtering with Data Filter 81 Database Objects Search 83 Enabling Teradata Unicode Pass-Through 87 Showing Table Row Counts 87 Chapter 5: Table Data Development 89 About the Table Data Editor 89 Table Data Editor 90 Table Data Editing 97 Large Data and Objects Editing 101 Table Data Filtering 116 Exporting Table Data 120 Chapter 6: Data Import and Export 121 Importing Data Into a Volatile Table 121 Import and Load External Data (Teradata, Aster) 121 Import and Load External Data (Hadoop) 127 About Smart Load Wizard (Teradata, Aster) 129 About Smart Load Wizard (Hadoop) 137 Export External Data 140 Transfer Progress View 142 Teradata Studio Express User Guide, Release

4 Contents Transfer History View 144 Chapter 7: Troubleshooting 149 Viewing Eclipse Error Messages 149 Increasing Java Heap Memory Size 149 Viewing Teradata Error Log 149 Turning on Debug 149 Chapter 8: Additional Information 151 Changes and Additions 151 Related Documentation 151 Teradata Links 151 Teradata Studio Express User Guide, Release

5 1 Getting Started With Studio Express About Teradata Studio Express Begin using Teradata Studio Express by creating a Connection Profiles for your database. Then in the Data Source Explorer open the Connection Profile where you can browse the Databases, Indexes, Macros, Tables, Stored Procedures, User-defined Functions, User-defined Types, and Views folders to discover the database objects. Note: The highest level in the tree is the database server node, indicated by the database name provided in the Connection Profile. If no database name was provided, the default database name 'DBC' is used. Clicking on an object in the Data Source Explorer displays the object in the Object Viewer. An SQL Editor is provided for you to start entering your SQL statements. Launching the Workbench Prerequisite: This procedure assumes you have installed Teradata Studio Express. See Teradata Studio and Studio Express Installation Guide for installation instructions. 1. To launch Teradata Studio Express: Operating System To Launch Linux a. Update your path variable to include the Teradata Studio Express directory. b. Execute TeradataStudioExpress. Mac Windows Execute (or double-click) Teradata Studio Express in the TeradataStudio directory. Double-click the Teradata Studio Express desktop icon shortcut. Note: If you installed your Studio Express workspace in the default location (C:\Users \workspace-studioexpress), right-click the Studio Express shortcut and select Run As Administrator to launch Studio. Teradata Studio Express User Guide, Release

6 1: Getting Started With Studio Express Workbench Customizing the Display The initial display for Teradata Studio Express consists of: Data Source Explorer Project Explorer Teradata Result Set Viewer There is an additional view, the SQL Editor, that is displayed when an SQL file is opened. You can move the view panels around the display area, as well as move sections of the toolbar. You can also remove a view panel by clicking the X on the view tab. A view can be re-displayed by selecting the view from the Windows > Show View menu. To reset the perspective back to the default settings, select Window > Reset Perspective from the top-most toolbar. Toolbars Each view contains a toolbar that gives you quick access to functions and dialogs for creating, modifying, and administering database objects. Preferences Modify preferences by selecting Window > Preferences. In the Preferences window, you can filter the information or navigate to the preference. Changes to preferences are stored within your workspace. Data Management Preferences Preference Connectivity Label Decorations Configures the connectivity Driver Definitions by adding, editing, removing, or copying driver definitions Specifies the display format for columns in the Data Source Explorer SQL Development General SQL Editor SQL Query Builder Specifies settings for database development Offers options for the SQL Editor for code assist, connection behavior for SQL files, syntax colors, and SQL templates Omits the current database/schema from the generated SQL statements of the SQL Query Builder Teradata Studio Express User Guide, Release

7 1: Getting Started With Studio Express Preference SQL Results View s Offers options for displaying the results of SQL statements General Preferences Preference Appearance Compare/Patch Content Types Editors Globalization Keys Workspace Customizes the display appearance by offering options for theme, color, font, and label preferences Customizes the display when comparing text files Enables you to associate editors with file types Customizes editor behaviors and functions and adds or removes the editors and file types available in the Content Types preferences Customizes global settings for Unicode and text/graphic support Customizes the keyboard bindings Changes the text file encoding for the workspace Help Preferences Preference Content Customizes the display of the help screens as well as configuring remote help content. Teradata Datatools Preferences Preference Teradata Datatools Connection s Data Source Explorer Load Data Utilities Sets query and size preferences for all Teradata datatools Sets connection preferences for connection profiles. Preferences include maximum connections per profile. For Teradata connections, queryband options allow you to specify user and metadata queryband settings, as well as FastLoad/export options. In addition, you can specify default JDBC Connection Properties for Teradata and Aster connections. Sets preferences in the Data Source Explorer for display of database and user object hierarchy and for load settings that determine which databases and user objects to load Specifies the root directory location and thresholds for disk cache and maximum rows allowed for COMMIT transactions Teradata Studio Express User Guide, Release

8 1: Getting Started With Studio Express Preference Dependencies Export History Logging New Profile Connection Types Result Set Viewer SQL Formatter SQL Handling Table Data Editor Sets preferences for accessing the Meta Data Services web service Sets the preference to launch a native editor and customizes export options. Select Write SQL and Result Status to the Export File to include the SQL and result status when exporting. Sets the exclude options for the History database, maximum number of rows to display, and which columns to show in the SQL History View Specifies your preferences for logging messages Sets which types of connection profiles to show as options in the New Connection Profile dialog Sets preferences for Teradata Result Set Viewer. Sets preference options for the SQL Formatter. Sets handling preferences for SQL result sets and options for drag-and-drop and auto-connect functions. You can also specify the LOB sizes for handling large values for Teradata and Aster, and customize success and failure notification as sounds during SQL execution. Sets preferences for selection color options, filter thresholds, and editor display and copy/paste options. Logging Preferences Teradata error log messages are sent to teradata.log which is located by default in <userprofile>/workspace-studio/.metadata/teradata. They are also sent to the Teradata Log Console. You can control the logging content in the log file and the Console independently. The Console is not a view of the log file. Teradata Datatools Preferences The Teradata Datatools Preference dialog lets you configure options that control the use of views to obtain metadata information and to set the byte increments for display of size metrics. The application uses system views to obtain information for its displays, such as the list of databases. Typically the views are available in two forms: the V view and a VX view variant. Depending on your permissions and how your database is set up, you may only be able to access the information through one form. Use the Teradata Datatools Preference to select the V, VX, or a Custom View to be used when loading the metadata for various objects. If you select Custom, you must provide the fullyqualified name for a table or view. Also, the table or view must provide the exact same column names and data types as the associated DBC view. For example, if you are providing a custom view for the Databases list, you must provide a fully-qualified name for a table or view that contains the same columns as DBC.DatabasesVX view. At Size Preference, choose whether KB, MB, and GB increments are in multiples of 1000 or Teradata Studio Express User Guide, Release

9 1: Getting Started With Studio Express JDBC Connection Properties Under Preferences, under Connection s, use the JDBC Connection Properties to define your default JDBC connections. For example, enter TMODE=TERA to set the system level default to Teradata or TMODE=ANSI to set the system level default to ANSI. Setting the Log File Location By default, the log file for Teradata Studio Express is located in /workspace/.metadata/teradata. You can designate a different location where the log file is created and maintained. 1. Click Window in the main menu and select Preferences. 2. Expand Teradata Datatools Preferences. 3. Click Logging Preferences. 4. Click Browse and navigate to the desired file location. 5. Click OK to close the Browse For Folder dialog. 6. Click OK to apply your changes and close the Result Set Viewer Preferences dialog. Views The system provides multiple views and tools that allow you to explore, discover, and manage Teradata-supported databases, to develop and execute SQL queries, and to transfer data between databases. Many of the views appear as tabbed panes in the perspective. Not every view applies to every perspective. This table shows the more commonly-used views in the system. Some views are explained in more detail below. View Data Source Explorer Project Explorer Details/Forms Data Lab SQL Editor Teradata SQL History Contains the database object tree display in the Query Development and Data Transfer perspectives. You can create Connection Profiles to your Teradata Database systems and interact with database objects. Provides a hierarchical view of the Projects and their resource files. You can select SQL files for editing or create new SQL files. Displays specific details for the selected database object and allows them to be created or modified Provides access to your tables from a Teradata Data Lab. Displays when an SQL file is opened. Initially, the SQL Editor is opened to provide an area to enter SQL statements. Double-clicking a file in the Project Explorer causes the file to be opened in the SQL Editor view. Maintains a list of SQL queries issued from the SQL editor, allowing you to reexecute them. Teradata Studio Express User Guide, Release

10 1: Getting Started With Studio Express View Teradata Result Set Viewer Transfer History Transfer Progress Displays the result set returned by SQL queries issued from the SQL Editor view. Individual Result Set tabs are created for each result set. If a CALL to a stored procedure that has OUT or INOUT parameters is run, a tab is shown in the Result Set Viewer that contains the output values of the parameters. Provides a display of the Data Transfer History information in the database. When a data transfer completes, an entry is placed in the Transfer History. Displays a list of executing data transfer jobs and their status. Opening Views 1. In the main menu bar, select Window > Show View. 2. Select a view in the list or click Other to display additional views in the Show View dialog. Your current perspective determines which views you can select. The view you select displays in the workbench. Moving View Panels You can customize the look and feel of the interface by moving view panels within the display window. Move a view by dragging it to a new location. You can also drag the view outside the display area, detaching it. Changing the Font 1. Click Window in the top menu and select Preferences. 2. In the Preferences pane, expand Genereal > Appearance > Colors and Fonts. 3. In the Color and Fonts pane, click Dialog Font, and click Edit. 4. Make font changes and click OK. 5. In the Preferences pane, click OK. Font changes appear in views within the tool including the Result Set Viewer and History View. Data Source Explorer The Data Source Explorer supports SQL development and execution, as well as data transfers. The Data Source Explorer is available in the Query Development perspective and Data Transfer perspective. Teradata Studio Express User Guide, Release

11 1: Getting Started With Studio Express Data Source Explorer Load Preferences The Data Source Explorer Load Preferences enable you to configure your preference settings for loading database and user objects and to determine what folders are shown in the Data Source Explorer hierarchical tree display. You can set preferences to: Load databases and users: All databases and all users Load only databases and certain users Load all databases and users with PermSpace configured Configure the hierarchical display to show: All databases and all users Only certain folders you specify Whether to load object details for: Table space and journals Column data types in views. Whether filters created for folders in the Data Source Explorer should be case-insensitive. The default is for filters to be case-sensitive. Check the option if you want filters to be caseinsensitive. What to Load Use radio buttons in this section to set preferences for which objects you want loaded to the Data Source Explorer view. All Databases and Users Only Databases (but include DBC user) Only Databases (but include DBC user and myself) Databases and Users with PermSpace User Choice (includes DBC) Loads all database and user objects for the connected database. selected by default. Loads all databases and the DBC user, but no other user objects. Loads all databases, the DBC user, and the current user. Loads all databases and users with PermSpace configured. Enables user to select only folders they want displayed in the Data Source Explorer tree hierarchy. If all boxes are checked in What to Display (default), this option is not available. Teradata Studio Express User Guide, Release

12 1: Getting Started With Studio Express What to Display Use the check boxes in this section to set preferences for which folders you want shown in the Data Source Explorer hierarchical tree display. Show Databases and Users in Hierarchical Display Include Database Indexes Folder Include Macros Folder Include Stored Procedures Folder Include Tables Folder Include User-Defined Functions Folder Include User-Defined Types Folder Include Views Folder Displays database and user objects in an expandable hierarchical view. selected by default. Displays index objects in the Indexes folder. selected by default. Displays macro objects in the Macros folder. selected by default. Displays stored procedures objects in the Stored Procedures folder. Displays table objects in the Tables folder. selected by default. Displays user-defined function (UDF) objects in the User-Defined Functions folder. selected by default. Displays user-defined type (UDT) objects in the User-Defined Types folder. selected by default. Displays view objects in the Views folder. selected by default. Load Object Details Select the object details to include when loading objects in the Data Source Explorer. All object details are selected by default. Load Tables space and journal details Load View Columns Data Types If selected, when table information loads in Data Source Explorer, the space and journaling data is included. selected by default. If selected, when view information loads in Data Source Explorer, column data types are included. selected by default. Setting Data Source Explorer Load Preferences Use Data Source Explorer Load Preferences to configure your preference settings for loading database and user objects in Data Source Explorer (DSE). You can also set preferences to determine what folders are shown in the hierarchical display. 1. Click Window in the top menu and select Preferences. 2. Expand Teradata Datatools Preferences. Teradata Studio Express User Guide, Release

13 1: Getting Started With Studio Express 3. Select Data Source Explorer Load Preferences. 4. Under Load options for the Data Source Explorer What to load, select the objects to load: All Databases and Users Only Databases (but include DBC user) Only Databases (but include DBC user and myself) Databases and Users with PermSpace Loads all database and user objects for the connected database. selected by default. Loads all databases and the DBC user, but no other user objects. Loads all databases, the DBC user, and the current user. Loads all databases and users with PermSpace configured. 5. Under What to display, select the folders to show: Show Databases and Users in Hierarchical Display Include Database Indexes Folder Include Macros Folder Include Stored Procedures Folder Include Tables Folder Include User-Defined Functions Folder Include User-Defined Types Folder Include Views Folder Displays database and user objects in an expandable hierarchical view. selected by default. Displays index objects in the Indexes folder. selected by default. Displays macro objects in the Macros folder. selected by default. Displays stored procedures objects in the Stored Procedures folder. Displays table objects in the Tables folder. selected by default. Displays user-defined function (UDF) objects in the User- Defined Functions folder. selected by default. Displays user-defined type (UDT) objects in the User-Defined Types folder. selected by default. Displays view objects in the Views folder. selected by default. 6. [al] To select all options to display, click Select All. 7. [al] To clear your selections, click Clear All. 8. In Load Object Details, select one or both of the following options: Load Tables space and journal details Load View Columns Data Types If selected, when table information loads in Data Source Explorer, the load operation includes the space and journaling data. This option is selected by default. If selected, when view information loads in Data Source Explorer, the load operation includes the column data types. This option is selected by default. Teradata Studio Express User Guide, Release

14 1: Getting Started With Studio Express 9. [al] To reset and restore default selections, click Restore Defaults. 10. To apply your changes, click Apply. 11. Click OK to apply your changes and close the preference dialog. The database and user folders in the Data Source Explorer refresh to reflect the settings you selected. Setting Root of Data Source Explorer Display This feature is available for Teradata Databases displayed in the Data Source Explorer. In the Data Source Explorer Load Preferences, be sure you select the Show Databases and Users in Hierarchical Display check box to display databases. 1. Right-click the Databases folder. 2. Select Teradata > Set Root Database for DSE. The Set Root Database for DSEdialog appears. 3. In Root, type the name of the root database to load and display in the Data Source Explorer hierarchical tree display. 4. Click OK. The database root displays in parenthesis in the Databases folder name. Note: The SYSUDTLIB database always shows in the list of databases. Teradata Studio Express User Guide, Release

15 2 Database Connectivity About Connection Profiles A connection profile contains the connection property information needed to connect to a data source in your enterprise. You can create the following types of connection profiles. Those marked default are the default options in the system. Aster Database Aster Execution Engine (Aster-on- Hadoop) DB2 for Linux, UNIX, and Windows DB2 for i5/os DB2 for z/os Generic JDBC Hadoop Cloudera Hadoop Generic System Hadoop Hortonworks Oracle SQL Server Teradata Database Connects to Teradata Aster Database using the Aster Embedded JDBC Driver (default). Connects to a Teradata Aster Execution Engine instance using the Aster AX Embedded JDBC Driver (default). Connects to IBM DB2 database for Linux, UNIX, or Windows, also known as DB2 LUW. Connects to IBM DB2 embedded in the i5/os operating system for IBM System i (iseries) formerly AS/400. Connects to IBM DB2 for z/os for IBM mainframe systems. Connects using a JDBC database connection. Connects to Hadoop Cloudera systems using these user-defined options (defaults): Teradata Connection to Hadoop (TDCH) for Teradata data transfer SQL-H for Hadoop to Aster data transfer Smart Loader for external file import and export in Hadoop Hive Impala JDBC for creating and running SQL Presto JDBC for creating and running SQL Connects to open source Hadoop systems using the WebHDFS service (default). Connects to Hortonworks Hadoop systems using these user-defined options (defaults): Knox Gateway Teradata Connection to Hadoop (TDCH) for Teradata data transfer SQL-H for Hadoop to Aster data transfer Smart Loader for external file import and export in Hadoop Hive JDBC for creating and running SQL Presto JDBC for creating and running SQL Connects to an Oracle database. Connects to a Microsoft SQL Server. Connects to Teradata Databases using the Teradata Embedded JDBC Driver (default). Teradata Studio Express User Guide, Release

16 2: Database Connectivity Maximum Connections per Profile Preference This option sets the maximum number of connections allowed per connection profile. This preference applies to Teradata, Aster, and Hadoop (JDBC-enabled) connection profiles. When you are using the maximum number of connections and you try a new SQL operation, a pop-up window reports that you've reached the maximum number of allowable connections. Adding a New Driver Definition When you create a new connection profile for a connection that uses JDBC, a default driver definition for an embedded driver is automatically selected. You can add a new driver definition for an external JDBC driver when you first create the profile in the Connection Profile wizard or using the Properties dialog box for an existing connection profile. 1. Do one of the following, depending on whether you are creating a new connection profile or modifying an existing one: Creating a new connection profile Modifying an existing Aster connection profile Modifying an existing Hadoop connection profile Modifying an existing Teradata connection profile Action In the New Connection Profile wizard, navigate to the Specify a Driver and Connection Details step for a Teradata or Aster connection or the JDBC Connection Properties step for a Hadoop connection. a. In the Data Source Explorer, right-click the connection name and select Properties. b. Select Aster Database Connection Properties. a. In the Data Source Explorer, right-click the connection name and select Properties. b. Select Hadoop System Connection Properties. c. Select the JDBC tab. a. In the Data Source Explorer, right-click the connection name and select Properties. b. Select Teradata JDBC Connection Properties. 2. Click next to Select a driver from the drop-down. a. Select the External JDBC Driver template for your system type. b. In Driver name, enter a unique name for the driver definition. c. On the JAR List tab, add the list of JDBC driver JARs. To locate your Teradata JDBC driver JAR files on the file system, click Add Jar/Zip. d. On the Properties tab, edit the JDBC driver properties. e. Click OK to save the new driver definition. The new driver is listed in the Select a driver from the drop-down list. Teradata Studio Express User Guide, Release

17 2: Database Connectivity Teradata Database Connectivity Creating a Teradata Connection Profile The Connection Profile contains the JDBC information required to connect to an instance of a Teradata Database. 1. In the Data Source Explorer or Navigator, click to create a new connection. 2. Select Teradata from Connection Profile Types. 3. At Name, type a name to identify the connection profile. 4. [al] At, type a description of the connection profile. 5. Click Next. 6. Select a driver from Select a driver from the drop-down. The Teradata Embedded JDBC Driver template is selected as the default JDBC driver template. If you need to create a new Teradata JDBC driver template, click. 7. At Database Server Name, type the host name running the Teradata Database. 8. At User Name[Domain], type the user name for the connection. If you are connecting through Kerberos authentication, include the Domain name. 9. At Password, type the password for the connection. 10. If you are using advanced authentication, such as LDAP or Kerberos, select the Authentication Mechanism. TDNEGO is also supported. If you did not choose LDAP, Kerberos, or TDNEGO, the default protected logon is used. 11. [al] Set the Database if your connection requires that a default database be set at logon. 12. Select Save Password to save the password. The password is valid for the workbench session. 13. In JDBC Connection Properties, accept the default properties or add and remove JDBC connection properties to specify the connection details for the profile. The default JDBC connection properties include a QueryBand string that contains query band name value pairs (separated by semicolons) for a session. 14. [al] Click Cache Properties to open the Database Cache Properties dialog and select the databases to cache. 15. [al] Click Delete Cache Files and confirm to delete cache files. 16. Specify when to connect: Connect when the wizard completes Connect every time the workbench is started Connect to the database when you complete the profile. Connect to this database each time you launch the workbench. 17. Click Next to view the Summary information. 18. Click Finish to create the connection profile. Teradata Studio Express User Guide, Release

18 2: Database Connectivity Kerberos Authentication When using Kerberos authentication, you must provide the TeraJDBC.config security configuration file and specify its location in a Java property. The format of the TeraJDBC.config file is specified in the Teradata JDBC Users Guide. Specify the location of this file in the java.security.auth.login.configure property variable. To add this property variable to the.ini file enter: -Djava.security.auth.login.config=c:/TeraJDBC.config where c:/terajdbc.config is the location of the TeraJDBC configuration file. The.ini file (TeradataStudioExpress.ini, TeradataStudio.ini, or eclipse.ini) is located in the same directory as the executable. You must run kinit to initialize your Kerberos credential before launching the product. Adding a JDBC Property The Add JDBC Properties dialog displays when you add JDBC connection properties in the New Teradata Connection Profile or Teradata JDBC Connection Properties dialog. JDBC connection properties are defined by property value pairs. 1. In JDBC Properties on the Add JDBC Property dialog box, select a JDBC property from the drop-down list. You can also select QUERY_BAND as a property to specify the query bands for a session. 2. Select the value for the property in Select Property Value. 3. [al] if the property you select requires a user-defined value, enter the value in the Enter JDBC Property Value dialog. a. In the JDBC Property Value field, type a value for the property. b. Click OK. Also the Enter JDBC Property Value dialog displays if you click Click to enter value in the Select Property Value field. 4. [al] To manually enter a JDBC property that is not in the properties list, select the property called USER_ENTERED_PROPERTY and create a new property name value pair. a. In the New JDBC Property dialog, in Property Name, enter the name for the new JDBC property. b. In Property Value, enter the value for the new JDBC property. c. Click OK. 5. Click OK. The JDBC property value pair is added to the JDBC Connection Properties. Editing JDBC Connection Properties You can add or remove connection properties to the list of JDBC Connection Properties. 1. Click Add to display a dialog with the list of JDBC properties. Teradata Studio Express User Guide, Release

19 2: Database Connectivity 2. Select the property you want to add. To remove a property, select it and click Remove. To clear the entire list of connection properties click Clear All. 3. From the list of Property Values, select the property value. If the value requires user input, a dialog appears. Default connection properties are supplied for new connection profiles. To override these defaults, click Save Properties. Future definitions use the saved properties. 4. Type in a Property Value of no more than 30 characters. 5. Click OK to save the JDBC property. If the property already exists in the list, a confirmation dialog appears. 6. Click OK to replace the JDBC property in the list. 7. Click Reset to Defaults to set the properties to the default values. 8. To cache schema, use metadatacache Properties. You must enter a user name and password in order to configure the cache properties. To delete all schema cache files for the connection profile, select Delete Cache Files 9. Repeat these steps to add multiple properties. 10. To test the connection, click Test Connection. A message box appears stating the ping either succeeded or failed. Click OK to close the message box. 11. Select Connect every time the workbench is started to automatically connect to the database when the application is started. 12. Click Finish to close the wizard and connect to your database. Database Cache The Database Cache option enables you to designate specific databases or users to be cached. A database cache file is created to store the metadata for the database. The metadata describes information about the database, such as its tables, columns, constraints, indexes, macros, parameters, stored procedures, user-defined functions, user-defined types, views, and more. This metadata is used to populate the Data Source Explorer and Transfer View trees. Note: The Database Cache option is associated with the Connection Profile. If the Connection Profile is deleted, the Database Cache list and any database cache files that were created are also deleted. Database Cache Inheritance If the Data Source Explorer load option is set to show databases in hierarchical format, child databases and user objects are nested under the parent database or user object. When you select a database or user object to be cached, all of its child database and user objects are also cached. When you change the Data Source Explorer load option, the database cache is deleted and then re-cached using the new selections. Teradata Studio Express User Guide, Release

20 2: Database Connectivity Progress Monitor When you first connect to the database and open the Databases folder, the database cache file is created in a background job. To view the progress of the database cache job, open the Progress Monitor view by selecting Window > Show View > Other > General > Progress and clicking OK. About Refreshing Cache After the cache is created, you can click Refresh to refresh the list of databases. Refreshing causes the cached databases to load from the database cache file. You can distinguish the cached databases within the Data Source Explorer tree by looking for the cache icon. If new database objects are modified in the database while it is loaded from the database cache, the modified objects do not display in the Data Source Explorer until you refresh the database cache. To refresh the database cache for a specific database, right-click the cached database and select Refresh Database Cache. This action deletes the database cache file, launches a new background job to create a new database cache file, and refreshes the list of databases. You can also refresh the database cache by deleting the database cache files in the Teradata JDBC Connection Properties dialog. Click Delete Cache Files to delete the database cache files. The Data Source Explorer shows any changes to the database objects. A subsequent refresh of the Databases folder loads the database from the database cache file. Termination of Cache Job Terminating the database cache job causes the database cache files to be deleted and databases to be loaded from the database metadata. To restart the database cache job, you must disconnect and reconnect the Connection Profile, and then click the Databases folder to open it and create the database cache files. QueryBand Preferences User QueryBand Settings s Use User QueryBand User QueryBand s Select this check box to enable the use of query bands for SQL Editor sessions. Use this option to turn query bands on and off for SQL sessions. Type the query band name value pairs you want available for a session. Separate each query band name value pair with a semicolon (;) and enclose the statement in single quotes ('). For example, 'ApplicationName=CDID;ClientUser=CS99934;'. The field provides a sample query band string with variables you can complete. Teradata Studio Express User Guide, Release

21 2: Database Connectivity Fast Load/Export QueryBand Settings s Use Fast Load/ Export QueryBand Settings Fast Load QueryBand s Select this check box to enable the use of query bands on fast load/export query operations. Type the query band name value pairs you want applied to the fast load/export session. Separate each query band name value pair with a semicolon (;) and enclose the statement in single quotes ('). For example, 'ApplicationName=CDID;ClientUser=CS99934;'. The field provides a sample query band string with variables you can complete. Metadata QueryBand Settings s Use Metadata QueryBand Metadata QueryBand s Select this check box to enable the use of query bands when gathering metadata for the Data Source Explorer or Navigator tree. This editable field shows the metadata query band string used for the session when the Use Metadata QueryBand check box is selected. Aster Database Connectivity An Aster Database connection profile defines the JDBC information required to connect to an instance of an Aster Database on your system. It contains information such as the database server name, user name and password required to establish the connection, port number, JDBC connection properties, and schema cache properties. Creating an Aster Database Connection Profile 1. In the Data Source Explorer or Navigator, click to create a new connection. 2. From Connection Profile Types, select Aster. To filter the list of databases shown in Connection Profile Types, type a filter key (for example Aster) to reduce the list to a subset of database types that match your filter criteria. 3. At Name, type a name to identify the connection profile. 4. [al] At, type a description of this Connection Profile. 5. Click Next. 6. Select Aster Database as the type of Aster database, and click Next. 7. Select a driver from Select a driver from the drop-down. The Aster Embedded JDBC Driver template is selected as the default JDBC driver template. If you need to create a new Aster JDBC driver template, click. Teradata Studio Express User Guide, Release

22 2: Database Connectivity 8. [al] Check Set Up SSO Connection to create a connection to an SSO-enabled Aster database server. 9. At Database Server Name, type the host name running the Aster Database. 10. At User Name, type the user name for the connection. 11. At Password, type the password for the connection. 12. Accept the default Port Number or type a different port number. 13. In Database Name, type the name of the database to which this profile connects. Your connection requires that a default database be set when a user logs on. The default database for Aster Database is beehive. 14. Select Save Password to save the password. The password is valid for the workbench session. 15. If you selected Set Up SSO Connection: a. Type the KDC required to connect to the database server. b. Type the Domain Name required to connect to the database server. c. Type the Service Name required to connect to the database server. d. Click Browse and add the location of the JAAS Login Configuration file. 16. In JDBC Connection Properties, accept the default properties or add and remove JDBC connection properties to specify the connection details for the profile. 17. [al] Click Cache Properties to open the Schema Cache Properties dialog and select the schemas to cache. 18. [al] Click Delete Cache Files and confirm to delete cache files. 19. Specify when to connect : Connect when the wizard completes Connect every time the workbench is started Connect to the database when you complete the profile. Connect to this database each time you launch the workbench. 20. Click Next to view the Summary information. 21. Click Finish to create the connection profile. Creating an Aster Execution Engine Connection Profile 1. In the Data Source Explorer or Navigator, click to create a new connection. 2. From Connection Profile Types, select Aster. To filter the list of databases shown in Connection Profile Types, type a filter key (for example Aster) to reduce the list to a subset of database types that match your filter criteria. 3. At Name, type a name to identify the connection profile. 4. [al] At, type a description of this Connection Profile. 5. Click Next. 6. Select Aster Execution Engine (Aster-on-Hadoop) as the type of Aster database, and click Next. Teradata Studio Express User Guide, Release

23 2: Database Connectivity 7. Select a driver from Select a driver from the drop-down. The Aster AX Embedded JDBC Driver template is selected as the default JDBC driver template. If you need to create a new Aster JDBC driver template, click. 8. [al] Check Set Up SSO Connection to create a connection to an SSO-enabled Aster database server. 9. At Database Server Name, type the host name running the Aster instance. 10. At User Name, type the user name for the connection. 11. At Password, type the password for the connection. 12. Accept the default Port Number or type a different port number. 13. In Database Name, type the name of the database to which this profile connects. Your connection requires that a default database be set when a user logs on. The default database for Aster Database is beehive. 14. Select Save Password to save the password. The password is valid for the workbench session. 15. If you selected Set Up SSO Connection: a. Type the KDC required to connect to the database server. b. Type the Domain Name required to connect to the database server. c. Type the Service Name required to connect to the database server. d. Click Browse and add the location of the JAAS Login Configuration file. 16. In JDBC Connection Properties, accept the default properties or add and remove JDBC connection properties to specify the connection details for the profile. 17. [al] Click Cache Properties to open the Schema Cache Properties dialog and select the schemas to cache. 18. [al] Click Delete Cache Files and confirm to delete cache files. 19. Specify when to connect: Connect when the wizard completes Connect every time the workbench is started Connect to the Aster instance when you complete the profile. Connect to the Aster instance each time you launch the workbench. 20. Click Next to view the Summary information. 21. Click Finish to create the connection profile. Specify a Driver and Connection Details The Specify a Driver and Connection Details dialog enables you to specify the JDBC information required to connect to an instance of an Aster Database or Aster Execution Engine. The dialog shows the connection properties that define the Connection Profile. Properties include: Database server name, port, and name of database to which to connect Teradata Studio Express User Guide, Release

24 2: Database Connectivity User name and password required to access the Aster Database or Aster Execution Engine instance defined in the profile JDBC connection properties s for caching database files and deleting cache files s for opening the connection to the database Connection Properties Select a driver from the dropdown Database Server Name User Name Password Port Number Database Name Save Password For an Aster Database connection, the Aster Embedded JDBC Driver Default template is selected as the default JDBC driver template. For an Aster Execution Engine instance connection, the Aster AX Embedded JDBC Driver Default template is selected as the default. To create a new Aster JDBC driver template, click the asterisk button ( ) to add a driver definition. Name of the database server that hosts the Aster Database or Aster Execution Engine instance. Aster user name used to connect to the database server. Password required to access the Aster Database or Aster Execution Engine instance. Port number to use for the Aster server. Name of the default database. Your connection requires that a default database be set when a user logs on. Select the Save Password check box if you want the password saved. If this option is not selected, you are required to enter a password each time a connection to the database is made. The password you entered in the Password field is valid for each workbench session and is not affected by this check box. JDBC Connection Properties The JDBC Connection Profile list is blank until you add a property. Use the buttons on the rightside to add, remove, clear, save, and reset properties in the list. Property Actions You can perform these actions for the JDBC connection properties you define. Button Add Remove Clear All Add JDBC connection properties to the list of JDBC Connection Properties. Remove properties from the list of JDBC Connection Properties by selecting the property and clicking Remove. The property is immediately removed from the list. Click to clear the entire list of connection properties. Teradata Studio Express User Guide, Release

25 2: Database Connectivity Button Save Properties Reset to Defaults Cache Properties Delete Cache Files Click to save the properties listed in the JDBC Connection Properties list. The Save Properties feature overrides the default connection properties supplied for a new connection profile, and saves the list you created. Click to set properties to the default values. If you have saved your properties, and therefore, overridden the system defaults, the Save Properties values are used as your default values. Click to configure schema cache properties. This action opens the Schema Cache Properties dialog. See Caching Aster Schemas. Click to delete cached files. See Deleting Aster Cache Files. Connection Actions You can verify that the information defined in the Connection Profile connects to the desired Aster Database or Aster Execution Engine. Test Connection Connect when the wizard completes Connect every time the workbench is started Click to test the connection. A message box appears stating the ping either succeeded or failed. Click OK to close the message. Select the check box if you want to connect to the database when you click Finish. Select the check box if you want to automatically connect to the database when the application is started. Aster Connection Properties The Aster Database Connection Properties and Aster AX Database Connection Properties dialogs detail the JDBC information required to connect to an instance of an Aster Database or Aster Execution Engine. The dialogs show the connection properties that make up the Connection Profile definition. Properties include: Database server name, port, and name of database to which to connect User name and password required to access the Aster Database or Aster Execution Engine instance defined in the profile JDBC connection properties s for caching database files and deleting cache files to create an SSO (Single Sign On) connection and KDC (Key Distribution Center), domain name, service name, and location of the JAAS (Java Authentication and Authorization Service) configuration file required to access an SSO-enabled system. Teradata Studio Express User Guide, Release

26 2: Database Connectivity Connection Properties Select a driver from the drop-down Set Up SSO Connection Database Server Name User Name Password Port Number Database Name Save Password KDC Domain Name Service Name JAAS Login Configuration The Aster Embedded JDBC Driver Default template is selected as the default JDBC driver template for an Aster Database connection, and the Aster AX Embedded JDBC Driver Default template is selected as the default for an Aster Execution Engine instance connection. Enables an SSO connection, which is disabled by default. Checking this option disables the User Name and Password fields. Name of the database server that hosts the Aster Database or Aster Execution Engine instance. Aster user name used to connect to the database server. Password required to access the Aster Database or Aster Execution Engine instance defined in this Connection Profile. Port number to use for the Aster server. Name of the default database. Your connection requires that a default database be set when a user logs on. Saves a password. If this option is not selected, you are required to enter a password each time a connection to the database is made. The password you entered in the Password field is valid for each workbench session and is not affected by this check box. Key Distribution Center required to access an SSO-enabled Aster database server. KDC is disabled by default and is enabled when Set Up SSO Connection is checked. Domain name required to access an SSO-enabled Aster database server. Domain name is disabled by default and is enabled when Set Up SSO Connection is checked. Service name required to access an SSO-enabled Aster database server. Service name is disabled by default and is enabled when Set Up SSO Connection is checked. The location of the JAAS Login Configuration file required to access an SSOenabled Aster database server. JAAS Login Configuration is disabled by default and is enabled when Set Up SSO Connection is checked. Note: If you are connected to the Connection Profile and change the connection properties, when you click OK, you are asked if you want to reconnect to the server. Teradata Studio Express User Guide, Release

27 2: Database Connectivity JDBC Connection Properties The JDBC Connection Profile list is blank until you add a property. Use the buttons on the rightside to add, remove, clear, save, and reset properties in the list. Property Actions You can perform these actions for the JDBC connection properties you define. Button Add Remove Clear All Save Properties Reset to Defaults Cache Properties Delete Cache Files Adds a JDBC connection properties to the list of JDBC Connection Properties. Removes properties from the list of JDBC Connection Properties. Clears the entire list of connection properties. Saves the properties listed in the JDBC Connection Properties list. The Save Properties feature overrides the default connection properties supplied for a new connection profile and saves the list you created. Sets properties to the default values. If you have saved your properties and overridden the system defaults, the Save Properties values are used as your default values. Configures schema cache properties. Deletes cached files. Connection Actions You can verify that the information defined in the Connection Profile results in a successful connection. Test Connection Tests the connection. Connecting to an Aster Database or Aster Execution Engine Connection profiles contain all the information required to securely connect to an Aster Database or Aster Execution Engine server. 1. Open Data Source Explorer. 2. Right-click an Aster Database connection profile name. 3. Select Connect. The Connection Properties dialog for Aster or Aster AX opens. 4. Verify the User Name. Teradata Studio Express User Guide, Release

28 2: Database Connectivity 5. Type the Aster Database user Password. 6. Click OK. If the connection is successful, the Data Source Explorer displays the list of databases. If the connection is not successful, an error "Problem Occurred" message displays. Click Details >> to view the error log or click OK to close the message. Disconnecting From Aster Database or Aster Execution Engine You disconnect from an Aster server by using the connection profile options. 1. In Data Source Explorer, right-click the Aster connection profile of the Aster server from which to disconnect. 2. Select Disconnect. The Data Source Explorer pane refreshes, and the database list collapses to now display only the name of the Aster connection profile. Deleting an Aster Connection Profile You delete a connection profile directly from the Data Source Explorer. 1. Open Data Source Explorer. 2. Right-click the name of the connection profile you want to delete. 3. Select Delete. 4. Click Yes to confirm you want to delete the profile. The Data Source Explorer refreshes and the connection profile name no longer displays in the folder hierarchy. Adding and Editing JDBC Connection Properties You can add JDBC connection properties when you create or edit a connection profile. You also can edit JDBC properties at any time from Data Source Explorer or Navigator. The Add button is located on the right side of the JDBC Connection Properties display area. 1. In Aster Database Connection Properties, click Add. The Add JDBC Property dialog displays a list of JDBC properties and values that you can add to the connection profile. 2. Under JDBC Properties, select the property you want to add. 3. [al] To enter a JDBC property that is not listed, select USER_ENTERED_PROPERTY, and enter the name and paired value. The property value displays in the Select Property Value field as <name_property>=<property_value>. 4. Click OK. The new property value displays in JDBC Connection Properties. 5. Click Save Properties to save the JDBC property. Teradata Studio Express User Guide, Release

29 2: Database Connectivity Note: If the property already exists in the list, a confirmation dialog displays. Click OK to replace the JDBC property in the list. 6. Repeat the above steps to add multiple properties. Changing the Aster User Password You can change the user password set in the Connection Profile for a connection to an Aster Database. 1. In Data Source Explorer, right-click an Aster Database name and select Aster > Change Password. 2. Type the current password. 3. Type the new password. 4. Retype the new password in the Confirm Password field. 5. Click OK. Adding an Aster Database Driver Definition When you create the Connection Profile for an Aster Database, you also can create a new driver definition for that database. 1. Open the New Connection Profile wizard. 2. Select Aster from the list of Connection Profile Types and enter a Name for the connection profile. 3. [al] Type a. 4. Click Next. 5. To add a new driver definition, click. a. Select the Aster External JDBC Driver template. b. In Driver name, type a unique name for the driver definition. c. On the JAR List tab, add the list of Aster JDBC Driver JARs. To locate your Aster JDBC Driver JAR files on the file system, click Add Jar/Zip. d. On the Properties tab, edit the JDBC driver properties. e. Click OK to save your new Aster Driver definition and return to the New Aster Connection Profile wizard. New JDBC Property Enter a valid JDBC property name and property value for the JDBC property/value pair. Property names and values must not contain commas or equal signs. Teradata Studio Express User Guide, Release

30 2: Database Connectivity New JDBC Property Name and Value Property Name Property Value Type the name of the property you want to add to the JDBC Connection Properties list. The name must not exceed 30 characters. Type the value for the property name. The value must not exceed 30 characters. When you click OK, the property name and value you define display in the Select Property Value field in the Add JDBC Property dialog in the format property_name = property_value. Add a JDBC Property You can add JDBC connection properties when you create a new Connection Profile. You can edit those properties at any time by right-clicking the Connection Profile and selecting Properties. To add a JDBC property, select the JDBC property you want to add and then select the property value. To manually enter a JDBC property, select the JDBC property named USER_ENTERED_PROPERTY. In the New JDBC Property dialog, enter a user-defined property name and value, and click OK. JDBC Properties Select JDBC Property Select Property Value Select a property from the list. If you select USDER_ENTERED_PROPERTY, the New JDBC Property dialog displays in which you can type a new user-defined property name and value. When you click OK, the property name and value you define displays in the Select Property Value field in the format property_name = property_value. Select a JDBC property value from the list. Names must not exceed the 30 character limit. If no values are displayed in the list, you can select USER_ENTERED_PROPERTY in the Select JDBC Property field and create a user-defined name/value property pair in the New JDBC Property dialog. About Caching Aster Schemas When working with Aster databases, you can designate specific schemas to be cached. Caching Aster schemas creates a schema cache file that contains the metadata for the schema. The metadata describe the schema tables, columns, constraints, indexes, mr functions, views, and so forth. Cached schema are associated with a Connection Profile. If you delete the Connection Profile, the Schema Cache list and any schema cache files associated with that Connection Profile are also deleted. You can cache Aster schema and set cache properties when you: Teradata Studio Express User Guide, Release

31 2: Database Connectivity Create a new Connection Profile - Select cache schemas when you create a new Connection Profile using the New Aster Connection Profile wizard. See Caching Aster Schemas. Edit existing cache schema list - Modify Aster cache properties from the Data Source Explorer. See Editing Aster Cache Schema Properties. Each cached Aster schema node in the Data Source Explorer is indicated by an When you connect to the Aster database and open the Schemas folder, a schema cache file is created in a background job. You can view the progress of the schema cache job in the Progress Monitor view by selecting Window > Show View > Other > General > Progress and click OK. Note: icon. After you select schema to cache or edit cache and open the Schemas folder, the Serialization process occurs. To complete the caching process, you must disconnect and reconnect to the Connection Profile. You can open the Progress Monitor to view the serialization process. Caching Aster Schemas You can cache Aster schema and set cache properties when you create a new Connection Profile using the New Aster Connection Profile wizard. Any schemas that you select in the Schema Cache Properties dialog are cached. You can also modify Aster cache schema properties from the Data Source Explorer. 1. Create a Connection Profile for an Aster Database. 2. In the New Aster Connection Profile wizard select a driver and complete credentials for logging on to the Aster database server. 3. Click Cache Properties on the first page of the wizard. The Schema Cache Properties dialog opens. 4. [al] Under Cache Properties select the Cache Selected Schemas check box if you want to view all available schemas for caching. 5. Confirm the connection to the database to get the list of schemas by clicking OK. If the credentials for the Connection Profile are valid and the connection is successful, a list of the schemas associated with the Connection Profile display in the Select Schema area. Note: If the credentials are not valid, an error message displays. 6. From the Select Schema list select one or more schema to cache by checking the box beside the schema name. 7. Click OK. Note: If objects are modified in a cached schema, you must refresh the schema cache to cause the changes to be reflected in the cache. To refresh schema cache, right-click the cached schema object in the Data Source Explorer and select Refresh Schema Cache. Teradata Studio Express User Guide, Release

32 2: Database Connectivity Schema Cache Properties The Schema Cache Properties dialog enables you to select Aster schemas that you want cached. Cache Properties s The following options require a valid set of credentials for connecting to the selected Aster schemas. You provide credentials when you create a Connection Profile, and they are saved in the Connection definition. Cache Selected Schemas Select Schema Opens a dialog that confirms you want to proceed with creating a connection to collect a list of schemas. Lists the schemas associated with the Connection Profile display in this text area if the credentials for the Connection Profile are valid and the connection is successful. Note: If the credentials are not valid, an error message displays. To test your connection, close the Schema Cache Properties dialog by clicking Close, and click Test Connection. Note: If objects are modified in a cached schema, you must refresh the schema cache to cause the changes to be reflected in the cache. To refresh schema cache, right-click the cached schema object in the Data Source Explorer and select Refresh Schema Cache. Editing Aster Cache Schema Properties You can edit caching properties using the Schema Cache Properties dialog available from the Data Source Explorer. 1. In the Data Source Explorer, right-click the Aster cached schema to be edited. 2. Select Properties. The Schema Cache Properties dialog opens. 3. Select the schemas you want to cache using one of the following options: Single selection Select all Clear all Selects an individual schema. Selects all schema names in the list. Clears all schema names from the list. Teradata Studio Express User Guide, Release

33 2: Database Connectivity 4. Click OK. 5. If you are prompted with a message asking if you want to reconnect to the server, click OK. About Refreshing Schema Cache After you create schema cache files, if you refresh the list of schemas by clicking Refresh, the cached schemas are loaded from the schema cache file. Cached schema are indicated in the Data Source Explorer view with the cache icon. If new database objects are modified in the schema while it is being loaded from the schema cache, the modified objects do not appear in the Data Source Explorer until you refresh the schema cache. To refresh the schema cache, right-click a cached schema and select Refresh Schema Cache. This deletes the schema cache file, launches a new background job to create a new schema cache file, and refreshes the list of schemas. You can also refresh the schema cache by deleting the schema cache files using the Aster Database Connection Properties Delete Cache Files option and then reconnecting the Connection Profile. The Data Source Explorer now shows the changes to the database objects. A subsequent refresh of the Schemas folder loads the schema from the schema cache file. Deleting Aster Cache Files You can delete Aster cache files using the Delete Cache Files button in these dialogs: Aster Database Connection Profile wizard Aster Database Connection Properties Deleting cache files does not disable the caching of Aster schemas. It only deletes the cache files that have been generated. When you connect to the Connection Profile, the files are recreated to cache. Any schemas you selected to be cached in the Cache Schema Properties dialog continue to be cached. To disable caching, you must remove the schema from the Select Schema list in the Cache Schema Properties dialog. 1. Open the Aster Database Connection Profile wizard or the Aster Database Connection Properties dialog. 2. Under JDBC Connection Properties, click Delete Cache Files. 3. When you are asked if you want to delete the cache files, click Yes. Hadoop Connectivity A Hadoop connection profile defines the information required to connect to an instance of a Hadoop Database on your system. It contains information such as the database server name, user name, and password required to establish the connection, port number, Hadoop vendor, and connection properties. Access to Cloudera or Hortonworks clusters within a Kerberos realm are supported. Teradata Studio Express User Guide, Release

34 2: Database Connectivity Adding and Editing JDBC Connection Properties for a Hadoop Connection You can add JDBC connection properties when you create or edit a Hadoop connection profile. The Add button is located on the right side of the Additional JDBC Properties display area. 1. In JDBC Connection Properties, click Add. The Add JDBC Property dialog opens. 2. Enter the property Name and Value, and select the JDBC Type. 3. Click OK. The new property value displays in JDBC Connection Properties. 4. Click Save Properties to save the JDBC property. 5. Repeat the steps above to add additional properties. Creating a Hadoop Generic System Connection Profile 1. In the Data Source Explorer or Navigator, click to create a new connection. 2. Select Hadoop from Connection Profile Types. 3. At Name, type a name to identify the connection profile. 4. [al] At, type a description of this Connection Profile. 5. Click Next. 6. Select Generic and TDCH as the Connection Service. 7. Specify when to connect: Connect when the wizard completes Connect every time the workbench is started Connect to the database when you complete the profile. Connect to this database each time you launch the workbench. 8. Click Next. 9. At WebHDFS Host Name, type the host name or IP address of the system configured to provide access to the Hadoop system. 10. At WebHDFS Port Number, type the port number to use to communicate with the WebHDFS service. 11. At WebHDFS User Name, type the user name with permissions to access the WebHDFS host. 12. If the Hadoop cluster has High Availability enabled for the namenode (the cluster has an active and standby namenode), select HA Enabled Cluster, then type the host name or IP address of the standby or backup namenode or host in Secondary WebHDFS Host Name. 13. Click Next to view the Summary information. 14. Click Finish to create the connection profile. Teradata Studio Express User Guide, Release

35 2: Database Connectivity Hadoop Cloudera Connection Profiles When creating Hadoop Cloudera connection profiles, you can select different connection options based on your current system connection setup and your data transfer needs. You should select Kerberos Security Authentication if your Hadoop Cloudera system is configured within a Kerberos realm. Connection TDCH Select this option if you plan to use this connection for data transfers between the Cloudera System and a Teradata Database. Teradata Connector for Hadoop (TDCH) enables you to move data between Teradata Databases and Hadoop systems. Manual metadata update for an Impala instance is required. Please refer to the REFRESH/INVALIDATE METADATA statements in the Cloudera Impala documentation. TDCH is not available for Teradata Studio Express. SQL-H Select this option if you plan to use this connection for data transfers from the Cloudera System to an Aster Database. Manual metadata update for an Impala instance is required. Please refer to the REFRESH/INVALIDATE METADATA statements in the Cloudera Impala documentation. SQL-H is not available for Teradata Studio Express. Smart Loader Hive Impala Presto Select this option if you plan to use this connection to import data from text delimited files into a Hadoop System. Select this option if you plan to use this connection to access the Hadoop Cloudera System using SQL from the SQL Editor. This option uses the Hive JDBC driver to access your Hadoop System. Select this option if you plan to use this connection to access the Hadoop Cloudera System using SQL from the SQL Editor. This option uses the Hive Impala JDBC Driver to access your Hadoop System. Select this option if you plan to use this connection to access the Hadoop Cloudera System using SQL from the SQL Editor. This option uses the Presto JDBC Driver to access your Hadoop System. Creating Hadoop Cloudera Connection Profiles You can create a Hadoop Cloudera Connection Profile using the connection options in the New Connection Profile wizard. 1. In the Data Source Explorer or Navigator, click to create a new connection. 2. Select Hadoop from Connection Profile Types. 3. At Name, type a name to identify the Connection Profile. 4. [al] At, type a description of the Connection Profile. 5. Click Next. 6. Select Cloudera. Teradata Studio Express User Guide, Release

36 2: Database Connectivity 7. [al] If your Hadoop Cloudera system is configured within a Kerberos realm, select Kerberos under Security Authentication. 8. [al] Select TDCH if you plan to use this connection for data transfers between the Hadoop Cloudera System and a Teradata Database. 9. [al] Select SQL-H if you plan to use this connection for data transfers from the Hadoop Cloudera System to an Aster Database. 10. [al] Select Smart Loader if you plan to use this connection to import data from text delimited files into a Hadoop Cloudera System. 11. [al] Select Hive if you plan to use Hive JDBC to create and run SQL. If you select this option, you cannot select the Impala or Presto options. 12. [al] Select Impala if you plan to use Hive Impala JDBC to create and run SQL. 13. [al] Select Presto if you plan to use Presto JDBC to create and run SQL. If you select this option, you cannot select the Smart Loader option. 14. [al] Specify when to connect: Connect when the wizard completes Connect every time the workbench is started Connect to the database when you complete the profile. Connect to this database each time you launch the workbench. 15. Click Next. 16. If Kerberos authentication is selected you will need to enter the authentication properties. a. If Smart Load or Impala are selected, enter the name of the Kerberos Realm. b. If Presto is selected, enter the SSL TrustStore Path and SSL TrustStore Password. c. Click Next. 17. If you selected a TDCH and/or Smart Load connection, enter the WebHDFS connection credentials: a. At WebHDFS Host Name, type the host name or IP address of the system configured to provide access to the Hadoop systems. b. At WebHDFS Port Number, type the port number to use to communicate with the Hadoop system. c. At WebHDFS User Name, type the user name with permissions to access the WebHDFS host. For systems configured with Kerberos authentication, this should typically be the principal user name. d. If the Hadoop cluster has High Availability enabled for the namenode (the cluster has an active and standby namenode), select HA Enabled Cluster, then type the host name or IP address of the standby or backup Namenode/WebHDFS host at Secondary WebHDFS Host Name. e. Click Next. 18. If you selected a SQL-H and/or an Impala or Presto connection, enter the WebHCat connection credentials: Teradata Studio Express User Guide, Release

37 2: Database Connectivity a. At WebHCat Host Name, type the host name or IP address of the Apache HCatalog system that manages the metadata services for your Hadoop system. b. In WebHCat Port Number, type the port number to use to communicate with the WebHCat host. c. In WebHCat User Name, type the user name with permissions to access the WebHCat host. For systems configured with Kerberos authentication, this should typically be the principal user name. d. Click Next. 19. Select a driver from Select a driver from the drop-down. The default JDBC driver for the Hadoop provider and connection service is selected. If you want to create a new driver definition, click. a. In JDBC Host, type the host name of the Hadoop System to which to connect. b. In JDBC Port Number, type the port number to use to communicate with the host. c. In JDBC Database, type the name of the Hadoop database. d. In JDBC User Name, type the user name to use to connect to the database. For systems configured with Kerberos authentication, this should typically be the principal user name. e. In JDBC Password, type the password required to access the database using Hive JDBC. f. Select Save Password to save the password. g. Select HTTP Transport Mode to transfer data using the HTTP secure transfer mode. h. In HTTP Path type the HTTP server path or accept the default. i. For connection services other than Presto, select LDAP Security Enabled to enable LDAP authentication. j. For a Presto connection, select JDBC Logging to generate JDBC log information. 20. Click Next to view the Summary information. 21. Click Finish to create the connection profile. Hadoop Hortonworks Connection Profiles When creating Hadoop Hortonworks connection profiles, you can select different connection options based on your current system connection setup and your data transfer needs. You should select Kerberos Security Authentication if your Hadoop Hortonworks system is configured within a Kerberos realm. Connection Knox Gateway TDCH Select this option if you currently connect to your Hortonworks Hadoop System through a Knox Gateway. The Apache Knox Gateway is a REST API gateway for interacting with Hadoop clusters. See Creating a Hortonworks Self-Signed Certificate for instructions about retrieving and installing certificate information. Select this option if you plan to use this connection for data transfers between the Hortonworks Hadoop System and a Teradata Database. Teradata Connector for Hadoop (TDCH) enables you to move data between Teradata Databases and Hadoop systems. TDCH is not available for Teradata Studio Express. Teradata Studio Express User Guide, Release

38 2: Database Connectivity Connection SQL-H Smart Loader Hive Presto Select this option if you plan to use this connection for data transfers from the Hortonworks Hadoop System to an Aster Database. SQL-H is not available for Teradata Studio Express. Select this option if you plan to use this connection to import data from text delimited files into a Hadoop System. Select this option if you plan to use this connection to access the Hortonworks Hadoop System using SQL from the SQL Editor. This option uses the Hive JDBC driver to access your Hadoop System. Select this option if you plan to use this connection to access the Hortonworks Hadoop System using SQL from the SQL Editor. This option uses the Presto JDBC Driver to access your Hadoop System. Creating a Hortonworks Self-Signed Certificate If you are using a Knox Gateway for connection to a Hortonworks Hadoop system and the Knox Gateway uses a certificate that is not issued by a trusted certificate authority (for example, it uses a self-signed certificate), you must retrieve the certificate used by the Knox server and install it in your Java Runtime certificate store. 1. Retrieve the Knox certificate by doing one of the following: From the Knox server From a web browser Run the command: keytool -export -alias gateway-identity -rfc -file knox.crt -keystore <path to gateway.jks keystore. For example: /usr/lib/ knox/data/security/keystore/gateway.jks Follow your browser's instructions for exporting a certificate. For example, if you use Chrome: a. Enter the Knox server:port in the address bar. You will see a message that the connection is not private. b. Click the Google customize and control icon in the upper right hand corner of the window to open the drop-down menu. Depending on your version of Google, this may appear as an orange circular icon or three vertical dots. c. Select More tools and then Developer tools d. In the Developer tools view, open the Security tab. e. Click View certificate. f. Select the Details tab in the resulting dialog and click the Copy to file... button. g. In the resulting Certificate Export Wizard, save the certificate as Base-64 encoded. 2. Install the certificate into your Java Runtime certificate store by running the command: %JDK_HOME%\bin\keytool.exe -importcert -alias "TDH240 Knox self-signed certificate" -file cert_location/<filename>.txt -keystore %JRE_HOME%\lib\security\cacerts where %JDK_HOME% is an environment variable with the location of a JDK and %JRE_HOME% is the location of the JRE used to run Studio. Teradata Studio Express User Guide, Release

39 2: Database Connectivity The keytool.exe will ask for the password to the certificate store. The password is changeit unless you have already changed it. Creating Hadoop Hortonworks Connection Profiles You can create a Hadoop Hortonworks Connection Profile using the connection options in the New Connection Profile wizard. 1. In the Data Source Explorer or Navigator, click to create a new connection. 2. Select Hadoop from Connection Profile Types. 3. At Name, type a name to identify the Connection Profile. 4. [al] At, type a description of the Connection Profile. 5. Click Next. 6. [al] Select Knox Gateway if you currently connect to your Hortonworks Hadoop System through a Knox Gateway. If you select this option, the Smart Load and Hive JDBC options are selected and disabled as no additional information is required for those options when Knox is selected. Kerberos is unselected and disabled since only Knox credentials are used to establish a connection, even on a Kerberized cluster. Presto is also unselected and disabled as it is not supported with Knox. 7. [al] Select TDCH if you plan to use this connection for data transfers between the Hortonworks Hadoop System and a Teradata Database. 8. [al] Select SQL-H if you plan to use this connection for data transfers from the Hortonworks Hadoop System to an Aster Database. 9. [al] Select Smart Loader if you plan to use this connection to import data from text delimited files into a Hortonworks Hadoop System. If you select this option, Hive is automatically selected as the Hortonworks Hive JDBC Driver will be used to access the Hortonworks Hadoop System. 10. [al] Select Hive if you plan to use Hive JDBC to create and run SQL. 11. [al] Select Presto if you plan to use Presto JDBC to create and run SQL. If you select this option, you cannot select the Smart Loader option. 12. [al] Specify when to connect: Connect when the wizard completes Connect every time the workbench is started Connect to the database when you complete the profile. Connect to this database each time you launch the workbench. 13. Click Next. 14. If you selected the Knox Gateway option, specify the properties for the Knox gateway connection: a. At Gateway Host, type the host name. b. At Gateway Port Number, type the port number for the host. c. At Cluster Name, type the cluster name. Teradata Studio Express User Guide, Release

40 2: Database Connectivity d. At Gateway User Name, type the user name for the Knox Gateway. e. [al] In Gateway Password, type the password for the Knox Gateway. f. Select Save Password to save the password. g. Select SSL Enabled to enable Secure Sockets Layer encryption. h. Select a driver from Select a driver from the drop-down. The default JDBC driver for the Hadoop provider and connection service is selected. If you want to create a new driver definition, click. i. [al] To add additional JDBC properties, click Add, enter the Name and Value, and select the variable Type. j. Click Next. 15. If Kerberos authentication is selected you will need to enter authentication properties. a. If Smart Load or Hive are selected, enter the name of the Kerberos Realm. b. If Presto is selected, enter the SSL TrustStore Path and SSL TrustStore Password. c. Click Next. 16. If you selected a TDCH and/or Smart Load connection, enter the WebHDFS connection credentials: a. At WebHDFS Host Name, type the host name or IP address of the system configured to provide access to the Hadoop systems. b. At WebHDFS Port Number, type the port number to use to communicate with the Hadoop system. c. At WebHDFS User Name, type the user name with permissions to access the WebHDFS host. For systems configured with Kerberos authentication, this should typically be the principal user name. d. If the Hadoop cluster has High Availability enabled for the namenode (the cluster has an active and standby namenode), select HA Enabled Cluster, then type the host name or IP address of the standby or backup Namenode/WebHDFS host at Secondary WebHDFS Host Name. e. Click Next. 17. If you selected a SQL-H and/or Hive or Presto connection, enter the WebHCat connection credentials: a. At WebHCat Host Name, type the host name or IP address of the Apache HCatalog system that manages the metadata services for your Hadoop system. b. In WebHCat Port Number, type the port number to use to communicate with the WebHCat host. c. In WebHCat User Name, type the user name with permissions to access the WebHCat host. For systems configured with Kerberos authentication, this should typically be the principal user name. d. Click Next. 18. If you specified a Smart Loader, Hive, or Presto connection, select a driver from Select a driver from the drop-down. The default JDBC driver for the Hadoop provider and connection service is selected. If you want to create a new driver definition, click. Teradata Studio Express User Guide, Release

41 2: Database Connectivity a. In JDBC Host, type the host name of the Hadoop System to which to connect. b. In JDBC Port Number, type the port number to use to communicate with the host. c. In JDBC Database, type the name of the Hadoop database. d. In JDBC User Name, type the user name to use to connect to the database. For systems configured with Kerberos authentication, this should typically be the principal user name. e. In JDBC Password, type the password required to access the database using Hive JDBC. f. Select Save Password to save the password. g. Select HTTP Transport Mode to transfer data using the HTTP secure transfer mode. h. In HTTP Path type the HTTP server path or accept the default. i. For connection services other than Presto, select LDAP Security Enabled to enable LDAP authentication. j. Select JDBC Logging to generate JDBC log information. 19. Click Next to view the Summary information. 20. Click Finish to create the connection profile. Oracle, DB2, and SQL Server Connections The system also supports connections to Oracle, DB2, and SQL Server Connections. These connections are contributed by the vendors to Eclipse. To use these connections, contact the vendor for the JDBC driver and instructions. Teradata Studio Express User Guide, Release

42 3 Teradata Data Lab About Data Lab A data lab is a separate dedicated work space, also known as a "sandbox", within the data warehouse where you can explore, analyze new data, and test data value theories. Developers of new analytic queries can combine their personal, ad hoc, or temporary data with production data for agile development. About the Data Lab View The Data Lab View provides access to your tables from a Teradata Data Lab. It is a tree view that displays the hierarchy of Data Lab groups with child Data Labs. In the hierarchy, a Data Lab has tables as children. From the view you can copy, load, and export data into Data Labs. The Data Lab View also allows you to create tables derived from external file data using the Smart Load Wizard. Teradata Studio Express User Guide, Release

43 3: Teradata Data Lab Teradata Connection Profile Provides access to a list of Connection Profiles. You must connect to the profile before you can select it in the list. The Teradata Database version displays beside the selected profile name. Data Lab Groups Lab groups allocate space for data labs and can be organized to fit your objectives for the labs, such as by individual, function, department, or region. Groups display as a hierarchy with child data labs in expandable views below parent groups. Tables Accessible from Data Lab Tables display as child data labs of a data lab group. Opening the Data Lab View 1. From the Data Transfer perspective, click the Data Lab icon on the toolbar to open the Data Lab View. Copying Tables to Data Labs The Data Lab View enables you to access tables as child data labs in a data lab group. Copying a Teradata table to a data lab is as easy as dragging the source table from the Data Source Explorer and dropping it into the Data Lab View. The Data Lab Copy Wizard guides you through the steps of performing a table copy. Note: The Copy Wizard is not provided in Teradata Studio Express. 1. Open the Data Source Explorer and navigate to the table object to copy to the Data Lab View. 2. Drag the table object to the Data Lab View and drop it on the parent data lab group. 3. In Copy Table verify the Source and Destination information is correct. 4. If the table does not exist in the data lab group, select from these options: Copy Data Lock Table Copies the source table data to the data lab table. To create a new table that is empty, de-select this option. If the target table exists, select to append or replace the data in the Data Lab. Locks the table during the copy operation. Locking tables might cause performance to be slow. 5. If the table already exists in the data lab group, select from these options: Lock Table Append to Existing Data Locks the table during the copy operation. Appends the source table data to the end of the data in the destination table. Teradata Studio Express User Guide, Release

44 3: Teradata Data Lab Replace Existing Data Replaces all existing data in the data lab table with the source table data. 6. Click Next. 7. In Filter Table specify which table columns to copy and then select a filter type and data value to filter the data in the column. This filter creates the SELECT statement for the COPY operation. 8. Click Next. 9. In SQL Preview Filter Table, review the generated SQL for the COPY operation. 10. Click Finish. 11. Monitor the progress of the COPY operation in the Transfer Progress View. Data Lab Copy Wizard About the Data Lab Copy Wizard The Data Lab View supports drag and drop of table objects from Data Source Explorer. When you drop a table into the Data Lab View, the Data Lab Copy Wizard opens. Note: The Copy Wizard is not provided in Teradata Studio Express. Using the wizard you can specify data filters to determine which columns and data to copy to the Data Lab. You can also lock the table while you are transferring data using the Lock Table option. The Copy Wizard displays the following dialogs: Dialog Name Copy Table Displays the database and table name of the data source and destination. Use this screen to verify that the copy information is correct. If you are copying to a new table, you can select the Copy Data option to copy the data when the new destination table is created. Clear this option to create an empty table. If you are copying to an existing table in the Data Lab, you must specify whether you want the data appended to the existing data or to replace all existing data with the source table data. Filter Table SQL Preview Filter Table Enables you to select which columns in the source table to copy to the Data Lab table. After you select a column, you can refine the copy operation by specifying which data in that column to copy. The default is to transfer all data. Displays the generated Data Definition Language (DDL) script that copies the source table to Data Lab. The copy job can be run by clicking Finish. Teradata Studio Express User Guide, Release

45 3: Teradata Data Lab About Copy Table When you drag and drop a table from the Data Source Explorer to the Data Lab View, the Copy Wizard displays the name of the source and destination tables in the Copy Table dialog. Source Database The source information includes the names of the Connection Profile, Database, and Table from which the data is copied. Destination Database The destination information includes the names of the Connection Profile, Database, and Table to which the Copy Wizard copies the data. Instructions for Copy Job You can specify these options for the Copy job: Copy Data Lock Table Creates the destination table and copies the source data to the new table. If you want to create an empty table, do not select this option. Locks source and destination tables during the data transfer. Teradata Studio Express User Guide, Release

46 3: Teradata Data Lab About Filter Table The Copy Wizard enables you to review the source table columns and specify which columns and data you want copied to the Data Lab destination table. Column Filter Lists filter types available. You must enter a value that is valid for the column data type. The data type displays beside the column name. Column Select for Copy Allows you to select a check box beside a column name to copy the column to the destination table. All columns are selected by default. Actions on All Columns Allows you to perform actions on all columns at the same time. All columns are selected by default. Use the Clear All and Select All buttons to act on all columns in the table. About SQL Preview Filter Table The generated Data Definition Language (DDL) script that copies the source object to its destination displays in the Generated SQL text area. Teradata Studio Express User Guide, Release

47 3: Teradata Data Lab Generated DDL Script DDL Script generated from the information you provided in previous screens of the Copy Object Wizard. Run this script to perform the copy operation. Teradata Studio Express User Guide, Release

48 4 Query Development Data Tools for Query Development Teradata provides multiple tools to assist you in developing queries for the Teradata databases in your system. Data Tools Teradata SQL Editor SQL Query Builder Compare Editor Compare SQL Object Wizard Result Set Viewer SQL History View Statistics Collection View Extends the Eclipse Data Tools Platform (DTP) SQL Editor to provide SQL development on Teradata databases. Extends the Eclipse Data Tools Platform (DTP) SQL Query Builder to provide execution on Teradata databases. Compares the Data Definition Language (DDL) text of two database objects. Enables you to compare the Data Definition Language (DDL) text in a database object with another object of the same type in either a Teradata Database or Aster Database. Provides an enhanced view of a result set that includes options to hide columns, filter on column values, find column values, copy data to the clipboard, format cell data, and switch between grid and text view. Provides historical information about SQL/DDL executions on one or more databases in your system. Collects the statistics on table columns and indexes that are important to producing query plans. Teradata SQL Editor About the SQL Editor The SQL Editor provides an integrated environment for the development of SQL files that enable you to develop SQL statements for execution. The editor enables you to validate SQL syntax, save files to a project or export to system files, and execute all SQL in a file or execute the SQL as individual statements. You must specify a Connection Profile before you can execute an SQL query statement. The SQL Editor displays when you open an SQL/DDL file or when you select the Query Development Perspective. Double-clicking an SQL/DDL file in the Project Explorer opens that file in the editor. You can also open the SQL Editor by clicking perspective. in the Query Development Teradata Studio Express User Guide, Release

49 4: Query Development Connection Profile Name Selects the profile in which to run the SQL script. You do not have to connect to a Connection Profile to display the Connection Profile name in the list. Editor Work Area Displays the active SQL edit window. You can insert, delete, and modify SQL statements displayed in this area. Note: After SQL is executed, any passwords displayed in the editor will be masked. If you want to re-execute the SQL, you will need to type in the passwords. Connection Status Indicator Shows the status of the connection to the selected Connection Profile. Green indicates that the connection is active. Autocommit Toggle When selected, submits each SQL statement in autocommit mode. Each SQL statement is then executed in its own transaction that ends with a COMMIT statement. You cannot roll back an SQL statement that is executed in autocommit mode. When Autocommit is set to ON, the Autocommit check box in the toolbar is selected. To turn Autocommit OFF, clear the check box. Max Rows Changes the maximum number of rows returned by SQL executed in this editor. SQL Execution s Displays a list of Execute options. You can select to Execute an Individual Statement that you have selected, or to Execute All query statements in the editing pane. SQL Editor Toolbar A set of tools to manage and execute SQL. Content Assist Provides aids for validating, debugging, and editing the SQL queries you develop in the editor. You can use the Text Editors preference settings ( Window > Preferences > General > Editors > Text Editors) to change the appearance of the SQL Editor, including displayed tab widths, color options, line numbers, hover overs, and more. Using the SQL File Editor The Teradata SQL Editor supports: Teradata Database connection profiles Aster Database connection profiles Teradata Studio Express User Guide, Release

50 4: Query Development Hadoop File System connection profiles with JDBC enabled If you are working with SQL files located on a different type of database, such as Oracle or MS SQL Server, you must work in the SQL File Editor. 1. Do one of the following: In Project Explorer, right-click the SQL folder. Open the SQL Editor and right-click in the main editor pane. 2. Select Open With > Other... The Editor Selection dialog displays. 3. Select SQL File Editor. 4. Click OK. 5. Under Connection Profile, select the Type of database for this connection; for example, Oracle_10 or SQL Server_ Select the Name of the connection profile from the list. Only existing connection profiles display in the list. 7. Select the Database name from the list. Aster and Hadoop have no database name. 8. Verify the status of the profile you selected. Status information displays to the right of the Database name. If no connection profile exists for a particular profile type, the Name and Database fields are blank. Drag and Drop into SQL Editor You can drag objects from the Data Source Explorer and drop them into the SQL Editor to build your SQL statement. The object name appears in the SQL Editor at the location where you drop it. SQL Editor Preferences The SQL Editor preferences customize the behaviors and look-and-feel of the SQL Editor. To set preferences for general editor appearance and behaviors, go to Window > Preferences > Data Management > SQL Development > SQL Editor. General Tab You can specify the following general preference settings: Syntax Validation Validates the syntax of the SQL statement. Enable syntax validation Syntax validation automatically updates the structure of an SQL statement in the Outline view and performs the syntax validation as you edit. The SQL Parser parses the SQL statement according to the Teradata Studio Express User Guide, Release

51 4: Query Development grammar for the version of Teradata or Aster specified in the Connection Profile. Note: Disabling validation also disables portability checking and the Outline view. Portability check target Maximum number of lines Prompt to disable system validation when content exceeds maximum number of lines Show detailed annotation information Selects the Teradata database type to use as the standard target for portability checks. You must enable syntax validation to select a portability target. Select None to indicate no database type for portability checks (default). Each line that is not portable to the target is annotated with a check. You can display additional information by placing the cursor over the marker. Specifies the maximum number of lines of SQL content to validate before disabling syntax validation. Select a number that optimizes validation without impacting editor performance. The default is Clear the check box to indicate no restriction to the number of lines of SQL to validate. Displays a message asking if you want to disable system validation. The message displays if the number of lines in the SQL file exceeds the value entered in Maximum number of lines. When selected enables the SQL Editor to display the list of possible correct syntax options when a syntax error occurs in the SQL statement. Execute Current Text Specifies what delimits the current text when you select Execute Current Text from the SQL Editor menu. Execute SQLs between delimiters Execute current line Execute SQLs between blank lines Selects the delimiter used in text to separate SQL statements for execution. Selects only the currently selected line of SQL code is to be executed. Selects to use blank lines as the delimiters for separating SQL statements for execution. Typing Tab Select check boxes to enable or disable typing aids that are available when editing in Smart Insert mode. Click to select an option and display the SQL in the Preview text area. Teradata Studio Express User Guide, Release

52 4: Query Development Close single quotes Close double quotes Close parentheses Close comments Begin-End Inserts characters to close a single quote in the SQL Editor. Inserts characters to close a double quote in the SQL Editor. Inserts characters to close a parentheses in the SQL Editor. Inserts characters to close multi-line comments in the SQL Editor. For example, if you type /* to indicate the start of a comment, the editor inserts */ to close the comment. Adds the End with proper indentation in the SQL Editor, and then moves the cursor to a new line between Begin/End with proper indentation. SQL Formatter Preferences This preference page is where you can configure the options which control the Teradata formatting strategy for SQL text using the following options: Main Keyword Case Specifies how to format keywords using the following sub-options: Uppercase Converts all keywords to uppercase Lowercase Starts with Uppercase Unchanged Converts all keywords to lowercase Converts only the first letter to uppercase and the rest of the keyword is lowercase Keywords are left as they were Identifier Case Specifies how to format identifiers using the following sub-options: Uppercase Converts all identifiers to uppercase Lowercase Starts with Uppercase Unchanged Converts all identifiers to lowercase Converts only the first letter to uppercase and the rest of the identifier is lowercase Identifiers are left as they were Stacking Lists Specifies how to arrange lists, such as Select lists, From lists, Order By lists, Group By lists, Parameter lists, and Column definition lists. If there is only a single item in the list, the formatter always places it on the same line as the context keyword, regardless of the option. Same Line Line Break After Comma Line Break Before Comma Line Break Before Comma with Space Unchanged Places list items all on the same line Places a line break after the comma Places a line break before the comma Places a line break before the comma and adds a space after the comma Lists are left as they were Teradata Studio Express User Guide, Release

53 4: Query Development Main Indentation Space Size Where Clause Break Specifies whether to use spaces or tabs for indentation. Specifies the size of the indentation for spaces. The value must be between 0 and 9. If tabs were chosen for the indentation option, the tab size is specified on the General > Editors > Text Editors Preference page (Displayed tab width). Specifies whether to place the AND and OR elements of the WHERE clause on separate lines or the same line. Line Break and Indent Same Line Places the list of AND and OR elements on new lines at the indentation level. Places the list of AND and OR elements on the same line. SQL Editor Toolbar The SQL Editor toolbar enables Connection Profile selection and action buttons that help you manage and execute SQL for supported databases. The SQL Editor Toolbar contains the following: Connection Profile Select a Connection Profile from the list. If the selected profile is not connected, confirm you want to connect by clicking Yes, enter the connection password, and click OK. Connection Status Shows the status of the connection to the selected Connection Profile. Green indicates that the connection is active. Autocommit Toggle When selected, submits each SQL statement in autocommit mode. Each SQL statement is then executed in its own transaction that ends with a COMMIT statement. You cannot roll back an SQL statement that is executed in autocommit mode. When Autocommit is set to ON, the Autocommit check box in the toolbar is selected. To turn Autocommit OFF, clear the check box. Connect to Selected Profile Connects to the connection profile, if it is disconnected. Commit If Autocommit is off, performs a commit. Rollback If Autocommit is off, performs a rollback. Max Rows Changes the maximum number of rows returned by SQL executed in this editor. SQL Execution s Displays a list of Execute options. You can select to Execute an Individual Statement that you have selected, or to Execute All query statements in the editing pane. Teradata Studio Express User Guide, Release

54 4: Query Development Cancel Running Statements Aborts a running SQL request. Save s Saves the SQL file to a project. Export Results to File When toggled on, exports the SQL results to a file instead of displaying in the Result Set viewer. Import Data to Volatile Table Lets you load external data into a volatile table. Clear Query Clears the SQL displayed in the editor. Rename Editor Renames the editor. View Result Sets View result sets created by this editor. String Substitution When toggled on, performs a direct string substitution for parameters in the SQL Editor. When the SQL is executed a dialog box appears for the user to enter the substitution for a named parameter in queries. Pertains to Teradata Database and Aster 6 and later systems, not Hadoop. New SQL Editor Opens a new SQL Editor. This action does not close the current editor, enabling you to work with multiple editors in tandem. SQL Handling Preferences Opens the SQL Handling Preferences. SQL Handling Common The Results Handler options enable you to select a result set handler to process SQL result sets. Qualify names for drag and drop in SQL Editor Prompt for notes Auto-connect to profile when selected in SQL Editor Results Handler (Default) Clear this check box if you do not want names qualified when you drag and drop objects from the Data Source Explorer to the SQL Editor. Check this check box if you want to be prompted to enter SQL execution notes. When you execute SQL statements, a dialog appears which prompts you to enter the note. The SQL History view displays your note text in the Note column. Select this check box to automatically connect to the selected profile within an instance of the SQL Editor. (Default) Select one: Teradata Studio Express User Guide, Release

55 4: Query Development Teradata Export Wizard (File Export) option handles result sets by exporting SQL to a file using the Teradata Export Wizard. (Default) Teradata Result Set Viewer option displays SQL result sets in the Result Set Viewer. Sampler Content Size Type a value for the sample content size. Default is 100. Teradata The following Large Value Handling settings enable you to set column size restrictions for creating BLOBs and CLOBs in Teradata tables. Handle Binary/Byte columns as BLOBs if size > Handle Character columns as CLOBs if size > Specify the limits for creating BLOBs for large binary values in results. Binary results are treated as BLOBs when their column size is greater than the value you enter. A value of zero specifies that all binary values are treated as BLOBs. Default is 30. Specify the limits for creating CLOBs for large character values in SQL results. Character values in results are treated as CLOBs when their column size is greater than the value you enter. A value of zero specifies that all character values are treated as CLOBs. Default is Aster The following Large Value Handling settings enable you to set size restrictions for creating BLOBs and CLOBs in Aster tables Handle Binary/Byte columns as BLOBs if size > Handle Character columns as CLOBs if size > Specify the limits for creating BLOBs for binary results. Binary results are treated as BLOBs when their column size is greater than the value you enter. A value of zero specifies that all binary values are treated as BLOBs. Default is 30. Specify the limits for creating CLOBs for results. Character values in results are treated as CLOBs when their column size is greater than the value you enter. A value of zero specifies that all character values are treated as CLOBs. Default is Sounds The Sounds settings enable you to customize audible indicators for success and failure notification sounds during SQL execution. Teradata Studio Express User Guide, Release

56 4: Query Development Success Sound Failure Sound Select one of these options: No sound (default) System Beep Secret Sound If you select Secret Sound, click Browse to select a sound file on your system. Select one of these options: Success Sound No sound (default) System Beep Secret Sound If you select Secret Sound, click Browse to select a sound file on your system. BLOB Disposition The BLOB Disposition form appears in the LOB Disposition Dialog when the results contain columns with large binary values. The form contains the following fields: Field Column Name Save to File Display images in Result View Location Browse File Base Name File Extension View the name of the column in the results. Saves the values of the column to files. When this check box is cleared the fields for specifying the name and location of files are unavailable. Displays the values that can be decoded as images in the result view as images. Enter the name of the folder where the files are to be saved. Click to display a dialog box that allows you to browse for the Location. This is the main component of the name of the files that are created for the large objects. The final name consists of the base name, the number of the row in the results that contains the value, and the File Extension. File extension component of the name of the files that are created for the large objects. CLOB Disposition The CLOB Disposition form appears in the LOB Disposition Dialog when the results contain columns with large character values. The form contains the following fields: Field Column Name Save to File Location View the name of the column in the results. This field can not be modified. Saves the values of the column. When this check box is cleared, the fields for specifying the name and location of files are unavailable. Type the name of the folder where the files are to be saved. Teradata Studio Express User Guide, Release

57 4: Query Development Field Browse File Base Name File Extension File Encoding Click to browse for the folder to be the Location value. Base name to give to the files created for the large objects. The final name consists of the base name, the number of the row in the results that contains the value and the File Extension. File extension to give to the files created for the large objects. Name of the encoding to use when the character values are written to the files. LOB Disposition The LOB Disposition dialog appears when the results of running an SQL statement contain CHARACTER LARGE OBJECT (CLOB) or BINARY LARGE OBJECT (BLOB) values, or character or binary values specified to be treated as large objects. The dialog contains a form for each column of the results that is a large object type. The forms enable you to specify how to handle the values. You can specify to store the values in files. In the case of binary data, you can specify that the values that are images are displayed in the Result View. The forms for specifying how the values are to be handled are: CLOB disposition: Specify the handling of large character values BLOB disposition: Specify the handling of large binary values As you enter values in the forms, the message at the top of the dialog indicates if there is an invalid value. When a form contains an invalid value the OK is disabled. Clicking Cancel displays a dialog that indicates large values are not saved to files. Setting SQL Handling Preferences Use the SQL Handling Preferences dialog to set very large value handling rules for objects, such as BLOBs, CLOBs, and LOBs, in the SQL Editor. 1. Click Window in the top menu and select Preferences. 2. In the Preferences navigation pane, expand Teradata Datatools Preferences. 3. Select SQL Handling. The SQL Handling dialog displays in the right pane. There are three tabs: Common, Teradata, and Aster. 4. Click the Common tab to set SQL rules for both Teradata Database and Aster database. a. Select Qualify names for drag and drop in SQL Editor to qualify names when objects are dragged from the Data Source Explorer and dropped in the SQL Editor. Clear this check box if you do not want names qualified. b. Select Prompt for notes to be able to enter a note when you execute SQL. The Note dialog lets you enter a text value that displays in the Teradata SQL History view in the Note column. Teradata Studio Express User Guide, Release

58 4: Query Development c. Under Results Handler, the Teradata Result Set Viewer is selected as the results handler for processing SQL result sets. 5. Click the Teradata tab to set large value handling rules in Teradata Databases. a. In Handle Binary/Byte columns as BLOBs if size >, type the number of bytes for column size which when exceeded, the object is handled as a binary large object (BLOB). Note: A value of zero specifies that all binary values are handled as BLOBs. b. In Handle Character columns as CLOBs if size >, type the number of characters which when exceeded, the object is handled as a character large object (CLOB). The default is Note: A value of zero specifies that all character values are handled as CLOBs. 6. Click the Aster tab to set large value handling rules in Aster databases. a. In Handle Binary/Byte columns as BLOBs if size >, type the number of bytes for column size which when exceeded, the object is handled as a binary large object (BLOB). Note: A value of zero specifies that all binary values are handled as BLOBs. b. In Handle Character columns as CLOBs if size >, type the number of characters which when exceeded, the object is handled as a character large object (CLOB). The default is Note: A value of 0 (zero) specifies that all character values are handled as CLOBs. 7. [al] To clear selections and restore default settings, click Restore Defaults. 8. To apply your changes, click Apply. 9. Click OK to apply your changes and close the Preferences dialog. Execute SQL The SQL Editor provides various options to execute SQL statements within an SQL file. To access the following options, click the appropriate button in the toolbar or right-click inside the SQL Editor text area. Label Execute as Individual Statements Executes all statements or selected statements one at a time, displaying the result as a Teradata Group Execution in the SQL Results view. This option allows you to execute SQL DDL statements, which Teradata Studio Express User Guide, Release

59 4: Query Development Label requires its own COMMIT between statements. The group result includes an individual SQL Result for each statement. Execute All Executes all SQL statements in the SQL File and displays the result as a single entry in the SQL Results view. Multiple result sets display in multiple Result tabs. Running SQL Teradata Studio has the following ways to run SQL operations on your Teradata systems: The SQL Editor provides the ability to define and run SQL statements. See the Using the SQL Editor topic for details of how to run SQL statements from the SQL Editor. Run Configurations let you define operations that you can run from the Run menu and Run toolbar button. See the Running SQL from Run Menu and Toolbar topic for details of how to specify run configurations and how to run them. Running database objects - Several types of objects can be "run" in from the Data Source Explorer. See the following section for details. Running Database Objects Another way that operations can be performed in the database is by using the Run menu item in the pop-up menu shown when you right-click certain objects in the Data Source Explorer tree. The types of objects that can be Run from the Data Source Explorer are (followed by the result of selecting Run): Stored Procedures - Displays the Configure Parameters dialog box where the procedure's parameters are specified. The Stored Procedure is called with the specified parameters. The values of the parameters after the call is completed, including the OUT and INOUT parameters, are shown in the Parameters tab of the SQL Results view. User-defined Functions - Displays the Configure Parameters dialog box where the procedure's parameters are specified. The UDF is SELECTED with the specified parameters. The values of the parameters are shown in the Parameters tab of the SQL Results view. The value of the UDF is shown in the Result1 tab. Macros - Displays the Configure Parameters dialog box where the procedure's parameters are specified. The macro is executed with the specified parameters. The results of the macro are shown in the Result tab(s) of the SQL Results view. Triggers - Displays the Edit Configuration dialog box where the SQL statement that performs the operations that causes the trigger to be run is specified. The specified SQL statement is run and the results of the SQL operation are shown in the SQL Results view. When SQL operations are performed using the Run menu item, a launch configuration specifying the way the operation was run is created. See the Running SQL from Run Menu topic for details of how to rerun, edit and remove the automatically created launch configurations. Teradata Studio Express User Guide, Release

60 4: Query Development Format SQL Command The Format SQL toolbar command formats the SQL statement in the SQL Editor. The formatter uses the formatting options specified in the SQL Formatter Preferences. The SQL Formatter Preferences are available from Window > Preferences > Teradata Datatools Preferences in the main menu. Explain and Dynamic Explain The Explain command displays the step-by-step translation of the query plan used in executing the SQL query in the SQL editor. The Dynamic Explain command displays the step-by-step plan of a query that uses IPE (incremental planning and execution). After executing a query in the SQL Editor, you can view the Explain or Dynamic Explain steps in the Result Set Viewer. You can also view the results by selecting either of those commands from the SQL menu or by pressing F6 for Explain or F7 for Dynamic Explain. The outline view displays an outline of the Explain or Dynamic Explain SQL statement in the editor area and lists the steps in a structured format. Set Connection Information The Set Connection Info menu option changes the Connection Profile for an SQL Editor file. You can select the database server type, connection profile name, and database name from the drop down lists then click OK. SQL Editor Templates SQL templates for creating SQL statements in the SQL Editor are provided in three ways: Generate SQL options SELECT, INSERT, UPDATE, and DELETE statement templates for tables. These Generate SQL options are available from the Query Development perspective when you right-click a table object in Data Source Explorer. Content Assist templates In-context insertion of SQL statements in SQL Editor. To invoke the SQL Templates, place your cursor at the point in the SQL text where you want assistance and enter CNTL+SPACE. Templates View for Aster analytical functions Aster-only view that displays a list of function templates you can drag and drop into the SQL Editor. Templates provided through the Content Assist mechanism help you create Data Manipulation Language (DML) type SQL statements, such as DELETE, INSERT, SELECT, and UPDATE. Template variables support tabbing from one variable to another. Template variables are linked allowing you to change one occurrence of a variable, for example, tablename1, and automatically change all occurrences of that same variable in the template. The Content Assist selection list includes all available SQL templates for creating SQL at the cursor insertion point in the text. Teradata Studio Express User Guide, Release

61 4: Query Development Retrieving Table Rows using a SELECT Template 1. Click Query Development to open the Query Development perspective. 2. Open the Data Source Explorer and navigate to the Teradata or Aster database table in which you want to insert rows. 3. Right-click the table object and select one of these options: For Select Teradata Database Aster Database Hadoop File System Teradata > Generate SQL > SELECT Statement Aster > Generate SQL > SELECT Statement Hadoop > SELECT Statement 4. In the SQL Editor, review the generated SELECT statement and edit as needed. 5. Click to execute the SELECT statement to retrieve the row in the table. Inserting Table Rows using an INSERT Template You can generate an INSERT statement template in the SQL Editor that inserts rows in a Teradata or Aster database table. The INSERT (Values) Statement menu option enables you to modify the generated statement and provide all query values. If you want to create a parameterized query, select the INSERT (Parameterized) Statement menu option. 1. Click Query Development to open the Query Development perspective. 2. Open the Data Source Explorer and navigate to the table in which you want to insert rows. 3. Right-click the table object and select one of these options:. For Teradata Database Aster Database Select Teradata > Generate SQL > INSERT (Values) Statement Aster > Generate SQL > INSERT (Values) Statement 4. In the SQL Editor, modify the generated INSERT statement to specify the values for the columns based on data types. 5. Click to execute the INSERT statement to insert the row into the table. Teradata Studio Express User Guide, Release

62 4: Query Development Inserting Table Rows using Parameterized Queries You can generate an INSERT statement template in the SQL Editor that uses parameter placeholders in those cases where you could specify constants. When you execute the SQL, the editor prompts you to specify the values for each of the parameter placeholders. You also have the option to load the default values for the parameters. 1. Click Query Development to open the Query Development perspective. 2. Open the Data Source Explorer and navigate to the database table in which you want to insert rows. 3. Right-click the table object and select one of these options:. For Teradata Database Aster Database Select Teradata > Generate SQL > INSERT (Parameterized) Statement Aster > Generate SQL > INSERT (Parameterized) Statement 4. In the SQL Editor, review the generated INSERT statement and edit as needed. 5. Click to execute the INSERT statement. 6. In Configure Parameters, specify the values for each of the parameters or click Load Defaults to specify default values. 7. Click OK. The SQL INSERT statement runs and inserts the row in the table. Parameterized Queries SQL statements can contain parameter placeholders (question marks) in most cases where you can specify constants. When you run SQL that contains one or more parameter placeholders from the SQL Editor, you are prompted to specify the values for each of the parameters. The values you specify are substituted for the parameter placeholders when the SQL executes. Named Parameters A special SQL element in the SQL Editor enables you to assign names to parameter placeholders. The form of the new element is:?\name Teradata Studio Express User Guide, Release

63 4: Query Development This form follows the rules of forming unquoted names which is a question mark followed by a back slash followed by a name with no space between the parts. Parameters that are specified without a name, that is, by using just the question mark alone, display with the name "Parameter n" where the n indicates the index of the parameter for the SQL value. For character string or binary columns, the Configure Parameters dialog provides a From File option which reads the input value from a file. To specify the input file, select the cell ellipsis (...) and display a dialog in which you can specify the input file. Re-executing Parameterized Queries When you select an entry in the list of operations in the SQL Results view that is produced by running parameterized SQL and select Reexecute from the context menu, you are presented with a dialog for specifying the parameter values. The dialog initially contains the values that were used to produce the results. Updating Table Rows using an UPDATE Template You can generate an UPDATE statement template in the SQL Editor to update table rows. 1. Click Query Development to open the Query Development perspective. 2. Open the Data Source Explorer and navigate to the database table in which you want to delete rows. 3. Right-click the table object and select one of these options: For Teradata Database Aster Database Select Teradata > Generate SQL > UPDATE Statement Aster > Generate SQL > UPDATE Statement 4. In the SQL Editor, review the generated UPDATE statement and optionally add conditions to the WHERE clause to update rows. 5. Click to execute the UPDATE statement and update the row in the table. Teradata Studio Express User Guide, Release

64 4: Query Development Deleting Table Rows using a DELETE Template You can generate a DELETE statement template in the SQL Editor to delete rows in an Aster Database table. 1. Click Query Development to open the Query Development perspective. 2. Open the Data Source Explorer and navigate to the Teradata or Aster database table in which you want to delete rows. 3. Right-click the table object and select one of these options:. For Teradata Database Aster Database Select Teradata > Generate SQL > DELETE Statement Aster > Generate SQL > DELETE Statement 4. In the SQL Editor, review the generated DELETE statement and optionally add conditions to the WHERE clause to delete rows. 5. Click to execute the DELETE statement and delete the row in the table. Inserting Aster Analytical Functions The Aster Database includes scripts for analytical function templates that you can insert into the SQL Editor. 1. Select a connection profile that connects to an Aster Database. 2. Click Query Development and launch the SQL Editor. The SQL Editor, Result Set Viewer, and Teradata SQL History views open. 3. In the main toolbar, select Windows > Show View > Other The Show View dialog opens. 4. Scroll up to General and select TemplatesView which is located at the bottom of the list. The Templates View opens below the SQL Editor. You can drag and dock the view in the left pane beside the Data Source Explorer to see the full list easily. Teradata Studio Express User Guide, Release

65 4: Query Development 5. Select a function in the Templates View and preview the script text in the Preview area below the view. 6. Drag and drop the selected Aster function into the SQL Editor to insert it. The text for the Aster analytical function displays at the point you drop it in the SQL Editor script. 7. Substitute your values for the template variables and execute the script. About Teradata SQL Query Builder Teradata SQL Query Builder extends the Eclipse Data Tools Platform SQL Query Builder to provide execution on Teradata. SQL Query Builder provides a graphical interface to create, edit, or run SQL statements. It provides access to your database schema and objects so that you can quickly create or edit SQL statements without actually typing any SQL code. You also have the flexibility to add or modify the SQL code in the editor window. You can open the Teradata SQL Query Builder in the SQL Editor by right-clicking an SQL file in the Project Explorer and choosing the Open With option, then selecting Teradata SQL Query Builder from the list of Editor choices. Note: You must have a Connection Profile assigned for the SQL file. Note: Some syntactic variations might exist between Teradata SQL syntax and the SQL syntax that the Eclipse DTP SQL Query Builder supports; consequently, some SQL Query Builder features might not work with Teradata SQL syntax. For example, Teradata allows for abbreviated keywords such as "sel" for "select", or "ins" for "insert", which the DTP SQL syntax does not support. Teradata Studio Express User Guide, Release

66 4: Query Development Note: Also, if multiple SQL statements exist in the file, SQL Query Builder uses the first statement and ignores the rest. It also does not handle nested SELECT statements. The Teradata SQL Query Builder supports four types of SQL statements: SQL Statement Type SELECT INSERT UPDATE DELETE Creates a SELECT statement to retrieve data from a database and displays the result set in a table format. Creates an INSERT statement to insert rows into the table. Creates an UPDATE statement to update data in a table. Creates a DELETE statement to remove data from a specified table. The SQL Query Builder provides tabs to edit the Columns, Conditions, Groups and Group Conditions. Right-clicking the graphical area background provides options to add tables or create joins. Right-clicking a table provides options to add a table, create a join, replace a table, select all columns, deselect all columns, update an alias, and remove a table. You can also drag table objects from the Data Source Explorer and drop them in the graphical display of the SQL Query Builder to easily add tables to your SQL statement. The SQL Query Builder can also be launched from the SQL Editor context menu by selecting a SQL statement then choosing the option Edit in SQL Query Builder. The SQL Query Builder displays the SQL statement as well as a graphical view of the tables, columns, and table joins. Note: If you select an existing statement to edit in the SQL Query Builder, make sure that the tables are qualified with the database name or that the designated database from the Connection Profile is the database involved in the SQL statement. Otherwise the SQL Query Builder does not recognize the columns and table joins for the graphical display. Also, if you perform a "SELECT *", the columns are not selected (checked) in the graphical view of the table. Only columns specifically named in the query are selected (checked) in the graphical view of the table. An Outline Viewer is displayed to the right of the graphical display. This shows a high-level outline view of the SQL Statements. Result Set Viewer The Result Set Viewer provides an enhanced view of the result set, including options to hide columns, filter on column values, find column values, copy data to the clipboard, format cell data, and switch between grid and text view. The result set is displayed in its own view with its own toolbar. Teradata Studio Express User Guide, Release

67 4: Query Development You can change preferences to customize the view by, for example, displaying alternating row background colors, enabling or disabling row numbers, column headers, table grid lines, and thousand separator on numeric columns. You can change the max display row count, as well as the display null value and date format. Refer to Result Set Viewer Preferences for more detailed information of the Result Set Viewer preferences. The Single Result Set Toolbar contains: Icon Preferences Show SQL Set Focus Rename Result Tab Text or Grid Display Format Selected Cells Pin Result Set Clear All Save Export Print Click to open the Result Set Viewer Preferences page. Click to open a dialog that displays the SQL statement. Click to set the focus to the associated SQL editor. Click to open a dialog that allows you to rename the result tab. Click to switch the view of the result set data between grid or text. The default is grid. Click to open the platform specific Font dialog which enables you to select the font, size, and color (on most platforms) of the selected cells. Click to pin the result set. Pinned result sets are not closed by the Clear All action. Pinned result sets must be closed manually. Click to clear all result sets in the Viewer. Click to save the result set data to a file within the workspace. The Eclipse Save Result dialog appears, which allows you to select the project, file name, file type, and export options. Click to export the result set data to an external file. The Eclipse Export Result dialog appears, which allows you to select the file name, format, and export options. Click to print the result set data. The Eclipse Print dialog appears, which allows you to select the printer, page range, and number of copies. The Multiple Result Sets Toolbar contains: Icon Preferences Show SQL Rename Result Tab Rename Group Result Tab Text or Grid Display Click to open the Result Set Viewer Preferences page. Click to open a dialog that displays the SQL statement. Click to open a dialog that allows you to rename the result tab. Select one of the group result tabs while in Tab display mode. Right- click the tab and select the Rename Group Result tab menu option. Click to switch the view of the result set data between grid or text. The default is grid. Teradata Studio Express User Guide, Release

68 4: Query Development Icon Sash or Tab Display Pin Result Set Refresh Result Set List Save Save All Export Export All Print Print All Click to switch the display of the multiple result sets between a tab folder or side-by-side sash framework. The default is tab folder. You can remove a result set from the sash framework by clicking the. Note: When result sets are displayed in a sash framework, you can not select a single result set for export, save, or print options. Click to pin the result set. Pinned result sets are not closed by the Clear All action. Pinned result sets must be closed manually. Click to refresh all of the removed result sets. Click to open to the Eclipse Save Result dialog which allows you to select the project, file name, file type, and export options and save the selected result set to a file within the workspace. Note: This option is unavailable when result sets are displayed in the sash framework. Click to open the Eclipse Save Result dialog which allows you to select the project, file name, file type, and export options and save all of the result sets to a file within the workspace. This option is enabled when you execute multiple SQL statements in a single execution, using the following SQL Editor menu options: Execute All, Execute Select Text (and more than one SQL statement is selected), or Execute Selected Text as One Statement. Click to open the Eclipse Export Result dialog which allows you to select the file name, format, and export options and export the selected result set to an external file. This option is unavailable when result sets are displayed in the sash framework. Click to open the Eclipse Export Result dialog which enables you to select the file name, format, and export options and export all of the result sets to an external file. This option is enabled when you execute multiple SQL statements in a single execution, using the following SQL Editor menu options: Execute All, Execute Select Text (and more than one SQL statement is selected), or Execute Selected Text as One Statement. Click to open the Eclipse Print dialog which enables you to select the printer, page range, and number of copies to print the selected result set. This button is disabled when result sets are displayed in the sash framework. Click to open the Eclipse Print dialog which enables you to select the printer, page range, and number of copies to print all of the result sets. This option is enabled when you execute multiple SQL statements in a single execution, using the following SQL Editor menu options: Execute All, Execute Select Text (and more than one SQL statement is selected), or Execute Selected Text as One Statement. The Grid Menu contains: Icon Hide Column Click to hide the selected column Teradata Studio Express User Guide, Release

69 4: Query Development Icon Show All Columns Select Column Auto resize column Auto resize row Rename column Find Find Next Find Next Reverse Aggregates Filter column Remove filters Freeze column Format Selected Cells Copy Cells Click to show all columns. Previously hidden columns are also shown. Click to select the entire column. Click to resize the column to fit the largest cell. Click to resize the row to fit the largest cell. Click to rename the column header. Click to search for a result set data value. Click to find the next match value in the result set data. Click to find the next match value in the result set data in the reverse direction. Click to compute aggregates for the selected column values. Click to create a filter on the column data. Click to remove filters for the column. Click to freeze scrolling at the selected column. All columns to the left are displayed. All columns to the right are scrolled. To unfreeze, click again. Click to open the platform specific Font dialog which enables you to select the font, size, and color (on most platforms) of the selected cells. Click to copy the cell data to the clipboard. The default is to copy the cell data into an HTML table. You can copy cells to Excel, Word, or an . The Text Display Menu contains: Icon Copy Select All Find Find Next Click to copy the selected text to the clipboard. The text is copied as a string to the clipboard. Click to select the entire text string displayed. Click to search for a result set data value within the text string. Click to find the next match value in the result set data. Other Actions: Sort Column Click the column header. An arrow appears indicated the direction of the sort, ascending or descending order. Clicking a third time returns the column back to its original order. Teradata Studio Express User Guide, Release

70 4: Query Development Move Column Long Text Display LOB Display Select a column and drag it just past the new position. If a cell contains text that exceeds the length specified by the Long Text Boundary Size in the Result Set Viewer Preference, only the first 20 characters of the text is displayed. Double-click the data to display the full text. When a result set contains CLOBs (Character Large Objects) or BLOBs (Binary Large Objects), a dialog appears that enables you to indicate whether to save the LOB to a file and the file location, as well as whether to display images in the Result View. Result Set Viewer Preferences The Result Set Viewer Preferences dialog enables you to set display options for result set data. Result Display Tab Display alternate Result Set rows in color Show Row Numbers Show Column Headers Show Table Grid Lines (*) Display Column Titles rather than Column Names (*) Max Display Row Count Long Text Boundary Size Display Negative Numbers in Red Display Negative Numbers in Red Translate some Control Characters Displays color in alternate rows of the result set. Click the color box to open the Color dialog and select a basic color or define a custom color to use. Displays row numbers. This option is enabled by default. Displays column headers. This option is enabled by default. Displays lines between rows and columns on the table grid. This option is enabled by default. Displays the column titles (if available) rather than the column names, in the column header area. This option is disabled by default. The query must be rerun in order for a change to this option to take effect. Changes the maximum number of rows to display. The default for this option is The query must be rerun in order for a change to this option to take effect. Changes the long text boundary size. If a data value length is longer than the long text boundary size, only the first 20 characters are displayed. The user can view the entire data value by double-clicking the data in the display grid. A pop-up window is presented with the full data value. The default for this option is 150. Displays negative numbers in red. This option is enabled by default. Translate control characters in the range of 0x0086 through 0x009f as if the bytes 0x86 through 0x9f were translated by the Windows code page cp1252. The query must be rerun for the change in this option to take effect. Translate control characters in the range of 0x0086 through 0x009f as if the bytes 0x86 through 0x9f were translated by the Windows code page cp1252. The query must be rerun for the change in this option to take effect. Teradata Studio Express User Guide, Release

71 4: Query Development Reuse Result Set Viewer Window Causes the Result Set Viewer to refresh the current window with new result sets generated by the SQL Editor. If you deselect the box, the Result Set Viewer creates a new window for each generated result set. Data Format Tab Display Null Value as Display 1000 Separator in Numeric Columns Number Fractional Digits Displayed Display Dashes between Bytes for Binary Data Values Display Float Values using Scientific Notation Display Time/ Timestamp without Time Zone Display Date Format Date Format Value Changes the value that is displayed when the data is null. The default for this options is "null." Displays a 1000 separator in numeric columns. This option is disabled by default. Designates the number of decimal places to display for Float values. By default, the value is blank and the data is presented as returned from the database. Set the value between 1 and 10 to change the number of fractional digits displayed. Displays a dash between each byte of the value for greater ease of reading, for example: 63-b1-a3-62. This option is enabled by default. Displays Float values using scientific notation rather than in decimal format. This option is disabled by default. Displays the time/timestamp without indicating the time zone. For example, instead of 11:37: this Results Set Viewer would show 11:37: This option is disabled by default. Select the format in which you want dates to be displayed. This option uses the Java Simple Date Format notation to format the date display in the result set. The default for this option is yyyy-mm-dd. You can select User Defined if you want to enter a format in the Date Format Value box. Shows the notation used to display date formats, based on the selection in the Display Date Format drop-down list and enables you to enter a format if you selected User Defined. Copy s Tab Delimiter Format Delimiter Value Changes the column delimiter when the Copy data option is used on the grid display. The default for this option is Comma Separated. Other possible choices are Tab Separated and User Defined. Changes the column delimiter value when the User Defined format option is selected. Teradata Studio Express User Guide, Release

72 4: Query Development Copy Include Column Headers Copy Include Grid Lines Select to include column headers when the copy data option is used on the grid display. Select to include cell borders when you use the Copy data option to copy cells from the grid display. Setting Result Set Viewer Preferences Use the Teradata Result Set Viewer preferences to configure the display of result set data. 1. Click Window in the main menu and select Preferences. 2. Expand Teradata Datatools Preferences. 3. Click Result Set Viewer Preferences. 4. In the Result Display tab, select the following options as appropriate: Display alternate Result Set rows in color Show Row Numbers Show Column Headers Show Table Grid Lines (*) Display Column Titles rather than Column Names Select the check box to display color in alternate rows of the result set. Click the color box to open the Color dialog and select a basic color or define a custom color to use. This option is disabled by default. Select to show row numbers in the grid display. This option is enabled by default. Select to show column headers in the grid display. This option is enabled by default. Select to display lines between rows and columns in table grid display. This option is enabled by default. Select to display column titles (if available) instead of column names as labels in column headers. This option is disabled by default. Note: You must rerun the query for these changes to take effect. (*) Max Display Row Count Specify the maximum number of rows to display. The default value is Note: You must rerun the query for these changes to take effect. Long Text Boundary Size Display Negative Numbers in Red Translate some Control Characters Enter the number of characters that will be displayed. The default for this option is 150. Select to enable display of negative numbers in red. This option is enabled by default. Translate control characters in the range of 0x0086 through 0x009f as if the bytes 0x86 through 0x9f were translated by the Windows code page cp1252. The query must be rerun for the change in this option to take effect. Teradata Studio Express User Guide, Release

73 4: Query Development Reuse Result Set Viewer Window Select to refresh the current window with new result sets generated by the SQL Editor. If deselected, the Result Set Viewer creates a new window for each result set generated. 5. In the Data Format tab, select the following options as appropriate: Display Null value as Display 1000 Separator in Numeric Columns Number Fractional Digits Displayed Display Dashes between Bytes for Binary Data Values Display Float Values using Scientific Notation Display Time/ Timestamp without Time Zone Display Date Format Date Format Value Specify the value or string you want displayed when a value results in an empty set or zero value. The default value is null. Select to display a 1000 separator in numeric columns. This option is disabled by default. Enter the number of decimal places to display for Float values. By default, the value is blank. The number must be between 1 and 10. Select to display a dash between each byte of the value for greater ease of reading, for example: 63-b1-a3-62. This option is enabled by default. Select to display Float values using scientific notation rather than in decimal format. This option is disabled by default. Select to display the time/timestamp without indicating the time zone. For example, instead of 11:37: the Results Set Viewer would show 11:37: This option is disabled by default. Specify the format to use to display the date in the result set. Default format is yyyy-mm-dd. When you specify the format, you must use the Java SimpleDateFormat notation to format the date. If you selected User Defined for the Display Date Format option, enter the format. 6. In the Copy s tab, select the following options as appropriate: Delimiter Format Copy Include Column Headers Copy Include Grid Lines Select how you want columns delimited when the Copy data option is used on the grid display: Comma Separated: Uses commas as delimiters to separate column data (default). Tab Separated : Uses tabs as delimiters to separate column data. User Defined: Enter the delimiter you want to use in the Delimiter Value field. Select to include column headers as delimited values when the Copy data option is used on the grid display. Select to include grid lines as delimited values when the Copy data option is used on the grid display. 7. [al] To clear selections and restore default settings, click Restore Defaults. Teradata Studio Express User Guide, Release

74 4: Query Development 8. To apply your changes, click Apply. Note: Clicking Apply or OK refreshes the current display of result sets in the Result Set Viewer to correspond with your changes. 9. Click OK to apply your changes and close the Result Set Viewer Preferences dialog. Results Preferences The Results Preferences provide extended capabilities for exporting results. Excel Export s Alternate Row Colors: Select this check box to alternate row background colors when exporting to Excel. Select a different background color by clicking color. The default for this option is cleared. Big Int/Decimal Format: Select the output format for Big Integers and Decimals. If you choose number, some precision may be lost. The default for this option is String. Success Sound Select the sound that is played when results are successfully loaded into the Result Set Viewer. The default for this option is no sound. No Sound: Play no sound when results are successful. System Beep: Play a system beep when results are successful. Select Sound: Play a sound file of your choosing when results are successful. Sound File: Choose a sound file to play when results are successful. Failure Sound Select the sound that is played when results fail to load into the Result Set Viewer. The default for this option is no sound. Success Sound: Play the same sound as successful results. No Sound: Play no sound when results failed. System Beep: Play a system beep when results failed. Select Sound: Play a sound file of your choosing when results failed. Sound File: Select the sound file to play when results fail. Restore Defaults Apply OK Restore the default values for the options. Apply any option changes that have been made. This may cause a refresh of the current result sets displayed in the Result Set Viewer. Applies any option changes that you made and closes the preferences page. This may cause a refresh of the current result sets displayed in the Result Set Viewer. Teradata Studio Express User Guide, Release

75 4: Query Development Formatting the Foreground in Selected Cells In the Result Set Viewer you can change the foreground of selected cells. You can reset your selections to default settings by clicking the (Format result set) icon on the toolbar. 1. In the Result Set Viewer, select cells in the result set table. 2. Right-click the selected cells, and select Format Foreground of Selected Cells. 3. Select the foreground options you want for the selected cells. 4. Click OK. The foreground changes you select are applied to the selected Result Set Viewer cells. Formatting the Background in Selected Cells In the Result Set Viewer you can apply background formatting to selected cells in the result set table. You can reset your selections to default settings by clicking the (Format result set) icon on the toolbar. 1. In the Result Set Viewer, select cells in the result set table. 2. Right-click the selected cells, and select Format Background of Selected Cells. 3. Select the background color you want for the selected cells. 4. Click OK. The background color changes are applied to the selected Result Set Viewer cells. Java Simple Date Format The Java Simple Data format uses the following symbolic notation for Date formatting: Symbol Definition Example G Era "GG"-> "AD" y Year "yy" -> "033 "yyyy" -> "20033 M Month "M" -> "73 "M" -> "123 "MM" -> "December" d Day in month "d" -> "33 "dd" -> "033 E Day in week "EEE" -> "Tue" "EEEE" -> "Tuesday" D Day in year (1-365 or 1-364) "D" -> "653 "DDD" -> "0653 F Day of week in month (1-5) "F" -> "13 w Week in year (1-53) "w" -> "73 W Week in month (1-5) "W" -> "33 Teradata Studio Express User Guide, Release

76 4: Query Development SQL History View SQL History Form The SQL History form provides an enhanced display of the history information. As you execute SQL statements from the SQL Editor or run functions from the Data Source Explorer, an entry is added to the SQL History list. The history displays extensive information about each SQL execution. It includes execution elapsed time, DBMS time, fetch time, database server, row count, parameter display for macros and stored procedures, as well as displaying the SQL statement and SQL statement type. Note: Any passwords in the SQL statement are masked when displayed in the SQL History form. If you want to re-execute the query, you must edit the query to re-enter the password. The SQL History form displays the data in a grid format that lets you select rows or cells. It provides options to copy cells or rows, sort columns, delete rows, edit the note or SQL for a history entry, filter columns, search for result history data, format the display, and re-execute SQL statements. The SQL History uses an embedded Derby Database to manage the SQL History entries. If you close the form and need to re-open it, go to Window > Show View > Other > SQL History. You can add notes manually by clicking on the Note column value. You can also choose to be prompted to add notes when you execute the SQL. Set the Prompt for notes option using the SQL Handling preferences. You can sort columns in ascending and descending order with the exception of the Parameters column. For single column sorting, left-click the mouse button. For multi-column sorts, note the following: Columns are movable and re-sizable. Many of the columns are grouped together under a collapsible header. Rows can be selected by clicking in the numbered row header. Column order, collapsed columns, filter, sort, and formatting are preserved from session to session. If a filter is in effect, the result of a newly executed SQL statement is inserted as the top row, regardless of whether it meets the filter criterion. If a sort is in effect the new entry is inserted in the sorted order. The Result column contains a summary of the executed SQL operation. To read the entire contents in a column cell, hover the mouse pointer over the cell. Error results show as red text in the resulting tool tip display. The following examples are samples of the Result summary. Example 1: In this example a single statement was executed successfully. Executed as Single statement. >Elapsed time = 00:00: STATEMENT 1: Select Statement completed. 26 rows returned. Teradata Studio Express User Guide, Release

77 4: Query Development Example 2: In this example the executed statement failed. This statement also has this icon associated with it. Executed as Single statement. Failed [3807 : 42S02] Object 'bogus' does not exist. Elapsed time = 00:00: STATEMENT 1: Select Statement failed. Example 3: In this example the executed statement was canceled. This statement also has this icon associated with it. Executed as Single statement. Canceled. Elapsed time = 00:00: STATEMENT 1: Select Statement canceled. Toolbar Actions Icon Delete Selected Rows Filter history display Export history Import history Cleanup history Format History View Sort history display Deletes selected row(s) from the view and history database. Opens a dialog to filter the display. Opens a dialog to export history view items to XML file. Opens a dialog to import history items from either a previously exported XML history file or SQL Assistant history file. Opens a dialog to clean up SQL history records based on selected criteria. Enables you to format the display. The platform-specific Font dialog allows you to select the font, size, and color (on most platforms). Opens a dialog for setting a multi-column sort. Toolbar Menu s Icon Delete Selected Rows Export history Import history Cleanup history Clear Filter Filter Format History View Sort multiple columns Deletes selected row(s) from the view and history database. Opens a dialog to export history view items to an XML file. Opens a dialog to Import history items from either a previously exported XML history file or SQL Assistant history file. Opens a dialog to clean up SQL history records based on selected criteria. Removes the current filter from the display. Opens a dialog to filter the display. Enables you to format the display. The platform specific Font dialog displays to allow you to select font, size, and color (on most platforms). Opens a dialog for setting a multi-column sort. Teradata Studio Express User Guide, Release

78 4: Query Development Context Menu s: Icons Find Find Next Copy Row Copy Cells Delete Row Edit SQL Edit Note Reexecute statement Allows you to search the SQL History view for a value. Finds the next matching value in the history view. Copies the selected row(s). Rows are copied as text and as HTML. The HTML display preserves the column headers. The target to which you paste determines whether text or HTML displays. Copies the cell data to the clipboard. Deletes selected row(s) from the view and history database. Edits the SQL from a selected cell in the SQL Statement column in an SQL Editor. Edits the note from a selected cell in the Note column. Re-executes the SQL from the selected cell in the SQL Statement column. About SQL History Form The SQL History view provides information about SQL/DDL executions on one or more databases in your system. As you execute SQL/DDL statements from the SQL Editor or run functions from the Data Source Explorer, an entry is added to the SQL History list. Toolbar The SQL History toolbar contains actions and menus that help you manage the data in the history data grid. Numbered Rows The first column contains numbers assigned to each rows in the data grid. The numbers start with 1 and increment for each data entry. The numbers do not indicate a special ordering or structure to the history data. Use them as an easy way to refer to rows in the grid. To select an entire row, click the number for the row. You can then right-click and select an action to perform on that row. For example, you might select several rows and then right-click to select Find to search for specific data in those rows. Teradata Studio Express User Guide, Release

79 4: Query Development Column Header Row The top row of the history grid contains the column headers for the categories of data collected during each SQL/DDL execution. SQL History Data Grid The SQL History view uses a data grid format of rows and columns to display information for each SQL/DDL execution. The grid displays each history entry in a single data row. Column headers in the top row distinguish the types of data collected during each execution. Toolbar for SQL History The SQL History toolbar contains icons and menus to help you manage the SQL History view and display of history records. Actions such as Delete Rows and Delete All History, in addition to removing records from the view, delete the records in the SQL history database. Actions Click toolbar icons to perform tasks. You also can access actions from the menu drop-down ( ) at the right-end of the toolbar. Icon Label Delete Row Filter Clear Filter Export History Import History Cleanup History Sort Deletes selected rows from the view and SQL history database. Opens the History Filter dialog to select criteria for filtering data in the view. Resets filter by removing filter criteria and showing all history entries in the view. Displays the Export History dialog to export SQL history records to an XML file. Opens the Import History dialog to import SQL history entries from an exported XML history file or SQL Assistant history file. Opens the Cleanup History dialog to clean up SQL history records using the criteria you specify. Opens the Sort dialog to choose which columns you want sorted. Use the Minimize and Maximize icons at the far right to resize the SQL History view. Cleanup History The Cleanup History dialog enables you to delete SQL History records based on selected criteria Teradata Studio Express User Guide, Release

80 4: Query Development Delete SQL History using a criteria Delete duplicate queries in SQL History Compact unused disk space allocated by SQL History Enables you to delete records based on the following criteria: Date deletes records from the SQL History view when the Timestamp column value is less than the selected date. Source deletes records from the SQL History view when the Source column matches the entered value SQL Statement deletes records from the SQL History view when the SQL Statement column is a super set of the entered value. Notes deletes records from the SQL History view when the Notes column is a super set of the entered value. User ID deletes records from the SQL History view when the User ID column matches the entered value. Queries that failed deletes records from the SQL History view when the query execution failed. Rows with empty Notes deletes records from the SQL History view when the Notes column value is empty. Deletes duplicate SQL query records from the SQL History view. Releases allocated disk space not used by the SQL History view. After the command executes, you must restart the application to make the disk space available. Import History The Import History dialog enables you to import history view items from either a previously exported XML history file or from an SQL Assistant MDB or XML file. Source Type File Name Browse Select either an XML file created using the Export history option or an SQL Assistant history MDB file. Enter the name of the file from which to import the history items. Select a folder and file name. Note: The import of an SQL Assistant MDB file is only available on the Microsoft Windows 32-bit platform. To locate the SQL Assistant history MDB file, start SQL Assistant and click Tools > s and select Locating File Paths for the history file. Export History The Export History dialog enables you to save SQL History view items to an XML file. You can select to export all or specific items from the view. Teradata Studio Express User Guide, Release

81 4: Query Development File Name Browse History Filter All History Filter Selection Displays the name of the XML file to which history entries are saved. Opens a dialog to select the location and file name of an XML file on the file system. Saves all history view items to an XML file. Saves only selected row items. You can select single or multiple rows from the history view. Filtering with Data Filter Use the Data Filter feature to set filter rules that reduce the number of rows loaded into the Table Data Editor. 1. From the Table Data Editor, click Data Filter icon. 2. In Filter, select a filter operator from the list and type a valid value or character string. For example, if values in Column2 are type VARCHAR, and you filter to display only rows LIKE product2, the Table Data grid refreshes to show all rows with the value product2 in the data string. 3. [al] If you want to clear all rules and set new filters, click Clear All. 4. Click OK to show filter results based on your filter rules. Note: The SYSUDTLIB database always shows in the filtered list. 5. When asked to confirm, click OK. Note: If you want to redo the filter results, click Revert in the toolbar, change the filter rules in the Data Filter, and then click OK. You can repeat these steps as often as you like. History Preferences Exclude s for History Database Select one or more of these options to exclude in the Teradata SQL History database: Exclude Explain and Dynamic Explain Statements Exclude Unsuccessful Queries Check this box to exclude EXPLAIN and DYNAMIC EXPLAIN statements in the History database. Check this box to exclude unsuccessful queries from being entered in the History database. Teradata Studio Express User Guide, Release

82 4: Query Development History s Limit History View Rows Maximum Text Display Length Derby Database Location Enter the maximum number of rows allowed to display in the Teradata SQL History view. Enter the maximum number of characters that can be displayed in a row. Displays the location of the SQL history file. To change the location, click Browse and navigate to the desired location. History View Columns Settings Use action buttons to select and move columns between the Columns Shown panel and the Removed Columns panel. Column Actions Remove Remove All Add Add All Up Down Removes the column you select from the Columns Shown list. Removes all columns shown in the Columns Shown list. Moves a column from the Removed Columns list to the Columns Shown list. Adds all columns in the Removed Columns list to the Columns Shown list. Moves a selected column one position up in the list. Moves a selected column down one position in the list. Column s Timestamp Source User ID Destination Result Date and time at which the query ended Data source name User ID logged on TBW - in progress Result message which is blank unless an error occurs. To see full message, hover your mouse over a cell in the Result column. Row Count Teradata Database number of rows matching the query submitted. If you abort a query in progress or decline to continue after the output limit is reached, Rows shows only how many rows matched the query you submitted. Other databases number of rows returned or changed. If you abort, Rows shows only the number of rows returned. Note SQL Statement User note attached to query Query text Teradata Studio Express User Guide, Release

83 4: Query Development Column s SQL Type Length Statements Statement Type Elapsed Time DBMS Time Fetch Time Parameters Sequence Type of database accessed Length of the query in characters Number of statements in the query List of statement types used in the query, such as, CREATE TABLE, INSERT, SELECT. Total elapsed time for the query Time spent within the database Time taken to return the data Number of parameters used in the query Order in which the query was submitted to the database Actions Apply Restore Defaults OK Click to apply your changes. Click to return settings to default values. Click to save your preference settings. Database Objects Search Find Object Find Object Find Object ( ) enables you to find a database object in the Data Source Explorer that matches a certain text value. It begins the search from the point selected in the Data Source Explorer and returns the first object whose name matches the text pattern. Note: The search is not case sensitive. Teradata Studio Express User Guide, Release

84 4: Query Development Find Next Find Next ( ) finds the next database object of the same object type that matches the text value, expands it, and selects it in the Data Source Explorer. Search Value Object Type Find Advanced Find Reset Specifies a value to search for. You can use the database 'LIKE' syntax to provide a more expanded search. The 'LIKE' syntax includes a percent sign ('%') and low line character ('_' ). The percent sign character represents any string of zero or more arbitrary characters. The low line character represents exactly one arbitrary character. For example, the search value of 'emp%' finds the first object whose name starts with 'emp'. Note: You must use the backward slash character '\' as the escape character when entering the special search characters, '\', '_', and '%', in your search value. For example, 'emp\%' searches for the first object whose name equals 'emp%'. Selects the object type from the list of object types for which you want to search. Starts the search process. Opens the Advanced Find dialog. Resets the Search Value to an empty field and the Object Type for the selected location in the Data Source Explorer. Finding Objects You can search for database objects in the Data Source Explorer that have names that match a text string you specify. 1. From the Data Source Explorer, right-click the database or user in which you want to search for an object. 2. Click Teradata > Find Objects. The Find Object dialog opens. 3. For Search Value Enter the exact name of the object you wish to find. The search is case-insensitive. If you know or wish to enter only a portion of the object name, click Advanced Find to open the Advanced Find dialog where you can specify only a portion of the object name in your search criteria. 4. Use the Object Type list to specify the type of database object you are searching for. If you wish to search more than one object type, click Advanced Find to open the Advanced Find dialog where you can specify several types of objects to search. 5. Click Find. If you used the basic Find Object dialog box to search, the Data Source Explorer tree expands to show you the first instance of an object it finds matching your criteria. Teradata Studio Express User Guide, Release

85 4: Query Development You can press F3 or right-click the Data Source Explorer tree and click Teradata > Find Next to search for other objects that have the same name. If you used the Advanced Find Objects dialog box to search, all results of the search are displayed in a tab of the Object Viewer. Advanced Find Objects The Advanced Find Object ( ) feature enables you to find all database objects that match a certain text pattern. It searches the referenced Connection Profile for objects names that match the text pattern. List of Databases or Connection Profiles available for the search Search constraint If you opened Advanced Find Objects dialog from the Databases Folder, a list of databases for the given Connection Profile appears. If you opened the Advanced Find Objects dialog from the Advanced Search button in the simple Find Object dialog at the highest level in the Data Source Explorer, the list of Connection Profiles appears. You can use the arrows to move single selected items to or from the list of objects to be searched. The double arrows allow you to move all available objects to or from the list to be searched. The Find Objects feature uses the search constraint to build a search pattern out of the search value. Note: You must use the backward slash character '\' as the escape character when entering the special search characters, '\', '_', and '%', in your search pattern. The '_' (low line) character represents exactly one arbitrary character. The '%' (percent sign) character represents any string of zero or more arbitrary characters. Types of search constraint are as follows: Search Starts with the characters Ends with the characters Contains the characters Anonymous Name Search Enter a valid SQL search pattern Search value is appended with a '%' character. Search value is prepended with a '%' character. '%' character is added to the begging and end of the search value. Searches for anonymous or empty name values. Anonymous names are valid only for Primary Key, Foreign Key, Check Constraint, and Index names. All other object type name options are disabled. Use for a custom search pattern. The search pattern follows the standard database search pattern as used for the Teradata 'LIKE' option pattern match. For example, if you want to search for all names that have exactly one character after the word 'cust', the custom pattern would be 'cust_'. Or if you want to search all names that match 'sales100%', then the search pattern would be 'sales100\%'. Teradata Studio Express User Guide, Release

86 4: Query Development Search Note: Use the '\' as the escape character when entering the special search characters, '\', '_', and '%', in the search pattern. Search Value Limit size of search result to: Object Types Select All Clear All The text value to search for. The limit to the size of the search result list. Valid values are between 1 and 500. Names you want to compare with the search value. This list is dependent on where in the Data Source Explorer tree you invoke the Find Objects dialog. For example, if you selected a Stored Procedures folder, the Stored Procedure Name and Parameter Name object type options display. Selects all of the Object Type names presented. Clears all of the Object Type names presented. Advanced Find Results The find results are displayed in the Find Results tab in the Object Viewer. The tab shows a list of the objects found that match the search pattern in the Advanced Find Objects dialog. The list displays as a table grouped by object types: Tables Macros Stored Procedures User Defined Functions User Defined Types Views Within each object type category, it is further grouped by sub-element, such as: Columns Constraints Triggers for Tables Parameters for Macros and Stored Procedures Columns for Views Teradata Studio Express User Guide, Release

87 4: Query Development Find Results The Find Results dialog provides a list of the objects found that matched the search pattern entered in the Advanced Find Objects dialog. The list is displayed as a table grouped by object types and within each object type category further grouped into details. Enabling Teradata Unicode Pass-Through Teradata Database 16.0 supports Unicode pass-through. Unicode pass-through enables you to store, retrieve, and analyze emojis and other ideographs. You can utilize this feature by performing the following steps. 1. Set the startup string for the user who will be connecting to the Teradata system: a. In the Administration perspective, double-click Databases and select the user in the Object List Viewer. b. Right-click the row for the user and select Open Database/User. The property form for the user is displayed. c. In the General tab, ensure that the Startup String field reads: set session character set unicode pass through on; If it is not already set, modify the user properties to include the startup string. 2. Add the RUNSTARTUP JDBC property for the connection: a. In the Teradata JDBC Connection Properties step of the Connection Profile wizard, enter the credentials for the user and Teradata Database 16.0 system you are connecting to. b. Click the Add button next to JDBC Connection Properties. c. In the Add JDBC Property dialog, select the RUNSTARTUP JDBC property, select the property value ON, and click OK. The new property is listed in the JDBC Connection Properties display box. 3. Set the font that supports displaying symbols such as emojis: a. From the Window menu, select Preferences. b. Expand General > Appearance and click Colors and Fonts. c. Select Text Font, and click the Edit button. d. In the Font dialog, select the Segoe UI Symbol font and click OK. e. Click OK to close the Preferences dialog. Showing Table Row Counts You can show the row count in one or more Teradata Database, Aster, or Hadoop tables. 1. From the Administration perspective, select a database in the Navigator. A list of available objects display in the Object List Viewer. 2. Click to highlight one or more tables in the Object List Viewer and do one of the following: From the toolbar, click. Right-click an object and select Row Count. A list of the selected tables with their row count displays in the Row Count(s) property form. Teradata Studio Express User Guide, Release

88 4: Query Development You can also view row counts from the Data Source Explorer in the Query Development perspective by right-clicking the table and then selecting Teradata, Aster, or Hadoop > Row Count. Teradata Studio Express User Guide, Release

89 5 Table Data Development About the Table Data Editor The Table Data Editor is an advanced editor for viewing and editing table data stored in a Teradata Database or Teradata Aster Database. The editor can manage any size table including very large tables that contain thousands of rows of data. You can also export table data to a file, such as Microsoft Excel, for further review. You can insert, delete, and update data in a table, and then filter to see the rows that have changed due to your edits. You can also set filter rules on table columns to show only data of interest. For ease of access and viewing, the Table Data Editor organizes data rows into pages that you select using page controls in the toolbar. The default is 500 rows per page, but you can define a preferred page size at the top of the editor. Toolbar The Table Data Editor toolbar contains navigation aids and action buttons that help you manage, filter, and edit data in a database table. Column Header Row The top row of the Table Data Editor shows the labels and data types for the table columns. Numbered Row Column You can show or hide the first column by setting your preference in the Table Data Editor Preference dialog. The column shows row numbers for the table you are editing. Teradata Studio Express User Guide, Release

90 5: Table Data Development Table Data Grid The Table Data Editor displays rows and columns of a database table in a spreadsheet grid format that shows relationships of data in the table. To update and see the most current view of this data, click Refresh in the toolbar. Status Bar This area displays error and system messages. Table Data Editor The Table Data Editor enables you to work directly with data stored in tables in a Teradata Database or Teradata Aster Database. The editor interface is a table grid of columns and rows that displays the corresponding data columns and rows of the selected database table. You can right-click rows and columns to view the actions you can perform on data. You can resize column and row widths by dragging line separators for column and row headers. Toolbar Use the toolbar to page to specific rows and to set the number of rows per page. You can also use the toolbar to save, filter and sort, revert, export, and refresh data. Table Data Grid The Table Data Editor displays a grid of columns and rows. The grid rows and columns correspond to the rows and columns in the table you selected from the Data Source Explorer tree. If the table you selected contains a large number of rows, the editor automatically creates data pages which you can size using the Page Size field in the toolbar. The default is 1000 rows per page. Actions on Columns Right-click a column header and select an option in the list. Hide columns Show all columns Auto resize column Find/Replace Show Values Hides a column from the Table Data grid. The column in which you right-clicked to select this option is the column that is hidden. To undo the hide, select Show all columns. Causes any hidden columns to re-display in the Table Data Editor. Changes the column width back to the auto-set width. Opens the Find/Replace dialog in which you can enter keywords to search data. Opens the Show Values dialog in which you can specify filter rules and show only rows that meet those rules. To undo a Show Values filter result, select Reset Show Values. Teradata Studio Express User Guide, Release

91 5: Table Data Development Reset Show Values Resets rows to the order that existed prior to the Show Values filtering of the column data. Actions on Rows Right-click a row or cell and select an option from the list. Auto resize now Copy Insert Revert Delete Select Rows for Export Clear Rows for Export Resizes rows back to the auto-set height. Copies one or more rows in the table for pasting to a data spreadsheet file; for example, Microsoft Excel. Inserts a row in the table. Reverts the rows you select by undoing your changes to that row. You are prompted to confirm the operation. Click OK to revert. Deletes the rows you select. Deleted rows are highlighted. To undo a row deletion, select the row and next select Revert. Selects rows for export by placing an Export icon in all selected rows. The icon is aligned left in the first column of the row. Deselects rows for export. The change is indicated by the removal of the Export icon in the first column of the row. Clear All Selected Rows for Export Resets all rows previously selected for export. The Export column disappears. icon is the first Export Selected Rows Opens the Export Data dialog to export all data rows selected for export. Rows selected for export are marked by an Export icon in the first column. Actions on Cells Right-click a table cell and select an option from the list. Undo Cut Copy Paste Delete Undoes the last change. Removes the data from one or more selected table cells and retains for pasting to a different cell. Copies data you want to paste to a data spreadsheet file; for example, Microsoft Excel. Pastes data from the clipboard into selected table cell. Deletes the data in the cell. Teradata Studio Express User Guide, Release

92 5: Table Data Development Status Bar The status bar at the bottom of the gird shows errors and Save status for the Table Data Editor. Toolbar The Table Data Editor toolbar contains navigation aids and action buttons that help you manage, find, and edit the data in a database table. Table Navigation Use the following features to navigate to specific rows in a large table. Row of Page Size Type the row number to display at the top of the table data grid. Use the drop-down menu to select a recent row number. Shows the number of data rows in the table. You cannot edit this field. Select the number of rows to include per page from the drop-down list. For example, if you select 1000, the first page begins at 1, and the second page begins at The default page size is 500. Actions Click toolbar icons to perform tasks. Icon Label Select First Page Select Previous Page Select Next Page Select Last Page Save Filter by Edits Goes to the first page of table data pages. Displays next page. Displays previous page. Goes to last page of table data pages. Commits data changes to the database. You can view the SQL DDL statement in the SQL Preview view before you click the Save icon. Displays the Show Edits dialog. Teradata Studio Express User Guide, Release

93 5: Table Data Development Icon Label SQL Preview Revert Data Filter/Sort Export All Refresh Displays the SQL Preview dialog to view generated SQL. Reverts values back to pre-edit states. Displays the Data Filter dialog to specify filter and sort data rules. Displays the Export Data Wizard which exports all data. Refreshes table data list from data in the database. About Editing Large Data and Objects The Table Data Editor provides editing capabilities for large data and large object storage in a database. You can edit: Binary Large Object (BLOB) - Contains raw binary data stored as a single object. BLOBs are used to store images, video clips, and word documents. See Editing Binary Large Object Data. Character Large Object (CLOB) - Contains only plain text, same as VARCHAR data type, and is used to store simple text, HTML, or XML documents. CLOBs are considered a subset of BLOBs since character data is a sequence of bytes and can be stored in BINARY fields as well as CHAR fields. See Editing Character Large Object Data. Large Binary Data - Contains raw binary data stored as VARBYTE data type. See Editing Large Binary Data. Large Text Data - Contains character data stored as VARCHAR data type. See Editing Large Text Data. XML Data Type - Contains data in the Extensible Markup Language (XML) format. See Editing XML Data. About Paging Large Tables The toolbar in the Table Data Editor contains several features that enable you to specify how many rows are included in a page, and to move forward and backward through pages to locate data. Use the Page Size field to specify the number of data rows you want included in a page. To review data in a table, use the page arrow keys to move to the beginning or end of the table, or incrementally forward or backward one page at a time. Data Filter The Data Filter dialog enables you to define data filters for the Table Data Editor. Use filtering to reduce the number of rows loaded into the Table Data Editor and to display only data of interest. You can determine which data displays by: Sorting column order Teradata Studio Express User Guide, Release

94 5: Table Data Development Filtering on data values within columns Filter Tab Move column names from the Table Column list to the Sort Column list to indicate on which columns to sort to display data in the Table Data grid. Column Names Types Select By Lists names of columns in table. Lists data type for each column in Column Names. Select a filter operator from the list and type a valid value or character string. For example, if values in Column1 are type INTEGER, and you filter to display only rows greater than (>) 5999, the Table Data grid refreshes to show all rows with the value 6000 or above. Sort Tab Use fields and radio buttons in this section to indicate how you want columns sorted. Table Columns Ascending Descending Sort Columns Up Down Lists all columns by name in the table. Orders the Table Columns list from the smallest or lowest to the largest or higher value. For example, A to Z or 1 to 100. Orders the Table Columns list from the largest or higher value to the smallest or lowest value. For example, Z to A or 100 to 1. Lists one or more columns in the order on which to sort. Select a column in the Sort Columns list and click Up to move it up in the list order. Select a column in the Sort Columns list and click Up to move it up in the list order. Actions Use the action buttons at the bottom of the dialog to clear or save your settings. Clear All OK Click to revert all selections in the Select By column to the default None. Click to save your Filter and Sort settings. Teradata Studio Express User Guide, Release

95 5: Table Data Development Opening the Table Data Editor The Table Data Editor gives you the ability to manage data stored in Teradata databases. Begin by using the Data Source Explorer view to find the table object you want to review or modify. 1. Open the Data Source Explorer view (Window > Show View > Data Source Explorer). 2. Navigate to the table you want to review or modify. 3. Right-click the table object and select Data > Edit Data. The Table Data Editor opens in the right pane and displays the data in the table you selected. You can also open the Table Data Editor from the Data Lab view. 1. Open the Data Lab view (Window > Show View > Data Lab View). 2. Navigate to the table you want to review or modify. 3. Right-click the table object and select Edit Data. Table Data Editor Preferences Set preferences to determine how the Table Data Editor displays. You can set these features: Show or hide numbered row column header Background color for alternate table rows Highlighted row color for inserted, updated, and deleted data Thresholds for filter and transaction rows Color s To control color, choose from these options: Display alternate Result Set rows in color Insert Selection Color Update Selection Color Delete Selection Color Select the check box to enable an alternate row background color, and then select the color. Click the color box to see color options. Click the color box to select the background color for inserted data. Click the color box to select the background color for updated data. Click the color box to select the background color for deleted data. Editor s To set edit preferences, choose from these options: Show Row Numbers Select the check box to show numbered rows in the first column of the data grid. Teradata Studio Express User Guide, Release

96 5: Table Data Development Display Filter Dialog Threshold (rows) Transaction Commit Size (rows) Enter the number of table rows above which the Table Data Editor presents the Data Filter dialog. Be sure to specify filters in the Table Data Editor to reduce the number of data rows that display. The default is Enter the number of data rows to batch in a single COMMIT transaction. This number is the threshold at which the batch UPDATE operation occurs. For example, if you set the threshold at 1000, the operation batches 1000 data row updates in a single COMMIT transaction. The default is 500. Copy and Paste s To set copy and paste preferences, choose from these options: Copy Column Names when Copying Rows Column Delimiter Select the check box to include column header labels when copying data to a file. Select from the list the type of delimiter to use to separate data when copying or pasting from the editor to a file, such as Microsoft EXCEL or Notepad. Supported delimiters are: Tab (default), Comma, Semicolon, and Space. Actions Apply, restore, or save your settings by choosing from these options: Apply Restore Defaults OK Click to apply your changes. You can preview results in the Table Data Editor. Click to return to default values. Click to save your preference settings. Setting Table Data Editor Preferences You can set preferences that determine the appearance and functional behavior of the Table Data Editor. You can accept the defaults or select new settings. 1. Select Window > Preferences in the main menu. 2. Expand Teradata Datatools Preferences and select Table Data Editor Preferences. 3. Make any desired changes to the Table Data Editor Preferences. 4. Click Apply to apply your changes. You can preview results in the Table Data Editor before you click OK. 5. After previewing, if you want to return to default values, click Restore Defaults. Teradata Studio Express User Guide, Release

97 5: Table Data Development 6. Click OK to save your preference settings. Table Data Editing About Editing Table Data The Table Data Editor enables you to edit data stored in tables in a Teradata or Aster database. The editor supports very large tables and provides several additional editors for large data objects such as Character Large Objects (CLOBs) and Binary Large Objects (BLOBs). It also supports an XML Data Type Editor for editing XML data. Rows of data can be grouped into pages that allow you to quickly locate table rows. Advanced filter and sort functions in the Data Filter help you to easily find data of interest. You can edit table data either directly in the Table Data Editor or you can export data to a Microsoft Excel spreadsheet or text file to change the data and then import it back into the table using the Load Data Wizard. Use the toolbar functions at the top of the editor to export data. Editing data in the Table Data Editor is as simple as editing data in a spreadsheet editor. Insertion and deletion functions are similar, as well as keyboard and cursor actions. Editing Table Data The Table Data Editor enables you to update data in a database table by: Inserting table data. Deleting table data. Reverting table data. In addition, it also provides several editors for large data tables. Editors include: CLOB Editor BLOB Editor Large Binary Editor Large Text Editor XML Data Type Editor Inserting Table Data You can insert rows in a table. 1. Right-click on a row or in the Table Data grid. 2. Select Insert. 3. Enter data in the new row at the bottom of the table. 4. Click in the toolbar to save your changes. Teradata Studio Express User Guide, Release

98 5: Table Data Development You can undo an insertion by clicking in the toolbar. or right-clicking the row or in the Table Grid and selecting Revert. If you want to revert more than one row at the same time, select multiple rows and click Revert. Displaying Column Data by Value You can specify to show values by columns. 1. Right-click in the column header of the column in which you want to show specific values. 2. Select Show Values. 3. In the Show Values dialog, select from one of the two steps below as the options are different based on the data type of values in the selected column. 4. To show values for DECIMAL, FLOAT, INTEGER, SMALLINT, BYTEINT, BIGINT, TIME, TIMESTAMP, or DATE data types, select from these options: Show Values Equal with Show Values Greater than Show Values Less than Type a numeric value to match against column data values that are equal to the value you enter. Type a numeric value to match against column data values that are greater than the value you enter. Type a numeric value to match against column data values that are less than the value you enter. 5. To show values for the VARCHAR data type, select from these options: Show Values that Start with Show Values that End with Show Value that Contains Type a value to match against the initial characters of a data value in the selected column. The field supports alpha-numeric characters. Do not use special characters or wildcards. Type a value to match against the end characters of a data value in the selected column. The field supports alpha-numeric characters. Do not use special characters or wildcards. Type the value you want to match against characters contained in data values in the selected column. The field supports alpha-numeric characters. Do not use special characters or wildcards. 6. Click OK. Deleting Table Rows You can delete entire rows of data in a table. For information about deleting data in cells, see Deleting Data from Cells. 1. Select a table row. The row background color changes when you select it. 2. Right-click and select Delete. The row is marked for deletion from the table. Teradata Studio Express User Guide, Release

99 5: Table Data Development 3. Click in the toolbar to save your changes. You can undo a deletion by clicking Revert. in the toolbar or right-clicking the row and selecting Deleting Data from Cells You can right-click a table cell to display the Delete option. The Delete function deletes only data in a cell, and does not delete the selected table cell. 1. Select a table cell. The cell background color changes when you select it. 2. Right-click and select Delete. 3. Click in the toolbar to save your changes. Reverting Edits You can reset data to pre-edited values by clicking the Revert icon ( ) in the toolbar. When you revert data, all unsaved changes are discarded, and any edited data is reset to its last saved value. 1. Click the Revert icon ( ) in the toolbar. 2. Confirm that you want to revert the contents of your data sheet by clicking OK. The Table Data Editor refreshes and shows the data reset to pre-edited values. Finding and Replacing Data You can find specific data values in a table column and replace it with a different value. You cannot replace values across columns in a table. 1. Right-click in the column header of the column that contains the data you want to find and replace. 2. Select Find/Replace. 3. In Find, type the value you want to find. 4. In Replace With, type the value you want to replace the found value with. 5. [al] Under s, select these check boxes: Case Sensitive Wrap Search Select to find only case-exact matches. Select this option if you want the search to return to the top of the column after it reaches the bottom. If you do not select this option and begin your search in the middle of a column, the search only does an incremental Find for half of the column and stops. 6. Click to select an action: Find Click to perform an incremental find of the value you entered in Find above. Teradata Studio Express User Guide, Release

100 5: Table Data Development Replace Replace All Click to replace an incremental Find value with the value you entered in Replace above. Click to replace all Find values at the same time. 7. Click Close to return to the Table Data Editor. Find Replace The Find Replace dialog lets you find specific data values in a table column and replace them with a different value. You cannot replace values across columns in a table. You can: Search for specific data values in tables. Replace target values with new values. Replace all values at the same time or incrementally one by one. Find/Replace Values You specify a data value to find and which value you want to replace it by completing these fields: Find Replace Type the data value you want to find. The data type must be consistent with the data type of the selected column. To perform only a Find operation, click Find at the bottom of the dialog. The Find operation looks for the value in the data column in which you opened the Find/Replace dialog. Type a data value to replace the value in Find. The data type must be consistent with the column data type. To perform the Find/Replace operation, click Replace at the bottom of the dialog. Find/Replace Criteria As an option, you can specify additional criteria for a Find/Replace operation by selecting the following check boxes: Case Sensitive Wrap Search Select to find only case-exact matches. Select this option if you want the search to return to the top of the column after it reaches the bottom. If you do not select this option and begin your search in the middle of a column, the search only does an incremental Find for half of the column and stops. Teradata Studio Express User Guide, Release

101 5: Table Data Development Actions Select an action from these options to perform Find and Replace operations. Find Replace Replace All Close Click to perform an incremental find of the value you entered in Find above. Click to replace an incremental Find value with the value you entered in Replace above. Click to replace all Find values at the same time. Click to return to the Table Data Editor. Selecting to Filter by Edits After you modify data in a table, you can select to view only the edited data rows. Filters are available for updated, deleted, or inserted data. This feature is useful if you've made multiple changes in a large table and want to review your changes before updating them in the database. It can also be used to group changes for export to a file, either as a record or for later review. 1. With an edited table open in the Table Data grid, click the Filter by Edits icon in the toolbar. The Show Edits dialog opens. 2. Select which type of edit to display by checking one or more of these options: a. Select the Inserts check box to display any rows with newly inserted data in the table. b. Select the Updates check box to display rows in which data has been added, edited, revised, or deleted. c. Select the Deletes check box to display rows removed from the table. 3. Click OK. The Table Data Editor refreshes to show only table rows that match the filter options you selected. Viewing SQL Preview for Data Updates After you make an edit, you can preview the generated SQL DDL statements. The SQL DDL statement includes updates and other changes that are submitted to the database when you save your changes. 1. Make one or more edits in the Table Data Editor. 2. Click the SQL Preview icon in the toolbar. 3. Review the generated SQL in the SQL Preview text box. 4. If you find an incorrect data update, return to the Table Data Editor and make further edits to correct it. 5. Click Close to return to the Table Data Editor view. Teradata Studio Express User Guide, Release

102 5: Table Data Development Large Data and Objects Editing About the Blob Editor You can use the Table Data Editor to review and edit database tables that contain Binary Large Objects (BLOBs). A BLOB is a collection of binary data stored as a single entity in a Database Management System (DBMS). BLOBs are typically images, audio, or other multimedia objects, though sometimes binary executable code is stored as a BLOB. You must edit BLOBs in the Blob Editor. Source of Imported Data If the data in the object is imported, the source file for that data displays in the File field. Actions on Object You can import, export, or clear the binary data in BLOBs. These functions are selected by clicking the action buttons to the left of the editor workarea. Editor Workarea The editor workarea displays the current data for the object you selected to edit. You can insert, delete, and modify data displayed in this area. You can also import from or export to files such as a text file. To remove all data displayed in the editor workarea, click Clear. Note: You can view, import, and export data larger than 64k, but you cannot edit the data. Imported data that is larger than 64k is identified by its filename in the editor. Slidebars The data in an object is often more than can be displayed within the editing area. Use the slidebars on each side of the workarea to scroll through data. Blob Editor The BLOB Editor displays the binary data contained in the selected Binary Large Object (BLOB) stored in a database. You can edit the data in the BLOB by: Inserting binary data Deleting binary data Clearing the binary data in the object Importing binary data from a file Exporting the binary data in the object A BLOB data object can be represented in one of three ways: BLOB handle - Handle to the BLOB data in the database. Snippet of data - Text snippet you edit or insert in cell. Filename - For data objects over 64k, name of file that contains the data. You can edit or insert data in this file. BLOB data larger than 64k cannot be edited in the Blob Editor. Teradata Studio Express User Guide, Release

103 5: Table Data Development Edit Blob Value Use the Blob Editor to modify the binary data in the Binary Large Object (BLOB) that you selected from a BLOB table. File Editor Workarea If data is imported, shows the name of the import source file. Displays the binary data in the selected object. Actions Use the action buttons to the right of the editor to import, export, or clear binary data. Import Export Clear OK Click to import binary data from a file. Click to export the binary data displayed in the editor to a file, such as a binary data file. Click to remove all data displayed in the editor workarea. Click to save the data to the object. Opening the Blob Editor You open the Blob Editor from the Table Data Editor by selecting the row that contains the Binary Large Object (BLOB) in the table. A BLOB data object can be represented in one of three ways: BLOB handle - Handle to the BLOB data in the database. Snippet of data - Text snippet you edit or insert in cell. Filename - For data objects over 64k, name of file that contains the data. You can edit or insert data in this file. BLOB data larger than 64k cannot be edited in the Blob Editor. To open the Blob Editor: 1. Select a table that contains a BLOB object and open it in the Table Data Editor. See Opening the Table Data Editor. The table name displays in the tab at the top of the editor. You can open several tables in the editor and move between them by clicking these tabs. 2. Select the BLOB to edit from the Binary Large Objects column. Single objects are separated in rows. 3. Click the ellipses ( ) at the right end of the row to open the Blob Editor. See About the Blob Editor. Teradata Studio Express User Guide, Release

104 5: Table Data Development Editing BLOB Data You can edit a Binary Large Object (BLOB) by inserting, deleting, and changing the binary data contained in the object. 1. Select a BLOB table in your database. 2. Right-click the table and select Teradata > Edit Data. 3. The table objects display in the Binary Large Object column in the Table Data Editor. 4. Locate the BLOB you want to edit and select it. The table row highlights, and an ellipses ( ) displays at the right end of the row. 5. Click the ellipses ( ) to open the Blob Editor. 6. Review and edit the data in the object. 7. Click OK to save your changes to the object. Also you can export the data to a binary data file to review and edit the data, and then import that data back to the Blob Editor. About the Clob Editor You can use the Table Data Editor to review and edit database tables that contain Character Large Objects (CLOBs). A CLOB is a collection of character data stored as a single entity in a Database Management System (DBMS). Teradata Studio Express User Guide, Release

105 5: Table Data Development Source of Imported Data If the data in the object is imported, the source file for that data displays in the File field. Actions on Object You can import, export, or clear the binary data in CLOBs. These functions are selected by clicking the action buttons to the left of the Edit workarea. Editor Workarea The editor workarea displays the current data in the selected object for edit. You can insert, delete, and modify data displayed in this area. You can import from or export to files, such as a Microsoft Word file or text file. You can also remove all data by clicking Clear. Note: CLOB data larger than 64k can be viewed, exported, and imported, but not edited in the Clob Editor. To edit files larger than 64k, export to a text editor. Slidebars The data in an object is often more than can be displayed within the editing area. Use the slidebars on each side of the Edit workarea to scroll through data. Encoding Standard The Encoding fields shows the encoding standard used for the data in the editor workarea. Use the drop-down menu to select a different standard. Teradata Studio Express User Guide, Release

106 5: Table Data Development Clob Editor The Clob Editor displays the character data contained in the selected Character Large Object (CLOB) stored in a database. You can edit the data in the CLOB by: Inserting character data Deleting character data Clearing the character data in the object Importing character data from a file Exporting the character data in the object A CLOB data object can be represented in one of three ways: CLOB handle - Handle to the CLOB data in the database. Snippet of data - Text snippet you edit or insert in cell. Filename - For data objects over 64k, name of file that contains the data. You can edit or insert data in this file. CLOB data larger than 64k cannot be edited in the Clob Editor. Edit Clob Value Use the Clob Editor to modify the character data in the Character Large Object (CLOB) that you selected from a CLOB table. File Editor Workarea If data is imported, shows the name of the import source file. Displays the character data in the selected object. Actions Use the action buttons to the right of the editor to import, export, or clear character data. Import Export Clear OK Click to import character data from a file. Click to export the character data displayed in the editor to a file, such as a Microsoft Word or text file. Click to remove all data displayed in the editor workarea. Click to save the data to the object. Teradata Studio Express User Guide, Release

107 5: Table Data Development Opening the Clob Editor You open the Clob Editor from the Table Data Editor by selecting the row that contains the Character Large Object (CLOB) in the table. A CLOB data object can be represented in one of three ways: CLOB handle - Handle to the CLOB data in the database. Snippet of data - Text snippet you edit or insert in cell. Filename - For data objects over 64k, name of file that contains the data. You can edit or insert data in this file. CLOB data larger than 64k cannot be edited in the Clob Editor. To open the Clob Editor 1. Open a table that contains a CLOB object to edit in the Table Data Editor. The table name displays in the tab at the top of the editor. You can open several tables in the editor and move between them by clicking these tabs. See Opening the Table Data Editor for more information. 2. Select the CLOB to edit from the Character Large Objects column. Single objects are separated by rows. 3. Click the ellipses ( ) at the right end of the row to open the Clob Editor. See About the Clob Editor. Editing CLOB Data You can edit a Character Large Object (CLOB) by inserting, deleting, and changing the character data contained in the object. 1. Select a CLOB table in your database. 2. Right-click the table and select Teradata > Edit Data. 3. The table objects display in the Character Large Object column in the Table Data Editor. 4. Locate the CLOB you want to edit and select it. The table row highlights, and an ellipses ( ) displays at the right end of the row. 5. Click the ellipses ( ) to open the Clob Editor. 6. Review and edit the data in the object. 7. Click OK to save your changes to the object. Teradata Studio Express User Guide, Release

108 5: Table Data Development Also you can export the data to a Microsoft Word or text file to review and edit the data, and then import that data back to the Clob Editor. About the Large Binary Editor You open the Large Binary Editor from the Table Data Editor by selecting the row that contains large binary data in a table. The Large Binary Editor provides a large workarea where you can review and modify data, and export and import data. Actions on Object You can import, export, or clear the binary data in the editor. These functions are selected by clicking the action buttons to the left of the editor workarea. Editor Workarea The editor workarea displays the data you selected for edit. You can insert, delete, and modify data displayed in this area. You can import from or export to files, such as a Microsoft Excel file. You can also remove all data by clicking Clear. Slidebars Large binary data is frequently too large to display without scrolling the editing area. Use the slidebars on each side of the editor workarea to scroll right-left or up-down through data. Opening the Large Binary Editor You open the Large Binary Editor from the Table Data Editor by selecting the row that contains large binary data. Teradata Studio Express User Guide, Release

109 5: Table Data Development 1. Open a table that contains rows of large binary data to edit in the Table Data Editor. The tab shows the name of the large binary data table you opened in the Table Data Editor. You can open several tables in the editor and move between them by clicking these tabs. See Opening the Table Data Editor for more information. 2. Select a row to edit from the VARBYTE column by clicking the row. Data is stored as single objects in separate rows. 3. Click the ellipses ( ) at the right end of the row to open the Large Binary Editor. See About the Large Binary Editor. Large Binary Editor The Large Binary Editor displays the binary data you selected from a table you are editing in Table Data Editor. You can edit the data by: Inserting binary data Deleting binary data Clearing the binary data in the editor Importing binary data from a file Exporting the binary data to a file Edit Binary Data Use the Large Binary Editor to modify the binary data in a table. The editor provides a large workarea that displays the binary data you selected from the table. Edit your binary data in this workarea. Teradata Studio Express User Guide, Release

110 5: Table Data Development Actions Use the action buttons to the right of the editor to import, export, or clear binary data. Import Export Clear OK Click to import binary data from a file. Click to export the binary data displayed in the editor to a file, such as a text file. Click to remove all data displayed in the editor workarea. Click to save the data. Editing Large Binary Data You can use the Table Data Editor to display and edit tables that contain large binary data. A large binary data table contains raw binary data stored as VARBYTE data type. 1. Select a table that contains large rows of raw binary data (VARBYTE) in your database. 2. Right-click the table and select Teradata > Edit Data. 3. The table data displays in the VARBYTE column in the Table Data Editor. 4. Locate the row you want to edit and select it. The table row highlights, and an ellipses ( ) displays at the right end of the row. 5. Click the ellipses ( ) to open the Large Text Editor. 6. Review and edit the data displayed in the editor. You can edit directly in the editor or you can export the data to a Microsoft Excel or text file to review and edit the data, and then import that data back to the Large Text Editor. 7. Click OK to save your changes to the object. About the Large Text Editor You can use the Table Data Editor to display and edit tables that contain character data. A large text data table contains large amounts of character data stored as VARCHAR data type and must be edited in the Large Text Editor. Teradata Studio Express User Guide, Release

111 5: Table Data Development Actions on All Data in Editor You can import, export, or clear the data displayed. These functions are selected by clicking the action buttons to the left of the editor workarea. Editor Workarea The editor workarea displays the large text data you selected to edit. You can insert, delete, and modify data displayed in this area. You can import from or export to files, such as a Microsoft Word file. You can also remove all data by clicking Clear. Slidebars The data in an object is often more than can be displayed within the editing area. Use the slidebars on each side of the Edit workarea to scroll through data. Encoding Standard The Encoding fields shows you the encoding standard used for the the data in the editor workarea. Use the drop-down menu to select a different standard. Large Text Editor The Large Text Editor enables you to edit VARCHAR or CHAR data stored in a large text data table. You can edit the data by: Inserting character data Teradata Studio Express User Guide, Release

112 5: Table Data Development Deleting character data Clearing the character data in the editor Importing character data from a file Exporting the character data to a file Edit Text Value Use the Large Text Editor to modify the character data in a table. The data you select displays in the workarea in the center of the editor. You can also export the data to a file where you can review and edit the data, then import it back into the editor. Actions Use the action buttons to the right of the editor to import, export, or clear character data. Import Export Clear OK Click to import character data from a file. Click to export the character data displayed in the editor to a file, such as a Microsoft Word or text file. Click to remove all data displayed in the editor workarea. Click to save the data to the object. Opening the Large Text Editor You open the Large Text Editor from the Table Data Editor by selecting the row that contains large text (VARCHAR) data. 1. Select a table that contains rows of large text data and open it in the Table Data Editor. See Opening the Table Data Editor. The name of the large text data table displays in the tab at the top of the Table Data Editor. You can open several tables in the editor and move between them by clicking these tabs. 2. Locate the data you want to edit in the VARCHAR column and click the row that contains the data. Data is stored as single objects in separate rows. 3. Click the ellipses ( ) at the right end of the row to open the Large Text Editor. See About the Large Text Editor. The data you selected displays in the Large Text Editor. Teradata Studio Express User Guide, Release

113 5: Table Data Development Editing Large Text Data You can use the Table Data Editor to display and edit tables that contain character data. A large text data table contains large amounts of character data stored as VARCHAR data type. The Table Data Editor provides a special Large Text Editor for this type of data. 1. Select a table that contains large rows of character data (VARCHAR) in your database. Data is stored as single objects in separate rows. 2. Right-click the table and select Teradata > Edit Data. You can open several tables in the editor in this way and move between them by clicking the tabs at the top of the editor. 3. The large text data displays in the VARCHAR column in the Table Data Editor. 4. Locate the row you want to edit and select it. The table row highlights, and an ellipses ( ) displays at the right end of the row. 5. Click the ellipses ( ) to open the Large Text Editor. 6. Review and edit the data displayed in the editor. You can edit directly in the editor or you can export the VARCHAR or CHAR data to a Microsoft Word or text file to review and edit the data, and then import that data back to the Large Text Editor. 7. Click OK to save your changes to the object. About the XML Data Type Editor You can use the Table Data Editor to access Extensible Markup Language (XML) data type objects stored in the connected database. To edit the data, you must edit the XML data type object in the XML Editor. Teradata Studio Express User Guide, Release

114 5: Table Data Development Source of Imported Data If the data in the object is imported, the source file for that data displays in the File field. Actions on Object You can import, export, or clear the data in XML data type objects. These functions are selected by clicking the action buttons to the left of the Edit workarea. Editor Workarea The editor workarea displays the current data in the selected object for edit. You can insert, delete, and modify data displayed in this area. You can import from or export to files, such as a text file. You can also remove all data by clicking Clear. Slidebars The data in an object is often more than can be displayed within the editing area. Use the slidebars on each side of the workarea to scroll through data. Encoding Standard The Encoding field shows the encoding standard used for the data in the editor workarea. Use the drop-down menu to select a different standard. Teradata Studio Express User Guide, Release

115 5: Table Data Development XML Editor The XML Editor displays the Extensible Markup Language (XML) data contained in the selected XML data type object stored in a database. An XML data type object is represented by the handle to the XML data stored in the database. You can edit the data in the XML object by: Inserting XML data Clearing the XML data in the object Importing XML data from a file Exporting the XML data in the object to a file Edit XML Use the XML Editor to review and modify data in an XML data type object. that you selected using the Table Data Editor. File Editor Workarea If data is imported, shows the name of the import source file. Displays the data in the selected XML data type object. Actions Use the action buttons to the right of the editor to import, export, or clear XML data. Import Export Clear OK Click to import XML data from a file. Click to export the XML data displayed in the editor to a file, such as a text file. Click to remove all data displayed in the editor workarea. Click to save your data changes to the object. Opening the XML Editor You open the XML Editor from the Table Data Editor by selecting an XML data type object stored in a database table. An XML data type object is represented by the handle to the XML data in the database. 1. In the Table Data Editor, open a table that contains the XML data type object you want to edit. Teradata Studio Express User Guide, Release

116 5: Table Data Development The table name displays in the tab at the top of the editor. You can open several tables in the editor and move between them by clicking these tabs. See Opening the Table Data Editor for more information. 2. Select the XML data type object to edit from the XML column. Single objects are separated by rows. 3. Click the ellipses ( ) at the right end of the row to open the XML Editor. See About the XML Editor. Editing XML Data You can use the Table Data Editor to display and edit database tables that contain XML data types. The Table Data Editor provides a special XML Editor for this type of data. 1. Select a table in your database that contains the XML data type. XML data type objects are stored as single objects in separate rows within the table. 2. Right-click the table and select Teradata > Edit Data. You can open several tables in the editor in this way and move between them by clicking the tabs at the top of the editor. 3. Review the table. Any XML data displays in the XML column of the table and is visible in the Table Data Editor. 4. Locate the object you want to edit and select the row for that object. An XML data type object is represented by the handle to the stored XML data. When you select the object, the row highlights, and an ellipses ( ) displays at the right end of the row. 5. Click the ellipses ( ) to open the XML Editor. 6. Review and edit the data displayed in the editor. You can edit directly in the editor or you can export the XML data to a text file to review and edit the data, and then import that data back to the XML Editor. 7. In Encoding, select the encoding standard to use from the list. 8. Click OK to save your changes. Teradata Studio Express User Guide, Release

117 5: Table Data Development Table Data Filtering About Filtering Table Data The Table Data Editor provides several ways to filter table data. You can filter data: To view only data of interest in columns. See Displaying Column Data by Value. To view only rows in which you have inserted, updated, or deleted data. See Selecting to Filter by Edits. To view data of interest using Data Filter rules. See Filtering with Data Filter. About the Data Filter The Data Filter dialog enables you to set filter rules to define which data is loaded and displayed in the Table Data Editor. Each time you use this dialog, the data is reloaded into the editor based on the rules you specify. To access the Data Filter dialog, click the Filter icon in the Table Data Editor toolbar. The dialog consists of two tabs described below. Filter Tab The Filter tab lists all columns in the table and enables you to set filter rules for each column. It is comprised of the following elements: Teradata Studio Express User Guide, Release

118 5: Table Data Development List of Columns in Table The Filter list displays all table columns. Select filter options in Select By to view in the Table Data Editor only data in which you are interested. Data Type of Column The Types list shows the column data type. Selection of Filter Rule In Select By, create a filter rule to apply to the column. Use the list to select a filter operator and enter a value. For example, you could specify a rule that filters column data for only values greater than Filter operators are based on column data type. Filter Rules by Column The Data Filter dialog provides the ability to define specific filter rules for each column in the selected table. Use this area to define, review, and refine your Table Data Editor view for specific tables. The default is None. Clear All Button Click Clear All to reset filter rules for all columns to None. Sort Tab Use the Sort tab to specify column row order for the Sort operation. For example, if you move Column3 to the Sort Columns list and position it as the first column in the list, the Sort operation Teradata Studio Express User Guide, Release

119 5: Table Data Development sorts all column rows based on the row order in Column3. The tab consists of the following elements: List of All Columns in Table A list of all table columns displays in the Table Columns selection box. You can order the list in either ascending or descending order by table name. Ordered List of Columns for Sort Move columns from Table Columns to Sort Columns to specify the column sort order. Use Up and Down to change column order. Choice Buttons: Order Table Column List Choose how you want the column list ordered: Ascending - Orders the Table Columns list from the smallest or lowest to the largest or higher value. For example, A to Z or 1 to 100. This is the default. Descending - Orders the Table Columns list from the largest or higher value to the smallest or lowest value. For example, Z to A or 100 to 1. Teradata Studio Express User Guide, Release

120 5: Table Data Development Action Buttons: Order Columns for Sorting Move columns up or down in the list. The sort operation uses the column order to determine sorting rules. The primary sort is based on the first column in the list. Exporting Table Data You can export data to a file, such as a Microsoft Excel spreadsheet or a text file. The Table Data Editor uses the Export Data Wizard to export data from tables. You can select data to export all data in the table or only data in specific rows to export. Exporting All Data The Export All feature exports all data in the table. 1. In the toolbar, click Export All. 2. Follow steps for Export Data Wizard below. Exporting Data in Rows The Export feature exports only data in the table rows you select. 1. Select the data rows you want to export. You can select multiple rows using the Ctrl key. 2. Right-click and select Select Rows for Export. The rows are marked for export. 3. Right-click and select Export Selected Rows. 4. Follow steps for the Export Data Wizard below. Exporting with Teradata Export Wizard 1. The Export Data dialog opens. Follow these steps for both Export All and Export tasks. 2. In Output File, type the path name of the file to which you want the data exported. You can also click Browse to locate and save the file. 3. In File Type, select from the list the type of the output file in the previous step. For example, you can select a delimited text file, Excel, or Excel ( ) file. 4. Select Column Labels in First Row to specify that you want column labels to be output in the first row of the file. 5. Under File s, if you selected a delimited text file as the output, complete the following: a. In Column Delimiter, select the column delimiter to be used in the output file to separate columns. b. In Character String Delimiter, select the character string delimiter to be used in the output file to indicate character strings. 6. In File Encoding, select the encoding standard to use. 7. Click Finish to export the data. Teradata Studio Express User Guide, Release

121 6 Data Import and Export Importing Data Into a Volatile Table Prerequisite: Volatile tables must be created manually, by executing CREATE VOLATILE TABLE statements from the SQL Editor. Volatile tables exist only during the session in which they are created. When a database session ends, Teradata Database automatically drops all volatile tables that were created during the session. After you have created a volatile table, use the Load Data wizard to import external data into the table. 1. In the SQL Editor view, click. The Load Data to Volatile Table dialog opens. 2. From the Volatile Table list, select the volatile table to which you want to import data, and click OK. Importing data to volatile tables is the purview of the Data Transfer perspective. The Switch Perspective dialog box may appear and offer to switch you to that perspective during this process. Switching perspectives is optional. The Data Transfer perspective shows the progress of the data import in the Progress Monitor view, and includes the Transfer History view, which may be helpful. After switching perspectives or dismissing the Switch Perspective dialog, the Data Transfer Wizard opens. 3. In the Data Transfer Wizard, for Source Type chose External File (FastLoad), and click Launch. The Load Data Wizard opens. 4. For File Type specify the format of the file that has the external data. 5. For Input File, enter the name of the file, or click Browse to navigate to the file on your system or network. A sample of the data in the input file is displayed in a table form preview, based on the File s. If the sample data is not displayed correctly, change the File s to correctly represent the input file format. 6. Click Finish. The external data is imported to the volatile table. Teradata Studio Express User Guide, Release

122 6: Data Import and Export Import and Load External Data (Teradata, Aster) About the Load Data Wizard (Teradata, Aster) Once you have selected the table to receive the data in the Data Source Explorer, you can specify the type of data import you want performed. Note: You must select External File (FastLoad) as the Source Type to launch the Load Data Wizard. After the Load Data Wizard opens, specify the name, path, and external file type of the source file. Be sure to specify data delimiters and encoding used in the source file. Use the drop-down lists to select the correct information. Teradata Studio Express User Guide, Release

123 6: Data Import and Export Teradata Studio Express User Guide, Release

124 6: Data Import and Export Load Data Wizard (Teradata, Aster) The Load Data Wizard enables you to load data from an input file into a table using either JDBC FastLoad or batch operations. The input file can be a delimited text file or an Excel file. If the table is not empty, the Load Data Wizard appends or replaces the existing data. Note: JDBC FastLoad operations are not applicable to Aster data transfers. The Load Data Wizard contains the following elements: Input File File Type Column Labels in First Row Stop Loading If Max Error(s) Occur Lock Table Replace Existing Data Include Null Row Use System Locale Specify the path and name of the file from which to import data and to specify the server path to its location in the file system. To locate an existing file, click Browse and navigate the file system to select a file. Select the type of file to be imported. You can choose to load data from a text file, such as a.txt or.cvs file, or from a Microsoft Excel file. Choose between a.xslx file, or.xls (Microsoft Excel ) file. The file data options change depending on which type of source file you selected. Select to specify that the first row in the file contains the column labels so that the first row in the file is ignored. Specify the maximum number of errors allowed before the wizard stops the Load operation. Select to prevent row lock errors. Note: Selecting this option may cause the import operation to be slow. If the table is not empty, check this option to replace the existing data. Leaving it cleared appends the loaded data to the existing data. If the table is empty, this option is grayed out. Select to include null rows in the table. Select to use the formatting for date, timestamp, digit grouping symbol, and decimal symbol based on the country and language setting for your operating system. A preview of the formatting is displayed. When system locale is not selected, Teradata Studio accepts the following formats: Numbers: Comma as digit grouping symbol. For example, 1,234,567. Dot as decimal symbol. For example, 1, Dates: "yyyy-mm-dd", "yyyy/mm/dd", "MM-dd-yy", "MM/dd/yy", "MM-ddyyyy", "MM/dd/yyyy" Timestamps: "MM/dd/yy hh:mm:ss.s","mm/dd/yyyy hh:mm:ss.s", "MM-dd-yy hh:mm:ss.s", "MM-dd-yyyy hh:mm:ss.s", "yyyy/mm/dd HH:mm:ss.S", "yyyy- MM-dd hh:mm:ss.s", "MM/dd/yy hh:mm:ss","mm/dd/yyyy hh:mm:ss", "MM-ddyy hh:mm:ss", "MM-dd-yyyy hh:mm:ss", "yyyy/mm/dd HH:mm:ss", "yyyy-mmdd hh:mm:ss" Teradata Studio Express User Guide, Release

125 6: Data Import and Export The File s change depending on the file type you select, and the destination. For example, the Delimited Text options are: Column Delimiter Character String Delimiter Line Separator File Encoding Start Loading at Row Number Specify the column delimiter used in the input file. This does not apply to Hadoop. Specify the character string delimiter used in the input file. This does not apply to Hadoop. Specify the type of column delimiters, character string delimiters, and character encoding the data in the imported file uses. If you specified an EXCEL spreadsheet as the input file and selected either EXCEL (.xlsx) or EXCEL (.xls) as the file type, you can import data from a single worksheet in the file by selecting a worksheet name in Import Worksheet. The Line Separator options enable you to import files that have only LineFeed (LF), as in Unix and Linux, or only Carriage Return (CR) as in Mac OS/X prior to v10.0, or both, as for Windows. The options are: Windows OS (CR and LF) Prior to Mac OS X v10.0 (CR) Unix, Linux, Mac OS X v10.0 and above (LF) Specify the type of encoding to used for the file. Specify the table row number where the Load operation begins. The Excel options are: Import Worksheet Start Loading at Row Number Import Worksheet - View a list of worksheets found in the specified Excel file. Specify which worksheet you want to import. Specify the table row number where the Load operation begins. A preview table at the bottom of the screen displays a sample of the data in the input file, based on the File s. The table data includes column name, column data type, and values in table rows. If the sample data is not displayed correctly, change the File s to correctly represent the input file format. When you click Finish, the results display in the Teradata SQL History view. Click the Message tab to view detailed messages. Loading Table Data from a File (Teradata, Aster) 1. Open the Data Transfer perspective. 2. Select a Teradata or Aster table in the Data Source Explorer as the destination table. 3. Right-click the table and select Data > Load Data. 4. In the Data Transfer Wizard, select External File as the Source Type. Teradata Studio Express User Guide, Release

126 6: Data Import and Export 5. Click Launch. The Load Data Wizard opens. 6. At Input File, type the directory path and name of the file that contains the data you want to import. To find a file in your file system, click Browse, select the file, and click Open. 7. In File Type, select one of the following options: Delimited Text Excel (.xlsx) Excel (.xls) Text file that uses delimiters to separate data; such as, commas or semicolons in a TXT or CSV file. Microsoft Excel file with.xlsx file extension. This is not available for Hadoop. Microsoft Excel file with.xls file extension. This is not available for Hadoop. 8. [al] Select Column Labels in First Row to use the first row of data as the column labels for the new table. 9. Select Stop Loading If Max Error(s) Occur and specify the maximum number of errors allowed before the Load operation stops. 10. [al] Select Lock Table to lock the source and destination tables during the Load operation. 11. [al] Select Replace Existing Data to specify that data in the source file replaces any existing data in the destination file. 12. [al] Select Include Null Rows to include null rows in the table. 13. Select Use System Locale to use the formatting for date, timestamp, digit grouping symbol, and decimal symbol based on the country and language setting for your operating system. A preview of the format is displayed. 14. Complete the File s. For example, if you selected Delimited Text, complete the following fields: a. In Column Delimiter, select the delimiter that you want used to separate data. Comma Uses commas (,) to separate data in destination file Semicolon Uses semicolons (;) to separate data in destination file Space Uses blank spaces to separate data in destination file Tab Uses Tabs to separate data in destination file Fixed Width Uses fixed width columns to separate data. Specify in Fixed Width Columns a numeric value for the fixed column width. I Inserts a vertical bar (I) to separate data b. Select the Character String Delimiter to use to distinguish string text. The options are " (double-quotes), ' (single quote), or None. c. In Line Separator, select one of the following options based on the operating system from which the data is imported. This option enables you to import files with only Carriage Returns (CR), only LineFeeds (LF), or both Carriage Returns and LineFeeds (CR and LF). Windows OS (CR and LF) Teradata Studio Express User Guide, Release

127 6: Data Import and Export Prior to Mac OS X v10.0 (CR) Unix, Linux, Mac OS X v10.0 and above (LF) d. In File Encoding, select the character set to use to encode the data. The options are: UTF-8, utf-16, ISO , UTF-16BE, UTF-16LE, US-ASCB, Cp1252. e. In Start Loading At Row Number, type the table row number at which you want the wizard to start loading data. This option does not apply to Hadoop. A sample of the input file based on the options you select displays below the File s. If you change the values selected in File s fields, the sample row display also changes. 15. Click Finish. The wizard returns you to the Transfer History View where you can view the report on the Load operation success or failure. About the Load Data Wizard and JDBC The JDBC Driver returns SQL warnings if it determines that a FastLoad operation is not possible. This might be due to incompatible column data types; for example, CLOB or BLOB data types. If this occurs, the JDBC Driver processes the batch insert in a non-fastload mode. Note: The JDBC Driver feature is not applicable for Aster data transfers. When loading data, not all data type conversions supported by the Teradata JDBC Driver are supported by JDBC FastLoad or JDBC addbatch. This is an issue related to Date, Time, and Timestamp data types. Teradata recommends that when you load data for these data types, use the following JDBC escape formats: JDBC Date escape format is: yyyy-mm-dd. JDBC Time escape format is: hh:mm:ss. JDBC Timestamp escape format is: yyyy-mm-dd hh:mm:ss.ffffff. Import and Load External Data (Hadoop) About the Load Data Wizard (Hadoop) Once you have selected the table to receive the data in the Data Source Explorer, You can specify the type of data import you want performed. Note: You must select External File as the Source Type to launch the Load Data Wizard. Teradata Studio Express User Guide, Release

128 6: Data Import and Export After the Load Data Wizard opens, specify the name, path, and external file type of the source file. Use the drop-down lists to select the correct information. Load Data Wizard (Hadoop) The Load Data Wizard enables you to load data from an input file into a table using a combination of WebHDFS and JDBC. The input file must be a delimited text file. If the table is not empty, the Load Data Wizard appends or replaces the existing data. The Load Data Wizard for Hadoop contains the following elements: Input File File Type Delimiter Specify the path and name of the file from which to import data and to specify the server path to its location in the file system. To locate an existing file, click Browse and navigate the file system to select a file. File type is Delimited Text. This cannot be changed. The delimiter corresponds to the delimiter of the Hadoop table you are importing. Teradata Studio Express User Guide, Release

129 6: Data Import and Export Table File Format Replace Existing Data The table file format corresponds to the table file format of the Hadoop table you are importing. If the table is not empty, check this option to replace the existing data. Leaving it cleared appends the loaded data to the existing data. If the table is empty, this option is grayed out. Line Separator Specify the line separator used in the file you are importing.. File Encoding Specify the type of encoding to used for the file. Data contained in the external file displays at the bottom of the wizard screen. Table data includes column name, column data type, and values in table rows. When you click Finish, a file transfer job is launched in the Transfer Progress View view. When the transfer is complete, it is displayed in the Transfer History View. Loading Table Data from a File (Hadoop) 1. Open the Data Transfer perspective. 2. Select a Hadoop table in the Data Source Explorer as the destination table. 3. Right-click the table and select Data > Load Data. 4. In the Data Transfer Wizard, select External File as the Source Type. 5. Click Launch. The Load Data Wizard opens. 6. At Input File, type the directory path and name of the file that contains the data you want to import. To find a file in your file system, click Browse, select the file, and click Open. 7. [al] Select Replace Existing Data to specify that data in the source file replaces any existing data in the destination file. 8. In Line Separator, select one of the following options based on the operating system from which the data is imported. This option enables you to import files with only Carriage Returns (CR), only LineFeeds (LF), or both Carriage Returns and LineFeeds (CR and LF). Windows OS (CR and LF) Prior to Mac OS X v10.0 (CR) Unix, Linux, Mac OS X v10.0 and above (LF) 9. In File Encoding, select the character set to use to encode the data. The options are: UTF-8, UTF-16, ISO , UTF-16BE, UTF-16LE, US-ASCB, Cp1252. A sample of the input file based on the options you select displays below the File s. If you change the values selected in File s fields, the sample row display also changes. 10. Click Finish. When you click Finish, a file transfer job is launched in the Transfer Progress View view. When the transfer is complete, it is displayed in the Transfer History View. Teradata Studio Express User Guide, Release

130 6: Data Import and Export About Smart Load Wizard (Teradata, Aster) The Smart Load Wizard enables you to create Teradata or Aster tables from data stored in an external file. This screen varies with destination system and options selected. Input File Enter the path and name for the file to import or click Browse to find a file on your file system. File Type Select the type of file to import. The default file type is delimited text. The Microsoft Excel file type has options for files with.xlsx and.xls extensions. Column Labels in First Row Select to specify that the first row in the file contains the column labels so that the first row in the file is ignored. Drop Table If Max n Error(s) Occur Select to drop the table if the number of error you enter occurs. Include Null Row Select to include null rows in the table. Teradata Studio Express User Guide, Release

131 6: Data Import and Export Use System Locale Select to use the formatting for date, timestamp, digit grouping symbol, and decimal symbol based on the country and language setting for your operating system. A preview of the formatting is displayed. When system locale is not selected, Teradata Studio accepts the following formats: Numbers: Comma as digit grouping symbol. For example, 1,234,567. Dot as decimal symbol. For example, 1, Dates: "yyyy-mm-dd", "yyyy/mm/dd", "MM-dd-yy", "MM/dd/yy", "MM-dd-yyyy", "MM/dd/yyyy" Timestamps: "MM/dd/yy hh:mm:ss.s","mm/dd/yyyy hh:mm:ss.s", "MM-dd-yy hh:mm:ss.s", "MM-dd-yyyy hh:mm:ss.s", "yyyy/mm/dd HH:mm:ss.S", "yyyy-mm-dd hh:mm:ss.s", "MM/dd/yy hh:mm:ss","mm/dd/yyyy hh:mm:ss", "MM-dd-yy hh:mm:ss", "MM-dd-yyyy hh:mm:ss", "yyyy/mm/dd HH:mm:ss", "yyyy-mm-dd hh:mm:ss" Quick Scan Select to scan the file partially when trying to derive a table from the imported data. Column Delimiter Specify the column delimiter used in the input file. Character String Delimiter Specify the character string delimiter used in the input file. Line Separator Specify the type of column delimiters, character string delimiters, and character encoding the data in the imported file uses. If you specified an EXCEL spreadsheet as the input file and selected either EXCEL (.xlsx) or EXCEL (.xls) as the file type, you can import data from a single worksheet in the file by selecting a worksheet name in Import Worksheet. The Line Separator options enable you to import files that have only LineFeed (LF), as in Unix and Linux, or only Carriage Return (CR) as in Mac OS/X prior to v10.0, or both, as for Windows. The options are: Windows OS (CR and LF) Prior to Mac OS X v10.0 (CR) Unix, Linux, Mac OS X v10.0 and above (LF) File Encoding Specify the type of encoding to used for the file. Creating Tables with Smart Load (Teradata, Aster) Use this procedure to create a new Teradata or Aster table by importing data from an external file. 1. In Data Source Explorer right-click Tables on a Teradata or Aster system. 2. Choose the correct option for your system: Teradata Aster Action Teradata > Data Transfer Aster > Data Transfer Teradata Studio Express User Guide, Release

132 6: Data Import and Export The Data Transfer Wizard displays. 3. In Source Type, select External File (Smart Load). 4. Click Launch. The Smart Load Wizard opens. 5. In Input File, type the directory path and name of the file that contains data you want to use to build a table. You can also browse to the file. 6. Select the File Type for the input file: Delimited Text Excel (.xlsx) Excel (.xls) Text file that uses delimiters to separate data; such as, commas or semicolons in a TXT or CSV file. Microsoft Excel file with.xlsx file extension. Microsoft Excel file with.xls file extension. 7. [al] Select Column Labels in First Row to specify to use the first row of data as the column labels for the new table. 8. [al] In Drop Table if Max Error(s) Occur, type the maximum number of errors that a table can have before it is dropped from the import operation. 9. [al] Select Include Null Rows to include null rows in the table. 10. Select Use System Locale to use the formatting for date, timestamp, digit grouping symbol, and decimal symbol based on the country and language setting for your operating system. A preview of the format is displayed. 11. [al] If you selected Delimited Text, select Quick Scan to scan the file partially when trying to derive a table from the imported data. 12. If you selected Delimited Text, use the list in Column Delimiter to select the delimiter that is used to separate data in the input file. Comma Input file data is separated by commas (,) Semicolon Input file data is separated by semicolons (;) Space Tab Fixed Width I Input file data is separated by blank spaces Input file data is separated by Tabs Input file data has fixed width columns. Specify in the Fixed Width Columns field a numeric value for the fixed column width. Vertical bar (I) is used to separate data 13. If you selected Delimited Text, select the Character String Delimiter to use to distinguish string text. The options are " (double-quotes), ' (single quote), or None. This option does not apply to Hadoop. 14. If you selected Delimited Text, in Line Separator select one of the following options based on the operating system from which the data is imported. This option enables you to import files Teradata Studio Express User Guide, Release

133 6: Data Import and Export with only Carriage Returns (CR), only LineFeeds (LF), or both Carriage Returns and LineFeeds (CR and LF). Windows OS (CR and LF) Prior to Mac OS X v10.0 (CR) Unix, Linux, Mac OS X v10.0 and above (LF) 15. If you selected Delimited Text, in File Encoding select the character set to use to encode the data. The options are: UTF-8, utf-16, ISO , UTF-16BE, UTF-16LE, US-ASCB, Cp Click Next. The Table Column Data Types screen displays. 17. In Table Name, type the name of the table to be derived from the loaded data. 18. [Teradata Only] In Primary Index, select whether this table will have a primary index, and whether it is unique. The Teradata primary index is used to evenly distribute data among AMPs.A non-unique primary index permits the insertion of duplicate field values. 19. Select the Table Type. 20. To edit the data types of a specific column, click (ellipses) in the column header. 21. Select one of the following: Click Next Click Finish Previews the SQL/DDL code that creates the new table. You can edit the SQL statements in the Generated SQL text area by clicking Show in Editor. If you choose to open the SQL Editor, the Smart Load Wizard closes. You can run the SQL query statements from the SQL Editor to create the table. Creates the table and imports the data from the file. Editing Column Data Types (Teradata, Aster) You can edit the data type for a table column prior to importing data in the Smart Load Wizard. The exact menu options vary depending on the table type and the column type. Teradata Studio Express User Guide, Release

134 6: Data Import and Export 1. On the Data Types page, click the ellipsis next to the data type to change. 2. In Type select the data type for the column you are editing. The remaining options vary depending on the data type. 3. Select Can contain nulls if the data in the column can include null values. This action de-selects Values must be unique if it is selected. 4. Select Values must be unique if the data in the column must be unique values. This action clears Can contain nulls. 5. If you selected SMALLINT as the data type, you can select Distribute by Hash if you want specify a distribution key column. Using Distribute by Hash with a distribution key is mandatory for fact tables and optional for dimension tables. Joins involving columns that are part of a distribution key constraint will be optimized. 6. Click OK. Smart Load Data Types for Teradata Tables The following data types are supported in the Smart Load Wizard for Teradata tables. Teradata Data Type BYTE CHARACTER CHARACTER LARGE OBJECT DATE Fixed length binary string Fixed length character string. In Size type the size limit of the character string. Large character string A date consisting of year/month/day Teradata Studio Express User Guide, Release

135 6: Data Import and Export Teradata Data Type DECIMAL DOUBLE PRECISION FLOAT INTEGER INTERVAL INTERVAL DAY INTERVAL DAY TO HOUR INTERVAL DAY TO MINUTE INTERVAL DAY TO SECOND INTERVAL HOUR INTERVAL HOUR TO MINUTE INTERVAL HOUR TO SECOND INTERVAL MINUTE INTERVAL MINUTE TO SECOND INTERVAL MONTH INTERVAL SECOND INTERVAL YEAR INTERVAL YEAR TO MONTH JSON NUMERIC PERIOD(DATE) PERIOD(TIME) PERIOD(TIME WITH TIME ZONE) PERIOD(TIMESTAMP) REAL Decimal number with fixed number of digits and a fixed number of digits to the right of the decimal point Floating-point data type. There are no additional options. Floating point number 32-bit binary integer. There are no additional options. There are no additional options. An interval defining a period of time in days An interval defining a period of time in days and hours An interval defining a period of time in days, hours and An interval defining a period of time in days, hours, minutes and seconds An interval defining a period of time in hours An interval defining a period of time in hours and minutes An interval defining a period of time in hours, minutes and seconds An interval defining a period of time in minutes An interval defining a period of time in minutes and seconds An interval defining a period of time in months An interval defining a period of time in seconds An interval defining a period of time in years An interval defining a period of time in years and months (JavaScript Object Notation) text-based, data interchange format used in web applications to transmit data Numeric data such as integers, real numbers, and floating-point numbers. A period of dates consisting of year/month/day. (This type is available only for Teradata 13 and later.) A period of times consisting of hour/minute/second/fractional second. (This type is available only for Teradata 13 and later.) A PERIOD(TIME) with displacements from UTC. (This type is available only for Teradata 13 and later.) A period of timestamps consisting of year/month/day/hour/ minute/second/fractional second. (This type is available only for Teradata 13 and later.) Floating-point data type. No additional options. Teradata Studio Express User Guide, Release

136 6: Data Import and Export Teradata Data Type SMALLINT TEXT TIME TIME WITH TIME ZONE TIMESTAMP TIMESTAMP WITH TIME ZONE VARBYTE VARCHAR XML 16-bit binary integer. There are no additional options to enter. In Size type the limit of the text size. A time consisting of hour/minute/second/fractional second A TIME with a displacement from UTC A timestamp consisting of year/month/day/hour/minute/ second/fractional second A TIMESTAMP with a displacement from UTC Variable length binary string Variable length character string (Extensible Markup Language) text-based, data format used for application integration to format messages passed between applications and as a document format for storing data Smart Load Data Types for Aster Tables The following data types are supported in the Smart Load Wizard for Aster tables. Aster BYTEA CHAR DATE DOUBLE PRECISION INTEGER INTERVAL IP4 IP4Range NUMERIC SMALLINT TEXT TIME Variable-length binary string Fixed length character string. In Size type the size limit of the character string. A calendar date consisting of year/month/day Double-precision Floating-point number. There are no additional options. 32-bit binary integer. There are no additional options. There are no additional options. IP address Range of IP addresses Numeric data such as integers, real numbers, and floating-point numbers. An Aster Database numeric must have a scale and precision to be exported, due to the different meanings of precision and scale in different systems. In Precision, type the total count of significant digits in the whole number, that is, the number of digits to both sides of the decimal point. In Scale, type the count of decimal digits in the fractional part, to the right of the decimal point. For example, the number has a precision of 6 and a scale of 4. Signed two-byte integer. There are no additional options to enter. Stores strings of any length. In Size type the limit of the text size. A time consisting of hour/minute/second/fractional second Teradata Studio Express User Guide, Release

137 6: Data Import and Export Aster TIME WITH TIME ZONE TIMESTAMP TIMESTAMP WITH TIME ZONE UUID VARBIT VARCHAR A TIME with a displacement from UTC A timestamp consisting of year/month/day/hour/minute/second/fractional second A TIMESTAMP with a displacement from UTC Stores Universally Unique Identifiers (UUID) as defined by RFC 4122, ISO/IEC :2005, and related standards. Variable length binary string Variable length character string About Smart Load Wizard (Hadoop) The Smart Load Wizard enables you to create Hadoop tables derived from data stored in an external file. Input File Enter the path and name for the file to import or click Browse to find a file on your file system. Teradata Studio Express User Guide, Release

138 6: Data Import and Export File Type This is Delimited Text for Hadoop destinations. Column Labels in First Row Select to specify that the first row in the file contains the column labels so that the first row in the file is ignored. This option is not available for Cloudera systems. Column Delimiter Specify the column delimiter used in the input file. Line Separator The Line Separator options enable you to import files that have only LineFeed (LF), as in Unix and Linux, or only Carriage Return (CR) as in Mac OS/X prior to v10.0, or both, as for Windows. The options are: Windows OS (CR and LF) Prior to Mac OS X v10.0 (CR) Unix, Linux, Mac OS X v10.0 and above (LF) File Encoding Specify the type of encoding to used for the file. Creating Tables with Smart Load (Hadoop) Use this procedure to create a new Hadoop table by importing data from an external file. 1. In Data Source Explorer right-click Tables on a Hadoop system. 2. Select Hadoop > Data Transfer. The Data Transfer Wizard displays. 3. In Source Type, select External File (Smart Load). 4. Click Launch. The Smart Loader for Hadoop Wizard opens. 5. In Input File, type the directory path and name of the file that contains data you want to use to build a table. You can also browse to the file. 6. [al] Select Column Labels in First Row to specify to use the first row of data as the column labels for the new table. This option is not available for Cloudera systems. 7. At Column Delimiter, select the delimiter that is used to separate data in the input file. Comma Input file data is separated by commas (,) Semicolon Input file data is separated by semicolons (;) Space Tab Input file data is separated by blank spaces Input file data is separated by Tabs 8. In Line Separator, select one of the following options based on the operating system from which the data is imported. This option enables you to import files with only Carriage Returns (CR), only LineFeeds (LF), or both Carriage Returns and LineFeeds (CR and LF). Teradata Studio Express User Guide, Release

139 6: Data Import and Export Windows OS (CR and LF) Prior to Mac OS X v10.0 (CR) Unix, Linux, Mac OS X v10.0 and above (LF) 9. In File Encoding select the character set to use to encode the data. The options are: UTF-8, UTF-16, ISO , UTF-16BE, UTF-16LE, US-ASCB, Cp Click Next. The Hadoop Table Properties screen displays. 11. In Table Name, type the name of the table to be derived from the loaded data. 12. In Table File Format, select the format of the data in the table. Supported table file format types are TEXT (default), SEQUENCE, RC, and ORC. ORC is only available for Hortonworks. For Cloudera Systems, if RC or SEQUENCE is selected for Table File Format, the wizard requires Hive JDBC Properties. Note: The hive host name field is prepopulated with the impala host name. If the hive host name is different, modify the field to the correct host value. 13. To edit the data types of a specific column, click (ellipses) in the column header. 14. Select one of the following: Click Next Click Finish Previews the SQL/DDL code that creates the new table. You can edit the SQL statements in the Generated SQL text area by clicking Show in Editor. If you choose to open the SQL Editor, the Smart Load Wizard closes. You can run the SQL query statements from the SQL Editor to create the table. Creates the table and imports the data from the file. Editing Column Data Types (Hadoop) You can edit the data type for a table column prior to importing data in the Smart Load Wizard. The exact menu options vary depending on the table type and the column type. Teradata Studio Express User Guide, Release

140 6: Data Import and Export 1. On the Data Types page, click the ellipsis next to the data type to change. 2. In Type select the data type for the column you are editing. 3. Click OK. Smart Load Data Types for Hadoop Tables The following data types are supported in the Smart Load Wizard for Hadoop tables. Teradata Data Type BIGINT DATE DOUBLE FLOAT INT SMALLINT STRING TIMESTAMP TINYINT 8-byte binary integer. There are no additional options. A date consisting of year/month/day. This does not apply to Cloudera systems. Floating-point data type. There are no additional options. Floating point number 32-bit binary integer. There are no additional options. 16-bit binary integer. There are no additional options. Character string. A timestamp consisting of year/month/day/hour/minute/second/fractional second. Cloudera systems can also use year/month/day. 8-bit binary integer. There are no additional options. Export External Data About the Export Data Wizard The Export Data Wizard enables you to export data from a table to a file in a file system. Teradata Studio Express User Guide, Release

141 6: Data Import and Export Export Data to External File In this section you can specify the name of the file to receive the data and the server path to its location in the file system. To locate an existing file, click Browse and navigate the file system to select a file. You can choose to export data to a text file, such as a.txt or.csv file, or to a Microsoft Excel file. Choose between a.xslx file, or.xls (Microsoft Excel ) file. The file data options change depending on which type of output file you select. Table Column Selecting Select Column Labels in First Row retrieves the column headers in the table to be written as the column labels in the first row of data in the export file. Export File Delimiters and Encoding A delimiter is a character or sequence of characters that specify the boundaries of independent regions of data in plain text by distinguishing the beginning and end of the unit of data, such as a field value. You must select how you want to delimit data from exported table columns when it is imported to the target file. You can accept the default to use commas or you can use choose to use semicolons, spaces, tabs, or vertical bars ( ). You can optionally select delimiters for character strings and the type of file encoding to use. Teradata Studio Express User Guide, Release

142 6: Data Import and Export Controls Control buttons are used to move forward or backward within the Export Data Wizard. When you are ready to export data, click Finish. A Progress Information dialog displays to show the progress of the export task. Exporting Table Data to an External File You can select a database table in the Data Source Explorer and export the data in the table to a TXT, CSV, XSL, or XSLX file in your file system. When you select to export data to an external file, the Export Data Wizard opens and prompts you for information about the data transfer operation. 1. Select a table object in the Data Source Explorer to use as the source table for exporting data to a file. 2. Right-click the selected table object and select Data > Export Data. 3. In the Data Transfer Wizard, select External File (FastExport) as the Destination Type. The Export Data Wizard opens. Transfer Progress View About the Transfer Progress View The Transfer Progress View displays a list of executing data transfer jobs and their status. It provides information about the source and destination tables for the data transfer, name of the transfer job, and start time, as well as the current elapsed time for the transfer operation. A progress bar appears in the right-most column for each executing job and shows the current progress state of the transfer compared to the estimated length of time to completion. The Transfer Progress View runs a single job to completion before it starts the next job. If multiple jobs are submitted at the same time, the jobs are placed in a queue and run in sequence. If you close Teradata Studio while jobs are running or queued, the jobs are canceled. Canceled jobs are moved to the History View where you can re-execute the jobs at a later time. If you close the view and need to re-open it, go to Window > Window > Transfer Progress View. The Transfer Progress View automatically displays when you select the Data Transfer perspective. Teradata Studio Express User Guide, Release

143 6: Data Import and Export List of Transfer Jobs The view displays a list of the data transfer jobs that are currently executing. After a job completes, you can view the transfer report in the Transfer History View and re-execute the job if needed. Job Information The view provides the following details for each data transfer job. Menu Job Type Name Start Time Time Elapsed Summary Progress Indicates the system type (Aster, Hadoop, or Teradata) and the type of transfer job; for example, whether the job is an Aster Load, Teradata Table Copy, Import from Hadoop to Teradata, or Export from Teradata to Hadoop. Displays the name which can be changed before the job begins in the setup wizard or after the job has completed in the Transfer History View. By default, the name of the job is the job type followed by the name of the table that is being transferred. Displays the time stamp for the start of the data transfer operation. Displays how long the job has been running. The entry displays "CANCELING" if the transfer is in the process of being canceled. The elapsed time value is updated continuously until the transfer completes. Displays the names of the source and destination tables for the transfer job. When a transfer job is running, the Progress bar shows the percentage of completion by displaying a green bar that gradually expands in length as the job progresses. Progress Bar The view displays a list of the data transfer jobs that are currently executing. After a job completes, it becomes an entry in the Transfer History View. Queue List Transfer jobs run one at a time. If a job is already running, the next job request is placed in the queue and designated as "queued" in the Progress column. Toolbar The Transfer Progress View toolbar allows you to cancel any jobs that are running and to view additional details about a job in the view list. Icon Menu Cancel Transfer Details Cancels the selected job in progress. The canceled job displays in the Transfer History View. Opens the Transfer Details dialog that displays the output from the transfer job while it is running. After the job completes, the output is available in the Transfer History View. Transfer Details The Transfer Details dialog displays the output of the transfer operation while the job is running. Teradata Studio Express User Guide, Release

144 6: Data Import and Export After the job completes, you can view the output in the Transfer History View. Job Details The Job Details dialog displays the output of the transfer operation while the job is running. After the job completes, you can view the output in the Transfer History View. Transfer History View About the Transfer History View The Teradata Transfer History view provides an enhanced display of the Data Transfer History information in the database. As data transfers are performed, an entry is placed in the Transfer History. The Transfer History view displays the data in a grid format that enables you to select rows or cells. The Transfer History view provides extensive information about the data transfer event, such as the name, start time, rows transferred, source and destination systems, status (Completed, Canceled, or Failed), and summary. It provides options to: Copy selected cells to the clipboard Sort columns Delete rows Edit "Note" or "Name" for a history entry Filter columns Search for transfer history data Teradata Studio Express User Guide, Release