You are on page 1of 173

The SQL Quick Reference Guide Simplicity by Design

First Edition Tom Coffing Todd Carroll Michael J. Larkins Robert Hines Steve Wilmes

Published by Coffing Publishing

First Edition October, 2002 Written by Tom Coffing, Michael Larkins, Todd Carroll, Robert Hines, and Steve Wilmes Web Page: www.Tera-Tom.com and www.CoffingDW.com E-Mail address: Tom.Coffing@CoffingDW.Com
Teradata , NCR , and BYNET are registered trademarks of NCR Corporation, Dayton, Ohio, U.S.A., IBM and DB2 are registered trademarks of IBM Corporation, ANSI is a registered trademark of the American National Standards Institute. In addition to these products names, all brands and product names in this document are registered names or trademarks of their respective holders. Coffing Data Warehousing shall have neither liability nor responsibility to any person or entity with respect to any loss or damages arising from the information contained in this book or from the use of programs or program segments that are included. The manual is not a publication of NCR Corporation, nor was it produced in conjunction with NCR Corporation. Copyright 2002 by Coffing Publishing
All rights reserved. No part of this book shall be reproduced, stored in a retrieval system, or transmitted by any means, electronic, mechanical, photocopying, recording, or otherwise, without written permission from the publisher. No patent liability is assumed with respect to the use of information contained herein. Although every precaution has been taken in the prepa ration of this book, the publisher and author assume no responsibility for errors or omissions, neither is any liability assumed for damages resulting from the use of information contained herein. For information, address:

Coffing Publishing 7810 Kiester Rd. Middletown, OH 45042 International Standard Book Number:ISBN 0-9704980-4-7

Printed in the United States of America


All terms mentioned in this book that are known to be trademarks or service have been stated. Coffing Publishing cannot attest to the accuracy of this information. Use of a term in this book should not be regarded as affecting the validity of any trademark or service mark.

Acknowledgements and Special Thanks


I dedicate this book to my wife Leona, who is a great mother of my child ren and helped me build this business from the beginning. Tom Coffing

I dedicate this book to my parents, Steve and Joanne, and my grandmother who inspired me to write and publish my first book. Steve Wilmes

I would like to make a three fold dedication of this book: first,to my wife Kisha and my mother Linda Wash, the two most precious women and appreciated supporters in my life, to my grandparents James and Mary Hines who have also been a constant source of stability and strength, and finally, to all the data warehousing professionals out there learning and using Teradata while striving to enhance their careers and their lives. Much appreciation and best wishes to you all. Robert Hines

I dedicate this book to my parents Linda and Steve for their continual support, strength and inspiration. Thanks for always being there. Todd Carroll

We are all grateful to God for the knowledge to complete this book, the perseverance to see it through, the dedication of from all the team members and the drive to see it through to completion. Most of all, we have Tom Coffing to thank for his tireless leadership and coordination of all the resources involved in this effort. Mike Larkins

About the Author Tom Coffing


Tom is President, CEO, and Founder of Coffing Data Warehousing. He is an internationally known consultant, facilitator, speaker, trainer, and executive coach with an extensive background in data warehousing. Tom has helped implement data warehousing in over 40 major data warehouse accounts, spoken in over 20 countries, and has provided consulting and Teradata training to over 8,000 individuals involved in data warehousing globally. Tom has co- authored the following eight books on Data Warehousing: Secrets of the Best Data Warehouses in the World Teradata SQL - Unleash the Power Tera-Tom on Teradata Basics Tera-Tom on Teradata E-business Teradata SQL Quick Reference Guide - Simplicity by Design Teradata Database Design - Giving Detailed Data Flight Teradata Users Guide -The Ultimate Companion Teradata Utilities - Breaking the Barriers

Mr. Coffing has also published over 20 data warehousing articles and has been a contributing columnist to DM Review on the subject of data warehousing. He wrote a monthly column for DM Review entitled, "T eradata Territory". He is a nationally known speaker and gives frequent seminars on Data Warehousing. He is also known as "The Speech Doctor" because of his presentation skills and sales seminars. Tom Coffing has taken his expert speaking and data warehouse knowledge and revolutionalized the way technical training and consultant services are delivered. He founded CoffingDW with the same philosophy more than a decade ago. Centered around 10 Teradata Certified Masters this dynamic and growing company teaches every Teradata classes, provides world class Teradata consultants, offers a suite of software products to enhance Teradata data warehouses, and has eight books published on Teradata. Tom has a bachelor's degree in Speech Communications and over 25 ye ars of business and technical computer experience. Tom is considered by many to be the best technical and business speaker in the United States. He has trained and consulted at so many Teradata sites that students affectionately call him Tera- Tom. Teradata Certified Master Teradata Certified Professional - Teradata Certified SQL Specialist Teradata Certified Administrator - Teradata Certified Implementation Teradata Certified Developer Specialist Teradata Certified Designer

About the Author Mike Larkins


Mike graduated with a Bachelors of Science degree in Management Information Systems from Chapman University in Orange, California. His computer career spans 30 years in a variety of related positions: computer operations, programmer, systems analyst, operating systems support, consultant, and college instructor. Mike retired from NCR Corporation in April 2000 with 18 years of service. His career has involved work with a variety of computer systems and relational databases. The last 5 years with NCR were entirely focused on Teradata and customer education. Of the 15 courses that he taught for NCR, SQL was his favorite. Mike has been working with Coffing Data Warehouse since May of 2000 teaching courses and doing consulting. He earned his Teradata Masters by passing all 6 certification exams. His other book, Teradata SQL Unleash the Power was a best seller at Partners 2001. This book has also become the course manual for many of the SQL classes taught by Coffing Data Warehousing. Other Books: Teradata SQL Unleash the Power

Teradata Certified Master Teradata Certified Professional - Teradata Certified SQL Specialist Teradata Certified Administrator - Teradata Certified Implementation Teradata Certified Developer Specialist Teradata Certified Designer

About the Author Steve Wilmes


Steve Wilmes is our Chief Technical Officer at Coffing Data Warehousing. He is considered one of the best Teradata Data Warehousing experts when it pertains to education and consulting in the industry today. Steve is a recognized expert on NCR hardware, UNIX, Teradata Database Administration, Physical Database Design, Application Development, Load Utilities, and SQL. He is also renowned internationally for his knowledge and expertise in these fields as well. Steve recently completed several assignments involving Teradata training and education. These data warehousing customers represent numerous major industries across the communications, financial, pharmaceuticals, airlines, wireless, home improvement and technology sectors. The education that was delivered includes Teradata basics, SQL intermediate/advanced, physical database design, application development, load utilities, and database administration. Steve has also participated in several assignments involving consulting for two major NCR Teradata Data Warehousing Customers. Assignments included resolving critical data warehousing implementation, administration, and database conversions. A Teradata Certified Master and co- author of the Teradata SQL Quick Reference Guide Simplicity by Design, Teradata Database Design - Giving Detailed Data Flight, Teradata Users Guide -The Ultimate Companion, and Teradata Utilities - Breaking the Barriers , along with Steves motivation, enthusiasm, and strong business skills has provided him the ability to work successfully in all global business environments.

Teradata Certified Master Teradata Certified Professional - Teradata Certified SQL Specialist Teradata Certified Administrator - Teradata Certified Implementation Teradata Certified Developer Specialist Teradata Certified Designer

About the Author Todd Carroll


Todd Carroll comes to Coffing Data Warehousing with big-time Teradata field experience. Todd gained experience as the lead database administrator for Industrial Web Machines. Todd installed Teradata, led core product demonstrations, and handled SQL Query along with database optimization. He was responsible for all testing of Industrial Web Machines core product releases and development. Todd has also done Teradata consulting work for the largest data warehouse sites in the world. Todd has worked closely with users to develop SQL applications and has also been responsible for converting Oracle and Sybase data to Teradata in many data warehouse sites. He has developed a repeatable process for synchronizing the development warehouse with the production warehouse. He has experience with database design, scrubbing, converting, loading, scripting, and writing Teradata SQL. Todd combines great field experience with excellent technical expertise to deliver outstanding Teradata classes for CoffingDW. He is Teradata Certified Master, with all 6 Teradata certifications. Todd teaches Teradata Basics, Utilities, Beginning to Advanced SQL, and Teradata Physical Database Design. His ability to break down the most difficult of concepts into easy to understand thoughts offers his students the best route to Teradata certification. He has trained and consulted at many Fortune 100 companies with a 100% Teradata Certification pass rate from his students. His wide span of knowledge provides him the ability to be flexible in terms of Teradata training and consulting. As a Teradata DBA and consultant, Todd has developed leadership, technical skills, and a strong decision making background. Combined with his motivation, enthusiasm, perfectionism, and strong work ethic, his skills provide a great addition to the Coffing Data Warehousing team.

Teradata Certified Master Teradata Certified Professional - Teradata Certified SQL Specialist Teradata Certified Administrator - Teradata Certified Implementation Teradata Certified Developer Specialist Teradata Certified Designer

About the Author Robert Hines


After graduating Magna Cum Laude from Benedict College with over a 3.9 grade point average, Robert Hines has emerged as an outstanding IT professional and has serviced clients all over the United States and Canada. His most notable accomplishments are in the arenas of training, consulting and providing professional services as a programmer to numerous industries (Utility, Communications, Financial, Government, E- Busine ss, etc.), primarily in the Data Warehousing arena. Though he has extensive SQL experience with Oracle, DB2, Sybase and other database programming languages, it is his accomplishments in the Teradata world that he is most proud of. Robert's experience as a Sr. Software Engineer in NCR's E-Business Engineering Center of Expertise is the foundation of his Teradata knowledge and experience, and his successful quest to become a Teradata Certified Master. While serving NCR as a Sr. Software Engineer, Robert was recognized on numerous occasions for Outstanding Performance. Some of the awarded accomplishments included completing SQL and Load Utility tasks critical to successful product releases and mentoring contractors and employees on SQL, Load Utilities and Microstrategy. Along with successfully completing Microstrategy training courses, Robert served as a Project Lead on a MicroStrategy conversion project, and also achieved designations as a Teradata Certified Professional, SQL Specialist, and Implementation Specialist. The experience at NCR with Teradata and MicroStrategy helped prepare him for his enormously successful training and consulting career with Coffing Data Warehousing. As a trainer, course developer, consultant and author with Coffing Data Warehousing Robert Hines has achieved new levels of accomplishment. He has trained, taught and mentored hundreds of developers and business users across the country on both Teradata and Microstrategy. Robert has an uncanny ability to effectively teach non-experienced and highly experienced students at the same time while satisfying both audiences. Students rave about his fun and exciting classes that are full of interesting ways of explaining technical concepts with clarity and simplicity. Consulting clients love his technical aptitude and ability to finish the job in a professional, yet personable manner, along with his ability to build relationships and empower end users and IT staff through effective communication. His wish is that this book will aid him in his quest to impact and energize the careers of others in the industry through the power of teaching! Teradata Certified Master Teradata Certified Professional - Teradata Certified SQL Specialist Teradata Certified Administrator - Teradata Certified Implementation Teradata Certified Developer Specialist Teradata Certified Designer

The Quicker Reference Index

A
ACCESS LOCKING = ANY, NOT = ALL Abort Abort/Rollback Add Column Attributes ADD_MONTHS Advanced Syntax AFTER Triggers Aggregation ALIAS using NAMED Aliasing Columns ALL ALTER Table AND AND - Multiples AND/OR Combined AND/OR Comparators: ANSI INNER Join 92 10 100 100 110 48 86 130 27 14 13 10 113 5 6 5 4 40 BEFORE Triggers BETWEEN BT/ET

B 129 11 99 C Calendar Cartesian Product Join CASE CASE - Nested CASESPECIFIC CAST ANSI CHARACTERS COALESCE Collect Statistics Column and Table Constraints Column Concatenation Column Constraints Commit Work Concatenation Constraints Correlated Subquery COUNT CREATE DATABASE CREATE GLOBAL TEMP TABLE CREATE Macro Create Table CREATE USER Create View Syntax CROSS JOIN Syntax Cumulative Sum (CSUM) 51 42 85 88 24 21 52 84 118 111 57 111 100 57 111 36 31 120 127 93 105 121 89 45 59

ANSI OUTER JOIN Syntax 43 10 ANY 28 AVERAGE (AVG) AVG = ANY, NOT = ALL Abort/Rollback Add Column Attributes ADD_MONTHS Function Advanced Syntax AFTER Triggers Aggregation Functions ALIAS using NAMED Aliasing Columns ALTER Table ANSI INNER Join Syntax 28 10 100 110 48 86 130 27 14 13 113 40

ANSI OUTER JOIN Syntax 43 AVERAGE Function (AVG) 28

The SQL Quick Reference Guide Simplicity by Design

The Quicker Reference Index

D Data Definition Language Data Interrogation Date DATE Date and Time Processing Default Values DELETE Delete with a Join Delete with a Subquery Derived Tables DISTINCT DML Commands DROP DATABASE DROP Macro DROP STATISTICS DROP Table DROP TEMP TABLE DROP USER DROP Views E EXCEPT EXECUTE Macro EXISTS EXPLAIN EXTRACT Function F FALLBACK FORMAT 108 22 70 94 37 19 49 105 81 46 47 46 73 77 78 78 125 16 72 122 95 119 114 128 122 90

G Global Temporary Tables H HASHAMP HASHBAKAMP HASHBUCKET Hashing Functions HASHROW HAVING Clause HELP HELP STATISTICS Horizontal Reporting I IN and NOT IN INDEX Index Primary INDEX Function Indexes - Join Index Indexes - Secondary INNER Join ANSI INSERT INSERT / SELECT Inserting Default Values Inserting NULLs INSTEAD OF Triggers INTEGERDATE INTERSECT IS NOT NULL IS NULL 9 55 106 56 117 116 40 72 74 73 73 131 46 68 7 7 124 124 124 123 123 32 17 119 87 127

The SQL Quick Reference Guide Simplicity by Design

ii

The Quicker Reference Index

J Join ANSI Join ANSI INNER Join - Cartesian Product Join - Deletes Join Indexes JOIN Outer Join Syntax Join UPDATE Joins 40 40 42 78 117 43 38 76 38

N NAMED Nested CASE NOT = ALL NOT CASESPECIFIC NOT Clause NOT IN NULLIF NULLIFZERO O 14 88
10

25 8 9 82 81

L LIKE Clause Lock Syntax LOCKING FOR ACCESS Locking Modifiers LOWER M MACROS MAVG MAX MDIFF MIN MINUS Moving Average (MAVG) Moving Difference (MDIFF) Moving Sum (MSUM) MSUM MULTILOAD UPSERT Multiple Column Primary Index Multiple Subqueries Multiple WITH..BYs MULTISET Table 93 61 30 62 29 71 61 62 60 60 80 106 34 104 107 12 96 92 96 26 OLAP Functions OR OR Multiples OR/AND Comparators: ORDER BY Clause Original Join Syntax OUTER JOIN Syntax P 109 55 106 Primary Index - Multi-Column 106 Permanent Journal POSITION Primary Index Q Quantifiers QUANTILE 35 63 58 5 6 4 15 38 43

The SQL Quick Reference Guide Simplicity by Design

iii

The Quicker Reference Index

R RANDOM RANK RENAME Table REPLACE Macro REPLACE Views Reporting Totals/Subtotals Rollback S SAMPLE SAMPLEID Secondary Indexes SELECT Selecting the DATE Sequencing Triggers SET Table Set Operator Commands Setting the Trans Mode SHOW Sorting Statistics 65 65 116 2 47 132 107 67 99 18 66 64 115 95 91 102 100

T Table Constraints Temporary Tables Teradata Transaction Mode (BT/ET) Time TIME TIMESTAMP TITLE Totals (WITH) TPUMP UPSERT Transaction Mode Settings Transaction Mode Types Transaction Modes Transaction Processing Triggers Triggers - INSTEAD OF Triggers - Sequencing Triggers -AFTER Triggers BEFORE TRIM U,V,W,Z UNION UPDATE UPDATE with a Join UPDATE with a Subquery UPPER UPSERT User Information Functions Views Volatile Temporary Tables WHERE Clause WITH WITH..BY WITH..BYs - Multiples ZEROIFNULL 111 125 99 46 50 50 23 102 80 99 98 98 96 129 131 132 129 129 53 69 75 76 76 26 79 20 89 126 3 102 103 104 83

15 118 57 String/Column Concatenation String Concatenation 57 Subquery 33 36 Subquery - Correlated Subquery - Delete 78 Subquery UPDATE 76 54 SUBSTR SUBSTRING 54 Subtotals 102 103 Subtotals (WITH..BY) SUM 27 System Calendar Columns 51

IV

The SQL Quick Reference Guide Simplicity by Design

Table of Contents

TABLE OF CONTENTS

The Select Command ....................................................................................................................... 2


The WHERE Clause .................................................................................................................................... 3 Comparators: AND/OR ............................................................................................................................. 4
Combining Comparators: AND/OR ................................................................................................. 5 Combining Multiple AND Comparators or Multiple OR Comparators ................... 6

IS NULL Clause and IS NOT NULL Clause .......................................................................... 7 NOT Clause ......................................................................................................................................................... 8 IN and NOT IN ................................................................................................................................................. 9 = ANY, NOT = ALL .................................................................................................................................10 BETWEEN .........................................................................................................................................................11 LIKE Clause ......................................................................................................................................................12 Aliasing Columns .........................................................................................................................................13
ALIAS using NAMED
............................................................................................................................14

ORDER BY Clause .....................................................................................................................................15 DISTINCT ..........................................................................................................................................................16

Help, Show, Explain, User Information Functions

...........................17

HELP .......................................................................................................................................................................17 SHOW ....................................................................................................................................................................18 User Information Functions .................................................................................................................20


Default Database Command ................................................................................................................20 Account ..............................................................................................................................................................20 SELECT Database Command ............................................................................................................20 SESSION ..........................................................................................................................................................20

Data Conversions..................................................................................................................................21

CAST ANSI ..................................................................................................................................................21 Implied Cast Teradata ..........................................................................................................................21 FORMAT ............................................................................................................................................................22 Tricking the ODBC to Format ...........................................................................................................22 CASESPECIFIC ............................................................................................................................................24 NOT CASESPECIFIC .............................................................................................................................25 LOWER and UPPER .................................................................................................................................26

Aggregation Functions .................................................................................................................27


SUM Function .................................................................................................................................................27 AVERAGE Function .................................................................................................................................28 (AVG) .....................................................................................................................................................................28 MINIMUM Function (MIN) ...............................................................................................................29 MAXIMUM Function (MAX) ..........................................................................................................30
The SQL Quick Reference Guide Simplicity by Design V

Table of Contents

Joins..........................................................................................................................................................................38

COUNT Function (COUNT) ............................................................................................................31 HAVING Clause ...........................................................................................................................................32 Subquery ..............................................................................................................................................................33 Multiple Subqueries ....................................................................................................................................34 Quantifiers ..........................................................................................................................................................35 Correlated Subquery ...................................................................................................................................36 Exists .......................................................................................................................................................................37 Original Join Syntax ...................................................................................................................................38 ANSI INNER Join Syntax (Newer Syntax) ...........................................................................40 Cartesian Product Join ..............................................................................................................................42 ANSI OUTER JOIN Syntax ................................................................................................................43 CROSS JOIN Syntax .................................................................................................................................45

Date and Time Processing ......................................................................................................46


INTEGERDATE Formula ....................................................................................................................46 Selecting the DATE ....................................................................................................................................47 ADD_MONTHS Function ....................................................................................................................48 EXTRACT Function ..................................................................................................................................49 TIME and TIMESTAMP .......................................................................................................................50 System Calendar Columns ....................................................................................................................51

Character String Processing .................................................................................................52


CHARACTERS Function .....................................................................................................................52 TRIM Function ...............................................................................................................................................53 SUBSTRING and SUBSTR Functions ......................................................................................54 POSITION and INDEX Functions ................................................................................................55 INDEX Function ...........................................................................................................................................56 String and Column Concatenation .................................................................................................57

OLAP Functions ....................................................................................................................................58


Cumulative Sum Function (CSUM) .............................................................................................59 Moving Sum Function (MSUM) .....................................................................................................60 Moving Average Function (MAVG) ............................................................................................61 Moving Difference Function (MDIFF) ......................................................................................62 QUANTILE Function ...............................................................................................................................63 RANK Function .............................................................................................................................................64 SAMPLE Function and SAMPLEID ...........................................................................................65 RANDOM Function ...................................................................................................................................66

Set Operator Commands ............................................................................................................67


INTERSECT .....................................................................................................................................................68

VI

The SQL Quick Reference Guide Simplicity by Design

Table of Contents

UNION ..................................................................................................................................................................69 EXCEPT ...............................................................................................................................................................70 MINUS ..................................................................................................................................................................71

Data Manipulation Language Commands


Inserting NULL and Default Values

......................................................72

INSERT .................................................................................................................................................................72
..............................................................................................73

INSERT / SELECT .....................................................................................................................................74 UPDATE ..............................................................................................................................................................75


UPDATE with a Subquery ....................................................................................................................76 UPDATE with a Join ................................................................................................................................76

DELETE ...............................................................................................................................................................77
Delete with a Join ...................................................................................................................................78 Delete with a Subquery .......................................................................................................................78

UPSERT ...............................................................................................................................................................79
UPSERT for TPUMP and MULTILOAD

DATA INTERROGATION .................................................................................................81


NULLIFZERO ................................................................................................................................................81 NULLIF ................................................................................................................................................................82 ZEROIFNULL ................................................................................................................................................83 COALESCE ......................................................................................................................................................84 CASE ......................................................................................................................................................................85
Basic Syntax ...................................................................................................................................................85 Advanced Syntax .........................................................................................................................................86 Horizontal Reporting ................................................................................................................................87 Nested CASE .................................................................................................................................................88

..................................................................................80

Views......................................................................................................................................................................89

MACROS.........................................................................................................................................................93

Create View Syntax ....................................................................................................................................89 DROP Views ....................................................................................................................................................90 REPLACE Views .........................................................................................................................................91 LOCKING FOR ACCESS ....................................................................................................................92 CREATE Macro ............................................................................................................................................93 EXECUTE Macro ........................................................................................................................................94 REPLACE Macro .........................................................................................................................................95 DROP Macro ....................................................................................................................................................95

Transaction Processing ................................................................................................................96


Locking Modifiers
.......................................................................................................................................96

Lock Types ......................................................................................................................................................96 Lock Syntax ....................................................................................................................................................96

The SQL Quick Reference Guide Simplicity by Design

VII

Table of Contents

Transaction Modes

......................................................................................................................................98 ........................................................................................................................98 .............................................................................................................99

Transaction Mode Types

Setting the Transaction Mode

Teradata Transaction Mode (BT/ET) ............................................................................................99 Commit Work .............................................................................................................................................. 100 Abort/Rollback ............................................................................................................................................ 100 Rollback Work ............................................................................................................................................ 101

Reporting Totals and Subtotals ..................................................................................... 102


Totals (WITH) ............................................................................................................................................... 102 Subtotals (WITH..BY) ........................................................................................................................... 103 Multiple WITH..Bys ................................................................................................................................ 104

ROLLBACK WORK ; ....................................................................................................................................... 101

Data Definition Language ..................................................................................................... 105


Create Table
.................................................................................................................................................... 105

Multiple Column Primary Index ..................................................................................................... 106 SET | MULTISET Table ...................................................................................................................... 107 FALLBACK ................................................................................................................................................. 108 Permanent Journal .................................................................................................................................... 109 Add Column Attributes ......................................................................................................................... 110 Column and Table Constraints ......................................................................................................... 111 CREATE TABLE with copying an existing table .............................................................. 112

ALTER Table ................................................................................................................................................. 113 DROP Table .................................................................................................................................................... 114 RENAME Table .......................................................................................................................................... 115 Secondary Indexes ..................................................................................................................................... 116 Join Indexes ..................................................................................................................................................... 117 Collect Statistics .......................................................................................................................................... 118
HELP STATISTICS DROP STATISTICS
................................................................................................................................ 119 ............................................................................................................................... 119

CREATE DATABASE ......................................................................................................................... 120 CREATE USER ........................................................................................................................................... 121 DROP DATABASE or USER ......................................................................................................... 122 Hashing Functions ..................................................................................................................................... 123
HASHROW .................................................................................................................................................. 123 HASHBUCKET ......................................................................................................................................... 124 HASHAMP ................................................................................................................................................... 124 HASHBAKAMP ....................................................................................................................................... 124

Temporary Tables .............................................................................................................................. 125


Derived Tables .............................................................................................................................................. 125 Volatile Temporary Tables ................................................................................................................. 126

VIII

The SQL Quick Reference Guide Simplicity by Design

Table of Contents

Global Temporary Tables

.................................................................................................................... 127 ....................................................................... 127

CREATE GLOBAL TEMPORARY TABLE

DROP TEMPORARY TABLE

...................................................................................................... 128

Triggers.............................................................................................................................................................. 129
BEFORE Triggers ...................................................................................................................................... 129 AFTER Triggers .......................................................................................................................................... 130 INSTEAD OF Triggers .......................................................................................................................... 131 Sequencing Triggers ................................................................................................................................. 132

APPENDIX A: Current Reserved Words ...................................................... 133


Current Reserved Words (continued) ........................................................................................ 134 Current Reserved Words (continued) ........................................................................................ 135 Current Reserved Words (continued) ........................................................................................ 136 Future Reserved Words ......................................................................................................................... 137

APPENDIX B: Data Control Language (DCL)

................................... 138

Data Control Language (DCL) Statements ........................................................................... 138 Privileges ........................................................................................................................................................... 138 GRANT Statement .................................................................................................................................... 139 REVOKE Statement ................................................................................................................................. 140 GIVE Statement ........................................................................................................................................... 141

Appendix C: Data Types and Format Symbols ................................. 142


Format Symbols
........................................................................................................................................... 143

Appendix D: Mathematical Functions ............................................................ 146 Appendix E: Qualifying and Table Aliasing ......................................... 147
Qualifying Column Names ................................................................................................................. 147 Creating an Alias for a Table ............................................................................................................ 148

Appendix F: Stored Procedure Syntax ........................................................... 149

The SQL Quick Reference Guide Simplicity by Design

IX

Simplicity by Design

Preface

You miss 100% of the shots you don't take


Wayne Gretzky
Asking the right questions is half the battle to greatly impacting the companys bottom line, but sometimes knowing the proper SQL inhibits users from taking their shot at corporate greatness. This book is dedicated to assisting users in asking the right questions by providing an easy to understand guide that takes the difficulty out of SQL. The purpose of SQL Reference Guide Simplicity by Design is simple: Users need an easy and concise reference book at their fingertips that they can refer to, without having to search through larger books for SQL help. After the generic syntax, there are applied examples that have been written based on the SQL_CLASS database, which can be downloaded from our website at :

www.CoffingDW.Com .

The SQL Reference Guide Simplicity by Design follows this format for each command: SQL Command Easy lookup with a great INDEX in the back Short Definition Syntax Examples Examples explained Hint Man - Tips from pros Issues Common Mistakes Solutions to those issues

The standards for SQL Reference Guide are as follows: <database-name> Substitute an actual database name in this location <table -name> Substitute an actual table name in this location <comparison> Substitute a comparison in this location, i.e. a=1 <column- name> Substitute an actual column name in this location <data-value> Substitute a literal data value in this location [ optional entry ] Everything between the [ ] is optional, not required to be valid syntax , use when needed { use this | or this Use one of the keywords or symbols on either side of the | , } but not both. I.e. { LEFT | RIGHT } use either LEFT or RIGHT but not both

The SQL Quick Reference Guide Page 1

The SQL Reference Guide

The Select Command


The SELECT Command selects which columns are needed for the report (or answer set) and the tables that contain them. SELECT {*} FROM <table- name>;
SELECT * FROM Course_Table;

The asterisk returns every column in the table. The SELECT * relates to columns and the WHERE clause relates to rows selected. Hint - Man

