Teradata Parallel Transporter. Quick Start Guide

Transcription

1 Teradata Parallel Transporter Quick Start Guide Release B K March 2014

2 The product or products described in this book are licensed products of Teradata Corporation or its affiliates. Teradata, Active Data Warehousing, Active Enterprise Intelligence, Applications-Within, Aprimo Marketing Studio, Aster, BYNET, Claraview, DecisionCast, Gridscale, MyCommerce, SQL-MapReduce, Teradata Decision Experts, "Teradata Labs" logo, Teradata ServiceConnect, Teradata Source Experts, WebAnalyst, and Xkoto are trademarks or registered trademarks of Teradata Corporation or its affiliates in the United States and other countries. Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc. AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc. Apache, Apache Hadoop, Hadoop, and the yellow elephant logo are either registered trademarks or trademarks of the Apache Software Foundation in the United States and/or other countries. Apple, Mac, and OS X all are registered trademarks of Apple Inc. Axeda is a registered trademark of Axeda Corporation. Axeda Agents, Axeda Applications, Axeda Policy Manager, Axeda Enterprise, Axeda Access, Axeda Software Management, Axeda Service, Axeda ServiceLink, and Firewall-Friendly are trademarks and Maximum Results and Maximum Support are servicemarks of Axeda Corporation. Data Domain, EMC, PowerPath, SRDF, and Symmetrix are registered trademarks of EMC Corporation. GoldenGate is a trademark of Oracle. Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company. Hortonworks, the Hortonworks logo and other Hortonworks trademarks are trademarks of Hortonworks Inc. in the United States and other countries. Intel, Pentium, and XEON are registered trademarks of Intel Corporation. IBM, CICS, RACF, Tivoli, and z/os are registered trademarks of International Business Machines Corporation. Linux is a registered trademark of Linus Torvalds. LSI is a registered trademark of LSI Corporation. Microsoft, Active Directory, Windows, Windows NT, and Windows Server are registered trademarks of Microsoft Corporation in the United States and other countries. NetVault is a trademark or registered trademark of Dell Inc. in the United States and/or other countries. Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries. Oracle, Java, and Solaris are registered trademarks of Oracle and/or its affiliates. QLogic and SANbox are trademarks or registered trademarks of QLogic Corporation. Quantum and the Quantum logo are trademarks of Quantum Corporation, registered in the U.S.A. and other countries. Red Hat is a trademark of Red Hat, Inc., registered in the U.S. and other countries. Used under license. SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc. SPARC is a registered trademark of SPARC International, Inc. Symantec, NetBackup, and VERITAS are trademarks or registered trademarks of Symantec Corporation or its affiliates in the United States and other countries. Unicode is a registered trademark of Unicode, Inc. in the United States and other countries. UNIX is a registered trademark of The Open Group in the United States and other countries. Other product and company names mentioned herein may be the trademarks of their respective owners. THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROVIDED ON AN "AS-IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. IN NO EVENT WILL TERADATA CORPORATION BE LIABLE FOR ANY INDIRECT, DIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS OR LOST SAVINGS, EVEN IF EXPRESSLY ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. The information contained in this document may contain references or cross-references to features, functions, products, or services that are not announced or available in your country. Such references do not imply that Teradata Corporation intends to announce such features, functions, products, or services in your country. Please consult your local Teradata Corporation representative for those features, functions, products, or services available in your country. Information contained in this document may contain technical inaccuracies or typographical errors. Information may be changed or updated without notice. Teradata Corporation may also make improvements or changes in the products or services described in this information at any time without notice. To maintain the quality of our products and services, we would like your comments on the accuracy, clarity, organization, and value of this document. Please teradata-books@lists.teradata.com. Any comments or materials (collectively referred to as "Feedback") sent to Teradata Corporation will be deemed non-confidential. Teradata Corporation will have no obligation of any kind with respect to Feedback and will be free to use, reproduce, disclose, exhibit, display, transform, create derivative works of, and distribute the Feedback and derivative works thereof without limitation on a royalty-free basis. Further, Teradata Corporation will be free to use any ideas, concepts, know-how, or techniques contained in such Feedback for any purpose whatsoever, including developing, manufacturing, or marketing products or services incorporating Feedback. Copyright by Teradata Corporation. All Rights Reserved.

