Upload
others
View
17
Download
0
Embed Size (px)
Citation preview
Teradata® RDBMS SQL/Data DictionaryQuick Reference
V2R5.0
B035-1510-122BFebruary 2003
The product described in this book is a licensed product of NCR Corporation.
BYNET is an NCR trademark registered in the U.S. Patent and Trademark Office.CICS, CICS/400, CICS/600, CICS/ESA, CICS/MVS, CICSPLEX, CICSVIEW, CICS/VSE, DB2, DFSMS/MVS, DFSMS/VM, IBM, NQS/MVS, OPERATING SYSTEM/2, OS/2, PS/2, MVS, QMS, RACF, SQL/400, VM/ESA, and VTAM are trademarks or registered trademarks of International Business Machines Corporation in the U. S. and other countries.DEC, DECNET, MICROVAX, VAX and VMS are registered trademarks of Digital Equipment Corporation.HEWLETT-PACKARD, HP, HP BRIO, HP BRIO PC, and HP-UX are registered trademarks of Hewlett-Packard Co.KBMS is a trademark of Trinzic Corporation.INTERTEST is a registered trademark of Computer Associates International, Inc.MICROSOFT, MS-DOS, MSN, The Microsoft Network, MULTIPLAN, SQLWINDOWS, WIN32, WINDOWS, WINDOWS 2000, and WINDOWS NT are trademarks or registered trademarks of Microsoft Corporation.SAS, SAS/C, SAS/CALC, SAS/CONNECT, and SAS/CPE are registered trademarks of SAS Institute Inc.SOLARIS, SPARC, SUN and SUN OS are trademarks of Sun Microsystems, Inc.TCP/IP protocol is a United States Department of Defense Standard ARPANET protocol.TERADATA and DBC/1012 are registered trademarks of NCR International, Inc.UNICODE is a trademark of Unicode, Inc.UNIX is a registered trademark of The Open Group.X and X/OPEN are registered trademarks of X/Open Company Limited.
YNET is a trademark of NCR Corporation.THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROVIDED ON AN “AS-IS” BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. IN NO EVENT WILL NCR CORPORATION (NCR) BE LIABLE FOR ANY INDIRECT, DIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS OR LOST SAVINGS, EVEN IF EXPRESSLY ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
The information contained in this document may contain references or cross references to features, functions, products, or services that are not announced or available in your country. Such references do not imply that NCR intends to announce such features, functions, products, or services in your country. Please consult your local NCR representative for those features, functions, products, or services available in your country.
Information contained in this document may contain technical inaccuracies or typographical errors. Information may be changed or updated without notice. NCR may also make improvements or changes in the products or services described in this information at any time without notice.
To maintain the quality of our products and services, we would like your comments on the accuracy, clarity, organization, and value of this document. Please e-mail: [email protected] or write:
Information EngineeringNCR Corporation100 North Sepulveda BoulevardEl Segundo, CA 90245-4361U.S.A.
Copyright © 1996-2003, NCR CorporationAll Rights Reserved
Preface
Supported Software Release
This book supports Teradata RDBMS V2R5.0.
Changes to This Book
This book includes the following changes to support the current release:
Date Description
February 2003 • Replaced restricted word list in Appendix B with a cross-reference to Appendix A in Teradata RDBMS Release Summary.
December 2002 • Updated existing syntax and added the following new syntax diagrams in Chapter 2 :
– 23 new diagrams to Arithmetic Operators and Functions/Trigonometric/Hyperbolic Functions
– Two new diagrams in Built-In Functions– Two new diagrams in Ordered Analytical Functions • Updated existing syntax and added ten new diagrams in Chapter 3.• Updated existing syntax and added two new diagrams in Chapter 4.• Added a new Chapter 5 to include Query and Workload Analysis
Statements.• Updated existing syntax and added one new diagrams in Chapter 7.• Updated existing syntax in Chapters 8 and 9. Added a new MERGE
syntax diagram in Chapter 9.• Updated existing syntax and added one new diagram in Chapter 10.• Changed the term OLAP Functions to Ordered Analytical Functions.• Added a new chapter to contain syntax of the cursors and cursor
control statements.
Teradata RDBMS SQL/Data Dictionary Quick Reference i
Preface
December 2002 (continued)
• Added the following new views and new column fields in Chapter 12, Data Dictionary Views:
– DBC.AllRoleRights– DBC.DBQLRules
– DBC.Functions– DBC.ProfileInfo[X]– DBC.QryLog– DBC.QryLogObjects– DBC.QryLogSteps– DBC.QryLogSummary– DBC.RoleInfo[X]– DBC.UserRoleRights• Updated Appendix B with new reserved and restricted words.
June 2001 • Reorganized chapters.• Added the following new syntax diagrams:– 7 new diagrams to Aggregate Functions in Chapter 2– 3 new diagrams to Ordered Analytical Functions in Chapter 2– DROP HASH INDEX in Chapter 3– HELP HASH INDEX in Chapter 5• Added two new views to Chapter 10: “Data Dictionary Views”: – ColumnStats – IndexStats• Updated Appendix B with new reserved and restricted words.
September 2000 • Updated existing syntax diagrams• Updated Appendix A
Date Description
Teradata RDBMS SQL/Data Dictionary Quick Referenceii
Preface
June 2000 • Updated the following information as required:– Existing syntax– SQL Keywords• Added new chapters containing syntax for the following types of
statements:– Client-Server Connectivity– Stored Procedure Language – Target Level Emulation
January 1999 • Reorganized the quick reference by dividing, the SQL statement syntax into four functional categories:
– SQL Data Definition Language– SQL Data Control Language– SQL Development Tools– SQL Data Manipulation Language• Added syntax for new SQL statements involving Dates and Times,
Intervals, Triggers, Join Indexes, and dynamic statement reprioritization.
• Revised existing syntax to accommodate expanded support for internationalization, temporary and volatile tables, and OLAP.
– Added greatly expanded data types for Date, Time, and Interval data.– Added complete SQL function and expression syntax.– DR fixes and enhancement requests.
Date Description
Teradata RDBMS SQL/Data Dictionary Quick Reference iii
PrefaceAbout This Book
About This Book
Purpose
This book is a quick reference for the SQL dialect supported by the Teradata Relational Database Management System. The book is also a quick reference to the supported data description phrases for the Teradata RDBMS and the Data Dictionary.
Audience
The audience for this quick reference is all users of Teradata SQL who need quick, non-detailed information about how to structure a SQL statement.
How This Book Is Organized
This book contains the following chapters and appendixes:
Chapter 1: “Data Types and Literals,” contains syntax for the Teradata SQL data handling, SQL data definition, control and manipulation, the SQL lexicon, and the foundations for the Teradata-supported international character sets.
Chapter 2: “SQL Functions and Expressions,” describes the functions, operators, expressions, and predicates of Teradata SQL.
Chapter 3: “SQL Data Definition Language Statement Syntax,” contains syntax for the Teradata SQL data definition language, which is used to create and delete or drop database objects.
Chapter 4: “SQL Data Control Language Statement Syntax,” contains syntax for the Teradata SQL data control language, which is used to give, grant, and revoke access rights to SQL and monitor objects.
Teradata RDBMS SQL/Data Dictionary Quick Referenceiv
PrefaceAbout This Book
Chapter 5: “Query and Workload Analysis Statements,” contains syntax for the Teradata SQL query and workload analysis statements used to collect or analyze data demographics and statistics.
Chapter 6: “SQL Help and Database Object Definition Tools: HELP and SHOW,” contains syntax for several useful tools for database administrators and designers, system administrators, and application developers.
Chapter 7: “SQL Client-Server Connectivity Statements,” contains syntax for the individual SQL statements concerned with connecting and maintaining a client application to a Teradata RDBMS server.
Chapter 8: “The SELECT Statement,” contains the syntax for the form, usage, and examples of the SELECT statement. It also contains syntax for the FROM clause and various SELECT statement clauses.
Chapter 9: “SQL Data Manipulation Language Statement Syntax,” contains the syntax for Teradata SQL data manipulation language, which is used to query and update the database.
Chapter 10: “SQL Stored Procedures,” contains the syntax for the statements for stored procedures, which provides a set of control and condition handling statements that make SQL a computationally complete programming language.
Chapter 11: “Cursors and Cursor Control Statements,” contains syntax for the cursors and cursor control statements.
Chapter 12: “Data Dictionary Views,” lists the views and columns of the Teradata Data Dictionary.
Appendix A: “How to Read Syntax Diagrams,” provides information about the conventions used in syntax diagrams.
Appendix B: “Restricted Words for V2R5.0,” describes Teradata reserved words, non-reserved words, those words reserved for future use, and SQL keywords.
Teradata RDBMS SQL/Data Dictionary Quick Reference v
PrefaceAbout This Book
Prerequisites
You should be familiar with basic computer technology, the Teradata relational database management system, and the Teradata SQL language.
It may be helpful to review the following books:
• Introduction to the Teradata RDBMS• Teradata RDBMS SQL Reference• Teradata RDBMS Data Dictionary
Teradata RDBMS SQL/Data Dictionary Quick Referencevi
PrefaceTechnical Information on the Web
Technical Information on the Web
The NCR home page (http://www.ncr.com) provides links to numerous sources of information about Teradata. Among the links provided are sites that deal with the following subjects:
• Contacting technical support• Enrolling in customer education courses• Ordering and downloading product documentation• Accessing case studies of customer experiences with Teradata• Accessing third party industry analyses of Teradata data
warehousing products• Accessing white papers• Viewing or subscribing to various online periodicals
Teradata RDBMS SQL/Data Dictionary Quick Reference vii
PrefaceTechnical Information on the Web
Teradata RDBMS SQL/Data Dictionary Quick Referenceviii
Contents
Preface
About This Book................................................................................................... ivTechnical Information on the Web ................................................................... vii
Chapter 1: Data Types and Literals
Byte Data Types..................................................................................................1–2BYTE ..............................................................................................................1–2VARBYTE .....................................................................................................1–2
Character Data Types ........................................................................................1–3CASESPECIFIC Phrase ...............................................................................1–3CHARACTER Type.....................................................................................1–3LONG VARCHAR Type ............................................................................1–3UPPERCASE Phrase....................................................................................1–3VARCHAR Type .........................................................................................1–4
Data Literals........................................................................................................1–5CHARACTER Data Literals.......................................................................1–5DATE Literals...............................................................................................1–5DECIMAL Literals.......................................................................................1–5FLOATING POINT Literals .......................................................................1–5GRAPHIC Literals .......................................................................................1–5Hexadecimal Literals ..................................................................................1–6INTEGER Literals ........................................................................................1–6INTERVAL DAY Literals ...........................................................................1–6INTERVAL DAY TO HOUR Literals .......................................................1–7
Teradata RDBMS SQL/Data Dictionary Quick Reference ix
Contents
INTERVAL DAY TO MINUTE Literals .................................................. 1–7INTERVAL DAY TO SECOND Literals .................................................. 1–7INTERVAL HOUR Literals ....................................................................... 1–7INTERVAL HOUR TO MINUTE Literals ............................................... 1–7INTERVAL HOUR TO SECOND Literals............................................... 1–8INTERVAL MINUTE Literals ................................................................... 1–8INTERVAL MINUTE TO SECOND Literals .......................................... 1–8INTERVAL MONTH Literals ................................................................... 1–8INTERVAL SECOND................................................................................. 1–8INTERVAL YEAR Literals......................................................................... 1–9INTERVAL YEAR TO MONTH Literals ................................................. 1–9TIME Literals ............................................................................................... 1–9TIMESTAMP Literals ................................................................................. 1–9
DateTime and Interval Data Types............................................................... 1–10DATE Data Type....................................................................................... 1–10INTERVAL DAY Data Type ................................................................... 1–10INTERVAL DAY TO HOUR Data Type................................................ 1–10INTERVAL DAY TO MINUTE Data Type ........................................... 1–10INTERVAL DAY TO SECOND Data Type........................................... 1–10INTERVAL HOUR Data Type ................................................................ 1–11INTERVAL HOUR TO MINUTE Data Type ........................................ 1–11INTERVAL HOUR TO SECOND Data Type ....................................... 1–11INTERVAL MINUTE Data Type............................................................ 1–11INTERVAL MINUTE TO SECOND Data Type ................................... 1–11INTERVAL MONTH Data Type ............................................................ 1–12INTERVAL SECOND Data Type ........................................................... 1–12INTERVAL YEAR Data Type ................................................................. 1–12INTERVAL YEAR TO MONTH Data Type.......................................... 1–12TIME Data Type........................................................................................ 1–12TIME WITH TIME ZONE Data Type .................................................... 1–13TIMESTAMP Data Type .......................................................................... 1–13TIMESTAMP WITH TIME ZONE Data Type ...................................... 1–13
x Teradata RDBMS SQL/Data Dictionary Quick Reference
Contents
Decimal/Numeric Data Types.......................................................................1–14BYTEINT Data Type .................................................................................1–14DECIMAL/NUMERIC Data Type..........................................................1–14FLOAT/REAL/DOUBLE PRECISION Data Type ..............................1–14INTEGER Data Type.................................................................................1–14SMALLINT Data Type..............................................................................1–14
Default Value Control Phrases.......................................................................1–15COMPRESS Phrase....................................................................................1–15DEFAULT Phrase ......................................................................................1–15NOT NULL Phrase....................................................................................1–15WITH DEFAULT Phrase ..........................................................................1–15
Output Format Phrases ...................................................................................1–16AS.................................................................................................................1–16FORMAT.....................................................................................................1–16NAMED ......................................................................................................1–16TITLE...........................................................................................................1–16
Chapter 2: SQL Functions and Expressions
Aggregate Functions..........................................................................................2–2AVG...............................................................................................................2–2CORR.............................................................................................................2–2COUNT .........................................................................................................2–2COVAR_POP ...............................................................................................2–2COVAR_SAMP............................................................................................2–2KURTOSIS ....................................................................................................2–3MAX ..............................................................................................................2–3MIN................................................................................................................2–3REGR_AVGX ...............................................................................................2–3REGR_AVGY ...............................................................................................2–3REGR_COUNT ............................................................................................2–3
Teradata RDBMS SQL/Data Dictionary Quick Reference xi
Contents
REGR_INTERCEPT .................................................................................... 2–4REGR_R2...................................................................................................... 2–4REGR_SLOPE .............................................................................................. 2–4REGR_SXX ................................................................................................... 2–4REGR_SXY ................................................................................................... 2–4REGR_SYY ................................................................................................... 2–4SKEW............................................................................................................ 2–5STDDEV_POP ............................................................................................. 2–5STDDEV_SAMP.......................................................................................... 2–5SUM .............................................................................................................. 2–5VAR_POP..................................................................................................... 2–5VAR_SAMP ................................................................................................. 2–5
Arithmetic Operators and Functions/Trigonometric/Hyperbolic Functions........................................................................................ 2–6
Arithmetic Operators ................................................................................. 2–6ABS................................................................................................................ 2–7ACOS ............................................................................................................ 2–7ACOSH......................................................................................................... 2–7ASIN ............................................................................................................. 2–7ASINH .......................................................................................................... 2–8ATAN ........................................................................................................... 2–8ATAN2 ......................................................................................................... 2–8ATANH ........................................................................................................ 2–9CASE_N........................................................................................................ 2–9COS ............................................................................................................... 2–9COSH.......................................................................................................... 2–10EXP.............................................................................................................. 2–10LN................................................................................................................ 2–10LOG............................................................................................................. 2–10NULLIFZERO............................................................................................ 2–11RANDOM .................................................................................................. 2–11RANGE_N ................................................................................................. 2–12
xii Teradata RDBMS SQL/Data Dictionary Quick Reference
Contents
SIN ...............................................................................................................2–13SINH............................................................................................................2–13SQRT............................................................................................................2–13TAN .............................................................................................................2–14TANH..........................................................................................................2–14WIDTH_BUCKET......................................................................................2–14ZEROIFNULL ............................................................................................2–14
Attribute Functions..........................................................................................2–15BYTES..........................................................................................................2–15CHARACTERS ..........................................................................................2–15CHARACTER_LENGTH .........................................................................2–15FORMAT.....................................................................................................2–15MCHARACTERS.......................................................................................2–15OCTET_LENGTH......................................................................................2–16TYPE ............................................................................................................2–16
Built-In Functions.............................................................................................2–17ACCOUNT .................................................................................................2–17CURRENT_DATE .....................................................................................2–17CURRENT_TIME ......................................................................................2–17CURRENT_TIMESTAMP.........................................................................2–17DATABASE ................................................................................................2–17DATE...........................................................................................................2–18PROFILE .....................................................................................................2–18ROLE ...........................................................................................................2–18SESSION .....................................................................................................2–18TIME ............................................................................................................2–18USER............................................................................................................2–18
CASE Expressions............................................................................................2–19COALESCE Expression ............................................................................2–20NULLIF Expression...................................................................................2–20
Comparison Operators....................................................................................2–21
Teradata RDBMS SQL/Data Dictionary Quick Reference xiii
Contents
Data Type Conversions .................................................................................. 2–23CAST........................................................................................................... 2–23Teradata Conversion Syntax ................................................................... 2–23
DateTime and Interval Functions and Expressions.................................... 2–24Arithmetic Operators and Result Types................................................ 2–24ANSI DateTime Expressions ................................................................... 2–25ANSI Interval Expressions ...................................................................... 2–25ADD_MONTHS........................................................................................ 2–26EXTRACT................................................................................................... 2–27
Hash-Related Functions ................................................................................. 2–28HASHAMP ................................................................................................ 2–28HASHBAKAMP........................................................................................ 2–28HASHBUCKET ......................................................................................... 2–28HASHROW................................................................................................ 2–29
Logical Predicates............................................................................................ 2–30ANY/ALL/SOME Subquery Syntax..................................................... 2–30BETWEEN/NOT BETWEEN.................................................................. 2–30EXISTS/NOT EXISTS............................................................................... 2–30IN/NOT IN................................................................................................ 2–31IS NULL/IS NOT NULL ......................................................................... 2–31LIKE ............................................................................................................ 2–32OVERLAPS ................................................................................................ 2–32
Ordered Analytical Functions ....................................................................... 2–33AVG ............................................................................................................ 2–33COUNT ...................................................................................................... 2–34CSUM.......................................................................................................... 2–35MAVG......................................................................................................... 2–35MAX............................................................................................................ 2–36MDIFF......................................................................................................... 2–37MIN............................................................................................................. 2–38MLINREG .................................................................................................. 2–39MSUM......................................................................................................... 2–39
xiv Teradata RDBMS SQL/Data Dictionary Quick Reference
Contents
PERCENT_RANK .....................................................................................2–39QUANTILE.................................................................................................2–39RANK ..........................................................................................................2–39ROW_NUMBER ........................................................................................2–40SUM .............................................................................................................2–41
Set Operators ....................................................................................................2–42INTERSECT Operator...............................................................................2–43MINUS/EXCEPT Operator......................................................................2–43UNION Operator.......................................................................................2–44
String Functions ...............................................................................................2–45CHAR2HEXINT ........................................................................................2–45Concatenation Operator ...........................................................................2–45INDEX .........................................................................................................2–45LOWER .......................................................................................................2–45POSITION...................................................................................................2–46SOUNDEX ..................................................................................................2–46SUBSTRING/SUBSTR ..............................................................................2–46TRANSLATE..............................................................................................2–46TRANSLATE_CHK...................................................................................2–47TRIM............................................................................................................2–47UPPER.........................................................................................................2–47VARGRAPHIC...........................................................................................2–47
Chapter 3: SQL Data Definition Language Statement Syntax
ALTER PROCEDURE........................................................................................3–2ALTER TABLE....................................................................................................3–3
Basic Table Parameters Modification Syntax ..........................................3–3Primary Index Modification Syntax..........................................................3–5Partitioned Primary Index Revalidation Syntax .....................................3–6
ALTER TRIGGER...............................................................................................3–7
Teradata RDBMS SQL/Data Dictionary Quick Reference xv
Contents
BEGIN LOGGING............................................................................................. 3–8COMMENT ........................................................................................................ 3–9CREATE DATABASE ..................................................................................... 3–10CREATE HASH INDEX ................................................................................. 3–11CREATE INDEX .............................................................................................. 3–12CREATE JOIN INDEX.................................................................................... 3–13
Multitable Syntax...................................................................................... 3–13Single-Table Syntax .................................................................................. 3–15
CREATE/REPLACE MACRO....................................................................... 3–17CREATE/REPLACE PROCEDURE ............................................................. 3–18CREATE PROFILE .......................................................................................... 3–22CREATE ROLE ................................................................................................ 3–23CREATE TABLE .............................................................................................. 3–24
Create Table Syntax .................................................................................. 3–24Copy Table Syntax .................................................................................... 3–27
CREATE TRIGGERREPLACE TRIGGER................................................................................. 3–29
CREATE USER................................................................................................. 3–30CREATE/REPLACE VIEW ........................................................................... 3–31DATABASE ...................................................................................................... 3–32DELETE DATABASE
DELETE USER ........................................................................................... 3–33DROP DATABASE ......................................................................................... 3–34DROP HASH INDEX...................................................................................... 3–35DROP INDEX................................................................................................... 3–36DROP JOIN INDEX......................................................................................... 3–37DROP MACRO
DROP PROCEDUREDROP TABLEDROP TRIGGERDROP VIEW .............................................................................................. 3–38
DROP PROFILE............................................................................................... 3–39
xvi Teradata RDBMS SQL/Data Dictionary Quick Reference
Contents
DROP ROLE......................................................................................................3–40DROP USER......................................................................................................3–41END LOGGING ...............................................................................................3–42MODIFY DATABASE .....................................................................................3–43MODIFY PROFILE...........................................................................................3–44MODIFY USER.................................................................................................3–45RENAME MACRO
RENAME PROCEDURERENAME TABLERENAME VIEWRENAME TRIGGER..................................................................................3–46
SET ROLE..........................................................................................................3–47SET SESSION....................................................................................................3–48
Set Session Syntax......................................................................................3–48Set Session Collation .................................................................................3–48Set Session Account...................................................................................3–48Set Session Dateform.................................................................................3–49Set Session Database .................................................................................3–49
SET TIME ZONE ..............................................................................................3–50
Chapter 4: SQL Data Control Language Statement Syntax
GIVE.....................................................................................................................4–2GRANT................................................................................................................4–3
Role Form......................................................................................................4–4GRANT LOGON................................................................................................4–5REVOKE ..............................................................................................................4–6
Role Form......................................................................................................4–7REVOKE LOGON..............................................................................................4–8
Teradata RDBMS SQL/Data Dictionary Quick Reference xvii
Contents
Chapter 5: Query and Workload Analysis Statements
BEGIN QUERY LOGGING.............................................................................. 5–2COLLECT DEMOGRAPHICS ......................................................................... 5–3COLLECT STATISTICS .................................................................................... 5–4
CREATE INDEX Syntax............................................................................. 5–4COLLECT STATISTICS (QCD Form)............................................................. 5–5DROP STATISTICS (Optimizer Form)........................................................... 5–6DROP STATISTICS (QCD Form) .................................................................... 5–8DUMP EXPLAIN............................................................................................... 5–9END QUERY LOGGING................................................................................ 5–10INITIATE INDEX ANALYSIS ....................................................................... 5–11INSERT EXPLAIN........................................................................................... 5–12RESTART INDEX ANALYSIS ....................................................................... 5–13DIAGNOSTIC DUMP COSTS ....................................................................... 5–14DIAGNOSTIC DUMP SAMPLES ................................................................. 5–15DIAGNOSTIC HELP COSTS......................................................................... 5–16DIAGNOSTIC HELP SAMPLES ................................................................... 5–17DIAGNOSTIC SET COSTS ............................................................................ 5–18DIAGNOSTIC SET SAMPLES....................................................................... 5–19
General Syntax .......................................................................................... 5–19Disable All Samples Syntax..................................................................... 5–19
DIAGNOSTIC “Validate Index” ................................................................... 5–20
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOW
HELP ................................................................................................................... 6–2HELP (Online Form) ......................................................................................... 6–3HELP COLUMN................................................................................................ 6–4HELP CONSTRAINT........................................................................................ 6–5
xviii Teradata RDBMS SQL/Data Dictionary Quick Reference
Contents
HELP DATABASEHELP USER ..................................................................................................6–6
HELP HASH INDEX .........................................................................................6–7HELP INDEX ......................................................................................................6–8HELP JOIN INDEX............................................................................................6–9HELP MACRO
HELP TABLEHELP VIEW................................................................................................6–10
HELP PROCEDURE ........................................................................................6–11HELP SESSION ................................................................................................6–12HELP STATISTICS (Optimizer Form) ..........................................................6–13HELP STATISTICS (QCD Form) ...................................................................6–14HELP TRIGGER ...............................................................................................6–15HELP VOLATILE TABLE...............................................................................6–16SHOW ................................................................................................................6–17SHOW JOIN INDEX
SHOW MACROSHOW PROCEDURESHOW TABLESHOW TRIGGERSHOW VIEW..............................................................................................6–18
Chapter 7: SQL Client-Server Connectivity Statements
CONNECT ..........................................................................................................7–2GET CRASH........................................................................................................7–3LOGOFF ..............................................................................................................7–4LOGON ...............................................................................................................7–5SET BUFFERSIZE...............................................................................................7–6SET CHARSET....................................................................................................7–7SET CONNECTION ..........................................................................................7–8SET CRASH.........................................................................................................7–9
Teradata RDBMS SQL/Data Dictionary Quick Reference xix
Contents
Chapter 8: The SELECT Statement
SELECT ............................................................................................................... 8–2SELECT INTO.................................................................................................... 8–5
Embedded SQL Form................................................................................. 8–5Stored Procedures Form ............................................................................ 8–5DISTINCT and ALL Options .................................................................... 8–6FROM Clause............................................................................................... 8–6WHERE Clause ........................................................................................... 8–6
Subqueries in Search Conditions .................................................................... 8–7Clauses ................................................................................................................ 8–8
SAMPLEID Expression .............................................................................. 8–9
Chapter 9: SQL Data Manipulation Language Statement Syntax
ABORT ................................................................................................................ 9–2ASYNC Statement Modifier............................................................................. 9–3BEGIN DECLARE SECTION........................................................................... 9–4BEGIN TRANSACTION .................................................................................. 9–5CALL ................................................................................................................... 9–6CHECKPOINT................................................................................................... 9–7COMMENT ........................................................................................................ 9–8COMMIT............................................................................................................. 9–9DATABASE ...................................................................................................... 9–10DECLARE STATEMENT ............................................................................... 9–11DECLARE TABLE ........................................................................................... 9–12DELETE............................................................................................................. 9–13DESCRIBE......................................................................................................... 9–15ECHO ................................................................................................................ 9–16END DECLARE SECTION ............................................................................ 9–17
xx Teradata RDBMS SQL/Data Dictionary Quick Reference
Contents
END-EXEC Statement Terminator ................................................................9–18END TRANSACTION.....................................................................................9–19EXEC ..................................................................................................................9–20EXEC SQL Statement Prefix ...........................................................................9–21EXECUTE ..........................................................................................................9–22EXECUTE IMMEDIATE .................................................................................9–23EXPLAIN Modifier ..........................................................................................9–24INCLUDE..........................................................................................................9–25INSERT ..............................................................................................................9–26LOCKING Modifier .........................................................................................9–27MERGE ..............................................................................................................9–28PREPARE ..........................................................................................................9–29ROLLBACK.......................................................................................................9–30TEST ...................................................................................................................9–31UPDATE............................................................................................................9–32USING Row Descriptor...................................................................................9–34WAIT..................................................................................................................9–35WHENEVER.....................................................................................................9–36
Chapter 10: SQL Stored Procedures
BEGIN - END Statement .................................................................................10–2CASE ..................................................................................................................10–3DECLARE .........................................................................................................10–4DECLARE HANDLER ....................................................................................10–5FOR.....................................................................................................................10–6IF .........................................................................................................................10–7ITERATE............................................................................................................10–8LEAVE ...............................................................................................................10–9LOOP ...............................................................................................................10–10REPEAT ...........................................................................................................10–11
Teradata RDBMS SQL/Data Dictionary Quick Reference xxi
Contents
SET................................................................................................................... 10–12WHILE ............................................................................................................ 10–13
Chapter 11: Cursors and Cursor Control Statements
CLOSE............................................................................................................... 11–2DECLARE CURSOR ....................................................................................... 11–3
Dynamic SQL Form .................................................................................. 11–3Macro Form................................................................................................ 11–3Request Form............................................................................................. 11–3Selection Form ........................................................................................... 11–3Stored Procedures Form .......................................................................... 11–4
FETCH............................................................................................................... 11–5Embedded SQL Form............................................................................... 11–5Stored Procedures Form .......................................................................... 11–5
OPEN................................................................................................................. 11–6Embedded SQL Form............................................................................... 11–6Stored Procedures Form .......................................................................... 11–6
POSITION......................................................................................................... 11–7REWIND ........................................................................................................... 11–8
Chapter 12: Data Dictionary Views
View Definitions .............................................................................................. 12–2DBC.AccessLog ......................................................................................... 12–3DBC.AccLogRules..................................................................................... 12–4DBC.AccLogRules (continued) ............................................................... 12–5DBC.AccountInfo[X]................................................................................. 12–6DBC.AllRights ........................................................................................... 12–6DBC.AllRoleRights ................................................................................... 12–7
xxii Teradata RDBMS SQL/Data Dictionary Quick Reference
Contents
DBC.AllSpace[X]........................................................................................12–8DBC.AllTempTables[X] ............................................................................12–8DBC.All_RI_Children ...............................................................................12–9DBC.All_RI_Parents ................................................................................12–10DBC.AMPUsage ......................................................................................12–10DBC.Association ......................................................................................12–11DBC.CharSets...........................................................................................12–11DBC.CharTranslations ............................................................................12–12DBC.Children[X]......................................................................................12–12DBC.Collations.........................................................................................12–12DBC.Columns[X] .....................................................................................12–13DBC.ColumnStats....................................................................................12–14DBC.Databases[X] ...................................................................................12–15DBC.Databases2.......................................................................................12–15DBC.Database_Default_Journals[X] .....................................................12–16DBC.DBCInfo ...........................................................................................12–16DBC.DBQLRules......................................................................................12–17DBC.DeleteAccessLog[X] .......................................................................12–17DBC.DeleteOldInDoubt..........................................................................12–18DBC.DiskSpace[X] ...................................................................................12–19DBC.Events[X] .........................................................................................12–20DBC.Events_Configuration[X] ..............................................................12–21DBC.Events_Media[X] ............................................................................12–21DBC.Functions .........................................................................................12–22DBC.Hardware_Event_Log ...................................................................12–23DBC.HostsInfo .........................................................................................12–24DBC.IndexConstraints ............................................................................12–24DBC.IndexStats ........................................................................................12–25DBC.Indices[X].........................................................................................12–26DBC.InDoubtLog.....................................................................................12–27DBC.Journals[X].......................................................................................12–27DBC.LogOnOff ........................................................................................12–28
Teradata RDBMS SQL/Data Dictionary Quick Reference xxiii
Contents
DBC.LogonRules..................................................................................... 12–28DBC.ProfileInfo[X].................................................................................. 12–29DBC.QryLog ............................................................................................ 12–30DBC.QryLogExplain............................................................................... 12–32DBC.QryLogObjects ............................................................................... 12–33DBC.QryLogSQL .................................................................................... 12–33DBC.QryLogSteps................................................................................... 12–34DBC.QryLogSummary........................................................................... 12–35DBC.RCC_Configuration[X] ................................................................. 12–35DBC.RCC_Media[X] ............................................................................... 12–35DBC.RI_Child_Tables............................................................................. 12–36DBC.RI_Distinct_Children .................................................................... 12–36DBC.RI_Distinct_Parents ....................................................................... 12–37DBC.RI_Parent_Tables ........................................................................... 12–37DBC.RoleInfo[X]...................................................................................... 12–38DBC.RoleMembers[X] ............................................................................ 12–38DBC.SecurityDefaults............................................................................. 12–39DBC.SecurityLog[X] ............................................................................... 12–39DBC.SessionInfo[X] ................................................................................ 12–40DBC.ShowColChecks ............................................................................. 12–41DBC.ShowTblChecks ............................................................................. 12–41DBC.Software_Event_Log ..................................................................... 12–42DBC.Table_LevelConstraints ................................................................ 12–43DBC.Tables[X] ......................................................................................... 12–44DBC.Tables2............................................................................................. 12–45DBC.TableSize[X].................................................................................... 12–45DBC.TableText......................................................................................... 12–45DBC.Triggers ........................................................................................... 12–46DBC.UserGrantedRights........................................................................ 12–47DBC.UserRights ...................................................................................... 12–47DBC.UserRoleRights .............................................................................. 12–48DBC.Users ................................................................................................ 12–49
xxiv Teradata RDBMS SQL/Data Dictionary Quick Reference
Contents
DBC.User_Default_Journals[X] .............................................................12–50
Appendix A: How to Read Syntax Diagrams
Syntax Diagram Conventions .........................................................................A–2
Appendix B: Restricted Words for V2R5.0
Reserved and Keywords for V2R5.0........................................................ B–1Reserved Words Script .............................................................................. B–1Running the Script...................................................................................... B–2
Teradata RDBMS SQL/Data Dictionary Quick Reference xxv
Contents
xxvi Teradata RDBMS SQL/Data Dictionary Quick Reference
Chapter 1:
Data Types and Literals
Teradata RDBMS SQL/Data Dictionary Quick Reference 1 – 1
Chapter 1: Data Types and LiteralsByte Data Types
Byte Data Types
BYTE
VARBYTE
FF07D170
BYTE
n( ) attributes
FF07D171
VARBYTE
n( ) attributes
Teradata RDBMS SQL/Data Dictionary Quick Reference1 – 2
Chapter 1: Data Types and LiteralsCharacter Data Types
Character Data Types
CASESPECIFIC Phrase
CHARACTER Type
LONG VARCHAR Type
UPPERCASE Phrase
FF07D205
NOT
CASESPECIFIC
CS
FF07D190
CHARACTER
n( )CHAR server_data_typeCHARACTER SET attributes
FF07D234
n(
GRAPHIC
) attributes
FF07D192
LONG VARCHAR
attributes
FF07D236
LONG VARGRAPHIC
attributes
FF07D206
UPPERCASE
UC
Teradata RDBMS SQL/Data Dictionary Quick Reference 1 – 3
Chapter 1: Data Types and LiteralsCharacter Data Types
VARCHAR Type
FF07D191
VARCHAR
n( )CHARACTER VARYING
CHAR VARYING
server_data_typeCHARACTER SET attributes
FF07D235
n(VARGRAPHIC )
attributes
Teradata RDBMS SQL/Data Dictionary Quick Reference1 – 4
Chapter 1: Data Types and LiteralsData Literals
Data Literals
CHARACTER Data Literals
DATE Literals
DECIMAL Literals
FLOATING POINT Literals
GRAPHIC Literals
1101A009
'string'
_character_set
FF07R017
DATE quotestring
KR01A143
± n.
±.n
±n.n
KR01A142
± nE± m
± n.E± m
±.nE± m
±n.nE± m
HH01A090
G '< ABC >'
Teradata RDBMS SQL/Data Dictionary Quick Reference 1 – 5
Chapter 1: Data Types and LiteralsData Literals
Hexadecimal Literals
External Client Form
Internal DBS Form
INTEGER Literals
INTERVAL DAY Literals
HH01A081
X 'hexadecimal digits'
1101A011
'hexadecimal digits' XC
VCharacterOptions
FB
VF
I124
ByteOptions
IntegerOptions
_character_set
KR01A141
± n
FF07D112
quotestringINTERVAL
sign
DAY
Teradata RDBMS SQL/Data Dictionary Quick Reference1 – 6
Chapter 1: Data Types and LiteralsData Literals
INTERVAL DAY TO HOUR Literals
INTERVAL DAY TO MINUTE Literals
INTERVAL DAY TO SECOND Literals
INTERVAL HOUR Literals
INTERVAL HOUR TO MINUTE Literals
FF07D113
quotestringINTERVAL
sign
DAY TO HOUR
FF07D114
quotestringINTERVAL
sign
DAY TO MINUTE
FF07D115
quotestringINTERVAL
sign
DAY TO SECOND
FF07D116
quotestringINTERVAL
sign
HOUR
FF07D129
quotestringINTERVAL
sign
HOUR TO MINUTE
Teradata RDBMS SQL/Data Dictionary Quick Reference 1 – 7
Chapter 1: Data Types and LiteralsData Literals
INTERVAL HOUR TO SECOND Literals
INTERVAL MINUTE Literals
INTERVAL MINUTE TO SECOND Literals
INTERVAL MONTH Literals
INTERVAL SECOND
FF07D130
quotestringINTERVAL
sign
HOUR TO SECOND
FF07D131
quotestringINTERVAL
sign
MINUTE
FF07D132
quotestringINTERVAL
sign
MINUTE TO SECOND
FF07D111
quotestringINTERVAL
sign
MONTH
FF07D133
quotestringINTERVAL
sign
SECOND
Teradata RDBMS SQL/Data Dictionary Quick Reference1 – 8
Chapter 1: Data Types and LiteralsData Literals
INTERVAL YEAR Literals
INTERVAL YEAR TO MONTH Literals
TIME Literals
TIMESTAMP Literals
FF07D109
quotestringINTERVAL
sign
YEAR
FF07D110
quotestringINTERVAL
sign
YEAR TO MONTH
FF07D107
TIME quotestring
FF07D108
TIMESTAMP quotestring
Teradata RDBMS SQL/Data Dictionary Quick Reference 1 – 9
Chapter 1: Data Types and LiteralsDateTime and Interval Data Types
DateTime and Interval Data Types
DATE Data Type
INTERVAL DAY Data Type
INTERVAL DAY TO HOUR Data Type
INTERVAL DAY TO MINUTE Data Type
INTERVAL DAY TO SECOND Data Type
FF07D139
DATE
attributes
FF07D123
INTERVAL DAY
( )precision attributes
FF07D124
INTERVAL DAY
( )precision
TO HOUR
attributes
FF07D125
INTERVAL DAY
( )precision
TO MINUTE
attributes
FF07D126
INTERVAL DAY
( )precision
TO SECOND
( )fractional_seconds_precision attributes
Teradata RDBMS SQL/Data Dictionary Quick Reference1 – 10
Chapter 1: Data Types and LiteralsDateTime and Interval Data Types
INTERVAL HOUR Data Type
INTERVAL HOUR TO MINUTE Data Type
INTERVAL HOUR TO SECOND Data Type
INTERVAL MINUTE Data Type
INTERVAL MINUTE TO SECOND Data Type
FF07D127
INTERVAL HOUR
( )precision attributes
FF07D128
INTERVAL HOUR
( )precision
TO MINUTE
attributes
FF07D102
TO SECONDINTERVAL HOUR
( )precision ( )fractional_seconds_precision attributes
FF07D103
INTERVAL MINUTE
( )precision attributes
FF07D104
TO SECONDINTERVAL MINUTE
( )precision ( )fractional_seconds_precision attributes
Teradata RDBMS SQL/Data Dictionary Quick Reference 1 – 11
Chapter 1: Data Types and LiteralsDateTime and Interval Data Types
INTERVAL MONTH Data Type
INTERVAL SECOND Data Type
INTERVAL YEAR Data Type
INTERVAL YEAR TO MONTH Data Type
TIME Data Type
1101A013
INTERVAL MONTH
attributes(precision)
FF07D105
INTERVAL SECOND
(precision )
,fractional_seconds_precision
attributes
FF07D121
INTERVAL YEAR
( )precision attributes
FF07D122
INTERVAL YEAR
( )precision
TO MONTH
attributes
FF07D117
TIME
( )fractional_seconds_precision attributes
Teradata RDBMS SQL/Data Dictionary Quick Reference1 – 12
Chapter 1: Data Types and LiteralsDateTime and Interval Data Types
TIME WITH TIME ZONE Data Type
TIMESTAMP Data Type
TIMESTAMP WITH TIME ZONE Data Type
FF07D119
TIME
( )fractional_seconds_precision
WITH TIME ZONE
attributes
FF07D118
TIMESTAMP
( )fractional_seconds_precision attributes
FF07D120
TIMESTAMP
( )fractional_seconds_precision
WITH TIME ZONE
attributes
Teradata RDBMS SQL/Data Dictionary Quick Reference 1 – 13
Chapter 1: Data Types and LiteralsDecimal/Numeric Data Types
Decimal/Numeric Data Types
BYTEINT Data Type
DECIMAL/NUMERIC Data Type
FLOAT/REAL/DOUBLE PRECISION Data Type
INTEGER Data Type
SMALLINT Data Type
FF07D186
BYTEINT
attributes
FF07D185
DECIMAL
n( )DEC
NUMERIC ,m
attributes
FF07D189
FLOAT
REAL
DOUBLE PRECISION
attributes
FF07D188
INTEGER
INT attributes
FF07D187
SMALLINTattributes
Teradata RDBMS SQL/Data Dictionary Quick Reference1 – 14
Chapter 1: Data Types and LiteralsDefault Value Control Phrases
Default Value Control Phrases
COMPRESS Phrase
DEFAULT Phrase
NOT NULL Phrase
WITH DEFAULT Phrase
NULL
const
COMPRESS
FF07A066
FF07R018
DEFAULT constant_valueDATE quotestringTIME quotestringTIMESTAMP quotestringINTERVAL quotestring qualifier
sign
FF07D148
NOT NULL
FF07D149
WITH DEFAULT
Teradata RDBMS SQL/Data Dictionary Quick Reference 1 – 15
Chapter 1: Data Types and LiteralsOutput Format Phrases
Output Format Phrases
AS
FORMAT
NAMED
TITLE
FF07D146
value_expression
AS
name
FF07D250
FORMAT 'format_string'
(expression) name)(NAMED
FF07D147
FF07D145
TITLE quotestring
Teradata RDBMS SQL/Data Dictionary Quick Reference1 – 16
Chapter 2:
SQL Functions and Expressions
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 1
Chapter 2: SQL Functions and ExpressionsAggregate Functions
Aggregate Functions
AVG
CORR
COUNT
COVAR_POP
COVAR_SAMP
FF07D210
AVERAGE ( )column_expression
AVG DISTINCT
AVE
KO01A022
CORR value_expression_1, value_expression_2( )
FF07D211
COUNT ( )column_name
DISTINCT
*
KO01A021
COVAR_POP value_expression_1, value_expression_2( )
KO01A046
COVAR_SAMP value_expression_1, value_expression_2( )
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 2
Chapter 2: SQL Functions and ExpressionsAggregate Functions
KURTOSIS
MAX
MIN
REGR_AVGX
REGR_AVGY
REGR_COUNT
KO01A020
KURTOSIS value_expression( )
DISTINCT
FF07D212
MAXIMUM ( )column_name
DISTINCTMAX
column_expression
FF07D213
MINIMUM ( )column_name
DISTINCTMIN
column_expression
KO01A041
REGR_AVGX dependent_column_expression, independent_column_expression( )
KO01A042
REGR_AVGY dependent_column_expression, independent_column_expression( )
KO01A040
REGR_COUNT dependent_column_expression, independent_column_expression( )
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 3
Chapter 2: SQL Functions and ExpressionsAggregate Functions
REGR_INTERCEPT
REGR_R2
REGR_SLOPE
REGR_SXX
REGR_SXY
REGR_SYY
KO01B024
REGR_INTERCEPT dependent_column_expression, independent_column_expression ( )
KO01A039
REGR_R2 dependent_column_expression, independent_column_expression( )
KO01B023
REGR_SLOPE dependent_column_expression, independent_column_expression( )
KO01A043
REGR_SXX dependent_column_expression, independent_column_expression( )
KO01A045
REGR_SXY dependent_column_expression, independent_column_expression( )
KO01A044
REGR_SYY dependent_column_expression, independent_column_expression( )
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 4
Chapter 2: SQL Functions and ExpressionsAggregate Functions
SKEW
STDDEV_POP
STDDEV_SAMP
SUM
VAR_POP
VAR_SAMP
KO01A019
SKEW value_expression( )
DISTINCT
KO01A016
STDDEV_POP value_expression( )
DISTINCT
KO01A015
STDDEV_SAMP value_expression( )
DISTINCT
FF07D214
SUM ( )column_expression
DISTINCT
KO01A018
VARIANCEP value_expression( )
DISTINCTVAR_POP
KO01A017
VARIANCE value_expression( )
DISTINCTVAR_SAMP
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 5
Chapter 2: SQL Functions and ExpressionsArithmetic Operators and Functions/Trigonometric/Hyperbolic Functions
Arithmetic Operators and Functions/Trigonometric/Hyperbolic Functions
Arithmetic Operators
Teradata supports the following arithmetic operators:
Operator Function
** Exponentiate
This is a Teradata extension to the ANSI SQL-99 standard.
* Multiply
/ Divide
MOD Modulo (remainder).
MOD calculates the remainder in a division operation.
For example, 60 MOD 7 = 4: 60 divided by 7 equals 8, with a remainder of 4. The result takes the sign of the dividend, thus:
-17 MOD 4 = -1
-17 MOD -4 = -1
17 MOD -4 = 1
17 MOD 4 = 1
This is a Teradata extension to the ANSI SQL-99 standard.
+ Add
- Subtract
+ Unary plus (positive value)
- Unary minus (negative value)
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 6
Chapter 2: SQL Functions and ExpressionsArithmetic Operators and Functions/Trigonometric/Hyperbolic Functions
ABS
ACOS
ACOSH
ASIN
KK01A010
ABS arg( )
KO01A020
ACOS arg( )
KO01A021
ACOSH arg( )
KO01A022
ASIN arg( )
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 7
Chapter 2: SQL Functions and ExpressionsArithmetic Operators and Functions/Trigonometric/Hyperbolic Functions
ASINH
ATAN
ATAN2
KO01A023
ASINH arg( )
KO01A024
ATAN arg( )
KO01A025
ATAN2 x, y( )
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 8
Chapter 2: SQL Functions and ExpressionsArithmetic Operators and Functions/Trigonometric/Hyperbolic Functions
ATANH
CASE_N
COS
KO01A026
ATANH arg( )
1101A069
A
A
NO CASE
UNKNOWN
OR UNKNOWN
, UNKNOWN
,
)
CASE_N
,
conditional_expression(
KO01A027
COS arg( )
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 9
Chapter 2: SQL Functions and ExpressionsArithmetic Operators and Functions/Trigonometric/Hyperbolic Functions
COSH
EXP
LN
LOG
KK01a001
COSH arg( )
KK01A002
EXP arg( )
KK01A003
LN arg( )
KK01A004
LOG arg( )
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 10
Chapter 2: SQL Functions and ExpressionsArithmetic Operators and Functions/Trigonometric/Hyperbolic Functions
NULLIFZERO
RANDOM
1101E225
NULLIFZERO ( )arg
1101B025
RANDOM lower_bound, upper_bound( )
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 11
Chapter 2: SQL Functions and ExpressionsArithmetic Operators and Functions/Trigonometric/Hyperbolic Functions
RANGE_N
NO RANGE
UNKNOWN
OR UNKNOWN
, UNKNOWN
,
BETWEENRANGE_N test_expression(
1101A068
A B
B
C
D
C
A
start_expression end_expressionAND
* EACH range_size
* end_expressionAND
*
start_expression
end_expressionAND EACH range_size
*
D
| range_list |
)
end_expressionAND
start_expression,
end_expressionAND EACH range_size
start_expression, end_expressionAND
* EACH range_size
range_list
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 12
Chapter 2: SQL Functions and ExpressionsArithmetic Operators and Functions/Trigonometric/Hyperbolic Functions
SIN
SINH
SQRT
KK01A005
SIN arg( )
KK01A006
SINH arg( )
KK01A007
SQRT arg( )
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 13
Chapter 2: SQL Functions and ExpressionsArithmetic Operators and Functions/Trigonometric/Hyperbolic Functions
TAN
TANH
WIDTH_BUCKET
ZEROIFNULL
KK01A008
TAN arg( )
KK01A009
TANH arg( )
1101A004
WIDTH BUCKET value_expression, lower_bound, upper_bound, partition_count( )
1101E226
ZEROIFNULL ( )arg
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 14
Chapter 2: SQL Functions and ExpressionsAttribute Functions
Attribute Functions
BYTES
CHARACTERS
CHARACTER_LENGTH
FORMAT
MCHARACTERS
FF07D174
BYTE byte_expression
S
FF07D165
string_expressionCHARACTERS ( )
CHARS
CHAR
FF07D088
CHARACTER_LENGTH (string_expression)CHAR_LENGTH
FF07D166
column_nameFORMAT ( )
FF07D217
MCHARACTERS (string_expression )
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 15
Chapter 2: SQL Functions and ExpressionsAttribute Functions
OCTET_LENGTH
TYPE
FF07D218
OCTET_LENGTH string_expression( )
character_set_name
FF07D169
expressionTYPE ( )
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 16
Chapter 2: SQL Functions and ExpressionsBuilt-In Functions
Built-In Functions
ACCOUNT
CURRENT_DATE
CURRENT_TIME
CURRENT_TIMESTAMP
DATABASE
FF07R001
ACCOUNT
FF07D135
CURRENT_DATE
FF07D136
CURRENT_TIME
( )fractional_precision
FF07D137
CURRENT_TIMESTAMP
( )fractional_precision
FF07R002
DATABASE
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 17
Chapter 2: SQL Functions and ExpressionsBuilt-In Functions
DATE
PROFILE
ROLE
SESSION
TIME
USER
FF07D134
DATE
PROFILE
KZ01A006
ROLE
KZ01A007
FF07R003
SESSION
FF07D271
TIME
FF07D272
USER
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 18
Chapter 2: SQL Functions and ExpressionsCASE Expressions
CASE Expressions
Valued CASE Expression
Searched CASE Expression
1101A012
value_expression_1CASE
END
A
B
scalar_expression_mELSE
WHEN BA value_expression_n THEN scalar_expression_n
FF07D224
CASE
END
A
A
scalar_expression_mELSE
WHEN search_condition_n THEN scalar_expression_n
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 19
Chapter 2: SQL Functions and ExpressionsCASE Expressions
COALESCE Expression
NULLIF Expression
1101E227
COALESCE
2,
( )scalar_expression_n
HH01B094
NULLIF scalar_expression1, scalar_expression2( )
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 20
Chapter 2: SQL Functions and ExpressionsComparison Operators
Comparison Operators
ANSI OperatorTeradata
ExtensionsFunction
= EQ Tests for equality.
<> ^=
NE
NOT=
Tests for inequality.
< LT Tests for less than.
<= LE Tests for less than or equal.
> GT Tests for greater than.
>= GE Tests for greater than or equal.
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 21
Chapter 2: SQL Functions and ExpressionsComparison Operators
Comparison Operators Syntax
FF07D160
scalar_expression comparison_operator scalar_expression
1101D219
expression_1 expression_2
quantifier
,operator
expression_1 quantifieroperator constant( )
expression_1 operator subquery( )
quantifier
operator subquery( )expression_1( )
,
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 22
Chapter 2: SQL Functions and ExpressionsData Type Conversions
Data Type Conversions
CAST
Teradata Conversion Syntax
KK01A011
CAST AS ansi_sql_data_type
data_type_list
expression( )
HH01A019
expression ( data_type_list )
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 23
Chapter 2: SQL Functions and ExpressionsDateTime and Interval Functions and Expressions
DateTime and Interval Functions and Expressions
Arithmetic Operators and Result Types
The following arithmetic operations are permitted for DateTime and Interval data types:
First Value Type Operator Second Value Type Result Type
DateTime - DateTime Interval
DateTime + Interval DateTime
DateTime - Interval DateTime
Interval + DateTime DateTime
Interval + Interval Interval
Interval - Interval Interval
Interval * Number Interval
Interval / Number Interval
Number * Interval Interval
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 24
Chapter 2: SQL Functions and ExpressionsDateTime and Interval Functions and Expressions
ANSI DateTime Expressions
date_time_expression Syntax
date_time_term Syntax
ANSI Interval Expressions
interval_expression Syntax
interval_term Syntax
FF07D266
interval_expression
date_time_term
date_time_term+
date_time_expression interval_term±
FF07D265
AT
date_time_primary
TIME ZONE
LOCAL
interval_expression
1101A010
interval_expression
interval_term
interval_term±
date_time_expression date_time_term )( start
TO end
FF07D268
interval_term
interval_primary
numeric_factor*
numeric_term interval_factor*
±
/
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 25
Chapter 2: SQL Functions and ExpressionsDateTime and Interval Functions and Expressions
numeric_term Syntax
numeric_factor Syntax
ADD_MONTHS
Date Syntax
Timestamp Syntax
FF07D270
numeric_term
numeric_factor
numeric_factor*
/
FF07D269
numeric_primary±
FF07D202
ADD_MONTHS ( )date_expression, integer_expression
FF07D208
ADD_MONTHS ( )timestamp_expression, integer_expression
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 26
Chapter 2: SQL Functions and ExpressionsDateTime and Interval Functions and Expressions
EXTRACT
FF07D144
EXTRACT
MONTH
( )YEAR valueFROM
DAY
HOUR
MINUTE
SECOND
TIMEZONE_HOUR
TIMEZONE_MINUTE
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 27
Chapter 2: SQL Functions and ExpressionsHash-Related Functions
Hash-Related Functions
HASHAMP
HASHBAKAMP
HASHBUCKET
HH01A027
HASHAMP (
expression
)
HH01A028
HASHBAKAMP (
expression
)
HH01A026
HASHBUCKET (
expression
)
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 28
Chapter 2: SQL Functions and ExpressionsHash-Related Functions
HASHROW
1101B026
HASHROW,
(
expression
)
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 29
Chapter 2: SQL Functions and ExpressionsLogical Predicates
Logical Predicates
ANY/ALL/SOME Subquery Syntax
Syntax 1
Syntax 2
BETWEEN/NOT BETWEEN
EXISTS/NOT EXISTS
1101A090
comparison_operator constantexpression ( )ALLANY
SOME
,
1101B041
comparison_operator subqueryexpression( ) ( )ALLANY
SOME
,
HH01A038
NOT
expr1 BETWEEN expr2 AND expr3
HH01A047
subquery
NOT
EXISTS
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 30
Chapter 2: SQL Functions and ExpressionsLogical Predicates
IN/NOT IN
Syntax 1
Syntax 2
IS NULL/IS NOT NULL
Logical Operator
HH01B001
NOT
expression_1 IN,
expression_2
( constant )
datetime_literal
HH01B002NOT
IN subquery
,
( )( ))expression )
NOT
expression IN subquery( ))
HH01A042
NOT
expression IS NULL
FF07D220
ORexpression_1 ORexpression_2 expression_3
FF07D221
AND NOTexpression_1 expression_2
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 31
Chapter 2: SQL Functions and ExpressionsLogical Predicates
LIKE
OVERLAPS
FF07D196
NOT
LIKE
ESCAPE escape_character
( pattern_expression )
,
NOT
expression LIKE
ESCAPE escape_character
( subquery )
,
NOT
expression LIKE
ESCAPE escape_character
( subquery )( )
NOT
expression LIKE pattern_expression
ESCAPE escape_character
,
expression( )
ALL
ANY
SOME
ALL
ANY
SOME
ALL
ANY
SOME
FF07D164
datetime_expression, datetime_expression datetime_expression, datetime_expression( OVERLAPS
datetime_expression, interval_expression
) ( )
row_subquery
datetime_expression, interval_expression
row_subquery
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 32
Chapter 2: SQL Functions and ExpressionsOrdered Analytical Functions
Ordered Analytical Functions
AVG
1101B101
AVG value_expression( )
PARTITION BY column_reference
,
OVER (
value_expression
A
A
ORDER BY
ROWS UNBOUNDED PRECEDING
CURRENT ROW
UNBOUNDED FOLLOWINGROWS BETWEEN
CURRENT ROW
,
ASC
DESC
B )
B
value PRECEDING
UNBOUNDED PRECEDING AND
value PRECEDING
value FOLLOWING
UNBOUNDED FOLLOWING
CURRENT ROW
value PRECEDING
value FOLLOWING
value FOLLOWING
value PRECEDING AND
value FOLLOWING AND
UNBOUNDED FOLLOWINGCURRENT ROW AND
CURRENT ROW
value FOLLOWING
UNBOUNDED FOLLOWING
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 33
Chapter 2: SQL Functions and ExpressionsOrdered Analytical Functions
COUNT
1101B102
COUNT value_expression( )
PARTITION BY column_reference
,
OVER
*
(
value_expression
A
A
ORDER BY
ROWS UNBOUNDED PRECEDING
CURRENT ROW
UNBOUNDED FOLLOWINGROWS BETWEEN
CURRENT ROW
,
ASC
DESC
B )
B
value PRECEDING
UNBOUNDED PRECEDING AND
value PRECEDING
value FOLLOWING
UNBOUNDED FOLLOWING
CURRENT ROW
value PRECEDING
value FOLLOWING
value FOLLOWING
value PRECEDING AND
value FOLLOWING AND
UNBOUNDED FOLLOWINGCURRENT ROW AND
CURRENT ROW
value FOLLOWING
UNBOUNDED FOLLOWING
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 34
Chapter 2: SQL Functions and ExpressionsOrdered Analytical Functions
CSUM
MAVG
FF07D080
CSUM (value_expression, sort_expression_list)
FF07D082
MAVG (value_expression, width, sort_expression_list)
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 35
Chapter 2: SQL Functions and ExpressionsOrdered Analytical Functions
MAX
1101B105
MAX value_expression( )
PARTITION BY column_reference
,
OVER (
value_expression
A
A
ORDER BY
ROWS UNBOUNDED PRECEDING
CURRENT ROW
UNBOUNDED FOLLOWINGROWS BETWEEN
CURRENT ROW
,
ASC
DESC
B )
B
value PRECEDING
UNBOUNDED PRECEDING AND
value PRECEDING
value FOLLOWING
UNBOUNDED FOLLOWING
CURRENT ROW
value PRECEDING
value FOLLOWING
value FOLLOWING
value PRECEDING AND
value FOLLOWING AND
UNBOUNDED FOLLOWINGCURRENT ROW AND
CURRENT ROW
value FOLLOWING
UNBOUNDED FOLLOWING
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 36
Chapter 2: SQL Functions and ExpressionsOrdered Analytical Functions
MDIFF
FF07D083
MDIFF (value_expression, width, sort_expression_list)
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 37
Chapter 2: SQL Functions and ExpressionsOrdered Analytical Functions
MIN
1101B106
MIN value_expression( )
PARTITION BY column_reference
,
OVER (
value_expression
A
A
ORDER BY
ROWS UNBOUNDED PRECEDING
CURRENT ROW
UNBOUNDED FOLLOWINGROWS BETWEEN
CURRENT ROW
,
ASC
DESC
B )
B
value PRECEDING
UNBOUNDED PRECEDING AND
value PRECEDING
value FOLLOWING
UNBOUNDED FOLLOWING
CURRENT ROW
value PRECEDING
value FOLLOWING
value FOLLOWING
value PRECEDING AND
value FOLLOWING AND
UNBOUNDED FOLLOWINGCURRENT ROW AND
CURRENT ROW
value FOLLOWING
UNBOUNDED FOLLOWING
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 38
Chapter 2: SQL Functions and ExpressionsOrdered Analytical Functions
MLINREG
MSUM
PERCENT_RANK
QUANTILE
RANK
Teradata - Specific Function
FF07D081
MLINREG (value_expression, width, sort_expression)
FF07D084
MSUM (value_expression, width, sort_expression_list)
1101B107
PERCENT_RANK()
PARTITION BY column_reference
,OVER (
ASC
value_expressionORDER BY )A
A
DESC
,
FF07D085
QUANTILE (quantile_constant, sort_expression_list)
FF07D086
RANK (sort_expression_list)
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 39
Chapter 2: SQL Functions and ExpressionsOrdered Analytical Functions
SQL-99 Window Function
ROW_NUMBER
1101B100
RANK()
PARTITION BY column_reference
,OVER (
ASC
value_expressionORDER BY )A
A
DESC
,
1101B108
ROW_NUMBER()
PARTITION BY column_reference
,OVER (
ASC
value_expressionORDER BY )A
A
DESC
,
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 40
Chapter 2: SQL Functions and ExpressionsOrdered Analytical Functions
SUM
1101B104
SUM value_expression( )
PARTITION BY column_reference
,
OVER (
value_expression
A
A
ORDER BY
ROWS UNBOUNDED PRECEDING
CURRENT ROW
UNBOUNDED FOLLOWINGROWS BETWEEN
CURRENT ROW
,
ASC
DESC
B )
B
value PRECEDING
UNBOUNDED PRECEDING AND
value PRECEDING
value FOLLOWING
UNBOUNDED FOLLOWING
CURRENT ROW
value PRECEDING
value FOLLOWING
value FOLLOWING
value PRECEDING AND
value FOLLOWING AND
UNBOUNDED FOLLOWINGCURRENT ROW AND
CURRENT ROW
value FOLLOWING
UNBOUNDED FOLLOWING
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 41
Chapter 2: SQL Functions and ExpressionsSet Operators
Set Operators
Syntax for query_term
Syntax for query_factor
Syntax for query_expression
FF07D178
(query_expression )
SELECT statement
HH01A061
query_term
INTERSECT query_termquery_factor
ALL
FF07D179
query_expression
query_factor
UNION
MINUS
EXCEPT
ALL
query_factor
(query_expression ) ORDER BY expression
,
ASC
DESC
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 42
Chapter 2: SQL Functions and ExpressionsSet Operators
INTERSECT Operator
Syntax
Semantics
MINUS/EXCEPT Operator
Syntax
Semantics
FF07D176
ALLquery_expression_1 INTERSECT query_expression_2
FF06A021
ALLquery factor INTERSECT query term
FF07D177
ALLquery_expression_1 MINUS query_expression_2
EXCEPT
FF07D179
query_expression
query_factor
UNION
MINUS
EXCEPT
ALL
query_factor
(query_expression ) ORDER BY expression
,
ASC
DESC
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 43
Chapter 2: SQL Functions and ExpressionsSet Operators
UNION Operator
Syntax
Semantics
FF07D175
ALLquery_expression_1 UNION query_expression_2
FF06A020
ALLquery expr UNION query factor
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 44
Chapter 2: SQL Functions and ExpressionsString Functions
String Functions
CHAR2HEXINT
Concatenation Operator
INDEX
LOWER
1101E173
CHAR2HEXINT ( character_string_expression )
FF07D195
string_expression_1 string_expression_2
string_expression_n
FF07D253
INDEX string_expression_1( ),string_expression_2
FF07D091
LOWER (character_string_expression)
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 45
Chapter 2: SQL Functions and ExpressionsString Functions
POSITION
SOUNDEX
SUBSTRING/SUBSTR
ANSI Syntax
Teradata Syntax
TRANSLATE
FF07D090
POSITION (string_expression_1 string_expression_2)IN
KO01A060
SOUNDEX string_expression( )
SUBSTRING
FOR n2
(string_expression )FROM n1
FF07D256
FF07D257
SUBSTR (string_expression,n1 )
,n2
1101E198
TRANSLATE character_string_expression
_encoding
( USING source_repertoire_name
_TO _target_repertoire_nameA
A
_suffix WITH ERROR
)
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 46
Chapter 2: SQL Functions and ExpressionsString Functions
TRANSLATE_CHK
TRIM
UPPER
VARGRAPHIC
1101E199
TRANSLATE_CHK character_string_expression
_encoding
( USING source_repertoire_name
_TO _target_repertoire_nameA
A
_suffix
)
1101E200
TRIM string_expression( )
FROM
trim_character
character_setBOTH
TRAILING
LEADING
FF07D258
UPPER character_string_expression( )
1101E197
VARGRAPHIC character_string_expression( )
Teradata RDBMS SQL/Data Dictionary Quick Reference 2 – 47
Chapter 2: SQL Functions and ExpressionsString Functions
Teradata RDBMS SQL/Data Dictionary Quick Reference2 – 48
Chapter 3:
SQL Data Definition Language Statement Syntax
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 1
Chapter 3: SQL Data Definition Language Statement SyntaxALTER PROCEDURE
ALTER PROCEDURE
1101Q001
ALTER PROCEDURE procedure_name
database_name.
ACOMPILE
A
WITH,
NOSPL
NOWARNING
;
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 2
Chapter 3: SQL Data Definition Language Statement SyntaxALTER TABLE
ALTER TABLE
Basic Table Parameters Modification Syntax
ALTER TABLEdatabase_name.
table_name
NO PROTECTION
FALLBACKA
WITH JOURNAL TABLE =
database_name.
table_name
NO
DUAL
JOURNAL
BEFORE
AFTER JOURNAL
NO
DUAL
LOCAL
NOT LOCAL
FREESPACE = integer
PERCENTDATABLOCKSIZE = integer
BYTES
KILOBYTES
KBYTES
IMMEDIATE
DATABLOCKSIZE
MAXIMUM
MINIMUM
Alter TableOptions
,
DEFAULT FREESPACE
DEFAULT
,
LOG
NO
ON COMMIT
PRESERVE
DELETE ROWS
CHECKSUM = integrity_checking_level
IMMEDIATE
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 3
Chapter 3: SQL Data Definition Language Statement SyntaxALTER TABLE
1101E034
ADD
CONSTRAINT name
UNIQUE
PRIMARY KEY
column_name
,DROP CONSTRAINT name
MODIFY
CONSTRAINT name
column_name ( boolean_condition )CHECK
DROP CHECK
column_name
CONSTRAINT name
ADD ( boolean_condition )CHECK
column_name
CONSTRAINT name
DROP INCONSISTENT REFERENCES
ADD
DROP
FOREIGN KEY
CONSTRAINT name
column_name REFERENCES table_name,
column_name
DROP column_name
ADD column_name NULL
ADD column_name data type declaration
data type attributes
UNIQUE
CONSTRAINT namePRIMARY KEY
CHECK ( boolean_condition )
REFERENCES table_name
( column_name )
,
ColumnStorage
Attributes
ColumnConstraintAttributes
ColumnChanges
ConstraintChanges
ReferenceDefinition
TableColumn
Definition
A
UniqueDefinition
,
data type attributes
,RENAME old_column_name TO new_column_name
AS( )
( )
( )
WITH CHECK OPTIONNO
WITH CHECK OPTIONNO
COMPRESSconstant
constant
,
( )
255
NULL
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 4
Chapter 3: SQL Data Definition Language Statement SyntaxALTER TABLE
Primary Index Modification Syntax
ALTER TABLE
NOT PARTITIONED
DROP RANGE
ADD RANGE
WHERE
BETWEEN start_expression
AND
,
end_expression EACH range_size NO RANGE
OR UNKNOWN
UNKNOWN,
,
conditional_expression
PARTITION BY partitioning_expression
WITH DELETE
INSERT save_table
INTO
MODIFY PRIMARY INDEX
NOT NAMED
database_name.index_name
column_name
;
,
)(
UNIQUE
NOT
table_name
A
1101B112
A
B
B
C
C
ADD RANGE BETWEEN start_expression
BETWEEN start_expression
AND end_expression EACH range_size NO RANGE
OR UNKNOWN
UNKNOWN,
,
UNKNOWN,
AND end_expression EACH range_size
INTO
UNKNOWN,
WITH DELETE
INSERT save_table
NO RANGE
OR UNKNOWN
UNKNOWN,
,
,
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 5
Chapter 3: SQL Data Definition Language Statement SyntaxALTER TABLE
Partitioned Primary Index Revalidation Syntax
ALTER TABLE REVALIDATE PRIMARY INDEXtable_name
database_name.
WITH DELETE
INSERT save_table
INTO
A
HH01A001
;
A
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 6
Chapter 3: SQL Data Definition Language Statement SyntaxALTER TRIGGER
ALTER TRIGGER
FF07D039
ALTER TRIGGER;database_name. table_name
trigger_name
DISABLED
ENABLED
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 7
Chapter 3: SQL Data Definition Language Statement SyntaxBEGIN LOGGING
BEGIN LOGGING
BEGIN LOGGING
FIRST
LAST
FIRST AND LAST
EACH
DENIALS WITH TEXT
ON A
ALL
BY
A,
operation
GRANTdatabase_name
, ON
object_name
VIEW
DATABASE database_name
USER user_name
TABLETABLE
MACRO
1101S044
database_name .
PROCEDURE
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 8
Chapter 3: SQL Data Definition Language Statement SyntaxCOMMENT
COMMENT
FF07D041
COMMENT;
object_name
ON DATABASE
USER
TABLE
VIEW
MACRO
COLUMN
TRIGGER
PROCEDURE
PROFILE
ROLE
AS
IS
'string'
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 9
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE DATABASE
CREATE DATABASE
1101E030
,
A
;
CREATE DATABASE name AS
FROM database_name
A
SPOOL = n
BYTES
ACCOUNT = 'account_ID'
FALLBACK
PROTECTIONNO
NO
DUAL
AFTER JOURNAL
DEFAULT JOURNAL TABLE =
database_name.
table_name
NO
DUAL
JOURNAL
BEFORE
LOCAL
NOT LOCAL
PERMANENT
PERM
= n
BYTES
CD
TEMPORARY = n
bytes
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 10
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE HASH INDEX
CREATE HASH INDEX
1101F379
CREATE HASH INDEX A
,
hash_index_name
ONA
FALLBACKNO
column_name_1
column_name_2
,
,
BY
PROTECTION
table_name
B
;ORDER BY VALUES
VALUES column_name_3 )(
,
HASH column_name_3 )(
,
column_name_3 )(
,
B( )
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 11
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE INDEX
CREATE INDEX
FF07D004
ON
;
join_index_name
CREATE
UNIQUE index_name
A
BA
B table_name
( column_name_1 )
,
INDEX
ALL
,
TEMPORARY
ORDER BY ( column_name_2 )
VALUES
HASH
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 12
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE JOIN INDEX
CREATE JOIN INDEX
Multitable Syntax
CREATE JOIN INDEX join_index_name
1101E294
;
A
BA column_1_name
,
,
column_1_name
, 16
)( , column_2_name
, 16
)(
CB table_nameFROM
correlation_name
AS
joined_table
DC
GROUP BY
D indexes
FALLBACK
NO PROTECTION
EXTRACT ( YEAR FROM
MONTH
date_expression AS correlation_name
column_name
,
AS SELECT
SUM
COUNT
EXTRACT
( numeric_expression ) AS correlation_name
( YEAR )
MONTH
FROM date_expression AS correlation_name
WHERE search_condition
,
column_name
column_position
ORDER BY
,
column_name
column_position
)
( column_expression )
ROWID
ROWIDROWID
ROWID
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 13
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE JOIN INDEX
1101E050
(joined_table)
joined_table
INNER
joined_table
joined_tableJOIN ON search_condition
LEFT
RIGHT OUTER
table_name
correlation_name
AS
FF07D051
PRIMARY
INDEX
ALL
( column_name_1 )
,
ORDER BY HASH
VALUES (column_name_2)
(column_name_2)
indexes
index_name
16
,
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 14
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE JOIN INDEX
Single-Table Syntax
CREATE JOIN INDEX join_index_name
1101E295
;
A
CB table_nameFROM
correlation_name
AS
C indexes
FALLBACK
NO PROTECTION
AS SELECT
GROUP BY column_name
column_position
ORDER BY column_name
column_position
BA column_1_name
,
,
column_1_name
, 16
)( , column_2_name
, 16
)(
EXTRACT ( YEAR FROM
MONTH
date_expression AS correlation_name
column_name
,
SUM
COUNT
EXTRACT
( numeric_expression ) AS correlation_name
( YEAR )
MONTH
FROM date_expression AS correlation_name
)
( column_expression )
ROWID
ROWIDROWID
ROWID
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 15
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE JOIN INDEX
FF07D051
PRIMARY
INDEX
ALL
( column_name_1 )
,
ORDER BY HASH
VALUES (column_name_2)
(column_name_2)
indexes
index_name
16
,
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 16
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE/REPLACE MACRO
CREATE/REPLACE MACRO
1101E172
AS
CREATE MACRO macro_name
parameter_name type declaration( )
,
;USING modifier
( statement ; )
type attribute
A
A
LOCKING modifier
CM
REPLACE MACRO
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 17
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE/REPLACE PROCEDURE
CREATE/REPLACE PROCEDURE
CREATE
REPLACE
PROCEDURE Aprocedure_name
database_name.
1101Q002
A ( ), 256parameter_name data_type
INOUT
IN
OUT
; statement
statement
YS6CP01B
ITERATE label_name
LEAVE label_name
iteration statement
label_name : label_name
SQL_statement
assignment statement
condition statement
compound statement
compound statement
label_name :local_declaration
BEGIN
cursor_declaration
B
YS6CP01C
END
label_name
B
condition_handler statement_list
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 18
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE/REPLACE PROCEDURE
YS6CP02a
local_declaration
DECLARE variable_name,
DEFAULT
data_type
literal
;
NULL
cursor_declaration
NO SCROLL
DECLARE cursor_name
SCROLL
CURSOR FOR C
FOR
UPDATE
READ ONLY
cursor_specification ;C
condition-handler
DECLARE HANDLER
EXIT
CONTINUE DFOR
YS6CP02b
;D
SQLEXCEPTION
SQLWARNING
NOT FOUND
,
SQLSTATE ,
VALUE
sqlstate_code handler_action _statement
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 19
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE/REPLACE PROCEDURE
YS6CP02C
assignment statement
SET assignment_target = assignment_source ;
YS6CP03A
condition statement
CASE operand_1 JWHEN operand_2 THEN statement ;
WHEN conditional_expression THEN statement
J
ELSE
END CASE
statement
IF conditional_expression THEN Gstatement
H
ELSE
END IF
statement
ELSEIF conditional_expression THEN
G H
statement
YS6CP03B
iteration statement
WHILE conditional-expression DO END WHILE ;statement
LOOP END LOOPstatement
EFOR for-loop-variable AS
CURSOR FORcursor-name
E DO END FORcursor-specification statement
REPEAT UNTIL conditional_expression END REPEATstatement
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 20
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE/REPLACE PROCEDURE
YS6CP03C
cursor-specification
SELECT FROM table_namecolumn_name
correlation_name
expression correlation_name
F,,
AS
AS
F
WHERE clause other SELECT clauses
,
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 21
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE PROFILE
CREATE PROFILE
CREATE PROFILE
AS
,
ACCOUNT = 'account_id',
'account_id'
NULL
DEFAULT DATABASE = database_name
SPOOL = n
BYTES
( )
;
profile_name
A
KZ01a001
A
TEMPORARY = n
BYTES
PASSWORD = EXPIRE =
,
n )(
ATTRIBUTESMINCHAR = n
MAXCHAR = n
DIGITS = c
SPECCHAR = c
MAXLOGONATTEMPTS = n
LOCKEDUSEREXPIRE = n
REUSE = n
NULL
NULL
NULL
NULL
NULL
NULL
NULL
NULL
NULL
NULL
NULL
NULL
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 22
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE ROLE
CREATE ROLE
CREATE ROLE
;
role_name
KZ01A003
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 23
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE TABLE
CREATE TABLE
Create Table Syntax
ACREATE table_name
SET
MULTISET
,
FALLBACK
PROTECTIONNO
FREESPACE = integer
database_name.
AFTER JOURNAL
LOG
NO
NO
DUAL
LOCAL
NOT LOCAL
PERCENT
CHECKSUM = integrity_checking_level
BYTE
KILOBYTE
KBYTE
DATABLOCKSIZE
MAXIMUM
MINIMUM
TABLE
CreateTable
Options
CT
GLOBAL TEMPORARY
VOLATILE
JOURNAL
NO
DUAL
BEFORE
WITH JOURNAL TABLE = table_name
DATABLOCKSIZE= integer
S
,
S
S
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 24
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE TABLE
‘
BA
data type attributes
UNIQUE
PRIMARY KEY
CHECK ( boolean condition )
REFERENCES
WITH CHECK OPTIONNO
table_name
column_name
UNIQUE
1101R019
PRIMARY KEY
( column_name )
CONSTRAINT
FOREIGN KEY
CONSTRAINT name
CHECK ( boolean_condition )
( column_name ) REFERENCES ,
ColumnStorageAttributes
ColumnConstraintAttributes
ColumnDefinition
UniqueDefinition
ReferencesDefinition
CheckDefinition
(
( column_name )
)
,
( column_name )
,
,
Tab
le L
evel
Def
initi
on
CONSTRAINT
GENERATED ALWAYS AS IDENTITY
START WITH(
INCREMENT BY
BY DEFAULT
name
CONSTRAINT name
name
datatype
declaration
table_nameWITH CHECK OPTION
NO
COMPRESSconstant
constant
,
( )
255
NULL
(
NO
MINVALUE
NO
MAXVALUE
NO
CYCLE
1101S021PRESERVE
ON COMMIT
C
DELETE ROWS ;
B C
,Index
Definition
,
PRIMARY INDEX
PARTITION BY partitioning_expression
primary_index_column( )
UNIQUE index_name
,
INDEX column_name( )
UNIQUE index_name ALL
,
INDEX ORDER BYVALUES
HASH
column_name( )index_name ALL
column_name( )
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 25
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE TABLE
FF07D203
INTEGER
SMALLINT
( integer )
FLOAT
NUMERIC
DECIMAL
CHAR
BYTES
GRAPHIC
LONG VARGRAPHIC
BYTEINT
DATE
REAL
DOUBLE PRECISION
( integer )
, integer
VARCHAR
CHAR VARYING
VARBYTE
VARGRAPHIC
( integer )
( integer )
LONG VARCHAR
Data Type Declarations
WITH TIMEZONE
TIME
WITH TIMEZONE
TIMESTAMP
TO MONTH
INTERVAL YEAR
INTERVAL MONTH
TO HOUR
INTERVAL DAY
TO MINUTE
TO SECOND
INTERVAL HOUR
TO MINUTE
TO SECOND
INTERVAL MINUTE
TO SECOND
INTERVAL SECOND
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 26
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE TABLE
Copy Table Syntax
FF07D204
NOT NULL
NOT
USER
DATE
TIME
NULL
UPPERCASE
CASESPECIFIC
TITLE
FORMAT quotestring
NAMED name
DEFAULT number
WITH DEFAULT
Data Type Attributes
UC
CS
CHARACTER SET character_data_type
ACREATE table_name
SET
MULTISET
FALLBACKPROTECTIONNO
FREESPACE = integer
database_name.
AFTER JOURNAL
LOG
NO
NO
DUAL
LOCAL
NOT LOCAL
PERCENT
CHECKSUM = integrity_checking_level
BYTE
KILOBYTE
KBYTE
DATABLOCKSIZE
MAXIMUM
MINIMUM
TABLE
CreateTable
Options
CT
,
,GLOBAL TEMPORARY
VOLATILE
JOURNAL
NO
DUAL
BEFORE
WITH JOURNAL TABLE = table_name
DATABLOCKSIZE= integer
S
S
S
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 27
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE TABLE
FF07D204
NOT NULL
NOT
USER
DATE
TIME
NULL
UPPERCASE
CASESPECIFIC
TITLE
FORMAT quotestring
NAMED name
DEFAULT number
WITH DEFAULT
Data Type Attributes
UC
CS
CHARACTER SET character_data_type
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 28
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE TRIGGER REPLACE TRIGGER
CREATE TRIGGERREPLACE TRIGGER
FF07D036
;
CREATE Atrigger_nameTRIGGER
A INSERT B
CB
DC
FOR EACH
D
,
REPLACE database_name.
ENABLED
DISABLED
BEFORE
AFTER
INSTEAD OF
DELETE
UPDATE
OF ( column_list )
ON table_name
database_name. ORDER integer
REFERENCING identifierOLD_TABLE
AS NEW_TABLE
AS
identifier
identifierOLD
AS NEW
AS
identifier
ROW
STATEMENT
WHEN (search_condition)
SQL _procedure_statement
BEGIN ATOMIC END_procedure_statementSQL ;(
( ;
)
)
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 29
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE USER
CREATE USER
1101A007
,
CREATE USER name PERMANENT
;
AS
FROM database_name
= n
BYTES
A
SPOOL = n
BYTES
PERM ,
A PASSWORD = password
DEFAULT DATABASE = database_name
FALLBACK
PROTECTIONNO
JOURNAL
BEFORENO
DUAL
DEFAULT JOURNAL TABLE =
database_name.
STARTUP = 'string;'
COLLATION =
,'account_ID'
,ACCOUNT = 'account_ID'
AFTER JOURNAL
NO
DUAL
LOCAL
NOT LOCAL
,
TEMPORARY = n
bytes
TIME ZONE = LOCAL
sign
quotestring
NULL
collation_sequence
table_name
'account_ID' ( )
DATEFORM = INTEGERDATE
ANSIDATE
NULL
DEFAULT ROLE =
PROFILE = profile_name
role_nameNONENULL
NULL
DEFAULT CHARACTER SET character_data_type
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 30
Chapter 3: SQL Data Definition Language Statement SyntaxCREATE/REPLACE VIEW
CREATE/REPLACE VIEW
1101S077
CREATE VIEW A
( column_name )
,view_name
LOCKING
DATABASE
database_name
TABLE
table_name
VIEW
view_name
ROW
LOCK FOR
IN
MODE
ACCESS
EXCLUSIVE
SHARE
READ
WRITE
EXCL
NOWAIT
BA
SELECT
ALL
table_name.*
DISTINCTexpression
alias_name
CSEL ,
FROM table_name
WHERE search_condition
E
C
E
GROUP BY column_name
,
HAVING condition ;
alias_nameAS
joined_table JOIN joined_table ON search_conditionINNERLEFT
RIGHTFULL
OUTER
D
CROSS JOIN single_table
( subquery ) derived_table_nameAS
( column_name )
,
,
D
column_positionexpression
DerivedTables
JoinedTables
SingleTables
WITH CHECK OPTION
AS
*
AS
B
CV
REPLACE VIEW
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 31
Chapter 3: SQL Data Definition Language Statement SyntaxDATABASE
DATABASE
FF07A016
DATABASE database_name
;
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 32
Chapter 3: SQL Data Definition Language Statement SyntaxDELETE DATABASE DELETE USER
DELETE DATABASEDELETE USER
FF07D026
DELETE name
DEL ;DATABASE
USER ALL
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 33
Chapter 3: SQL Data Definition Language Statement SyntaxDROP DATABASE
DROP DATABASE
1101A070
DROP DATABASE database_name
;
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 34
Chapter 3: SQL Data Definition Language Statement SyntaxDROP HASH INDEX
DROP HASH INDEX
FF07D380
DROP HASH INDEX;
hash_index_name
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 35
Chapter 3: SQL Data Definition Language Statement SyntaxDROP INDEX
DROP INDEX
DROP index_name Syntax
DROP index_definition Syntax
FF07D045
DROP INDEX
join_index_name
index_name ON;
table_nameTEMPORARY
FF07D003
ON
;
join_index_name
DROP INDEX
ALL
( column_name )
,
index_name
A
ORDER BY
BA
( column_name_2 )
B table_name
TEMPORARY
VALUES
HASH
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 36
Chapter 3: SQL Data Definition Language Statement SyntaxDROP JOIN INDEX
DROP JOIN INDEX
FF07D018
DROP JOIN INDEX
;
join_index_name
database_name.
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 37
Chapter 3: SQL Data Definition Language Statement SyntaxDROP MACRO DROP PROCEDURE DROP TABLE DROP TRIGGER DROP VIEW
DROP MACRODROP PROCEDUREDROP TABLEDROP TRIGGERDROP VIEW
FF07D093
DROP;
MACRO macro_name
TABLE table_name
TRIGGER trigger_name
TEMPORARY
VIEW view_name
ALL
database_name.
OVERRIDE
PROCEDURE procedure_name
database_name.
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 38
Chapter 3: SQL Data Definition Language Statement SyntaxDROP PROFILE
DROP PROFILE
DROP PROFILE
;
profile_name
KZ01A004
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 39
Chapter 3: SQL Data Definition Language Statement SyntaxDROP ROLE
DROP ROLE
DROP ROLE
;
role_name
KZ01A005
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 40
Chapter 3: SQL Data Definition Language Statement SyntaxDROP USER
DROP USER
1101A071
DROP USER user_name
;
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 41
Chapter 3: SQL Data Definition Language Statement SyntaxEND LOGGING
END LOGGING
END LOGGING
DENIALS WITH TEXT
ON
;
A
ALL
BY
A
B
B,
operation
GRANTdatabase_name
,
,
ON
object_name
VIEW
DATABASE database_name
USER user_name
TABLETABLE
MACRO
1101E371
database_name.
PROCEDURE
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 42
Chapter 3: SQL Data Definition Language Statement SyntaxMODIFY DATABASE
MODIFY DATABASE
FF07D025
MODIFY DATABASE dbname
;
FALLBACK
PROTECTIONNO
NO
DUAL
JOURNAL
BEFORE
AS PERMANENT
PERM
= number
BYTES
SPOOL = number
BYTES
DEFAULT JOURNAL TABLE = table_name
database_name.DROP DEFAULT JOURNAL TABLE
= table_name
,
NO
DUAL
AFTER JOURNAL
LOCAL
NOT LOCAL
ACCOUNT = 'account_ID'
TEMPORARY =
bytes
number
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 43
Chapter 3: SQL Data Definition Language Statement SyntaxMODIFY PROFILE
MODIFY PROFILE
MODIFY PROFILE AS
,
ACCOUNT = 'account_id',
'account_id'
NULL
DEFAULT DATABASE = database_name
SPOOL = n
BYTES
( ) ;
profile_name
A
KZ01a002
A
TEMPORARY = n
BYTES
PASSWORD = EXPIRE =
,
n )(
ATTRIBUTESMINCHAR = n
MAXCHAR = n
DIGITS = c
SPECCHAR = c
MAXLOGONATTEMPTS = n
LOCKEDUSEREXPIRE = n
REUSE = n
NULL
NULL
NULL
NULL
NULL
NULL
NULL
NULL
NULL
NULL
NULL
NULL
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 44
Chapter 3: SQL Data Definition Language Statement SyntaxMODIFY USER
MODIFY USER
1101A008
MODIFY USER username
FALLBACK
NO
AS
= number
BYTES
PERMANENT
PERM
PASSWORD = password
RELEASE PASSWORD LOCK
= number
BYTES
SPOOL
=ACCOUNT 'account_ID'
DEFAULT DATABASE =database_name
DEFAULT JOURNAL TABLE =
database_name
DROP DEFAULT JOURNAL TABLE
= table_name
PROTECTION
,
NO
DUAL
JOURNAL
BEFORE
NO
DUAL
AFTER JOURNAL
LOCAL
NOT LOCAL
( 'account_ID' ,'account_ID' )
STARTUP =
TIME ZONE = LOCAL
sign
quotestring
NULL
DATEFORM = INTEGERDATE
ANSIDATE
NULL
DEFAULT ROLE =
PROFILE = profile_name
role_nameNONENULL
NULL
TEMPORARY = number
BYTES
DEFAULT CHARACTER SET character_data_type
COLLATION = collation_sequence
NULL
quotestring
FOR USER
table_name
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 45
Chapter 3: SQL Data Definition Language Statement SyntaxRENAME MACRO RENAME PROCEDURE RENAME TABLE RENAME VIEW RENAME TRIGGER
RENAME MACRORENAME PROCEDURERENAME TABLERENAME VIEWRENAME TRIGGER
FF07D159
RENAME old_name
;MACRO
TABLE
VIEW
TO new_name
AS
TRIGGER
database_name.
PROCEDURE
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 46
Chapter 3: SQL Data Definition Language Statement SyntaxSET ROLE
SET ROLE
SET ROLE
;
role_name
NULL
NONE
KZ01A010
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 47
Chapter 3: SQL Data Definition Language Statement SyntaxSET SESSION
SET SESSION
Set Session Syntax
Set Session Collation
Set Session Account
1101S141
;COLLATIONSET SESSION
SS ACCOUNT= 'account_id' FOR
REQUEST
SESSION
DATEFORM =
DATABASE database_name
INTEGERDATE
ANSIDATE
collation_sequence
FF07D291
;COLLATIONSET SESSION
SS
collation_sequence
FF07D292
;ACCOUNT=SET SESSION
SS
'account_id' FOR
REQUEST
SESSION
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 48
Chapter 3: SQL Data Definition Language Statement SyntaxSET SESSION
Set Session Dateform
Set Session Database
FF07D293
;DATEFORM=SET SESSION
SS INTEGERDATE
ANSIDATE
1101A076
;SET SESSION DATABASE database_name
SS
Teradata RDBMS SQL/Data Dictionary Quick Reference 3 – 49
Chapter 3: SQL Data Definition Language Statement SyntaxSET TIME ZONE
SET TIME ZONE
FF07D143
;LOCAL
INTERVAL
SET TIME ZONE
USER
sign'time_zone_displacement' HOUR TO MINUTE
Teradata RDBMS SQL/Data Dictionary Quick Reference3 – 50
Chapter 4:
SQL Data Control Language Statement Syntax
Teradata RDBMS SQL/Data Dictionary Quick Reference 4 – 1
Chapter 4: SQL Data Control Language Statement SyntaxGIVE
GIVE
FF07A025
GIVE;
database_name TO recipient_name
user_name
Teradata RDBMS SQL/Data Dictionary Quick Reference4 – 2
Chapter 4: SQL Data Control Language Statement SyntaxGRANT
GRANT
SQL Form
MONITOR Form
AGRANT
1101S055
PRIVILEGES
ALL
,
ON database_name
database_name.object_name
object_name
TO
user_name
;WITH GRANT OPTION
A
privilege
, 25
ALL
,
PUBLIC
ALL BUT
privilege
,
PROCEDURE procedure_name
role_name
FF07A056
GRANT MONITOR TO
,
ALLuser_name
WITH GRANTOPTION
;
PRIVILEGES
BUT NOT
A
A
PUBLIC
,
,
monitor_privilege
monitor_privilege
Teradata RDBMS SQL/Data Dictionary Quick Reference 4 – 3
Chapter 4: SQL Data Control Language Statement SyntaxGRANT
Role Form
GRANT TOrole_name
,
;
KZ01a008
user_name
role_name
,
WITH ADMIN OPTION
Teradata RDBMS SQL/Data Dictionary Quick Reference4 – 4
Chapter 4: SQL Data Control Language Statement SyntaxGRANT LOGON
GRANT LOGON
FF07B027
GRANT LOGON
,
ON
ALL
host_id
WITH NULL PASSWORD ;AS DEFAULT
TO
,
FROM
database_name
Teradata RDBMS SQL/Data Dictionary Quick Reference 4 – 5
Chapter 4: SQL Data Control Language Statement SyntaxREVOKE
REVOKE
SQL Form
REVOKEGRANT OPTION FOR
ALL
privilege
,
ALL BUT
PRIVILEGES
,
,
TO
FROM ALLuser_name
PUBLIC
role_name
A
B
FF07R061
A
database_nameON
database_name.object_name
object_name
B
object_type
Teradata RDBMS SQL/Data Dictionary Quick Reference4 – 6
Chapter 4: SQL Data Control Language Statement SyntaxREVOKE
MONITOR Form
Role Form
GRANT OPTION FOR
FF07A062
,
TO
FROM ALLuser_name
PUBLIC
A
REVOKE MONITOR TOPRIVILEGES
BUT NOT
A
monitor_privilege
,
monitor_privilege
,
REVOKE role_name user_nameTO
,
;
KZ01a009
ADMIN OPTION FOR FROM role_name
,
Teradata RDBMS SQL/Data Dictionary Quick Reference 4 – 7
Chapter 4: SQL Data Control Language Statement SyntaxREVOKE LOGON
REVOKE LOGON
FF07A036
REVOKE LOGON
,
ON
ALL
host_id
;AS DEFAULT
TO
,
FROM
database_name
Teradata RDBMS SQL/Data Dictionary Quick Reference4 – 8
Chapter 5:
Query and Workload Analysis Statements
Teradata RDBMS SQL/Data Dictionary Quick Reference 5 – 1
Chapter 5: Query and Workload Analysis StatementsBEGIN QUERY LOGGING
BEGIN QUERY LOGGING
BEGIN QUERY LOGGING
1101B109
logging_option
;
,A
A
WITH limit_option LIMIT
limit_option AND
ON ALL
user_name
'account_name'
,,
,
ACCOUNT = ( )
Teradata RDBMS SQL/Data Dictionary Quick Reference5 – 2
Chapter 5: Query and Workload Analysis StatementsCOLLECT DEMOGRAPHICS
COLLECT DEMOGRAPHICS
1101A001
COLLECT DEMOGRAPHICS FOR table_name
table_name(
,
;
INTO QCD_name
ALL
WITH NO INDEX
A
A
)
Teradata RDBMS SQL/Data Dictionary Quick Reference 5 – 3
Chapter 5: Query and Workload Analysis StatementsCOLLECT STATISTICS
COLLECT STATISTICS
CREATE INDEX Syntax
COLLECT STATISTICS table_name
ONUSING SAMPLE
join_index_name
FF07D048
( column_name )
;
,
A
A
TEMPORARYCOLLECT STATS
COLLECT STAT
hash_index_name
COLUMN
COLUMN
( column_name )
,
INDEX
INDEX
column_name
index_name
FF07D355
ON
;
join_index_name
UNIQUEUSING SAMPLE
COLUMN
index_name
A
ORDER BY
A table_name
( column_name_1 )
column_name
,
( column_name )
,
INDEX
ALL
TEMPORARY
COLLECT STATISTICS
COLLECT STAT
COLLECT STATS
,
( column_name_2 )
VALUES
HASH
hash_index_name
Teradata RDBMS SQL/Data Dictionary Quick Reference5 – 4
Chapter 5: Query and Workload Analysis StatementsCOLLECT STATISTICS (QCD Form)
COLLECT STATISTICS (QCD Form)
PERCENT
B
ACOLLECT STATISTICS
STATS
STAT
FOR SAMPLE percentage
1101B004
COLUMN column_name ;
COLUMN ( column_name )
,
INDEX ( column_name )
,
INDEX index_name
INTO ON table_nameQCD_nameA B
Teradata RDBMS SQL/Data Dictionary Quick Reference 5 – 5
Chapter 5: Query and Workload Analysis StatementsDROP STATISTICS (Optimizer Form)
DROP STATISTICS (Optimizer Form)
Recommended Syntax
FF07D299
;
join_index_name
DROP STATISTICS
COLUMN column_name
A
BA
B table_name
FOR
,
TEMPORARY
DROP STATS
DROP STAT
INDEX
UNIQUE
COLUMN column_name
,
( )
index_name
INDEX
UNIQUE
( column_name_1 )
,
ORDER BY ( column_name_2 )
VALUES
HASH
index_name
ON
hash_index_name
Teradata RDBMS SQL/Data Dictionary Quick Reference5 – 6
Chapter 5: Query and Workload Analysis StatementsDROP STATISTICS (Optimizer Form)
Legacy Syntax
FF07D029
COLUMN column_name_1
INDEX ( column_name_2 )
INDEX name
,
DROP STATISTICS table_name
ON
join_index_name
;
A
A
TEMPORARYDROP STATS
DROP STAT
hash_index_name
COLUMN ( column_name_1 )
,
Teradata RDBMS SQL/Data Dictionary Quick Reference 5 – 7
Chapter 5: Query and Workload Analysis StatementsDROP STATISTICS (QCD Form)
DROP STATISTICS (QCD Form)
A
ADROP STATISTICS
STATS
STAT
FROM QCD_name ON table_name
1101B003
COLUMN column_name ;
COLUMN ( column_name )
,
INDEX ( column_name )
,
INDEX index_name
Teradata RDBMS SQL/Data Dictionary Quick Reference5 – 8
Chapter 5: Query and Workload Analysis StatementsDUMP EXPLAIN
DUMP EXPLAIN
LIMIT
INTODUMP EXPLAIN QCD_name
A
A
1101E321
;
SQL_statement
AS query_plan_name
SQL
= n
Teradata RDBMS SQL/Data Dictionary Quick Reference 5 – 9
Chapter 5: Query and Workload Analysis StatementsEND QUERY LOGGING
END QUERY LOGGING
1101B110
;
ONEND QUERY LOGGING ALL
user_name
'account_name'
,,
,
ACCOUNT = ( (
Teradata RDBMS SQL/Data Dictionary Quick Reference5 – 10
Chapter 5: Query and Workload Analysis StatementsINITIATE INDEX ANALYSIS
INITIATE INDEX ANALYSIS
INITIATE INDEX ANALYSIS FOR
SET boundary_option = value
workload_name
ON
IN AS index_name_tagQCD_name
,
table_name
,
KEEP INDEX USE MODIFIED STATISTICS
STATS
B
A
A
B C
1101B013
;CHECKPOINT checkpoint_trigger
C
STAT
Teradata RDBMS SQL/Data Dictionary Quick Reference 5 – 11
Chapter 5: Query and Workload Analysis StatementsINSERT EXPLAIN
INSERT EXPLAIN
1101E322
;SQL_statement
INTO QCD_name
AS query_plan_name
INSERT EXPLAIN
WITH STATISTICS AND DEMOGRAPHICS
NO
FOR
,
table_name
A
A B
FOR frequency
B
LIMIT
SQL
= n
Teradata RDBMS SQL/Data Dictionary Quick Reference5 – 12
Chapter 5: Query and Workload Analysis StatementsRESTART INDEX ANALYSIS
RESTART INDEX ANALYSIS
1101B111
RESTART INDEX ANALYSIS FOR IN QCD_nameworkload_name
;
AS index_name_tagA
A
Teradata RDBMS SQL/Data Dictionary Quick Reference 5 – 13
Chapter 5: Query and Workload Analysis StatementsDIAGNOSTIC DUMP COSTS
DIAGNOSTIC DUMP COSTS
FF07D327
DIAGNOSTIC
;
target_system_nameDUMP COSTS
'comment'
Teradata RDBMS SQL/Data Dictionary Quick Reference5 – 14
Chapter 5: Query and Workload Analysis StatementsDIAGNOSTIC DUMP SAMPLES
DIAGNOSTIC DUMP SAMPLES
GO01A001
;
DIAGNOSTIC
TABLE table_name
DUMP SAMPLES target_system_name
database_name.
A
A
Teradata RDBMS SQL/Data Dictionary Quick Reference 5 – 15
Chapter 5: Query and Workload Analysis StatementsDIAGNOSTIC HELP COSTS
DIAGNOSTIC HELP COSTS
FF07D328
DIAGNOSTIC
;
HELP COSTS
Teradata RDBMS SQL/Data Dictionary Quick Reference5 – 16
Chapter 5: Query and Workload Analysis StatementsDIAGNOSTIC HELP SAMPLES
DIAGNOSTIC HELP SAMPLES
GO01A002
;
DIAGNOSTIC HELP SAMPLES
target_system_name
Teradata RDBMS SQL/Data Dictionary Quick Reference 5 – 17
Chapter 5: Query and Workload Analysis StatementsDIAGNOSTIC SET COSTS
DIAGNOSTIC SET COSTS
FF07D326
DIAGNOSTIC
;
target_system_nameSET COSTS
TPA
NOT
ON FOR REQUEST
SESSION
IFP
SYSTEM
Teradata RDBMS SQL/Data Dictionary Quick Reference5 – 18
Chapter 5: Query and Workload Analysis StatementsDIAGNOSTIC SET SAMPLES
DIAGNOSTIC SET SAMPLES
General Syntax
Disable All Samples Syntax
;
DIAGNOSTIC
SESSION TABLE table_name
SET SAMPLES ON FOR
NOT
target_system_name
database_name.SYSTEM
A
A
GO01A004
GO01A003
;
SESSIONDIAGNOSTIC SET ALL SAMPLES NOT ON FOR
SYSTEM
Teradata RDBMS SQL/Data Dictionary Quick Reference 5 – 19
Chapter 5: Query and Workload Analysis StatementsDIAGNOSTIC “Validate Index”
DIAGNOSTIC “Validate Index”
TW01A002
DIAGNOSTIC "validate index" ON FOR SESSION
NOT ;
Teradata RDBMS SQL/Data Dictionary Quick Reference5 – 20
Chapter 6:
SQL Help and Database Object Definition Tools: HELP and SHOW
Teradata RDBMS SQL/Data Dictionary Quick Reference 6 – 1
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOWHELP
HELP
1101F022
;
DATABASE database_nameHELP
,
USER user_name
TABLE table_name
VIEW view_name
MACRO macro_name
COLUMN column_name FROM
,
table_name
COLUMN * FROM
,
table_name.
COLUMN
COLUMN table_name. *
INDEX table_name
( column_name )
,
STATISTICS table_name
SESSION
CONSTRAINT table_name.name
database_name.
table_name.column_name
,
join_index_name
join_index_name
JOIN INDEX join_index_name
TEMPORARY
TEMPORARY
TRIGGER
table_name
trigger_name
database_name.
VOLATILE TABLE
COLUMN expression
PROCEDURE procedure_name
database_name. ATTRIBUTES
ATTR
ATTRS
HASH INDEX hash_index_name
HELP STATISTICS
STATS
STAT
table_name FROM QCD_name
Teradata RDBMS SQL/Data Dictionary Quick Reference6 – 2
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOWHELP (Online Form)
HELP (Online Form)
1101A006
;' HELPHELP '
' SQL
commandname
' ARCHIVE
commandname
' DUMP
commandname
' FASTEXPORT
commandname
' FASTLOAD
commandname
' MULTILOAD
commandname
' PMPC
commandname
' TPCCONS
commandname
' SPL
commandname
Teradata RDBMS SQL/Data Dictionary Quick Reference 6 – 3
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOWHELP COLUMN
HELP COLUMN
Syntax 1
Syntax 2
Syntax 3
Syntax 4
Syntax 5
FF07D244
HELP COLUMN
,
;column_name FROM table_name
,
join_index_name
hash_index_name
FF07D245
HELP COLUMN;
* FROM table_name.
,
join_index_name
hash_index_name
FF07D246
HELP COLUMN;
table_name. column_name
,
join_index_name
hash_index_name
FF07D247
HELP COLUMN;
table_name.*
join_index_name
hash_index_name
FF07D264
HELP COLUMN
;
expression
Teradata RDBMS SQL/Data Dictionary Quick Reference6 – 4
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOWHELP CONSTRAINT
HELP CONSTRAINT
FF07D248
HELP CONSTRAINT
;
table_name. constraint_name
database_name.
Teradata RDBMS SQL/Data Dictionary Quick Reference 6 – 5
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOWHELP DATABASE HELP USER
HELP DATABASEHELP USER
FF07D240
HELP
user_name ;
database_name
USER
DATABASE
Teradata RDBMS SQL/Data Dictionary Quick Reference6 – 6
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOWHELP HASH INDEX
HELP HASH INDEX
HELP HASH INDEX hash_index_name;
1101A005
Teradata RDBMS SQL/Data Dictionary Quick Reference 6 – 7
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOWHELP INDEX
HELP INDEX
FF07D002
HELP
;
table_name
join_index_name
INDEX
TEMPORARY
column_name
;
)(
Teradata RDBMS SQL/Data Dictionary Quick Reference6 – 8
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOWHELP JOIN INDEX
HELP JOIN INDEX
FF07D047
HELP JOIN INDEX join_index_name;
Teradata RDBMS SQL/Data Dictionary Quick Reference 6 – 9
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOWHELP MACRO HELP TABLE HELP VIEW
HELP MACROHELP TABLEHELP VIEW
FF07D241
HELP;
joint_index_name
MACRO
TABLE
macro_name
table_name
VIEW view_name
Teradata RDBMS SQL/Data Dictionary Quick Reference6 – 10
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOWHELP PROCEDURE
HELP PROCEDURE
YSHP004
HELP PROCEDURE procedure_name
database_name. ; ATTRIBUTES
ATTRS
ATTR
Teradata RDBMS SQL/Data Dictionary Quick Reference 6 – 11
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOWHELP SESSION
HELP SESSION
FF07D242
HELP SESSION
;
Teradata RDBMS SQL/Data Dictionary Quick Reference6 – 12
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOWHELP STATISTICS (Optimizer Form)
HELP STATISTICS (Optimizer Form)
FF07D243
HELP
;
table_name STATISTICS
TEMPORARY STATS
STAT
join_index_name
hash_index_name
Teradata RDBMS SQL/Data Dictionary Quick Reference 6 – 13
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOWHELP STATISTICS (QCD Form)
HELP STATISTICS (QCD Form)
1101B005
HELP STATISTICS
STATS
STAT
table_name
;
FROM QCD_name
Teradata RDBMS SQL/Data Dictionary Quick Reference6 – 14
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOWHELP TRIGGER
HELP TRIGGER
FF07D038
HELP TRIGGER;table_name
trigger_name
database_name
Teradata RDBMS SQL/Data Dictionary Quick Reference 6 – 15
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOWHELP VOLATILE TABLE
HELP VOLATILE TABLE
FF07D249
HELP VOLATILE TABLE
;
table_name
Teradata RDBMS SQL/Data Dictionary Quick Reference6 – 16
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOWSHOW
SHOW
KO01A012
SHOW dml_statement
;QUALIFIED
Teradata RDBMS SQL/Data Dictionary Quick Reference 6 – 17
Chapter 6: SQL Help and Database Object Definition Tools: HELP and SHOWSHOW JOIN INDEX SHOW MACRO SHOW PROCEDURE SHOW TABLE SHOW TRIGGER SHOW VIEW
SHOW JOIN INDEXSHOW MACROSHOW PROCEDURESHOW TABLESHOW TRIGGERSHOW VIEW
Embedded SQL Syntax
FF07D024
SHOW;
HASH INDEX hash_index_name
TABLE table_name
TRIGGER trigger_name
TEMPORARY
VIEW view_name
MACRO macro_name
PROCEDURE procedure_name
database_name.
JOIN INDEX join_index_name
SHOW
GW01A034
object_name
TABLE
INTO
host_variable_name
A
: : host_indicator_name
A
MACRO
VIEW
dbname.
INDICATOR
Teradata RDBMS SQL/Data Dictionary Quick Reference6 – 18
Chapter 7:
SQL Client-Server Connectivity Statements
Teradata RDBMS SQL/Data Dictionary Quick Reference 7 – 1
Chapter 7: SQL Client-Server Connectivity StatementsCONNECT
CONNECT
CONNECT idvar IDENTIFIED BY passwordvar
: :
JR01A002
AS
A
A
connection_name
: namevar
Teradata RDBMS SQL/Data Dictionary Quick Reference7 – 2
Chapter 7: SQL Client-Server Connectivity StatementsGET CRASH
GET CRASH
GET CRASH
GW01A058
WAIT, TELL waitvar,INTO
:tellvar,
:
Teradata RDBMS SQL/Data Dictionary Quick Reference 7 – 3
Chapter 7: SQL Client-Server Connectivity StatementsLOGOFF
LOGOFF
LOGOFF
JR01A004
CURRENT
:host_variable_name
ALL
connection_name
Teradata RDBMS SQL/Data Dictionary Quick Reference7 – 4
Chapter 7: SQL Client-Server Connectivity StatementsLOGON
LOGON
LOGON
:
JR01A003
AS connection_name
: namevar
logon_string
Teradata RDBMS SQL/Data Dictionary Quick Reference 7 – 5
Chapter 7: SQL Client-Server Connectivity StatementsSET BUFFERSIZE
SET BUFFERSIZE
SET BUFFERSIZE
GW01A032
size
Teradata RDBMS SQL/Data Dictionary Quick Reference7 – 6
Chapter 7: SQL Client-Server Connectivity StatementsSET CHARSET
SET CHARSET
SET CHARSET
GW01A033
set_name
:set_name_var
Teradata RDBMS SQL/Data Dictionary Quick Reference 7 – 7
Chapter 7: SQL Client-Server Connectivity StatementsSET CONNECTION
SET CONNECTION
SET CONNECTION
JR01A005
connection_name
: namevar
Teradata RDBMS SQL/Data Dictionary Quick Reference7 – 8
Chapter 7: SQL Client-Server Connectivity StatementsSET CRASH
SET CRASH
SET CRASH
GW01A057
NOWAIT_TELL
WAIT_NOTELL
Teradata RDBMS SQL/Data Dictionary Quick Reference 7 – 9
Chapter 7: SQL Client-Server Connectivity StatementsSET CRASH
Teradata RDBMS SQL/Data Dictionary Quick Reference7 – 10
Chapter 8:
The SELECT Statement
Teradata RDBMS SQL/Data Dictionary Quick Reference 8 – 1
Chapter 8: The SELECT StatementSELECT
SELECT
SELECT
ALL
table_name.*
DISTINCTexpression
alias_name
ASEL ,
FROM table_nameA
GROUP BY column_name,
alias_nameAS
join_table_name joined_tableINNERLEFT
RIGHTFULL
OUTER
B
CROSS JOIN
( subquery ) derived_table_nameAS
( column_name )
,
column_positionexpression
AS
*
WHERE search_conditionCB
HAVING conditional_expressionQUALIFY search_condition
,
ON search_condition
DerivedTables
JoinedTables
SingleTables
JOIN
Teradata RDBMS SQL/Data Dictionary Quick Reference8 – 2
Chapter 8: The SELECT StatementSELECT
1101S080
C
G
;G
ORDER BY,
DESC
ASC
column_position
column_nameexpression
WITH,
expression_1
DESC
ASC
,expression_2BY
SAMPLE
WITH REPLACEMENT RANDOMIZED ALLOCATION
count_description
fraction_description
count_description
fraction_descriptionTHENconditionWHEN
,
,
count_description
fraction_descriptionELSE
END,
D
D
E
E
F
F
Teradata RDBMS SQL/Data Dictionary Quick Reference 8 – 3
Chapter 8: The SELECT StatementSELECT
Simple SELECT Statement
FF06R024
SELECT FROM table_nameSEL
expression
,
;column_name
*
Teradata RDBMS SQL/Data Dictionary Quick Reference8 – 4
Chapter 8: The SELECT StatementSELECT INTO
SELECT INTO
Embedded SQL Form
Stored Procedures Form
select_list A
A
SELECT
SEL ALL
INTO
host_variable_name
GW01A048
B
:
,
from_clause
DISTINCT
:host_indicator_name
INDICATOR
B
where_clause
select_listSELECT
SEL ALL
INTO
: local_variable_name
ff07D406
,
from_clause
DISTINCT
: parameter_name where_clause
C
C
Teradata RDBMS SQL/Data Dictionary Quick Reference 8 – 5
Chapter 8: The SELECT StatementSELECT INTO
DISTINCT and ALL Options
FROM Clause
WHERE Clause
FF06A018
ALLDISTINCT
FF06A013
FROM table_name
correlation_nameAS
joined_table JOIN joined_table ON search_conditionINNERLEFT
RIGHTFULL
OUTER
CROSS JOIN single_table
( subquery ) derived_table_nameAS ,
,
DerivedTables
JoinedTables
SingleTables
( )column_name
FF06R011
WHERE search_condition
Teradata RDBMS SQL/Data Dictionary Quick Reference8 – 6
Chapter 8: The SELECT StatementSubqueries in Search Conditions
Subqueries in Search Conditions
Syntax 1
Syntax 2: Logical Expressions
HH01B064
expression
IN
NOT IN
, ANY
SOME
comparison_operator
ALL
(query )
expression )(
HH01A065
EXISTS (query )
Teradata RDBMS SQL/Data Dictionary Quick Reference 8 – 7
Chapter 8: The SELECT StatementClauses
Clauses
GROUP BY Clause
HAVING Clause
QUALIFY Clause
FF06R015
GROUP BY column_name
,
column_positionexpression
FF06R016
HAVING condition
FF07D087
QUALIFY search_condition
Teradata RDBMS SQL/Data Dictionary Quick Reference8 – 8
Chapter 8: The SELECT StatementClauses
SAMPLE Clause
SAMPLEID Expression
SAMPLE
WITH REPLACEMENT RANDOMIZED ALLOCATION
1101A065
count_description
fraction_description
count_description
fraction_descriptionTHENconditionWHEN
,
,
count_description
fraction_descriptionELSE
END,
A
A
B
B
C
C
FF07D180
SAMPLEID
Teradata RDBMS SQL/Data Dictionary Quick Reference 8 – 9
Chapter 8: The SELECT StatementClauses
ORDER BY Clause
WITH Clause
FF06R017
ORDER BY
,
DESC
ASC
column_position
column_name
expression
FF06B014
WITH
,
expression_1
DESC
ASC
,
expression_2BY
Teradata RDBMS SQL/Data Dictionary Quick Reference8 – 10
Chapter 9:
SQL Data Manipulation Language Statement Syntax
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 1
Chapter 9: SQL Data Manipulation Language Statement SyntaxABORT
ABORT
FF07R068
ABORT
FROM optionabort_message WHERE abort_condition
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 2
Chapter 9: SQL Data Manipulation Language Statement SyntaxASYNC Statement Modifier
ASYNC Statement Modifier
JR01A001
ASYNC ( )async_statement_modifier async_SQL_statement
:host_variable_name
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 3
Chapter 9: SQL Data Manipulation Language Statement SyntaxBEGIN DECLARE SECTION
BEGIN DECLARE SECTION
BEGIN DECLARE SECTION
GW01A001
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 4
Chapter 9: SQL Data Manipulation Language Statement SyntaxBEGIN TRANSACTION
BEGIN TRANSACTION
BEGIN TRANSACTION
GW01A040BT
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 5
Chapter 9: SQL Data Manipulation Language Statement SyntaxCALL
CALL
IN argument
CALL procedurename
dbname .
( )
;
,
IN argument
INOUT argument
OUT argument
value expression
?
INOUT argument
OUT argument
value expression
?
YSCALL001
CAST AS data type( )
param-name
OUT call placeholder
OUT call placeholder
out_call_variable
OUT call placeholder
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 6
Chapter 9: SQL Data Manipulation Language Statement SyntaxCHECKPOINT
CHECKPOINT
Interactive Syntax
Embedded SQL and Stored Procedure Syntax
FF07A007
CHECKPOINT tname
, NAMED chkpt_name ;
GW01A002
CHECKPOINT table_name
dbname. ,NAMED
: lablevar
ckpt_label
A
A INTO:
host_variable_name
B
B
: host_indicator_name
INDICATOR
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 7
Chapter 9: SQL Data Manipulation Language Statement SyntaxCOMMENT
COMMENT
Placing Form
Returning Form
COMMENT
GW01A004
objkind objref 'comment '
ON IS
AS
COMMENT objkind objref
ON
INTO
host_variable_name
A
:
A
GW01A005
B
B
:host_indicator_name
INDICATOR
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 8
Chapter 9: SQL Data Manipulation Language Statement SyntaxCOMMIT
COMMIT
COMMIT
GW01A006
WORK
RELEASE
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 9
Chapter 9: SQL Data Manipulation Language Statement SyntaxDATABASE
DATABASE
DATABASE
GW01A008
dbname
:dbnamevar
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 10
Chapter 9: SQL Data Manipulation Language Statement SyntaxDECLARE STATEMENT
DECLARE STATEMENT
DECLARE
GW01A013
STATEMENTstatement_name
,
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 11
Chapter 9: SQL Data Manipulation Language Statement SyntaxDECLARE TABLE
DECLARE TABLE
DECLARE
GW01R014
table_name TABLE A
A column_name
view_name
( )
null_attribute
,
data_type
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 12
Chapter 9: SQL Data Manipulation Language Statement SyntaxDELETE
DELETE
Basic/Searched Form
Join Condition Form
DELETE table_name
DEL
WHERE
ALL
condition
FROM
AS
table_name correlation_name
1101C072
;
A
A
DELETE table_namedelete_table_name
DEL
WHERE
ALL
condition
AS
correlation_name
1101C073
;
A
A
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 13
Chapter 9: SQL Data Manipulation Language Statement SyntaxDELETE
Positioned Form
DELETE FROM table_name
delete_table_nameDEL
WHERE
ALL
condition
AS
correlation_name
1101C074
;
A
A
GW01A046
table_nameFROM WHERE CURRENT OF cursor_nameDELETE
DEL
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 14
Chapter 9: SQL Data Manipulation Language Statement SyntaxDESCRIBE
DESCRIBE
DESCRIBE
GW01A015
statement_name INTO A
A
:
descriptor_area
USING
B
NAMES
ANY
BOTH
LABELS
FOR STATEMENT statement_number
numvar
:
B
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 15
Chapter 9: SQL Data Manipulation Language Statement SyntaxECHO
ECHO
FF07R022
ECHO ' string '
' command '
;
;
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 16
Chapter 9: SQL Data Manipulation Language Statement SyntaxEND DECLARE SECTION
END DECLARE SECTION
END DECLARE SECTION
GW01A016
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 17
Chapter 9: SQL Data Manipulation Language Statement SyntaxEND-EXEC Statement Terminator
END-EXEC Statement Terminator
FF07D287
END-EXEC.
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 18
Chapter 9: SQL Data Manipulation Language Statement SyntaxEND TRANSACTION
END TRANSACTION
END TRANSACTION
GW01A041ET
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 19
Chapter 9: SQL Data Manipulation Language Statement SyntaxEXEC
EXEC
EXEC
GW01A043
macroname
(parameter_list )
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 20
Chapter 9: SQL Data Manipulation Language Statement SyntaxEXEC SQL Statement Prefix
EXEC SQL Statement Prefix
FF07D288
EXEC SQL sql_statement_terminatorembedded_sql_statement
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 21
Chapter 9: SQL Data Manipulation Language Statement SyntaxEXECUTE
EXECUTE
Macro Form
Dynamic SQL Form
FF07A023
EXECUTEEXEC ;
macroname
( param_name = const_expr )
( const_expr )
,
,
EXECUTE
GW01A017
statement_name A
A
USING host_variable_name
: :host_indicator_name
INDICATOR
,
USING DESCRIPTOR descriptor_area
:
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 22
Chapter 9: SQL Data Manipulation Language Statement SyntaxEXECUTE IMMEDIATE
EXECUTE IMMEDIATE
EXECUTE IMMEDIATE
GW01A018
statement_string
statement_string_var
:
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 23
Chapter 9: SQL Data Manipulation Language Statement SyntaxEXPLAIN Modifier
EXPLAIN Modifier
FF07D251
EXPLAIN
;
_statementSQL
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 24
Chapter 9: SQL Data Manipulation Language Statement SyntaxINCLUDE
INCLUDE
Syntax
SQLCA
SQLDA
INCLUDE
GW01A020
text_name
INCLUDE SQLCA
GW01A021
INCLUDE SQLDA
GW01A022
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 25
Chapter 9: SQL Data Manipulation Language Statement SyntaxINSERT
INSERT
FF07B030
INSERTINS ;
table_name
( column_name )
INTO VALUES,
VALUES
subquery
( column_name )
,
DEFAULT VALUES
,
( expression )
,
( expression )
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 26
Chapter 9: SQL Data Manipulation Language Statement SyntaxLOCKING Modifier
LOCKING Modifier
FF07R031
LOCKING
DATABASE
database_name
TABLE
table_name
VIEW
view_name
ROW
LOCK FOR
IN
MODE
ACCESS
EXCLUSIVE
SHARE
READ
WRITE
CHECKSUM
EXCL
NOWAIT
A
;A statement
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 27
Chapter 9: SQL Data Manipulation Language Statement SyntaxMERGE
MERGE
MERGE
USING VALUES ( using_expression
source_table_name
target_tableINTO correlation_name
AS
WHEN MATCHED THEN UPDATE SET update_column=update_expression
UPD
match_condition ON
WHEN NOT MATCHED clause
(
( subquery AS(
( column_name
,
,
( C
A
A
B
B
D
E
WHEN NOT MATCHED THEN INSERT
INS VALUES
insert_column VALUES
,
( )
,
D
1101B012
;
C
WHEN NOT MATCHED clause
WHEN NOT MATCHED clause
E
insert_expression
,
( )
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 28
Chapter 9: SQL Data Manipulation Language Statement SyntaxPREPARE
PREPARE
PREPARE
GW01A029
statement_name
B
USING NAMES
ANY
BOTH
LABELS
FOR STATEMENT statement_number
numvar
:
B
descriptor_areaINTO:
FROM statement_string
statement_string_var
:
A2
A1
A2
A1
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 29
Chapter 9: SQL Data Manipulation Language Statement SyntaxROLLBACK
ROLLBACK
ROLLBACK
GW01R031
WORK 'abort_message'
RELEASE
FROM_clause
A
A
WHERE_clause ;
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 30
Chapter 9: SQL Data Manipulation Language Statement SyntaxTEST
TEST
TEST
JR01A007
async_statement_identifier COMPLETION: namevar
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 31
Chapter 9: SQL Data Manipulation Language Statement SyntaxUPDATE
UPDATE
Searched Form
Positioned Form
UPDATE table_name
FF07B040
ALL
WHERE condition
SET column_name = expression
,
FROM table_name
alias_nameAS
,
A
A
UPD alias_nameAS
;
GW01A047
table_name A
A
alias_name
SET
,
WHERE CURRENT OF cursor_name
UPDATE
UPD
;
column_name = expression
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 32
Chapter 9: SQL Data Manipulation Language Statement SyntaxUPDATE
Upsert Form
FF07D378
UPDATE A
,
table_name_1
ELSE BA
(
VALUES ;
SET
B
UPD
column_name=expression
WHERE condition
INSERT table_name_2
INS INTO
)expression
( )column_name
,
( )expressionVALUES
DEFAULT VALUES
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 33
Chapter 9: SQL Data Manipulation Language Statement SyntaxUSING Row Descriptor
USING Row Descriptor
1101E201
USING
,
(host_variable_name data_type_declaration )
;SQL_request
data_type_attribute
A
A
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 34
Chapter 9: SQL Data Manipulation Language Statement SyntaxWAIT
WAIT
WAIT
JR01A008
async_statement_identifier COMPLETIONALL
,
ANY COMPLETION INTO
:
stmtvar
:
sessvar,
Teradata RDBMS SQL/Data Dictionary Quick Reference 9 – 35
Chapter 9: SQL Data Manipulation Language Statement SyntaxWHENEVER
WHENEVER
WHENEVER
GW01R035
actioncondition
Teradata RDBMS SQL/Data Dictionary Quick Reference9 – 36
Chapter 10:
SQL Stored Procedures
Teradata RDBMS SQL/Data Dictionary Quick Reference 10 – 1
Chapter 10: SQL Stored ProceduresBEGIN - END Statement
BEGIN - END Statement
A
label_name : local_declaration
BEGIN
cursor_declaration
YS6BE001
A ;
condition_handler statement
END
label_name
Teradata RDBMS SQL/Data Dictionary Quick Reference10 – 2
Chapter 10: SQL Stored ProceduresCASE
CASE
Syntax 1
Syntax 2
CASE operand_1 AWHEN operand_2 THEN statement
YSCase01
A
ELSE
;
statement
END CASE
CASE AWHEN conditional_expression THEN statement
YSCase02
A
ELSE
;
statement
END CASE
Teradata RDBMS SQL/Data Dictionary Quick Reference 10 – 3
Chapter 10: SQL Stored ProceduresDECLARE
DECLARE
YS6DE001
;DECLARE variable_name
,
DEFAULT
data_type
literal
NULL
attribute
Teradata RDBMS SQL/Data Dictionary Quick Reference10 – 4
Chapter 10: SQL Stored ProceduresDECLARE HANDLER
DECLARE HANDLER
YS6DH001
DECLARE HANDLER
EXIT
CONTINUE AFOR
A ;handler_action_statementSQLSTATE
VALUE
sqlstate_code
SQLEXCEPTION
SQLWARNING
NOT FOUND
,
,
Teradata RDBMS SQL/Data Dictionary Quick Reference 10 – 5
Chapter 10: SQL Stored ProceduresFOR
FOR
YS6FOR01
AFOR for_loop_variable AS
DO statement END FORcursor_specification
CURSOR FORcursor_namelabel_name :
label_nameA ;
Teradata RDBMS SQL/Data Dictionary Quick Reference10 – 6
Chapter 10: SQL Stored ProceduresIF
IF
IF conditional_expression THEN statement A
A
ELSEIF conditional_expression THEN statement
B
B
ELSE statement
END IF
YS6IF001
;
Teradata RDBMS SQL/Data Dictionary Quick Reference 10 – 7
Chapter 10: SQL Stored ProceduresITERATE
ITERATE
ITERATE label_name ;
YS6ITER01
Teradata RDBMS SQL/Data Dictionary Quick Reference10 – 8
Chapter 10: SQL Stored ProceduresLEAVE
LEAVE
label_nameLEAVE ;
YS6LEA01
Teradata RDBMS SQL/Data Dictionary Quick Reference 10 – 9
Chapter 10: SQL Stored ProceduresLOOP
LOOP
LOOP statement END LOOP
label_name : label_name
;
YS6LOOP1
Teradata RDBMS SQL/Data Dictionary Quick Reference10 – 10
Chapter 10: SQL Stored ProceduresREPEAT
REPEAT
YS6RPT01
REPEAT UNTILstatement
label_name :
A
conditional_expression ;END REPEAT
label_name
A
Teradata RDBMS SQL/Data Dictionary Quick Reference 10 – 11
Chapter 10: SQL Stored ProceduresSET
SET
YS6SET01
SET assignment_target = assignment_source ;
Teradata RDBMS SQL/Data Dictionary Quick Reference10 – 12
Chapter 10: SQL Stored ProceduresWHILE
WHILE
YS6WHI01
WHILE conditional_expression DO
statement END WHILE
label_name :
A
A
label_name
;
Teradata RDBMS SQL/Data Dictionary Quick Reference 10 – 13
Chapter 10: SQL Stored ProceduresWHILE
Teradata RDBMS SQL/Data Dictionary Quick Reference10 – 14
Chapter 11:
Cursors and Cursor Control Statements
Teradata RDBMS SQL/Data Dictionary Quick Reference 11 – 1
Chapter 11: Cursors and Cursor Control StatementsCLOSE
CLOSE
CLOSE
GW01A003
cursor_name
Teradata RDBMS SQL/Data Dictionary Quick Reference11 – 2
Chapter 11: Cursors and Cursor Control StatementsDECLARE CURSOR
DECLARE CURSOR
Dynamic SQL Form
Macro Form
Request Form
Selection Form
DECLARE
GW01A012
cursor_name CURSOR FOR statement_name
DECLARE
GW01A011
cursor_name CURSOR FOR EXEC
dbname.
macroname
( parameter_list )
A
A
DECLARE
GW01A010
cursor_name CURSOR FOR 'request_specification'
GW01C009
DECLARE cursor_name CURSOR FOR
COMMENT
A
A
EXPLAIN
HELP
SHOW
SELECT
Teradata RDBMS SQL/Data Dictionary Quick Reference 11 – 3
Chapter 11: Cursors and Cursor Control StatementsDECLARE CURSOR
Stored Procedures Form
1101A072
DECLARE
FOR
CURSOR FOR cursor_specification
NO SCROLL
SCROLL
cursor_name
;
A
A
READ ONLY
UPDATE
Teradata RDBMS SQL/Data Dictionary Quick Reference11 – 4
Chapter 11: Cursors and Cursor Control StatementsFETCH
FETCH
Embedded SQL Form
Stored Procedures Form
FETCH
GW01A019
cursor_name A
A
INTO host_variable_name
:host_indicator_name:
INDICATOR
,
USING DESCRIPTOR descriptor_area
:
1101A074
FETCH
,
local_variable_name
parameter_reference
FROM
INTO
NEXT
FIRST
cursor_name
;
A
A
Teradata RDBMS SQL/Data Dictionary Quick Reference 11 – 5
Chapter 11: Cursors and Cursor Control StatementsOPEN
OPEN
Embedded SQL Form
Stored Procedures Form
OPEN
GW01A027
cursor_name A
A
USING host_variable_name
:host_indicator_name:
INDICATOR
,
USING DESCRIPTOR descriptor_area
:
1101A073
OPEN cursor_name ;
Teradata RDBMS SQL/Data Dictionary Quick Reference11 – 6
Chapter 11: Cursors and Cursor Control StatementsPOSITION
POSITION
POSITION
GW01A028
cursor_name
TO NEXT
TO
STATEMENT
statement_number
numvar
:
Teradata RDBMS SQL/Data Dictionary Quick Reference 11 – 7
Chapter 11: Cursors and Cursor Control StatementsREWIND
REWIND
REWIND
GW01A030
cursor_name
Teradata RDBMS SQL/Data Dictionary Quick Reference11 – 8
Chapter 12:
Data Dictionary Views
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 1
Chapter 12: Data Dictionary ViewsView Definitions
View Definitions
Views shown with an [X] suffix have two modes.
• Without the X (for example, DBC.AccountInfo), they display global information.
• With the X (for example, DBC.AccountInfoX), they display information associated with the requesting user only.
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 2
Chapter 12: Data Dictionary ViewsView Definitions
DBC.AccessLog
User Type Columns Selected
Security Administrator LogDate
LogTime
LogonDate
LogonTime
LogicalHostId
IFPNo
SessionNo
UserName
AccountName
OwnerName
AccessType
Frequency
EventCount
Result
DatabaseName
TVMName
ColumnName
StatementType
StatementText
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 3
Chapter 12: Data Dictionary ViewsView Definitions
DBC.AccLogRules
User Type Columns Selected
Security Administrator UserName
DatabaseName
TVMName
AcrAlterFunction
AcrCheckpoint
AcrCreateDatabase
AcrCreateFunction
AcrCreateMacro
AcrCreateProcedure
AcrCreateTable
AcrCreateUser
AcrCreateView
AcrDelete
AcrDropDatabase
AcrDropFunction
AcrDropMacro
AcrDropProcedure
AcrDropTable
AcrDropUser
AcrDropView
AcrDump
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 4
Chapter 12: Data Dictionary ViewsView Definitions
DBC.AccLogRules (continued)
User Type Columns Selected
Security Administrator AcrExecute
AcrExecuteFunction
AcrExecuteProcedure
AcrGrant
AcrIndex
AcrInsert
AcrReference
AcrRestore
AcrSelect
AcrUpdate
ArcCreateTrigger
ArcDropTrigger
AcrCreateRole
AcrDropRole
AcrCreateProfile
AcrDropProfile
AcrAlterProcedure
CreatorName
CreateTimeStamp
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 5
Chapter 12: Data Dictionary ViewsView Definitions
DBC.AccountInfo[X]
DBC.AllRights
User Type Columns Selected
Supervisory
[X]End
Administrator
Name
UserOrProfile
AccountName
User Type Columns Selected
Administrator UserName
DatabaseName
TableName
ColumnName
AccessRight
GrantAuthority
GrantorName
AllnessFlag
CreatorName
CreateTimeStamp
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 6
Chapter 12: Data Dictionary ViewsView Definitions
DBC.AllRoleRights
User Type Columns Selected
Security Administrator
Supervisory
Administrator
UserName
DatabaseName
TableName
ColumnName
AccessRight
GrantAuthority
GrantorName
CreateTimeStamp
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 7
Chapter 12: Data Dictionary ViewsView Definitions
DBC.AllSpace[X]
DBC.AllTempTables[X]
User Type Columns Selected
Administrator
[X]End
Vproc
DatabaseName
AccountName
TableName
MaxPerm
MaxSpool
MaxTemp
CurrentPerm
CurrentSpool
CurrentTemp
PeakPerm
PeakSpool
PeakTemp
User Type Columns Selected
Administrator
[X]End
HostNo
SessionNo
UserName
B_DatabaseName
B_TableName
E_TableId
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 8
Chapter 12: Data Dictionary ViewsView Definitions
DBC.All_RI_Children
User Type Columns Selected
All users IndexID
IndexName
ChildDB
ChildTable
ChildKeyColumn
ParentDB
ParentTable
ParentKeyColumn
InconsistencyFlag
CreatorName
CreateTimeStamp
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 9
Chapter 12: Data Dictionary ViewsView Definitions
DBC.All_RI_Parents
DBC.AMPUsage
User Type Columns Selected
All users IndexID
IndexName
ParentDB
ParentTable
ParentKeyColumn
ChildDB
ChildTable
ChildKeyColumn
InconsistencyFlag
CreatorName
CreateTimeStamp
User Type Columns Selected
Administrator AccountName
UserName
CPUTime
Vproc
VprocType
Model
DiskIO
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 10
Chapter 12: Data Dictionary ViewsView Definitions
DBC.Association
DBC.CharSets
User Type Columns Selected
Operations Control DatabaseName
TableName
EventNum
Original_DataBaseName
Original_TableName
Original_TableKind
Original_Version
Original_ProtectionType
Original_JournalFlag
Original_CreatorName
Original_CommentString
User Type Columns Selected
End CharSetName
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 11
Chapter 12: Data Dictionary ViewsView Definitions
DBC.CharTranslations
DBC.Children[X]
DBC.Collations
User Type Columns Selected
End CharSetName
CharSetId
InstallFlag
E2I
E2IUp
I2E
I2EUp
User Type Columns Selected
Administrator Child
Parent
User Type Columns Selected
End
Administrator
CollName
CollInstall
CollEqvClass
CollOrderCS
CollOrderUC
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 12
Chapter 12: Data Dictionary ViewsView Definitions
DBC.Columns[X]
User Type Columns Selected
[X]End
Administrator
DatabaseName
TableName
ColumnName
ColumnFormat
ColumnTitle
SPParameterType
ColumnType
ColumnLegth
DefaultValue
Nullable
CommentString
DecimalTotalDigits
DecimalFractionalDigits
ColumnId
UpperCaseFlag
Compressible
CompressValue
ColumnConstraint
ConstraintCount
CreatorName
CreateTimeStamp
LastAlterName
LastAlterTimeStamp
CharType
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 13
Chapter 12: Data Dictionary ViewsView Definitions
DBC.Columns[X] (continued)
DBC.ColumnStats
User Type Columns Selected
[X]End
Administrator
NOTE:
** This field is not used.
IdColType
CompressValueList
AccessCount**
LastAccessTimeStamp**
User Type Columns Selected
Tools DatabaseNameI
FieldID
FieldFormat
FieldName
FieldStatistics
FieldType
ImpliedPoint
MaxLength
TotalDigits
TVMNameI
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 14
Chapter 12: Data Dictionary ViewsView Definitions
DBC.Databases[X]
DBC.Databases2
User Type Columns Selected
[X]End
Administrator
NOTE:
**This field is not used.
DatabaseName
CreatorName
OwnerName
AccountName
ProtectionType
JournalFlag
PermSpace
SpoolSpace
TempSpace
CommentString
CreateTimeStamp
LastAlterName
LastAlterTimeStamp
DBKind
AccessCount**
LastAccessTimeStamp**
User Type Columns Selected
All users DatabaseName
DatabaseId
UnResolvedRICount
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 15
Chapter 12: Data Dictionary ViewsView Definitions
DBC.Database_Default_Journals[X]
DBC.DBCInfo
User Type Columns Selected
[X]End
Administrator
DatabaseName
Journal_DB
JournalName
User Type Columns Selected
All users InfoKey
InfoData
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 16
Chapter 12: Data Dictionary ViewsView Definitions
DBC.DBQLRules
DBC.DeleteAccessLog[X]
User Type Columns Selected
Administrator
Supervisory
UserName
AccountString
ExplainFlag
ObjFlag
SqlFlag
StepFlag
SummaryFlag
ThresholdFlag
TextSizeLimit
SummaryVal1
SummaryVal2
SummaryVal3
ThreshValue
User Type Columns Selected
Security
Administrator
LogDate
LogTime
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 17
Chapter 12: Data Dictionary ViewsView Definitions
DBC.DeleteOldInDoubt
User Type Columns Selected
Administrator LogicalHostId
CoordTaskId
LogonUserName
CommitOrRollback
CompletionDate
UserLogonTime
SessionNumber
RunUnitId
ResolvingUserLogonName
UserLogonDate
CompletionTime
Options
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 18
Chapter 12: Data Dictionary ViewsView Definitions
DBC.DiskSpace[X]
User Type Columns Selected
Administrator
[X]End
Supervisory
Vproc
DatabaseName
AccountName
MaxPerm
MaxSpool
MaxTemp
CurrentPerm
CurrentSpool
CurrentTemp
PeakPerm
PeakSpool
PeakTemp
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 19
Chapter 12: Data Dictionary ViewsView Definitions
DBC.Events[X]
User Type Columns Selected
Operations Control CreateDate
CreateTime
EventNum
EventType
UserName
DatabaseName
ObjectType
AllAMPsFlag
RestartSeqNum
OperationInProcess
TableName
CheckpointName
LinkingEventNum
DataSetName
LockMode
JournalUsed
JournalSaved
IndexPresent
DupeDumpSet
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 20
Chapter 12: Data Dictionary ViewsView Definitions
DBC.Events_Configuration[X]
DBC.Events_Media[X]
User Type Columns Selected
Operations Control Vproc
CreateDate
CreateTime
EventNum
EventType
UserName
LogProcessor
PhyProcessor
ProcessorState
RestartSeqNum
User Type Columns Selected
Operations Control CreateDate
CreateTime
EventNum
EventType
UserName
DataSetName
VolSerialId
VolSequenceNum
DupeDumpSet
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 21
Chapter 12: Data Dictionary ViewsView Definitions
DBC.Functions
User Type Columns Selected
Administrator DatabaseName
FunctionName
SpecificName
FunctionId
NumParameters
ParameterDataTypes
FunctionType
ExternalName
SrcFileLanguage
NoSQLDataAccess
ParameterStyle
DeterministicOpt
NullCall
PrepareCount
ExecProtectionMode
ExtFileReference
CharacterType
Platform
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 22
Chapter 12: Data Dictionary ViewsView Definitions
DBC.Hardware_Event_Log
User Type Columns Selected
Operations Control TheDate
TheTime
Event_Tag
Category
Severity
Primary_Part_Number
Revision_Level
Secondary_Part_Number
Serial_Number
PMA
Module_Type
Slot
Slot_Type
SubSlot
SubSlot_Type
FW_Version
Vcc_Margin
Frequency_Margin
Vcc_Volts
Vcc_Amps
Temperature
Line
Text
Error_Data
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 23
Chapter 12: Data Dictionary ViewsView Definitions
DBC.HostsInfo
DBC.IndexConstraints
User Type Columns Selected
End
Administrator
LogicalHostId
HostName
DefaultCharSet
User Type Columns Selected
End
Administrator
DatabaseName
TableName
IndexName
IndexNumber
ConstraintType
ConstraintText
ConstraintCollation
CollationName
CreatorName
CreateTimestamp
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 24
Chapter 12: Data Dictionary ViewsView Definitions
DBC.IndexStats
User Type Columns Selected
Tools DatabaseNameI
FieldFormat
FieldName
FieldPosition
FieldType
ImpliedPoint
IndexNumber
IndexType
IndexStatistics
MaxLength
Name
TotalDigits
TVMNameI
UniqueFlag
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 25
Chapter 12: Data Dictionary ViewsView Definitions
DBC.Indices[X]
User Type Columns Selected
Supervisory
[X]End
Administrator
NOTE:
**This field is not used.
DatabaseName
TableName
IndexNumber
IndexType
UniqueFlag
IndexName
ColumnName
ColumnPosition
CreatorName
CreateTimeStamp
LastAlterName
LastAlterTimeStamp
IndexMode
AccessCount**
LastAccessTimeStamp**
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 26
Chapter 12: Data Dictionary ViewsView Definitions
DBC.InDoubtLog
DBC.Journals[X]
User Type Columns Selected
Administrator LogicalHostId
CoordTaskId
LogonUserName
UserLogonDate
CompletionDate
CommitOrRollBack
SessionNumber
RunUnitId
ResolvingUserLogonName
UserLogonTime
CompletionTime
Options
User Type Columns Selected
[X]End
Administrator
Tables_DB
TableName
Journals_DB
JournalName
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 27
Chapter 12: Data Dictionary ViewsView Definitions
DBC.LogOnOff
DBC.LogonRules
User Type Columns Selected
Security Administrator
Administrator
Supervisory
LogDate
LogTime
UserName
AccountName
Event
LogicalHostId
IFPNo
SessionNo
LogonDate
LogonTime
LogonSource
User Type Columns Selected
Administrator UserName
LogicalHostId
LogonStatus
NullPassword
CreatorName
CreateTimeStamp
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 28
Chapter 12: Data Dictionary ViewsView Definitions
DBC.ProfileInfo[X]
User Type Columns Selected
[X]End
Supervisory
Security Administrator
Administrator
ProfileName
DefaultAccount
DefaultDB
SpoolSpace
TempSpace
ExpirePassword
PasswordMinChar
PassordMaxChar
PasswordDigits
PasswordSpecChar
MaxLogonAttempts
LockedUserExpire
PasswordReuse
CommentString
CreatorName
CreateTimeStamp
LastAlterName
LastAlterTimeStamp
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 29
Chapter 12: Data Dictionary ViewsView Definitions
DBC.QryLog
User Type Columns Selected
Administrator
NOTE:
**This field is not used.
ProcID
CollectTimeStamp
QueryID
UserID
AcctString
ExpandAccString
SessionID
LogicalHostID
RequestNum
LogonDateTime
AccStringTime
AccStringHour
AccStringDate
AppID
ClientID
QueryBrand**
ProfileID
StartTime
FirstStepTime
FirstRespTime
LastRespTime
NumSteps
NumStepswPar
MaxStepsInPar
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 30
Chapter 12: Data Dictionary ViewsView Definitions
DBC.QryLog (continued)
User Type Columns Selected
Administrator
NOTE:
**This field is not used.
NumResultRows**
ResultRowSize**
TotalIOcount**
TotalCPUTime**
ErrorCode
ErrorText
TDQMFlag
AbortFlag
CacheFlag
QueryText
HotAmp1CPU**
HotAmp2CPU**
HotAmp3CPU**
LowAmp1CPU**
LowAmp2CPU**
LowAmp3CPU**
AvgAmpCPUSec**
HotAmp1IO**
HotAmp2IO**
HotAmp3IO**
LowAmp1IO**
LowAmp2IO**
LowAmp3IO**
AvgAmpIOCnt**
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 31
Chapter 12: Data Dictionary ViewsView Definitions
DBC.QryLog (continued)
DBC.QryLogExplain
User Type Columns Selected
Administrator
NOTE:
**This field is not used.
SpoolUsage**
ExtraField1**
ExtraField2**
ExtraField3**
ExtraField4**
ExtraField5**
User Type Columns Selected
Administrator ProcID
CollectTimeStamp
Query ID
ExpRowNo
ExplainText
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 32
Chapter 12: Data Dictionary ViewsView Definitions
DBC.QryLogObjects
DBC.QryLogSQL
User Type Columns Selected
Administrator ProcID
CollectTimeStamp
QueryID
ObjectDatabaseName
ObjectTableName
ObjectColumnName
ObjectID
ObjectNum
ObjectType
FreqofUse
User Type Columns Selected
Administrator ProcID
CollectTimeStamp
Query ID
SqlRowNo
SqlTextInfo
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 33
Chapter 12: Data Dictionary ViewsView Definitions
DBC.QryLogSteps
User Type Columns Selected
Administrator
NOTE:
**This field is not used.
ProdIDCollectTimestampQueryIDStepLev1NumStepLev2NumStepNameStepStartDateStepStopDateCPUtime **IOcount **RowCount **HotAmp1CPU **HotAmp2CPU **HotAmp3CPU **LowAmp1CPU **LowAmp2CPU **LowAmp3CPU **AvgAmpCPUSec **HotAmp1IO **HotAmp2IO **HotAmp3IO **LowAmp1IO **LowAmp2IO **LowAmp3IO **AvgAmpIOCnt **ExtraField1ExtraField2ExtraField3ExtraField4
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 34
Chapter 12: Data Dictionary ViewsView Definitions
DBC.QryLogSummary
DBC.RCC_Configuration[X]
DBC.RCC_Media[X]
User Type Columns Selected
Administrator ProcID
CollectTimeStamp
SessionID
QueryCount
QuerySeconds
LowHist
HighHist
User Type Columns Selected
Operations Control EventNum
LogProcessor
PhyProcessor
ProcessorState
RestartSeqNum
Vproc
User Type Columns Selected
Operations Control EventNum
VolSerialId
VolSequenceNum
DupeDumpSet
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 35
Chapter 12: Data Dictionary ViewsView Definitions
DBC.RI_Child_Tables
DBC.RI_Distinct_Children
User Type Columns Selected
All users IndexID
IndexName
ChildDbID
ChildTID
ChildKeyFID
ParentDbID
ParentTID
ParentKeyFID
InconsistencyFlag
CreatorName
CreateTimeStamp
User Type Columns Selected
All users IndexID
IndexName
ChildDB
ChildTable
ParentDB
ParentTable
InconsistencyFlag
CreatorName
CreateTimeStamp
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 36
Chapter 12: Data Dictionary ViewsView Definitions
DBC.RI_Distinct_Parents
DBC.RI_Parent_Tables
User Type Columns Selected
All users IndexID
IndexName
ParentDB
ParentTable
ChildDB
ChildTable
InconsistencyFlag
CreatorName
CreateTimeStamp
User Type Columns Selected
All users IndexID
IndexName
ParentDbID
ParentTID
ParentKeyFID
ChildDbID
ChildTID
ChildKeyFID
InconsistencyFlag
CreatorName
CreateTimeStamp
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 37
Chapter 12: Data Dictionary ViewsView Definitions
DBC.RoleInfo[X]
DBC.RoleMembers[X]
User Type Columns Selected
Security Administrator
[X]End
RoleName
CreatorName
CommentString
CreateTimeStamp
User Type Columns Selected
Security Administrator
[X]End
RoleName
Grantee
GranteeKind
Grantor
WhenGranted
DefaultRole
WithAdmin
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 38
Chapter 12: Data Dictionary ViewsView Definitions
DBC.SecurityDefaults
DBC.SecurityLog[X]
User Type Columns Selected
Security Administrator ExpirePassword
PasswordMinChar
PasswordMaxChar
PasswordDigits
PasswordSpecChar
MaxLogonAttempts
LockedUserExpire
PasswordReuse
User Type Columns Selected
Security Administrator LogDate
LogTime
LogType
UserName
AccountName
DatabaseName
TableName
Text
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 39
Chapter 12: Data Dictionary ViewsView Definitions
DBC.SessionInfo[X]
User Type Columns Selected
Administrator
Security Administrator
Supervisory
[X]End
UserName
AccountName
SessionNo
DefaultDataBase
IFPNo
Partition
LogicalHostId
HostNo
CurrentCollation
LogonDate
LogonTime
LogonSequenceNo
LogonSource
ExpiredPassword
TwoPCMode
Transaction_Mode
CurrentRole
LogonAcct
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 40
Chapter 12: Data Dictionary ViewsView Definitions
DBC.ShowColChecks
DBC.ShowTblChecks
User Type Columns Selected
End
Administrator
DatabaseName
TableName
ColumnName
ColCheck
CreatorName
CreateTimeStamp
User Type Columns Selected
End
Administrator
DatabaseName
TableName
CheckName
TblCheck
CreatorName
CreateTimeStamp
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 41
Chapter 12: Data Dictionary ViewsView Definitions
DBC.Software_Event_Log
User Type Columns Selected
Operations Control TheDate
TheTime
Event_Tag
Category
Severity
PMA
Vproc
Partition
Task
TheFunction
SW_Version
Line
Text
StackTrace
Error_Data
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 42
Chapter 12: Data Dictionary ViewsView Definitions
DBC.Table_LevelConstraints
User Type Columns Selected
All users DatabaseName
TableName
ConstraintName
ConstraintText
CreatorName
CreateTimeStamp
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 43
Chapter 12: Data Dictionary ViewsView Definitions
DBC.Tables[X]
User Type Columns Selected
[X]End
Administrator
NOTE:
This field is not used.
DatabaseName
TableName
Version
TableKind
ProtectionType
JournalFlag
CreatorName
RequestText
CommentString
ParentCount
ChildCount
NamedTblCheckCount
UnnamedTblCheckExist
PrimaryKeyIndexId
CreateTimeStamp
LastAlterName
LastAlterTimeStamp
RequestTxtOverFlow
AccessCount**
LastAccessTimeStamp**
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 44
Chapter 12: Data Dictionary ViewsView Definitions
DBC.Tables2
DBC.TableSize[X]
DBC.TableText
User Type Columns Selected
Administrator
Supervisory
TVMName
TVMId
DatabaseId
ParentCount
ChildCount
User Type Columns Selected
Administrator
[X]End
Vproc
DatabaseName
AccountName
TableName
CurrentPerm
PeakPerm
User Type Columns Selected
Administrator
[X]End
DatabaseName
TableName
TableKind
RequestText
LineNo
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 45
Chapter 12: Data Dictionary ViewsView Definitions
DBC.Triggers
User Type Columns Selected
Administrator DatabaseName
TableName
TriggerName
EnabledFlag
ActionTime
Event
Kind
OrderNumber
TriggerComment
RequestText
CreatorName
CreateTimeStamp
LastAlterName
LastAlterTimeStamp
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 46
Chapter 12: Data Dictionary ViewsView Definitions
DBC.UserGrantedRights
DBC.UserRights
User Type Columns Selected
End DatabaseName
TableName
ColumnName
Grantee
GrantAuthority
AccessRight
AllnessFlag
CreatorName
CreateTimeStamp
User Type Columns Selected
End DatabaseName
TableName
ColumnName
AccessRight
GrantAuthority
GrantorName
CreatorName
CreateTimeStamp
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 47
Chapter 12: Data Dictionary ViewsView Definitions
DBC.UserRoleRights
User Type Columns Selected
End RoleName
DatabaseName
TableName
ColumnName
AccessRight
GrantorName
CreateTimeStamp
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 48
Chapter 12: Data Dictionary ViewsView Definitions
DBC.Users
User Type Columns Selected
Supervisory
End
Administrator
UserName
CreatorName
PasswordLastModDate
PasswordLastModTime
OwnerName
PermSpace
SpoolSpace
TempSpace
ProtectionType
JournalFlag
StartupString
DefaultAccount
DefaultDataBase
CommentString
DefaultCollation
PasswordChgDate
LockedDate
LockedTime
LockedCount
TimeZoneHour
TimeZoneMinute
DefaultDateForm
CreateTimeStamp
LastAlterTime
LastAlterTimeStamp
DefaultCharType
Teradata RDBMS SQL/Data Dictionary Quick Reference 12 – 49
Chapter 12: Data Dictionary ViewsView Definitions
DBC.Users (continued)
DBC.User_Default_Journals[X]
User Type Columns Selected
RoleName
ProfileName
User Type Columns Selected
[X]End
Administrator
UserName
Journal_DB
JournalName
Teradata RDBMS SQL/Data Dictionary Quick Reference12 – 50
Appendix A:
How to Read Syntax Diagrams
This appendix describes the conventions that apply to reading the syntax diagrams used in this book.
Teradata RDBMS SQL/Data Dictionary Quick Reference A – 1
Appendix A: How to Read Syntax DiagramsSyntax Diagram Conventions
Syntax Diagram Conventions
Notation Conventions
The following table defines the notation used in this quick reference:
Item Definition / Comments
Letter An uppercase or lowercase alphabetic character ranging from A through Z.
Number A digit ranging from 0 through 9.
Do not use commas when entering a number with more than three digits.
Word Variables and reserved words.
IF a word is shown in . . . THEN it represents . . .
UPPERCASE LETTERS
a keyword.
Syntax diagrams show all keywords in uppercase, unless operating system restrictions require them to be in lowercase.
If a keyword is shown in uppercase, you may enter it in uppercase or mixed case.
lowercase italic letters a variable such as a column or table name.
You must substitute a proper value.
lowercase bold letters a variable that is defined immediately following the diagram that contains it.
Teradata RDBMS SQL/Data Dictionary Quick ReferenceA – 2
Appendix A: How to Read Syntax DiagramsSyntax Diagram Conventions
Paths
The main path along the syntax diagram begins at the left, and proceeds, left to right, to the vertical bar, which marks the end of the diagram. Paths that do not have an arrow or a vertical bar only show portions of the syntax.
The only part of a path that reads from right to left is a loop.
Paths that are too long for one line use continuation links. Continuation links are small circles with letters indicating the beginning and end of a link:
IF a word is shown in . . . THEN it represents . . .
lowercase letters a keyword that you must enter in lowercase, such as a UNIX command.
UNDERLINED LETTERS
the default value.
This applies both to uppercase and to lowercase words.
Spaces Use one space between items, such as keywords or variables.
Punctu-ation
Enter all punctuation exactly as it appears in the diagram.
Item Definition / Comments
FE0CA002
A
A
Teradata RDBMS SQL/Data Dictionary Quick Reference A – 3
Appendix A: How to Read Syntax DiagramsSyntax Diagram Conventions
When you see a circled letter in a syntax diagram, go to the corresponding circled letter and continue.
Required Items
Required items appear on the main path:
If you can choose from more than one item, the choices appear vertically, in a stack. The first item appears on the main path:
Optional Items
Optional items appear below the main path:
If choosing one of the items is optional, all the choices appear below the main path:
You can choose one of the options, or you can disregard all of the options.
FE0CA003
SHOW
FE0CA005
SHOW
VERSIONS
CONTROLS
FE0CA004
SHOW
CONTROLS
FE0CA006
SHOW
CONTROLS
VERSIONS
Teradata RDBMS SQL/Data Dictionary Quick ReferenceA – 4
Appendix A: How to Read Syntax DiagramsSyntax Diagram Conventions
Abbreviations
If a keyword or a reserved word has a valid abbreviation, the unabbreviated form always appears on the main path. The shortest valid abbreviation appears beneath.
In the above syntax, the following formats are valid:
• SHOW CONTROL• SHOW CONTROLS
Loops
A loop is an entry or a group of entries that you can repeat one or more times. Syntax diagrams show loops as a return path above the main path, over the item or items that you can repeat.
The following rules apply to loops:
IF... THEN...
there is a maximum number of entries allowed
the number appears in a circle on the return path.
In the example, you may enter cname a maximum of 4 times.
there is a minimum number of entries required
the number appears in a square on the return path.
In the example, you must enter at least 3 groups of column names.
FE0CA042
SHOW
CONTROL
CONTROLS
JC01B012
(
, 4
cname )
, 3
Teradata RDBMS SQL/Data Dictionary Quick Reference A – 5
Appendix A: How to Read Syntax DiagramsSyntax Diagram Conventions
Excerpts
Sometimes a piece of a syntax phrase is too large to fit into the diagram. Such a phrase is indicated by a break in the path, marked by | terminators on either side of the break. A name for the excerpted piece appears between the break marks in boldface type.
The named phrase appears immediately after the complete diagram, as illustrated by the following example.
a separator character is required between entries
the character appears on the return path.
If the diagram does not show a separator character, use one blank space.
In the example, the separator character is a comma.
a delimiter character is required around entries
the beginning and end characters appear outside the return path.
Generally, a space is not needed between delimiter characters and entries.
In the example, the delimiter characters are the left and right parentheses.
IF... THEN...
LOCKING excerpt
where_cond
A
cname
excerpt
JC01A014
A
HAVING con
,
col_pos
,
Teradata RDBMS SQL/Data Dictionary Quick ReferenceA – 6
Appendix B:
Restricted Words for V2R5.0
Release V2R5.0 restricts the use of certain terminology in SQL queries and in other user application programs that interface with the Teradata RDBMS.
Certain words cannot be used as object names, such as database, table, column, index, or stored procedure names, because Teradata RDBMS already uses the words and might misinterpret them. Other words are permitted as object names, but discouraged because of possible confusion that might result.
Reserved and Keywords for V2R5.0
For a complete list of Teradata RDBMS V2R5.0 reserved words, non-reserved words, words reserved for future use, and SQL-99 reserved and non-reserved keywords, see Appendix A: “Restricted Words for V2R5.0” in Teradata RDBMS Release Summary.
Reserved Words Script
Before upgrading from your current release of Teradata RDBMS to Release V2R5.0, run:
V2R5.0 Reserved Words Script
This script reports the names of existing data objects that conflict with Teradata RDBMS reserved words, including those newly created for the current release. Customers are
Teradata RDBMS SQL/Data Dictionary Quick Reference B – 1
Appendix B: Restricted Words for V2R5.0
advised to either rename or use double quotes around any conflicting object names.
Notes:
• This script does not check for table name aliases or embedded SQL statements.
• The script only checks for Teradata RDBMS reserved keywords and future reserved words. You must search manually for SQL-99 keywords and Teradata non-reserved keywords. For an explanation of the various classes of restricted words, see Appendix A: “Restricted Words for V2R5.0” in Teradata RDBMS Release Summary.
Running the Script
To get the latest list of Reserved Words and Keywords, and the Reserved Words Script to check out your system, follow these steps:
Step Action
1 Go to http://www.info.ncr.com
2 Click Teradata Data Warehousing >Teradata Database >V2R5.0.0.
3 Click V2R5.0 Reserved Words Script (B035-1952-122K).The script opens in another browser window.
Teradata RDBMS SQL/Data Dictionary Quick ReferenceB – 2
Appendix B: Restricted Words for V2R5.0
4 Copy and paste the script text into your own ASCII Text editor, and save this file on your local disk drive as a .bteq file.
Note: Be sure to use an ASCII Text editor that does not add any control characters or extra carriage returns. Wordpad does not work for this purpose. Notepad and Editpad are good editors. If you use Notepad, be sure to keep the extension of the file as .bteq and not as a .txt file.
5 Run the file on your system as a BTEQ script.
Step Action
Teradata RDBMS SQL/Data Dictionary Quick Reference B – 3
Appendix B: Restricted Words for V2R5.0
Teradata RDBMS SQL/Data Dictionary Quick ReferenceB – 4