Issues: The message, 3807: Table/view/trigger <table-name> does not exist. will occur when the table being selected from does not reside on Teradata. Or, you are in the wrong database. Solutions: Check the spelling of the <table -name>, use the SELECT DATABASE syntax to confirm you are in the correct database or HELP DATABASE <database-name> to see all objects in the database.

SELECT

{ <column-name> } [,<column-name> ] FROM <table- name>;


SELECT Customer_Number FROM Customer_Table;

SELECT Dept_No

,Dept_Name FROM Department_Table;


When requesting multiple columns in a table each column is separated from the next by a comma. Experienced users often place the comma at the beginning for easy debugging. Hint - Man

Issues: A missing comma could be a problem with this syntax. Here is the Error Message: 3810: Column Column1Column2 does not exist.

Solution: Search through the SQL code to locate the two columns with no comma between the two, and place a comma. Or you could have an extra comma at the end of the last column selected. Take the extra comma out.

Page 2 The SQL Quick Reference Guide

Simplicity by Design

The WHERE Clause


The WHERE clause eliminates certain ROWS from the result set and is used when users dont want to see every single row in a table.

SELECT

{ * | <column-name> } [,<column-name> ] FROM <table- name> WHERE { <column-name> | <expression> } <comparison> <data-value> ;

SELECT * FROM Employee_Table WHERE Dept_No = 400;

English: The above example will SELECT all columns from the Employee_Table if the employees department number is 400.

If a query has no WHERE clause then every row will be selected. If you want to access data as fast as possible use the Primary Index column in the WHERE clause. Hint - Man

Issues:

3535: A character string failed conversion to a numeric value. The <data -value> in the WHERE clause does not match the data type of the <column-name>. Also remember that numeric values are not in single quotes . Character data should be in single quotes.

Solu tions: The first thing to do is to find out the data type of the <column-name> involved by running HELP TABLE <table -name>. Next, adjust the <data -value> to match the data type.

The SQL Quick Reference Guide Page 3

The SQL Reference Guide

Comparators: AND/OR
Many times a single comparison in a WHERE clause is not enough to specify the desired rows. The AND/OR commands are called logical operators. The AND syntax requires both comparisons to be true . The OR syntax however, only requires one of the two to be true. SELECT <column- name> [,<column-name> ] FROM <table- name> WHERE <column-name> <comparison> <data- value> AND | OR <column- name> <comparison> <data-value>;

SELECT * FROM Order_Table WHERE Customer_Number = 11111111 AND Order_Total > 10000;

English: Above we select all columns if the customer number = 11111111 AND the Order_Total is greater than 10000. Both have to be true for data to come back. SELECT Product_Id, Daily_Sales FROM Sales_Table WHERE Sale_Date = 2000-09-28 OR Sale_Date = 2000-10-01;

English: Above we select two columns for any row that has a sale date of eit her September 28 2000 or October 1 2000. Only one of them has to be true.

Hint - Man

If you get a syntax error with an OR command it is probably because you did not name the column in the where clause twice. For example, you cant say WHERE DEPT_NO = 10 OR 20. You must say WHERE DEPT_NO = 10 OR DEPT_NO = 20.

Issues:

You get now rows coming back in the answer set

Solutions: Remember that when you use AND that you must utilize two different columns. For example, an employee could not have a SALARY of $50,000 AND $75,000. You could however have an employee in department 100 AND have a salary of $50,000.

Page 4 The SQL Quick Reference Guide

Simplicity by Design

Combining Comparators: AND/OR SELECT <column- name> [...,<column-name> ] FROM <table- name> WHERE (<column- name> <comparison> <data-value> OR <column- name> <comparison> <data-value> ) AND <column- name> <comparison> <data-value> ;

SELECT Last_Name, First_Name FROM Student_Table WHERE ( Class_Code = JR OR Class_Code = SO ) AND Grade_Pt > 2.5;

English: The above selects two columns if the student has a Class_Code of JR or SO and that JR or SO has a Grade_Pt above 2.5.

When there is an AND/OR combination the AND is always done first by Teradata unless the OR pair is in parentheses, like the above example. Hint - Man

Issues:

The data you expected to come back may not.

Solutions: You need to remember that when combining AND/OR comparators that Teradata will analyze the AND first unless you place parenthesis around the OR statements.

The SQL Quick Reference Guide Page 5

The SQL Reference Guide

Combining Multiple AND Comparators or Multiple OR Comparators

SELECT

<column- name> [...,<column-name> ] FROM <table- name> WHERE <column-name> <comparison> <data- value> AND | OR <column- name> <comparison> <data-value> AND | OR <column- name> <comparison> <data-value>

SELECT * FROM Student_Course_Table WHERE Student_Id = 280023 OR Student_Id = 333450 OR Student_Id = 231222;

English: Above we select every column from the row if the Student_Id is 280023 or 333450 or 231222.

SELECT Employee_No FROM Employee_Table WHERE Dept_No <> 400 AND Salary > 40000 AND Salary < 50000;

English: Above we select one column from the row if the Dept_No is not equal to 400 and the salary is greater than $40000, but less than $50000.

Dealing with NOT, AND an OR can be confusing. You can place parenthesis around the SQL and it will be evaluated first. Hint - Man

Hint - Man

Be careful when using multiple AND statements. Remember that ALL criteria must be met in order for the row to be returned in the result set. For example, a user should not search for a student with a Grade_pt of 3.0 and 4.0. This will not work because nobody can have a Grade_pt of both 3.0 and 4.0. An OR should have possibly been used.

Page 6 The SQL Quick Reference Guide

Simplicity by Design

IS NULL Clause and IS NOT NULL Clause


NULL data is often described as empty data , but it is actually undetermined data. Therefore you can never check if something is EQUAL to NULL. You can only check if something IS NULL or IS NOT NULL.

SELECT <column- name> [...,<column-name> ] FROM <table -name> WHERE <column-name>IS NULL

SELECT Last_Name, First_Name FROM Student_Table WHERE Grade_Pt IS NULL ;

English: Above we select two columns from any row that has a NULL value for Grade_pt. SELECT Last_Name, First_Name FROM Student_Table IS NOT NULL ;

WHERE Grade_Pt

English: Above we select two columns from any row that does NOT have a NULL value for Grade_pt.

Hint - Man

Sometimes when checking if something is = NULL you will get an error and sometimes you will not get an error, but no rows will be returned. When checking for NULLS the only valid statements are IS NULL or IS NOT NULL.

Issues: = NULL is not a valid SQL statement. Change the syntax to IS NULL. 3731: The user must use IS NULL or IS NOT NULL to test for NULL values.

Solution: Adjust the SQL syntax from =NULL to IS NULL or IS NOT NULL.

The SQL Quick Reference Guide Page 7

The SQL Reference Guide

NOT Clause
The NOT Clause will check for values that are NOT <, > or equal to a value searches for the logical opposite of the <comparison> statement. SELECT <column- name> FROM <table- name> WHERE <column-name> NOT<comparison> <data-value> ;
WHERE Seats SELECT Course_Name FROM Course_Table NOT >= 20;

. Teradata

English: Above we find all courses where there are less than 20 seats in the course. SELECT Customer_Name, Phone_Number FROM Customer_Table WHERE Customer_Name NOT= ACE Consulting; English: Above we SELECT two columns for all Customers except ACE Consulting.

Alternative Syntax: SELECT <column- name> FROM <table- name> WHERE NOT (<column-name> <comparison> <data- value>);
WHERE SELECT Course_Name FROM Course_Table NOT ( Seats >= 20 ) ;

SELECT Customer_Name, Phone_Number FROM Customer_Table WHERE NOT ( Customer_Name = ACE Consulting )

Running this syntax without parentheses is permissible, but not recommended. Hint - Man

Issues: Teradata returns the message: 3707: Syntax error, expected something like an IN keyword between the NOT keyword and <comparison>. This is a problem caused by the NOT not being properly placed in the SQL.

Solutions: Locate the NOT in the SQL and place it directly before the <column-name>, with the <comparison> after that.

Page 8 The SQL Quick Reference Guide

Simplicity by Design

IN and NOT IN
The IN comparison is an alternative to using one or more OR comparisons on the same columnin the WHERE clause of a SELECT. Teradata actually views the IN clause as a multiple OR statement. If the criteria are in the <value - list>, a row will be returned.

SELECT <column- name> [...,<column-name> ] FROM <table -name> WHERE <column-name> IN | NOT IN (<value -list>) ;
WHERE Dept_No SELECT Dept_Name, Mgr_No FROM Department_Table IN ( 200, 300,100 ) ;

English: Above we select two columns from each row where the Dept_no is 200 or 300 or 100. SELECT * FROM Order_Table WHERE Order_Number NOT IN (123585, 123456 ) ; English: Above we select all columns unless the Order_Number is 123585 or 123456. SELECT * FROM Department_Table IN( Sales , Marketing);

WHERE Dept_Name

English: Above we select all columns from the Department_Table if the department name is Sales or Marketing. Notice the single quotes around Sales and Marketing. They are not numbers so they need single quotes.

Do not place the word NULL in the <value-list> for a NOT IN, being that no rows will be returned every time. Hint - Man

Issues: 3706: Syntax error: expected something between an {integer | character-string} and ;. This error is caused by a lack of parentheses around the <value -list>.

Solutions: Place a ( before the <value -list> and a ) after the final entry in the <value list>.

The SQL Quick Reference Guide Page 9

The SQL Reference Guide

= ANY, NOT = ALL


The =ANYcommand is the logical equivalent to the command is similar to the NOT IN clause. SELECT <column- name> [...,<column-name> ] FROM <table -name> WHERE <column-name> = ANY (<value -list>);
WHERE Dept_No SELECT Dept_Name, Mgr_No FROM Department_Table = ANY ( 200, 300, 100) ;

IN clause . The

NOT = ALL

English: The above example selects two columns if the Dept_No is 200 or 300 or 100. This

is the same syntax as WHERE Dept_No IN (200, 300, 100).

SELECT <column- name> [...,<column-name> ] FROM <table -name> WHERE <column-name> NOT = ALL(<value - list>) ;
SELECT * FROM Order_Table WHERE Order_Number NOT = ALL ( 123585, 123456 ) ;

English: The above example will SELECT all columns WHERE the Order_Number does NOT = 123585 or 123456. This syntax is the same as NOT IN.

Be careful NOT to use NOT = ANY . This is because all rows will be returned unless they Are NULL. This is because the instance a value is not equal to any one in the list, it is Hint - Man automatically returned.

Issues: Missing the = sign is a possible problem. 3707: Syntax Error, expected something like an IN keyword or a LIKE keyword between the NOT keyword and the ALL keyword.

Solutions: Add the equal sign before the ANY keyword, or after the NOT keyword.

Page 10 The SQL Quick Reference Guide

Simplicity by Design

BETWEEN
The BETWEEN statement is another technique to request multiple values for a column that are all in a specific range. The key item to remember is that BETWEEN is inclusive and most widely used with numericvalues. If you write WHERE AGE is BETWEEN 13 and 15 then the answer set would contain individuals whose ages are 13, 14, or 15.

SELECT <column- name> [...,<column-name> ] FROM <table -name> WHERE <column-name>BETWEEN <low-value> AND <high-value>;

SELECT * FROM Sales_Table WHERE Daily_Sales BETWEEN 25000 AND 42000 ;

English: Select all columns where the Daily_Sales is between 25000 and 42000. This includes 25000 exactly and 42000 exactly. SELECT Last_Name, First_Name, Grade_Pt FROM Student_Table WHERE Last_Name BETWEEN Delaney and Phillips ;

English: Select three columns where the Last_Name is between Delaney and Phillips. This includes Delaney, Phillips and any name alphabetically greater than Delaney and Less than Phillip s.

Hint - Man

BETWEEN is a command to look for ranges. BETWEEN works well with dates. If you index a date field in a table you can use the ORDER BY VALUES syntax when creating the date index. Then BETWEEN and DATE ranges work in tandem. To see if a d ate is an index ORDERED BY VALUES run the SHOW TABLE <Tablename> command.

The SQL Quick Reference Guide Page 11

The SQL Reference Guide

LIKE Clause
The LIKE Command searches character data strings and can use wildcards to find data that is similar. For example, a user can use the LIKE command to request rows where the last_na me starts with SM. SELECT <column- list> FROM <table -name> WHERE <column-name>LIKE [<wildcard(s)>]<search-string>[<wildcard(s)>];
The wildcard characters are: Wildcard symbol What it does _ (underscore) matches any single character, but a character must be present % (percent sign) matches any single character, a series of characters or the absence of characters

SELECT Course_Name, Course_Id FROM Course_Table WHERE Course_Name LIKE %SQL ;

English: Select two columns from the rows in the course table if Course_Name has SQL at the end of the string.
SELECT * FROM Student_Table

WHERE Last_Name

LIKE _m% ;

English: Select all columns from the rows in the Student table if Last_Name has an m as the second character.

Hint - Man

LIKE works on Character Data. If I have a name that is CHAR(10) and a name such as Smith then the system sees the name as Smith . Notice the 5 extra spaces. You can use the TRIM function with the LIKE function to find anyone whose name ended in h. SELECT * FROM Student_Table WHERE TRIM(Last_Name) LIKE %h;

Issues: The LIKE statement is not returning all the rows expected to be in the result set. More than likely you are dealing with Character strings of CHAR data type. Remembe r Smith in the eyes of Teradata is Smith+ empty space. This empty space resides in the rest of the fixed data space on the system.