3 Preface Purpose This book is a quick start guide to using Teradata Parallel Transporter (Teradata PT), a Teradata Tools and Utilities product. Teradata Tools and Utilities is a group of client products designed to work with the Teradata Database. Teradata PT provides high-performance data extraction, loading, and updating operations for the Teradata Database. The best way to use this book is to work through each Teradata PT job example in the order presented here. 1 Reading data from a flat file and loading it into a Teradata Database target table. 2 Exporting data from a Teradata Database source table and writing it to a flat file. 3 Exporting data from a Teradata Database source table and loading it to a Teradata Database target table. Audience This book is intended for first-time Teradata PT users. Supported Releases This book supports the following releases: Teradata Database Teradata Tools and Utilities Teradata Parallel Transporter To locate detailed supported release information: 1 Go to 2 Under Online Publications, click General Search. 3 Type 3119 in the Publication Product ID box. 4 Under Sort By, select Date. 5 Click Search. 6 Open the version of the Teradata Tools and Utilities ##.# Supported Platforms and Product Versions spreadsheet associated with this release. Teradata Parallel Transporter Quick Start Guide, Release

4 Preface Changes to this Book The spreadsheet includes supported Teradata Database versions, platforms, and product release numbers. Changes to this Book Release March Description Updated to in Supported Releases. Additional Information Additional information that supports this product and the Teradata Tools and Utilities is available at the following web sites. Type of Information Description Source Release overview Late information Use the Release Definition for the following information: Overview of all the products in the release Information received too late to be included in the manuals Operating systems and Teradata Database versions that are certified to work with each product Version numbers of each product and the documentation for each product Information about available training and support center 1 Go to 2 Under Online Publications, click General Search 3 Type 2029 in the Publication Product ID box. 4 Click Search. 5 Select the appropriate Release Definition from the search results. 4 Teradata Parallel Transporter Quick Start Guide, Release 15.00

5 Preface Additional Information Type of Information Description Source Additional product information Use the Teradata Information Products web site to view or download specific manuals that supply related or additional information to this manual. 1 Go to 2 Under the Online Publications subcategory, Browse by Category, click Data Warehousing. 3 Do one of the following: For a list of Teradata Tools and Utilities documents, click Teradata Tools and Utilities, and then select an item under Releases or Products. Select a link to any of the data warehousing publications categories listed. Specific books related to Teradata PT are as follows: Teradata Tools and Utilities Access Module Programmer Guide B Teradata Tools and Utilities Access Module Reference B Teradata Parallel Transporter Application Programming Interface Programmer Guide B Teradata Parallel Transporter Operator Programmer Guide B Teradata Parallel Transporter Quick Start Guide B Teradata Parallel Transporter Reference B B Teradata Tools and Utilities for IBM z/os Installation Guide B Teradata Tools and Utilities Installation Guide for Microsoft Windows B Teradata Tools and Utilities for Red Hat Enterprise Linux Installation Guide B Teradata Tools and Utilities for SUSE Linux Installation Guide B Teradata Tools and Utilities for s390x Linux Installation Guide B Teradata Tools and Utilities for HP-UX Installation Guide B Teradata Parallel Transporter Quick Start Guide, Release