Solutions: There are two solutions to this problem. The first solution is to place a % at the end of the <search-string>, as in the second example. The second solution would be to place the <column-name> in a TRIM function as so: TRIM(<column-name>. Either solution will take care of the problem.

Page 12 The SQL Quick Reference Guide

Simplicity by Design

Aliasing Columns
You create an ALIAS on a column for the purpose of giving the column a new name . You might do this to shorten the name or to better describe a title you want to see as a column header. If you ALIAS and use a reserved word such as SELECT place double quotes around it. In giving a column an alias, there are two options: ANSI Standard: SELECT <column- name> FROM <table- name>; Teradata Standard: SELECT FROM <column- name> < alias-name > <table- name>;
SELECT Dept_No ,Dept_Name ,Mgr_No FROM Department_Table ORDER BY Department Name; AS DEPT AS Department Name Manager

AS <alias-name>

English: We have aliased three columns. The first column does not need double quotes. The second column needs them because there is a space between Department and Name. The third ALIAS does not have the word AS. The word AS is optiona l when aliasing. Also notice we are sorting by Department Name. We once again use the double quotes.

Hint - Man

If a user desires to assign an alias with a space like Department Name, be sure to use double quotes around the alias name, otherwise you dont need the quotes. For example, Department_Name does not need quotes.

Issues: A common error is using a Teradata Reserved Word for an alias. 3707: Syntax Error, expected something like a name between the {AS | NAMED} keyword and the <reserved-word> keyword.

Solutions: You can place double quotes around the ALIAS name and it is no longer considered a keyword in the query. For example, if you had an ALIAS named MAX you could place double quotes around it to become MAX.

The SQL Quick Reference Guide Page 13

The SQL Reference Guide

ALIAS using NAMED Teradata Extension that is used to alias a column. Once you use the NAMED command you must refer to the column with its new name. You can also sort by the new name.

SELECT <column- name> FROM <table- name> ;

( NAMED <alias -name> )

SELECT Dept_No, Dept_Name (NAMED Department Name) FROM Department_Table;

English: The above example is aliasing Dept_Name as Department Name. Notice the double quotes. This is because there is a space between Department and Name. If the alias had been Department_Name we would not need the double quotes.

Hint - Man

Some time after Teradata V2R5 this function will no longer be available. Remember to place double quotes around any aliases with spaces in them, or if they are Teradata Reserved Words.

Issues: A common error is using a Terada ta Reserved Word for an alias. 3707: Syntax Error, expected something like a name between the {AS | NAMED} keyword and the <reserved-word> keyword.

Solutions: For reserved word errors place double quotes around the ALIAS name and Teradata will accept the ALIAS. For example, if you had an ALIAS named MAX you could place double quotes around it to become MAX.

Page 14 The SQL Quick Reference Guide

Simplicity by Design

ORDER BY Clause
Teradata brings back data unsorted unless you use the ORDER BY statement. The ORDER BY statement will sort the given <column-name> in the desired order default for Teradata isascending order. . The

SELECT <column- name> [...,<column-name>] FROM <table- name> ORDER BY { <column-name> | <relative-column-number> } [ ASC | DESC ] ; {, <column-name> | <relative-column-number> } [ ASC | DESC ]

SELECT Course_Id, Course_Name FROM Course_Table ORDER BY 1 ; English: The above will sort by the first column in the list which is the same thing as stating ORDER BY Course_Id .

SELECT Customer_Number, Order_Number, Order_Total FROM Order_Table ORDER BY Customer_Number DESC, Order_Number

English: The above will sort by the Customer_Number in Descending order as the first sort key and then Order_Number as the second order key. ASC is the default.

Hint - Man

Teradata allows the ORDER BY statement to use a column name or number. If you ORDER BY 1 for example Teradata will order by the first column in your select list. If you said ORDER BY 1 and your select list was SELECT * then Teradata will ORDER BY the 1 s t column in the table.

Issues:

3637: Invalid ORDER BY constant. This error occurs when using the number of a column rather than its name in the ORDER BY clause. In most cases the number used is larger than the actual count of columns involved in the query.

Solutions: Identifying how many columns should be returned to the result set is the first thing to do. Next, find the proper number for the column, or columns desired in the ORDER BY and adjust the SQL.

The SQL Quick Reference Guide Page 15

The SQL Reference Guide

DISTINCT
If there are duplicate values in <column-name> Teradata will return all rows. Distinct allows the user toeliminate all the duplicatesand only return one instance of that value.

SELECT DISTINCT <column- name> [, <column-name> ] FROM <table- name>;

SELECT DISTINCT Student_Id FROM Student_Course_Table;

English: SELECT every distinct Student_Id from the Student_Course_Table. No duplicate Student_Ids will be returned. SELECT DISTINCT First_Name, Dept_No FROM Employee_Table ;

English: SELECT every distinct combination of First_Name and Dept_No. For example, Mary in Dept_No 10 is different than Mary in Dept_No 20. Both would be returned.

Hint - Man

This is a useful function but this may cause inaccurate results. The issue with DISTINCT is that it affects all the columns desired in the result set. If there are two columns in the query, Teradata will search for a unique combination of both. In the second example, the rows returned will be any distinct combinations of First_Name and Dept_No.

Hint - Man

Often users will either use DISTINCT or GROUP BY for the same purpose. DISTINCT Is faster when there are only a few duplicates and GROUP BY is faster when there are Many duplicates.

Page 16 The SQL Quick Reference Guide

Simplicity by Design

Help, Show, Explain, User Information Functions


HELP
The Help Function returns important informationregarding the object specified in the SQL. Results include columns involved in the object, the data type, parameters passed, table and column comments, etc. HELP <OBJECT> <Object Name>;
Object Choices: Database User Table Volatile Table View Macro Procedure Trigger Column Index Statistics Session

HELP Database SQL_CLASS;

HELP Table SQL_CLASS.Student_Table;

HELP Column Course_Table.Course_Name;

HELP Session;

HELP SQL | <Function>;

HELP SQL Create;

HELP SQL Explain;


Issues: A common problem is that an object does not exist. not exist . Object <object-name> does

Solutions: The easiest and quickest solution is to execute the HELP DATABASE <databasename> command to see what objects are in the database. You might have misspelled the object name or are pointing to the wrong database. The HELP SESSION command will tell you what Database you are currently in.

The SQL Quick Reference Guide Page 17

The SQL Reference Guide

SHOW
Teradata will return the actual DDL/Create Text for the given object in the SQL. This is handy if a user needs to create an object identical or similar in structure. You can also use this to see what indexes are on a table. SHOW<OBJECT> <object name>;
Object Choices: Table View Macro Trigger Procedure

SHOW Table Department_Table;

SHOW View Department_Table_v;

SHOW Macro SQL_CLASS.Department_Count_m;

SHOW Trigger Update_Department_t;

SHOW Procedure Department_Count_p;

Issues: Object does not exist error code:

<object-type> <object-name> does not exist.

Solutions: The first item is to check the spelling of the <object-name> to ensure proper spelling. The next choice is to simply run the HELP DATABASE <databasename> command to get a list of all the objects in the database where you believe the object is located. You can also see which da tabase you are currently point to with the HELP SESSION command.

Hint - Man

The SHOW command is great if you want to see columns definitions, what indexes are defined, and any constraints in the table. If you have to change a view, macro, or stored procedure with the replace command it is a great idea to do the show command and then copy the current structure to make the necessary changes.

Page 18 The SQL Quick Reference Guide

Simplicity by Design

EXPLAIN
Returns the Optimizers plan of how the Teradata system will perform the given SQL request. This plan will include information on indexes being used, estimated time for query execution, estimated range of rows returned, and information about the spool space used during the query. EXPLAIN<SQL command>;

EXPLAIN SELECT * FROM Student_Course_Table;

EXPLAIN SELECT last_name, first_name FROM Employee_Table WHERE Salary > 45000;

EXPLAIN SELECT Customer_Number, Customer_Name FROM Customer_Table AS a INNER JOIN Order_Table AS b ON a.customer_number = b.customer_number;

Hint - Man

It is always recommended to run an EXPLAIN on any new query involving large tables, or vital tables that are frequently accessed. The EXPLAIN will also tell you the strategy for joins or the indexes being utilized for a particular query.

The SQL Quick Reference Guide Page 19

The SQL Reference Guide

User Information Functions


Default Database Command Moves the scope of the user from one database to <Database Name>. This command can eliminate the need to qualify a table in a certain database.

Database <Database Name>;

DATABASE SQL_CLASS;

Account Returns the account numberfor the current user you are logged in as.
Select ACCOUNT ;

SELECT Database Command This command displays the database that the user is currently located.
Select DATABASE ;

SESSION Retrieves the session numberabout the current user.


Select SESSION ;

Page 20 The SQL Quick Reference Guide

Simplicity by Design

Data Conversions
CAST ANSI
Cast is an ANSI standard function that converts a <column-name> from one data type for another . This allows for flexibility in creating reports and performing calculations on non-like data type columns. SELECT CAST(<column-name>AS <data-type>[(<length>)] ) FROM <table- name> ;
SELECT CAST(Student_id as CHAR(10)) FROM Student_Table; English: The example above will SELECT the Student_id from the Student_Table and display it as a Character 10 data type. The actual table is unaffected.

Implied Cast Teradata


This is a Teradata Extension for the ANSI Cast function. It transforms a <column-name> to another data type to easier perform calculations and reporting. SELECT <column- name> ( <data-type> [(<length>)] FROM <table- name>;
SELECT Student_id (CHAR(10)) FROM Student_Table;

Be careful because the results may vary between the Implied Cast and ANSI Standard CAST. Hint - Man

Issues: When using these syntaxes a user may run into this error message: 2617: Overflow occurred computing an expression involving <table-name>.<column -name> . This tells the user that the <data -type> the <column-name> is being cast to is not large enough to accommodate the transformation.

Solutions: The best solution would be to perform a HELP TABLE <table -name> to discover the actual data type of the <column-name>. Once that is established, choose a proper sized data type to transform the <column-name> and change the SQL.

The SQL Quick Reference Guide Page 21

The SQL Reference Guide

FORMAT
Formatting is mainly used to make the reporting of the data easier to read. This is a key way to truncate data when using a tool like BTEQ, but truncation will not work in ANSI mode. SELECT <column- name>(FORMAT <format-scheme>) FROM <table- name>;

SELECT Customer_Number (FORMAT 99999999) , Order_date (FORMAT YYYY-MM-DD) FROM Order_Table;

English: The above example will SELECT two columns from the Order_Table and format the Customer_Number as 99999999 and Order_Date as YYYY-MM-DD.

Hint - Man

Remember when using Queryman the FORMAT function will not be acknowledged by the ODBC driver and therefore wont work. Refer to the following sub-section titled Tricking the ODBC to Format. We have found a way to get the FORMAT function to work in Queryman.

Tricking the ODBC to Format


Tricking the ODBC is important to know because most users work with applications that communicate with Teradata using ODBC. This trick is essential in making data format in the desired manner. SELECT CAST( (<data>(FORMAT <format- string ) ) AS CHAR(<length>) ) FROM <table- name>;
SELECT FROM Student_Table; CAST(( Student_Id (FORMAT X(10))) AS CHAR(10))

English: The example above will CAST the student_Id as a Character 10. This will allow for the format statement to work with Queryman. Anytime you want the format statement to work in Queryman you can cast the result as a character.

Hint - Man

The Format statement works in BTEQ. Although it will NOT cause an error in Queryman The Format will not take in Queryman. By casting the results as character data the format will work in Queryman. This is a great tip.

Page 22 The SQL Quick Reference Guide

Simplicity by Design

TITLE
This syntax changes the name of a <column-name> only in the heading of the result set , not as the SQL itself. It does not perform like creating an alias.

SELECT <column- name> , <column- name> FROM <table -name>;

(TITLE Column title to appear in output) (TITLE Level 1 // Level 2 // Level 3)

SELECT Student_id ,Grade_Pt FROM

(TITLE Student // Identification) (TITLE GPA) Student_Table;

English: The above example will TITLE the student Id as Student on the top line and Identification on the bottom. This is how you stack and can have up to 3 stacks. The stacking feature does not work in Queryman. The Grade_Pt will have a TITLE of GPA. Sometime s Queryman does not always TITLE what you want.

TITLE is more functional in BTEQ due to the ability to stack the Title in the column header, which Queryman cannot do. TITLE is only used to Title a column. You can give a column both a Title and an Alias. The Title is for the title and the Alias is a new way to refer to the column. You can sort with the ALIAS name, but NOT the Title. Hint - Man

Issues: A common error message when dealing with TITLE is, 3707: Syntax error, expected something like a string between the TITLE keyword and the word Column title to appear in output. Teradata is saying that your title needs single quotes around it.

Solutions: The solution is simple: Place single quotes around the title.

The SQL Quick Reference Guide Page 23

The SQL Reference Guide

CASESPECIFIC
Forces Teradata to compare the given data values with between lower case and upper case characters. awareness of the difference

SELECT <column- name> [...,<column-name>] FROM <table- name> WHERE <column-name>( CASESPECIFIC) ={<character-literal> | <column- name>};

SELECT Customer_Name, Customer_Number FROM Customer_Table WHERE Customer_Name (CASESPECIFIC) = ACE Consulting ;

English: The above makes Customer_Name CASESPECIFIC so the comparison of Customer_Name must be equal to ACE Consulting with exact upper and lower case characters.

CASESPECIFIC is usually utilized in ANSI mode because ANSI is Case Specific. Teradata Mode is NOT Case Specific so Teradata sees abc exactly the same as ABC. ANSI Mode does not see abc as the same thing as ABC. Hint - Man

Issues: <word2>.

3706: Syntax error: expected something between the word <word1> and This error message usually indicates the lack of single quotes around the <character-literal> in the SQL.

Solutions: Locate the <character-literal> string in the code and place single quotes around it.

Page 24 The SQL Quick Reference Guide

Simplicity by Design

NOT CASESPECIFIC
Turns off the need to test for upper case or lower case characters. This only needs to be used while a user is inANSI Mode .

SELECT <column- name> [...,<column-name>] FROM <table- name> WHERE <column-name> ( NOT CASESPECIFIC) = { <character-literal> | <column- name> };

SELECT Customer_Name, Customer_Number FROM Customer_Table WHERE Customer_Name (NOT CASESPECIFIC) = ACE Consulting ;

English: The above makes Customer_Name NOT CASESPECIFIC so the comparison of Customer_Name must equal ACE Consulting, but without exact upper and lowercase characters.

NOT CASESPECIFIC is usually utilized in ANSI mode because ANSI is Case Specific. Teradata Mode is NOT Case Specific so Teradata sees abc exactly the same as ABC. ANSI Mode does not see abc as the same thing as ABC. Hint - Man

Issues: <word2>.

3706: Syntax error: expected something between the word <word1> and This error message usually indicates the lack of single quotes around the <character-literal> in the SQL.

Solutions: Locate the <character-literal> string in the code and place single quotes around it.

The SQL Quick Reference Guide Page 25

The SQL Reference Guide

LOWER and UPPER


The Lower Function changes all the characters in <column- name> to lower case before any testing is performed. The Upper Function transforms all the characters in <columnname> to uppercase prior to any testing of criteria.

SELECT LOWER(<column- name>) FROM <table- name> [WHERE LOWER(<column- name>) = { <character-literal> | <column- name> }];

SELECT LOWER (Course_Name) FROM Course_Table WHERE LOWER (Course_Name) = database administration ;

English: The above example will display Course_Name in lower case and in the WHERE clause the comparison of Course_Name will be converted to lowercase before the comparison. SELECT FROM Department_Table; LOWER(Dept_Name)

English: The above example will SELECT Dept_Name from the Department_Table and display the Dept_Name in all lowercase.

SELECT UPPER(<column- name>) FROM <table- name> [WHERE UPPER(<column- name>) = { <character-literal> | <column- name> }];
SELECT UPPER(Course_Name) FROM Course_Table WHERE Upper(Course_Name) =DATABASE ADMINISTRATION

English: The Course_Name that is selected will be displayed in UPPER Case. The WHERE clause will also convert Course_Name to UPPER Case in the comparison.

SELECT FROM Department_Table;

UPPER (Dept_Name)

English: The Dept_Name will be displayed in uppercase.

Page 26 The SQL Quick Reference Guide

Simplicity by Design

Aggregation Functions
The focus of aggregates is to summarize the values of data in a given column. Aggregates produce one- line answers for SUM, MAX, MIN, AVG, and COUNT. The main thing to remember is that aggregates remove any type of detail on that column. Its important to know that all the aggregate functions ignore NULL values in the respective calculations.

SUM Function
A user performs this function to that final value in the result set. add up all the values in the <column- name> and returns

SELECT SUM(<column-name>) [...,<column-name>] FROM <table- name> [WHERE <column- name> <comparison> <value>] [GROUP BY <column- name>] [ORDER BY <column-name>];
SELECT SUM(Budget) FROM Department_Table;

SELECT Dept_No,

SUM(Salary) FROM Employee_Table GROUP BY Dept_No ;

SUM(Daily_Sales) , Product_Id FROM Sales_Table GROUP BY 2 ORDER BY Product_Id; SELECT


GROUP BY is used when a non-aggregate column is in the Select Statement. All nonaggregate columns are required to be in the GROUP BY Statement. The GROUP By statement will allow you to get aggregates for each GROUP. Hint - Man

Issues: The most common error with Aggregates is not using GROUP BY with nonaggregate columns. 3504: Selected non-aggregate values must be part of the associated group.

Solutions: Search through the SQL and find all the columns that are not involved in aggregate functions. We call these non-aggregates. Next, write a GROUP BY statement with all the non-aggregate columns, with the desired sequence of grouping. Column names or numbers are admissible.

The SQL Quick Reference Guide Page 27

The SQL Reference Guide

AVERAGE Function (AVG)


Teradata returns a calculated average on the given <column- name>. This calculation, like all other aggregates, is not affected by NULL va lues. SELECT AVG(<column-name>) [...,<column-name>] FROM <table- name> [WHERE <column- name> <comparison> <value>] [GROUP BY <column- name>] [ORDER BY <column-name>];
SELECT AVG(Budget) FROM Department_Table;

SELECT Dept_No, GROUP BY 1 ;

AVG(Salary)FROM Employee_Table

AVG(Daily_Sales) , Product_Id FROM Sales_Table GROUP BY Product_Id ORDER BY Product_Id; SELECT

English: In the above examples you see that we are looking for the Averages as our chosen aggregate. Also notice in some of the examples we are also looking for Dept_No or Product_Id. These are non-aggregates and so the Group By statement must be used.

GROUP BY is used when a non-aggregate column is in the Select Statement. All nonaggregate columns are required to be in the GROUP BY Statement. The GROUP By statement will allow you to get aggregates for each GROUP. Hint - Man

Issues: The most common error with Aggregates is not using GROUP BY with nonaggregate columns. 3504: Selected non-aggregate values must be part of the associated group.

Solutions: Search through the SQL and find all the columns that do are not involved in aggregate functions. We call these non-aggregates. Next, write a GROUP BY statement with all the non-aggregate columns, with the desired sequence of grouping. Column names or numbers are admissible.

Page 28 The SQL Quick Reference Guide

Simplicity by Design

MINIMUM Function (MIN)


This function searches through all the values of the <column- name> and returns the smallest value to the result set. SELECT MIN(<column-name>) [...,<column-name>] FROM <table- name> [WHERE <column- name> <comparison> <value>] [GROUP BY <column- name>] [ORDER BY <column-name>];
SELECT MIN(Budget) FROM Department_Table;

SELECT Dept_No, GROUP BY 1 ;

MIN(Salary) FROM Employee_Table

MIN(Daily_Sales) , Product_Id FROM Sales_Table GROUP BY Product_Id ORDER BY Product_Id; SELECT

English: Notice that in our last two examples we are using the Group By statement because we have non-aggregates in Dept_No and Product_Id. Notice that we can say Group By 1 meaning the first column in our select list or GROUP BY Product Id actually specifying the name.

GROUP BY is used when a non-aggregate column is in the Select Statement. All nonaggregate columns are required to be in the GROUP BY Statement. The GROUP By statement will allow you to get aggregates for each GROUP. Hint - Man

Issues: The most common error with Aggregates is not using GROUP BY with nonaggregate columns. 3504: Selected non-aggregate values must be part of the associated group.

Solutions: Search through the SQL and find all the columns that do are not involved in aggregate functions. We call these non-aggregates. Next, write a GROUP BY statement with all the non-aggregate columns, with the desired sequence of grouping. Column names or numbers are admissible.

The SQL Quick Reference Guide Page 29

The SQL Reference Guide

MAXIMUM Function (MAX)


Aggregate function that will return the l argest value in the <column- name> of the MAX function. SELECT MAX(<column-name>) [...,<column-name>] FROM <table- name> [WHERE <column- name> <comparison> <value>] [GROUP BY <column- name>] [ORDER BY <column-name>];

SELECT MAX(Budget) FROM Department_Table; SELECT Dept_No, MAX(Salary) FROM Employee_Table GROUP BY Dept_No ;

MAX(Daily_Sales) , Product_Id FROM Sales_Table GROUP BY 2 ORDER BY Product_Id; SELECT

GROUP BY is used when a non-aggregate column is in the Select Statement. All nonaggregate columns are required to be in the GROUP BY Statement. The GROUP By statement will allow you to get aggregates for each GROUP. Hint - Man

Issues: The most common error with Aggregates is not using GROUP BY with nonaggregate columns. 3504: Selected non-aggregate values must be part of the associated group.

Solutions: Search through the SQL and find all the columns that do are not involved in aggregate functions. We call these non-aggregates. Next, write a GROUP BY statement with all the non-aggregate columns, with the desired sequence of grouping. Column names or numbers are admissible.

Page 30 The SQL Quick Reference Guide

Simplicity by Design

COUNT Function (COUNT)


This function performs a count of the number of values in the <column-name> that exist. A COUNT(*) will be sure to include all NULLs, with it counting the number of rows, not the number of values in a column.

SELECT COUNT(<column-name>) [...,<column-name>] FROM <table- name> [WHERE <column- name> <comparison> <value>] [GROUP BY <column- name>] [ORDER BY <column-name>];

SELECT COUNT(*) FROM Department_Table;

SELECT Dept_No,

COUNT(Salary) FROM Employee_Table GROUP BY Dept_No ;

COUNT(Daily_Sales) , Product_Id FROM Sales_Table GROUP BY 2 ORDER BY Product_Id; SELECT

GROUP BY is used when a non-aggregate column is in the Select Statement. All nonaggregate columns are required to be in the GROUP BY Statement. The GROUP By statement will allow you to get aggregates for each GROUP. Hint - Man

Issues: The most common error with Aggregates is not using GROUP BY with nonaggregate columns. 3504: Selected non-aggregate values must be part of the associated group.

Solutions: Search through the SQL and find all the columns that do are not involved in aggregate functions. We call these non-aggregates. Next, write a GROUP BY statement with all the non-aggregate columns, with the desired sequence of grouping. Column names or numbers are admissible.

The SQL Quick Reference Guide Page 31

The SQL Reference Guide

HAVING Clause
The HAVING clause serves the same purpose of the WHERE clause by eliminating certain rows from the result set. Teradata performs the aggregate functions, then HAVIN G serves as afinal filterbefore the results are returned.

SELECT <aggregate- function> (<column-name>) [...,<column-name>] FROM <table- name> ; HAVING <limiting -constraint>

SELECT Dept_No, SUM(Salary) as Total_Sal , AVG(Salary) FROM Employee_Ta ble HAVING Total_Sal > 120000 GROUP BY Dept_No;

English: In the above example we are selecting Dept_No (a non-aggregate) and SUM of Salary and AVG of Salary. We are using the GROUP BY statement on the Dept_No and getting our aggregates for every Dept_No. Then the Having statement will check the SUM(Salary) for a final check to see if the SUM(Salary) aliased as Total_Sal is greater than 120000. If not the group is eliminated.

WHERE and HAVING are similar but different. WHERE eliminates the base rows selected for calculation. HAVING has no effect on the base rows. HAVING waits until the aggregate calculation is complete and then eliminates any groups who dont meet the HAVING condition. The HAVING clause is the WHERE clause for aggregate groups. Hint - Man

Page 32 The SQL Quick Reference Guide

Simplicity by Design

Subquery
Subqueries are queries that retrieve information and pass that information to other parts of the query as a list of values. You can have multiple subqueries in a query. Normal Subqueries run the bottom query first which passes a list of values to the top query. The main indicator of a subquery is the WHERE IN or WHERE NOT IN clause. SELECT <column- name> [...,<column-name>] FROM <table -name> WHERE <column-name>[..., <column-name> ] [ NOT ] IN ( SELECT <column-name> [,<column-name> ] FROM <table-name> [ WHERE <column-name>[, <column-name> ] );
SELECT Employee_No, Last_Name, First_Name Dept_No IN (SELECT Dept_No FROM Department_Table ; WHERE Dept_Name LIKE Sale%)
Teradata allows a maximum of 63 subqueries in one SQL statement. Each subquery passes a list of values to be used by the query above.

FROM Employee_Table WHERE

Hint - Man

Issues: If your query is not bringing back any rows you may have made a logical mistake. The biggest logical mistake with a subquery involves the borders between the top and bottom query. Here is an example of a correct subquery. Make sure you have the bolded areas a Primary Key in one table and a Foreign Key in another table.
SELECT * FROM Student_Table WHERE (SELECT WHERE Credits > 3); Student_Id IN Student_Id FROM Student_Course_Table

Solution: Make sure your bottom query is passing values to the top query that match. If you are using different tables for the two queries then the bolded values need to be from the same domain. In other words match apples with apples and in most cases the columns will be a Primary Key in one table and a Foreign Key in another table.

The SQL Quick Reference Guide Page 33

The SQL Reference Guide

Multiple Subqueries
Multiple Subqueries can have as many as 63 separate subqueries Teradata is one more reason why Teradata is the Best in the World! SELECT <column- name> [...,<column-name>] FROM <table -name> WHERE <column-name>[..., <column-name> ] [ NOT ] IN ( SELECT <column-name> [,<column-name> ] FROM <table- name> [ WHERE <column- name>[, <column- name> [ NOT ] IN ( SELECT <column-name> [,<column-name> ] FROM <table-name> [ WHERE <column-name>[, <column-name> ]; )); . This flexibility in

SELECT Last_Name, First_Name FROM Student_Table WHERE Student_Id IN (SELECT Student_Id FROM Student_Course_Table WHERE Course_Id IN (SELECT Course_Id FROM Course_Table WHERE Course_Name = Teradata Concepts))

When developing code for multiple subqueries, keep in mind how they are processed: from the ground up. The last subquery is performed first and sends the result set to the subquery above it. Hint - Man

Issues: A missing parentheses is one of the most common errors when dealing with subqueries. Always be sure that each ( has a matching ) in the SQL. The error for a missing parentheses may look like this: 3707: Syntax error, expected something like an EXCEPT keyword or an UNION keyword or a MINUS keyword or ) between ) and ;.

Solutions: The best means of solving this issue is to start with the first ( and find the ) that is paired with it. Then move to the second ( and find its partner ), and continue this process until all the ( have a paired up ). If there is a ( with no pair place a ) at the end of the SQL before the semi-colon.

Page 34 The SQL Quick Reference Guide

Simplicity by Design

Quantifiers
These symbols serve as replacementsfor the IN or NOT IN clause. SELECT <column- name> [...,<column-name>] FROM <table -name> WHERE <column-name>[..., <column-name> ] { = | > | < | >= | <= | <> } {ANY | ALL } ( SELECT <column-name> [,<column-name> ] FROM <table- name> [ WHERE <column- name>[, <column- name> ] );

SELECT Customer_Name, Phone_Number FROM Customer_Table

WHERE Customer_Number = ANY (SELECT Customer_Number from Order_Table)

English: The above query SELECTS two columns from the Customer_Table if the customer has placed an order in the Order_Table.

The = ANY quantifier is the equivalent to IN, as NOT = ALL is equivalent to NOT IN.

Hint - Man

The SQL Quick Reference Guide Page 35

The SQL Reference Guide

Correlated Subquery
A correlated subquery works backwards compared to regular subqueries. It reads one row in the main query, then performs the subquery and returns the top row if it meets the criteria from the bottom query. Then it reads the second row, and so forth. This type of subquery performs quite efficiently in Teradata and is extremely powerful.

SELECT <column- name> [...,<column-name> ] FROM <table-name1> [ AS <table1-alias>] WHERE <column-name> { = | < | > | <= | >= | <> } ( SELECT { MIN | MAX | AVG }(<column-name>) FROM <table-name2>[AS <table2- alias> ] WHERE <table1-alias>.<column-name>=<table2-alias>.<column-name> ) ;

SELECT Last_Name, First_Name, Dept_No, Salary emp FROM Employee_Table as WHERE Salary = (SELECT MAX(Salary) FROM Employee_Table as emp.Dept_No = emt.Dept_No); WHERE

emt

You can recognize a correlated subquery by the WHERE clause in the bottom query. The last WHERE clause will compare a value from the top query with a value from the bottom query. That correlates the top and bottom queries together. Notice the aliasing in the example. Hint - Man

Issues: Using a correlated subquery without an aggregate function will produce this error message: 3669: More than one value was returned by a subquery.

Solutions: The solution is to place one of the aggregate functions in the subquery. *For more information on Table -Aliasing, refer to Appendix E.

Page 36 The SQL Quick Reference Guide

Simplicity by Design

Exists
Using this syntax allows for Teradata to perform a true -false test within the WHERE clause . The system will return either one or zero rows to satisfy the test.

SELECT <column- name> [...,<column-name> ] FROM <table- name1> [AS <table1-alias>] WHERE [ NOT ] EXISTS ( SELECT <column-name> [...,<column-name> ] FROM <table- name> [AS <table2-alias>] WHERE <table1- alias>.<column-name> = <table2-alias>.<column- name>) ;

SELECT Customer_Name FROM Customer_Table AS CUST WHERE EXISTS (SELECT * FROM Order_Table AS OT WHERE CUST.Customer_Number = OT.Customer_Number)

English: The above selects the Customer_Name if a customer has placed a current order. SELECT Course_Name FROM Course_Table AS Course WHERE NOT EXISTS (SELECT * FROM Student_Course_Table AS STU WHERE COURSE.Course_Id = STU.Course_Id) English: The above selects the Course_Name if no students are enrolled.

This is great SQL to use for testing queries prior to putting them into production. You can use EXISTs to see if certain values exist in the database. Hint - Man

Issues: 3707: Syntax error, expected something like an EXCEPT keyword or an UNION keyword or a MINUS keyword or ) between ) and ;. This error will be produced when there is an unneeded semi-colon inside the subquery.

Solutions: Search for the end of the subquery which is indicated by the ) and remove the semi-colon inside the ).

The SQL Quick Reference Guide Page 37

The SQL Reference Guide

Joins
Original Join Syntax
A join involves two or more tables in the same FROM clause of a single SELECT statement. Teradata is brilliant at performing joins.

SELECT

[<table- name>.]<column- name> [...,<table- name>.<column-name> ] FROM <table-name> [ AS <table1-alias> ] ,<table-name> [ AS <table2-alias> ] [ { WHERE [<table1-alias>.]<column-name>= [<table2-alias>.]<column-name> ] [ AND [<table1-alias>.]<column-name> = [<table2-alias>.]<column-name> ] [ { AND | OR } <column-name = <data-value> ] | WHERE <column-name = <data-value> } ] ;

SELECT Employee_No, Last_Name, First_Name, Dept_Name, dept.Dept_No FROM Employee_Table AS emp, Department_Table AS dept ; WHERE emp.Dept_No = dept.Dept_No

English: The above example SELECTS 3 columns from the Employee_Table and two columns from the Department_Table and joins them together.

SELECT STU.Student_Id, Last_Name, First_Name, Course_Name FROM Student_Table AS STU, Course_Table AS COUR, Student_Course_Table AS STU_COUR WHERE STU.Student_Id = STU_COUR.Student_Id ; AND COUR.Course_Id = STU_COUR.Course_Id English: The above example joins 3 tables together. Notice the WHERE clause joins the Student_Table with the Student_Course_Table and then the Course_Table with the Student_Course_Table. The Student_Course_Table is called an associative table.

The most complex part of any join is the WHERE or ON clause. The best technique is to make sure that the columns in the WHERE or ON clause have a Primary Key Foreign Key relationship. Quite often they will have the same name. In many cases you can look at the two tables and pick the columns that have the same name in both tables. Hint - Man

Page 38 The SQL Quick Reference Guide

Simplicity by Design

Issues:

An ambiguous column name in the SQL exists. This is caused by a column that exists in two or more of the tables involved in the join. There is a need to qualify one of the columns in the syntax. 3809: Column <column -name> is ambiguous. To eliminate this ambiguity we need to find the column that exists in two or more of the tables. We can do this by running a SHOW TABLE <table -name> for each table involved in the join. This will display all the columns of each table and allow the user to find the column that is shared between any of them. After finding that column return to the original join SQL, locate that column, and qualify it to determine from which table you want the values.

Solutions:

Issues:

You are getting back way more rows than expected . You are probably aliasing a table and not consistently using the alias for that table throughout the query. For example, SELECT Employee_Table .Dept_No, Dept_Name FROM Employee_Table as E, Department_Table as D WHERE E.Dept_No = D.Dept_No;

Solutions:

The above query would be a problem because we are SELECTING Employee_Table.Dept_No (In bold). Since we have aliased the Employee_Table as E we needed to SELECT E.Dept_No or Teradata thinks we are trying to join three tables. Teradata sees tables E, D, and Employee_Table. Once you alias a table in the FROM clause that alias applies to the table everywhere.

The SQL Quick Reference Guide Page 39

The SQL Reference Guide

ANSI INNER Join Syntax (Newer Syntax)


A Join involves two or more tables in the FROM clause of a single SELECT statement. The two main differences between this ANSI join syntax and the Te radata join syntax (on the previous page) are the words INNER JOIN separating the two tables in the FROM clause and the ON Clause instead of the WHERE clause.

SELECT [<table- name>.]<column- name> [ [...,<table- name>.]<column- name> ] ] FROM <table-name> [AS <table1-alias>] [INNER] JOIN <table-name> [AS <table2-alias>] ON [<table1-alias>.]<column-name>=[<table2-alias>.]<column-name> [ AND [<table1-alias>.]<column- name> = [<table2- alias>.]<column-name> ] [ [INNER] JOIN <table- name> [AS <table3-alias> ] ON [<table3- alias>.]<column-name> = [< {table1 | table2} - alias>.]<column-name> ;

SELECT Employee_No, Last_Name, First_Name, Dept_Name, EMP. Dept_No FROM Employee_Table AS emp INNER JOIN Department_Table AS dept ; emp.Dept_No = dept.Dept_No

ON

SELECT STU.Student_Id, Last_Name, First_Name, Course_Name FROM Student_Table AS STU INNER JOIN Student_Course_Table AS STU_COUR ON STU.Student_Id = STU_COUR.Student_Id INNER JOIN Course_Table AS COUR ; ON STU_COUR.Course_Id = COUR.Course_Id

SELECT Mgr_No, Last_Name, First_Name FROM Employee_Table AS EMP INNER JOIN Department_Table AS DEPT ON EMP.Employee_No = DEPT.Mgr_No ; WHERE Budget > = 500000

Notice the difference in syntax from the Original syntax. The two main changes are that INNER JOIN replaces the comma separating the tables in the FROM clause, and the ON clause overwrites the WHERE clause. This Syntax makes it easier to avoid those unwanted Product Joins. Hint - Man

Page 40 The SQL Quick Reference Guide

Simplicity by Design

Issues: An ambiguous column name in the SQL exists. This is caused by a column that exists in two or more of the tables involved in the join. There is a need to qualify one of the columns in the syntax. 3809: Column <column -name> is ambiguous. Solutions: To eliminate this ambiguity we need to find the column that exists in two or more of the tables. We can do this by running a SHOW TABLE <table -name> for each table involved in the join. This will display all the columns of each table and allow the user to find the column that is shared between any of them. After finding that column return to the original join SQL, locate that column, and qualify it to determine from which table you want the values. Below is an example.

SELECT Employee_No, Last_Name, First_Name, Dept_Name,

Dept_No
FROM ON Employee_Table AS emp INNER JOIN Department_Table AS dept emp.Dept_No = dept.Dept_No

Error - 3809: Column Dept_No is ambiguous.

English: The problem with the above query is that the Dept_No (in bold) is in both tables involved in the join. Because the system does not know which Dept_No we mean we need to qualify Dept_No. This could have worked had we stated either emp.Dept_No or Dept.Dept_No.

The SQL Quick Reference Guide Page 41

The SQL Reference Guide

Cartesian Product Join


A Cartesian Product join contains no WHERE clause . It is recommended to avoid this situation because 99% percent of the time this is a bad idea. SELECT [<table- name>.]<column- name> [...,<table- name>.<column-name> ] FROM <table-name> [ AS <table1-alias> ] ,<table-name> [ AS <table2-alias> ] ;

SELECT Employee_No, Last_Name, First_Name, Dept_Name, EMP.Dept_No ; FROM Employee_Table AS EMP, Department_Table English: The above example has no WHERE or ON clause so you will get a result set that has the number of rows in the first table multiplied by the number of rows in the second table. The results will be garbage.

Page 42 The SQL Quick Reference Guide

Simplicity by Design

ANSI OUTER JOIN Syntax


Outer Joins return all rows from the outer table. It will join matching rows from the joining table just like an inner join, but put NULL values for all columns of the inner table if there is not a match. There are LEFT, RIGHT and FULL Outer Joins.

SELECT

[<table- name>.]<column- name> [...,<table- name>.]<column- name> FROM <table- name> [AS <table1-alias-name>] {LEFT | RIGHT | FULL} [OUTER] JOIN <table -name> [AS <table2- alias- name>] ON [<table-name>.]<column-name> = [<table-name>.]<column-name> [ WHERE <condition- test> ] ;

SELECT ORD. Customer_Number, Customer_Name ,Phone_Number FROM Customer_Table AS CUST LEFT OUTER JOIN Order_Table AS ORD
ON CUST.Customer_Number = ORD.Customer_Number ;

In the Left Outer Join, the Customer_Table will be returning all of its rows, looking for matches in the Order_Table based on the Customer_Number defined by the ON statement.

Hint - Man

SELECT Employee_No, Last_Name, DEPT.Dept_No FROM Employee_Table AS EMP RIGHT OUTER JOIN Department_Table as DEPT ON EMP.Dept_No = DEPT.Dept_No ;

In the Right Outer Join, the Department_Table will be returning all of its rows, looking for matches in the Employee_Table based on the Dept_No defined by the ON statement. For any Department_Table rows with no matches in the Employee_Table the result set will contain NULL values for the columns from the Employee_Table. Hint - Man

The SQL Quick Reference Guide Page 43

The SQL Reference Guide

SELECT Last_Name, First_Name, Course_Id FROM Student_Table AS STU FULL OUTER JOIN Student_Course_Table AS STU_COUR

ON STU.Student_Id = STU_COUR.Student_Id ;
Customer_Table and the Order_Table will be returning all In the Full Outer Join, both the of its rows, looking for matches in each table based on the Customer_Number defined by the ON statement. Hint - Man

Issues: An ambiguous column name in the SQL exists. This is caused by a column that exists in two or more of the tables involved in the join. There is a need to qualify one of the columns in the syntax. 3809: Column <column -name> is ambiguous.

Solutions: To eliminate this ambiguity we need to find the column that exists in two or more of the tables. We can do this by running a SHOW TABLE <table -name> for each table involved in the join. This will display all the columns of each table and allow the user to find the column that is shared between any of them. After finding that column return to the original join SQL, locate that column, and qualify it to determine from which table you want the values.

Page 44 The SQL Quick Reference Guide

Simplicity by Design

CROSS JOIN Syntax


Cross- Joins are the ANSI equivalent of a Product Join . Both a Product Join and a Cartesian Product Join will compare every row from a table with every row from another table. A Cartesian Product Join will bring back every row where a Product Join will bring back only the rows that qualify in the WHERE or ON clause. SELECT [<table- name>.]<column- name> [[...,<table- name>.]<column- name> ] FROM <table- name> [AS <table1-alias>] CROSS JOIN <table -name> [AS <table2- alias>] [WHERE <condition- test> ] ;

SELECT Customer_Name, CUST.Customer_Number, Order_Total FROM Customer_Table AS CUST CROSS JOIN Order_Table AS ORD WHERE Order_Total < 10000 ;

The SQL Quick Reference Guide Page 45

The SQL Reference Guide

Date and Time Processing


Teradata has date functionality built into the database. Since dates are stored as integers in YYYMMDD form the date can be used for calculations of other dates. Users can SELECT the date directly from the Teradata system. Date refers to the date according to Teradata standards (YY/MM/DD) and Current_Date refers to the date according to ANSI standards (YYYY/MM/DD).

Teradata stores data on disk with the formula below. ((Year 1900) * (10000)) + (Month * 100) + Day

Example: January 12, 1977 = August 1, 2002 = 770112 1020824

INTEGERDATE Formula
This is the default display format for most Teradata client utilities. It is in the form of YY/MM/DD. The INTEGERDATE has nothing to do with how Teradata stores the data, but how Teradata displays the data.

The IntegerDate is NOT how Teradata stores dates on the physical disks, but is the default display format for client utilities. The exception is Queryman. Because Queryman uses ODBC as a standard Queryman will display the date format in ANSI format. Hint - Man

Page 46 The SQL Quick Reference Guide

Simplicity by Design

Selecting the DATE


These functions return the present date in . yy/mm/dd format SELECT DATE ;

Teradata Extension. Returns result by default in yy-mm-dd format.

Hint - Man

SELECT Current_Date;

ANSI Standard. Returns result in yyyy-mm-dd format.

Hint - Man

The SQL Quick Reference Guide Page 47

The SQL Reference Guide

ADD_MONTHS Function
Teradata gives a user the ability to calculate a new date. This is a Teradata extension function. This date can be the future with addition or past with subtraction. The calendar has intelligence built -in for the number of days in a month as well as leap year. SELECT ADD_MONTHS(<date-column>, <number-of-months>) FROM <table- name> ;
SELECT ADD_MONTHS(Order_Date, 3) FROM Order_Table ;

SELECT

ADD_MONTHS(Sale_Date, -2) FROM Sales_Table ;

English: The above examples will take the date from the column values (inside parenthesis) and add or subtract months.

The ADD_Months can utilize multiplication. For example, ADD_MONTHS(Date, 12*10) would bring back the date plus 10 years. Hint - Man

Issues: 3707: Syntax error, expected something like || or , between the word <date -column> and the integer <number-of-months>. This error will be returned when there is no comma between the <date -column> and the <number-ofmonths>.

Solutions: In the ADD_MONTHS function place a comma in between the <date -column> and the <number-of-months>.

Page 48 The SQL Quick Reference Guide

Simplicity by Design

EXTRACT Function
EXTRACT allows users to pull out the desired segment of a date or a time. Users can extract the YEAR, MONTH, or DAY from a date or HOUR, MINUTE, SECOND from the time. SELECT EXTRACT(<date/time-segment> FROM <date/time -data>) FROM <table- name> ;
SELECT EXTRACT(Year FROM order_date) FROM Order_Table ;

SELECT FROM Order_Table ;

EXTRACT(Month FROM order_date)

SELECT FROM Order_Table ;

EXTRACT(Day FROM order_date)

SELECT

EXTRACT(Hour FROM 06:35:22) ;

SELECT

EXTRACT(Minute FROM 06:35:22) ;

SELECT

EXTRACT(Second FROM 06:35:22) ;

The SQL Quick Reference Guide Page 49

The SQL Reference Guide

TIME and TIMESTAMP


Time and Current_Time returns the present time on the Teradata system in the HH:MM:SS format. Current_Timestamp returns the date and time in the yyyy-mm-dd HH:MM:SS format. SELECT TIME ;

A Teradata Extension Function. Returns time in hours:minutes:seconds.

Hint - Man

SELECT CURRENT_TIME ;

ANSI Standard Equivalent to TIME. Returns time in hours:minutes:seconds.

Hint - Man

Issues: 3822: Cannot resolve column currenttime. Specify table or view. If Terada ta returns this error the underscore ( _ ) character is missing in the syntax. Solution: Edit the SQL by placing a _ between the end of current and the beginning of time with no spaces.

SELECT CURRENT_TIMESTAMP ;

ANSI Standard. Return format is yyyy- mm- dd hh:mm:ss.

Hint - Man

Issues: 3822: Cannot resolve column currenttimestamp. Specify table or view. If Teradata returns this error the underscore ( _ ) character is missing in the syntax.

Solution: Edit the SQL by placing a _ between the end of current and the beginning of timestamp with no spaces.

Page 50 The SQL Quick Reference Guide

Simplicity by Design

System Calendar Columns


The following is a list of all the columns in the sys_calendar.calendar. Calendarview for the system table

Column Name Data Type Description _ calendar_date DATE Standard Teradata date Equivalency: DATE day_of_week BYTEINT 1-7, where 1 is Sunday Equivalency: (DATE - DATE) MOD 7 day_of_month BYTEINT 1-31, some months have less Equivalency: DATE MOD 7 day_of_year SMALLINT 1-366, Julian day of the year Equivalency: DATE MOD 100 or EXTRACT Day day_of_calendar INTEGER Number of days since 01/01/1900 Equivalency: DATE - 101(date) weekday_of_month BYTEINT The sequence of a day within a month, first Sunday=1, second Sunday=2, etc Equivalency: None known week_of_month BYTEINT 0-5, sequential week number within a month, partial week starts at 0 Equivalency: None known week_of_year BYTEINT 0-53, sequential week number within a year, partial week starts at 0 Equivalency: None known week_of_calendar INTEGER Number of weeks since 01/01/1900 Equivalency: (DATE 101(date))/7 month_of_quarter BYTEINT 1-3, each quarter has 3 months Equivalency: CASE EXTRACT Month month_of_year BYTEINT 1-12, up to 12 months per year Equivalency: DATE/100 MOD 100 or EXTRACT Month month_of_calendar INTEGER Number of months since 01/01/1900 Equivalency: None needed quarter_of_year BYTEINT 1-4, up to 4 quarters per year Equivalency: CASE EXTRACT Month quarter_of_calendar INTEGER Number of quarters since 01/01/1900 Equivalency: None needed year_of_calendar SMALLINT Starts at 1900 Equivalency: EXTRACT Year

Samples for use of Calendar:

SELECT * FROM sys_calendar.calendar ; WHERE calendar_date = 1020801

SELECT quarter_of_year WHERE calendar_date = current_date

FROM sys_calendar.calendar ;

The SQL Quick Reference Guide Page 51

The SQL Reference Guide

Character String Processing


CHARACTERS Function
Counts the number of characters in a string. This function is most often used with VARCHAR strings. If used with CHARACTER strings it will return the length of the column because it counts the spaces. When using the Characters function on fixed length columns it should be combined with the TRIM function. SELECT CHARACTERS( <column-name> ) FROM <table- name> [ WHERE CHARACTERS( <column-name> ) <comparison> <data- value> ] ;
SELECT Dept_Name, FROM Department_Table ; CHARACTERS(Dept_Name)

English: The above example selects Dept_Name and the number of Characters in the Dept_Name for all rows in the Department Table. If a row had a value for Dept_Name as Sales the answer set would state the Dept_Name and the number of characters in the name. Dept_Name Characters(Dept_Name) ___________ ___________________ Sales 5

SELECT CHAR(TRIM(Customer_Name)) , Customer_Name FROM Customer_Table WHERE Customer_Number IS NOT NULL ORDER BY 1 ; English: The above example will TRIM the leading and trailing spaces from the Customer_Name first and then count the number of characters. This is done because Customer_Name is a fixedlength character data type and not a varchar.

Issues: A column may not be a character data type. Check the data type. Teradata will return an error message that looks like this: 3580: Illegal use of CHARACTERS, MCHARACTERS, or OCTET_LENGTH functions.

Solutions: The first step is to execute the SHOW TABLE <table -name> syntax for the table where the column in question resides. If this column is not of a character data type it is necessary to choose a different column to run the CHARACTERS function on.

Page 52 The SQL Quick Reference Guide

Simplicity by Design

TRIM Function
TRIM removes the extra spaces from the front, back, or on both ends of a fixed length character string. The default for TRIM is BOTH. SELECT TRIM( {TRAILING | LEADING | BOTH } FROM <column-name> ) FROM <table- name> ;
SELECT TRIM(TRAILING FROM Course_Name) FROM Course_Table ;

SELECT FROM Employee_Table ;

TRIM(LEADING FROM Last_Name) , First_Name

SELECT FROM Student_Table ;

TRIM(BOTH FROM First_Name)

SELECT TRIM(Customer_Name) FROM Customer_Table ; English: The above examples will either TRIM the TRAILING, LEADING, or BOTH TRAILING and LEADING spaces from fixed-length character columns. Notice in the last example we dont specify LEADING or TRAILING. This will default to BOTH.

The SQL Quick Reference Guide Page 53

The SQL Reference Guide

SUBSTRING and SUBSTR Functions


Both of these functions serve the purpose of returning a desired section of a character string. A user chooses the starting position and then how many characters to pull out of the string. The <length> specified must be positive a number, otherwise an error will occur . SELECT SUBSTRING( <column-name>FROM <start- location> [ FOR <length> ] ) FROM <table- name>;
SELECT SUBSTRING(Course_Name FROM 3 FOR 4) FROM Course_Table ; SELECT SUBSTRING(Teradata FROM 2 FOR 5) ;

English: The last example will return a result of: erada

SELECT SUBSTR ( <column- name>, <start-location> [ , <length> ] ) FROM <table- name> ;


SELECT SUBSTR(Course_Name, 3 , 4) FROM Course_Table ;

SELECT

SUBSTR(Teradata, 2 , 5 ) ;

English: The last example will return a result of: erada

Issues:

2662: SUBSTR: string subscript out of bounds. <length> in the SQL is a negative number.

This error will occur when the

Solutions: To remove this problem, simply choose a non-negative number to place in the <length> parameter.

Issues: String literals must have single quotes around them. This error will come back if single quotes are missing. 3822: Cannot resolve column <string-literal>. Specify table or view.

Solutions: The solution is to locate the <string-literal> and place single quotes around it.

Page 54 The SQL Quick Reference Guide

Simplicity by Design

POSITION and INDEX Functions


Teradata will return the actual place number of where the <character- string> first occurs in the values of <column-name>. It is recommended to use the ANSI standard function, which is POSITION in this case.

SELECT POSITION( <character-string> IN <column- name> ) FROM <table- name> ;

SELECT POSITION(e IN Course_Name) , Course_Name FROM Course_Table ;

SELECT

POSITION(a IN Teradata) ;

English: The last example would return the position of a in Teradata which would be 4.

Teradata will return a 4 when running the second example query.

Hint - Man

POSITION is often used with the SUBSTRING function. Think about the SUBSTRING syntax: SELECT SUBSTRING(Column, FROM Start Position for End Position). An example would be SELECT SUBSTRING(Teradata, 5 for 4) which returns the string data. POSITION can be substituted inside the SUBSTRING for Start Position or End Position. An example would be: SELECT SUBSTRING(Teradata Class, POSITION( in Teradata Class) + 1, 5) The above would take the literal Teradata Class and find the position of the first . That number would actually be 9. Then the system would add one to it making it 10. So the actual SUBSTRING would actually be converted to: SELECT SUBSTRING(Teradata Class, FROM 10 for 5). This returns the word Class.

The SQL Quick Reference Guide Page 55

The SQL Reference Guide

INDEX Function
Teradata will return the actual place number of where the <character- string> first occurs in the values of <column-name>. SELECT INDEX( <column- name> , <character- string> ) FROM <table- name> ;

SELECT FROM Course_Table ;

INDEX(Course_Name , e)

SELECT INDEX(Teradata , a) ;

Equivalent Teradata Extension to the ANSI Standard POSITION function. When choosing to use an ANSI Standard function or the Teradata Extension Equivalent, it is recommended to use the ANSI Standard Function. Hint - Man

Issues: String literals must have single quotes around them. This error will come back if single quotes are missing: 3822: Cannot resolve column <string-literal>. Specify table or view. Solution: Place single quotes around the literal in question.

Page 56 The SQL Quick Reference Guide

Simplicity by Design

String and Column Concatenation


Concatenation is a very powerful feature that allows a user to combine two or more columnsin the result set to make reporting easier to read. Using concatenation with a string literal is permissible as well.

SELECT <character-data> || <character-data>AS <alias> FROM <table- name> ;

SELECT First_Name || Last_Name AS Full_Name FROM Employee_Table WHERE Salary <= 40000 ;

SELECT FROM Student_Table ;

Class_Code || Class AS Class

English: The last example above will take the value in Class_Code and concatenate the value with the word Class. If the value in Class_Code was FR then the result set would be: FR Class. In both examples above the queries are selecting only one column because the columns are concatenated.

Flexible in terms of mixing column data with literal strings.

Hint - Man

The SQL Quick Reference Guide Page 57

The SQL Reference Guide

OLAP Functions
OLAP Functions, not only are a Teradata Extension, but they are tools built into Teradata to give programmers the ability to analyze business trends and mine data into very granular reports. There are a few major points that need to be discussed that encompass all of the OLAP tools. OLAP is different than aggregates. While aggregates only return one line of aggregate data OLAP functions can have detail data mixed with OLAP functions. OLAP can be thought of very easily if you follow this logic. Each OLAP function will have a built in sort key. The OLAP query actually sorts the data by the OLAP function inside the parenthesis first. Then it calculates the OLAP requested only after the data is sorted. NEVER use the ORDER BY statement with OLAP because all sorts are done inside the Parenthesis of the OLAP function. Remember, OLAP sorts the data first by the sort key or keys inside the OLAP parenthesis and then and only then does the OLAP calculations. Below is an example of a Cumulative SUM OLAP query.
SELECT Order_Number, Order_Total, CSUM(Order_Total, FROM Order_Table ;

Order_Date)

English: The above query will SELECT the Order_Number and Order_Total from the Order_Table. It will also perform an OLAP function on the Order_Total, but before the calculation takes place Teradata will SORT the data by Order_Date. The Order_Date (in bold) is the Sort Key. Once the data is sorted by Order_Date Teradata will do a cumulative sum on Order_Total. Read on and you will understand.

Page 58 The SQL Quick Reference Guide

Simplicity by Design

Cumulative Sum Function (CSUM)


CSUM performs a cumulative sum on all the rows in the given <column-name>. The CSUM column in the result set will show the running calculation through the rows that are arranged according to the first <sort- key>.

SELECT CSUM( <column-name>, <sort -key> [ASC | DESC] [..., <sort -key> [ASC | DESC] ) FROM <table- name> [GROUP BY <column- name> [...,<relative- column- number> ;] ]
SELECT Order_Number, Order_Total, CSUM(Order_Total, Order_Date)
FROM Order_Table ;

SELECT Dept_No, Salary, FROM Employee_Table GROUP BY Dept_No ;

CSUM(Salary, Last_Name, Dept_No)

Hint - Man

The GROUP BY clause resets the Cumulative Sum total. The <sort -key> default for ordering is ASCENDING. Remember that when using the GROUP BY clause, be sure to include that same column as a <sort- key>. GROUP BY will reset the Cumulative Sum calculation. In the second example the CSUM will be reset for every Department Number in the Employee Table.

Issues: This message will be returned by Teradata is a user does not place a <sort-key> in the CSUM syntax: 3706: Syntax error: expected something between the word <column-name> and ).

Solutions: It is essential to select at least one sort-key, which is called a major sort. It would be best to run a SHOW TABLE <table -name> to get a list of the columns to choose from. Then place the desired column in the <sort-key> part of the CSUM syntax.

The SQL Quick Reference Guide Page 59

The SQL Reference Guide

Moving Sum Function (MSUM)


MSUM adds up the rows in the given <column-name> with a certain <width>based on the moving window. This <width> serves as a sliding window of which rows to include in the calculation. SELECT MSUM( <column-name>, <width>, <sort-key> [ASC | DESC] [..., <sort -key> [ASC | DESC] ) FROM <table- name> [GROUP BY<column-name> [...,<relative -column- number>] ] ;
SELECT Order_Number, Order_Total, MSUM(Order_Total, 3, Order_Date) FROM Order_Table ;

English: The example above will first sort the data by Order_Date. Then it will perform a moving sum on Order_Total for every 3 rows.

SELECT Product_Id, Sale_Date, MSUM(Daily_Sales , 2 , Sale_Date, Product_Id) FROM Sales_Table GROUP BY Product_Id ;

English: The example above will first sort the data by Product_Id. Then it will perform a moving sum on Daily_Sales for every 2 rows.

Issues: This message will be returned by Teradata is a user does not place a <sort-key> in the CSUM syntax: 3706: Syntax error: expected something between the word <column-name> and ).

Solutions: It is essential to select at least one sort-key, which is called a major sort. It would be best to run a SHOW TABLE <table -name> to get a list of the columns to choose from. Then place the desired column in the <sort-key> part of the CSUM syntax.

Page 60 The SQL Quick Reference Guide

Simplicity by Design

Moving Average Function (MAVG)


Serves as a function tocalculate an average based on the moving <width> . SELECT MAVG( <column-name>, <width>, <sort -key> [ASC | DESC]) [..., <sort -key> [ASC | DESC] ) FROM <table- name> [GROUP BY<column-name> [...,<relative -column- number> ] ] ;

SELECT Order_Number, Order_Total, MAVG(Order_Total, 3, Order_Date) FROM Order_Table ;

English: The example above will first sort the data by Order_Date. Then it will perform a moving average on Order_Total for every 3 rows.

SELECT Product_Id, Sale_Date, MAVG(Daily_Sales , 2 , Sale_Date) FROM Sales_Table GROUP BY Product_Id ; English: The example above will first sort the data by Sale_Date. Then it will perform a moving average on Daily_Sales for every 2 rows.

Issues: This message will be returned by Teradata is a user does not place a <sort-key> in the CSUM syntax: 3706: Syntax error: expected something between the word <column-name> and ).

Solutions: It is essential to select at least one sort-key, which is called a major sort. It would be best to run a SHOW TABLE <table -name> to get a list of the columns to choose from. Then place the desired column in the <sort-key> part of the CSUM syntax.

The SQL Quick Reference Guide Page 61

The SQL Reference Guide

Moving Difference Function (MDIFF)


The MDIFF functio n behaves a little differently than other OLAP functions. In the MDIFF result set column the difference calculation of <column-name>on Row A is performed on the entry that is <width> rows above Row A. SELECT MDIFF(<column-name>, <width>, <sort-key> [ASC | DESC] ) [..., <sort -key> [ASC | DESC] ) FROM <table- name> [GROUP BY<column-name> [...,<relative -column- number>] ] ;

SELECT Order_Number, Order_Total, MDIFF(Order_Total, 3, Order_Date) FROM Order_Table ; English: The example above will first sort the data by Order_Date. Then it will perform a moving difference on Order_Total for every 3 rows.

SELECT Product_Id, Sale_Date, MDIFF(Daily_Sales , 2 , Sale_Date) FROM Sales_Table GROUP BY Product_Id ; English: The example above will first sort the data by Sale_Date. Then it will perform a moving difference on Daily_Sales for every 2 rows.

Issues: This message will be returned by Teradata is a user does not place a <sort-key> in the CSUM syntax: 3706: Syntax error: expected something between an integer and ).

Solutions: It is essential to select at least one sort-key, which is called a major sort. It would be best to run a SHOW TABLE <table -name> to get a list of the columns to choose from. Then place the desired column in the <sort-key> part of the CSUM syntax.

Page 62 The SQL Quick Reference Guide

Simplicity by Design

QUANTILE Function
This function will divide the result set into a certain <column- name>. number of <partitions> based on the

SELECT QUANTILE (<partitions>, <column-name> , [<sort -key> [DESC | ASC]]) FROM <table- name> ; [QUALIFY QUANTILE (<column-name>) {< | > | = | <= | >=} <number-of-rows>]
SELECT Employee_No, Last_Name, Dept_No , QUANTILE(4, Salary, Dept_No DESC) FROM Employee_Table ; English: The example above will first sort the data by Dept_No in DESC order. Then it will perform a quantile function on salaries in quantiles of 4. In other words each salary will be assigned a number from 0-3.

SELECT Product_Id, Daily_Sales, QUANTILE(100, Daily_Sales, Sale_Date ASC) as Percentile FROM Sales_Table QUALIFY Percentile < 5 ;

English: The example above will first sort the data by Sale_Date in ASC order. Then it will perform a quantile function on Daily_Sales in quantiles of 100 returning all quantiles that are assigned a number less than 5.

The QUALIFY function is the equivalent to the WHERE and HAVING clauses. It is used when doing QUANTILE Functions. Hint - Man

The SQL Quick Reference Guide Page 63

The SQL Reference Guide

RANK Function
Returns the rows of the involved table in ranked a order determined by the <column-name>.The default order for RANK is DESCENDING or DESC. SELECT RANK( <column-name> [DESC | ASC] ) FROM <table- name> [GROUP BY <column- name> [...,<relative- column- number> ] ] [ { ASC | DESC } ] [QUALIFY RANK(<column-name>) {< | <=} <number-of-rows> [DESC | ASC] ];

, FROM Employee_Table

SELECT Employee_No, Last_Name, Dept_No RANK(Salary ASC) GROUP BY Dept_No ;

English: The above example will RANK the salaries in asc order. The query will return the Employee_Id, Last_Name, Dept_No, and Salary Rank in ascending order by Salary Rank.

SELECT Product_Id, Daily_Sales, RANK(Daily_Sales DESC) as Ranking FROM Sales_Table QUALIFY Ranking < 5 ;

English: The above example will RANK the Daily_Sales in DESC order. The query will return the Product_Id, Daily_Sales and Rank of Daily_Sales ordered by RANK of Daily_Sales if the rank is less than 5. The query is actually returning the top four selling products.

Page 64 The SQL Quick Reference Guide

Simplicity by Design

SAMPLE Function and SAMPLEID


SAMPLE returns a random sample of the result set of the given SQL statement . The sample size is determined by either a number of rows, or percentage of rows. SAMPLEID shows the user from which sample a certain row is in.

SELECT { <column- name> | * } [...,<column-name> ] [,SAMPLEID ] FROM <table- name> SAMPLE { <number-of-rows> | <percentage> } ; [...,<number-of-rows> | <percentage> ]
SELECT Customer_Name, Phone_Number FROM Customer_Table SAMPLE 3 ; English: A Sample of 3 rows. SELECT Course_Name FROM Course_Table SAMPLE .25 ; English: A Sample of 25% rows. SELECT Sale_Date, Daily_Sales, FROM Sales_Table SAMPLE 4 , 4 ; English: Two samples of 4 rows.
When requesting a concrete number of rows to be returned in a sample, the actual number of rows in the table should be taken into account. Suppose a user decides to take two samples from a 1000 row table. One sample is for 800 rows, and the second sample being 300 rows. The second sample will only have 200 rows returned because in SAMPLE there are no repeats in the same SQL statement!!

SAMPLEID

Hint - Man

Issues: More than 100% of result set wanted for Sample or multiple samples. This issue appears only when dealing with percentages. 5473: SAMPLE Clause has invalid set of arguments.

Solutions: The key is to adjust the sampling percentages to a proper total. For example if you are currently attempting to get three samples of .50 each, adjust the percentages to .33. This will take care of the error.

The SQL Quick Reference Guide Page 65

The SQL Reference Guide

RANDOM Function
Returns a random number between the<low-literal-value> and the <high-literal-value>. SELECT RANDOM( <low- literal-value>, <high- literal-value> );
SELECT RANDOM(10, 150) ;

English: SELECT a random number between 10 and 150.

SELECT * FROM Employee_Table WHERE RANDOM(1,100) = 2 ; English: Randomly Select 2% of the rows from the table.

Page 66 The SQL Quick Reference Guide

Simplicity by Design

Set Operator Commands


The SET Operators are UNION, INTERSECT, EXCEPT/MINUS. EXCEPT and MINUS are the same commands. The SET operators will run two queries at once and combine the result sets together. Here is an example: SELECT Employee_No from Employee_Table INTERSECT SELECT Mgr_No from Department_Table;
English: The above is looking for managers because both queries will run and then only the columns that match from the two SETS will be returned.

Here are a few general guidelines for using set operators: 1. Each SELECT statement involved must contain the same number of columns as the others. All corresponding columns must be of the same domain, which means that their da ta types and ranges of values must match. 2. The First Select statement formatsthe results and defines aliases and titles for column output. 3. The Last SELECT contains the ORDER BY clause for the entire SQL statement. 4. When using multiple set operators in one statement the order of operations is as follows: INTERSECT, UNION, EXCEPT/MINUS. This order holds true unless parentheses are used to manipulate the order.

For a more detailed list of guidelines on using Set Operators, refer to Teradata SQL: Unleash the Power, Chapter 11. Hint - Man

The SQL Quick Reference Guide Page 67

The SQL Reference Guide

INTERSECT
The INTERSECT operator matches like values from two sets of rows similar to an INNER JOIN. No duplicate rows will be returned in the result set unless the ALL keyword is used to include duplicate rows (when they exist). SELECT <column- name> [,<column-name> ] FROM <table -name> INTERSECT [ ALL ] SELECT <column- name> [,<column-name> ] FROM <table -name> [ORDER BY <column-name>] ;
SELECT Customer_Number AS Customers_with_Orders FROM Customer_Table INTERSECT SELECT Customer_Number FROM Order_Table ORDER BY 1 DESC; English: The above query returns all Customer_Numbers who have Orders in the Order_Table eliminating any duplicates. SELECT Student_Id FROM Student_Table INTERSECT ALL SELECT Student_Id (TITLE Students_With_Courses) FROM Student_Course_Table; English: The above query returns all Student_Ids who have enrolled in courses without eliminating any duplicates.

INTERSECT ALL is not a valid function for Teradata Versions earlier than Version 2 Release 4. Hint - Man

Issues: The columns in the two select statements do not match up in terms of data types. 3654: Corresponding select-list expressions are incompatible. Solutions: The best way to find matching data types is to run SHOW TABLE <table -name> for both tables you would like to intersect. Search through the DDL and locate the columns that match up properly. These are the columns you may use in the intersect.

Page 68 The SQL Quick Reference Guide

Simplicity by Design

UNION
UNION is a function that stacks one result set on top of the second result respectively. No duplicate rows will be returned in the answer set unless the ALL keyword is used to include any existing duplicate rows. SELECT <column- name> [,<column-name> ] FROM <table -name> UNION [ ALL ] SELECT <column- name> [,<column-name> ] FROM <table -name> [ORDER BY <column-name>];

SELECT Student_Id (TITLE All Students No Duplicates) FROM Student_Table UNION SELECT Student_Id FROM Student_Course_Table;

English: The above query returns all Student_Ids from both tables eliminating any duplicates.

SELECT Student_Id (TITLE All Students No Duplicates) FROM Student_Table UNION ALL SELECT Student_Id FROM Student_Course_Table; English: The above query returns all Student_Ids from both tables and does not eliminate any duplicates.

Issues: The columns in the two select statements do not match up in terms of data types. 3654: Corresponding select-list expressions are incompatible. Solutions: The best way to find matching data types is to run SHOW TABLE <table -name> for both tables you would like to intersect. Search through the DDL and locate the columns that match up properly. These are the columns you may use in the union.

The SQL Quick Reference Guide Page 69

The SQL Reference Guide

EXCEPT
EXCEPT serves the purpose of removing rows from the first result set that have a match in the second result set. No duplicate rows will be returned in the answer set unless the ALL keyword is used to include any existing duplicate rows. SELECT <column- name> [,<column-name> ] FROM <table -name> EXCEPT [ALL] SELECT <column- name> [,<column-name> ] FROM <table -name> [ORDER BY <column-name>] ;

SELECT Student_Id (TITLE 'Students w/o Courses - No Dups') FROM Student_Table EXCEPT SELECT Student_Id FROM Student_Course_Table;

English: The above query returns all Student_Ids from the top query (Student_Table) only. It will then eliminate any Student_Id from the top spool if they are in the Student_Course_Table. No data in the Student_Course_Table can ever be in the answer set. All duplicates in the top query only are eliminated. SEL Student_Id (TITLE 'Students w/o Courses Dups incl.') FROM Student_Table EXCEPT ALL SEL Student_Id FROM Student_Course_Table; English: The above query returns all Student_Ids from the top query (Student_Table) only. It will then eliminate any Student_Id from the top spool if they are in the Student_Course_Table. No data in the Student_Course_Table can ever be in the answer set. All duplicates in the top query are NOT eliminated.

Issues: The columns in the two select statements do not match up in terms of data types. 3654: Corresponding select-list expressions are incompatible. Solutions: The best way to find matching data types is to run SHOW TABLE <table -name> for both tables you would like to intersect. Search through the DDL and locate the columns that match up properly. These are the columns you may use in the except.

Page 70 The SQL Quick Reference Guide

Simplicity by Design

MINUS
The MINUS operator is the ANSI equivalent of its Teradata counterpart EXCEPT . It returns rows from the first result set that do not have matches in the second result set. No duplicate rows will be returned in the answer set unless the ALL keyword is used to include any existing duplicate rows. SELECT <column- name> [,<column-name> ] FROM <table -name> MINUS [ ALL ] SELECT <column- name> [,<column-name> ] FROM <table -name> [ORDER BY <column-name>];
SELECT Student_Id (TITLE 'Students w/o Courses - No Dups') FROM Student_Table MINUS SELECT Student_Id FROM Student_Course_Table; English: The above query returns all Student_Ids from the top query (Student_Table) only. It will then eliminate any Student_Id from the top spool if they are in the Student_Course_Table. No data in the Student_Course_Table can ever be in the answer set. All duplicates in the top query only are eliminated. SELECT Student_Id (TITLE 'Students w/o Courses - Dups incl.') FROM Student_Table MINUS ALL SELECT Student_Id FROM Student_Course_Table ORDER BY 1 DESC; English: The above query returns all Student_Ids from the top query (Student_Table) only. It will then eliminate any Student_Id from the top spool if they are in the Student_Course_Table. No data in the Student_Course_Table can ever be in the answer set. All duplicates in the top query are NOT eliminated.