6 Preface Additional Information Type of Information Description Source Teradata Tools and Utilities for IBM AIX Installation Guide B Teradata Tools and Utilities for Oracle Solaris on AMD Opteron Systems Installation Guide B Teradata Tools and Utilities for Oracle Solaris on SPARC Systems Installation Guide B CD-ROM images General information about Teradata Access a link to a downloadable CD-ROM image of all customer documentation for this release. Customers are authorized to create CD-ROMs for their use from this image The Teradata home page provides links to numerous sources of information about Teradata. Links include: Executive reports, case studies of customer experiences with Teradata, and thought leadership Technical information, solutions, and expert advice Press releases, mentions and media resources 1 Go to 2 Under the Online Publications subcategory, Browse by Category, click Data Warehousing. 3 Click CD-ROM Images. 4 Follow the ordering instructions. Go to Teradata.com/t/resources. Select a link. Product Safety Information This document may contain information addressing product safety practices related to data or property damage, identified by the word Notice. A notice indicates a situation which, if not avoided, could result in damage to property, such as equipment or data, but not related to personal injury. Example: Improper use of the Reconfiguration utility can result in data loss. 6 Teradata Parallel Transporter Quick Start Guide, Release 15.00

7 Table of Contents Preface Purpose Audience Supported Releases Changes to this Book Additional Information Product Safety Information Chapter 1: Reading Data from a Flat File and Loading it into a Teradata Table Specify TdpId, UserName, and UserPassword Create a Target Table Run the Teradata PT Job Script For More Information Chapter 2: Exporting Data from a Teradata Table and Writing it to a Flat File Specify TdpId, UserName, and UserPassword Create a Source Table Run the Teradata PT Job Script For More Information Chapter 3: Exporting Data from a Source Table and Loading it into a Target Table Specify TdpId, UserName, and UserPassword Teradata Parallel Transporter Quick Start Guide, Release

8 Table of Contents Create a Source and Target Table Run the Teradata PT Job Script For More Information Appendix A: Teradata PT Publications Teradata Parallel Transporter Quick Start Guide, Release 15.00

9 List of Figures Figure 1: Reading Data from a Flat File and Loading it into an Empty Target Table Figure 2: Exporting Data from a Teradata Source Table and Writing it to a Flat File Figure 3: Exporting Data from a Source Table to Loading it into a Target Table Teradata Parallel Transporter Quick Start Guide, Release

10 List of Figures 10 Teradata Parallel Transporter Quick Start Guide, Release 15.00

11 CHAPTER 1 Reading Data from a Flat File and Loading it into a Teradata Table This chapter describes the most commonly used Teradata PT function: loading flat file data into a Teradata table. The Teradata PT script you will run loads into the empty target table, called TARGET_EMP_TABLE, 10 rows of employee data from a flat file called flatfile1.txt whose data is delimited using the pipe ( ) text delimiter. Here are the contents of flatfile1.txt. ID01 JOHN ID02 PETER ID03 FRANK ID04 MARY ID05 ELLEN ID06 MICHAEL ID07 SAM ID08 JONATHAN ID09 MICHELLE ID10 ALICE Figure 1: Reading Data from a Flat File and Loading it into an Empty Target Table Job Script 1 Flatfile 1 10 Rows of Employee Data Teradata PT Teradata Target Table 2501A001 Loading flat file data into a Target table entails performing the following three steps. Do them in the order in which they appear here. Specify TdpId, UserName, and UserPassword To specify the TdpId, UserName, and UserPassword, edit the job variables file, jobvars1.txt, as follows: Teradata Parallel Transporter Quick Start Guide, Release

12 Chapter 1: Reading Data from a Flat File and Loading it into a Teradata Table Create a Target Table CD [change directory] to the quick start sample directory. Open the jobvars1.txt (job variables) file. Specify site-specific values for the following 3 variables: TargetTdpId: name of your Teradata Database TargetUserName: your user name on the Teradata Database TargetUserPassword: your password on the Teradata Database Example: TargetTdpId = 'yourtdpid',targetusername = 'yourusername',targetuserpassword = 'yourpassword' Once you have entered your values, save your changes and close the file. Create a Target Table The following is the job script you will be running: DEFINE JOB qsetup1 ( APPLY ('DROP TABLE TARGET_EMP_TABLE;'),('DROP TABLE TARGET_EMP_TABLE_LOG;'),('DROP TABLE TARGET_EMP_TABLE_E1;'),('DROP TABLE TARGET_EMP_TABLE_E2;'),('CREATE TABLE TARGET_EMP_TABLE(EMP_ID VARCHAR(10), EMP_NAME VARCHAR(10));') TO OPERATOR ($DDL); ); The script is saved as qsetup1.txt in the quickstart sample directory. To run the job script that creates a target table, execute the following Teradata PT command in the command window: tbuild -f qsetup1.txt -v jobvars1.txt -j qsetup1 where: This tbuild option... Takes the following argument... -f Name of the script to be run: qsetup1.txt -v Name of the job variables file: jobvars1.txt This is the job variables file you have edited. -j Name of the job: qsetup1 RESULT: Once you have run the tbuild command creating the target table, you will see output on the console confirming that the table has been created. The console output may contain a DBS 3807 warning. You can ignore this message. For more information, see the 12 Teradata Parallel Transporter Quick Start Guide, Release 15.00