Issues: The columns in the two select statements do not match up in terms of data types. 3654: Corresponding select-list expressions are incompatible. Solutions: The best way to find matching data types is to run SHOW TABLE <table -name> for both tables you would like to intersect. Search through the DDL and locate the columns that match up properly. These are the columns you may use in the minus.

The SQL Quick Reference Guide Page 71

The SQL Reference Guide

Data Manipulation Language Commands


INSERT
The INSERT syntax gives a user the ability to place more rows of data into a certain table. The command must take in account for every column in the table whether it is with actual data or nulls. INSERT [ INTO ] <table- name> VALUES ( <literal-data-value1> [ , <literal-data-value2> [, ] ) ;

INSERT INTO Student_Table VALUES ( 999333, 'Jones', 'Jerry', 'SR', 3.00 );

INSERT INTO Student_Table VALUES ( 999444, 'Smith', 'Jean', , NULL);

INSERT INTO Student_table (First_Name, Last_Name, Student_Id) VALUES ( 'Russel', 'Paul', 999111);

INSERT INTO Student_table (First_Name='Russel', Last_Name='Paul', Student_Id=999111);

English: The above examples use multiple ways to INSERT data into the Student_Table.

Hint - Man

When using the INSERT command, inserting column values in the proper order is essential. The order of values inserted must correspond to the order that the columns are defined in the table unless you name the columns. Take notice of the two ways in which NULL values are inserted (NULL or ,). Since the column names are specified in the last two syntax examples in the column order is arbitrary.

Issues: Too many values are being inserted in the target table. There are too many arguments in the Insert statement for the table to handle. 3706: Syntax error, Column name list shorter than value list. Solutions: Running a SHOW TABLE <table -name> or a HELP TABLE <table -name> is the best way to find out how many columns there are, and what data types they are. One you know this information you can edit the SQL to adhere to the structure of the table.

Page 72 The SQL Quick Reference Guide

Simplicity by Design

Inserting NULL and Default Values These three statements are ways to insert a row of nulls into the Student table. The third statement works in Teradata Version 2 Release 3 and l ater. When using this statement, any default values defined for columns will be inserted in place of nulls.

INSERT INTO Student_Table VALUES

(, , , , , ) ;

INSERT INTO Student_Table VALUES (NULL, NULL, NULL, NULL, NULL, NULL)

INSERT INTO Student_Table DEFAULT VALUES ;

Issues: The values that are being inserted do not match up properly with the columns in the target table. 3706: Syntax error, Column name list shorter than value list.

Solutions: Running a SHOW TABLE <table -name> or a HELP TABLE <table -name> is the best way to find out how many columns there are, and what data types they are. One you know this information you can edit the SQL to adhere to the structure of the table.

The SQL Quick Reference Guide Page 73

The SQL Reference Guide

INSERT / SELECT
The INSERT/SELECT statement serves as a very fast way to move data from one table to another. It is very flexible in addition to being great for performance. INSERT [ INTO ] <table1- name> SELECT <column1- name> [ ,<column2- name> [ , ] ] FROM <table2- name> ;
INSERT INTO New_Employee_Table * FROM Employee_Table;

SELECT

INSERT INTO New_Employee_Table SELECT ( Employee_No, Last_name, First_name, , ) FROM Employee_Table;

INSERT INTO New_Employee_Table (Dept_No, First_name, Last_name, Employee_No) SELECT Dept_No, First_name, Last_name, Employee_No FROM Employee_Table;

Issues:

3813: The positional assignment list has too many values. This error comes up when there are too many columns in the SELECT table for the target table to handle.

Solutions: There are two solutions for this issue. The first solution would be to look in the SELECT table DDL, with a SHOW TABLE <table -name> then adjust the SELECT statement to choose only the columns that match with the target table. The second solution would be to alter the structure of the target table, but this is normally not recommended.

INSERT INTO Employee_Table_USA SELECT * FROM Employee_Table_West UNION SELECT * FROM Employee_Table_East;

The above query does an INSERT SELECT into an empty table. Because the target table was empty there is no need to take before image pictures with the Transient Journal. Because we have used the UNION command to make both SELECTS part of the same transaction we can INSERT the rows from both tables much faster. This is a clever trick. Hint - Man

Page 74 The SQL Quick Reference Guide

Simplicity by Design

UPDATE
This syntax serves the purpose of changing data values of one or more existing rows that meet the criteria specified in SQL request. UPDATE<table -name> [ AS <alias-name> ] [ FROM <table2-name> [AS <alias2-name> ] ] SET <column- name> = <expression-or- data- value> [ , <column-name> = <expression-or-data-value> ] [ WHERE <condition- test> ] [ AND <condition- test> ] [ OR <condition- test> ] [ALL] ;

UPDATE Student_table SET Grade_Pt = Grade_Pt + 1.0 WHERE Last_Name = 'Jones' AND First_Name = 'Jerry' AND Class_Code = 'JR';

UPDATE Student_table SET Grade_Pt = 2.50 ,Class_Code = 'JR' WHERE Student_Id = 999333;

UPDATE Employee_Table SET Salary = Salary * 1.1 All;

English: The above query examples are updating. The top two examples are updating only one row, but the last example gives everyone in the Employee_Table a 10% raise.

The ALL command is completely optional. Teradata would have updated every row in the table for the last example.

Hint - Man

The SQL Quick Reference Guide Page 75

The SQL Reference Guide

UPDATE with a Subquery Using a subquery is a very advanced means of updating rows. UPDATE<table -name> [ AS <alias- name> ] [ FROM <table -name2> [AS <alias-name2> ] ] SET <column- name> = <expression-or- data- value> [ , <column-name> = <expression-or-data-value> ] WHERE<column- name> [ , <column- name2> [ , ]] IN ( SELECT <column- name> [,<column- name2> [ , ]] FROM <table- name> [ AS <alias-name> ] [ WHERE <condition- test> ] ) [ ALL ] ;
UPDATE Employee_Table SET Salary = Salary * 1.10 WHERE Dept_No IN (SELECT Dept_No FROM Department_Table WHERE Budget > 500000)

UPDATE with a Join When a programmer understands his or her data well enough, it could be very beneficial to use this syntax. UPDATE<table -name1> [ AS <alias- name1> ] [ FROM <table -name2> [ AS <alias-name2> ] ] SET <column- name> = <expression-or- data- value> WHERE[<table -name1>.]<column-name> = [<table -name1>.]<column-name> [ AND <condition- test> ] [ OR <condition- test> ] [ ALL ];

UPDATE Employee_Table FROM Department_Table dept SET Sala ry = Salary * 1.10 WHERE Employee_Table.Dept_No = dept.Dept_No ; AND Budget > 500000

Page 76 The SQL Quick Reference Guide

Simplicity by Design

DELETE
Unlike most databases Teradata has the ability to quickly delete rows from a given table. It is recommended to delete all rows from a table rather than drop it , then recreate that table. DELETE [ FROM ] <table- name> [ AS <alias-name> ] [ WHERE condition ] [ ALL ];
DELETE FROM Student_Table ALL ;

DELETE FROM Student_Table WHERE Grade_Pt < 1.0 ;

Issues: The table having rows deleted does not exist. 3807: Table/view/trigger Student does not exist.

Solutions: Check the spelling of the <table -name>, use the SELECT DATABASE syntax to confirm you are in the correct database or HELP DATABASE <database-name> to see all objects in the database.

The SQL Quick Reference Guide Page 77

The SQL Reference Guide

Delete with a Join On occasion, you may wish to delete rows from a table based on values in another table . The Delete command can be used with a join or subquery operation to accomplish this task. DELETE<table - name1> [ FROM <table- name2> [ AS <alias- name> ] ] WHERE<table -name1>.<column- name>=<table -name1>.<column-name> [ AND <condition> ] [ OR <condition> ] [ ALL ];
DELETE Employee_Table FROM Department_Table AS dept WHERE Employee_Table.Dept_No = dept.Dept_No ; AND Budget < 400000

DELETE Employee_Table WHERE Employee_Table.Dept_No = Department_Table.Dept_No ; AND Budget < 400000

Keep in mind when omitting the optional FROM clause an alias cannot be used.

Hint - Man

Delete with a Subquery DELETE<table - name> [ AS <alias- name> ] WHERE<column- name> [ , <column- name2> [, ] ] IN ( SELECT <column- name> [,<column- name2> [, ] FROM <table- name> [ AS <alias-name> ] [ WHERE condition ] ) [ ALL ];

DELETE FROM Employee_Table WHERE Dept_No IN (SELECT Dept_No FROM Department_Table WHERE Budget < 500000)

Page 78 The SQL Quick Reference Guide

Simplicity by Design

UPSERT
UPSERT combines UPDATE and INSERT into a single command. If the row already exists, then the Update will occur. If the row does not exist, then the row will be inserted. In Teradata versions prior to V2R4.1 TPUMP and MULTILOAD could only use this syntax. In Teradata V2R4.1 and later, this functionality is present in Queryman and BTEQ as well. UPDATE<table -name> SET <column- name> = <expression> [ ,<column-name> = <expression> ] WHERE [<table -name1>.]<column-name> = [<table - name1>.]<column- name> [ AND <condition- test> ] [ OR <condition- test> ] ELSE INSERT INTO <table-name> VALUES ( <value -list> ) ;
UPDATE Student_Table SET Grade_Pt = 4.0 WHERE Last_Name = 'Jones' AND First_Name = 'Jasmine' AND Class_Code = 'JR' AND Student_Id = 555555 ELSE INSERT INTO Student_Table VALUES ( 555555,'Jones','Jasmine','JR',4.0 ) ;

English: In the above example we are attempting to UPDATE the Student_Table. If the UPDATE works the query is done, however, if Teradata does not find the row in the table it will INSERT the record into the table.

For a more information on using UPSERT, refer to Teradata SQL: Unleash the Power, book by Larkins and Coffing, Chapter 12. Hint - Man

Issues: Missing the ELSE before the INSERT statement. 3706: Syntax error: expected something between an integer and the INSERT keyword.

Solutions: In the SQL request, locate the word INSERT and place ELSE before it.

The SQL Quick Reference Guide Page 79

The SQL Reference Guide

UPSERT for TPUMP and MULTILOAD This UPSERT syntax is to be used in TPUMP and MULTILOAD only . Teradata will not recognize the command without the Label and DO INSERT code. .DML LABEL <label-name> DO INSERT FOR MISSING UPDATE ROWS; UPDATE<table -name> SET <column- name> = <expression> [ ,<column-name> = <expression> ] WHERE [<table -name1>.]<column-name> = [<table - name1>.]<column- name> [ AND <condition- test> ] [ OR <condition- test> ] ; INSERTINTO <table- name> VALUES ( <value- list> ) ;

.DML LABEL UPSERT1 DO INSERT FOR MISSING UPDATE ROWS;


UPDATE Student_Table SET Grade_Pt = 4.0 WHERE Last_Name = 'Jones' AND First_Name = 'Jasmine' AND Class_Code = 'JR' AND Student_Id = 555555 INSERT INTO Student_Table VALUES ( 555555,'Jones','Jasmine','JR',4.0 ) ;

: In the above example you see the statement: Do INSERT for Missing UPDATE rows. This is a required statement and not just a comment. Often users dont think they need this in Multiload and they do. For more information see the Teradata Utilities Breaking the Barriers by Coffing, Jones, Larkins, Volters and Wilmes.

Hint - Man

Page 80 The SQL Quick Reference Guide

Simplicity by Design

DATA INTERROGATION
NULLIFZERO
This Teradata extension returns a NULL value when the column value is This function is helpful with eliminating any division by zeros. equal to zero .

SELECT NULLIFZERO( <column-name> ) ,<Aggregate>( NULLIFZERO(<column-name> ) ) FROM <table -name> GROUP BY 1;

SELECT Class_code , NULLIFZERO(Grade_pt) AS "Class AVG" FROM Student_table;

SELECT Last_Name ,First_Name ,Class_Code ,Grade_Pt , Grade_pt / ( NULLIFZERO(Grade_Pt) * 2 ) AS "Calc" FROM Student_Table ORDER BY 3,4;

The second example illustrates a good use of the NULLIFZERO Function by eliminating division by zero errors. Hint - Man

Issues: The user is attempting to use this function on a non-numeric column. 2621: Bad character in format or data of Student_table.Class_code. Solutions: The only answer to this problem would be to choose another column that is of numeric data type. Executing a SHOW TABLE <table -name> or a HELP TABLE <table -name> command will display the information you need to make an educated decision.

The SQL Quick Reference Guide Page 81

The SQL Reference Guide

NULLIF
An ANSI Statement that compares two values and equal. returns a NULL when the values are

SELECT NULLIF(<column-name>, <value> ) [,<Aggregate>(NULLIF(<column-name>, <value> ) )] FROM <table- name> [GROUP BY 1] ;

SELECT Class_Code , AVG(NULLIF(Grade_pt, 0) ) AS CLASSAVG FROM Student_table GROUP BY Class_Code;

English: In the above example Grade_Pt is compared to 0. If Grade_Pt equals 0 a NULL value is returned. Since aggregates like AVG ignore nulls the AVG wont be pulled way down for a 0.

Issues: Attempting to use this function on a non-numeric column. 2621: Bad character in format or data of Student_table.Class_code. Solutions: The only answer to this problem would be to choose another column that is of numeric data type. Executing a SHOW TABLE <table -name> or a HELP TABLE <table -name> command will display the information you need to make an educated decision.

Page 82 The SQL Quick Reference Guide

Simplicity by Design

ZEROIFNULL
It returns a zero when the data value in a column contains a NULL . This function can be used with mathematical formulas and functions in order to eliminate the use of NULL values in calculations.

SELECT

ZEROIFNULL(<column-name> ) [,<Aggregate> ( ZEROIFNULL(<column-name> ) )] FROM <table- name> [GROUP BY 1] ;

SELECT Last_Name ,First_Name ,Class_code , ZEROIFNULL(Grade_pt) AS GPA FROM Student_table ORDER BY 4 DESC;

SELECT Class_Code , AVG(ZEROIFNULL(Grade_pt)) CLASSAVG FROM Student_table GROUP BY 1 ORDER BY 2;

This function can be used with mathematical formulas and functions in order to eliminate the use of NULL values in calculations. Hint - Man

Issues: Attempting to use this function on a non-numeric column. 2621: Bad character in format or data of Student_table.Class_code.

Solutions: The only answer to this problem would be to choose another column that is of numeric data type. Executing a SHOW TABLE <table -name> or a HELP TABLE <table -name> command will display the information you need to make an educated decision.

The SQL Quick Reference Guide Page 83

The SQL Reference Guide

COALESCE
This ANSI statement returns the first Non-NULL value in a list that can include columns, literals, or both. If all columns in the list are NULL Coalesce returns a NULL.

SELECT

COALESCE (<column-list> [,<literal> ] ) [,<Aggregate>( COALESCE(<column-list>[,<literal>] ) )] FROM <table- name> [GROUP BY 1];

SELECT Last_name ,First_Name , COALESCE(Class_code, 'Missing Classification') FROM Student_Table ORDER BY 1;

Class

SELECT Last_name ,First_Name ,COALESCE(Class_code, Grade_Pt,'Missing Class and Grade') AS Class FROM Student_Table ORDER BY 1;

English: The above COALESCE statements will SELECT Class_code unless Class_code is NULL. If Class_code is NULL then another column or literal will be chosen.

One technique that will guarantee no NULL is returned is to place a literal value at the end of the list. For example (watch for the bold below): Hint - Man SELECT COALESCE(HomePhone, WorkPhone,

No Phone);

Issues:

3810: Column <string-literal> does not exist. This error is caused by not properly identifying a character string in the COLAESCE function.

Solutions: The solution is to find the character string that is suspected of the error and place sin gle quotes around that string.

Page 84 The SQL Quick Reference Guide

Simplicity by Design

CASE
The CASE statement is a flexible SQL function that provides for multiple levels of testing data. There are a few different styles, which give the user the choice of how much data interrogation can be performed on the rows. Basic Syntax This is the simplest syntax of all the styles of case statements. Only tested is this format. CASE <column- name> WHEN <value1> THEN <true -result1> WHEN <value2> THEN <true -result2> [ ELSE <false-result> ] END ; one column can be

SELECT First_Name , Last_Name , CASE Class_Code WHEN 'FR' THEN 'Freshman' WHEN 'SO' THEN 'Sophomore' WHEN 'JR' THEN 'Junior' WHEN 'SR' THEN 'Senior' ELSE 'Not Classified' END "Classification" FROM Student_Table ;

In a case statement, the ELSE clause is optional. If you choose not to use the else, any arguments that do not match any of the criteria will return a NULL value to the result set. Hint - Man

The SQL Quick Reference Guide Page 85

The SQL Reference Guide

Advanced Syntax This advanced syntax returns results based on than one columnif desired. various conditions , which can test more

CASE WHEN <condition- test1> THEN <true- result1> WHEN <condition- test2> THEN <true- result2> [ ELSE <false-result> ] END ;
SELECT First_Name || ' ' || Last_Name , CASE WHEN Class_Code = 'FR' THEN 'Freshman' WHEN Class_Code = 'SO' THEN 'Sophomore' WHEN Class_Code = 'JR' THEN 'Junior' WHEN Class_Code = 'SR' THEN 'Senior' ELSE 'Not Classified' END "Classification" FROM Student_Table;

English: The above query example will concatenate the First_Name and Last_Name together with a space in between. Then the Class_Code will be inte rrogated and the proper literal will be placed in the report. The alias is called Classification. SELECT First_Name || ' ' || Last_Name ,Salary , CASE WHEN Salary > 50000 THEN 'Top of Pay Scale' WHEN Salary BETWEEN 40000 AND 50000 THEN 'Reaching Top Pay' WHEN Salary BETWEEN 35000 AND 39999 THEN Low End' WHEN Salary IS NULL THEN 'Missing Salary' ELSE 'Entry Level' END "Clas sification" FROM Employee_Table ORDER BY 2;

Both syntaxes allow for an alternative result when all values/conditions evaluated are false. Knowledge of your data and business rules is critical to properly utilize the CASE statement. Hint - Man

Page 86 The SQL Quick Reference Guide

Simplicity by Design

Horizontal Reporting The CASE Statement below will display Average salaries for Departments 100-400 in a manner of one row, rather than four separate rows. This style of Case Statement is called Horizontal Reporting.

SELECT AVG(CASE Dept_No WHEN 100 THEN Salary ELSE NULL END) AS "Dept 100 AVG SAL" ,AVG(CASE Dept_No WHEN 200 THEN Salary ELSE NULL END) AS "Dept 200 AVG SAL" ,AVG(CASE Dept_No WHEN 300 THEN Salary ELSE NULL END) AS "Dept 300 AVG SAL" ,AVG(CASE Dept_No WHEN 400 THEN Salary ELSE NULL END) AS "Dept 400 AVG SAL" FROM Employee_Table WHERE Dept_No IS NOT NULL;

English: The above query is brilliant, but you must first understand that aggregates ignore NULLS. Normally a query such as this will be performed showing the Dept_No and AVG(Salary) and grouping by Dept_No. The result set would produce a one line total for each department. If there were four departments then there would be four rows in the answer set. The above query delivers a one -line answer set. With four case statements and four aliases a row will either qualify in one of the four case state ments and be part of the average or is made NULL and therefore ignored by the AVG. The output would look something like this:
Dept 100 AVG SAL Dept 200 AVG SAL ________________ _________________ 50000.00 60000.00 Dept 300 AVG SAL Dept 400 AVG SAL _________________ _________________ 55000.00 80000.50

The SQL Quick Reference Guide Page 87

The SQL Reference Guide

Nested CASE Each nested CASE statement is enclosed in parentheses and has a corresponding END statement . This allows for further testing of a value that passes the first level of the nested case statement.
SELECT TRIM(Last_name) || ', ' || First_Name ,CASE Class_code WHEN 'FR' THEN 'Freshman ' || (CASE WHEN Grade_pt < 2 THEN 'Unacceptable' WHEN Grade_pt < 3.5 THEN 'Satisfactory' ELSE 'Honor Roll' END) WHEN 'SO' THEN 'Sophomore ' || (CASE WHEN Grade_pt < 2 THEN 'Unacceptable' WHEN Grade_pt < 3.5 THEN 'Satisfactory' ELSE 'Honor Roll' END) WHEN 'JR' THEN 'Junior ' || (CASE WHEN Grade_pt < 2 THEN 'Failing' WHEN Grade_pt < 3.5 THEN 'Satisfactory' ELSE 'Honor Roll' END) ELSE 'Senior ' || (CASE WHEN Grade_pt < 2 THEN 'Unacceptable' WHEN Grade_pt < 3.5 THEN 'Satisfactory' ELSE 'Honor Roll' END) END AS "Grade Status" FROM Student_Table ORDER BY Class_Code, Last_Name;

For more details refer to Teradata SQL: Unleash the Power, Chapter 13.

Hint - Man

Issues: Possibly missing parentheses in the SQL. 3707: Syntax error, expected something like ) between the END keyword and the END keyword . Solutions: The best means of solving this issue is to start with the first ( and find the ) that is paired with it. Then move to the second ( and find its partner ), and continue this process until all the ( have a paired up ). If there is a ( with no pair place a ) at the end of the SQL before the semi-colon.

Page 88 The SQL Quick Reference Guide

Simplicity by Design

Views
In all the classes that Ive taught, I always get the question of why views are a big part of Teradata. There are many ways that can be answered. Views are used as a means to customize the way users can access a certain table by deriving columns, restricting columns, or joining multiple tables together to make reporting an easier task. Most Enterprises use views as a means of protecting the raw data from any accidental corruption by users.

Create View Syntax


Views allow a user to manipulate the columns returned with the reporting format desired, which is very useful. The WITH CHECK OPTION statement allows a user to only insert or modify rows that are compliant with the WHERE Clause in the CREATE VIEW syntax. CREATE VIEW <view- name> [( <alias- name>, <alias-name>, ) ] AS SELECT <column- name> [AS <alias- name> ] [, <column-name> [AS <alias- name> ] ] FROM <table- name> [ WHERE <conditional-tests> ] [ WITH CHECK OPTION] ;
CREATE VIEW Employee_V AS SELECT Employee_No, Last_Name , First_Name, Dept_No FROM Employee_Table ;

CREATE VIEW Course_Credits_V (CourseName, Hours) AS SELECT Course_Name, Credits FROM Course_Table ;

CREATE VIEW Roster_400_V AS SELECT STU.Student_Id, Last_Name, First_Name FROM Student_Table STU INNER JOIN Student_Course_Table STU_COUR ON STU.Student_Id = STU_COUR.Student_Id WHERE Course_Id = 400 WITH CHECK OPTION ;

The SQL Quick Reference Guide Page 89

The SQL Reference Guide

The Create View Syntax can be replaced by CV, which is a Teradata specific feature. In the fourth example, a user may only insert or modify rows that are compliant to Course_Id = 400 due to the WITH CHECK OPTION statement. Hint - Man

Issues: Table does not exist from which the view is pulling from. A misspelling of some sort could cause this error, or the table you are looking for could not be in that database. 3807: Table/view/trigger <table-name> does not exist.

Solutions: The first thing to do is search for the table name and ensure it is properly spelled. The next step is to run a HELP DATABASE <database-name> command to locate the table desired to have a view on. Then put the proper table name in the view create text.

DROP Views
The DROP View syntax completely removes a view from the Data Dictionary. DROP VIEW[<database- name<.]<view- name> ;

DROP VIEW Employee_V ; DROP VIEW Course_Credits_V ;

Page 90 The SQL Quick Reference Guide

Simplicity by Design

REPLACE Views
Use the word REPLACE to change a view.

REPLACE VIEW[<database- name>.]<view- name> AS SELECT <column- name> [...,<column-name> ] FROM <table -name> [ WHERE <conditional-tests> ] [ WITH CHECK OPTION ] ;

REPLACE VIEW Sales_Low_V AS SELECT * FROM Sales_Table WHERE Daily_Sales <= 40000 ;

REPLACE VIEW Roster_400_V AS SELECT Last_Name, First_Name FROM Student_Table STU INNER JOIN Student_Course_Table STU_COUR ON STU.Student_Id = STU_COUR.Student_Id WHERE Course_Id = 400 WITH CHECK OPTION ;

Hint - Man

A clever technique to replacing a view is to run the SHOW VIEW <ViewName> command. Then when the answer set shows the current view structure you can copy it and then change the word CREATE to REPLACE and make your changes. This is safer and more efficient then trying to retype the entire view in again.

The SQL Quick Reference Guide Page 91

The SQL Reference Guide

LOCKING FOR ACCESS


Using an Access Lock is like a Dirty Read . Access Locks provide compatibility with all other lock types except for an Exclusive Lock.
{ CREATE | REPLACE } VIEW [<database- name>.]<view-name>

AS LOCKING <table-name> FOR ACCESS SELECT <column- name> [...,<column-name> ] FROM <table -name> [ WHERE <conditional-tests> ] [ WITH CHECK OPTION ] ;

CREATE VIEW Employee_V AS LOCKING Employee_Table FOR ACCESS SELECT Employee_No, Last_Name , First_Name, Dept_No FROM Employee_Table ;

CREATE VIEW Course_Credits_V (CourseName, Hours) AS LOCKING Course_Table FOR ACCESS SELECT Course_Name, Credits FROM Course_Table ;

CREATE VIEW Sales_Low_V AS LOCKING Sales_Table FOR ACCESS SELECT * FROM Sales_Table WHERE Daily_Sales <= 35000 ; English: The above examples are explicitly telling Teradata to put an ACCESS Lock on the tables being read instead of the default READ Lock.

Hint - Man

Teradata places locks for users automatically, but in a data warehouse Decision Support Environment many users dont want to wait on a table or row that has a WRITE Lock placed on it. The above queries tell Teradata to put an ACCESS lock on the table so they wont wait on a WRITE Lock. Only do this for queries where the answer does not have to be exact.

For more information on Lock Types, refer to Teradata SQL: Unleash the Power by Larkins and Coffing, Chapter 16, or Tera-Tom on Teradata Basics by Jones and Coffing. Hint - Man

Page 92 The SQL Quick Reference Guide

Simplicity by Design

MACROS
Often in sports each team has a number of set plays that they run during a game sometimes in order to guarantee success. In Teradata, these set plays are called Macros. Each macro has a set order of SQL commands that has a predictable result, just like the plays used by a basketball team. Another important thing to remember about Macros is that Teradata treats them as one single transaction. What this means is either the macro works or does not. There is no partial success.

CREATE Macro
It is very important to remember that CM does not work with any ODBC tool, only on BTEQ. Once this SQL is run Teradata will store the definition and also the parsed plan of execution. CREATE MACRO <macro-name> (<variable -name> <data- type>, ) AS ([ INSERT ; ] [ UPDATE ; ] [ DELETE ; ] [ SELECT ; ] ) ;
CREATE MACRO Add_Dept_M AS (d_no SMALLINT, d_name char(20), Mgr_No INTEGER, budget DECIMAL(10,2) ) ( INSERT INTO Department_Table
(dept_no, dept_name, Mgr_No, budget) ; ) ;

English: The macro above is set up to take input parameters when executed.
CREATE MACRO Remove_Sales_Date_M AS

( DELETE FROM Sales_Ta ble


WHERE Sale_Date = Current_Date 30 ; ) ;

CREATE MACRO Check_Orders AS


( SELECT * FROM Order_Table ; SELECT * FROM Customer_Table WHERE Customer_Number IN (SELECT Customer_Number FROM Order_Table) ; ) ;

English: The macro above runs multiple queries within the same ma cro.
When CREATING a MACRO remember that every Macro ends with ;); The first semi -colon ends the last SQL statement in the macro and the close parenthesis and ending semi -colon ends the Macro itself.

Hint - Man

The SQL Quick Reference Guide Page 93

The SQL Reference Guide

It is always recommended to write out the full CREATE MACRO syntax in order to eliminate any possible confusion of users looking at the query at a later time. Hint - Man

Issues: 3707: Syntax error, expected something like ';' between a <any SQL> and ')'. When Teradata returns this message, there is a need for a semi-colon inside the parentheses of the macro declaration.

Solutions: Directly inside the ), place a ; character, and execute the CREATE MACRO request again.

EXECUTE Macro
This is the syntax allows a user to run a macro, with passing along any parameters if needed.

EXEC<macro-name> [ ( <parameter- value -list> ) ] ;

EXEC Add_Dept_M(600, Technical Support, 2341218, 525000);

EXEC Update_Sal_M ;

Page 94 The SQL Quick Reference Guide

Simplicity by Design

REPLACE Macro
Teradata treats this syntax as a Smart Replace . Teradata will recreate the macro <macro- name> as if it does not already exist. This syntax changes the DDL of a macro. REPLACE MACRO<macro-name> AS ( [ INSERT ; ] [ UPDATE ; ] [ DELETE ; ] [ SELECT ; ] ) ;

REPLACE MACRO Update_Sal_M


( UPDATE Employee_Table SET Salary = Salary * 1.10 ; ) ;

AS

REPLACE MACRO Remove_Sales_Date_M ( DELETE FROM Sales_Table


WHERE Sale_Date = Current_Date 60 ; ) ;

AS

REPLACE MACRO Order_M AS ( SELECT * FROM Order_Table WHERE Order_Total > 10000 ; ) ;

Hint - Man

A clever technique to replacing a macro is to run the SHOW MACRO <MacroName> command. Then when the answer set shows the current macro structure you can copy it and then change the word CREATE to REPLACE and make your changes. This is safer and more efficient then trying to retype the entire macro in again.

DROP Macro
DROP MACRO completely removes a macros definition and parsed execution plan from Teradatas Data Dictionary. DROP MACRO <macro-name> ;

DROP MACRO Remove_Sales_Date_M ;

DROP MACRO Add_Dept_M ;

The SQL Quick Reference Guide Page 95

The SQL Reference Guide

Transaction Processing
Locking Modifiers

Lock Types

Lock Type Brief Description Exclusive Used mainly when Table or Database DDL is being modified. Causes object to be inaccessible. Locks at the Database or Table Level. Write A data block is being modified, making it temporarily unavailable. Read Data is retrieved from a disk, with no changes made. <DEFAULT for all users> Access A Dirty Read. Allows a user to access data that is currently locked with a Write Lock.

For more details on Locks and Lock compatibility, refer to Chapter 16, Teradata SQL: Unleash the Power book by Larkins and Coffing. Hint - Man

Lock Syntax The defaultlevel of locking for this syntax is Row Level . NOWAIT serves the purpose of ignoringany lock that is on that specific row, and performing the SQL immediately. LOCKING[<table -name>] FOR <desired- locking> [NOWAIT]

LOCKING Order_Table for READ SELECT * FROM Order_Table ;

LOCKING Department_Table for WRITE NOWAIT INSERT INTO Department_Table (700, Shipping, 1000234, 450000) ;

Page 96 The SQL Quick Reference Guide

Simplicity by Design

LOCKING ROW FOR<desired- locking>

LOCKING ROW FOR ACCESS SELECT * FROM Customer_Table WHERE Customer_Name = ACE Consulting ;

LOCKING DATABASE<database- name> FOR <desired-locking>

LOCKING DATABASE Sql_Class FOR EXCLUSIVE MODIFY DATABASE Sql_Class AS Permanent = 5500000 BYTES ;

LOCKING VIEW<view-name> FOR <desired-locking>

LOCKING VIEW Employee_V FOR READ SELECT * FROM Employee_V ;

LOCKING TABLE<table -name> FOR <desired- locking>

LOCKING Department_Table for WRITE NOWAIT INSERT INTO Department_Table (700, Shipping, 1000234, 450000) ;

The SQL Quick Reference Guide Page 97

The SQL Reference Guide

Transaction Modes
Teradata offers two types of Transaction Modes in ANSI or Teradata mode. Teradata mode is called BTET, which stands for Begin Transaction End Transaction. The difference between the two modes is represented in the table below. One big key to remember is that users can utilize either mode and all SQL commands work in either mode.

Transaction Mode Types

TERADATA Mode ANSI Mode Data comparison is not case specific . Character literal values can be coded in the SQL as lower case or upper case. The search engine would view an A the same as an a and the data would be returned. Allows truncation of displayed data. Certain SQL commands covered in the chapter allow the user to request less characters be returned than the number of characters stored in a column. This is perfectly acceptable. A transaction is implicit by nature each SQL statement is a stand-alone transaction and the work committed upon a successful completion. A transaction can also be explicit with a BEGIN TRANSACTION (BT) command and an END TRANSACTION (ET) command. The presence of the ET command will cause all succes sfully completed SQL work to be committed and make it permanent. The CREATE TABLE will default to: SET table (no duplicate rows allowed) Non-case specific character data columns

Data comparison is case specific . Character literal values must be coded using the correct case in order for the search engine to determine a match. An A is different than an a and data would not be returned. Forbids truncation of display data. Any attempt to return less than all the data stored in a column will cause the SQL to fail with an error (3996).

All transactions are explicit only and at the end of a transaction a COMMIT WORK command is required in order to commit all successfully completed work and make it permanent.

The CREATE TABLE will default to: MULTISET table (duplicate rows allowed) Case specific character data columns

Page 98 The SQL Quick Reference Guide

Simplicity by Design

Setting the Transaction Mode


This syntax sets the mode to Teradata Mode , which is normally the default when a user logs in. This syntax is only to be used in BTEQ. .SET SESSION TR ANSACTION BTET ; The syntax places the user session into ANSI Mode , which is a Case Sensitive mode that requires the user to COMMIT WORK after transactions. This syntax is only to be used in BTEQ. .SET SESSION TRANSACTION ANSI ;

When setting the transaction mode in BTEQ, you must set the Transaction mode BEFORE logging onto the Teradata system. If you are already logged in and would like to change modes you must logoff, set the mode, and then log back on. Hint - Man

Teradata Transaction Mode (BT/ET) BT/ET allows for establishing a manual transactionwhile in Teradata mode . BT stands for Begin Transaction, ET stands for End Transaction. BT ; <SQL- statement> [ <SQL- statement>] ET ;
BT ; UPDATE Employee_Table SET Salary = Salary * 1.15 WHERE Employee_No = 1232578 ; .if errorcode > 0 then .quit 12 UPDATE Department_Table FROM Employee_Table AS E SET Budget = Budget + (Salary * .015) WHERE E.Dept_No = Department_Table.Dept_No AND E.Employee_No = 1232578 ; ET ;
Normally the BT/ET Statement is used in BTEQ. In BTEQ error checking is available. The above example is BTEQ Specific. For more information refer to Chapter 16 Teradata SQL: Unleash the Power book by Larkins and Coffing. Hint - Man

The SQL Quick Reference Guide Page 99

The SQL Reference Guide

Commit Work The Commit Work syntax is used only in ANSI Transaction Mode . It ensures that all transactions prior to the statement have been properly processed.

COMMIT WORK ;
UPDATE Employee_Table SET Salary = Salary * 1.15 WHERE Employee_No = 1232578 ; .if errorcode > 0 then .quit 12 UPDATE Department_Table FROM Employee_Table AS E SET Budget = Budget + (Salary * .015) WHERE E.Dept_No = Department_Table.Dept_No AND E.Employee_No = 1232578 ; COMMIT WORK ; Issues: User is in Teradata mode, therefore commit work is not needed. 3706: Syntax error: COMMIT WORK not allowed for a DBC/SQL session. Solutions: If there is a need to be in ANSI mode, a user must be running BTEQ . Before logging onto the Teradata system enter the .SET SESSION TRANSACTION ANSI command. This will put you in ANSI mode. If there is no need for ANSI mode simply remove COMMIT WORK or use the BT/ET SQL syntax.

Abort/Rollback These statements are used only in Teradata mode in the middle of a BT/ET Transaction. An alternative for this is simply logging off to end the session before the ET in the Transaction. ABORT; Or ROLLBACK;
BT ; SELECT * FROM Department_Table ; INSERT INTO Department_Table (800, Administration, 1423546, 250000) ; ABORT ; (Alternative: ROLLBACK ; )

Page 100

The SQL Quick Reference Guide

Simplicity by Design

Rollback Work This syntax is used to roll back a transaction while using ANSI Transaction Mode .

ROLLBACK WORK;

SELECT * FROM Department_Table ; INSERT INTO Department_Table

(800, Administration, 1423546, 250000) ;


ROLLBACK WORK ;

The example is written under the assumption the user is in ANSI Transaction Mode.

Hint - Man

Issues: User is in Teradata Mode, therefore this syntax is not valid. Use ABORT instead.

The SQL Quick Reference Guide Page 101

The SQL Reference Guide

Reporting Totals and Subtotals


Managers are always asking for detailed reports and information on performances broken down into various sections. In quoting Jim Carrey from the move Liar, Liar: And the truth shall set you free!!! Using WITH and WITH..BY will break down the truth, the whole truth, and nothing but the truth and result in detailed reports that are logical and easy to read. One big thing to remember is that these are to be used in BTEQ rather than Queryman.

Totals (WITH)
Using the WITH provides the user the ability to aggregate functions may be applied. Total a given <column-name> . All

SELECT <column- name> ,[, <column-name> ] FROM <table- name> WITH <aggregate-function>( <column-name> ) [ (TITLE <title-string>:) ] [...,<aggregate-function>( <column-name> ) [ (TITLE <title-string>:) ] ]
SELECT Dept_No, Dept_Name, Budget FROM Department_Table WITH SUM(Budget) (TITLE Total Budget) ;

English: The above example will select detail lines for Dept_No, Dept_Name, and Budget. At the end of the report a grand total for SUM(Budget) will be given.

SELECT Last_Name, First_Name, Dept_No, Salary FROM Employee_Table WITH AVG(Salary) ; , SUM(Salary) English: The above example will select detail lines for Last_Name, First_Name, Dept_No, and Salary. At the end of the report a grand total for AVG(Salary) and SUM(Salary) will be given.

This syntax can NOT be used in Queryman, so you must use BTEQ for this command.

Hint - Man

Issues: An aggregate function must be used in a WITH statement. 3504: Selected non-aggregate values must be part of the associated group. Solutions: Place an aggregate function of your choice in the WITH statement.

Page 102

The SQL Quick Reference Guide

Simplicity by Design

Subtotals (WITH..BY)
WITH..BY allows forsubtotalsbased on the BY <column-name> clause.

SELECT <column- name> ,<column- name> FROM <table- name> WITH SUM( <column-name> ) [...,<aggregate-function>( <column-name> ) ] BY <column-name> [ (TITLE <title-string>:) ] [ WITH SUM( <column-name> ) [...,<aggregate-function>( <column-name> ) ] ; BY <column-name> [ (TITLE <title-string>:) ] ]

SELECT Dept_No, Dept_Name, Budget FROM Department_Table WITH SUM(Budget) (TITLE Total Budget) BY Dept_No ; English: The above query will produce detail lines for Dept_No, Dept_Name, and Budget. It will also produce a SUM(Budget) subtotal for each Dept.

This syntax is not available in Queryman, but is supported in BTEQ. BTEQ is the recommended tool to use when creating reports with totals and subtotals. Hint - Man

Issues: An aggregate function must be used in a WITH..BY statement. 3504: Selected non-aggregate values must be part of the associated group.

Solutions: The way to fix this problem is to place the aggregate of choice after the WITH in the request statement.

The SQL Quick Reference Guide Page 103

The SQL Reference Guide

Multiple WITH..Bys
Using a combina tion of the WITH and WITH..BY functions can be very powerful. This allows the user to create complex reportsthat include both grand totals and subtotals.
SELECT Product_Id, Sale_Date, Daily_Sales FROM Sales_Table WITH SUM(Daily_Sales) (TITLE By Month) BY Sale_Date/100 WITH SUM(Daily_Sales) (TITLE By Product) BY Product_Id WITH SUM(Daily_Sales) WHERE Product_Id IN (1000, 2000) ORDER BY Sale_Date ; English: The above query will produce detail lines for Product_Id, Sale_Date, and Daily_Sales. It will then produce subtotals of SUM(Daily_Sales) By Month. Then another subtotal break of SUM(Daily_Sales) will be produced by Product within month. There will be a Grand_Total of SUM(Daily_Sales) at the end of the report.

Page 104

The SQL Quick Reference Guide

Simplicity by Design

Data Definition Language


If you use the keywords CREATE, DROP or ALTER you are using Data Definition Language. You are defining objects or the way objects look or function.

Create Table
Teradata is extremely flexible and allows the user to create a table without declaring a Primary Index. However, Teradata will assign by default a Non-Unique Primary Index on the first columnif a Primary Index is not defined in the Create Table statement. CREATE TABLE[<database- name>.]<table -name> ( <column-name> <data- type> [...,<column-name> <data- type> ] ) [UNIQUE] PRIMARY INDEX [<index-name>] (<column-name>) ;
CREATE TABLE SQL_CLASS.VENDOR_TABLE ( Vendor_Id INTEGER ,Vendor_Name VARCHAR(20) ,Phone_Number CHAR(8) ) UNIQUE PRIMARY INDEX (Vendor_Id) ;

Using the <database-name> to identify the table is known as qualifying, which is discussed in Appendix E. Hint - Man

*Detailed information on Data Types can be found in Appendix C.

The SQL Quick Reference Guide Page 105

The SQL Reference Guide

Multiple Column Primary Index Although multiple column Primary Indexes are allowed, it is recommended to use single column Primary Indexes whenever possible.

CREATE TABLE [<database- name>.]<table -name> ( <column-name> <data- type> [...,<column-name> <data- type> ] ) [UNIQUE] PRIMARY INDEX [<index-name>](<column- name> [..,<column-name>]) ;

CREATE TABLE SQL_CLASS.VENDOR_TABLE ( Vendor_Id INTEGER ,Vendor_Name VARCHAR(20) ,Phone_Number CHAR(8) ) UNIQUE PRIMARY INDEX VNDRIDX (Vendor_Id, Vendor_Name) ;

Issues: 3707: Syntax error, expected something like an 'UNIQUE' keyword between the word '<column-name>' and ','. The error is caused by not assigning a data type to a column that is being defined.

Solutions: The only way to fix this syntax is to look at the create statement and locate the column name that does not have a data type, then assign it a data type accordingly.

Page 106

The SQL Quick Reference Guide

Simplicity by Design

SET | MULTISET Table MULTISET Tables allow for . The default for multiple instances of the same row Teradata Mode is SET. The default for ANSI Mode is MULTISET. A SET table will throw out any rows that are complete duplicates. If you dont care which type you have it is better to have a Multi- Set table because SET tables must always compare rows for duplicates.

CREATE [SET | MULTISET]TABLE [<database- name>.]<table -name> ( <column-name> <data- type> [...,<column-name> <data- type> ] ) [UNIQUE] PRIMARY INDEX [<index-name>](<column- name>[,<column- name>]) ;

CREATE SET TABLE SQL_CLASS.VENDOR_TABLE ( Vendor_Id INTEGER ,Vendor_Name VARCHAR(20) ,Phone_Number CHAR(8) ) UNIQUE PRIMARY INDEX VNDRIDX(Vendor_Id, Vendor_Name) ;

CREATE MULTISET TABLE SQL_CLASS.VENDOR_TABLE ( Vendor_Id INTEGER ,Vendor_Name VARCHAR(20) ,Phone_Number CHAR(8) ) UNIQUE PRIMARY INDEX VNDRIDX(Vendor_Id, Vendor_Name) ;

MULTISET tables are quite useful when using Teradata for accounting purposes.

Hint - Man

Issues: A common error could be caused by having a spa ce in MULTISET. This is the error returned by Teradata: 3706: Syntax error: Expected GLOBAL TEMPORARY.

Solutions: The only solution to this is to remove the space in the MULTISET phrase.

The SQL Quick Reference Guide Page 107

The SQL Reference Guide

FALLBACK FALLBACK is a Table specific Teradata feature to protect against default is NO FALLBACK. AMP failure . The

CREATE [SET | MULTISET] TABLE [<database-name>.]<table - name> [, FALLBACK ] ( <column-name> <data- type> [...,<column-name> <data- type> ] ) [UNIQUE] PRIMARY INDEX [<index-name>](<column- name>[,<column- name>]) ;

CREATE SET TABLE SQL_CLASS.VENDOR_TABLE, ( Vendor_Id INTEGER ,Vendor_Name VARCHAR(20) ,Phone_Number CHAR(8) ) UNIQUE PRIMARY INDEX (Vendor_Id) ;

FALLBACK

You can FALLBACK protect all tables, no tables, or some tables. You can also add or drop FALLBACK at any time. Hint - Man

Issues: A missing comma between the <table -name> and FALLBACK. 3706: Syntax error: expected something between the word VENDOR_TABLE2 and the FALLBACK keyword.

Solutions: Simply place a comma before the FALLBACK keyword.

Page 108

The SQL Quick Reference Guide

Simplicity by Design

Permanent Journal There are three variances for the Permanent Journal: BEFORE, AFTER, DUAL BEFORE/DUAL AFTER. The BEFORE Journal takes a picture of the affected rows before any changes are made. The AFTER Journaltakes a picture of the affected rows after any changes are made. The DUAL BEFORE or DUAL AFTER Journal takes two pictures before the rows are changed and saves them on two different AMPs. The DUAL AFTER Jounal takes two pictures after that rows are changed and stores them on two different AMPs . All the pictures are stored on disk, so be sure to purge the Journalafter a full system backup.

CREATE [SET | MULTISET] TABLE [<database-name>.]<table - name> [, FALLBACK ] [, [DUAL ] BEFORE JOURNAL ] [, [DUAL ] AFTER JOURNAL ] ( <column-name> <data- type> [...,<column-name> <data- type> ] ) [UNIQUE] PRIMARY INDEX [<index-name>](<column- name>[,<column- name>]) ;

CREATE SET TABLE SQL_CLASS.VENDOR_TABLE, FALLBACK , BEFORE JOURNAL ( Vendor_Id INTEGER ,Vendor_Name VARCHAR(20) ,Phone_Number CHAR(8) ) UNIQUE PRIMARY INDEX VNDRIDX(Vendor_Id, Vendor_Name) ;

CREATE SET TABLE SQL_CLASS.VENDOR_TABLE, FALLBACK , AFTER JOURNAL ( Vendor_Id INTEGER ,Vendor_Name VARCHAR(20) ,Phone_Number CHAR(8) ) UNIQUE PRIMARY INDEX VNDRIDX(Vendor_Id, Vendor_Name) ;

CREATE SET TABLE SQL_CLASS.VENDOR_TABLE, FALLBACK , DUAL BEFORE JOURNAL, DUAL AFTER JOURNAL ( Vendor_Id INTEGER ,Vendor_Name VARCHAR(20) ,Phone_Number CHAR(8) ) UNIQUE PRIMARY INDEX VNDRIDX(Vendor_Id, Vendor_Name) ;

The most common journal is the AFTER JOURNAL. This will be used in conjunction with Full System Backups. If a crash occurs the DBA can go to the last Full System Backup and then add the After Journal. Hint - Man

The SQL Quick Reference Guide Page 109

The SQL Reference Guide

Add Column Attributes CREATE [SET | MULTISET] TABLE [<database-name>.]<table - name> [, FALLBACK ] [, [DUAL ] BEFORE JOURNAL ] [, [DUAL ] AFTER JOURNAL ] ( <column-name> <data- type>[<column-level-attribute>] [...,<column-name> <data- type> ][<column-level-attribute>]) [UNIQUE] PRIMARY INDEX [<index-name>](<column- name>[,<column- name>]) ;

The following is a list of all the column level attributes.

Hint - Man

UPPERCASE Convert and store entered data in uppercase CASESPECIFIC Treat data as case specific for all comparisons FORMAT Establishes the display format TITLE Establishes the title attribute NAMED Establishes an alias name WITH DEFAULT Default numeric values to zero, characters values to blanks DEFAULT DATE Use todays date as default value DEFAULT TIME Use current time as default value COMPRESS Compress nulls to take no disk space COMPRESS NULL Compress nulls to take no disk space COMPRESS <value> Compress specified value to take no disk space. The value is stored one time in the table header. CHARACTER SET Establishes the computer internal storage rules and how it should be interpreted. i.e. LATIN and KANJI NOT NULL Disallow nulls to be stored in the column DEFAULT Value Use default value if null entered DEFAULT User Use the users ID as the default value for the column DEFAULT NULL Use null as the default value for the column

CREATE SET TABLE SQL_CLASS.VENDOR_TABLE, FALLBACK , BEFORE JOURNAL ( Vendor_Id INTEGER NOT NULL ,Vendor_Name VARCHAR(20) TITLE Vendor Name ,Phone_Number CHAR(8) DEFAULT NULL ) UNIQUE PRIMARY INDEX (Vendor_Id) ;

Page 110

The SQL Quick Reference Guide

Simplicity by Design

Column and Table Constraints CREATE [SET | MULTISET] TABLE [<database-name>.]<table - name> [, FALLBACK ] [, [DUAL ] BEFORE JOURNAL ] [, [DUAL ] AFTER JOURNAL ] ( <column-name> <data- type> [<column-level-attribute>] [<column-level-constraint>] [...,<column-name> <data- type>][<column-level- attribute>] [<column-level-constraint>]) [UNIQUE] PRIMARY INDEX [<index-name>](<column- name>[,<column- name>]) [<column-level-constraint>] [ ,<column-level-constraint>];

For more information and examples refer to Teradata SQL: Unleash the Power, Chapter 18. Hint - Man

This chart is used to determine the level constraints can be named: Used as Column Level Used as Table Level Constraint PRIMARY KEY Yes Yes UNIQUE Yes Yes CHECK Yes Yes REFERENCES Yes Yes FOREIGN KEY No Yes This chart is used to determine the functio n of the constraints: PRIMARY KEY A PRIMARY KEY enforces uniqueness. You must have the NOT NULL constraint also defined when defining a PRIMARY KEY. UNIQUE UNIQUE enforces uniqueness on a column. You must have the NOT NULL constraint also defined when defining a UNIQUE constraint. CHECK Allows range or value constraints to be placed on the column. REFERENCES Requests a referential integrity check. This requires values to be reference checked or selected from another table before accepting a new row into this table CREATE SET TABLE SQL_CLASS.VENDOR_TABLE, FALLBACK , BEFORE JOURNAL ( Vendor_Id INTEGER NOT NULL CONSTRAINT UNIQUE_1 UNIQUE ,Vendor_Name VARCHAR(20) TITLE Vendor Name ,Phone_Number CHAR(8) DEFAULT NULL );

The SQL Quick Reference Guide Page 111

The SQL Reference Guide

CREATE TABLE with copying an existing table The Teradata Lingo for this syntax is the this statement isNO DATA . Create Table AS statement. The default for

CREATE TABLE [<database- name>.]<table -name> { <SELECT-statement>} WITH { DATA | NO DATA } [ [ UNIQUE ] PRIMARY INDEX (<column-list>) ] ;

AS

CREATE TABLE SQL_CLASS.Employee_Table2 AS ( SELECT * FROM Employee_Table ) WITH DATA ;

English: The above example will CREATE a table called Employee_Table2 in the SQL_CLASS database that has the exact same structure as the Employee_Table. The data from the Employee_Table is also copied into the Employee_Table2 table.

CREATE TABLE SQL_CLASS.Employee_Table2 AS ( SELECT * FROM Employee_Table ) WITH NO DATA UNIQUE PRIMARY INDEX(Employee_Id) ;

English: The above example will CREATE a table called Employee_Table2 in the SQL_CLASS Database that has the exact same structure as the Employee_Table, but the data is not copied. The new table is completely empty of data.

For more information and examples refer to Teradata SQL: Unleash the Power book by Larkins and Coffing, Chapter 18. Hint - Man

Page 112

The SQL Quick Reference Guide

Simplicity by Design

ALTER Table
ALTER TABLE is used to modify a Table or column level attribute and constraint user may not change column names, but adding or dropping columns are permissible. If column changes are required, then the table must be dropped and re- created with the column name changes included. ALTER TABLE[<database-name>.]<table- name> [, <table- level- attributes> ] [ WITH JOURNAL TABLE = <table- name> ] [ ADD <column-name>[<data-type>][<attribute-list>][<column-level-constraint>] ] [ DROP <column-name>] [ ADD <table-level-constraint> ] [ MODIFY <table-level-constraint> ] [ DROP <table-level-constraint> ] ; .A

ALTER TABLE SQL_CLASS. Vendor_Table NO BEFORE JOURNAL, AFTER JOURNAL ADD Vendor_Desc VARCHAR(65), DROP VENPK ;

ALTER TABLE SQL_CLASS.Course_Table ADD Prerequisites VARCHAR(150) TITLE Prereqs ADD CONSTRAINT COURSE_Unique UNIQUE(Course_Name)

In the first example VENPK is a <table-level-constraint> defined in the example section of Column and Table Constraints. Hint - Man

Issues: The table being altered does not exist. 3807: Table/view/trigger Course_Table2 does not exist.

Solutions: There are two possible causes and they are a misspelled <table -name> or you may be looking in the wrong database. To solve both causes run HELP DATABASE <database-name> to do research about the table you are looking to alter.

The SQL Quick Reference Guide Page 113

The SQL Reference Guide

DROP Table
If a user is looking to permanently remove a table from the Teradata Warehouse, this is the proper SQL to run. However, unlike other databases, Teradata is capable of deleting all rows of a table very quickly. It is recommended to delete all rows rather than drop a table and recreating it.

; DROP TABLE[<data-base- name>.]<table -name>

DROP TABLE SQL_CLASS.Vendor_Table ;

It is recommended to delete all rows rather than drop a table and recreating it. The DELETE Syntax is addressed in the Data Manipulation Section of the book. Hint - Man

Issues: The table being dropped does not exist. exist.

3807: Table/view/trigger Course_Table2 does not

Solutions: There are two possible causes are a misspelled <table-name> or you may be looking in the wrong database. To solve both causes run HELP DATABASE <database-name> to do research about the table you are looking to alter.

Page 114

The SQL Quick Reference Guide

Simplicity by Design

RENAME Table
When renaming a table, the <database- name> cannot be changed. RENAME TABLE [database-name>.]<table - name> TO[database-name>.]<table- name> ;

RENAME TABLE SQL_CLASS.Department_Table TO SQL_CLASS.Dept_Table ;

If there is a need to have a table with the same structure in a separate database, use the CREATE TABLE AS syntax which can be located in the Data Definition Language section of this book. Hint - Man

Issues: The table being renamed does not exist. 3807: Table/view/trigger Course_Table2 does not exist.

Solutions: There are two possible causes are a misspelled <table -name> or you may be looking in the wrong database. To solve both causes run HELP DATABASE <database-name> to do research about the table you are looking to alter.

The SQL Quick Reference Guide Page 115

The SQL Reference Guide

Secondary Indexes
Secondary Indexes are used in Teradata as another method to accessing data . Value Ordered NUSIs are limited to numeric values that are no larger than 4 bytes long. Also, the index name is optional. CREATE [UNIQUE] INDEX [ <index-name> ] (<column-list>) [ORDER BY VALUES [ (<column-list>) ] ] on [database.]<table-name> [ALL] ;
CREATE UNIQUE INDEX (Course_Name) ON SQL_CLASS.Course_Table ; English: Above we have created a Unique Secondary Index (USI) on Course_Name.