13 Chapter 1: Reading Data from a Flat File and Loading it into a Teradata Table Run the Teradata PT Job Script ErrorList operator attribute in the DDL Operator chapter of the Teradata Parallel Transporter Reference. Run the Teradata PT Job Script The following is the Teradata PT job script you will be running. DEFINE JOB qstart1 ( APPLY $INSERT TO OPERATOR ($LOAD) SELECT * FROM OPERATOR($FILE_READER); ); The script is saved as qstart1.txt in the quickstart sample directory. To run the job script, execute the following Teradata PT command in the command window: tbuild -f qstart1.txt -v jobvars1.txt -j qstart1 where: This tbuild option... Takes the following argument... -f Name of the script to be run: qstart1.txt -v Name of the job variables file: jobvars1.txt This is the job variables file you have edited. -j Name of the job: qstart1 RESULT: Once you have run the tbuild command loading data into the target table, you will see the following output on the console, confirming that 10 rows have been loaded. The console output may contain a DBS 3807 warning. You can ignore this message. For more information, see the ErrorList operator attribute in the DDL Operator chapter of the Teradata Parallel Transporter Reference.... Teradata Parallel Transporter Version Job log: C:\Program Files\Teradata\client\ \Teradata Parallel Transporter/lo gs/qstart1-32.out Job id is qstart1-32, running on WUSLK V5X Teradata Parallel Transporter Load Operator Version $LOAD: private log specified: loadprivate.log Teradata Parallel Transporter DataConnector Version $FILE_READER: TPT19008 DataConnector Producer operator Instances: 1 $FILE_READER: TPT19003 ECI operator ID: $FILE_READER-6024 $FILE_READER: TPT19222 Operator instance 1 processing file 'flatfile1.dat'. $LOAD: connecting sessions $LOAD: preparing target table $LOAD: entering Acquisition Phase $LOAD: entering Application Phase Teradata Parallel Transporter Quick Start Guide, Release

14 Chapter 1: Reading Data from a Flat File and Loading it into a Teradata Table For More Information $LOAD: Statistics for Target Table: 'TARGET_EMP_TABLE' $LOAD: Total Rows Sent To RDBMS: 10 $LOAD: Total Rows Applied: 10 $LOAD: disconnecting sessions $FILE_READER: TPT19221 Total files processed: 1. $LOAD: Total processor time used = ' Second(s)' $LOAD: Start : Fri May 20 13:53: $LOAD: End : Fri May 20 13:53: Job step MAIN_STEP completed successfully Job qstart1 completed successfully For More Information To Learn More About... Editing job variable files The tbuild command tbuild command-line options and their arguments Teradata PT command line utilities other than tbuild Teradata PT simplified job script syntax Teradata PT job syntax Delimited flat files Loading data into Teradata Database tables from source files other than flat files See... Teradata Parallel Transporter Reference Teradata Parallel Transporter Reference Teradata Parallel Transporter Reference 14 Teradata Parallel Transporter Quick Start Guide, Release 15.00