CREATE INDEX (Course_Id) ORDER BY VALUES ON SQL_CLASS.Student_Course_Table ; English: Above we have created a Value -Ordered NUSI on Course_Id. CREATE INDEX Full_Name_Idx(First_Name,Last_Name) ON SQL_CLASS.Employee_Table ; English: Above we have created a Multi-Key Non-Unique Secondary Index (NUSI) on First_Name and Last_Name combined. We have given the index a name called Full_Name_Idx.

Refer to the Teradata Users Guide by T.Coffing, L.Coffing, C.Coffing, S.Wilmes and R.Hines for further information on Secondary Index selection and Performance Optimization. Hint - Man

A Unique Secondary Index (USI) is always a two -AMP retrieve when the USI column is used in the WHERE clause of the SQL. Hint - Man A Non-Unique Secondary Index (NUSI) is an All-AMP operation, but not a Full Table Scan (FTS).

DROP INDEX { <index- name> | (<column- list>) } ;

DROP INDEX Crs_Nm_Indx ;

Page 116

The SQL Quick Reference Guide

Simplicity by Design

Join Indexes
Join Indexes provide the means of improving performanceon any type of recurring query that involves joins and/or aggregate functions. A Join Index pre-joins tables and physically keeps them on disks. The Teradata optimizer will decide whether a query can run faster on the base tables or with the Join Index table. The Join Index table will be kept current by Teradata if the base tables change. CREATE JOIN INDEX [<database-name>.]<join- index-name> [[NO] FALLBACK] AS SELECT [<columns>] [SUM numeric -expression] [COUNT column- expression] [EXTRACT year | month from date- expression] FROM [<database-name(s)>.]<table- names>] [WHERE <search- condition>] [GROUP BY <column- name>] [ORDER BY <column-name>] PRIMARY INDEX(<column- name>) [index <column-name> ORDER by HASH | VALUES] ;
CREATE JOIN INDEX SQL_CLASS.Course_Roster NO FALLBACK AS SELECT STU.Last_name ,STU.First_name ,STU.Class_code ,COUR.Course_name ,COUR.Credits ,STU_COUR.Student_ID FROM Student_table STU INNER JOIN Student_Course_Table STU_COUR ON STU.Student_ID = STU_COUR.Student_ID INNER JOIN Course_Table COUR ON STU_COUR.Course_ID = COUR.Course_ID;

Hint - Man

Teradata Versions V2R4.1.2xx and later allows for single table join indexes to be created. This is extremely beneficial when you create a single table join index on larger tables that are being utilized in joins with smaller tables. In addition, single table join indexes do not require all the columns to be listed in order for Teradata to utilize the join index. Partial covering of the join index is supported, which provides a significant performance enhancement and greatly flexibility.

DROP JOIN INDEX [<database-name>.]<join-index- name>;


DROP JOIN INDEX SQL_CLASS.Student_Table_Indx ;

The SQL Quick Reference Guide Page 117

The SQL Reference Guide

Collect Statistics
This is a very important part of optimizing and maintainingthe Teradata System. When a query is run the Parsing Engine (PE) optimizer will check if statistics were run on the table. Collect statistics will tell the PE what the data demographics are in order for the PE to come up with a plan for the AMPs to get the data. You can collect statistics at the column or index level.

COLLECT STATISTICS ON[ TEMPORARY ] <table - name> | <join-index- name> [ { COLUMN <column-name> | INDEX(<column- list>) } ] ;

COLLECT STATISTICS ON Employee_Table column Last_Name ; English: Above we collect statistics on the column Last_Name in the Employee_Table. COLLECT STATISTICS ON Employee_Table ; index(Last_Name, First_Name) English: Above we collect statistics on the multi-column index of Last_Name and First_Name.

COLLECT STATISTICS ON Employee_Table English: Above we refresh statistics on all columns and indexes that have current statistics.

Hint - Man

Collecting Statistics causes a Full Table Scan (FTS) and should be done during off hours. You dont collect on every index and column in a table. Collect Statistics for all NonUnique Secondary Indexes, columns used in the WHERE clause on queries or joins, and on Primary indexes of all small tables.

Refresh statistics when a table adds or deletes data and this changes the table by more than 10%. Always collect statistics at the column level even if a column is an index. The exception to this rule is on Multi-Column indexes. Hint - Man

Page 118

The SQL Quick Reference Guide

Simplicity by Design

HELP STATISTICS HELP STATISTICS is used to discover what columns and indexes have statistics run on them. Information returned contains the time and date statistics of when last time statistics were collected. HELPSTATISTICS <table-name> ;
HELP STATISTICS Student_Table ;

DROP STATISTICS DROP STATISTICS is recommended when the decision has been made to statistics on the given <table -name>. no longer keep

DROP STATISTICS ON [ TEMPORARY ] <table-name> | <join- index-name> [ { COLUMN <column-name> | INDEX(<column- list>) } ] ;

DROP STATISTICS ON SQL_CLASS.Department_Table ;

DROP STATISTICS ON Student_Table


INDEX (Last_Name) ;

The SQL Quick Reference Guide Page 119

The SQL Reference Guide

CREATE DATABASE
You create a database to normally hold objects such as Tables, Views, Macros, Triggers, and Stored Procedures. A Database and a User are almost the same in Teradata because both can have Perm and Spool space, which allow them to hold objects. The only difference between a user and a database is that a user has a password and can logon and run queries.

{ CREATE | MODIFY } DATABASE <database-name> FROM <parent-database-name> AS [ PERM[ANENT] = <num-of-bytes> SPOOL = <num-of-bytes> TEMPORARY = <num-of-bytes> ACCOUNT = <acctid> [NO] FALLBACK [NO | DUAL] BEFORE JOURNAL [NO | DUAL | LOCAL | NOT LOCAL] AFTER JOURNAL DEFAULT JOURNAL TABLE = <database-name>.<table-name> ] ;

, , , , , , ,

CREATE DATABASE SQL_CLASS2 FROM SYSADMIN AS PERM = 5000000 SPOOL = 2000000 TEMPORARY = 1000000 ACCOUNT = carrolltg NO FALLBACK NO BEFORE JOURNAL NO AFTER JOURNAL DEFAULT JOURNAL TABLE = SQL_CLASS2.Journal_Table ;

When defining the upper limit for Perm space, remember to have enough disk space in the system to have 20% in Spool Reserve. Its a good idea to research the impact on the system when creating large databases. Hint - Man

Page 120

The SQL Quick Reference Guide

Simplicity by Design

CREATE USER
You create a USER so that user can logon to Teradata and run queries. A user in Teradata can hold objects such as Tables, Views, Macros, Triggers, and Stored Procedures. A Database and a User are almost the same in Teradata because both can have Perm and Spool space, which allow them to hold objects. The only difference between a user and a database is that a user has a password and can logon and run queries.

{ CREATE | MODIFY } USER <user-name> FROM <parent-database-name> AS PERM[ANENT] = <num-of-bytes> PASSWORD = { <password> | NULL } [ ,STARTUP = <string> ,SPOOL = <num-of-bytes> ,TEMPORARY = <num-of-bytes> ,DEFAULT DATABASE = <database-name> ,COLLATION = <collation-sequence> ,ACCOUNT = <acctid> ,[NO] FALLBACK ,[NO | DUAL] BEFORE JOURNAL ,[NO | DUAL | LOCAL | NOT LOCAL] AFTER JOURNAL ,DEFAULT JOURNAL TABLE = <database-name>.<table-name> ] ;

, , , , , , , , , ,

CREATE USER SQL26 FROM SQL00 AS PERM = 1000000 PASSWORD = SQL26 STARTUP = SET SESSION ANSI; SPOOL = 10000000 TEMPORARY = 5000000 DEFAULT DATABASE = SQL_CLASS COLLATION = HOST ACCOUNT = carrolltg NO FALLBACK NO BEFORE JOURNAL NO AFTER JOURNAL ;

Teradata views a User as a Database with a password. A User may store all objects in its PERM space, and behave exactly like a database. Hint - Man

The SQL Quick Reference Guide Page 121

The SQL Reference Guide

DROP DATABASE or USER


This syntax will remove the DDL of a User or Database from the Data Dictionary. DROP { DATABASE | USER } <database-name> ;

DROP DATABASE SQL_CLASS ;

DROP USER SQL00 ;

Page 122

The SQL Quick Reference Guide

Simplicity by Design

Hashing Functions
Hashing functions allow users to see how data is distributed across the AMPs. Even data distribution can be very important to Teradata because Teradata processes data in parallel.

HASHROW The HASHROW function returns an 8- digit Hexidecimal number, which represents the result of putting the <data-column-value> into Teradatas Hash Formula. SELECT HASHROW( [ <data- column-value> [..., <data- column- value> ] ] ) ;

SELECT HASHROW (Dept_No) from Department_Table ;

SELECT COUNT(*) / COUNT(DISTINCT( AS AVG_ROW_CNT FROM Student_Table ;

HASHROW (Student_Id)))

A great demonstration of how to use this function powerfully is in the second example.

Hint - Man

The SQL Quick Reference Guide Page 123

The SQL Reference Guide

HASHBUCKET This function produces the 16-bit binary Hash Bucket from the Data Distribution Hash Map. The result will be between 0 and 65536. The input into this function is the 32- bit Row Hash value, which can be produced using the HASHROW function. SELECT HASHBUCKET( [ <row- hash-value> ] ) ;
SELECT COUNT(*), HASHBUCKET (HASHROW(Student_Id)) AS Bucket FROM Student_Table ;
Group by Bucket

Issues: A 32-bit row hash value was not plugged into the function. type for the HASHBUCKET function is invalid.

3794: The argument

HASHAMP HASHAMP returns the identification number for the AMP in which the hash bucket number points to. The correct application is using HASHBUCKET and HASHROW together. A proper use of this function would be to place the Primary Index column in the formula to discover the distribution among all the AMPs in the system. SELECT HASHAMP( <hash-bucket> ) ;

SELECT HASHAMP (HASHBUCKET(HASHROW(Student_Id))) FROM Student_Table ;

HASHBAKAMP HASHBAKAMP identifies the FALLBACK AMP for a given hash bucket number. Just as HASHAMP a correct application is with HASHBUCKET and HASHROW. SELECT HASHBAKAMP ( <hash-bucket> ) ;

SELECT HASHBAKAMP (HASHBUCKET(HASHROW(Student_Id))) FROM Student_Table ;

Page 124

The SQL Quick Reference Guide

Simplicity by Design

Temporary Tables
Teradata allows users to create Temporary tables with great ease. There are three types of Temporary tables in Derived, Volatile, and Global Temporary tables. Each is described below.

Derived Tables
Derived tables exist for the length of time it takes to run the query . The derived table definition begins after the FROM clause in the statement and are automatically deleted at query end. The space to material the rows comes from the users SPOOL space. SELECT <column- name> [..., <column- name> ] FROM ( SELECT <column-name> [ AS <alias-name> ] [ ,<column-name> ] FROM <table-name> ) <Derived-table-name> [ ( <alias-name> [,<alias-name> ] )
SELECT * FROM (SELECT MIN(SALARY) FROM Employee_Table) DT (Min_Sal) ;

SELECT L_Name, F_Name, CC FROM (SELECT Last_Name, First_Name, Class_Code FROM Student_Table WHERE Grade_Pt >= 3.0 ) DT (L_Name, F_Name, CC) SELECT Dept_No, Dept_Name, AVG_Budget FROM (SELECT AVG(Budget) FROM Department_Table) DT (AVG_Budget), Department_Table ORDER BY Dept_No ;

Once the result set is returned to the user, the derived table no longer exists. For more detailed information and examples refer to Chapter 19, Teradata SQL: Unleash the Power by Larkins and Coffing. Hint - Man

Issues: The derived table has not been given a name. 3707: Syntax error, expected something like a name between ) and ; Solutions: The only way to fix this is to place a DT at the end of the derived table declaration.

The SQL Quick Reference Guide Page 125

The SQL Reference Guide

Volatile Temporary Tables


Volatile Temporary Table, or Volatile Table, is available throughout the user session . A user may log onto the Teradata system, create a Volatile Table and use it until logging off. The LOG option allows a Volatile Table to use the Transient Journal during transactions. The ON COMMIT clause gives two options to the user: whether to keep the rows in the table after a transaction, or to have the rows deleted upon a comp lete transaction. The default value is ON COMMIT DELETE ROWS, so users beware!

CREATE VOLATILETABLE <table -name> [ , { LOG | NO LOG} ] ( <column-name> <data- type> [ , <column-name> <data- type> [ , <column-name> <data- type> ] ) [ [ UNIQUE ] PRIMARY INDEX (<column-list>) ] [ ON COMMIT { PRESERVE | DELETE } ROWS ] ;
CREATE ( Sale_Date ,Sum_Sale ,Avg_Sale ,Max_Sale ,Min_Sale ) VOLATILE TABLE Sales_Report_vt, LOG DATE DECIMAL(9,2) DECIMAL(7,2) DECIMAL(7,2) DECIMAL(7,2) ON COMMIT PRESERVE ROWS ; Now that the Volatile Table has been created, the table must be populated with an INSERT/SELECT statement like the following:

INSERT INTO Sales_Report_vt SELECT Sale_Date ,SUM(Daily_Sales) ,AVG(Daily_Sales) ,MAX(Daily_Sales) ,MIN(Daily_Sales) FROM Sales_Table GROUP BY Sale_Date;

Hint - Man

Imagine you have to get monthly information from a yearly table. A great idea is to create a Volatile table. INSERT into the table the information from the specific month and then run your queries. In theory, they should run 12 times faster than if you queried the yearly table. When you logoff the table is deleted. The space comes from the users spool space.

Page 126

The SQL Quick Reference Guide

Simplicity by Design

Global Temporary Tables


CREATE GLOBAL TEMPORARY TABLE Global Temporary Tables, or Global Tables are a new breed of temporary table that is very powerful. The definition of the table is stored in the Data Dictionary and that allows for multiple users to have access to the table definition. However, each user may put different data into their own copy of the table definition. CREATE GLOBAL TEMPORARY TABLE <table -name> ( <column-name> <data- type> [ , <column-name> <data- type> ] [ [ UNIQUE ] PRIMARY INDEX (<column-list>) ] [ ON COMMIT { PRESERVE | DELETE } ROWS ] ; [ { LOG | NO LOG} ]

CREATE GLOBAL TEMPORARY TABLE Sales_Report_gt, LOG ( Sale_Date DATE ,Sum_Sale DECIMAL(9,2) ,Avg_Sale DECIMAL(7,2) ,Max_Sale DECIMAL(7,2) ,Min_Sale DECIMAL(7,2) ) PRIMARY INDEX(Sale_Date) ON COMMIT PRESERVE ROWS ;
If a user desires to remove the table definition from the Data Dictionary the user must implement a DROP TABLE command. The LOG option allows a Temp Table to use the Transient Journal during transactions. Hint - Man

To materialize a copy of the Global Temp definition and populate it perform the following syntax:

INSERT INTO Sales_Report_gt SELECT Sale_Date ,SUM(Daily_Sales) ,AVG(Daily_Sales) ,MAX(Daily_Sales) ,MIN(Daily_Sales) FROM Sales_Table GROUP BY Sale_Date ;

The SQL Quick Reference Guide Page 127

The SQL Reference Guide

DROP TEMPORARY TABLE


This syntax removes any temporary table . However it Temporary table definitionfrom the Data Dictionary. DROP TEMPORARYTABLE <table -name> ; will not drop the Global

DROP

TEMPORARYTABLE Sales_Report_vt ;

Issues: The temporary table does not exist in the user session. 3807: Table/view/trigger <table-name> does not exist.

Page 128

The SQL Quick Reference Guide

Simplicity by Design

Triggers
When dealing with triggers, a user must understand the difference between the two types of triggers: Row Triggers and Statement Triggers. Both are mutually exclusive, meaning that a created trigger can either be a Row Trigger type or a Statement Trigger type but not both. A Row Trigger fires off for each row that is affected by the triggering statement. A Statement Trigger fires off only once per triggering statement. Triggers are most widely used as a means for Referential Integrity.

BEFORE Triggers
In this scenario, the <TRIGGERED ACTION> is being performed <TRIGGERING ACTION>. beforethe specific

CREATE TRIGGER <Trigger-name> BEFORE <TRIGGERING ACTION > {INSERT | UPDATE | DELETE | INSERT/SELECT} [ OF (<column-name>, ) ] ON <subject- table> REFERENCING OLD_TABLE AS <before -image> NEW_TABLE AS <after-image> { FOR EACH STATEMENT | FOR EACH ROW } [ WHEN ( optional condition ) ] ( <TRIGGERED ACTION> { INSERT | IN SERT/SELECT | UPDATE | DELETE | ABORT/ROLLBACK | EXEC } ; )
CREATE TRIGGER CUST_ORD_TRIG BEFORE INSERT ON Order_Table REFERENCING NEW AS ord_row FOR EACH ROW WHEN (ord_row.customer_number NOT IN (SELECT customer_number FROM Customer_Table)) (INSERT INTO Customer_Table VALUES (ord_row.customer_number, Customer Name, 999-9999););
A good example would be when inserting a new order into the Order_Table, a trigger could be created to ensure the Customer who is making the order exists in the Customer_Table. If not, then insert a row into the Customer_Table BEFORE inserting a row into the Order_Table. The above example illustrates this scenario.

Hint - Man

Issues: There is not a FOR EACH ROW or FOR EACH STATEMENT clause present in the code. 5423: This trigger contains an invalid REFERENCING clause.

Solutions: Fixing this problem is as simple as deciding whether to use the FOR EACH ROW or the FOR EACH STATEMENT, and then adding in the statement after the BEFORE INSERT ON <table -name> command.

The SQL Quick Reference Guide Page 129

The SQL Reference Guide

AFTER Triggers
The AFTER Trigger, causes the <TRIGGERED ACTION> to fire afterthe <TRIGGERING ACTION> is performed. The importing thing to remember is that an AFTER Trigger is helpful for making changes on one table depending on the modifications of another table. CREATE TRIGGER <Trigger- name> AFTER <TRIGGERING ACTION > {INSERT | UPDATE | DELETE | INSERT/SELECT} [ OF (<column- name>, ) ] ON <subject- table> REFERENCING OLD_TABLE AS <before- image> NEW_TABLE AS <after- image> { FOR EACH STATEMENT | FOR EACH ROW } [ WHEN ( optional condition ) ] ( <TRIGGERED ACTION> { INSERT | INSERT/SELECT | UPDATE | DELETE | ABORT/ROLLBACK | EXEC } ; ) ;

CREATE TRIGGER Salary_Fraud_Trig AFTER UPDATE OF (salary) ON Employee_Table before_row REFERENCING OLD AS NEW AS after_row FOR EACH ROW WHEN ((after_row.salary before_row) / before_row.salary > .10 ) (INSERT INTO Salary_Fraud VALUES (after_row.employee_no, before_row.salary, after_row.salary, DATE) ;) ;

A good application would be a table that is updated if any employees salary is raised more than 10%. This would be useful to detect any type of salary fraud within the company. The above example reflects this scenario. Hint - Man

Page 130

The SQL Quick Reference Guide

Simplicity by Design

INSTEAD OF Triggers
This style of trigger is fairly direct. It tells Teradata to do the <TRIGGERED ACTION> place of the <TRIGGERING ACTION>. CREATE TRIGGER <Trigger- name> INSTEAD OF <TRIGGERING ACTION > {INSERT | UPDATE | DELETE | INSERT/SELECT} [ OF (<column- name>, ) ] ON <subject- table> REFERENCING OLD_TABLE AS <before- image> NEW_TABLE AS <after- image> { FOR EACH STATEMENT | FOR EACH ROW } [ WHEN ( optional condition ) ] ( <TRIGGERED ACTION> { INSERT | INSERT/SELECT | UPDATE | DELETE | ABORT/ROLLBACK | EXEC } ; ) ; in

CREATE TRIGGER New_Student_Trig INSTEAD OF Student_Table INSERT ON REFERENCING NEW AS newstu FOR EACH STATEMENT (INSERT INTO New_Student_Table Select * from newstu; ) ;

Hint - Man

A Database Administrator may want to keep track of and maintain any new rows added into the Student_Table. What this means is that the INSTEAD OF Trigger, will place any new rows inserted into the Student_Table in a separate table. Then at a later time the new rows can be placed into the Student _Table. The example of this scenario follows.

The SQL Quick Reference Guide Page 131

The SQL Reference Guide

Sequencing Triggers
The idea behind sequencing triggers is to set an order of operations for triggers that are set off by the same event. This is to allow the Database Administrator flexibility to place a preference on one trigger over another one. A User may number their triggers (1 through 32,767). Order 1 triggers will be kicked off before Order 2 triggers, etc . CREATE TRIGGER <Trigger- name> {BEFORE | AFTER | INSTEAD OF} [ ORDER <sequence -number> ] <TRIGGERING ACTION > {INSERT | UPDATE | DELETE | INSERT/SELECT} [ OF (<column- name>, ) ] ON <subject- table> REFERENCING OLD_TABLE AS <before- image> NEW_TABLE AS <after- image> FOR EACH STATEMENT [ WHEN ( optional condition ) ] ( <TRIGGERED ACTION> { INSERT | INSERT/SELECT | UPDATE | DELETE | ABORT/ROLLBACK | EXEC } ; ) ;
CREATE TRIGGER Save_GPA_Trig BEFORE UPDATE ON Student_Table REFERENCING NEW AS new_row OLD AS old_row FOR EACH ROW WHEN (new_row.Grade_pt <> old_row.Grade_pt) (INSERT INTO Save_GPA_Table VALUES (old_row.Student_Id, old_row.Grade_pt) ; ); ORDER 100

CREATE TRIGGER GPA_Fraud_Trig BEFORE UPDATE ON Student_Table ORDER 150 REFERENCING NEW AS new_row OLD AS old_row FOR EACH ROW WHEN(new_row.Grade_pt <> old_row.Grade_pt) (INSERT INTO GPA_Fraud_Table VALUES (old_row.Student_Id, old_row.Grade_pt, new_row.Grade_pt); );

Issues: 5432: A trigger Order value must be within a range of 0 to 32767. Ordering triggers is important, but you need to keep the range in mind.

Solutions: Locate the ORDER statement and replace the <sequence-number> with a number between 0 and 32767.

Page 132

The SQL Quick Reference Guide

Simplicity by Design

APPENDIX A: Current Reserved Words


The following list indicates all of the Teradata release V2R4.1 reserved words. These are words that need to be avoided when creating database objects. If they are used for anything other than their reserved meaning, they will need to be enclosed in double quotes (). - AABORT ABORTSESSION ABS ACCESS_LOCK ACCOUNT ADD ADD_MONTHS AFTER ALL ALTER AMP AND ANSIDATE ANY AS ASC AT ATOMI C AVE AVERAGE AVG

- BBEFORE BEGIN BETWEEN BOTH BT BUT BY BYTE BYTEINT BYTES

- CCALL CASE CASESPECIFIC CAST CD CHAR CHARACTER CHARACTERS CHARACTER_LENGTH CHARS CHAR2HEXINT CHAR_LENGTH CHECK CHECKPOINT CLUSTER CM COALESCE COLLATION COLLECTCOLUMN COMMENT COMMIT COMPRESS CONSTRAINT CONTINUE CONVERT_TABLE_HEADER CORR OLAP COUNT COVAR_POP CREATE CROSS CS CSUM CT CURRENT CURRENT_DATE CURRENT_TIME CURRENT_TIMESTAMP CURSOR CV

- DDATABASE DATABLOCKSIZE DATE DATEFORM DAY DEC DECIMAL DECLARE DEFAULT DEL DELETE DESC DIAGNOSTIC DISABLED DISTINCT DO DOUBLE DROP DUAL DUMP

- EEACH ECHO ELSE ELSEIF ENABLED END EQ ERROR ERRORFILES ERRORTABLES ESCAPE ET EXCEPT EXEC EXECUTE EXISTS EXIT EXP EXPLAIN EXTRACT

The SQL Quick Reference Guide Page 133

The SQL Reference Guide

Current Reserved Words (continued)


- FFALLBACK FASTEXPORT FLOAT FOR FOREIGN FORMAT FREESPACE FROM FULL

- GGCOUNT OLAP GE GIVE GRAPHIC GROUP GSUM GRANT GT

- HHANDLER HASH HASHAMP HASHBAKAMP HASHBUCKET HASHROW HAVING HELP HOUR

- IIF IMMEDIATE IN INCONSISTENT INDEX INITIATE INNER INOUT INS INSERT INSTEAD INT INTEGER INTEGERDATE INTERSECT INTERVAL INTO IS ITERATE

- JJOIN JOURNAL

- KKEY KURTOSIS

- LLE LEADING LEAVE LEFT LIKE LN LOADING LOCAL LOCK LOCKING LOG LOGGING LOGON LONG LOOP LOWER LT

-MMACRO MAVG MAX MAXIMUM MCHARACTERS MDIFF MIN MINDEX MINIMUM MINUS MINUTE MLINREG MLOAD MOD MODE MODIFY MONITOR MONRESOURCE MONSESSION MONTH MSUBSTR MSUM MULTISET

Page 134

The SQL Quick Reference Guide

Simplicity by Design

Current Reserved Words (continued)


- NNAMED NATURAL NE NEW NEW_TABLE NO NOT NOWAIT NULL NULLIF NULLIFZERO NUMERIC

- OOCTET_LENGTH OF OFF OLD OLD_TABLE ON OPTION OR ORDER OUT OUTER OVER OVERLAPS OVERRIDE

- PPASSWORD PERCENT PERM PERMANENT POSITION PRECISION PRESERVE PRIMARY PRIVILEGES PROCEDURE PROTECTION PUBLIC

- QQUALIFY QUANTILE

- RRANDOM RANK REAL REFERENCES REFERENCING REGR_INTERCEPT REGR_SLOPE RELEASE RENAME REPLACE REPLICATION REPOVERRIDE REQUEST RESTART RESTORE RESUME RET RETRIEVE REVALIDATE REVOKE RIGHT RIGHTS ROLE ROLLBACK ROLLFORWARD ROW ROWID ROWS

- SSAMPLE SAMPLEID SECOND SEL SELECT SESSION SET SETRESRATE SETSESSRATE SHOW SKEW SMALLINT SOME SPOOL SQLEXCEPTION SQRT SS STARTUP STATEMENT STATISTICS STDDEV_POP STDDEV_SAMP STRING_CS SUBSCRIBER SUBSTR SUBSTRING SUM SUSPEND

The SQL Quick Reference Guide Page 135

The SQL Reference Guide

Current Reserved Words (continued)


- TTABLE TBL_CS TEMPORARY TERMINATE THEN TIME TIMESTAMP TIMEZONE_HOUR TIMEZONE_MINUTE TITLE TO TRAILING TRANSACTION TRANSLATE TRANSLATE_CHK TRIGGER TRIM TYPE

- UUC UNDEFINED UNDO UNION UNIQUE UPD UPDATE UPPER UPPERCASE USER USING

- VVALUE VALUES VARBYTE VARCHAR VARGRAPHIC VARYING VAR_ POP VAR_SAMP VIEW VOLATILE

- WWHEN WORK WHERE WHILE WITH

- YYEAR

- ZZEROIFNULL ZONE
A

Page 136

The SQL Quick Reference Guide

Simplicity by Design

Future Reserved Words


The following words are reserved for the future: - AALIAS AUTHORIZATION

- DDESCRIPTOR

- GGO GOTO

- IINDICATOR

- PPRIVATE

- WWAIT

The SQL Quick Reference Guide Page 137

The SQL Reference Guide

APPENDIX B: Data Control Language (DCL)


Data Control Language (DCL) Statements
Data Control Language (DCL) is normally used by the database administrator (DBA). These statements control the ownership and access by users to the database objects. There are three DCL statements that will be covered: GRANT gives permission to perform a specific operation REVOKE takes away permission to perform a specific operation GIVE - transfers ownership of a database or user

Privileges
Access rights, often referred to as privileges, define what a user can and cannot do with a particular object. The privileges are defined in the following categories: CREATE - make a new object DROP - remove an object CHECKPOINT - mark rows as valid DUMP - backup or archive to the checkpoint RESTORE - return to disk from an archive EXECUTE - run a macro or stored procedure REFERENCES - table or column level access INDEX - secondary index operations DELETE - remove rows from a table or view INSERT - build new rows in a table or view SELECT - read rows from a table or view UPDATE - modify columns or rows in a table or view The database objects that can be allowed with the CREATE / DROP: DATABASE / USER TRIGGER PROCEDURE MACRO TABLE VIEW

Page 138

The SQL Quick Reference Guide

Simplicity by Design

GRANT Statement
Compatibility: ANSI The GRANT statement is used to explicitly provide one or more privileges to one or more users. All granted privileges are stored in the Data Dictionary. The GRANT syntax for SQL privileges:
GRANT [ { ALL | ALL BUT } ] <privilege> [,<privilege>] ON [ PROCEDURE ] [<database-name>.]<object-name> TO [ ALL ] { <user-name> [,<user-name> ] | PUBLIC } [ WITH GRANT OPTION ] ;

It is not a good idea to use PUBLIC in Teradata due to the larger number of users. The ALL causes the privilege(s) to cascade downward to all dependents of the user specified. Hint - Man

The GRANT syntax forLOGON :


GRANT LOGON { ALL | <host-id> [,<host-id>] } TO { <database-name> [,<database-name> ] | AS DEFAULT } [ WITH NULL PASSWORD ] ;

The GRANT syntax to provide MONITOR operations: GRANT <monitor-privilege> [,<monitor_privilege>] MONITOR [ {PRIVILEGES | BUT NOT <monitor-privilege> [,<monitor-privilege>]} ] TO [ ALL ] { <user-name> [,<user-name> ] | PUBLIC } [ WITH GRANT OPTION ] ;

The monitor privileges: MONRESOURCE MONSESSION ABORTSESSION SETRESRATE SETSESSRATE

The SQL Quick Reference Guide Page 139

The SQL Reference Guide

REVOKE Statement
Compatibility: ANSI The REVOKE statement is used to explicitly remove one or more privileges from one or more users. All granted privileges are stored in the Data Dictionary. THE REVOKE syntax for SQL privileges:
REVOKE [GRANT OPTION FOR ] [ { ALL | ALL BUT } ] <privilege> [,<privilege>] ON [ PROCEDURE ] [<database-name>.]<object-name> { TO | FROM } [ ALL ] { <user-name> [,<user-name> ] | PUBLIC } ;

It is not a good idea to use PUBLIC in Teradata due to the larger number of users. The ALL causes the privilege(s) to cascade downward to all dependents of the user specified. Hint - Man

The REVOKE syntax forLOGON:


REVOKE LOGON { ALL | <host-id> [,<host-id>] } { { TO | FROM } { <database-name> [,<database-name> ] | AS DEFAULT } ;

The REVOKE syntax to provide MONITOR operations: REVOKE [GRANT OPTION FOR ] <monitor-privilege> [,<monitor-privilege>] MONITOR [ {PRIVILEGES | BUT NOT <monitor-privilege> [,<monitor-privilege>]} ] { TO | FROM } [ ALL ] { <user-name> [,<user-name> ] | PUBLIC } ;

The monitor privileges: MONRESOURCE MONSESSION ABORTSESSION SETRESRATE SETSESSRATE

Page 140

The SQL Quick Reference Guide

Simplicity by Design

GIVE Statement
Compatibility: Teradata The GIVE statement is used to transfer the ownership of a database or user to another database or user. This transfer reallocates all space and privileges with it. The GIVE syntax:
GIVE { <database-name> | <user-name> } TO { <database-name> | <user-name> } ;

The SQL Quick Reference Guide Page 141

The SQL Reference Guide

APPENDIX C: Data Types and Format Symbols


The following table is a chart of all the ANSI Standard Data Types that Teradata supports.

Data Type Description Data Value Range INTEGER Signed whole number -2,147,483,648 to SMALLINT Signed smaller whole number DECIMAL (X,Y) Signed decimal number Largest value DEC(18,0) Where: X=1 thru 18, total 18 digits on either side of the Smallest value DEC(18,18) number of digits in the decimal point number And Y=0 thru 18 digits to the right of the decimal NUMERIC (X,Y) Synonym for DECIMAL Same as DECIMAL Same as DECIMAL FLOAT Floating Point Format <value>x103 0 7 to <value>x10 308 (IEEE) REAL Stored internally as FLOAT PRECISION Stored internally as FLOAT DOUBLE PRECISION Stored internally as FLOAT CHARACTER (X) Fixed length character 1 to 64,000 characters long, CHAR (X) string, 1 byte of storage per pads to length with space Where: X=1 thru 64000 character, VARCHAR (X) Variable length character 1 to 64,000 characters as a CHARACTER string, 1 byte of storage per maximum. The system only VARYING (X) character, plus 2 bytes to stores the characters presented CHAR VARYING (X) record length of actual data to it. Where: X=1 thru 64000 DATE Signed internal Currently to the year 3500 as a representation of positive number and back into YYYMMDD (YYY AD years as a negative represents the number of number. years from 1900, i.e. 100 for Year 2000) TIME Identifies a field as a TIME value with Hour, Minutes and Seconds TIMESTAMP Identifies a field as a TIMESTAMP value with Year, Month, Day, Hour, Minute, and Seconds 2,147,483,647 -32,768 to 32,767

Page 142

The SQL Quick Reference Guide

Simplicity by Design

Teradata also has its own data types that are acknowledged as Teradata Extensions:
Data Type Description Data Value Range BYTEINT Signed whole number -128 to 127 BYTE (X) Binary 1 to 64,000 bytes Where: X=1 thru 64000 VARBYTE (X) Variable length binary 1 to 64,000 bytes Where: X=1 thru 64000 LONG VARCHAR Variable length string 64,000 characters (maximum data length) The system only stores the characters provided, not trailing spaces.) GRAPHIC (X) Fixed length string of 16-bit 1 to 32,000 KANJI Where: X=1 thru 32000 bytes (2 bytes per character) characters VARGRAPHIC (X) Variable length string of 161 to 32,000 characters as a Where: X=1 thru 32000 bit bytes maximum. The system only stores characters provided.

Format Symbols
Forma tting symbols are very powerful. These symbols allow the user to control the way data can be inserted into a row and displayed in the result set. It provides for more predictable result sets.

Be sure to keep in mind that the ODBC will ignore formatting, unless you trick it. To see true formatting, the user should use BTEQ. Hint - Man

Basic Numeric and Character Data Formatting Symbols Symbol Mask character and how used X or x Character data. Each X represents one character. Can repeat value i.e. XXXXX or X(5). 9 Decimal digit. Holds place for numeric digit for a display 0 through 9. All leading zeroes are shown if the format mask is longer than the data value. Can repeat value i.e. 99999 or 9(5). V or v Implied decimal point. Aligns data on a decimal value. Primarily used on imported data without actual decimal point. E or e Exponential. Aligns the end of the mantissa and the beginning of the exponent. G or g Graphic data. Each G represents one logical (double byte - KANJI or Katakana) character. Can repeat value i.e. GGGGG or G(5).

The SQL Quick Reference Guide Page 143

The SQL Reference Guide

Advanced Numeric and Character Formatting Symbols Symbol Mask character and how used $ Fixed or floating dollar sign. Inserts a $ or leaves spaces and moves (floats) over to the first character of a currency value. With the proper keyboard, additional currency signs are available: Cent, Pound and Yen. , Comma. Inserted where appears in format mask. Used primarily to make large numbers easier to read. . Period. Primary use to align decimal point position. Also used for: dates and comma in some currencies. - Dash character. Inserted where appears in format mask. Used primarily for dates and negative numeric values. Also used for: phone numbers, zip codes, and social security (USA). / Slash character. Inserted where appears in format mask. Used primarily for dates. % Percent character. Inserted where appears in format mask. Used primarily for display of percentage i.e. 99% vs. .99 Z or z Zero-suppressed decimal digit. Holds place for numeric digit displays 1 through 9 and 0, when significant. All leading zeroes (insignificant) are shown as space since their presence does not change the value of the number being displayed. B or b Blank data. Insert a space where appears in format mask.

,2014859999 ,1021.53 ,991001

SELECT ABCDE (FORMAT XxX) AS Fmt_Shorter (FORMAT 999-999-9999) AS Fmt_Phone (FORMAT ZZZZZZ9.9999) AS Z_press (FORMAT $$$$,$$$.99) AS Fmt_Pay ;

Page 144

The SQL Quick Reference Guide

Simplicity by Design

In addition to have the abilit y to format Numeric and Character Data Types, a user may also format Dates.

Date Formatting Symbols Symbol Mask character and how used (not case specific) M or m Month. Allows month to be displayed any where in the date display. When MM is specified, the numeric (01-12) value is available. When MMM is specified, the three character (JAN-DEC) value is available. D or d Day. Allows day to be displayed any where in the date display. When DD is specified, the numeric (01-31) value is available. When DDD is specified, the three-digit day of the year (001-366) value is available. Y or y Year. Allows day to be displayed any where in the date display. The normal th century with the 19YY YY has been used for many years for the 20 st century, it is assumed. However, since we have moved into the 21 recommended that the YYYY be used.

SELECT
991001(date) (FORMAT Yyddd) AS Fmt_Julian ,991001(date) (FORMAT YYYY-mm-dd) AS Fmt_ANSI ,9991001(date) (FORMAT yy/mm/dd) AS Fmt_Teradata ;

The SQL Quick Reference Guide Page 145

The SQL Reference Guide

APPENDIX D: Mathematical Functions


This is a chart of those Teradata arithmetic, trigonometric and hyperbolic math functions: Operator Operation performed Modulo returns the remainder from a division (1 mod 2 derives MOD x

ABS( x ) EXP( x) LOG( x ) LN( x ) SQRT( x ) COS( x )

SIN( x )

TAN( x)

ACOS( x)

ASIN( x)

ATAN( x ) ATAN2 (x,y )

COSH( x ) SINH( x )

1, as the remainder of division, 2 goes into 1, 0 times with a remainder of 1. Then, 2 mod 10 derives 2, 10 goes into 2, 0 times with a remainder of 2). MOD always returns 0 thru x-1. As such, MOD 2 returns 0 for even numbers and 1 for odd; MOD 7 can be used to determine the day of the week; and MOD 10, MOD 100, MOD 1000, etc can be used to shift the decimal of any number to the left by the number of zeroes in the MOD operator. Absolute value, the absolute value of a negative number is the same number as a positive x. (ABS(10-12) = 2) Exponentiation, e raised to a power, ( EXP(10) derives 2.20264657948067E004 ) Logarithm calculus function, ( LOG(10) derives the value 1.0000000000000E000 ) Natural logarithm, ( LN(10) derives the value 2.30258509299405E000 ) Square root, ( SQRT(10) derives the value 3.16227766016838E000) Takes an angle in radians (x ) and returns the ratio of two sides of a right triangle. The ratio is the length of the side adjacent to the angle divided by the length of the hypotenuse. The result lies in the range -1 to 1, inclusive where x is any valid number expression that expresses an angle in radians. Takes an angle in radians (x ) and returns the ratio of two sides of a right triangle. The ratio is the length of the side opposite to the angle divided by the length of the hypotenuse. The result lies in the range -1 to 1, inclusive where x is any valid number expression that expresses an angle in radians. Takes an angle in radians (x ) and returns the ratio of two sides of a right triangle. The ratio is the length of the side opposite to the angle divided by the length of the side adjacent to the angle where x is any valid number expression that expresses an angle in radians. Returns the arccosine of x. The arccosine is the angle whose cosine is x where x is the cosine of the returned angle. The values of x must be between -1 and 1, inclusive. The returned angle is in the range 0 to ??radians, inclusive. Returns the arcsine of ( x) . The arcsine is the angle whose sine is x where x is the sine of the returned angle. The values of x must be between -1 and 1, inclusive. The returned angle is in the range ?/2 to ??/2 radians, inclusive. Returns the arctangent of ( x) . The arctangent is the angle whose tangent is arg. The returned angle is in the range ?/2 to ??/2 radians, inclusive. Returns the arctangent of the specified (x,y) coordinates. The arctangent is the angle from the x-axis to a line contained the origin(0,0) and a point with coordinates (x,y). The returned angle is between ? and ?? radians, excluding ? . A positive result represents a counterclockwise angle from the x-axis where a negative result represents a clockwise angle. The ATAN2(x,y) equals ATAN(y/x), except that x can be 0 in ATAN2(x,y) and x cannot be 0 in ATAN(y/x) since this will result in a divide by zero error. If both x and y are 0, an error is returned. Returns the hyperbolic cosine of ( x) where x is any real number. Returns the hyperbolic sine of ( x) where x is any real number.

Page 146

The SQL Quick Reference Guide

Simplicity by Design

TANH( x ) ACOSH( x)

ASINH( x) ATANH( x)

Returns the hyperbolic tangent of ( x) where arg is any real number. Returns the inverse hyperbolic cosine of ( x) . The inverse hyperbolic cosine is the value whose hyperbolic cosine is a number so that x is any real number equal to, or greater than, 1. Returns the inverse hyperbolic sine of ( x) . The inverse hyperbolic sine is the value whose hyperbolic sine is a number so that x is any real number. Returns the inverse hyperbolic tangent of ( x) . The inverse hyperbolic tangent is the value whose hyperbolic tangent is a number so that x is any real number between 1 and -1, excluding 1 and -1).

APPENDIX E: Qualifying and Table Aliasing


This section provides techniques to specifically reference table and columns throughout all databases and to temporarily rename tables with an alias name.

Qualifying Column Names

3- level reference: <database- name>.<table - name>.<column- name> 2- level reference: <database- name>.<table - name> 2- level reference: <table -name>.<column-name>

SELECT SQL_CLASS.Employee_Table.Dept_No FROM Employee_Table ;

SELECT * FROM

SQL_CLASS.Employee_Table ;

SELECT Student_Table.Student_Id FROM Student_Table INNER JOIN Student_Course_Table ON Student_Table.Student_Id = Student_Course_Table.Student_Id ;

The SQL Quick Reference Guide Page 147

The SQL Reference Guide

Creating an Alias for a Table


Once an alias is established for a table, the alias must be used or the real table will also be included in the query and possibly cause a product join. SELECT <column- list> FROM <table- name> AS <table-alias-name> ;

SELECT * FROM Customer_Table SELECT CUST.Customer_Name FROM Customer_Table as CUST ;

as CUST ;

SELECT STU.Student_Id, STU_COUR.Course_Id FROM Student_Table as STU INNER JOIN Student_Course_Table ON STU.Student_Id = STU_COUR.Student_Id ;

asSTU_COUR

Alternative Syntax:

SELECT <column- list> FROM <table- name><table-alias-name> ;

SELECT * FROM Customer_Table CUST ;

SELECT CUST.Customer_Name FROM Customer_Table CUST ;

Page 148

The SQL Quick Reference Guide

Simplicity by Design

APPENDIX F: Stored Procedure Syntax


Stored Procedures are a relatively new concept for Teradata. Despite being new, they are quite powerful, flexible, and easy to write. This appendix is a focus on the Create Syntax, and all the possible Stored Procedure Language (SPL) options.

CREATE PROCEDURE [<database- name>.]<procedure-name> ( [ <parameter- list> ] ) <procedure- body> ;

This is the simplest syntax for a stored procedure with <procedure-body> including loops, if statements, and other SPL choices. Hint - Man

The following is a list of all the SPL features that Teradata supports: BEGIN / END Establishes the range of the <procedure-body>. CALL Executes one procedure from the procedure being run. DECLARE Introduces local variables or handlers to the procedure. FOR / END FOR Serves as a FOR Loop, for each ro w returned from Teradata. IF / END IF Provides a conditional test for a given variable. ITERATE Terminates the remaining steps in any loop, returning back to corresponding Label. LEAVE Used to exit a loop prematurely. LOOP / END LOOP Defines the length of the loop. PRINT Used for testing and debugging of a procedure. SET Establishes a value to a variable in the procedure. WHILE / END WHILE Loop with a conditional test before the code in the loop.

For further information about Stored Procedures and SPL, please refer to Teradata SQL: Unleash the Power, Chapter 21. Detailed information is included on each SPL feature, and the whole concept of Stored Procedures.

The SQL Quick Reference Guide Page 149

Index of Contents A Abort i, 100 ABS(X ) 146 ACOS( X ) 146 ACOSH( X ) 147 Add_Months i, 48 After Journal 109, 110, 111, 113, 120, 121 After Triggers i, 130 Aliasing Columns i, 13 Alter Table i, 113 And/Or 4, 5 Ansi Mode 25, 98, 99, 107 AS i, 13, 144, 145 ASIN( X) 146 ASINH( X) 147 ATAN( X) 146 ATAN2 ( X,Y ) 146 ATANH(X ) 147 Average (Avg) i B Befor e Journal 109, 110, 111, 113, 120, 121 Before Triggers i, 129 Begin / End 149 Between i, 11, 86, 133 Byte (X) 143 Byteint 51, 133, 143 C Calendar_Date 51 Call 133, 149 Cartesian Product Join i, 42, 45 Case i, 51, 85, 86, 87, 88, 133 Casespecific i, 24, 25, 110, 133 Character (X) 142 Character Set 110 Characters 52 Coalesce i, 84, 133 Collect Statistics i, 118 Commit Work i, 100 Compress 110, 133 Compress Null 110 Correlated Subquery i, 36 COS( X) 146 COSH( X ) 146 Count (Count) 31 Create Database i, 120 Global Temporary Table 127 Macro i, 93 Table i, 105, 112 User i, 121 View i, 89 Cross Join i, 45 Current Reserved Words 134, 135, 136 Current_Time 50, 133 Current_Timestamp 50, 133 D Data Control Language (Dcl) 138 Data Interrogation Case i, 51, 85, 86, 87, 88, 133 Coalesce i, 84, 133 Nullif iii, 82, 135 Nullifzero iii, 81, 135 Zeroifnull 4, 83, 136 Data Manipulation Delete ii, 77, 78, 93, 95, 126, 127, 129, 130, 131, 132, 133, 138 Insert ii, 72, 73, 74, 79, 80, 93, 95, 96, 97, 100, 101, 126, 127, 129, 130, 131, 132, 134, 138 Insert / Select ii, 74 Update iii, 4, 75, 76, 79, 80, 93, 95, 99, 100, 129, 130, 131, 132, 136, 138 Upsert iii, 4, 79, 80 Data Types Byte (X) 143 Byteint 51, 133, 143 Character (X) 142 Date ii, 4, 47, 51, 110, 126, 127, 130, 133, 142 Decimal (X,Y) 142 Double Precision 142 Float 134, 142 Graphic (X) 143

Integer 51, 93, 105, 106, 107, 108, 109, 110, 111, 134, 142 Long Varchar 143 Numeric (X,Y) 142 Precision 135, 142 Real 135, 142 Smallint 51, 93, 135, 142 Time 4, 50, 110, 133, 136, 142 Timestamp 4, 50, 133, 136, 142 Varbyte (X) 143 Varchar (X) Character 142 Vargraphic (X) 143 Database Create i, 120 Drop 122 Give 141 Grant 139 Revoke 140 DATE ii, 4, 47, 51, 110, 126, 127, 130, 133, 142 Integerdate 46 Date Functions Add_Months i, 48 Extract ii, 49 Day_Of_Calendar 51 Day_Of_Month 51 Day_Of_Week 51 Day_Of_Year 51 Decimal (X,Y) 142 Declare 133, 149 Default Date 110 Default Null 110, 111 Default Time 110 Default User 110 Default Value 110 Delete ii, 77, 78, 93, 95, 126, 127, 129, 130, 131, 132, 133, 138 Derived Table ii, 125 Distinct ii, 16, 123, 133 Double Precision 142 Drop Database 122 Macro ii, 95 Table ii, 114 Temporary Table 128 User 122

View ii, 90 Drop Statistics ii, 119 Dual After Journal 109 Dual Before Journa l 109 E Except ii, 34, 37, 67, 70, 71, 133 Execute Macro ii, 94 Exists 37 EXP(X ) 146 Explain ii, 19, 133 Extract ii, 49 F Fallback ii, 108, 109, 110, 111, 117, 120, 121, 124, 134 Float 134, 142 For / End For 149 Format ii, 22, 110, 134, 144, 145 Format Symbols 142, 143 Function Characters 52 Cumulative Sum (Csum) 59 Hashing ii, 123 Index 55 Moving Average (Mavg) 61 Moving Difference (Mdiff) 62 Moving Sum (Msum) 60 Position 55 Quantile 63 Random 66 Rank 64 Substring And Substr 54 Trim 53 Future Reserved Words 137 G Give 141 Global Temporary Table ii, 127 Create 127 Grant 139 Graphic (X) 143 H Hashamp ii, 124, 134

Hashbakamp ii, 124, 134 Hashbucket ii, 124, 134 Hashing ii, 123 Hashrow ii, 123, 124, 134 Having ii, 32 Help 2, 3, 17, 18, 21, 72, 73, 77, 81, 82, 83, 90, 113, 114, 115, 119, 134 Column 17 Database 17 Index 17 Macro 17 Procedure 17 Session 17 Statistics 17 Table 17 Trigger 17 User 17 View 17 Volatile Table 17 Horizontal Reporting ii, 87 I If / End If 149 In ii, 9 Index Function 55 Indexes Non- Unique Primary Index 105 Non- Unique Primary Index (NUPI) 105 Primary Index iii, 105, 106, 124 Secondary 116 Secondary Index 4, 116 Unique Primary Index 105 Inner Join 40 Insert ii, 72, 73, 74, 79, 80, 93, 95, 96, 97, 100, 101, 126, 127, 129, 130, 131, 132, 134, 138 Insert / Select ii, 74 Instead Of Triggers ii, 131 Integer 51, 93, 105, 106, 107, 108, 109, 110, 111, 134, 142 Integerdate 46 Intersect ii, 67, 68, 134 Is Null 7 Iterate 134, 149

J Join iii, 38 Cartesian Product Join i, 42, 45 Cross Join i, 45 Inner Join 40 Outer Join i, 43 Join Index iii, 117 L Leave 134, 149 Like iii, 12 LN( X) 146 Locking Database 97 Modifiers iii, 96 Table 97 View 97 Locking Modifiers 96 LOG(X) 146 Long Varchar 143 Loop / End Loop 149 Lower And Upper 26 M Macro Create Macro i, 93 Drop Macro ii, 95 Execute Macro ii, 94 Replace Macro 4, 95 Math Functions ABS(X ) 146 ACOS( X ) 146 ACOSH( X ) 147 ASIN( X) 146 ASINH( X) 147 ATAN( X) 146 ATAN2 ( X,Y ) 146 ATANH(X ) 147 Begin / End 149 Call 133, 149 COS( X) 146 COSH( X ) 146 Declare 133, 149 EXP(X ) 146 For / End For 149

If / End If 149 Iterate 134, 149 Leave 134, 149 LN( X) 146 LOG(X) 146 Loop / End Loop 149 MOD X146 Print 149 Set 4, 67, 75, 76, 79, 80, 95, 98, 99, 100, 107, 108, 109, 110, 111, 121, 135, 149 SIN(X ) 146 SINH( X) 146 SQRT(X) 146 TAN(X) 146 TANH( X) 147 While / End While 149 Maximum (Max) 30 Minimum (Min) 29 Minus iii, 34, 37, 67, 71, 134 MOD X146 Month_Of_Calendar 51 Month_Of_Quarter 51 Month_Of_Year 51 Multiple Subquery iii, 34 Multiset Table 107 N Named i, iii, 13, 14, 110, 135 Nested CASE iii, 88 Non- Unique Primary Index (Nupi) 105 Non- Unique Primary Index (NUPI) 105 Not iii, 8 Not Casespecific iii, 25 Not In ii, 9 Not Null ii, 7, 52, 87, 110, 111 Nullif iii, 82, 135 Nullifzero iii, 81, 135 Numeric (X,Y) 142 O Odbc 22 Order By iii, 15 Outer Join i, 43

P Permanent Journal iii, 109 Position Function 55 Precision 135, 142 Primary Index iii, 105, 106, 124 Print 149 Privileges 138 Q Qualifying Column Names 147 Quantifiers iii, 35 Quarter_Of_Calendar 51 Quarter_Of_Year 51 R Real 135, 142 Rename Table 4, 115 Replace Macro 4, 95 Replace View 4, 91 Revoke 140 Rollback i, 4, 100, 101 Rollback Work 101 S Secondary Index 4, 116 Select 2, 3, 4, 6, 9, 10, 11, 12, 19, 33, 37, 51, 66, 74, 91, 92, 93, 95, 96, 97, 100, 101, 112, 148 Sequencing Triggers 4, 132 Set 4, 67, 75, 76, 79, 80, 95, 98, 99, 100, 107, 108, 109, 110, 111, 121, 135, 149 Set Operators Except ii, 34, 37, 67, 70, 71, 133 Intersect ii, 67, 68, 134 Minus iii, 34, 37, 67, 71, 134 Union 4, 34, 37, 67, 69, 74, 136 Set Table 107 Show 18, 39, 41, 44, 52, 59, 60, 61, 62, 68, 69, 70, 71, 72, 73, 74, 81, 82, 83, 135 Macro 18 Procedure 18 Table 18 Trigger 18 View 18

SIN(X ) 146 SINH( X) 146 Smallint 51, 93, 135, 142 SQRT(X) 146 String And Column Concatenation 57 Subquery Correlated Subquery i, 36 Multiple 34 Multiple Subqueries iii, 34 Sum 27 System Calendar Columns 4, 51 Calendar_Date 51 Day_Of_Calendar 51 Day_Of_Month 51 Day_Of_Week 51 Day_Of_Year 51 Month_Of_Calendar 51 Month_Of_Quarter 51 Month_Of_Year 51 Quarter_Of_Calendar 51 Quarter_Of_Year 51 Week_Of_Calendar 51 Week_Of_Month 51 Week_Of_Year 51 Weekday_Of_Month 51 Year_Of_Calendar 51 T Table Alias 148 Alter Table i, 113 Create 105, 112 Create Table i, 105, 112 Derived Table ii, 125 Drop Table ii, 114 Global Temporary 127 Global Temporary Table ii, 127 Rename Table 4, 115 Volatile Temporary Table 4, 126 TAN(X) 146 TANH( X) 147 Temporary Table Drop 128 Teradata Mode 98 TIME 4, 50, 110, 133, 136, 142 TIMESTAMP 4, 50, 133, 136, 142

TITLE 4, 23, 68, 69, 70, 71, 102, 103, 104, 110, 111, 113, 136 Transaction Mode Setting 99 Triggers After i, 130 Before i, 129 Instead Of ii, 131 Sequencing 4, 132 U Union 4, 34, 37, 67, 69, 74, 136 Unique Primary Index (Upi) 105 Update iii, 4, 75, 76, 79, 80, 93, 95, 99, 100, 129, 130, 131, 132, 136, 138 Uppercase 110, 136 Upsert iii, 4, 79, 80 User Create i, 121 Drop 122 V Varbyte (X) 143 Varchar (X) Character 142 Vargraphic (X) 143 View Create View i, 89 Drop View ii, 90 Locking For Access iii, 92 Replace View 4, 91 Volatile Temporary Table 4, 126 W Week_Of_Calendar 51 Week_Of_Month 51 Week_Of_Year 51 Weekday_Of_Month 51 Where4, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 19, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 42, 43, 45, 51, 52, 57, 66, 75, 76, 77, 78, 79, 80, 87, 89, 91, 92, 93, 95, 97, 99, 100, 104, 117, 125, 136 While / End While 149 With 4, 102 With Default 110

With..By 4, 103 Y Year_Of_Calendar 51

Z Zeroifnull 4, 83, 136

You might also like