15 CHAPTER 2 Exporting Data from a Teradata Table and Writing it to a Flat File This chapter describes the second most commonly used Teradata PT function: exporting data from a Teradata Table to a flat file. The Teradata PT script you will run exports 10 rows of employee data from a Teradata table called SOURCE_EMP_TABLE, and writes the rows to a flat file called flatfile2.txt whose data will be delimited using a comma (, ) text delimiter. Here are the contents of SOURCE_EMP_TABLE. ID11 BILLY ID12 JANIE ID13 KRYSTAL ID14 MATTHEW ID15 LINDA ID16 DAN ID17 LAINE ID18 MICHIKO ID19 WILL ID20 MONICA Figure 2: Exporting Data from a Teradata Source Table and Writing it to a Flat File Job Script 2 Teradata Source Table 10 Rows of Employee Data Teradata PT Flatfile A002 Exporting data from a Teradata Source Table into a flat file entails performing the following three steps. Do them in the order in which they appear here. Specify TdpId, UserName, and UserPassword To specify the TdpId, UserName, and UserPassword, edit the job variables file, jobvars2.txt, as follows: Teradata Parallel Transporter Quick Start Guide, Release

16 Chapter 2: Exporting Data from a Teradata Table and Writing it to a Flat File Create a Source Table CD [change directory] to the quick start sample directory. Open the jobvars2.txt (job variables) file. Specify site-specific values for the following 3 variables: SourceTdpId: name of your Teradata Database SourceUserName: your user name on the Teradata Database SourceUserPassword: your password on the Teradata Database Example: SourceTdpId = 'yourtdpid',sourceusername = 'yourusername',sourceuserpassword = 'yourpassword' Note: The TargetTextDelimiter in the jobvars.txt file is a comma (, ). Once you have entered your values, save your changes and close the file. Create a Source Table The following is the job script you will be running: DEFINE JOB qsetup2 ( APPLY ('DROP TABLE SOURCE_EMP_TABLE;'),('CREATE TABLE SOURCE_EMP_TABLE(EMP_ID VARCHAR(10), EMP_NAME VARCHAR(10));'),('INSERT INTO SOURCE_EMP_TABLE(''ID11'',''BILLY'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID12'',''JANIE'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID13'',''KRYSTAL'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID14'',''MATTHEW'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID15'',''LINDA'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID16'',''DAN'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID17'',''LAINE'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID18'',''MICHIKO'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID19'',''WILL'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID20'',''MONICA'');') TO OPERATOR ($DDL ATTR ( TdpId=@SourceTdpId,UserName=@SourceUserName,UserPassword=@SourceUserPassword ) ); ); The script is saved as qsetup2.txt in the quickstart sample directory. To run the job script that creates a source table, execute the following Teradata PT command in the command window: tbuild -f qsetup2.txt -v jobvars2.txt -j qsetup2 where: 16 Teradata Parallel Transporter Quick Start Guide, Release 15.00

17 Chapter 2: Exporting Data from a Teradata Table and Writing it to a Flat File Run the Teradata PT Job Script This tbuild option... Takes the following argument... -f Name of the script to be run: qsetup2.txt -v Name of the job variables file: jobvars2.txt This is the job variables file you have edited. -j Name of the job: qsetup2 RESULT: Once you have run the tbuild command creating the source table, you will see output on the console confirming that the table has been created. The console output may contain a DBS 3807 warning. You can ignore this message. For more information, see the ErrorList operator attribute in the DDL Operator chapter of the Teradata Parallel Transporter Reference. Run the Teradata PT Job Script The following is the Teradata PT job script you will be running. The script is saved as qstart2.txt in the quickstart sample directory. DEFINE JOB qstart2 ( APPLY TO OPERATOR ($FILE_WRITER) SELECT * FROM OPERATOR($EXPORT); ); To run the job script, execute the following Teradata PT command in the command window: tbuild -f qstart2.txt -v jobvars2.txt -j qstart2 where: This tbuild option... Takes the following argument... -f Name of the script to be run: qstart2.txt -v Name of the job variables file: jobvars2.txt This is the job variables file you have edited. -j Name of the job: qstart2 RESULT: Once you have run the tbuild command loading data into the target table, you will see the following output on the console, confirming that 10 rows have been loaded. The console output may contain a DBS 3807 warning. You can ignore this message. For more information, see the ErrorList operator attribute in the DDL Operator chapter of the Teradata Parallel Transporter Reference.... Teradata Parallel Transporter Quick Start Guide, Release

18 Chapter 2: Exporting Data from a Teradata Table and Writing it to a Flat File For More Information Teradata Parallel Transporter DataConnector Version $FILE_WRITER: TPT19007 DataConnector Consumer operator Instances: 1 $FILE_WRITER: TPT19003 ECI operator ID: $FILE_WRITER-7992 $FILE_WRITER: TPT19222 Operator instance 1 processing file 'flatfile2.dat'. Teradata Parallel Transporter Export Operator Version $EXPORT: private log specified: exportprivate.log $EXPORT: connecting sessions $EXPORT: sending SELECT request $EXPORT: entering End Export Phase $EXPORT: Total Rows Exported: 10 $FILE_WRITER: TPT19221 Total files processed: 1. $EXPORT: disconnecting sessions $EXPORT: Total processor time used = ' Second(s)' $EXPORT: Start : Fri Jun 03 12:55: $EXPORT: End : Fri Jun 03 12:55: Job step MAIN_STEP completed successfully Job lk completed successfully For More Information To Learn More About... Editing job variables files The tbuild command tbuild command-line options and their arguments Teradata PT command line utilities other than tbuild Teradata PT simplified job script syntax Teradata PT job syntax Delimited flat files Loading data into a flat file from sources other than a Teradata DatabaseTeradata table See... Teradata Parallel Transporter Reference Teradata Parallel Transporter Reference Teradata Parallel Transporter Reference 18 Teradata Parallel Transporter Quick Start Guide, Release 15.00

19 CHAPTER 3 Exporting Data from a Source Table and Loading it into a Target Table This chapter describes a third commonly used Teradata PT function: exporting data from a Teradata source table to a Teradata Target Table. The Teradata PT script you will run exports 10 rows of employee data from a Teradata Source Table called SOURCE_EMP_TABLE, and updates a Teradata Target Table that has 10 rows of employee data. Here are the contents of SOURCE_EMP_TABLE: ID11 BILLY ID12 JANIE ID13 KRYSTAL ID14 MATTHEW ID15 LINDA ID16 DAN ID17 LAINE ID18 MICHIKO ID19 WILL ID20 MONICA Here are the contents of the TARGET_EMP_TABLE: ID01 JOHN ID02 PETER ID03 FRANK ID04 MARY ID05 ELLEN ID06 MICHAEL ID07 SAM ID08 JONATHAN ID09 MICHELLE ID10 ALICE Teradata Parallel Transporter Quick Start Guide, Release

20 Chapter 3: Exporting Data from a Source Table and Loading it into a Target Table Specify TdpId, UserName, and UserPassword Figure 3: Exporting Data from a Source Table to Loading it into a Target Table Job Script 3 Teradata Source Table 10 Rows of Employee Data 10 Rows 10 Rows Teradata PT Teradata Target Table 10 Rows of Employee Data 2501A003 Exporting data from a Teradata Source Table into a Teradata Target Table entails performing the following three steps. Do them in the order in which they appear here. Specify TdpId, UserName, and UserPassword To specify the TdpId, UserName, and UserPassword, edit the job variables file, jobvars3.txt, as follows: CD [change directory] to the quick start sample directory. Open the jobvars3.txt (job variables) file. Specify site-specific values for the following 6 variables: SourceTdpId: name of your Teradata Database SourceUserName: your user name on the Teradata Database SourceUserPassword: your password on the Teradata Database TargetTdpId: name of your Teradata Database TargetUserName: your user name on the Teradata Database TargetUserPassword: your password on the Teradata Database Example: SourceTdpId = 'yourtdpid',sourceusername = 'yourusername',sourceuserpassword = 'yourpassword',targettdpid = 'yourtdpid',targetusername = 'yourusername',targetuserpassword = 'yourpassword' Once you have entered your values, save your changes and close the file. Create a Source and Target Table The following is the job script you will be running: 20 Teradata Parallel Transporter Quick Start Guide, Release 15.00

21 Chapter 3: Exporting Data from a Source Table and Loading it into a Target Table Create a Source and Target Table DEFINE JOB qsetup3 ( APPLY ('DROP TABLE SOURCE_EMP_TABLE;'),('CREATE TABLE SOURCE_EMP_TABLE(EMP_ID VARCHAR(10), EMP_NAME VARCHAR(10));'),('INSERT INTO SOURCE_EMP_TABLE(''ID11'',''BILLY'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID12'',''JANIE'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID13'',''KRYSTAL'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID14'',''MATTHEW'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID15'',''LINDA'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID16'',''DAN'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID17'',''LAINE'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID18'',''MICHIKO'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID19'',''WILL'');'),('INSERT INTO SOURCE_EMP_TABLE(''ID20'',''MONICA'');'),('DROP TABLE TARGET_EMP_TABLE;'),('DROP TABLE TARGET_EMP_TABLE_LOG;'),('DROP TABLE TARGET_EMP_TABLE_E1;'),('DROP TABLE TARGET_EMP_TABLE_E2;'),('CREATE TABLE TARGET_EMP_TABLE(EMP_ID VARCHAR(10), EMP_NAME VARCHAR(10));'),('INSERT INTO TARGET_EMP_TABLE(''ID01'',''JOHN'');'),('INSERT INTO TARGET_EMP_TABLE(''ID02'',''PETER'');'),('INSERT INTO TARGET_EMP_TABLE(''ID03'',''FRANK'');'),('INSERT INTO TARGET_EMP_TABLE(''ID04'',''MARY'');'),('INSERT INTO TARGET_EMP_TABLE(''ID05'',''ELLEN'');'),('INSERT INTO TARGET_EMP_TABLE(''ID06'',''MICHAEL'');'),('INSERT INTO TARGET_EMP_TABLE(''ID07'',''SAM'');'),('INSERT INTO TARGET_EMP_TABLE(''ID08'',''JONATHAN'');'),('INSERT INTO TARGET_EMP_TABLE(''ID09'',''MICHELLE'');'),('INSERT INTO TARGET_EMP_TABLE(''ID10'',''ALICE'');') TO OPERATOR ($DDL); ); The script is saved as qsetup3.txt in the quickstart sample directory. Note: For the purposes of this example, qsetup3 creates and populates both the source and target tables. To run the job script that creates a target table, execute the following Teradata PT command in the command window: tbuild -f qsetup3.txt -v jobvars3.txt -j qsetup3 where: This tbuild option... Takes the following argument... -f Name of the script to be run: qsetup3.txt -v Name of the job variables file: jobvars3.txt This is the job variables file you have edited. -j Name of the job: qsetup3 Teradata Parallel Transporter Quick Start Guide, Release

22 Chapter 3: Exporting Data from a Source Table and Loading it into a Target Table Run the Teradata PT Job Script RESULT: Once you have run the tbuild command creating the source and target table, you will see output on the console confirming that the table has been created. The console output may contain a DBS 3807 warning. You can ignore this message. For more information, see the ErrorList operator attribute in the DDL Operator chapter of the Teradata Parallel Transporter Reference. Run the Teradata PT Job Script The following is the Teradata PT job script you will be running. The script is saved as qstart3.txt in the quickstart sample directory. DEFINE JOB qstart3 ( APPLY $INSERT TO OPERATOR ($UPDATE) SELECT * FROM OPERATOR ($EXPORT); ); To run the job script, execute the following Teradata PT command in the command window: tbuild -f qstart3.txt -v jobvars3.txt -j qstart3 where: This tbuild option... Takes the following argument... -f Name of the script to be run: qstart3.txt -v Name of the job variables file: jobvars3.txt This is the job variables file you have edited. -j Name of the job: qstart3 RESULT: Once you have run the tbuild command loading data into the target table, you will see the following output on the console, confirming that 10 rows have been written to a target table that already has 10 rows. The console output may contain a DBS 3807 warning. You can ignore this message. For more information, see the ErrorList operator attribute in the DDL Operator chapter of the Teradata Parallel Transporter Reference.... Teradata Parallel Transporter Version Job log: C:\Program Files\Teradata\client\ \Teradata Parallel Transporter/lo gs/qstart3-36.out Job id is qstart3-36, running on WUSLK V5X Teradata Parallel Transporter Update Operator Version $UPDATE: private log specified: updateprivate.log Teradata Parallel Transporter Export Operator Version $EXPORT: private log specified: exportprivate.log $UPDATE: connecting sessions $EXPORT: connecting sessions $UPDATE: preparing target table(s) 22 Teradata Parallel Transporter Quick Start Guide, Release 15.00

23 Chapter 3: Exporting Data from a Source Table and Loading it into a Target Table For More Information $UPDATE: entering DML Phase $UPDATE: entering Acquisition Phase $EXPORT: sending SELECT request $EXPORT: entering End Export Phase $EXPORT: Total Rows Exported: 10 $UPDATE: entering Application Phase $UPDATE: Statistics for Target Table: 'TARGET_EMP_TABLE' $UPDATE: Rows Inserted: 10 $UPDATE: Rows Updated: 0 $UPDATE: Rows Deleted: 0 $UPDATE: entering Cleanup Phase $UPDATE: disconnecting sessions $EXPORT: disconnecting sessions $EXPORT: Total processor time used = ' Second(s)' $EXPORT: Start : Fri May 20 14:01: $EXPORT: End : Fri May 20 14:01: $UPDATE: Total processor time used = ' Second(s)' $UPDATE: Start : Fri May 20 14:01: $UPDATE: End : Fri May 20 14:01: Job step MAIN_STEP completed successfully Job qstart3 completed successfully For More Information To Learn More About... Editing job variables files The tbuild command tbuild command-line options and their arguments Teradata PT command line utilities other than tbuild Teradata PT simplified job script syntax Teradata PT job syntax Loading data into a target table from a source table See... Teradata Parallel Transporter Reference Teradata Parallel Transporter Reference Teradata Parallel Transporter Reference Teradata Parallel Transporter Quick Start Guide, Release

24 Chapter 3: Exporting Data from a Source Table and Loading it into a Target Table For More Information 24 Teradata Parallel Transporter Quick Start Guide, Release 15.00

25 APPENDIX A Teradata PT Publications User documentation for Teradata PT is distributed among the following books. Teradata PT Publications Publication Teradata Parallel Transporter Application Programming Interface Programmer Guide B Teradata Parallel Transporter Operator Programmer Guide B Teradata Parallel Transporter Quick Start Guide (this book) B Teradata Parallel Transporter Reference B Contents Provides information about: Setting up the interface. Coding. Error reporting. Checkpointing and restarting. Provides information on developing custom operators, including all interface functions that allow communication between the Teradata PT operators and the Teradata PT infrastructure. Provides getting-started information for using Teradata PT. Includes Teradata PT job examples for: Reading data from a flat file and loading it into a Teradata Database target table. Exporting data from a Teradata Database source table and writing it to a flat file. Exporting data from a Teradata Database source table and loading it to a Teradata Database target table. A reference book that defines: Teradata PT command line utility commands. Object definition statements that make up the declarative section of a Teradata PT job script. The APPLY statement that makes up the executable section of a Teradata PT job script. Syntax for each Teradata PT operator. Teradata Parallel Transporter Quick Start Guide, Release

26 Appendix A: Teradata PT Publications Teradata PT Publications Publication Teradata Parallel Transporter User Guide B Contents Detailed strategies for planning, implementing, and debugging Teradata PT. The book includes chapters on: Writing Teradata PT template job scripts, the kind of job scripts illustrated in the Teradata Parallel Transporter Quick Start Guide Writing Teradata PT defined schema job scripts that: Move data to and from data targets Move data within the Teradata environment Describing individual Teradata PT operators and access modules Launching, managing, and troubleshooting a Teradata PT job 26 Teradata Parallel Transporter Quick Start Guide, Release 15.00