Data Dictionary - Teradata Documentation

Teradata Database
Data Dictionary
Release 13.10
B035-1092-109A
December 2012
The product or products described in this book are licensed products of Teradata Corporation or its affiliates.
Teradata, Active Enterprise Intelligence, Applications-Within, Aprimo, Aprimo Marketing Studio, Aster, BYNET, Claraview, DecisionCast, Gridscale,
MyCommerce, Raising Intelligence, Smarter. Faster. Wins., SQL-MapReduce, Teradata Decision Experts, "Teradata Labs" logo, "Teradata Raising
Intelligence" logo, Teradata ServiceConnect, Teradata Source Experts, "Teradata The Best Decision Possible" logo, The Best Decision Possible,
WebAnalyst, and Xkoto are trademarks or registered trademarks of Teradata Corporation or its affiliates in the United States and other countries.
Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc.
AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc.
Apache, Apache Hadoop, Hadoop, and the yellow elephant logo are either registered trademarks or trademarks of the Apache Software Foundation
in the United States and/or other countries.
Axeda is a registered trademark of Axeda Corporation. Axeda Agents, Axeda Applications, Axeda Policy Manager, Axeda Enterprise, Axeda Access,
Axeda Software Management, Axeda Service, Axeda ServiceLink, and Firewall-Friendly are trademarks and Maximum Results and Maximum
Support are servicemarks of Axeda Corporation.
Data Domain, EMC, PowerPath, SRDF, and Symmetrix are registered trademarks of EMC Corporation.
GoldenGate is a trademark of Oracle.
Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company.
Hortonworks, the Hortonworks logo and other Hortonworks trademarks are trademarks of Hortonworks Inc. in the United States and other
countries.
Intel, Pentium, and XEON are registered trademarks of Intel Corporation.
IBM, CICS, RACF, Tivoli, and z/OS are registered trademarks of International Business Machines Corporation.
Linux is a registered trademark of Linus Torvalds.
LSI is a registered trademark of LSI Corporation.
Microsoft, Active Directory, Windows, Windows NT, and Windows Server are registered trademarks of Microsoft Corporation in the United States
and other countries.
NetVault is a trademark or registered trademark of Quest Software, Inc. in the United States and/or other countries.
Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries.
Oracle, Java, and Solaris are registered trademarks of Oracle and/or its affiliates.
QLogic and SANbox are trademarks or registered trademarks of QLogic Corporation.
Red Hat is a trademark of Red Hat, Inc., registered in the U.S. and other countries. Used under license.
SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc.
SPARC is a registered trademark of SPARC International, Inc.
Symantec, NetBackup, and VERITAS are trademarks or registered trademarks of Symantec Corporation or its affiliates in the United States and
other countries.
Unicode is a registered trademark of Unicode, Inc. in the United States and other countries.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Other product and company names mentioned herein may be the trademarks of their respective owners.
THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROVIDED ON AN "AS-IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR
NON-INFRINGEMENT. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION
MAY NOT APPLY TO YOU. IN NO EVENT WILL TERADATA CORPORATION BE LIABLE FOR ANY INDIRECT, DIRECT, SPECIAL, INCIDENTAL,
OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS OR LOST SAVINGS, EVEN IF EXPRESSLY ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.
The information contained in this document may contain references or cross-references to features, functions, products, or services that are not
announced or available in your country. Such references do not imply that Teradata Corporation intends to announce such features, functions,
products, or services in your country. Please consult your local Teradata Corporation representative for those features, functions, products, or
services available in your country.
Information contained in this document may contain technical inaccuracies or typographical errors. Information may be changed or updated
without notice. Teradata Corporation may also make improvements or changes in the products or services described in this information at any time
without notice.
To maintain the quality of our products and services, we would like your comments on the accuracy, clarity, organization, and value of this document.
Please email: teradata-books@lists.teradata.com.
Any comments or materials (collectively referred to as "Feedback") sent to Teradata Corporation will be deemed non-confidential. Teradata
Corporation will have no obligation of any kind with respect to Feedback and will be free to use, reproduce, disclose, exhibit, display, transform,
create derivative works of, and distribute the Feedback and derivative works thereof without limitation on a royalty-free basis. Further, Teradata
Corporation will be free to use any ideas, concepts, know-how, or techniques contained in such Feedback for any purpose whatsoever, including
developing, manufacturing, or marketing products or services incorporating Feedback.
Copyright © 2000 – 2012 by Teradata Corporation. All Rights Reserved.
Preface
Purpose
This book describes the Teradata Database Data Dictionary. It contains information about
system views that allows various types of users to access underlying table information stored
in the Teradata Database.
This includes specific information about the following:
•
Database objects
•
Sessions
•
Resource usage
Audience
This book is intended for database administrators and other technical personnel responsible
for maintaining the Teradata Database. More specifically, the manual provides information
for the following types of users:
•
End users
•
Teradata database administrators
•
Teradata database security administrators
•
Operations control users
Supported Software Releases and Operating
Systems
This book supports Teradata® Database 13.10.
Teradata Database 13.10 supports:
•
Microsoft Windows Server 2003 64-bit
•
SUSE Linux Enterprise Server 10
Teradata Database client applications can support other operating systems.
Data Dictionary
3
Preface
Prerequisites
Prerequisites
You should be familiar with relational databases in general and the Teradata Database in
particular.
It may be helpful to review the following books:
•
Introduction to Teradata
•
Database Design
•
The SQL book set
•
Database Administration
Changes to This Book
Release
Description
Teradata Database 13.10
Updated the SpoolUsage column description in the QryLogV view.
December 2012
4
Data Dictionary
Preface
Changes to This Book
Release
Description
Teradata Database 13.10
• Deleted references to Teradata Manager and Teradata Dynamic
Workload Manager / Teradata DWM
• Updated ConnectRulesTbl.TrustOnly
• Added ConnectRules[V].TrustOnly
• Updated the following columns:
• TableConstraints.CollName
• TableConstraints.SessionMode
• TableConstraints.CharSetID
• IndexConstraints.SessionMode
• IndexConstraints.CharSetID
• IndexConstraints.CollationName
• Updated UDFInfo.SrcFileLanguage
• Updated DBQLogTbl.LogicalHostID and
DBQLSummaryTbl.LogicalHostID
• Made appropriate changes from access rights to privileges
throughout the book
• Added a note to the Profiles and SysSecDefaults tables indicating
that the user password security controls affect only those passwords
authenticated by Teradata Database
• Removed VM references throughout the book
• Added the following views:
• ResolvedDTSV
• ResolvedDTSVX
• Added possible values to:
• DBQLObjTbl.TypeOfUse
• QryLogObjects.TypeOfUse
August 2010
Data Dictionary
5
Preface
Changes to This Book
Release
Description
Teradata Database 13.10
• Replaced Customer Care Link (CCL) with Teradata Vital
Infrastructure (TVI)
• Modified one of the attributes for object names to indicate that the
system for object names remains 30 UNICODE characters, and the
128 character object name limit is reserved for future expansion
only
• Updated the description for TVFields.CompressValueList
• Updated the description for SW_Event_Log
• Replaced “quotation marks” with “apostrophes (single quotation
marks)”
• Added possible value “O” to ArchiveLoggingObjsV[X].LogLevel.
• Added a note to the descriptions of the StatsTbl and QueryStatsTbl
tables that they are reserved for future use and are not currently
populated with rows.
• Changed the name of the “Profile of the User” event type to “Bad
profile” (one of the event types shown in the Event column).
• Added possible value “R” to the following:
• Columns[X].TimeDimension
• ConstraintNames.VTConstraintType
• ReferencedTbls.VTFKType
• ReferencingTbls.VTFKType
• TVFields.TimeDimension
• Added the following fields to Table_LevelConstraints[V][X]:
• VTCheckType
• TTCheckType
• ResolvedCurrent_Date
• ResolvedCurrent_TimeStamp
• Added the following fields to ShowTblChecks[V][X]:
• VTCheckType
• TTCheckType
• ResolvedCurrent_Date
• ResolvedCurrent_TimeStamp
• Added the following fields to ShowColChecks[V][X]:
• TimeDimension
• VTCheckType
• TTCheckType
• Added the following fields to RI_Parent_Tables[V][X]:
• VTPKType
• TTPKType
• VTFKType
• TTFKType
August 2010 (Continued)
6
Data Dictionary
Preface
Changes to This Book
Release
Description
Teradata Database 13.10
• Added the following fields to RI_Child_Tables[V][X]:
• VTPKType
• TTPKType
• VTFKType
• TTFKType
• Added the following fields to Triggers[V][X]:
• VTEventType
• TTEventType
• Added the following fields to Tables[V][X]:
• TemporalProperty
• ResolvedCurrent_Date
• ResolvedCurrent_Timestamp
• SystemDefinedJI
• VTQualifier
• TTQualifier
• Added the following fields to Indices[V][X]:
• UniqueOrPK
• VTConstraintType
• TTConstraintType
• SystemDefinedJI
• Added column TemporalQualifier to SessionInfo[V][X]:
• Added OtherCount to QryLogTDWMSumV
• Added the following fields to IndexConstraints[V][X]:
• VTCheckType
• TTCheckType
• ResolvedCurrent_Date
• ResolvedCurrent_TimeStamp
• Added the following fields to IndexStats[V]:
• UniqueOrPK
• VTConstraintType
• TTConstraintType
• SystemDefinedJI
• TimeDimension
• Added column SessionTemporalQualifier to QryLog[V]:
• Updated the descriptions for the following fields:
• ReferencingTbls.VTFKType
• ReferencedTbls.VTFKType
• TVFields.TimeDimension
• ConstraintNames.VTConstraintType
August 2010 (Continued)
Data Dictionary
7
Preface
Additional Information
Additional Information
URL
Description
www.info.teradata.com/
Use the Teradata Information Products Publishing Library site
to:
• View or download a manual:
1 Under Online Publications, select General Search.
2 Enter your search criteria and click Search.
• Download a documentation CD-ROM:
1 Under Online Publications, select General Search.
2 In the Title or Keyword field, enter CD-ROM, and click
Search.
• Order printed manuals:
Under Print & CD Publications, select How to Order.
www.teradata.com
The Teradata home page provides links to numerous sources of
information about Teradata. Links include:
• Executive reports, white papers, case studies of customer
experiences with Teradata, and thought leadership
• Technical information, solutions, and expert advice
• Press releases, mentions and media resources
www.teradata.com/t/TEN/
Teradata Customer Education designs, develops and delivers
education that builds skills and capabilities for our customers,
enabling them to maximize their Teradata investment.
http://tays.teradata.com/
Use Teradata @ Your Service to access Orange Books, technical
alerts, and knowledge repositories, view and join forums, and
download software patches.
developer.teradata.com/
Teradata Developer Exchange provides articles on using
Teradata products, technical discussion forums, and code
downloads.
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 email teradatabooks@lists.teradata.com.
8
Data Dictionary
Table of Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Supported Software Releases and Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
Changes to This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
Additional Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
Chapter 1: Teradata Database Data Dictionary Overview . . . 19
Data Dictionary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Data Dictionary Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Accessing the Data Dictionary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Updating the Data Dictionary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Examples of System Uses of Data Dictionary Information . . . . . . . . . . . . . . . . . . . . . . . .
19
20
24
24
25
Organization of the Data Dictionary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Data Dictionary Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Granted Rights on Data Dictionary Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Extending View Privileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
System View Versions Non-X and X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
26
26
26
27
Views for Special Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Security Logging Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Administrator Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Operations and Recovery Control Views. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Database Administrator Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
End User Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
29
29
31
32
32
33
Querying the Data Dictionary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Querying X Versus Non-X Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Dictionary Information Using HELP and COMMENT. . . . . . . . . . . . . . . . . . . . . . . . . . .
34
35
35
36
Stored Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
External Stored Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
User-Defined Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Data Dictionary
9
Table of Contents
User-Defined Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
JARs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
Java External Stored Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42
Java User-Defined Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
PM/API Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44
MONITOR-Related Queries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45
Monitoring Usage with Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
AllSpace and TableSize Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
AMPUsage View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
Compiling AMPUsage Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48
Account String Expansion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49
Other Methods of Evaluating Capacity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49
Additional Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49
DIPVIEWS Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
Tracking Miscellaneous System Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
Tracking System Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
Tracking Logon Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
Tracking Privileges. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
Calendar System View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
Calendar View Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
SQLJ System Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
JAR_JAR_USAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
Corresponding System Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54
JARS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54
Corresponding System Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54
ROUTINE_JAR_USAGE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
Corresponding System Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
DBCExtension Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56
GLOP_Map. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
GLOP_Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58
GLOP_Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60
Related Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61
Maintaining System Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61
Purging Outdated Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61
Other System Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62
Columns with Hex Unicode Constants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62
10
Data Dictionary
Table of Contents
Chapter 2: Data Dictionary Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Users of Data Dictionary Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Character Data in the Data Dictionary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Object Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Text Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Other Character Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Compatibility System Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Unicode System Views. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Updatable Views. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
64
64
64
64
64
65
66
System Views Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
System Views Columns Reference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Chapter 3: Data Dictionary Views: Usage and Examples. . . . 419
AccessLog[V]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
AccLogRules[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
AccountInfo[V][X]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
AllRights[V][X]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
AllRoleRights[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
AllSpace[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
AllTempTables[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
All_RI_Children[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
All_RI_Parents[V][X]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
AMPUsage[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
ArchiveLoggingObjsV[X]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
Association[V][X]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
Authorizations[V][X]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
CharSets[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
CharTranslations[V]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
Children[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
Collations[V]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
Columns[V][X]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
ColumnStats[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
ConnectRules[V]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
CostProfiles_V. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
CostProfileTypes_V . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
CostProfileValues_V. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
Data Dictionary
11
Table of Contents
Databases[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .453
Databases2[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .454
Database_Default_Journals[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .455
DBCInfo[V]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .456
DBQLRules[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .457
DeleteAccessLog[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .458
DeleteOldInDoubt[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .459
DiskSpace[V][X]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .460
ErrorTblsV[X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .462
Events[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .463
Events_Configuration[V][X]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .466
Events_Media[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .467
ExternalSPs[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .469
Functions[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .470
HostsInfo[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .472
IndexConstraints[V][X]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .473
IndexStats[V]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .475
Indices[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .478
InDoubtLog[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .479
JoinIndicesV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .480
Journals[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .481
LogOnOff[V][X]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .482
LogonRules[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .483
MultiColumnStats[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .483
ProfileInfo[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .485
QryLog[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .487
QryLogEventHis[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .489
QryLogEvents[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .490
QryLogExceptions[V]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .492
QryLogExplain[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .493
QryLogObjects[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .495
QryLogSQL[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .496
QryLogSteps[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .497
QryLogSummary[V]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .498
QryLogTDWM[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .500
QryLogTDWMSum[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .501
QryLogXMLV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .503
RCC_Configuration[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .504
12
Data Dictionary
Table of Contents
RCC_Media[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505
ReconfigDeleteOrderV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
ReconfigInfoV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507
ReconfigRedistOrderV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508
ReconfigTableStatsV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509
RepCaptureRulesV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510
RepTables[V][X]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512
ResolvedDTSV[X]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512
RestrictedWords[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513
RI_Child_Tables[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513
RI_Distinct_Children[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514
RI_Distinct_Parents[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
RI_Parent_Tables[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516
RoleInfo[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
RoleMembers[V][X]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
SecurityDefaults[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
SecurityLog[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519
SessionInfo[V][X]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
ShowColChecks[V][X]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521
ShowTblChecks[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522
Software_Event_Log[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
Table_LevelConstraints[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524
Tables[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
Tables2[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527
TableSize[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528
TableText[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529
Triggers[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530
UserGrantedRights[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
UserRights[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533
UserRoleRights[V] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
Users[V]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536
User_Default_Journals[V][X] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
Chapter 4: Data Dictionary Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539
Table Column Formats. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539
AccessRights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539
Data Dictionary
13
Table of Contents
AccLogRuleTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .540
AccLogTbl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .542
Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .543
Acctg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .544
ArchiveLoggingObjsTbl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .544
AsgdSecConstraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .545
CollationTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .545
ColumnCorrelation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .545
ConnectRulesTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .547
ConstantDefs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .548
ConstantValues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .548
ConstraintFunctions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .549
ConstraintNames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .549
ConstraintValues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .550
CostProfiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .550
CostProfileTypes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .551
DataBaseSpace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .551
Dbase. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .552
DBCAssociation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .554
DBCInfoTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .555
DBQLExplainTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .556
DBQLObjTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .556
DBQLogTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .557
DBQLRuleCountTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .560
DBQLRuleTbl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .560
DBQLSqlTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .561
DBQLStepTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .561
DBQLSummaryTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .563
DBQLXMLTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .564
Dependency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .565
ErrorMsgs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .565
ErrorTbls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .566
EventLog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .566
Global . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .568
Hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .568
IdCol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .568
Indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .569
InDoubtResLog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .570
JARS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .571
JAR_JAR_Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .571
LogonRuleTbl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .572
MDSRecoveryTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .572
Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .572
14
Data Dictionary
Table of Contents
Next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OldPasswords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Owners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ParentChildCorrelation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Parents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PasswordRestrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
QueryStatsTbl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
RCConfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
RCEvent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
RCMedia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ReconfigDeleteOrderTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ReconfigInfoTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ReconfigRedistOrderTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ReconfigTableStatsTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ReferencedTbls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ReferencingTbls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
RepBatchStatus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
RepCaptureRulesTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
RepGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
RepGroupTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
RepRulesetTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
RoleGrants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Routine_JAR_Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SecConstraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SessionTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
StatsTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SW_Event_Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SysSecDefaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SystemQTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TableConstraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TDWMEventHistory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TDWMEventLog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TDWMExceptionLog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TDWMSummaryLog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TempTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TextTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Translation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TriggersTbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TSETQueryText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TVFields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TVM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Data Dictionary
573
573
573
574
574
574
575
576
577
577
578
579
579
582
582
584
585
586
586
587
587
588
588
588
589
589
590
594
597
597
599
599
601
602
602
603
605
605
606
606
607
608
610
15
Table of Contents
UDFInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .613
UnResolvedReferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .614
UDTCast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .615
UDTInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .616
UDTTransform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .617
Chapter 5: Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .619
TwoPCRule Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .619
ResUsage Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .620
DIPVIEWS Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .621
ARC_NonEmpty_List[M] Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .622
ClearAccounting Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .624
ClearAllDatabaseUseCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .625
ClearDatabaseUseCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .625
ClearPeakDisk Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .626
ClearTVMUseCount. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .626
CollAddStandard Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .626
CollInstallMulti Macro. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .627
CopyCostProfile Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .628
CreateNewCostProfile Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .628
DBQLAccessMacro Macro. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .629
DeleteConstantValue Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .630
DeleteCostProfile Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .630
DIPMarkNSIO Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .631
InsertConstantString Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .631
InsertConstantValue Macro. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .632
ListCostProfiles Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .632
ListCostProfiles1 Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .633
ListCostProfiles2 Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .634
LogonRule Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .635
MergeCostProfile Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .635
ShowCostProfile Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .636
ShowCostProfileAs Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .636
16
Data Dictionary
Table of Contents
Appendix A: How to Read Syntax Diagrams . . . . . . . . . . . . . . . . . . . 639
Syntax Diagram Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Notation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Required Entries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Optional Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Abbreviations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Loops . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Excerpts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Multiple Legitimate Phrases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sample Syntax Diagram. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Diagram Identifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
639
639
639
640
640
641
641
641
642
643
643
644
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649
Data Dictionary
17
Table of Contents
18
Data Dictionary
CHAPTER 1
Teradata Database Data
Dictionary Overview
This chapter describes the Teradata Database Data Dictionary and provides information
about the following topics:
•
What the Data Dictionary consists of
•
How the Data Dictionary is organized
•
What views are and who uses them
•
How to query the Data Dictionary
•
What are stored procedures
•
Monitoring system use
•
DIPVIEWS script
•
Tracking system events
•
System calendar
•
Maintaining system logs
•
Other system objects
•
Columns with Hex Unicode constants
Data Dictionary
The Teradata Database Data Dictionary is composed of tables and views that reside in the
system user named DBC. The tables are reserved for use by the system and contain metadata
about the objects in the system, privileges, system events, and system usage. The views provide
access to the information in the tables. The tables contain current definitions, control
information, and general information about the following:
•
•
•
•
•
•
•
•
•
•
Data Dictionary
Authorization
Accounts
Character sets
Columns
Constraints
Databases
Disk Space
End Users
Events
External stored procedures
•
•
•
•
•
•
•
•
•
•
Indexes
JAR and ZIP archive files
Logs
Macros
Privileges
Profiles
Resource usage
Roles
Rules
Sessions and session attributes
•
•
•
•
•
•
•
•
•
Statistics
Stored procedures
Tables
Translations
Triggers
User-defined functions
User-defined methods
User-defined types
Views
19
Chapter 1: Teradata Database Data Dictionary Overview
Data Dictionary
Data Dictionary Users
Users typically use views to obtain information on objects, and database administrators
generally create and update tables that system views reference. The following table contains
information about what is stored in the Data Dictionary when you create some of the most
important objects.
20
WHEN you create…
THEN the definition of the object is stored along with the following details…
a table
• Table location, identification, database name, table name, creator
name, version, database name, and user names of all owners in the
hierarchy.
• Each column in the table, including column name, data type, length,
and phrases.
• User/creator access privileges on the table.
• Indexes defined for the table.
• Constraints defined for the table.
• Table backup and protection (including fallback and permanent
journaling status).
• Date and time the object was created.
a database
• Database name, creator name, owner name, and account name
• Space allocation (if any) including:
• Permanent
• Spool
• Temporary
• Number of fallback tables
• Collation type
• Creation time stamp
• The date and time the database was last altered and the name that
altered it
• Role and profile names
• Revision numbers for the UDF library and any external stored
procedure (XSP) libraries by Application Category
a view or macro
• The text of the view or macro.
• Creation time attributes.
• User and creator access privileges on the view or macro.
a stored procedure
• Creation time attributes of the stored procedure.
• Parameters of the stored procedure, including parameter name,
parameter type, data type, and default format.
• User and creator access privileges on the stored procedure.
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
Data Dictionary
Data Dictionary
WHEN you create…
THEN the definition of the object is stored along with the following details…
an external stored
procedure
• C/C++ source code and object code for the external stored procedure if
its language is not Java.
• External stored procedure name
• External name
• Data types of the parameters
• Source file language
• Data accessing characteristic
• Parameter passing convention
• Execution protection mode
• Character type
• Platform type
a JAR
•
•
•
•
•
Java object code for the JAR
JAR name
External name
Platform type
Revision number
a Java external stored
procedure
•
•
•
•
•
•
•
•
•
Java external stored procedure name
External file reference
Data types of the parameters
Source file language
Data accessing characteristic
Parameter passing convention
Execution protection mode
Character type
Platform type
a Java user-defined
function
•
•
•
•
•
•
•
•
•
•
•
•
•
Function call name
Specific name
External name
Data types of the parameters
Function class
Source file language
Data accessing characteristic
Parameter passing convention
Deterministic characteristic
Null-call characteristic
Execution protection mode
Character type
Platform type
21
Chapter 1: Teradata Database Data Dictionary Overview
Data Dictionary
22
WHEN you create…
THEN the definition of the object is stored along with the following details…
a trigger
• The IDs of the:
• Table
• Trigger
• Database and subject table database
• User who created the trigger
• User who last updated the trigger
• Timestamp for the last update
• Indexes
• Trigger name and
• Whether the trigger is enabled
• The event that fires the trigger
• The order in which triggers fire
• Default character set
• Creation text and time stamp
• Overflow text, that is, trigger text that exceeds a specified limit
• Fallback tables
a user-defined
function
• C source code and object code for the user defined function if its
language is not Java.
• Function call name
• Specific name
• External name
• Data types of the parameters
• Function class
• Source file language
• Data accessing characteristic
• Parameter passing convention
• Deterministic characteristic
• Null-call characteristic
• Execution protection mode
• Character type
• Platform type
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
Data Dictionary
WHEN you create…
THEN the definition of the object is stored along with the following details…
a user-defined
method
•
•
•
•
•
•
•
•
•
•
•
•
•
•
a user-defined type
DBC.UDTInfo - one entry per UDT
C source code and object code for the user defined method
Function call name
Specific name
External name
Data types of the parameters
Function class
Source file language
Data accessing characteristic
Parameter passing convention
Deterministic characteristic
Null-call characteristic
Execution protection mode
Character type
Platform type
•
•
•
•
•
Type name
Type kind (Distinct or Structured)
Whether the type is instantiable
Default transform group (name)
Ordering form (full ordering or equals only - distinct and structured
types are always full)
• Ordering category (map or relative - distinct and structured types are
always map)
• Ordering routine ID
• Cast count
DBC.UDTCast - one entry per cast for a UDT
• Whether cast is implicit assignment
• Cast routine ID
DBC.UDFInfo - one entry for the UDT's auto-generated default
constructor
• Entries are the same as for a regular (C/C++) UDF
DBC.UDTTransform - one entry for the UDT's transform
• Default transform group name
• ToSQL routine ID
• FromSQL routine ID
Data Dictionary
23
Chapter 1: Teradata Database Data Dictionary Overview
Data Dictionary
WHEN you create…
THEN the definition of the object is stored along with the following details…
a user
• User name, creator name, and owner name
• Password string and password change date
• Space allocation including:
• Permanent
• Spool
• Temporary
• Default account, database, collation, character type, and date form
• Creation timestamp
• Name and time stamp of the last alteration made to the user
• Role and profile name
Accessing the Data Dictionary
For security and data integrity reasons, only the SELECT privilege is granted by default to
PUBLIC for most views in both the X and non-X views in the Data Dictionary. You cannot
use the INSERT, UPDATE, or DELETE SQL commands to alter the Data Dictionary in any
way.
SELECT privileges have not been granted to the PUBLIC on the following Data Dictionary
views:
• DBC.AccessLog
• DBC.QryLogExplain
• DBC.AccLogRules
• DBC.QryLogEvents
• DBC.CSPSessionInfo
• DBC.QryLogObjects
• DBC.DBQLRules
• DBC.QryLogSQL
• DBC.DeleteAccessLog
• DBC.QryLogSteps
• DBC.DeleteOldInDoubt
• DBC.QryLogSummary
• DBC.InDoubtLog
• DBC.QryLogTDWM
• DBC.LogonRules
• DBC.QryLogTDWMSum
• DBC.QryLog
• DBC.SecurityLog
• DBC.QryLogExceptions
• DBC.Software_Event_Log
Updating the Data Dictionary
When a data definition statement is processed, the system tables are updated automatically.
When a table is changed by an ALTER, CREATE, DROP, or RENAME statement, the Teradata
Database automatically increments the version count for that table. For more information
about creating, changing, and dropping tables, see Chapter 4: “Data Dictionary Tables.”
24
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
Organization of the Data Dictionary
Examples of System Uses of Data Dictionary Information
This table lists some examples of how the system uses Data Dictionary information.
For each …
The system …
request
checks the Data Dictionary to ensure that the requestor has the
appropriate access privileges.
approved query
uses the Data Dictionary information, along with all other
available statistics, to devise the best method of accessing the
data.
approved request that references
a macro name
executes the macro according to the definition stored in the
Data Dictionary.
approved request that references
a view name
assembles the view according to the definition stored in the
Data Dictionary and integrates the underlying tables and views
into a query to create the best method of accessing the data.
approved request that references
a stored procedure name
obtains the stored procedure creation-time attributes from the
Data Dictionary and validates the usage of the submitted
request.
approved request that references
a user-defined function
obtains the user-defined function attributes from the Data
Dictionary and validates the usage of the submitted request.
Organization of the Data Dictionary
Data Dictionary entries are stored in system tables in a special database named DBC.
Information in these system tables can be examined directly or indirectly using the Data
Dictionary views.
Data Dictionary views are pre-defined views that provide users with a way to retrieve
frequently used data from underlying system tables. Views do not contain data and are stored
as entries in the Data Dictionary. Views, which look like tables to users, display data in
columns and rows only when a user submits an SQL statement that uses them.
View names, such as “DiskSpace,” “Users,” and “Columns” are based on entries contained in
the underlying tables.
The set of views that are available to a user is determined by the Teradata Database
administrator. Specialized views are designed to meet the needs of the following individuals:
•
Teradata Database administrators (system administrators and security administrators)
•
Users that supervise other system users and accounts
•
End users or clients logged on to a Teradata Database session
•
Operators using the database window of the Administration Workstation (AWS) or
someone responsible for running client utilities
References to specific views for certain users are described in detail later in this chapter.
Data Dictionary
25
Chapter 1: Teradata Database Data Dictionary Overview
Data Dictionary Views
Data Dictionary Views
Data Dictionary views are part of the Teradata Database Data Dictionary and reside in the
space owned by the system user DBC. View definitions are stored in the table DBC.TVM.
View column information is stored in DBC.TVFields.
The Teradata Database administrator loads the views for a site by running the Database
Initialization Program (DIP) from the Database Window (DBW). For more information on
running DIP from the DBW, see Utilities. The DIP script is run automatically with other
scripts at installation or upgrade.
Supplied views allow the database administrator to provide a consistent image of the data
stored in the Data Dictionary. In most instances, only the Teradata Database administrator is
allowed to directly update or delete a Data Dictionary view or its underlying system tables.
Granted Rights on Data Dictionary Views
The database administrator can GRANT or REVOKE a privilege on any view for a user at any
time. In addition, since some views are applicable only to a security administrator or a field
engineer, access to these views is normally restricted.
By default, the SELECT privilege is granted to PUBLIC on most views. This privilege allows
any user to retrieve view information via the SELECT statement.
If no changes are made to the default access privilege (GRANT SELECT TO PUBLIC) in the
view definitions, any user can query a Data Dictionary view by specifying its fully-qualified
name (DBC.viewname).
For example, a user can review the current Teradata Database version and release by
submitting the following query from any client:
SELECT * FROM DBC.DBCInfo;
Extending View Privileges
In some cases, the database administrator may want to grant to other users the SELECT or
other privileges on certain administrator views. For example, it might be useful for
development personnel and financial planners to monitor the use of system resources with
information obtained from the AllSpace, TableSize, DiskSpace, AMPUsage, and LogOnOff
views.
In addition, if full security auditing is implemented on the Teradata Database, a security
administrator user may need to be created and granted the privileges necessary to execute
BEGIN/END LOGGING statements.
26
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
Data Dictionary Views
System View Versions Non-X and X
During system installation, two versions of the system views, non-X and X, are available for
loading into the DBC user space.
Availability of views depends on the database administrator, who can load either or both
versions. Generally, most available system views have a corresponding X version.
The standard non-X views are named according to the contents of their underlying tables,
such as DBC.User_Default_Journals, DBC.DiskSpace, and DBC.TableSize. These views return
every row of every column defined on the underlying table.
The X version of a view defines the same views followed with the character “X.” For example,
DBC.DiskSpaceX, DBC.TableSizeX, and DBC.User_Default_JournalsX.
An X version of a view limits the return from a view to only those rows associated with the
requesting user, such as the following:
•
Databases
•
Users
•
Objects owned or created by the user
•
Objects on which the user has been granted privileges
In addition to the rows associated with the requesting user, the following X views return rows
associated with the requesting the current role of the user and any nested roles of that current
role.
Data Dictionary
•
DBC.All_RI_ChildrenX
•
DBC.All_RI_ParentsX
•
DBC.AllRightsX
•
DBC.AssociationX
•
DBC.ColumnsX
•
DBC.DatabasesX
•
DBC.Databases2X
•
DBC.Database_Default_JournalsX
•
DBC.DiskSpaceX
•
DBC.EventsX
•
DBC.Events_MediaX
•
DBC.Events_ConfigurationX
•
DBC.FunctionsX
•
DBC.IndexConstraintsX
•
DBC.IndicesX
•
DBC.JournalsX
•
DBC.RCC_MediaX
•
DBC.RCC_ConfigurationX
•
DBC.RepTablesX
27
Chapter 1: Teradata Database Data Dictionary Overview
Data Dictionary Views
•
DBC.RI_Child_TablesX
•
DBC.RI_Distinct_ChildrenX
•
DBC.RI_Distinct_ParentsX
•
DBC.RI_Parent_TablesX
•
DBC.ShowColChecksX
•
DBC.ShowTblChecksX
•
DBC.Table_LevelConstraintsX
•
DBC.TablesX
•
DBC.Tables2X
•
DBC.TableSizeX
•
DBC.TableTextX
•
DBC.TriggersX
•
DBC.User_Default_JournalsX
For example, the DBC.TablesX view provides the following information for each table to
which the role of the user has access.
•
If the Role has privilege on all in TVMs
•
If the Role has privilege on this specific TVM
It also depends on the current session role of the user to determine what role(s) is used to
verify privileges.
If the current role is . . .
Then . . .
not NULL or ALL
the current role and its nested role are used for security checks.
ALL
all the role(s) directly granted to the user and all their nested role(s)
are used for security checks.
X views run slower than non-X views because the X views have security checks.
Example
For example, assume user Jones enters a query against the standard TableSize view, as follows:
SELECT * FROM DBC.TableSize;
This query returns size information for every data table in the Teradata Database.
To limit the response, Jones could query the X version of the view. For example, if Jones
submits the following query:
SELECT * FROM DBC.TableSizeX;
then information is returned only for those tables that Jones created or is otherwise associated
with.
For security, Jones may be permitted to use only the X version.
28
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
Views for Special Users
Views for Special Users
Some views are available only to special system users and are not normally available to
PUBLIC, although this depends solely on the privileges that are granted to each user (either
directly or via PUBLIC). The following table describes who typically uses certain types of
views:
View Type
Description
Security Logging
The security logs, which store information about access rules and events,
are populated as a result of executing BEGIN LOGGING and END
LOGGING statements.
These statements may be executed only if the AccLogRule special security
macro has been installed on the Teradata Database platform.
The database administrator should create a security administrator user,
and grant to that user at least the SELECT privilege on the access logging
views.
For more information, see Security Administration.
System Administrator
These views are generally available only to SYSADMIN. They provide
information about Parser Engine (PE) vprocs (virtual processors) on the
Teradata Database, which are of interest to database administrators of
Teradata Database platforms that communicate with PC or workstation
clients.
System Field Engineer
These views are generally available only to user SYSTEMFE. They are
normally used by Field Engineers to review data about the automatic
identification and recovery of bad disk sectors.
The following sections describe particular views that can be valuable to different types of
users.
Security Logging Views
The following Data Dictionary views are of interest to the user responsible for security of the
data on the Teradata Database.
View
Definition
AccessLog
Returns information on the results of privilege checks performed against
user requests to access data, which are logged as determined by the access
logging rules.
To keep space consumption under control, archive and empty the log
regularly using the DeleteAccessLog[X] view.
Data Dictionary
29
Chapter 1: Teradata Database Data Dictionary Overview
Views for Special Users
View
Definition
AccLogRules
Shows the rules generated as a result of successfully executed BEGIN
LOGGING statements.
The AccessLog view provides an audit trail of access events logged as a
result of applying these rules.
DeleteAccessLog[X]
Removes AccessLog records that are more than 30 days old.
SecurityLog[X]
Provides a subset of the information in the AccessLog view.
LogOnOff
Reports logon/logoff activity for a user, including account, date, time of
day, and unsuccessful logon attempts.
LogonRules
Reports logon rules that have been generated for username/hostid pairs as
a result of successfully executed GRANT LOGON and REVOKE LOGON
statements.
SecurityDefaults
Reports global password parameters, such as length, valid characters,
number of logon attempts, and elapsed time for password expiration and
re-use defined for your site.
A user responsible for security may also have an interest in views listed in the next section, for
example, the ones that deal with privileges.
Statements related to access logging may be executed only if the DBC.AccLogRule security
macro has been created in database DBC. Otherwise, logging of Teradata SQL access requests
is not performed. See Security Administration for more information on creating this macro
and further information on access logging and security.
If access logging is specified for a data object (for example, a table), log entries are generated
only when that object is accessed by name. As an example, a logging statement specifying
“FIRST SELECT ON DatabaseA.Table1” causes a log entry to be generated if an access
statement is the following:
SELECT . . . FROM Table1
Logging does not occur on the following access statements unless a logging rule specifies the
view or macro used:
•
SELECT . . . FROM View1_of_Table1
•
EXECUTE MACRO1
(Where Macro1 contains the statement SELECT . . . FROM Table1)
Note: The behavior of not logging indirect access to underlying tables when views or
macros are executed was introduced with Teradata Database Version 2.0. In prior releases,
if underlying tables had logging rules, then rows were added even if access was through a
view or macro.
It is strongly recommended that you not install the macro unless your site requires such
security, since the logging feature extracts a performance penalty even if little or no logging is
performed.
30
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
Views for Special Users
Administrator Views
Data Dictionary views of specific interest to Teradata Database administrators could include
but are not limited to the following:
View
Description
AllRights
What privileges on databases/users, tables, views, triggers, stored
procedures, macros, user-defined functions, user-defined types, and userdefined methods have been granted to each user?
AllSpace[X]
How much disk storage space or spool space is being used by a given table,
database/user, or account, on all AMPs or specific AMPs?
AMPUsage
What demands on Teradata Database resources (AMP usage,
I/Os) are generated by a given user/account string?
CharSets
What names of any user-defined character sets are installed and can be
used in a session?
CharTranslations
What names and hexadecimal codes have been defined for the purpose of
creating non-standard international character sets?
Note: If this view does not exist or no rows are found, then no userdefined character sets have been inserted into the system table.
Data Dictionary
Children[X]
What databases and users are owned by other databases and users?
ColumnStats
What is the statistical information on the columns in a table for which
statistics have been collected?
DBCInfo
What Teradata Database software version and release are running? What
version and release are indicated after a restart?
DiskSpace[X]
How much disk storage space or spool space is being used by a given
database/user or account on all AMPs? On specific AMPs?
HostsInfo
What character sets have been assigned to what client systems?
IndexStats
What is the statistical information on the indexes defined on a table for
which statistics have been collected?
LogOnOff
What is the logon/logoff activity for a user, including account, date, time of
day, and unsuccessful logon attempts?
LogonRules
What logon rules have been generated for username/hostid pairs as a result
of successfully executed GRANT LOGON and REVOKE LOGON
statements?
ProfileInfo[X]
What is the profile and its parameter settings for users or the current user?
RoleInfo[X]
What are the names of the role creators corresponding to each role?
SecurityDefaults
What password parameters, such as length, valid characters, number of
logon attempts, and elapsed time for password expiration and re-use, are
defined for your site?
31
Chapter 1: Teradata Database Data Dictionary Overview
Views for Special Users
View
Description
SessionInfo[X]
What user name, account, default database, collation, logon hostid, logon
sequence number, and logon source are associated with each current
Teradata Database session?
Software_Event_Log
What software events have been logged by the diagnostic subsystem? What
are the IDs of the dump node and originating node, and what is the
severity and category?
TableSize[X]
What is the current and peak disk space usage (not including spool) for a
given database/user, data table, journal table, or account on all AMPs? On a
specific AMP?
TableText[X]
What data tables, views, macros have been created with the create/request
text overflow in DBC.TVM table?
Note: When you are logging view accesses, only the access of the top view in a hierarchy is
logged. Actions based on base views or tables are not logged.
Operations and Recovery Control Views
These views are useful to the system operator. They provide audit trails on the following:
View
Description
Events[X]
All archive and restore activity.
Events_Configuration[X]
Archive and restore activity that did not affect all AMPs.
Events_Media[X]
Archive and restore events that involved removable media.
RCC_Configuration[X]
Utility events that did not affect all AMPs.
RCC_Media[X]
Utility events that involved removable media.
Software_Event_Log
Software events and error logging information.
Association
Retrieves information about an object that was imported from
another Teradata Database.
Database Administrator Views
The following views are useful to a database administrator:
32
View
Description
AccountInfo[X]
What accounts are available to a given user?
ProfileInfo[X]
What are the profile and its parameter settings for the current user?
RoleInfo[X]
What are the names of the role creators corresponding to each role?
Users
What users are owned, or have been created, by a user?
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
Views for Special Users
End User Views
The following views are useful to an end user:
View
Description
AccountInfo[X]
What are the accounts the user can control?
Association
What are the ported and original definitions of databases, users,
and objects that were moved to a different Teradata Database
platform via the Portable Dump/Restore utility?
CharSets
What user-defined International character sets are currently
installed on the Teradata Database and available for sessions?
If this view does not exist or no rows are found, then either
international character sets have not been defined (see the
CharTranslations view), or those defined have not yet been
installed.
CharTranslations
What are the names and hexadecimal codes of all the translation
tables that have been inserted to create International character
sets?
If this view does not exist or no rows are found, then no
International character sets have been defined.
Collations
What are the names and hexadecimal codes of all the defined
collation sequences? Which one is currently installed as the
default sequence for MULTINATIONAL collation?
Columns[X]
What columns are associated with a table or view, or what
parameters are associated with a macro, user-defined function,
user-defined types, user-defined methods, or stored procedure,
on which you have privileges? What attributes have been defined
for these columns or parameters? What join indexes have been
defined using these columns?
Databases[X]
What are the characteristics of the databases you own or on
which you have privileges?
Database_Default_Journals[X]
What databases are defined as having a default journal table, and
what are the journal table names?
Functions[X]
What is all the information available for a particular function?
HostsInfo
What character sets have been assigned as the default to each
Teradata Database client connection in the Teradata Database
configuration?
If this view does not exist or no rows are found, user-defined
international character sets are not available (see the CharSets
view), or have not been assigned as host defaults. In this case, the
standard default is used (EBCDIC for IBM mainframe hosts and
ASCII for all others).
IndexConstraints
Data Dictionary
What index constraints derived from partitioning expressions
have been defined for a table?
33
Chapter 1: Teradata Database Data Dictionary Overview
Querying the Data Dictionary
View
Description
Indices[X]
What kinds of indexes have been defined for a table?
Journals[X]
What data tables use what journal tables, and in which database
does each table reside?
ProfileInfo[X]
What are all the profiles and their parameter settings?
RoleInfo[X]
What are the names of role creators corresponding to each role?
RoleMembers[X]
What is each role and all of its members?
ShowTblChecks
What table constraints have been defined for a database?
This view selects the uppercase databasename and tablename.
Table_LevelConstraints
What table constraints have been defined for a database?
This view selects the databasename and tablename as they were
entered by the user.
Tables[X]
What data tables, triggers, stored procedures, views, join indexes,
macros, user-defined types, user-defined methods, and user
defined functions have been created in a database on which you
have privileges?
TableSize[X]
What is the AMP-by-AMP disk usage for each database, table, or
account?
Triggers
What event-driven specialized procedures are attached to a single
table?
User_Default_Journals[X]
What user spaces are defined as having a default journal table,
and what are the journal table names?
UserGrantedRights
What privileges have you granted to other users?
UserRights
What privileges have you been granted on databases, tables,
triggers, stored procedures, views, join indexes, macros, userdefined types, user-defined methods, and user-defined functions?
UserRoleRights
What are all the rights granted to each role for the user?
Querying the Data Dictionary
You can review entries in the Data Dictionary by performing a query on a system view.
Various utilities and tools, such as BTEQ and other third-party tools, can be used to enter the
SELECT statement, and to display or print the results.
The examples included in this book show sample results of a query. The actual formatting of
the results may differ, depending on the utility or tool used.
The following sections explain and show various methods for retrieving directory
information.
34
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
Querying the Data Dictionary
Special Keywords
Three special names are used in queries of Data Dictionary views. Although they appear as
user or database names in information returned from a view, these names are not names of
actual users or databases. Rather, they are character strings that serve as placeholders,
appearing only as special “user names” or “database names” in the queries of certain views.
The three special names are:
•
ALL
•
DEFAULT
•
PUBLIC
These names must be enclosed in apostrophes as do actual user or database names when they
are used in certain views.
For example, the following query uses ALL as a name and returns the logging rules that apply
to all users:
SELECT * FROM DBC.AccLogRules
WHERE UserName = ’ALL’;
Note: In general, users never reference these names in queries or other SQL commands. These
names, although appearing as user or database names, actually have no content, no tables, no
views, and cannot be logged onto.
Querying X Versus Non-X Views
The amount of information that can be retrieved from system views at a particular site
depends on the following conditions:
•
Whether an X version is available for a particular view
•
The privilege granted, if any, on each available view
•
Whether the statement references “viewname” or “viewnameX”
Assuming that both the X and non-X versions of the views are installed, and that the SELECT
privilege is granted to PUBLIC on both versions, the information returned by an
unconditional SELECT depends on the specified viewname, as follows:
A view specified as …
Returns information about …
DBC.viewname
all objects for which entries exist in the underlying table.
Note: Unconditional SELECTs on non-X views may cause the result to
exhaust the available spool space of the user.
DBC.viewnameX
only those objects that the requesting user:
•
•
•
•
Data Dictionary
owns
created
has been granted privileges on
has access to via current role and the current nested roles of the role
35
Chapter 1: Teradata Database Data Dictionary Overview
Querying the Data Dictionary
Example for Non-X View Query
For example, user “Test1” may query the Databases view with the following statement:
SELECT DatabaseName, CreatorName, OwnerName, PermSpace
FROM DBC.Databases ;
As a result, all the databases in the Teradata Database would be listed, as shown below:
DatabaseName
pers
Accounting2
SQLDBA
abc123
PERSONNEL
Accounting1
Test1
Jane
.
.
CreatorName
SYSADMIN
Jacobs
DBC
SYSADMIN
SYSADMIN
Hillstein
SYSADMIN
Jane
.
.
OwnerName
SYSADMIN
Vettes
SYSADMIN
SYSADMIN
SYSADMIN
Vettes
Test1
Test1
.
.
PermSpace
500,000
250,000
150,000
1,460,000
1,500,000
500,000
1,000,000
500,000
.
.
Example for X View Query
User “Test1” may use the same structure to query the X version of Databases, as follows:
SELECT DatabaseName, CreatorName, OwnerName, PermSpace
FROM DBC.DatabasesX;
In contrast to the results of the previous example, only those databases that Test1 owned or
had access to would be listed:
DatabaseName
SQLDBA
Jane
PERSONNEL
Test1
.
.
CreatorName
DBC
Jane
SYSADMIN
SYSADMIN
.
.
OwnerName
SYSADMIN
Test1
SYSADMIN
Test1
.
.
PermSpace
150,000
500,000
1,500,000
1,000,000
.
.
Dictionary Information Using HELP and COMMENT
If the SELECT privilege on one or more system views was revoked or not granted to PUBLIC,
the HELP and COMMENT statements can be used to obtain directory information about a
particular object for which the user has access.
HELP does not require long or complex queries and the returns can be formatted for printing.
The COMMENT statement returns descriptive information about a database or database
object. This includes information about Data Dictionary views.
For example, the following COMMENT statement:
COMMENT ON DBC.UserGrantedRights;
returns the following description:
The DBC.UserGrantedRights view provides information on privileges that
the current user has granted to other users. The column names are:
DatabaseName, TableName, ColumnName, AccessRight, Grantee, Grant
Authority, and Allnessflag.
36
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
Stored Procedures
Stored Procedures
A stored procedure is defined and stored as a database object. Unlike objects such as views and
macros whose DDL statement text is stored in the Data Dictionary, a stored procedure also
has information stored in the database of the user space.
The stored procedure object in the platform contains the following information:
•
Source text (definition) used for creating the stored procedure
•
Corresponding object code (the compiled stored procedure)
•
Character set of the creator, character data type, collation sequence, and default database
name
Relationship with Data Dictionary
The information pertaining to a stored procedure object is stored in the DBC.TVM,
DBC.TVFields, DBC.AccessRights, and DBC.AccLogRulesTbl tables of the Data Dictionary.
The column, SPObjectCodeRows, in the DBC.TVM table references information on the status
of the stored procedure. The value of this column indicates the following stored procedure
creation-time attributes:
•
Session mode
•
Platform
•
Print option
•
Stored procedure text storage option
•
Teradata Stored Procedure (TDSP) version number
•
Warning option
•
Hardware architecture
The column SPParameterType in the DBC.TVFields table contains information on the
parameters of the stored procedure. Parameter types for this column include IN, INOUT, or
OUT.
The following privileges are stored in the AccessRights table:
•
CREATE OWNER PROCEDURE
•
CREATE PROCEDURE
•
ALTER PROCEDURE
•
EXECUTE PROCEDURE
•
DROP PROCEDURE
The corresponding logging rules are stored in AccLogRuleTbl. These respective columns are
called AcrCreOwnerProcedure, AcrCreateProcedure, AcrAlterProcedure,
AcrExecuteProcedure, and AcrDropProcedure.
Data Dictionary
37
Chapter 1: Teradata Database Data Dictionary Overview
External Stored Procedures
The Transient Journal (TJ) record holds the host request number for a stored procedure, in
addition to the DBS request number. This is required to return a correct response to the
“query status” for a request after DBS restarts.
Related Information
See Chapter 4: “Data Dictionary Tables” for more specific information on tables affected by
stored procedures.
See SQL Stored Procedures and Embedded SQL for complete details and rules for the usage of
stored procedures.
External Stored Procedures
An external stored procedure is defined and stored as a database object. The External Stored
Procedures (XSP) attributes are stored in the DBC.TVM Data Dictionary table. Similar to the
user-defined function objects, the source code and the object code of external stored
procedures are stored in the database of the user space.
The external stored procedure object contains the following information:
•
C/C++ source and object code for the external stored procedure if its language is not Java.
•
External stored procedure name
•
External name
•
Data types of the parameters
•
Source file language
•
Data accessing characteristic
•
Parameter passing convention
•
Execution protection mode
•
Character type
•
Platform type
Relationship with Data Dictionary
Information pertaining to external stored procedures is included in the following tables:
38
•
DBC.TVM
•
DBC.TVFields
•
DBC.AccLogRuleTbl
•
DBC.DBase
•
DBC.AccessRights
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
User-Defined Methods
The privileges relating to external stored procedures are:
•
CREATE OWNER PROCEDURE
•
CREATE PROCEDURE
•
ALTER PROCEDURE
•
DROP PROCEDURE
•
EXECUTE PROCEDURE
Related Information
For more information on External Stored Procedures, see SQL External Routine Programming.
User-Defined Methods
A user-defined method is defined and stored as a database object. The function attributes are
stored in a Data Dictionary table called DBC.UDFInfo. Similar to stored procedure objects,
the source code and the object code of the user-defined methods are stored in the database of
the user space.
The user-defined method object contains the following information:
Data Dictionary
•
C source code and object code for the user defined method
•
Function call name
•
Specific name
•
External name
•
Data types of the parameters
•
Function class
•
Source file language
•
Data accessing characteristic
•
Parameter passing convention
•
Deterministic characteristic
•
Null-call characteristic
•
Execution protection mode
•
Character type
•
Platform type
39
Chapter 1: Teradata Database Data Dictionary Overview
User-Defined Functions
User-Defined Functions
A user-defined function is defined and stored as a database object. The function attributes are
stored in a Data Dictionary table called DBC.UDFInfo. Similar to stored procedure objects,
the source code and the object code of the user-defined functions are stored in the database of
the user space.
The user-defined function object contains the following information:
•
C source code and object code for the user defined function if its language is not Java.
•
Function call name
•
Specific name
•
External name
•
Data types of the parameters
•
Function class
•
Source file language
•
Data accessing characteristic
•
Parameter passing convention
•
Deterministic characteristic
•
Null-call characteristic
•
Execution protection mode
•
Character type
•
Platform type
Relationship with Data Dictionary
The information pertaining to user-defined functions is included in the following Data
Dictionary tables:
•
DBC.TVM
•
DBC.UDFInfo
•
DBC.TVFIelds
•
DBC.AccLogRuleTbl
•
DBC.DBase
•
DBC.AccessRights
The privileges relating to user-defined functions are the following:
40
•
ALTER FUNCTION
•
CREATE FUNCTION
•
DROP FUNCTION
•
EXECUTE FUNCTION
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
JARs
Related Information
For more specific information on tables affected by user-defined functions, see Chapter 4:
“Data Dictionary Tables.”
For more information on user-defined functions, see SQL External Routine Programming and
SQL Data Definition Language.
JARs
A JAR is created externally to the database but is defined and stored as a database object when
installed on the system. The attributes of JAR are stored in the DBC.TVM and DBC.JARS Data
Dictionary tables. Similar to the user-defined function objects, the object code of the
externally created JAR file is stored in the database of the user space.
The JAR object contains the following information:
•
Java object code for the JAR
•
JAR name
•
External name
•
Platform type
•
Revision number
Relationship with Data Dictionary
Information pertaining to JARs is included in the following Data Dictionary tables:
•
DBC.TVM
•
DBC.JARS
•
DBC.DBase
•
DBC.AccessRights
The privileges relating to JARs are:
•
CREATE EXTERNAL PROCEDURE
•
DROP PROCEDURE
•
CREATE FUNCTION
•
DROP FUNCTION
Related Information
For more information on JARs, see SQL External Routine Programming.
Data Dictionary
41
Chapter 1: Teradata Database Data Dictionary Overview
Java External Stored Procedures
Java External Stored Procedures
A Java external stored procedure is defined and stored as a database object. The Java External
Stored Procedures attributes are stored in the DBC.TVM and DBC.Routine_Jar_Usage Data
Dictionary tables.
The Java external stored procedure object contains the following information:
•
Java external stored procedure name
•
External file reference
•
Data types of the parameters
•
Source file language
•
Data accessing characteristic
•
Parameter passing convention
•
Execution protection mode
•
Character type
•
Platform type
Relationship with Data Dictionary
Information pertaining to Java external stored procedures is included in the following Data
Dictionary tables:
•
DBC.TVM
•
DBC.TVFields
•
DBC.AccLogRuleTbl
•
DBC.DBase
•
DBC.AccessRights
•
DBC.Routine_Jar_Usage
•
DBC.UDFInfo
The privileges relating to Java external stored procedures are:
•
CREATE OWNER PROCEDURE
•
CREATE EXTERNAL PROCEDURE
•
ALTER PROCEDURE
•
DROP PROCEDURE
•
EXECUTE PROCEDURE
Related Information
For more information on Java External Stored Procedures, see SQL External Routine
Programming.
42
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
Java User-Defined Functions
Java User-Defined Functions
A Java user-defined function is defined and stored as a database object. The function
attributes are stored in the DBC.TVM, DBC.UDFInfo, and DBC.Routine_Jar_Usage Data
Dictionary tables.
The Java user-defined function object contains the following information:
•
Function call name
•
Specific name
•
External name
•
Data types of the parameters
•
Function class
•
Source file language
•
Data accessing characteristic
•
Parameter passing convention
•
Deterministic characteristic
•
Null-call characteristic
•
Execution protection mode
•
Character type
•
Platform type
Relationship with Data Dictionary
The information pertaining to Java user-defined functions is included in the following Data
Dictionary tables:
•
DBC.TVM
•
DBC.TVFields
•
DBC.AccLogRuleTbl
•
DBC.DBase
•
DBC.AccessRights
•
DBC.Routine_Jar_Usage
•
DBC.UDFInfo
The privileges relating to Java user-defined functions are the following:
Data Dictionary
•
ALTER FUNCTION
•
CREATE FUNCTION
•
DROP FUNCTION
•
EXECUTE FUNCTION
43
Chapter 1: Teradata Database Data Dictionary Overview
PM/API Queries
Related Information
For more specific information on tables affected by user-defined functions, see Chapter 4:
“Data Dictionary Tables.”
For more information on user-defined functions, see SQL External Routine Programming and
SQL Data Definition Language.
PM/API Queries
Performance Monitor/Application Programming Interface (PM/API) monitors commands
issued through a logon partition called MONITOR.
Using PM/API commands, performance data is collected on:
•
Current system configuration
•
Resource usage and status of an individual Access Module Process (AMP), Parsing Engine
(PE), or node
•
Resource usage and status of individual sessions
PM/API affects the following:
•
PM privileges (MONITOR SESSION, MONITOR RESOURCE, SET SESSION RATE, SET
RESOURCE RATE)
•
ABORT SESSION, which can force a user off the system
•
Execution of the commands SET RESOURCE, SET SESSION, and ABORT SESSION are
considered major system events and are, thus, logged to the DBC.SW_Event_Log table
The LogonSource column, referenced by the SW_Event_Log and the SessionTbl tables,
includes information about the source of sessions logged on from a z/OS client, including
information on the TDP and job name.
Queries against the following tables can possibly result in PM/API-related values for some
columns:
44
•
DBC.AccessRights
•
DBC.SessionTbl
•
DBC.SW_Event_Log
•
DBC.Dbase
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
PM/API Queries
The following Data Dictionary views, which are built on those tables, are also affected by
PM/API:
•
AllRights
•
AllSpace[X]
•
Databases[X]
•
DiskSpace[X]
•
Software_Event_Log
•
LogOnOff
•
SessionInfo
•
UserGrantedRights
•
UserRights
MONITOR-Related Queries
Queries related to the PM/API are made in a manner similar to other Data Dictionary queries.
The following queries provide information about MONITOR-related activities:
To determine who is using the monitor, enter the following:
SELECT UserName, IFPNo FROM DBC.SessionInfo
WHERE Partition = ’MONITOR’ ;
Queries regarding the use of system monitoring can be made much like other SELECT
queries. For example, to determine what users have the privilege to force other users off the
system, enter the following:
SELECT DISTINCT UserName FROM DBC.AllRights
WHERE AccessRight = ’AS’ ;
The ‘AS’ indicates the ABORT SESSION privilege.
To find out what users have been forced off the system in the past two days, enter the
following:
SELECT DISTINCT UserName FROM DBC.LogOnOff
WHERE Event = ’Forced Off’
AND LogDate > DATE - 3 ;
Data Dictionary
45
Chapter 1: Teradata Database Data Dictionary Overview
Monitoring Usage with Views
Monitoring Usage with Views
Information on the usage of the Teradata Database is collected by user and by account
number. Control is determined by the definition of each CREATE USER statement.
An account is associated with a group of users whose usage charges are maintained by the
Teradata Database. Account IDs may be established for a user with the ACCOUNT phrase in
the CREATE USER statement. If ACCOUNT is not specified, the default is the account ID of
the immediate owner of the user. If the owner has multiple account IDs, then the first account
ID is taken for the user as the default.
The following sections describe the accounting information available for any Teradata
Database session.
You can monitor usage with the following Data Dictionary views:
•
AccountInfo
•
AllSpace
•
AMPUsage
•
DiskSpace
•
LogOnOff
•
TableSize
The AllSpace, DiskSpace, TableSize, and AMPUsage views are useful in tracking Teradata
Database resources for accounting purposes, and in determining how effectively resources are
being utilized by accounts and users.
AllSpace and TableSize Views
You use the AllSpace, Diskspace, and TableSize views that access data from the DatabaseSpace
table to show how efficiently a table is distributed across the AMPs on which it is stored.
For example, the following statement:
SELECT CurrentPerm, PeakPerm, AMP FROM DBC.AllSpace
WHERE TableName = ’Personnel.Department’;
returns a row for each AMP on which the Department table is stored. Data in the
CurrentPerm column shows, in bytes, how Department data is distributed across the AMPs.
If the distribution is uneven, you can tell from the CurrentPerm data. In addition, the
PeakPerm column data indicates any fluctuations in distribution since the table was created.
AMPUsage View
The AMPUsage view supplies information about AMP CPU time consumed, and the number
of AMP to disk read and write operations generated by a given user or account.
This view also tracks the activities of any console utilities. A row is returned for each AMP in
the system unless aggregate figures are specified.
46
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
Monitoring Usage with Views
When you ask for resource usage logging, data about CPU overhead, user service, and user
execution is collected by vproc type and by node.
You can use the AMPUsage, AllSpace, DiskSpace, and TableSize views to summarize resource
usage for all AMPs, or for AMPs on which data is stored.
Example 1
To obtain a list (in the order of the amount of space used) of those databases currently using
more than 80% of their permanent space allocation, submit the following statement:
SELECT DatabaseName, SUM(CurrentPerm)
FROM DBC.DiskSpace
GROUP BY DatabaseName
HAVING (SUM(CurrentPerm)/NULLIFZERO(SUM(MaxPerm))) >.8
ORDER BY SUM(CurrentPerm) DESC;
You can also use the AMPUsage and DiskSpace views to compile and maintain usage statistics
that can later be selected and analyzed as described in the following sections.
Example 2
DBC.AMPUsage, which is a view for the DBC.Acctg system table, provides information about
the usage of each AMP for each user and account.
For example, the CPU time in a given row is the cumulative CPU time of the user since logon
plus the cumulative previous logon time for that user. The I/O entry in a row records the total
I/O accesses for the user during any reporting logon period.
The following occurs to DBC.Acctg, which is a non-fallback and non-hashed system table
when an AMP is down:
Data Dictionary
•
Data rows on the down AMP are not available, and DML statements such as SELECT,
INSERT, UPDATE, and DELETE do not apply to the down AMP.
•
Resource accounting information for the down AMP temporarily disappears until the
AMP is back online.
•
Any aggregate query on the DBC.Acctg includes only the online AMPs.
•
No resource accounting information is recorded during the down AMP recovery.
•
The down AMP recovery is not associated with any particular user. However, the resource
accounting associated with the Transient Journal (TJ) rolling back for the down AMP is
charged to the user. (No resource accounting is charged to the user while the down AMP
recovers from offline to online except when the updates on the TJ apply to the down
AMP.)
•
A system restart may impact the cumulative totals in the DBC.Acctg. (Any accounting data
accumulated in the cache since the last time the cache was flushed before the restart is lost
completely and does not contribute to the totals in DBC.Acctg resulting from the loss of
cache memory.)
47
Chapter 1: Teradata Database Data Dictionary Overview
Monitoring Usage with Views
Compiling AMPUsage Statistics
You can use the AMPUsage view to build and maintain a history table of CPU time and disk
I/O statistics for each username/accountname.
To create the history table, enter the following statement:
CREATE TABLE AMPUseHist
( AccountName VARCHAR(30),
UserName VARCHAR(30),
CPUtime INTEGER,
DiskIO INTEGER,
CollectDate DATE,CollectTime FLOAT )
PRIMARY INDEX (UserName, AccountName);
Periodically, collect usage statistics using the following procedure:
1
Select statistics from the AMPUsage view and insert them in the history table.
2
Reset AMPUsage counters to zero for the next collection period.
This procedure can be carried out using the following BTEQ script:
.LOGON username, password
INSERT INTO AMPUseHist
SELECT AccountName, UserName,SUM(CPUtime), SUM(DiskIO), DATE, TIME
FROM DBC.AMPUsage
GROUP BY AccountName, UserName, DATE, TIME;
UPDATE DBC.AMPUsageV
SET CPUTime = 0, DiskIO = 0 ALL;
.QUIT
The units in which Disk I/O are measured represent data block accesses. CPU time is
measured in seconds.
Refer to the DiskSpace View to determine how you can use the DiskSpace view to build and
maintain a table of disk space usage.
After a collection period, you may select AMPUsageV and DiskSpace statistics from the
history tables to query the data or to archive the data on a client system. You can use the
selected data in sequential data sets on the host computer for subsequent analysis.
For example, you can use a BTEQ script to achieve the following:
48
•
Create a client-resident file
•
Use the BTEQ .EXPORT command to save the data being selected into that file
•
Select all rows from the DiskSpace history table
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
Monitoring Usage with Views
The following example shows how such a BTEQ job is used to select data from the DiskSpace
history table:
//JOBNAME JOB
jobcard
//EXTRACT EXEC PGM=ITBMAIN
//STEPLIB DD
DSN=TERADATA.APPLOAD,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//SAVEDATA DD DSN=ACC.SAVEDATA.DATA,DISP=(NEW,CATLG)
//
UNIT=SYSDA,SPACE=(TRK,(1,1),RLSE),
//
DCB=(LRECL=80,RECFM=FB,BLKSIZE=800)
//SYSIN
DD
DATA,DLM=##
.LOGON somebody,password
.EXPORT DATA DDNAME=SAVEDATA
SELECT * FROM DiskSpaceHist
ORDER BY CollectDate,CollectTime;
.QUIT
##
Once selected and stored, historical data can be used for analysis, as follows:
•
Client-resident software packages such as SAS can be used to perform analysis and other
statistical manipulation on the data.
•
Graphic software packages can be used to display the data.
Account String Expansion
Another way to measure resource usage is by using the optional Account String Expansion
(ASE) feature. It allows you to append date, time, hour, or logon time stamp data to the
DBC.Acctg table.
This allows more precise measurement of individual Teradata SQL statement execution, more
precise statistics, more accurate capacity planning, and more information for chargeback and
accounting software.
Other Methods of Evaluating Capacity
You can use the ResNode macro to evaluate the capacity of current system resources, and the
Performance Monitor/Application Program Interface (PM/API) feature to determine current
capacity during an active session.
Additional Information
The following references provide additional information on resource usage:
Data Dictionary
Book
Chapter
Section
Performance Management
Other Performance
Monitoring Tools
AMPUsage View
Resource Usage Macros and Tables
Resource Usage Macros
• ResUsage Macro Names
• ResUsage Macro Functions
• ResNode Macros
49
Chapter 1: Teradata Database Data Dictionary Overview
DIPVIEWS Script
DIPVIEWS Script
The DIPVIEWS script allows database administration to install the Data Dictionary and
system views. It is provided on the Teradata Database CD-ROM or release tape.
For more information on the Database Initialization Program (DIP) utility, see Utilities.
Note: The DIPVIEWS script is run as part of running DIPALL from the utility.
Tracking Miscellaneous System Actions
Tracking System Events
The Software_Event_Log view displays, by date and time, any events that have affected
processing, such as a memory parity error, a disabling of logons, a Teradata Database restart,
or execution of a PM/API SET COLLECT command, along with an associated message. The
processor is identified when appropriate.
The LogOnOff view, because it chronologically records all logon and logoff activity as well as
the reasons for unsuccessful logons and logoffs, allows you to detect actual and attempted
security violations. This view also lets you know how long any user is connected to the
Teradata Database.
Tracking Logon Rules
The LogonRules view is used to review the rules generated by the GRANT LOGON and
REVOKE LOGON statements. These statements define which user can log on from what
mainframe or LAN host connection, and whether the logon string of the user is acceptable
without a password.
The initial default is that all users may logon from all hosts, and that every logon string must
contain a password. To change the default, use the GRANT LOGON and REVOKE LOGON
statements.
Tracking Privileges
The UserRights view provides information about the privileges that have been granted to any
user.
See the description of the GRANT statement in the SQL Data Definition Language, for an
explanation of the types of privileges, and how they are granted.
If a more detailed audit trail is necessary, this information may be supplemented by log entries
that provide an audit trail of the results of checks against requests to access table data. See also
Security Administration.
50
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
Calendar System View
Calendar System View
Introduction
The Sys_Calendar.Calendar system view helps to extend the properties of a DATE data type
column by means of a join.
The DIPCAL SQL script must be run from the DIP utility by the administrator to create the
Sys_Calendar database and Calendar view.
The calendar dates range from 1900 to 2100 and are stored in a table in the Sys_Calendar
database.
Authorization
The Sys_Calendar.Calendar view has SELECT privilege granted to PUBLIC.
Calendar View Definition
The following table describes the columns of the Sys_Calendar.Calendar view. In addition, the
table includes information on the data type and format of the column.
Data Dictionary
View Column Name
Description
Data Type
Format
calendar_date
Returns the default date format.
DATE
YY-MM-DD
day_of_week
Returns the day of the week (1-7) where
Sunday = 1 and Saturday = 7.
INTEGER
-(10)9
day_of_month
Returns the day of the month (1-31).
INTEGER
-(10)9
day_of_year
Returns the day of the year (1-366).
INTEGER
-(10)9
day_of_calendar
Returns the number of days since and
including 01/01/1900.
INTEGER
-(10)9
weekday_of_month
Returns the nth occurrence of the weekday
in the month (1-5).
INTEGER
-(10)9
week_of_month
Returns the nth full week of the month,
first partial week is 0 (0-5).
INTEGER
-(10)9
week_of_year
Returns the nth full week of the year, first
partial week is 0 (0-53).
INTEGER
-(10)9
week_of_calendar
Returns the nth full week of the calendar,
the first partial week is 0.
INTEGER
-(10)9
month_of_year
Returns the month of the year (1-12).
INTEGER
-(10)9
month_of_quarter
Returns the month of the quarter (1-4).
INTEGER
-(10)9
month_of_calendar
Returns the number of the months since
and including 01/01/1900.
INTEGER
-(10)9
51
Chapter 1: Teradata Database Data Dictionary Overview
Calendar System View
View Column Name
Description
Data Type
Format
quarter_of_year
Returns the quarter of the year. 1 (Jan/Feb/
Mar) - 4 (Oct/Nov/Dec).
INTEGER
-(10)9
quarter_of_calendar
Returns the number of quarters since and
including Q1/1900.
INTEGER
-(10)9
year_of_calendar
Returns the number of calendar years in 4
digit format.
INTEGER
-(10)9
Example
You are encouraged to define views on the Calendar system view because of its convenience.
A useful view to define on Calendar is Today:
CREATE VIEW Today AS (
SELECT * FROM Sys_Calendar.Calendar
WHERE Sys_Calendar.Calendar.calendar_date = DATE
);
Calendar permits easy specification of arithmetic expressions and aggregation. This is
particularly useful in online analytical processing environments where requests commonly
aggregate values by weeks, months, year-to-date, years, and so on. The following is a good
example.
What are the dollar sales for this week, last week, and the same weeks last year for all items in
the sportswear department for women?
SELECT a2.week_of_calendar, SUM(a1.price)
FROM Sales a1, CALENDAR a2, Item a3, Department a4, Today a5
WHERE a1.calendar_date=a2.calendar_date
AND (a2.week_of_calendar=a5.week_of_calendar
OR a2.week_of_calendar=a5.week_of_calendar - 1
OR a2.week_of_calendar=a5.week_of_calendar - 52
OR a2.week_of_calendar=a5.week_of_calendar - 53
)
AND a1.itemID=a3.itemID
AND a3.classID=a4.classID
AND a4.classDesc='Women’s Sportswear'
GROUP BY a2.week_of_calendar
ORDER BY a2.week_of_calendar;
52
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
SQLJ System Views
SQLJ System Views
Introduction
The SQLJ database and its views are used by the system to manage JAR files that implement
Java external stored procedures.
The SQLJ database is created via a DIP script. The DIP script used to create the SQLJ database
and its objects is called DIPSQLJ. This script is run as part of DIPALL. It requires sufficient
space for all required components to be defined within it, and the initial space allocation for
this database is determined based upon that fact. The best practice is to avoid the placement of
additional items into this database, as the SQLJ database could be considered an extension to
the Teradata Data Dictionary defined in the DBC database. The DIP script which creates SQLJ
and its components follows the pattern set by the DBC Data Dictionary initialization process,
and revokes all privileges which could result in modification of SQLJ's views and external
stored procedures.
The SQLJ system database contains the following views:
•
JAR_JAR_USAGE
•
JARS
•
ROUTINE_JAR_USAGE
JAR_JAR_USAGE
The JAR_JAR_USAGE view identifies each JAR owned by a given user or database on which
other JARs defined on the system are dependent.
The following table describes the columns of the JAR_JAR_USAGE view.
View Column Name
Description
Data Type
Format
DatabaseId
The identifier of the database or user in which the JAR
identified by JarName is defined.
BYTE(4)
NOT NULL
X(8)
JarName
The name designator for a JAR that depends on code
from another JAR.
VARCHAR(128)
UNICODE
UPPERCASE
NOT CASESPECIFIC
NOT NULL
X(128)
PathJarName
The name designator for a JAR, which is in the SQLJava path of the JAR identified by JarName
VARCHAR(128)
UNICODE
UPPERCASE
NOT CASESPECIFIC
NOT NULL
X(128)
The SQL-Java path is the search path defined for a
particular JAR. With a SQL-Java path defined, a
method defined in a particular JAR (JAR A, for
example) may invoke a method which is actually
defined in another JAR (JAR B), if JAR B (and all its
classes) is contained in JAR A's SQL-Java path. A SQLJava path for a JAR can only be created, altered, or
dropped via a call to SQLJ.Alter_Java_Path.
Data Dictionary
53
Chapter 1: Teradata Database Data Dictionary Overview
SQLJ System Views
Corresponding System Tables
The corresponding system tables for SQLJ.JAR_JAR_USAGE are:
•
DBC.JAR_JAR_USAGE
•
DBC.DBase
•
DBC.TVM
Example
The following SELECT statement retrieves information about each JAR owned by a given user
or database on which other JARs are dependent.
==> SELECT * FROM sqlj.jar_jar_usage;
*** Query completed. 2 rows found. 3 columns returned.
*** Total elapsed time was 1 second.
DatabaseId
---------0000B905
0000B905
JarName
------JAR1
JAR2
PathJarName
----------JAR4
JAR3
JARS
The JARS view identifies the installed JARs defined on the system that are accessible to the
current user or database.
The following table describes the columns of the JARS view.
View Column Name
Description
Data Type
Format
DatabaseId
The identifier of the database or user in which the JAR
identified by JarName is defined.
BYTE(4)
NOT NULL
X(8)
JarName
The name designator for an installed JAR.
VARCHAR(128)
UNICODE
UPPERCASE
NOT CASESPECIFIC
NOT NULL
X(128)
JarId
The unique identifier for the JAR identified by
JarName.
BYTE(6)
NOT NULL
X(12)
Corresponding System Tables
The corresponding system tables for SQLJ.JARS are:
54
•
DBC.DBase
•
DBC.JARS
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
SQLJ System Views
Example
The following SELECT statement retrieves information about all of the JAR objects that are
accessible to the current user or database.
==> SELECT * FROM sqlj.jars;
*** Query completed. 3 rows found. 3 columns returned.
*** Total elapsed time was 1 second.
DatabaseId
---------0000B905
0000B905
0000B905
JarName
------JAR1
JAR2
JAR3
JarId
-----------000061280000
000062280000
000063280000
ROUTINE_JAR_USAGE
The ROUTINE_JAR_USAGE view identifies the JARs owned by a given user or database on
which external Java routines defined on the system are dependent.
View Column Name
Description
Data Type
Format
DatabaseId
The identifier of the database or user in which the JAR
identified by JarName is defined.
BYTE(4)
NOT NULL
X(8)
RoutineName
The name designator for a Java external stored procedure
that depends on the JAR identified by JarName.
VARCHAR(128)
UNICODE
UPPERCASE
NOT CASESPECIFIC
NOT NULL
X(128)
JarName
The name designator for a JAR that contains code that
the RoutineName external stored procedure depends on.
VARCHAR(128)
UNICODE
UPPERCASE
NOT CASESPECIFIC
NOT NULL
X(128)
Signature
The signature defined for Java external stored procedure
identified by RoutineName.
VARCHAR(6400)
LATIN
CASESPECIFIC
X(255)
Corresponding System Tables
The corresponding system tables for SQLJ.ROUTINE_JAR_USAGE are:
Data Dictionary
•
DBC.ROUTINE_JAR_USAGE
•
DBC.DBase
•
DBC.TVM
55
Chapter 1: Teradata Database Data Dictionary Overview
DBCExtension Tables
Example
The following SELECT statement retrieves information about all of the JARs owned by a given
user or database on which dependent external Java routines are defined. Information about
these routines is also returned.
==> SELECT * FROM sqlj.routine_jar_usage;
*** Query completed. 3 rows found. 4 columns returned.
*** Total elapsed time was 1 second.
DatabaseId
JarName
RoutineName
Signature
DatabaseId
JarName
RoutineName
Signature
DatabaseId
JarName
RoutineName
Signature
0000B905
JAR1
MYINT
(I[I)V
0000B905
JAR2
MYDEC
(Ljava/math/BigDecimal;[Ljava/math/BigDecimal;)V
0000B905
JAR3
MYVARBYTE
([B[Ljava/lang/String;)V
DBCExtension Tables
Introduction
The DBCExtension database is used to obtain the Global and Persistent (GLOP) sets used to
define a particular mapping of data, how the data in the set is mapped, and the actual GLOP
data that is mapped.
The DBCExtension database is created via a DIP script. The DIP script used to create the
DBCExtension database and its objects is called DIPGLOP.
The DIPGLOP DIP script is not run as part of DIPALL but is an optional DIP script, and it has
to be run separately.
The DBCExtension system database contains the following tables:
56
•
GLOP_Map
•
GLOP_Set
•
GLOP_Data
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
DBCExtension Tables
GLOP_Map
The GLOP_Map table contains the possible mappings for the particular set.
The following describes the columns of the GLOP_Map table.
Table Column Name
Description
Data Type
Format
GLOP_Set_ID (USI)
Returns the numeric ID of the GLOP set.
BYTE(6) NOT NULL
X(12)
VARCHAR(128)
UNICODE
NOT CASESPECIFIC
NOT NULL
X(128)
It is the TVM GLOP set ID created with a CREATE
GLOP SET statement.
GLOP_SetName
(Composite UPI)
Returns the name for the GLOP set.
DatabaseId (Composite
UPI)
Returns the Dbase ID of the database the GLOP set
belongs to.
BYTE(4) NOT NULL
X(8)
GLOP_Type0
Returns the type of data GLOP to be mapped at the
specified position in the reference array when the
external routine is called.
CHAR(2) LATIN NOT
CASESPECIFIC
X(2)
CHAR(1) LATIN NOT
CASESPECIFIC
X(1)
CHAR(1) LATIN NOT
CASESPECIFIC
X(1)
INTEGER
--,---,---,--9
to
GLOP_Type7
It is the name specified in the external routine NEW
MEMBER clause and in the CREATE GLOP SET
statement.
See GLOP_Type description for the GLOP type
values.
Note: A NULL value indicates that particular map
entry (position) is not being used.
GLOP_Map0
Returns one of the following values:
to
• NULL = no mapping for that GLOP type in that
set.
• N = the normal mapping is taking place, and the
GLOP is mapped when the external routine is a
member of the set.
• S = the GLOP type is to have the mapping shared
with any other GLOP set if the GLOP set
specifies the same data reference.
GLOP_Map7
GLOP_Mode0
Returns one of the following values:
to
• R = read-only
• W = read/write
• M = read/write and can be globally modified
GLOP_Mode7
GLOP_Page0
to
GLOP_Page7
Data Dictionary
Returns the initial GLOP data page for a
read-only GLOP to be mapped when the map is set
up for an external routine.
If the field is NULL, then whatever page is already
mapped on the vproc is mapped. If the field is
NULL, and the GLOP has not been mapped yet,
then the first page is mapped. The field can only be
one for read/write GLOP data.
57
Chapter 1: Teradata Database Data Dictionary Overview
DBCExtension Tables
GLOP_Set
The GLOP_Set table describes the type of mapping for a set.
The following describes the columns of the GLOP_Set table.
Table Column Name
Description
Data Type
Format
GLOP_Set_ID
(Composite UPI)
(Composite NUSI)
Returns the ID of the GLOP set.
BYTE(6) NOT NULL
X(12)
GLOP_Sub_ID
(Composite UPI)
(Composite NUSI)
Returns 0.
BYTEINT NOT NULL
--9
DatabaseId
Returns the database the set is associated with (the
owner of the set).
BYTE(4) NOT NULL
X(8)
GLOP_Type (Composite
UPI) (Composite NUSI)
Returns one of the following values:
CHAR(2) LATIN NOT
CASESPECIFIC NOT
NULL
X(2)
GLOP_Index
(Composite UPI)
Returns the position in the map array.
BYTEINT NOT NULL
--9
It is the TVM GLOP SET ID created with a CREATE
GLOP SET statement.
If this is a dependency GLOP, then this value is
nonzero. It has a range of 0 to 3.
•
•
•
•
•
•
•
SY = for system level context
RO = for role level context
US = for user account level context
SE = for session level context
TR = for transaction level context
RE = for request level context
XR = for external routine level context
The GLOP address is to be found in the external
routine.
Valid values are 0 to 7.
58
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
DBCExtension Tables
Table Column Name
Description
Data Type
Format
GLOP_Dependency
Determines when a changed GLOP can be replaced
with the new one.
CHAR(4) LATIN NOT
CASESPECIFIC
X(4)
BYTE(6)
X(12)
VARCHAR(128)
UNICODE NOT
CASESPECIFIC
X(128)
The field is normally set to NULL.
The dependency value consists of two parts:
Part A
• NULL = no dependency
• RS = replace on system restart
• SY = replace on system GLOP changes
• RO = replace on role changes
• US = replace on user changes
• SE = replace on session changes
• TR = replace on transaction changes
• RE = replace on request changes
• QS = replace when system is quiescent
Part B
• N = change when new or as yet not seen
referenced type is established
GLOP_Association
(Composite UPI)
Returns the ID associated with the given
GLOP_Type.
This field is used for role, user, and external routine
GLOPs only.
GLOP_AssociationName
Returns the name associated with the given
GLOP_Association.
This field is used for role, user, and external routine
GLOPs only.
GLOP_DataName
Returns the name associated with the GLOP data.
VARCHAR(128)
UNICODE NOT
CASESPECIFIC
X(128)
GLOP_Length
Returns the size in bytes of the GLOP data to be
established.
INTEGER NOT NULL
--,---,---,--9
GLOP_Data_Ref
Returns the assigned reference number to the data
GLOP row.
INTEGER NOT NULL
--,---,---,--9
GLOP_Pages
Returns the number of GLOP data pages associated
with the GLOP_Data_Ref.
INTEGER NOT NULL
--,---,---,--9
Data Dictionary
59
Chapter 1: Teradata Database Data Dictionary Overview
DBCExtension Tables
GLOP_Data
The GLOP_Data table describes the actual data to be mapped for a particular GLOP set
reference.
The following describes the columns of the GLOP_Data table.
Table Column Name
Description
Data Type
Format
GLOP_Data_Ref
(Composite UPI)
Returns the ID that is associated with this data
GLOP row.
INTEGER NOT
NULL
--,---,---,--9
GLOP_Page (Composite
UPI)
Returns the current GLOP data row assigned to
that page number.
INTEGER NOT
NULL
--,---,---,--9
Note the following:
• GLOP page numbers must start at one
• Only read-only GLOPs can have more than
one page
• All others allow only one GLOP page
DatabaseId (Composite
UPI)
Returns the database the set is associated with
(the owner of the set).
BYTE(4) NOT NULL
X(8)
GLOP_Disable
Returns one of the following values:
CHAR(1) LATIN
NOT CASESPECIFIC
NOT NULL
X(1)
INTEGER
--,---,---,--9
INTEGER NOT
NULL
--,---,---,--9
TIMESTAMP(6)
NOT NULL
YYYY-MMDDBHH:MI: SS
BLOB
X(2097088000)
• D = GLOP data is disabled
• E = GLOP data is enabled
GLOP_Ageing
Returns an aging value.
Note the following:
• This value applies to read mode GLOPs only
• Read/write GLOPs cannot be aged
• A NULL or 0 (zero) value indicates the GLOP
should never be aged
GLOP_Version
Returns a value that is incremented each time
the particular GLOP page is changed.
If the GLOP data is removed and added again,
the version number starts over from one (1).
Individual pages of a read-only GLOP may have
a different version number.
GLOP_Change_Date
Returns the last time the GLOP data was
changed.
Individual pages of a read-only GLOP may have
a different change date.
GLOP_Data
60
Returns the context defining the meaning of the
global memory for the current page.
Data Dictionary
Chapter 1: Teradata Database Data Dictionary Overview
Maintaining System Logs
Related Information
For information on the DBCExtension.GLOP_Add, DBCExtension.GLOP_Remove,
DBCExtension.GLOP_Change, and DBCExtension.GLOP_Report stored procedures that
provide user access to the tables, see SQL External Routine Programming.
Maintaining System Logs
The resource usage logs and the tables underlying the AMPUsage, AccessLog, LogOnOff, and
Software_Event_Log views are not purged automatically by the system.
Outdated information in these tables should be deleted periodically by an authorized user
such as a security, database administrator, or by Teradata support personnel.
Because the errors and events that comprise Software_Event_Log information are analyzed for
the purpose of enhancing the product, this information is often maintained by Teradata field
support personnel.
Purging Outdated Information
You must purge outdated AMPUsage information using the Teradata SQL DELETE statement.
You may also use the Teradata SQL DELETE statement to purge outdated DBQL information
from:
•
DBQLogTbl
•
DBQLObjTbl
•
DBQLExplainTbl
•
DBQLStepTbl
•
DBQLSqlTbl
•
DBQLSummaryTbl
•
TDWMEventLog
•
TDWMExceptionLog
•
TDWMSummaryLog
•
TDWMEventHistory
For example, the following statement could be used to purge information for account $M619
after an accounting period has closed.
DELETE FROM DBC.AMPUsageV
WHERE Accountname = ’$M619’;
A similar statement could be used to eliminate usage information after a user has been
dropped from the system.
LogOnOff information also should be purged periodically to reclaim disk space. For example,
the following statement purges LogOnOff information that is more than 90 days old:
DELETE FROM DBC.LogOnOffV
WHERE (DATE-Logdate) > 90;
Data Dictionary
61
Chapter 1: Teradata Database Data Dictionary Overview
Other System Objects
Log entries that are more than 30 days old may be deleted from the access log by using the
DeleteAccessLog view in the FROM clause of the DELETE statement, as follows.
DELETE FROM DBC.DeleteAccessLog ALL ;
If preferred, you can periodically archive the contents of system tables to backup storage such
as tape. This can be done, for example, using the BTEQ .EXPORT command, FastExport, or
an Backup Application Software solution.
For information on how to copy the data to user tables and do the copying and purging, see
Database Administration.
Other System Objects
The following system objects are not covered in detail in this manual:
Object
Reference for More Information
SysAdmin.Fastlog table
This internal table containing FastLoad information does not need
to be accessed directly by the user.
SystemFE database
SystemFE Macros
Resource Usage tables
Resource Usage Macros and Tables
Sys_Calendar database
SQL Data Types and Literals
Columns with Hex Unicode Constants
The columns listed in the following tables are stored with a CharType based on the system’s
support of Japanese Language (see “System Initializer Utility” in Utilities).
Constants are converted to the _Unicode’..’XC format if they would otherwise not be sharable
(see SQL Data Types and Literals).
62
Database Name
Table Name
Column Name
DBC
TableConstraints
TableCheck
DBC
TriggersTbl
CreateText
DBC
TVFields
ColumnCheck
DBC
TVM
CreateText
Data Dictionary
CHAPTER 2
Data Dictionary Views
This chapter serves as a reference for users of Data Dictionary views and consists of the
following:
•
A brief description of the various types of users who have access to the Data Dictionary
views that resides in database DBC.
•
An explanation of the kinds of Data Dictionary views - compatibility and UNICODE Data
Dictionary views.
•
A reference table describing the Data Dictionary views, the tables referenced by each view,
the columns selected by that view, and the typical user of that view.
•
A reference table that lists and describes all the columns referenced by the Data Dictionary
views in alphabetical order including the data type and format of each column.
Note: In general, column names are descriptive of the type of data referenced by that column.
Users of Data Dictionary Views
Many of the views in the Teradata Database Data Dictionary may be restricted to special types
of users, while others are accessible by all users. The ability to access Data Dictionary views is
controlled by granting of privileges by the database administrator. The following table defines
the information needs of various types of users:
Data Dictionary
This type of user …
Needs to know this information …
End user
• Objects to which the user has access
• Types of access available to the user
• Privileges the user has granted to other users
Supervisors
•
•
•
•
•
•
How to create and organize databases
How to monitor space usage
How to define new users
How to allocate privileges
How to create indexes
How to perform archiving operations
Teradata Database system
administrator
•
•
•
•
Performance
Status and statistics
Errors
Accounting
63
Chapter 2: Data Dictionary Views
Character Data in the Data Dictionary
This type of user …
Needs to know this information …
Teradata Database security
administrator
• Access logging rules generated by the execution of BEGIN
LOGGING statements
• Results of access checking events, logged as determined by the
access logging rules
Operations and Recovery
Control
Archive and recovery activities.
Character Data in the Data Dictionary
Character data in the Data Dictionary affects the following kinds of columns in system views:
•
Object Name
•
Text Strings
•
Other Character Data
Object Names
To make the Data Dictionary field definitions consistent across all Teradata platforms, the
following attributes apply to each object name:
•
All object name columns are VARCHAR(128) CHARACTER SET UNICODE.
•
The system limit for object names in the Data Dictionary remains 30 UNICODE
characters. Other restrictions on object names, such as the characters allowed, apply.
•
The default format for the object names is defined as X (128).
Text Strings
In the Data Dictionary, some character columns contain object names and other single-byte
or multibyte characters.
These columns are Unicode.
Other Character Data
The server character set of non-object name character fields in the Data Dictionary is Latin.
These fields can only contain single-byte characters from U+0020 to U+007F.
Compatibility System Views
The compatibility system views return the same result sets as they did in releases prior to
Teradata Database 12.0.
The compatibility system views export character data with the same properties. Object name
columns that are defined as VARCHAR (128) CHARACTER SET UNICODE in the
underlying system table need a conversion to be displayed as CHAR (30) CHARACTER SET
64
Data Dictionary
Chapter 2: Data Dictionary Views
Character Data in the Data Dictionary
LATIN/KANJI1 for backwards compatibility. A SQL translate function
(UNICODE_TO_LOCALE) and a cast function are used to convert the modified Unicode
fields to Kanji1/Latin based on the session character set and the current language support
mode (Japanese/Standard).
The size, type, and format of the object name columns are the same except for the following:
•
•
The data type is VARCHAR for the following columns:
•
DBQLogTbl.ErrorText
•
TDWMExceptionLog.ErrorText
•
TVFields.FieldFormat
The size of the following fields is as follows:
•
TVM.CreateText: 13000 characters
•
TVFields.FieldTitle: 256 characters
•
SW_Event_Log.Text: 1024 characters
•
SessionTbl.ExternalRoles: 1934 characters
•
DBQLogTbl.ErrorText: 1024 characters
•
TDWMExceptionLog.ErrorText: 1024 characters
Unicode System Views
Unicode system views access the Data Dictionary table information without any conversion.
Unlike the compatibility system views, in the Unicode system views, object name fields are
selected as Unicode strings without translation to Kanji1/Latin.
A Unicode view exists for each compatibility view in database DBC. This means that there is a
Unicode system view corresponding to each compatibility system view that does not access
object name columns from the Data Dictionary tables. These views have the same definition
for both the compatibility and Unicode system views and produce the same results.
All Unicode system views end with a suffix V or VX.
Example
REPLACE VIEW DBC.CSPSESSIONINFOV
AS SELECT
SESSIONNO,
HOSTNO,
SESSIONVPROC (NAMED STARTMBOX),
LOGONSOURCE
FROM DBC.SESSIONTBL;
Data Dictionary
65
Chapter 2: Data Dictionary Views
System Views Reference
Updatable Views
Based on the language support mode, a compatibility system view casts the object name to 30
fixed characters in the Latin or Kanji1 server character set. System tables cannot be updated
via the compatibility system views are now supported using the Unicode system views; users
have to change their processes previously referenced as compatibility system views to now
reference to corresponding Unicode views.
Privileges for the compatibility system views have been changed to read only and Insert/
Update/Delete/ Select privileges are granted under the following Unicode system views:
•
CollationsV
•
CharTranslationsV
•
HostsInfoV
DROP VIEW privilege is granted to DBC for the following Unicode system views:
•
SessionInfoV
•
ChildrenV
•
Database_Default_JournalsVX
System Views Reference
The following table lists all the views included in the database DBC and includes a brief
description of how the view is used, the referenced tables, and columns selected by that view.
You can view detailed information for a specific column in the view by using the index in this
book, or online by clicking on the blue hypertext link for column name in the system views
table, which automatically links you to that column description in the columns table.
The referenced columns in the table do not mean necessarily that the view definition
references the column (though sometimes it does), but rather that the value in the column
selected should correspond to a value in the column referenced in the table. It would be
meaningful to join the view and the referenced table based on the selected column and the
referenced column.
The "Columns Selected" in the table refers to the column names defined in the view definition.
The DBC.UserDB and DBC.OwnerDB system views are not covered in this section because
they are not usually referenced directly by users. These views are used only to join other
system tables and views (especially the X version of views).
66
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
AccessLog[V]
AccLogTbl
Displays, by row, the
results of a privilege
check performed in
response to a request.
Data Dictionary
User Type
Columns Selected
Referenced column(s)
Teradata
Database
security
administrator
LogDate
None
LogTime
None
LogonDate
None
LogonTime
None
LogicalHostId
None
IFPNo
None
SessionNo
None
UserName
AccLogTbl.UserName
AccountName
AccLogTbl.AccountName
OwnerName
AccLogTbl.OwnerName
AccessType
None
Frequency
None
EventCount
None
AccLogResult
None
DatabaseName
AccLogTbl.DatabaseName
TVMName
AccLogTbl.TVMName
ColumnName
AccLogTbl.ColumnName
StatementType
None
StatementText
None
QueryBand
None
ProxyUser
None
67
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
AccLogRules[V]
AccLogRuleTbl
Provides information
about logging rules that
are currently in effect on
the system.
Dbase
68
TVM
User Type
Columns Selected
Referenced column(s)
Teradata
Database
security
administrator
UserName
Dbase.DatabaseName
DatabaseName
Dbase.DatabaseName
TVMName
TVM.TVMName
AcrAlterFunction
None
AcrCheckPoint
None
AcrCreateDatabase
None
AcrCreateFunction
None
AcrCreateMacro
None
AcrCreateTable
None
AcrCreateUser
None
AcrCreateView
None
AcrCreateProcedure
None
AcrCreExtProcedure
None
AcrDelete
None
AcrDropDatabase
None
AcrDropFunction
None
AcrDropMacro
None
AcrDropTable
None
AcrDropUser
None
AcrDropView
None
AcrDropProcedure
None
AcrDump
None
AcrExecute
None
AcrExecuteFunction
None
AcrExecuteProcedure
None
AcrGrant
None
AcrIndex
None
AcrInsert
None
AcrReference
None
AcrRestore
None
AcrSelect
None
AcrUpdate
None
AcrCreateTrigger
None
AcrDropTrigger
None
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
AccLogRules[V]
(Continued)
AccLogRuleTbl
Dbase
TVM
User Type
Columns Selected
Referenced column(s)
Teradata
Database
security
administrator
AcrCreateRole
None
AcrDropRole
None
AcrCreateProfile
None
AcrDropProfile
None
AcrAlterProcedure
None
AcrRepControl
None
AcrAlterExtProcedure
None
AcrUDTUsage
None
AcrUDTType
None
AcrUDTMethod
None
AcrCreAuthorization
None
AcrDropAuthorization
None
AcrStatistics
None
AcrCreOwnerProcedure
None
AcrConnectThrough
None
CreatorName
Dbase.DatabaseName
CreateTimeStamp
None
AcrCreateGLOP
None
AcrDropGLOP
None
AcrGLOPMember
None
AcrShow
None
AccountInfo[V][X]
Accounts
Supervisory
UserName
Dbase.DatabaseName
Provides information
about valid accounts.
Dbase
Teradata
Database
administrator
AccountName
Accounts.AccountName
UserOrProfile
None
Profiles
[X]AccessRights
[X]End user
[X]Userdb
[X]Owners
Data Dictionary
69
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
AllRights[V][X]
AccessRights
Provides information
about all users who have
been explicitly or
automatically granted
privileges, and the
objects on which the
privileges were granted
including: databases,
users, tables, views,
stored procedures,
macros, user-defined
types, user-defined
methods, and userdefined functions.
Dbase
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
UserName
Dbase.DatabaseName
DatabaseName
Dbase.DatabaseName
TVM
TableName
TVM.TVMName
TVFields
ColumnName
TVFields.FieldName
[X]Roles
AccessRight
None
[X]RoleGrants
GrantAuthority
None
GrantorName
Dbase.DatabaseName
AllnessFlag
None
CreatorName
Dbase.DatabaseName
CreateTimeStamp
None
Teradata
Database
security
administrator
RoleName
Roles.RoleName
DatabaseName
Dbase.DatabaseName
TableName
TVM.TVMName
Teradata
Database
administrator
ColumnName
TVFields.FieldName
AccessRight
None
GrantorName
Dbase. DatabaseName
CreateTimeStamp
None
Vproc
None
DatabaseName
Dbase.DatabaseName
The AllRights view also
returns PUBLIC rights.
AllRoleRights[V]
Dbase
Lists all rights granted to
each role.
TVM
TVFields
Roles
AccessRights
Supervisory
AllSpace[V][X]
DatabaseSpace
Gives both database and
table space utilization.
Dbase
70
Teradata
Database
administrator
TVM
AccountName
Accounts.AccountName
[X]Roles
[X]End user
TableName
TVM.TVMName
[X]RoleGrants
Supervisory
MaxPerm
None
[X]AccessRights
MaxSpool
None
[X]Owners
MaxTemp
None
CurrentPerm
None
CurrentSpool
None
CurrentTemp
None
PeakPerm
None
PeakSpool
None
PeakTemp
None
MaxProfileSpool
None
MaxProfileTemp
None
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
AllTempTables[V][X]
TempTables
Provides information
about the local
temporary tables
materialized from the
base global temporary
tables.
Dbase
All_RI_Children[V][X]
ReferencingTbls
Provides information
about all tables in childparent order. It is similar
to the RI_Child_Tables
view, but returns the
names of databases,
tables, and columns,
instead of IDs.
Dbase
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
HostNo
SessionTbl.HostNo
SessionNo
SessionTbl.SessionNo
UserName
SessionTbl.DatabaseName
B_DatabaseName
Dbase.DatabaseName
B_TableName
TVM.TVMNameI
E_TableId
TVM.TVMId
IndexID
None
IndexName
ReferencingTbls.Reference
IdxName
TVFields
ChildDB
Dbase.DatabaseName
[X]Roles
ChildTable
TVM.TVMName
[X]RoleGrants
ChildKeyColumn
TVFields.FieldName
ParentDB
Dbase.DatabaseName
ParentTable
TVM.TVMName
ParentKeyColumn
TVFields.FieldName
InconsistencyFlag
None
CreatorName
Dbase.DatabaseName
CreateTimeStamp
None
IndexID
None
IndexName
ReferencedTbls.Reference
IdxName
TVFields
ParentDB
Dbase.DatabaseName
[X]Roles
ParentTable
TVM.TVMName
[X]RoleGrants
ParentKeyColumn
TVFields.FieldName
ChildDB
Dbase.DatabaseName
ChildTable
TVM.TVMName
ChildKeyColumn
TVFields.FieldName
InconsistencyFlag
None
CreatorName
Dbase.DatabaseName
CreateTimeStamp
None
TVM
SessionTbl
All users
TVM
All_RI_Parents[V][X]
ReferencedTbls
Provides information
about all tables in
parent-child order. It is
similar to the
RI_Parent_Tables view,
but returns the names of
databases, tables, and
columns, instead of IDs.
Dbase
Data Dictionary
[X]End user
All users
TVM
71
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
AMPUsage[V][X]
Acctg
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
AccountName
Acctg.AccountName
UserName
Acctg.DatabaseName
CPUTime
None
DiskIO
None
CPUTimeNorm
None
Vproc
None
VprocType
None
Model
None
DatabaseName
Dbase.DatabaseName
TVM
TVMName
TVM.TVMName
ArchiveLogging
ObjsTbl
LogLevel
None
CreatorName
None
CreateTimeStamp
None
DatabaseName
Dbase.DatabaseName
TableName
TVM.TVMName
TVM
EventNum
None
[X]Roles
Original_Database
Name
DBCAssociation.Original_
DatabaseName
Original_TableName
DBCAssociation.Original_
TVMName
Original_TableKind
None
Original_Version
None
Original_Protection
Type
None
Original_JournalFlag
None
Original_Creator
Name
DBCAssociation.Original_
CreatorName
Original_Comment
String
None
Gives CPU and I/O
accounting information
saved by the DBC.
ArchiveLoggingObjsV[X
]
Provides information
about tables that have
online archive active logs
and their online archive
logging levels.
Dbase
Association[V][X]
DBCAssociation
Retrieves information
about tables that have
been ported using the
Dump/Restore facility.
Dbase
[X]RoleGrants
72
All users
Operations
and Recovery
Control
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
Authorizations[V][X]
Dbase
Provides information
about an authorization.
TVM
CharSets[V]
User Type
Columns Selected
Referenced column(s)
Teradata
Database
Administrator
DatabaseName
DBC.DatabaseName
AuthorizationName
TVM.TVMName
AccessRights
AuthorizationId
TVM.TVMId
Owners
TableKind
None
Version
None
AuthorizationType
None
AuthorizationSub
Type
None
OSDomainName
None
OSUserName
None
Translation
End user
CharSetName
Translation.TranslateName
Translation
End user
CharSetName
Translation.TranslateName
CharSetId
None
InstallFlag
None
E2I
None
E2IUp
None
I2E
None
I2EUp
None
Child
Dbase.DatabaseName
Parent
Dbase.DatabaseName
CollName
CollationTbl.CollName
CollInstall
None
CollEqvClass
None
CollOrderCS
None
CollOrderUC
None
Returns the names
assigned to user-defined
character sets currently
installed on the database.
CharTranslations[V]
Shows hexadecimal
codes inserted by the
Teradata Database
system administrator to
form translation tables
that enable the Teradata
Database to store and
manipulate non-English
character sets.
Children[V][X]
Owners
Provides the names of all
the databases and users
with the names of their
parent.
Dbase
Collations[V]
CollationTbl
Provides definitions for
standard Swedish and
Norwegian collations as
well as custom collation
sequence definitions.
Data Dictionary
Supervisory
[X]AccessRights
[X]Userdb
End user
73
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
Columns[V][X]
TVFields
[X]End user
DatabaseName
Dbase.DatabaseName
Provides information
about the columns of
tables or views, the
parameters of stored
procedures, the
attributes of userdefined types, the
parameters of userdefined methods,
macros, and user defined
functions that the user
can access.
Dbase
Teradata
Database
administrator
TableName
TVM.TVMName
ColumnName
TVFields.FieldName
[X]Roles
ColumnFormat
TVFields.FieldName
[X]RoleGrants
ColumnTitle
None
[X]AccessRights
SPParameterType
None
[X]Owners
ColumnType
None
ColumnUDTName
TVFields.UDTName
ColumnLength
None
DefaultValue
None
Nullable
None
CommentString
None
DecimalTotalDigits
None
DecimalFractional
Digits
None
ColumnId
Accessrights.FieldId
TVM
ReferencingTbls.Foreign
KeyFID
ReferencedTbls.ParentKey
FID
Indexes.FieldId
74
UpperCaseFlag
None
Compressible
None
CompressValue
None
ColumnConstraint
TVFelds.ColumnCheck
ConstraintCount
None
CreatorName
Dbase.DatabaseName
CreateTimeStamp
None
LastAlterName
Dbase.DatabaseName
LastAlterTimeStamp
None
CharType
None
IdColType
None
AccessCount
None
LastAccessTimeStamp
None
CompressValueList
None
TimeDimension
None
VTCheckType
None
TTCheckType
None
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
ColumnStats[V]
TVFields
All users
DatabaseName
Dbase.DatabaseNameI
Displays statistics for the
columns in a table for
which statistics have
been collected.
Dbase
TableName
TVM.TVMNameI
TVM
ColumnName
TVFields.FieldName
ColumnType
None
ColumnLength
None
ColumnFormat
TVFields.FieldFormat
DecimalTotalDigits
None
DecimalFractional
Digits
None
FieldStatistics
None
SeqNumber
None
TrustUser
None
ProxyUser
None
ProxyUserType
None
GrantStatus
None
WithoutRole
None
ProxyRole1
None
ProxyRole2
None
ProxyRole3
None
ProxyRole4
None
ProxyRole5
None
ProxyRole6
None
ProxyRole7
None
ProxyRole8
None
ProxyRole9
None
ProxyRole10
None
ProxyRole11
None
ProxyRole12
None
ProxyRole13
None
ProxyRole14
None
ProxyRole15
None
CreatorName
None
CreateTimeStamp
None
TrustOnly
None
ConnectRules[V]
Dbase
Retrieves information
about CONNECT
THROUGH rules
generated as a result of
successfully processed
GRANT CONNECT
THROUGH statements.
ConnectRulesTbl
Data Dictionary
Teradata
Database
security
administrator
75
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
CostProfiles_V
CostProfileTypes
All users
ProfileTypeName
None
Provides the cost profile
instances available for
use by the Optimizer.
CostProfiles
ProfileName
None
ProfileId
None
ProfileCat
None
ProfileDesc
None
ProfileTypeName
None
ProfileTypeDesc
None
ProfileName
None
CostProfileTypes_V
CostProfileTypes
All users
Provides the name and
description for each cost
profile type.
CostProfileValues_V
CostProfiles
Provides values for
constants in a cost
profile instance.
ConstantDefs
ProfileId
None
ConstantValues
ConstName
None
ConstId
None
ConstCat
None
ConstVal
None
ConstDesc
None
SessionNo
None
HostNo
None
StartMBox
None
LogonSource
None
CSPSessionInfo[V]
(Reserved for internal
use.)
SessionTbl
All users
Operations
and Recovery
Control
Returns information on
crashdumps.
Databases[V][X]
Dbase
[X]End user
DatabaseName
DBase.DatabaseName
Provides information
about the databases that
the user can access.
[X]Roles
Teradata
Database
administrator
CreatorName
DBase.CreatorName
OwnerName
DBase.OwnerName
[X]AccessRights
AccountName
DBase.AccountName
[X]Userdb
ProtectionType
None
[X]Owners
JournalFlag
None
PermSpace
None
SpoolSpace
None
TempSpace
None
CommentString
None
CreateTimeStamp
None
LastAlterName
Dbase.DatabaseName
LastAlterTimeStamp
None
DBKind
None
AccessCount
None
LastAccessTimeStamp
None
76
[X]RoleGrants
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
Databases2[V][X]
Dbase
All users
DatabaseName
Dbase.DatabaseName
Provides ID definition
information about
databases.
[X]Roles
DatabaseId
Accounts.UserId
[X]RoleGrants
Databasespace.DatabaseId
Accessrights.UserId
Owners.OwnerId
TVM.DatabaseId
ReferencingTbls.
Referencing.DbId
DBCAssociation.
DatabaseId
Owners.OwneeId
ReferencedTbls.
ReferencedDbId
TableConstraints.DbaseId
Triggertbl.DatabaseId
Database_
Default_Journals[V][X]
Provides the name for
each database that has a
default journal table.
UnResolvedRICount
None
Dbase
[X]End user
DatabaseName
Dbase.DatabaseName
TVM
Teradata
Database
administrator
Journal_DB
DBase.DatabaseName
JournalName
TVM.TVMName
All users
InfoKey
None
InfoData
DBCInfoTbl.InfoData
[X]Roles
[X]RoleGrants
[X]AccessRights
[X]Owners
DBCInfo[V]
Provides information on
the current version and
release of the DBC. It is
updated during each
system restart.
Data Dictionary
DBCInfoTbl
77
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
DBQLRules[V]
Dbase
Displays the DBQL rules
in effect for users.
DBQRuleTbl
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
Username
Dbase.DatabaseName
AccountString
DBQLRuleTbl.AccountString
ApplName
None
TypeOfRule
None
ExplainFlag
None
ObjFlag
None
SqlFlag
None
StepFlag
None
SummaryFlag
None
XMLPlanFlag
None
ThresholdFlag
None
TextSizeLimit
None
SummaryVal1
None
SummaryVal2
None
SummaryVal3
None
TypeOfCriterion
None
Teradata
Database
security
administrator
LogDate
None
LogTime
None
Teradata
Database
administrator
LogicalHostId
None
SessionNumber
None
CoordTaskId
Dbase.DatabaseName
RunUnitId
None
LogonUserName
None
ResolvingUserLogon
Name
None
CommitOrRollback
None
UserLogonDate
None
UserLogonTime
Dbase.DatabaseName
CompletionDate
None
CompletionTime
None
Options
None
Supervisory
DeleteAccessLog[V]
AccLogTbl
Provides a means of
controlling deletion of
DBC.AccLogTbl. Only
rows older than 30 days
from the current date
can be deleted.
DeleteOldInDoubt[V]
Displays those rows in
the
DBC.InDoubtResLog
table that are more than
30 days old.
78
InDoubtResLog
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
DiskSpace[V][X]
DatabaseSpace
Provides AMP-by-AMP
information about disk
space usage, including
spool, for each database
or account.
Dbase
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
Vproc
None
DatabaseName
Dbase.DatabaseName
AccountName
DBase.AccountName
MaxPerm
None
[X]AccessRights
MaxSpool
None
[X]Userdb
MaxTemp
None
[X]Owners
CurrentPerm
None
CurrentSpool
None
CurrentTemp
None
PeakPerm
None
PeakSpool
None
PeakTemp
None
MaxProfileSpool
None
MaxProfileTemp
None
ErrTblDbName
None
ErrTblName
None
BaseTblDbName
None
BaseTblName
None
CreatorName
None
CreateTimeStamp
None
[X]Roles
[X]RoleGrants
ErrorTblsV[X]
TVM
Provides information on
relationships between
data and error tables
accessible to the current
user.
Dbase
Data Dictionary
ErrorTbls
[X]End user
Supervisory
Teradata
Database
administrator
[X]End user
Supervisory
79
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
Events[V][X]
RCEvent
Provides a row for each
execution of a Host
Utility function or of a
DBC/SQL checkpoint
statement.
[X]Roles
User Type
Columns Selected
Referenced column(s)
Operations
and Recovery
Control
CreateDate
None
CreateTime
None
EventNum
[X]Dbase
RCConfiguration.
EventNum
[X]AccessRights
RCMedia.EventNumber
[X]RoleGrants
EventType
None
UserName
RCEvent.UserName
DatabaseName
RCEvent.DatabaseName
ObjectType
None
AllAmpsFlag
None
RestartSeqNum
RCConfiguration.
RestartSeqNum
OperationInProcess
None
TableName
RCEvent.TableName
CheckpointName
None
LinkingEventNum
None
DataSetName
None
LockMode
None
JournalUsed
None
JournalSaved
None
IndexPresent
None
DupeDumpSet
RCMedia.DupeDumpSet
CreateDate
None
CreateTime
None
EventNum
[X]RoleGrants
RCConfiguration.Event
Num
[X]Dbase
RCMedia.EventNumber
[X]Userdb
[X]Owners
Events_Configuration[V][X]
Provides a row for each
execution of a Host
Utility function or of a
DBC/SQL checkpoint
statement, which was
executed on a subset of
the AMP processors.
80
RCEvent
RCConfiguration
[X]Roles
Operations
and Recovery
Control
[X]AccessRights
EventType
None
[X]Userdb
UserName
RCEvent.UserName
[X]Owners
LogProcessor
None
PhyProcessor
None
Vproc
None
ProcessorState
None
RestartSeqNum
None
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
Events_Media[V][X]
RCEvent
Provides a row for each
execution of a Host
Utility dump or restore
function, which created
or used removable
media.
RCMedia
User Type
Columns Selected
Referenced column(s)
Operations
and Recovery
Control
CreateDate
None
CreateTime
None
EventNum
[X]RoleGrants
RCConfiguration.
EventNum
[X]Dbase
RCMedia.EventNumber
[X]Roles
[X]AccessRights
[X]Userdb
[X]Owners
ExternalSPs[V][X]
UDFInfo
Extracts the External
Stored Procedures
(XSPs) from
DBC.UDFInfo table.
DBase
Data Dictionary
TVM
Teradata
Database
administrator
EventType
None
UserName
RCEvent.UserName
DataSetName
None
VolSerialId
None
VolSequenceNum
None
DupeDumpSet
None
DatabaseName
Dbase.DatabaseName
ExternalProcedure
Name
UDFInfo.FunctionName
ExternalProcedureId
TVM.TVMId
NumParameters
None
ExternalName
None
SrcFileLanguage
None
NoSQLDataAccess
None
ParameterStyle
None
ExecProtectionMode
None
ExtFileReference
None
CharacterType
None
Platform
None
RoutineKind
None
ParameterUDTIds
None
AuthIdUsed
TVM.AuthIdUsed
AppCategory
None
GLOPSetDatabaseName
None
GLOPSetMemberName
None
81
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
Functions[V][X]
UDFInfo
Contains all the function
information.
DBase
HostsInfo[V]
Provides information
about any user-defined
character sets assigned
by the Teradata Database
system administrator as
the default for the client
systems in the Teradata
Database configuration.
82
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
DatabaseName
Dbase.DatabaseName
FunctionName
None
SpecificName
TVM.TVMName
FunctionId
TVM.TVMId
NumParameters
None
ParameterDataTypes
None
FunctionType
None
ExternalName
UDFInfo.FunctionName
SrcFileLanguage
None
NoSQLDataAccess
None
ParameterStyle
None
DeterministicOpt
None
NullCall
None
PrepareCount
None
ExecProtectionMode
None
ExtFileReference
None
CharacterType
None
Platform
None
InterimFldSize
None
RoutineKind
None
ParameterUDTIds
None
AuthIdUsed
TVM.AuthIdUsed
MaxOutParameters
None
GLOPSetDatabaseName
None
GLOPSetMemberName
None
End user
LogicalHostId
None
Teradata
Database
administrator
HostName
None
DefaultCharSet
Hosts.DefaultCharSet
TVM
Hosts
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
IndexConstraints[V][X]
TableConstraints
End user
DatabaseName
Dbase.DatabaseName
Provides information for
index constraints
(implied by the
partitioning expressions
for an index).
[X]Roles
Teradata
Database
administrator
TableName
TVM.TVMName
IndexName
TableConstraints.Name
IndexNumber
Indexes.IndexNumber
ConstraintType
None
ConstraintText
None
ConstraintCollation
None
CollationName
None
CreatorName
None
CreateTimeStamp
None
CharSetID
None
SessionMode
None
VTCheckType
TableConstraints.VTCheck
Type
TTCheckType
TableConstraints.TTCheck
Type
ResolvedCurrent_Date
TableConstraints.Resolved
Current_Date
ResolvedCurrent_
TimeStamp
TableConstraints.Resolved
Current_TimeStamp
Data Dictionary
[X]RoleGrants
83
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
IndexStats[V]
Dbase
End user
DatabaseName
Dbase.DatabaseNameI
Displays statistics on the
indexes defined on a
table for which statistics
have been collected.
Indexes
Teradata
Database
administrator
TableName
TVM.TVMNameI
IndexNumber
None
IndexName
Indexes.Name
IndexType
None
UniqueFlag
None
ColumnPosition
None
ColumnName
TVFields.FieldName
ColumnType
None
ColumnLength
None
ColumnFormat
TVFields.FieldFormat
DecimalTotalDigits
None
DecimalFractional
Digits
None
IndexStatistics
None
UniqueOrPK
Indexes.UniqueOrPK
VTConstraintType
Indexes.VTConstraintType
TTConstraintType
Indexes.TTConstraintType
SystemDefinedJI
Indexes.SystemDefinedJI
TimeDimension
TVFields.TimeDimension
84
TVM
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
Indices[V][X]
Indexes
[X]End user
DatabaseName
Dbase.DatabaseName
Describes each of the
indexes on each table.
Dbase
Teradata
Database
administrator
TableName
TVM.TVMName
IndexNumber
None
TVFields
IndexType
None
[X]Roles
UniqueFlag
None
[X]RoleGrants
IndexName
Indexes.Name
[X]AccessRights
ColumnName
TVFields.FieldName
[X]Owners
ColumnPosition
None
CreatorName
Dbase.DatabaseName
CreateTimeStamp
None
LastAlterName
Dbase.DatabaseName
LastAlterTimeStamp
None
IndexMode
None
AccessCount
None
LastAccessTimeStamp
None
UniqueOrPK
Indexes.UniqueOrPK
VTConstraintType
Indexes.VTConstraintType
TTConstraintType
Indexes.TTConstraintType
SystemDefinedJI
Indexes.SystemDefinedJI
LogicalHostId
None
SessionNumber
None
CoordTaskId
None
RunUnitId
None
LogonUserName
Dbase.DatabaseName
ResolvingUserLogon
Name
Dbase.DatabaseName
CommitOrRollBack
None
UserLogonDate
None
UserLogonTime
None
CompletionDate
None
CompletionTime
None
Options
None
InDoubtLog[V]
Displays the contents of
the
DBC.InDoubtResLog
table.
Data Dictionary
TVM
InDoubtResLog
Teradata
Database
administrator
85
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
JoinIndicesV
Dbase
[X]End user
DataBaseName
DBase.DatabaseName
Joins DBC.Indexes with
DBC.TVM and
DBC.Databasename to
get the actual names of
the tables, join indexes,
and their databases.
TVM
Teradata
Database
administrator
TableName
TVM.TVMName
JoinIdxDataBaseName
None
JoinIdxName
None
IndexType
None
Journals[V][X]
Dbase
[X]End user
Tables_DB
Dbase.DatabaseName
Provides specific
information about
journal-to-table
mappings for each data
table that uses journal
protection.
TVM
Teradata
Database
administrator
TableName
TVM.TVMName
Journals_DB
Dbase.DatabaseName
JournalName
TVM.TVMName
LogOnOff[V][X]
EventLog
Teradata
Database
security
administrator
LogDate
None
LogTime
None
UserName
EventLog.UserName
Teradata
Database
administrator
AccountName
EventLog.AccountName
Event
None
LogicalHostId
None
Supervisory
IFPNo
None
SessionNo
None
LogonDate
None
LogonTime
None
LogonSource
None
UserName
Dbase.DatabaseName
LogicalHostID
None
LogonStatus
None
NullPassword
None
CreatorName
Dbase.DatabaseName
CreateTimeStamp
None
Indexes
[X]Roles
[X]RoleGrants
[X]AccessRights
[X]Owners
Gives the DBA access to
the session event table
that records logon,
logoffs, and attempted
logons.
LogonRules[V]
LogonRuleTbl
Retrieves information
about logon rules
generated as a result of
successfully processed
GRANT/REVOKE
LOGON statements.
Dbase
86
Teradata
Database
security
administrator
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
MultiColumnStats[V]
Indexes
End user
DatabaseName
Dbase.DatabaseNameI
Provides information
about statistics collected
on a set of non-indexed
columns.
TVM
Teradata
Database
administrator
TableName
TVM.TVMNameI
StatisticsId
None
ColumnPosition
None
ColumnName
TVFields.FieldName
ColumnType
None
ColumnLength
None
ColumnFormat
TVFields.FieldFormat
DecimalTotalDigits
None
DecimalFractional
Digits
None
ColumnsStatistics
None
ProfileName
Profiles.ProfileName
DefaultAccount
Profiles.DefaultAccount
DefaultDB
Profiles.DefaultDatabase
SpoolSpace
None
TempSpace
None
ExpirePassword
None
PasswordMinChar
None
PasswordMaxChar
None
PasswordDigits
None
PasswordSpecChar
None
PasswordRestrict
Words
None
MaxLogonAttempts
None
LockedUserExpire
None
PasswordReuse
None
CommentString
None
CreatorName
Dbase.DatabaseName
CreateTimeStamp
None
LastAlterName
Dbase.DatabaseName
LastAlterTimeStamp
None
Dbase
TVFields
ProfileInfo[V][X]
[X]Profiles
Lists all profiles and their
parameter settings.
[X]Dbase
Teradata
Database
administrator
[X]End user
Supervisory
Teradata
Database
security
administrator
Data Dictionary
87
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
QryLog[V]
DBQLogTbl
Specifies the main view
for DBQL.
88
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
ProcID
None
CollectTimeStamp
None
QueryID
None
UserID
None
UserName
None
DefaultDatabase
None
AcctString
None
ExpandAcctString
None
SessionID
None
LogicalHostID
None
RequestNum
None
InternalRequestNum
None
LogonDateTime
None
AcctStringTime
None
AcctStringHour
None
AcctStringDate
None
LogonSource
None
AppID
None
ClientID
None
ClientAddr
None
QueryBand
None
ProfileID
None
StartTime
None
FirstStepTime
None
FirstRespTime
None
ElapsedTime
None
NumSteps
None
NumStepswPar
None
MaxStepsInPar
None
NumResultRows
None
TotalIOCount
None
AMPCPUTime
None
ParserCPUTime
None
UtilityRowCount
None
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
QryLog[V]
(Continued)
DBQLogTbl
Data Dictionary
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
ErrorCode
None
ErrorText
None
WarningOnly
None
AbortFlag
None
CacheFlag
None
StatementType
None
StatementGroup
None
QueryText
None
NumOfActiveAMPs
None
MaxAmpCPUTime
None
MaxCPUAmpNumber
None
MinAmpCPUTime
None
MaxAmpIO
None
MaxIOAmpNumber
None
MinAmpIO
None
SpoolUsage
None
LSN
None
EstResultRows
None
EstProcTime
None
EstMaxRowCount
None
AMPCPUTimeNorm
None
ParserCPUTimeNorm
None
MaxAmpCPUTime
Norm
None
MaxCPUAmpNumber
Norm
None
MinAmpCPUTime
Norm
None
ParExpreqTime
None
ProxyUser
None
ProxyRole
None
SessionTemporal
Qualifier
None
89
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
QryLogEventHis[V]
TDWMEvent
history
Provides a means by
which an end user can
discover the sequence of
states and events that
occurred at any point in
time.
QryLogEvents[V]
Contains Teradata
Database events that
affect the Teradata
dynamic workload
management software.
90
TDWMEvent
Log
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
ProcID
None
CollectTimeStamp
None
EntryTS
None
EntryKind
None
EntryID
None
EntryName
None
EventValue
None
LastValue
None
Activity
None
ActivityId
None
ActivityName
None
ConfigId
None
SeqNo
None
Spare1
None
Spare2
None
Spare3
None
ProcID
None
CollectTimeStamp
None
SessionID
None
LogicalHostID
None
WDID
None
OpenvID
None
SysConID
None
EventTime
None
EventCode
None
EventSubCode
None
EventInfo
None
Teradata
Database
administrator
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
QryLogExceptions[V]
TDWM
ExceptionLog
Contains information
about logons or queries
rejected by the Teradata
dynamic workload
management software
snd actions taken by WD
exception handling.
QryLogExplain[V]
Contains the "Explain"
of the query. Since the
"Explain" can be larger
than 64KB, it may use
multiple rows to hold
the data.
Data Dictionary
DBQLExplain
Tbl
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
ProcID
None
CollectTimeStamp
None
QueryID
None
UserName
None
SessionID
None
RequestNum
None
LogicalHostID
None
AcctString
None
WDID
None
OpEnvID
None
SysConID
None
ClassificationTime
None
ExceptionTime
None
ExceptionValue
None
ExceptionAction
None
NewWDID
None
ExceptionCode
None
ExceptionSubCode
None
ErrorText
None
ExtraInfo
None
RuleID
None
WarningOnly
None
RejectionCat
None
ProcID
None
CollectTimestamp
None
Query ID
None
ExpRowNo
None
ExplainText
None
Teradata
Database
administrator
91
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
QryLogObjects[V]
DBQLObjTbl
Populated if object
information is requested
for the query in addition
to the default
information row.
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
ProcID
None
CollectTimeStamp
None
QueryID
None
ObjectDatabaseName
None
ObjectTableName
None
ObjectColumnName
None
ObjectID
None
ObjectNum
None
ObjectType
None
FreqofUse
None
TypeofUse
None
ProcID
None
CollectTimeStamp
None
QueryID
None
SqlRowNo
None
SqlTextInfo
None
ProcID
None
CollectTimestamp
None
QueryID
None
StepLev1Num
None
StepLev2Num
None
StepName
None
StepStartTime
None
StepStopTime
None
ElapsedTime
None
EstProcTime
None
EstCPUCost
None
CPUTime
None
IOcount
None
EstRowCount
None
RowCount
None
RowCount2
None
A row for each object
(database, table, column,
or index) is used. If the
object is a secondary
index, its number and
use are logged.
QryLogSQL[V]
DBQLSQLTbl
Populated if the SQL is
requested for the query
in addition to the default
information row. If the
additional SQL text is
greater than 64KB,
multiple rows are
generated.
QryLogSteps[V]
Populated by step-level
information. If the stepinformation of the query
is requested, a step table
is populated with a row
for each step.
92
DBQLStepTbl
Teradata
Database
administrator
Teradata
Database
administrator
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
QryLogSteps[V]
(Continued)
DBQLStepTbl
Data Dictionary
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
NumOfActiveAMPs
None
MaxAmpCPUTime
None
MaxCPUAmpNumber
None
MinAmpCPUTime
None
MaxAmpIO
None
MaxIOAmpNumber
None
MinAmpIO
None
SpoolUsage
None
MaxAMPSpool
None
MaxSpoolAmpNumber
None
MinAMPSpool
None
StepWD
None
LSN
None
UtilityTableID
None
RowsWComprColumns
None
EstIOCost
None
EstNetCost
None
EstHRCost
None
CPUTimeNorm
None
MaxAmpCPUTime
Norm
None
MaxCPUAmp
NumberNorm
None
MinAmpCPUTime
Norm
None
93
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
QryLogSummary[V]
DBQLSummary
Tbl
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
ProcID
None
CollectTimeStamp
None
UserID
None
AcctString
None
For the summary case, a
row exists for each
collection if the count of
queries run in the 10minute interval
(LowHist to HighHist) is
greater than 0.
LogicalHostID
None
AppID
None
ClientID
None
ClientAddr
None
ProfileID
None
For threshold, one row
(with LowHist=
ThreshValue and
HighHist=0) exists for
the collection if there
were queries shorter
than LowHist seconds.
SessionID
None
QueryCount
None
ValueType
None
QuerySeconds
None
AverageTime
None
TotalIOCount
None
AverageIO
None
AMPCPUTime
None
AverageAmpCPU
None
ParserCPUTime
None
AverageParserCPU
None
AMPCPUTimeNorm
None
AverageAmpCPU
Norm
None
ParserCPUTime
Norm
None
AverageParserCPU
Norm
None
LowHist
None
HighHist
None
Populated only if
summary information is
requested or a threshold
value is used.
94
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
QryLogTDWM[V]
DBQLogTbl
Displays a subset of the
DBC.DBQLogTbl fields.
In addition to the
general identification
fields, only fields that are
connected with the
Teradata dynamic
workload management
software are displayed.
Data Dictionary
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
ProcID
None
CollectTimeStamp
None
QueryID
None
UserID
None
UserName
None
DefaultDatabase
None
AcctString
None
LastStateChange
None
DelayTime
None
WDDelayTime
None
WDID
None
OpEnvID
None
SysConID
None
LSN
None
NoClassification
None
WDOverride
None
SLGMet
None
ExceptionValue
None
FinalWDID
None
TDWMEstMaxRows
None
TDWMEstLastRows
None
TDWMEstTotalTime
None
TDWMAllAmpFlag
None
TDWMConfLevelUsed
None
StatementGroup
None
95
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
QryLogTDWMSum[V]
TDWMSummary
Log
Contains a summary of
the activity of each WD
over a user-defined
interval.
QryLogXMLV
Allows users to access the
XML query plan.
96
DBQLXMLTbl
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
ProcID
None
CollectTimeStamp
None
WDID
None
OpEnvID
None
SysConID
None
StartColTime
None
Arrivals
None
ActiveCount
None
Completions
None
MinRespTime
None
MaxRespTime
None
AvgRespTime
None
MinCPUTime
None
MaxCPUTime
None
AvgCPUTime
None
DelayedCount
None
AvgDelayTime
None
ExceptionAbCount
None
ExceptionMvCount
None
ExceptionCoCount
None
ExceptionCount
None
MetSLGCount
None
AbortCount
None
OtherCount
None
ErrorCount
None
RejectedCount
None
MovedInCount
None
IntervalDelayCnt
None
DelayedQueries
None
ProcID
None
CollectTimeStamp
None
QueryID
None
XMLRowNo
None
XMLTextInfo
None
Teradata
Database
administrator
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
RCC_Configuration[V][
X]
RCConfiguration
Provides a row for each
execution of a Host
Utility function or of a
Teradata SQL
checkpoint statement,
which was executed on a
subset of the AMP
processors.
User Type
Columns Selected
Referenced column(s)
Operations
and Recovery
Control
EventNum
RCEvent.EventNum
LogProcessor
None
[X]RoleGrants
PhyProcessor
None
[X]Dbase
Vproc
None
[X]AccessRights
ProcessorState
None
[X]Userdb
RestartSeqNum
None
EventNum
RCMediaEventNumber
VolSerialId
None
[X]RoleGrants
VolSequenceNum
None
[X]Dbase
DupeDumpSet
None
OrderNumber
None
DatabaseName
None
TableName
None
CheckTableOption
None
ProcessOffline
None
ReconfigId
None
Description
None
ReconfigType
None
BeginTimeStamp
None
EndTimeStamp
None
BeginRedistTime
Stamp
None
EndRedistTimeStamp
None
BeginDelTimeStamp
None
EndDelTimeStamp
None
Status
None
CurrByteCount
None
CurrTabRedistCount
None
CurrTabDeleteCount
None
[X]Roles
[X]Owners
RCC_Media[V][X]
RCMedia
Provides a row for each
execution of a Host
Utility dump or restore
function that created or
used removable media.
[X]Roles
Operations
and Recovery
Control
[X]AccessRights
[X]Userdb
[X]Owners
ReconfigDeleteOrderV
Provides the end user a
way to access the
ReconfigDeleteOrderTbl
table.
ReconfigInfoV
Provides status and
summary information
for Reconfig.
Data Dictionary
ReconfigDelete
OrderTbl
ReconfigInfoTbl
All users
All users
97
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
ReconfigInfoV
(Continued)
ReconfigInfoTbl
All users
EstRemainRedistSecs
None
EstRemainDeleteSecs
None
AddAmpCount
None
DelAmpCount
None
MovAmpCount
None
ModAmpCount
None
NodeCount
None
TotTaskCount
None
TotTableCount
None
TotByteCount
None
TotCatchUpByteCount
None
TotJournalByteCount
None
ActualRedistSecs
None
ActualDeleteSecs
None
EstRedistSecs
None
EstDeleteSecs
None
BeginCalcHBTime
Stamp
None
EndCalcHBTimeStamp
None
BeginWrSpaceTime
Stamp
None
EndWrSpaceTime
Stamp
None
BeginPHBNewTime
Stamp
None
EndPHBNewTime
Stamp
None
BeginFBHBNewTime
Stamp
None
EndFBHBNEWTime
Stamp
None
BeginWrPHBTime
Stamp
None
EndWrPHBTime
Stamp
None
BeginWrFBHBTime
Stamp
None
98
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
ReconfigInfoV
(Continued)
ReconfigInfoTbl
All users
EndWrFBHBTime
Stamp
None
BeginWrCfgTime
Stamp
None
EndWrCfgTimeStamp
None
BeginWrCfgNewTime
Stamp
None
EndWrCfgNewTime
Stamp
None
EndWrBkupIdTime
Stamp
None
BeginWrBMTime
Stamp
None
EndWrBMTimeStamp
None
BeginDelHBNewTime
Stamp
None
BeginWrBkupIdTime
Stamp
None
EndDelHBNewTime
Stamp
None
BeginVProcCfgTime
Stamp
None
EndVProcCfgTime
Stamp
None
OrderNumber
None
DatabaseName
None
TableName
None
ProcessOffline
None
ReconfigRedistOrderV
Provides the end user a
way to access the
ReconfigRedistOrderTbl
table.
Data Dictionary
ReconfigRedist
OrderTbl
All users
99
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
ReconfigTableStatsV
ReconfigTable
StatsV
Provides statistics
collected on each table
during the
Redistribution Phase
and the Deletion Phase
of a Reconfiguration.
100
User Type
Columns Selected
Referenced column(s)
All users
DatabaseName
None
TableName
None
ReconfigId
None
Phase
None
Status
None
BeginTimeStamp
None
EndTimeStamp
None
TotRowCount
None
TotByteCount
None
TotCPUSecs
None
TotIOCount
None
LowRowCount
None
LowRowCountAmp
None
HighRowCount
None
HighRowCountAmp
None
LowByteCount
None
LowByteCountAmp
None
HighByteCount
None
HighByteCountAmp
None
LowCPUSecsCount
None
LowCPUSecsCountAmp
None
HighCPUSecsCount
None
HighCPUSecsCount
Amp
None
LowIOCount
None
LowIOCountAmp
None
HighIOCount
None
HighIOCountAmp
None
NUSICount
None
FallBackFlag
None
DBlockSize
None
PartitionCount
None
ActualRedistSecs
None
ActualDeleteSecs
None
EstRedistSecs
None
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
ReconfigTableStatsV
(Continued)
ReconfigTable
StatsV
RepCaptureRulesV
RepRulesetTbl
Provides information
regarding all replication
capture rules defined in
the system.
RepGroup
RepTables[V][X]
RepGroup
Returns all the
replication groups
defined in the system
and all their member
tables.
TVM
ResolvedDTSV[X]
DBase
Returns the last
reconciled date and
timestamp associated
with a table or join
index.
TVM
Data Dictionary
User Type
Columns Selected
Referenced column(s)
All users
EstDeleteSecs
None
FSGIOCount
None
FSysReadCount
None
FSysWriteCount
None
FSysMiscCount
None
MsgRcvCount
None
MsgSendCount
None
MsgMiscCount
None
MsgWaitRcvTime
None
MsgWaitSendTime
None
MsgWaitMiscTime
None
NoMemFlushCount
None
CkptFlushCount
None
RuleSetName
RepRuleSetTbl.RuleSetName
GroupName
RepGroup.GroupName
ObjectKind
None
DefaultOpt
None
LikePattern
None
LikeEscape
None
NotLikePattern
None
NotLikeEscape
None
GroupName
RepGroup.GroupName
TableName
TVM.TVMName
ResolvedCurrent_Date
None
ResolvedCurrent_
TimeStamp
None
TableName
None
DatabaseName
None
All users
All users
[X]Roles
[X]RoleGrants
TableConstraints
All users
101
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
RestrictedWords[V]
User Type
Columns Selected
Referenced column(s)
Password
Restrictions
All users
RestrictedWord
None
RI_Child_Tables[V][X]
ReferencingTbls
All users
IndexID
None
The RI_Child_Tables
view provides
information about tables
in child-parent order. It
is similar to the
DBC.All_RI_Children
view but returns the
internal IDs of
databases, tables, and
columns instead of
names.
Dbase
IndexName
ReferencingTbls.Reference
IdxName
ChildDbID
Dbase.DatabaseId
ChildTID
TVM.TVMId
Returns a list of words
that can be restricted
from being part of a
password string.
For a complete list of
restricted words, see
Security Administration.
[X]Roles
[X]RoleGrants
TVFields.TableId
ChildKeyFID
TVFields.FieldId
ParentDbID
Dbase.DatabaseId
ParentTID
TVM.TVMId
TVFields.TableId
RI_Distinct_
Children[V][X]
Provides information
about tables in childparent order without the
duplication that could
result from multicolumn foreign keys.
102
ParentKeyFID
TVFields.FieldId
InconsistencyFla
None
CreatorName
Dbase.DatabaseName
CreateTimeStamp
ReferencingTbls.CreateTimeS
tamp
VTFKType
ReferencingTbls.VTFKType
TTFKType
ReferencingTbls.TTFKType
VTPKType
ReferencingTbls.VTPKType
TTPKType
ReferencingTbls.TTPKType
IndexID
None
IndexName
ReferencingTbls.Reference
IdxName
[X]Roles
ChildDB
Dbase.DatabaseName
[X]RoleGrants
ChildTable
TVM.TVMName
ParentDB
Dbase.DatabaseName
ParentTable
TVM.TVMName
InconsistencyFlag
None
CreatorName
Dbase.DatabaseName
CreateTimeStamp
None
ReferencingTbls
Dbase
All users
TVM
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
RI_Distinct_Parents[V][
X]
ReferencingTbls
All users
IndexID
None
IndexName
ReferencedTbls.Reference
IdxName
ParentDB
Dbase.DatabaseName
ParentTable
TVM.TVMName
ChildDB
Dbase.DatabaseName
ChildTable
TVM.TVMName
InconsistencyFlag
None
CreatorName
Dbase.DatabaseName
CreateTimeStamp
None
IndexID
None
IndexName
ReferencedTbls.Reference
IdxName
ParentDbID
Dbase.DatabaseId
ParentTID
TVM.TVMId
Provides information
about tables in parentchild order without the
duplication that could
result from multicolumn foreign keys.
Dbase
TVM
[X]Roles
[X]RoleGrants
RI_Parent_Tables[V][X]
ReferencingTbls
Provides information
about all tables in
parent-child order.
Dbase
All users
[X]Roles
[X]RoleGrants
TVFields.TableId
ParentKeyFID
TVFields.FieldId
ChildDbID
Dbase.DatabaseId
ChildTID
TVM.TVMId
TVFields.TableId
RoleInfo[V][X]
DBase
Returns the names of
role creators
corresponding to each
role.
Roles
Data Dictionary
ChildKeyFID
TVFields.FieldId
InconsistencyFlag
None
CreatorName
Dbase.DatabaseName
CreateTimeStamp
ReferencedTbls.CreateTimeSt
amp
VTPKType
ReferencedTbls.VTPKType
TTPKType
ReferencedTbls.TTPKType
VTFKType
ReferencedTbls.VTFKType
TTFKType
ReferencedTbls.TTFKType
Teradata
Database
security
administrator
RoleName
Roles.RoleName
CreatorName
DBase.DatabaseName
CommentString
None
[X]End user
CreateTimeStamp
None
ExtRole
None
103
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
RoleMembers[V][X]
[X]Dbase
Lists each role and all of
its members.
[X]Roles
Note: The
RoleMemberX view does
not have the Grantee and
GranteeKind columns.
SecurityDefaults[V]
[X]RoleGrants
SysSecDefaults
Describes the password
features selected on the
site.
SecurityLog[V][X]
AccLogTbl
Provides access to the
DBC.AccLogTbl. Rows
are logged as directed by
BEGIN/END
LOGGING.
[X]Dbase
104
[X]Owners
[X]Userdb
User Type
Columns Selected
Referenced column(s)
Teradata
Database
security
administrator
RoleName
Roles.RoleName
Grantee
DBase.DatabaseName
Granteekind
None
[X]End user
Grantor
DBase.DatabaseName
WhenGranted
None
DefaultRole
None
WithAdmin
None
ExpirePassword
None
PasswordMinChar
None
PasswordMaxChar
None
PasswordDigits
None
PasswordSpecChar
None
PasswordRestrictWords
None
MaxLogonAttempts
None
LockedUserExpire
None
PasswordReuse
None
LogDate
None
LogTime
None
LogType
None
UserName
Dbase.DatabaseName
AccountName
None
DatabaseName
Dbase.DatabaseName
TableName
TVM.TVMName
Text
None
Teradata
Database
security
administrator
Teradata
Database
security
administrator
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
SessionInfo[V][X]
SessionTbl
Gives one row for each
time the user is logged
on; used as a review of
accounts set by user.
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
UserName
SessionTbl.UserName
AccountName
SessionTbl.AccountName
SessionNo
Temptables.SessionNo
DefaultDataBase
SessionTbl.CurrentDataBase
IFPNo
None
Partition
None
LogicalHostId
None
HostNo
TempTables.HostNo
CurrentCollation
None
LogonDate
None
LogonTime
None
LogonSequenceNo
None
LogonSource
None
ExpiredPassword
None
TwoPCMode
None
Transaction_Mode
None
CurrentRole
SessionTbl.CurrentRole
ProfileName
SessionTbl.ProfileName
LogonAcct
SessionTbl.LogonAcct
LDAP
None
AuditTrailId
SessionTbl.AuditTrailId
CurIsolationLevel
None
QueryBand
None
ProxyUser
None
ProxyCurRole
None
TemporalQualifier
None
Teradata
Database
security
administrator
Supervisory
[X]End user
ShowColChecks[V][X]
TVFields
End user
DatabaseName
Dbase.DatabaseName
Provides information
about column
constraints.
Dbase
Teradata
Database
administrator
TableName
TVM.TVMNameI
ColumnName
TVFields.FieldName
[X]Roles
ColCheck
TVFields.ColumnCheck
[X]RoleGrants
CreatorName
Dbase.DatabaseNameI
CreateTimeStamp
TVFields.CreateTimeStamp
TimeDimension
TVFields.TimeDimension
VTCheckType
TVFields.VTCheckType
TTCheckType
TVFields.TTCheckType
Data Dictionary
TVM
105
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
ShowTblChecks[V][X]
TableConstraints
End user
DatabaseName
Dbase.DatabaseName
Provides information
about table constraints.
Dbase
Teradata
Database
administrator
TableName
TVM.TVMNameI
CheckName
TableConstraints.Name
[X]Roles
TblCheck
TableConstraints.TableCheck
[X]RoleGrants
CreatorName
Dbase.DatabaseNameI
CreateTimeStamp
TableConstraint.CreateTimeS
tamp
VTCheckType
TableConstraints.VTCheck
Type
TTCheckType
TableConstraints.TTCheck
Type
ResolvedCurrent_Date
TableConstraints.Resolved
Current_Date
ResolvedCurrent_
TimeStamp
TableConstraints.Resolved
Current_TimeStamp
TheDate
None
TheTime
None
Event_Tag
None
Category
None
Severity
None
PMA
None
Vproc
None
Partition
None
Task
None
TheFunction
None
SW_Version
None
Line
None
Text
None
Software_Event_Log[V]
Provides information
about logged software
events originating in the
Parallel Data Extensions
(PDE) or the Teradata
Database.
106
TVM
SW_Event_Log
Operations
and Recovery
Control
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
Table_Level
Constraints[V][X]
TableConstraints
End user
DatabaseName
Dbase.DatabaseName
Dbase
Teradata
Database
administrator
TableName
TVM.TVMName
ConstraintName
TableConstraints.Name
[X]Roles
ConstraintText
None
[X]RoleGrants
CreatorName
Dbase.DatabaseName
CreateTimeStamp
None
VTCheckType
TableConstraints.VTCheck
Type
TTCheckType
TableConstraints.TTCheck
Type
ResolvedCurrent_Date
TableConstraints.Resolved
Current_Date
ResolvedCurrent_
TimeStamp
TableConstraints.Resolved
Current_TimeStamp
Provides information
about table constraints.
Data Dictionary
TVM
107
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
Tables[V][X]
TVM
[X]End user
DatabaseName
Dbase.DatabaseName
Provides information
about tables, views,
stored procedures, join
indexes, macros, userdefined types, userdefined methods, or user
defined functions.
Dbase
Teradata
Database
administrator
TableName
TVM.TVMName
Version
None
[X]RoleGrants
TableKind
None
[X]AccessRights
ProtectionType
None
[X]Owners
JournalFlag
None
CreatorName
Dbase.DatabaseName
TVM.CreatorName
RequestText
None
CommentString
None
ParentCount
TVM.ParentCount
ChildCount
TVM.ChildCount
NamedTblCheck
Count
None
UnnamedTblCheck
Exist
None
PrimaryKeyIndexId
None
RepStatus
TVM.TblStatus
CreateTimeStamp
TVM.CreateTimeStamp
LastAlterName
None
LastAlterTimeStamp
None
RequestTxtOverFlow
None
AccessCount
None
LastAccessTimeStamp
None
UtilVersion
None
QueueFlag
None
CommitOpt
None
TransLog
None
CheckOpt
None
TemporalProperty
TVM.TemporalProperty
ResolvedCurrent_Date
TVM.ResolvedCurrent_Date
ResolvedCurrent_
Timestamp
TVM.ResolvedCurrent_
Timestamp
SystemDefinedJI
TVM.SystemDefinedJI
VTQualifier
TVM.VTQualifier
TTQualifier
TVM.TTQualifier
108
[X]Roles
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
Tables2[V][X]
TVM
Provides ID definition
information about
tables. It is similar to the
Tables view but includes
the ID of the table and
database instead of the
other information (for
example, Version and
TableKind), provided by
the Tables view.
[X]Roles
[X]RoleGrants
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
TVMName
TVM.TVMNameI
TVMId
AcclogRuleTbl.TVMId
DatabaseSpace.tableId
Supervisory
Accessrights.TVMId
Temptables.BaseTableId
ReferencingTbls.ReferencingTblId
ReferencedTbls.ReferencedTblId
DBCAssociation.TVMId
TVFields.TableId
Dbase.JournalId
Indexes.TableId
Tableconstraints.TVMId
DatabaseId
Accessrights.DatabaseId
Owners.owneeId
Dbase.DatabaseId
ParentCount
None
ChildCount
None
TableSize[V][X]
DataBaseSpace
[X]End user
Vproc
None
Provides AMP-by AMP
information about disk
space usage, excluding
spool, for any database,
data table, journal table,
or account the user can
access.
Dbase
Teradata
Database
administrator
DatabaseName
Dbase.DatabaseName
AccountName
DBase.AccountName
[X]Roles
TableName
TVM.TVMName
[X]RoleGrants
CurrentPerm
None
[X]AccessRights
PeakPerm
None
TVM
[X]Owners
TableText[V][X]
DBase
[X]End user
DatabaseName
Dbase.DatabaseName
Provides complete
RequestText for an
object.
TVM
Teradata
Database
administrator
TableName
TVM.TVMName
TableKind
None
[X]Roles
RequestText
None
[X]RoleGrants
LineNo
None
TextTbl
[X]AccessRights
[X]Owners
Data Dictionary
109
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
Triggers[V][X]
TriggersTbl
Provides information
about event-driven,
specialized procedures
attached to a single table
and stored in the
database.
Dbase
User Type
Columns Selected
Referenced column(s)
Teradata
Database
administrator
DatabaseName
Dbase.DatabaseName
SubjectTable
DatabaseName
Dbase.DatabaseName
TableName
TVM.TVMName
TriggerName
TriggersTbl.TriggerName
EnabledFlag
None
ActionTime
None
Event
None
Kind
None
OrderNumber
None
TriggerComment
None
RequestText
None
CreatorName
Dbase.DatabaseName
CreateTimeStamp
None
LastAlterName
Dbase.DatabaseName
LastAlterTimeStamp
None
AccessCount
None
LastAccessTimeStamp
None
CreateTxtOverflow
None
VTEventType
TriggersTbl.VTEventType
TTEventType
TriggersTbl.TTEventType
DatabaseName
Dbase.DatabaseName
TVM
[X]Roles
[X]RoleGrants
UserGrantedRights[V]
AccessRights
Describes the explicit
rights that the user has
granted to other users.
Dbase
TableName
TVM.TVMName
TVM
ColumnName
TVFields.FieldName
TVFields
Grantee
Dbase.DatabaseName
Ownerdb
AccessRight
None
GrantAuthority
None
AllnessFlag
None
CreatorName
Dbase.DatabaseName
CreateTimeStamp
None
110
End user
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
UserRights[V]
AccessRights
End user
DatabaseName
Dbase.DatabaseName
Describes the explicit
rights of each user for
access to tables, views,
join indexes, stored
procedures, macros,
user-defined types, userdefined methods, or
user-defined functions.
Dbase
TableName
TVM.TVMName
TVM
ColumnName
TVFields.FieldName
TVFields
AccessRight
None
Userdb
GrantAuthority
None
GrantorName
Dbase.DatabaseNameI
CreatorName
Dbase.DatabaseName
CreateTimeStamp
None
RoleName
Roles.RoleName
UserRoleRights[V]
Dbase
Lists all rights granted to
each role for the user.
TVM
DatabaseName
Dbase.DatabaseName
TVFields
TableName
TVM.TVMName
Roles
ColumnName
TVFields.FieldName
AccessRights
AccessRight
None
GrantorName
Dbase.DatabaseName
CreateTimeStamp
None
Data Dictionary
End user
111
Chapter 2: Data Dictionary Views
System Views Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
Users[V]
Dbase
End user
UserName
DbaseDatabaseName
Describes in detail all
information about users
that you control,
including passwords.
AccessRights
Teradata
Database
administrator
CreatorName
DbaseCreatorName
PasswordLastMod
Date
None
PasswordLastMod
Time
None
OwnerName
Dbase.OwnerName
PermSpace
None
SpoolSpace
Dbase.SpoolSpace
Userdb
Owners
Supervisory
Profiles
Profiles.SpoolSpace
TempSpace
Dbase.TempSpace
Profiles.TempSpace
Users[V]
(Continued)
None
JournalFlag
None
StartupString
RCEvent.DatabaseName
DefaultAccount
Dbase.AccountName
DefaultDatabase
Dbase.DefaultDatabase
CommentString
None
DefaultCollation
None
PasswordChgDate
Dbase.PasswordChgDate
LockedDate
None
LockedTime
None
LockedCount
None
TimeZoneHour
None
TimeZoneMinute
None
DefaultDateForm
None
CreateTimeStamp
None
LastAlterName
Dbase.DatabaseName
Dbase
End user
LastAlterTimeStamp
None
AccessRights
Teradata
Database
administrator
DefaultCharType
None
RoleName
DBase.RoleName
ProfileName
DBase.ProfileName
AccessCount
None
LastAccessTimeStamp
None
Userdb
Owners
Profiles
112
ProtectionType
Supervisory
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
View Name and
Description
Referenced
Tables and Views
User Type
Columns Selected
Referenced column(s)
User_Default_
Journals[V][X]
Dbase
[X]End user
UserName
Dbase.DatabaseName
TVM
Teradata
Database
administrator
Journal_DB
Dbase.DatabaseName
JournalName
TVM.TVMName
Describes the users that
have default journal
tables, including the
name and database for
each journal table.
AccessRights
Owners
[X]Roles
[X]RoleGrants
System Views Columns Reference
The following table describes the columns of each of the system views in the DBC in
alphabetical order. In addition, each includes information on which views select that column,
and the data type and format of the column.
Some column formats are “explicit”; others are not. The following explains what “explicit”
means, and what it means when this term is not specified.
"Explicit" means the format string is explicitly specified during the view creation or from an
explicit format of the underlying table. When "explicit" is not specified, the format is taken
from the default format for the data type for the underlying table column or default format
for the data type of the view column if the format for the view column does not come from a
single underlying table column. If “explicit” is specified, the specified format is used; if it is not
specified, the format is based on the default format for a data type (which may be configured
for a system to have a different default format than the one given in the following).
Using the information included in the view columns table, you can write a SELECT statement
that returns the information you want.
Note: The 128 character object name limit is reserved for future expansion as the internal
representation of a name is still limited to 30 characters in the Latin and Kanji1 server
character sets. See the "Names" topic in SQL Fundamentals for additional information.
This note applies to all the following tables.
Data Dictionary
113
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AbortCount
Returns the number of queries that finished in this WD in this interval (dashboard or
logging) with an error code of 0 or 3156 and an abort flag.
Note: Dashboard interval is used for the API data, and logging interval is used for logging
data to the disk.
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Column Name
Description
AbortFlag
Returns an indicator if this query was aborted.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
CHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
QryLog
QryLogV
Column Name
Description
AccessCount
Returns the access count for the corresponding database object.
Data Type
114
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
Columns[X]
Databases[X]
Indices[X]
Tables[X]
Users
Triggers[X]
ColumnsV[X]
DatabasesV[X]
IndicesV[X]
TablesV[X]
UsersV
TriggersV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AccessRight
Returns a code that identifies a privilege granted on the object. Possible values for privilege
type are as follows:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Data Dictionary
AE
AF
AP
AS
CA
CD
CE
CF
CG
CM
CO
CP
CR
CT
CU
CV
D
DA
DD
DF
DG
DM
DO
DP
DR
DT
DU
DV
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
ALTER EXTERNAL PROCEDURE
ALTER FUNCTION
ALTER PROCEDURE
ABORT SESSION
CREATE AUTHORIZATION
CREATE DATABASE
CREATE EXTERNAL PROCEDURE
CREATE FUNCTION
CREATE TRIGGER
CREATE MACRO
CREATE PROFILE
CHECKPOINT
CREATE ROLE
CREATE TABLE
CREATE USER
CREATE VIEW
DELETE
DROP AUTHORIZATION
DROP DATABASE
DROP FUNCTION
DROP TRIGGER
DROP MACRO
DROP PROFILE
DUMP
DROP ROLE
DROP TABLE
DROP USER
DROP VIEW
• E = EXECUTE(MACRO)
• EF = EXECUTE
FUNCTION
• GC = CREATE GLOP
• GD = DROP GLOP
• GM = GLOP MEMBER
• I = INSERT
• IX = INDEX
• MR = MONITOR
RESOURCE
• MS = MONITOR
SESSION
• NT = NONTEMPORAL
• OD = OVERRIDE
DELETE POLICY
• OI = OVERRIDE
INSERT POLICY
• OP = CREATE OWNER
PROCEDURE
• OS = OVERRIDE
SELECT POLICY
• OU = OVERRIDE
UPDATE POLICY
• PC = CREATE
PROCEDURE
• PD = DROP PROCEDURE
115
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
AccessRight
(Continued)
116
Description
• PE = EXECUTE
PROCEDURE
• R = RETRIEVE/
SELECT
• RF = REFERENCE
• RO = REPLCONTROL
• RS = RESTORE
• SA = SECURITY
CONSTRAINT
ASSIGNMENT
• SD = SECURITY
CONSTRAINT
DEFINITION
• SH = SHOW
• SR = SET RESOURCE
RATE
• SS = SET SESSION
RATE
• ST = STATISTICS
• TH = CTCONTROL
• U = UPDATE
• UM = UDT METHOD
• UT = UDT TYPE
• UU = UDT USAGE
Data Type
Compatibility View
Unicode View
CHAR(2)
LATIN
NOT NULL
CHAR(2)
LATIN
NOT NULL
Format
X(2)
X(2)
Associated View
AllRights[X]
UserGrantedRights
UserRights
AllRoleRights
UserRoleRights
AllRightsV[X]
UserGrantedRightsV
UserRightsV
AllRoleRightsV
UserRoleRightsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AccessType
(for “Acr”-type columns)
Returns the type of privilege for which the check that generated this log entry was
performed.
• AE = ALTER EXTERNAL PROCEDURE
• AF = ALTER FUNCTION
• AN = ANY PRIVILEGE *
(* Indicates a HELP or SHOW
statement for which at least
one privilege, but no
specific privilege, is
required.)
• AP = ALTER PROCEDURE
• AS = ABORT SESSION
• CA = CREATE AUTHORIZATION
• CD = CREATE DATABASE
• CE = CREATE EXTERNAL PROCEDURE
• CF = CREATE FUNCTION
• CG = CREATE TRIGGER
• CM = CREATE MACRO
• CO = CREATE PROFILE
• CP = CHECKPOINT
• CR = CREATE ROLE
• CT = CREATE TABLE
• CU = CREATE USER
• CV = CREATE VIEW
• D = DELETE
• DA = DROP AUTHORIZATION
• DD = DROP DATABASE
• DF = DROP FUNCTION
• DG = DROP TRIGGER
• DM = DROP MACRO
• DO = DROP PROFILE
• DP = DUMP
• DR = DROP ROLE
• DT = DROP TABLE
• DU = DROP USER
• DV = DROP VIEW
• E = EXECUTE
• EF = EXECUTE FUNCTION
• I = INSERT
• IX = INDEX
• GC = Create GLOP
• GD = Drop GLOP
• GM = GLOP Member
Data Dictionary
• HR = HUT RELEASE
LOCK *
(* Indicates that a
client system
utility lock is
involved, which
could require a
check for one or
more of the
privileges
associated with
DUMP and RESTORE.)
• MR = MONITOR
RESOURCE
• MS = MONITOR
SESSION
• OP = CREATE OWNER
PROCEDURE
• PC = CREATE
PROCEDURE
• PD = DROP PROCEDURE
• PE = EXECUTE
PROCEDURE
• RF = REFERENCE
• RS = RESTORE
• S = RETRIEVE/
SELECT
• SR = SET RESOURCE
RATE
• SS = SET SESSION
RATE
• ST = STATISTICS
• U = UPDATE
• UU = UDT USAGE
• UT = UDT TYPE
• UM = UDT METHOD
• WL = WRITE LOCK *
(* Indicates that a
LOCKING objectname
“FOR WRITE” is
involved, which may
require checks for
one or more of the
following
privileges: INSERT,
UPDATE, DELETE.)
117
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
AccessType
(Continued)
Description
Data Type
Compatibility View
Unicode View
CHAR(2)
LATIN
NOT NULL
CHAR(2)
LATIN
NOT NULL
Format
X(2)
X(2)
Associated View
AccessLog
AccessLogV
Column Name
Description
AccLogResult
Returns a code to indicate how the access request for which this log entry was made. Possible
codes are as follows:
• G = Granted
• D = Denied
Data Type
118
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
AccessLog
AccessLogV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AccountName
Returns the expanded account in effect when the request that generated this log entry was
submitted.
Note: The system account name SYSTEMACCOUNTNO tracks console utility activity such
as table rebuild, Diskcopy, or Scandisk.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
AccessLog
SecurityLog[X]
AMPUsage[X]
AccountInfo[X]
AllSpace[X]
Databases[X]
DiskSpace[X]
LogOnOff[X]
SessionInfo[X]
TableSize[X]
AccessLogV
SecurityLogV[X]
AMPUsageV[X]
AccountInfoV[X]
AllSpaceV[X]
DatabasesV[X]
DiskSpaceV[X]
LogOnOffV[X]
SessionInfoV[X]
TableSizeV[X]
Column Name
Description
AccountString
(Title: Account)
Returns the specific account for the user with a DBQL rule, or blank if all account strings
apply.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
DBQLRules
DBQLRulesV
119
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcctString
Returns the user unexpanded logon account string.
Data Type
Compatibility View
Unicode View
CHAR(30)
UNICODE
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
QryLog
QryLogSummary
QryLogExceptions
QryLogTDWM
QryLogV
QryLogSummaryV
QryLogExceptionsV
QryLogTDWMV
Column Name
Description
AcctStringDate
Returns the result from the &D code when the user has specified Account String Expansion
(ASE).
Data Type
Compatibility View
Unicode View
DATE
DATE
Format
YY/MM/DD
YY/MM/DD
Associated View
QryLog
QryLogV
Column Name
Description
AcctStringHour
Returns the result from the &H code when the user has specified Account String Expansion
(ASE).
Data Type
120
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
--9
--9
Associated View
QryLog
QryLogV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcctStringTime
Returns the result from the &T code when the user has specified Account String Expansion
(ASE).
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
99:99:99
99:99:99
Associated View
QryLog
QryLogV
Column Name
Description
AcrAlterExtProcedure
(Title: AXP)
Returns the logging in effect for the ALTER EXTERNAL PROCEDURE privilege on the
objects or users (or both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrAlterFunction
(Title: AFN)
Returns the logging in effect for the Alter Function privilege on the object(s) and/or users to
which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
121
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcrAlterProcedure
(Title: ASP)
Returns the logging in effect for the Alter Procedure privilege on the object(s) and/or users
to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrCheckPoint
(Title: CPT)
Returns the logging in effect for the CHECKPOINT privilege on the objects or users (or
both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrConnectThrough
(Title: CTH)
Returns the logging in effect for the CTControl privilege on the users to which the rule
applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
122
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcrCreateDatabase
(Title: CDB)
Returns the logging in effect for the CREATE DATABASE privilege on the objects or users
(or both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrCreateFunction
(Title: CFN)
Returns the logging in effect for the CREATE FUNCTION privilege on the objects or users
(or both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrCreateGLOP
(Title: CGL)
Returns the access logging rules for the CREATE GLOP privilege.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
123
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcrCreateMacro
(Title: CMC)
Returns the logging in effect for the CREATE MACRO privilege on the objects or users (or
both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrCreateProcedure
(Title: CSP)
Returns the logging in effect for the CREATE PROCEDURE privilege on the objects or users
(or both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrCreateProfile
(Title: CPR)
Returns the logging in effect for the CREATE PROFILE privilege.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
124
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcrCreateRole
(Title: CRO)
Returns the logging in effect for the CREATE ROLE privilege.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrCreateTable
(Title: CTB)
Returns the logging in effect for the CREATE TABLE privilege on the objects or users (or
both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrCreateTrigger
(Title: CTG)
Returns the logging in effect for the CREATE TRIGGER privilege on the objects or users (or
both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
125
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcrCreateUser
(Title: CUS)
Returns the logging in effect for the CREATE USER privilege on the objects or users (or
both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrCreateView
(Title: CVW)
Returns the logging in effect for the CREATE VIEW privilege on the objects or users (or
both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrCreAuthorization
(Title: CAU)
Returns the logging in effect for the CREATE AUTHORIZATION privilege on the objects or
users (or both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
126
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcrCreExtProcedure
(Title: CXP)
Returns the logging in effect for the CREATE EXTERNAL PROCEDURE privilege on the
objects or users (or both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrCreOwnerProcedure
(Title: COP)
Returns the logging in effect for the CREATE OWNER PROCEDURE privilege on the
objects or users (or both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrDelete
(Title: DEL)
Returns the logging in effect for the DELETE privilege on the objects or users (or both) to
which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
127
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcrDropAuthorization
(Title: DAU)
Returns the logging in effect for the DROP AUTHORIZATION privilege on the objects or
users (or both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrDropDatabase
(Title: DDB)
Returns the logging in effect for the DROP DATABASE privilege on the objects or users (or
both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrDropFunction
(Title: DFN)
Returns the logging in effect for the DROP FUNCTION privilege on the objects or users (or
both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
128
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcrDropGLOP
(Title: DGL)
Returns the access logging rules for the DROP GLOP privilege.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrDropMacro
(Title: DMC)
Returns the logging in effect for the DROP MACRO privilege on the objects or users (or
both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrDropProcedure
(Title: DSP)
Returns the logging in effect for the DROP PROCEDURE privilege on the objects or users
(or both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
129
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcrDropProfile
(Title: DPR)
Returns the logging in effect for the DROP PROFILE privilege.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrDropRole
(Title: DRO)
Returns the logging in effect for the DROP ROLE privilege.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrDropTable
(Title: DTB)
Returns the logging in effect for the DROP TABLE privilege on the objects or users (or both)
to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
130
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcrDropTrigger
(Title: DTG)
Returns the logging in effect for the DROP TRIGGER privilege on the objects or users (or
both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrDropUser
(Title: DUS)
Returns the logging in effect for the DROP USER privilege on the objects or users (or both)
to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrDropView
(Title: DVW)
Returns the logging in effect for the DROP VIEW privilege on the objects or users (or both)
to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
131
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcrDump
(Title: DMP)
Returns the logging in effect for the DUMP privilege on the objects or users (or both) to
which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrExecute
(Title: EXE)
Returns the logging in effect for the EXECUTE privilege on the objects or users (or both) to
which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrExecuteFunction
(Title: EFN)
Returns the logging in effect for the EXECUTE FUNCTION privilege on the objects or users
(or both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
132
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcrExecuteProcedure
(Title: ESP)
Returns the logging in effect for the EXECUTE PROCEDURE privilege on the objects or
users (or both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrGLOPMember
(Title: MGL)
Returns the access logging rules for the GLOP MEMBER privilege.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrGrant
(Title: GRT)
Returns the logging in effect for the GRANT privilege on the objects or users (or both) to
which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
133
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcrIndex
(Title: IDX)
Returns the logging in effect for the CREATE/DROP INDEX privilege on the object(s) or
users (or both) to which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrInsert
(Title: INS)
Returns the logging in effect for the INSERT privilege on the objects or users (or both) to
which the rule applies.
For information on the character code, see “AccLogRules[V]” on page 421.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrReference
(Title: REF)
Returns the logging in effect for the Reference privilege on the object(s) or users (or both) to
which the rule applies.
Data Type
134
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcrRepControl
(Title: REP)
Returns the logging in effect for the RepControl privilege on the object(s) and/or users to
which the rule applies.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrRestore
(Title: RST)
Returns the logging in effect for the RESTORE privilege on the objects or users (or both) to
which the rule applies.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrSelect
(Title: SEL)
Returns the logging in effect for the SELECT privilege on the objects or users (or both) to
which the rule applies.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
135
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcrShow
(Title: SHO)
Returns the logging in effect for the SHOW privilege on the objects or users (or both) to
which the rule applies.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrStatistics
(Title: STA)
Returns the logging privilege checks corresponding to privileges for the COLLECT/DROP
STATISTICS statement.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrUDTMethod
(Title: UDM)
Returns the logging privilege checks corresponding to privileges for UDTMethod.
Data Type
136
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AcrUDTType
(Title: UDT)
Returns the logging privilege checks corresponding to privileges for UDTType.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrUDTUsage
(Title: USG)
Returns the logging privilege checks corresponding to privileges for UDTUsage.
Data Type
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
Column Name
Description
AcrUpdate
(Title: UPD)
Returns the logging in effect for the UPDATE privilege on the objects or users (or both) to
which the rule applies.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
AccLogRules
AccLogRulesV
137
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ActionTime
Returns a code to signify when, in relation to the SQL statement, the trigger is fired.
These are the values:
• B = Before
• A = After
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Triggers[X]
TriggersV[X]
Column Name
Description
ActiveCount
Returns the number of queries that are active in the WD in the collection period.
Data Type
138
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
Activity
Returns the activity being logged.
These are the values:
• ACTIVE = The Event…State is becoming active.
• INACTIVE = The Event…State is becoming inactive.
• EXPRESSION = The Event entry was used in determining that an expression is to be
made active.
• SYSCON = The Expression entry was used in determining that a SysCon is to be made
active.
• OPENV = The Expression entry was used in determining that an OpEnv is to be made
active.
Data Type
Compatibility View
Unicode View
CHAR(10)
LATIN
NOT CASESPECIFIC
CHAR(10)
LATIN
NOT CASESPECIFIC
Format
X(10)
X(10)
Associated View
QryLogEventHis
QryLogEventHisV
Column Name
Description
ActivityID
Returns the internal ID of the construct made active when Activity is EXPRESSION,
SYSCON, or OPENV; otherwise, it is set to zero.
Data Type
Data Dictionary
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogEventHis
QryLogEventHisV
139
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ActivityName
Returns the name of the construct made active when Activity is EXPRESSION, SYSCON, or
OPENV; otherwise, the field is null.
Data Type
Compatibility View
Unicode View
VARCHAR(128)
UNICODE
NOT CASESPECIFIC
VARCHAR(128)
UNICODE
NOT CASESPECIFIC
Format
X(128)
X(128)
Associated View
QryLogEventHis
QryLogEventHisV
Column Name
Description
ActualDeleteSecs
Returns the actual elapsed time in seconds for the Deletion/NUSI Rebuild phase.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
ReconfigInfoV
Column Name
Description
ActualRedistSecs
Returns the actual elapsed time in seconds for the Redistribution phase.
Data Type
Unicode View
FLOAT
NOT NULL
140
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
ReconfigInfoV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AddAmpCount
Returns the number of AMPs added.
Data Type
Unicode View
SMALLINT
Format
ZZZZ9
Associated View
ReconfigInfoV
Column Name
Description
AllAMPsFlag
Returns a code that indicates whether the event was executed on all AMPs, clusters, or
processors.
These are the values:
• A = all AMPs used
• C = all Clusters
• P = all Processors
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
Events[X]
EventsV[X]
Column Name
Description
AllnessFlag
Returns Y (yes) or N (no) to indicate whether or not the privilege was granted to all
subordinate users, or to all users who are owned by the grantee.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
AllRights[X]
UserGrantedRights
AllRightsV[X]
UserGrantedRightsV
141
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AMPCPUTime
Returns the total AMP CPU time used for query.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZ,ZZZ,ZZ9.999
ZZ,ZZZ,ZZ9.999
Associated View
QryLog
QryLogV
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZZ,ZZZ.999
ZZZ,ZZZ.999
Associated View
QryLogSummary
QryLogSummaryV
Column Name
Description
AMPCPUTimeNorm
Returns the normalized AMP CPU time for co-existence systems.
Data Type
142
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZ,ZZZ,ZZ9.999
ZZ,ZZZ,ZZ9.999
Associated View
QryLog
QryLogV
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZZ,ZZZ.999
ZZZ,ZZZ.999
Associated View
QryLogSummary
QryLogSummaryV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AppCategory
Returns the application category of an external stored procedure.
These are the values:
•
•
•
•
•
C = CLI
O = ODBC
J = JAVA
N = .NET
S = Standard XSP or UDF
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
ExternalSPs[X]
ExternalSPsV[X]
Column Name
Description
AppID
Returns the application ID.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
UNICODE
CHAR(30)
UNICODE
Format
X(30)
X(30)
Associated View
QryLog
QryLogSummary
QryLogV
QryLogSummaryV
143
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ApplName
Returns the name of the application,
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN
NOT CASESPECIFIC
NOT NULL
CHAR(30)
LATIN
NOT CASESPECIFIC
NOT NULL
Format
X(30)
X(30)
Associated View
DBQLRules
DBQLRulesV
Column Name
Description
Arrivals
Returns the number of queries that were classified into this WD by the Teradata dynamic
workload management software.
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Column Name
Description
AuditTrailId
Returns the identifier that is used for access logging.
Data Type
144
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
UPPERCASE
NOT NULL
Format
X(30)
X(128)
Associated View
SessionInfo[X]
SessionInfoV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AuthIdUsed
Returns the identifier of the authorization being used for the External Stored Procedure or
User Defined Function.
Data Type
Compatibility View
Unicode View
BYTE(6)
BYTE(6)
Format
X(12)
(explicit)
X(12)
(explicit)
Associated View
ExternalSPs[X]
Functions[X]
ExternalSPsV[X]
FunctionsV[X]
Column Name
Description
AuthorizationId
Returns the unique ID of the authorization.
Data Type
Compatibility View
Unicode View
BYTE(6)
NOT NULL
BYTE(6)
NOT NULL
Format
X(12)
X(12)
Associated View
Authorizations[X]
AuthorizationsV[X]
Column Name
Description
AuthorizationName
Returns the name of the authorization.
If AuthorizationType = I, then two entries appear for the same databasename: one where the
AuthorizationName is the same as the name specified in the CREATE AUTHORIZATION
statement and one where the AuthorizationName is a default name.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Authorizations[X]
AuthorizationsV[X]
145
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AuthorizationSubType
Specifies whether the authorization is a default authorization.
These are the values:
• D - Default
• N - Non-default
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
CHAR(1)
LATIN
UPPERCASE
Format
X(1)
X(1)
Associated View
Authorizations[X]
AuthorizationsV[X]
Column Name
Description
AuthorizationType
Returns the type of authorization.
These are the valid types:
• D = Definer
• I = Invoker
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
CHAR(1)
LATIN
UPPERCASE
Format
X(1)
X(1)
Associated View
Authorizations[X]
AuthorizationsV[X]
Column Name
Description
AverageAmpCPU
Returns the average number of AMP CPU seconds used by QueryCount.
Data Type
146
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZZ,ZZZ.999 (explicit)
ZZZ,ZZZ.999 (explicit)
Associated View
QryLogSummary
QryLogSummaryV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AverageIO
Returns the average IO time.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
Z(10)
Z(10)
Associated View
QryLogSummary
QryLogSummaryV
Column Name
Description
AverageParserCPU
Returns the average number of CPU seconds used in the parser by QueryCount.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZZ,ZZZ.999
ZZZ,ZZZ.999
Associated View
QryLogSummary
QryLogSummaryV
Column Name
Description
AverageTime
Returns the average elapsed time.
Data Type
Data Dictionary
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZZ,ZZZ,999 (explicit)
ZZZ,ZZZ,999 (explicit)
Associated View
QryLogSummary
QryLogSummaryV
147
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
AvgCPUTime
Returns the average CPU time for all queries completed in the summary interval for the
WD.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
ZZZZZZ.99 (explicit)
ZZZZZZ.99 (explicit)
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Column Name
Description
AvgDelayTime
Returns the average delay time for all queries completed in the summary interval for the
WD.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
----,---,---,---,--9
----,---,---,---,--9
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Column Name
Description
AvgRespTime
Returns the average response time for all queries completed in the summary interval for the
WD.
Data Type
148
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
ZZZZZZ.99 (explicit)
ZZZZZZ.99 (explicit)
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
BaseTblDbName
Returns the name of the database that contains an error table.
Data Type
Unicode View
VARCHAR(128)
UNICODE
Format
X(128)
Associated View
ErrorTblsV[X]
Column Name
Description
BaseTblName
Returns the name of the table that contains an error table.
Data Type
Unicode View
VARCHAR(128)
UNICODE
Format
X(128)
Associated View
ErrorTblsV[X]
Column Name
Description
BeginCalcHBTimeStamp
Returns the timestamp at which reconfig Phase 1 (Calculate Hash Buckets) begins.
Data Type
Unicode View
TIMESTAMP(0)
Data Dictionary
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
149
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
BeginDelHBNewTimeStamp
Returns the timestamp at which reconfig Phase 4.9.2 (Delete New Hash Bucket Maps)
begins.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
BeginDelTimeStamp
Returns the timestamp at which the reconfig Deletion phase begins.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
BeginFBHBNewTimeStamp
Returns the timestamp at which reconfig Phase 4.4 (Update New Backup Hash Buckets)
begins.
Data Type
Unicode View
TIMESTAMP(0)
150
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
BeginPHBNewTimeStamp
Returns the timestamp at which reconfig Phase 4.3 (Update New Primary Hash Buckets)
begins.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
BeginRedistTimeStamp
Returns the timestamp at which the reconfig Redistribution phase begins.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
BeginTimeStamp
For ReconfigTableStatsV, returns the timestamp for the start of the reconfig phase for this
table.
For ReconfigInfoV, returns the timestamp for the start of the Reconfiguration.
Data Type
Unicode View
TIMESTAMP(0)
Data Dictionary
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigTableStatsV
ReconfigInfoV
151
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
BeginVProcCfgTimeStamp
Returns the timestamp at which the reconfig final phase (update VprocCfg GDO) begins.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
BeginWrBkupIdTimeStamp
Returns the timestamp at which reconfig Phase 4.9 (Update Backup-IDs-Array) begins.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
BeginWrBMTimeStamp
Returns the timestamp at which reconfig Phase 4.9.1 (Update BMHashTbl GDO) begins.
Data Type
Unicode View
TIMESTAMP(0)
152
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
BeginWrCfgNewTimeStamp
Returns the timestamp at which reconfig Phase 4.8 (Update New Configuration Map)
begins.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
BeginWrCfgTimeStamp
Returns the timestamp at which reconfig Phase 4.7 (Update Current Configuration Map)
begins.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
BeginWrFBHBTimeStamp
Returns the timestamp at which reconfig Phase 4.6 (Update Current Backup Hash Buckets)
begins.
Data Type
Unicode View
TIMESTAMP(0)
Data Dictionary
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
153
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
BeginWrPHBTimeStamp
Returns the timestamp at which reconfig Phase 4.5 (Update Current Primary Hash Buckets)
begins.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
BeginWrSpaceTimeStamp
Returns the timestamp at which reconfig Phase 4.1(Store Database Space Info) begins.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
B_DatabaseName
Returns the name of the database in which the base global table resides.
Data Type
154
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
UPPERCASE
NOT NULL
Format
X(30)
X(128)
Associated View
AllTempTables[X]
AllTempTablesV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
B_TableName
Returns the name of the base global temporary table.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
UPPERCASE
NOT NULL
Format
X(30)
X(128)
Associated View
AllTempTables[X]
AllTempTablesV[X]
Column Name
Description
CacheFlag
This field is blank if the query is not found in step cache.
These are the values:
•
•
•
•
"T" if the query is found in step cache.
"S" if the query is a parameterized query and a Specific Plan is generated.
"G" if the query is a parameterized query and a Generic Plan is generated.
"A" if the query is a parameterized query and a Specific Always decision is taken. That is,
each time a query is submitted USING values are peeked at and the query is parsed.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
CHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
QryLog
QryLogV
155
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
Category
Shows the category code assigned to a software event.
These are the values:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
0 None
1 CPU Hardware
2 Memory Hardware
3 TDN Hardware
4 Disk Hardware
5 Channel Hardware
6 Host
7 Driver
8 Resource
9 System
10 User
11 Occurrence
12 Abnormal
52 Base TP
64 Max TP
Data Type
Compatibility View
Unicode View
BYTEINT
BYTEINT
Format
Z9
Z9
Associated View
Software_Event_Log
Software_Event_LogV
Column Name
Description
CharacterType
Returns the character type that was the default when the function or External Stored
Procedure was created.
Data Type
156
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
Functions[X]
ExternalSPs[X]
FunctionsV[X]
ExternalSPsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
CharSetId
Returns a number uniquely identifying the character set of the CHARSET_COLL collation.
If the character set is user-defined, this ID should also exist in
DBC.CharTranslations.CharSetID.
For constraints not involving comparison of character data or not using CHARSET_COLL
for evaluation, the value is NULL.
Data Type
Compatibility View
Unicode View
BYTEINT
NOT NULL
BYTEINT
NOT NULL
Format
ZZ9
ZZ9
Associated View
IndexConstraints[X]
IndexConstraintsV[X]
Returns the number assigned to the character set defined by this row.
Data Type
Compatibility View
Unicode View
BYTEINT
NOT NULL
BYTEINT
NOT NULL
Format
ZZ9
ZZ9
Associated View
CharTranslations
CharTranslationsV
Column Name
Description
CharSetName
Returns the name of a user-defined character set that is installed and available for the
current session, or the name assigned to the character set defined by this row.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
CharSets
CharTranslations
CharSetsV
CharTranslationsV
157
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
CharType
Returns the type of the different character data types.
These are the values:
•
•
•
•
•
•
1 = Latin
2 = Unicode
3 = KanjiSJIS
4 = Graphic
5 = Kanji1
0 = all other data types
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
Columns[X]
ColumnsV[X]
Column Name
Description
CheckName
Returns the name of the table-level check.
This field is NULL if this is an unnamed table check.
Data Type
158
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
ShowTblChecks[X]
ShowTblChecksV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
CheckOpt
Indicates whether or not the table allows duplicate rows.
These are the values:
• Y = Duplicate rows are allowed
• N = Duplicate rows are not allowed
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
Tables[X]
TablesV[X]
Column Name
Description
CheckpointName
Returns the checkpoint name as specified by the user in the CHECKPOINT statement.
Data Type
Data Dictionary
Compatibility View
Unicode View
VARCHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
Events[X]
EventsV[X]
159
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
CheckTableOption
Returns the option for Reconfig to automatically run Checktable after the Deletion/Rebuild
NUSI is completed for a user table.
These are the options:
•
•
•
•
0 - Do not automatically run checktable (Default)
1 - Check table at level one
2 - Check table at level two
3 - Check table at level three
Data Type
Unicode View
BYTEINT
Format
ZZ9
Associated View
ReconfigDeleteOrderV
Column Name
Description
Child
Returns the name of a referencing database or user.
Data Type
160
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Children[X]
ChildrenV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ChildCount
Returns the count of the referencing tables for the table.
For stored procedures and external stored procedures, this field stores the number of result
sets.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
Tables[X]
Tables2[X]
TablesV[X]
Tables2V[X]
Column Name
Description
ChildDb
Returns the name of the referencing database.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
All_RI_Children[X]
All_RI_Parents[X]
RI_Distinct_Children[X]
RI_Distinct_Parents[X]
All_RI_ChildrenV[X]
All_RI_ParentsV[X]
RI_Distinct_ChildrenV[X]
RI_Distinct_ParentsV[X]
Column Name
Description
ChildDbId
Returns the database ID of the referencing table.
Data Type
Data Dictionary
Compatibility View
Unicode View
BYTE(4)
NOT NULL
BYTE(4)
NOT NULL
Format
X(8)
X(8)
Associated View
RI_Child_Tables[X]
RI_Parent_Tables[X]
RI_Child_TablesV[X]
RI_Parent_TablesV[X]
161
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ChildKeyColumn
Returns the name of a column in the referencing key.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
All_RI_Children[X]
All_RI_Parents[X]
All_RI_ChildrenV[X]
All_RI_ParentsV[X]
Column Name
Description
ChildKeyFID
Returns the field ID of a column in the referencing key.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
RI_Child_Tables[X]
RI_Parent_Tables[X]
RI_Child_TablesV[X]
RI_Parent_TablesV[X]
Column Name
Description
ChildTable
Returns the name of the referencing table.
Data Type
162
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
All_RI_Children[X]
All_RI_Parents[X]
RI_Distinct_Children[X]
RI_Distinct_Parents[X]
All_RI_ChildrenV[X]
All_RI_ParentsV[X]
RI_Distinct_ChildrenV[X]
RI_Distinct_ParentsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ChildTID
Returns the table ID of the referencing table.
Data Type
Compatibility View
Unicode View
BYTE(6)
NOT NULL
BYTE(6)
NOT NULL
Format
X(12)
X(12)
Associated View
RI_Child_Tables[X]
RI_Parent_Tables[X]
RI_Child_TablesV[X]
RI_Parent_TablesV[X]
Column Name
Description
CkptFlushCount
Returns the number of checkpoints flushed.
Data Type
Unicode View
INTEGER
NOT NULL
Format
ZZZZZZZZZ9
Associated View
ReconfigTableStatsV
Column Name
Description
ClassificationTime
Returns the time when the query was classified.
Data Type
Data Dictionary
Compatibility View
Unicode View
TIMESTAMP(2)
TIMESTAMP(2)
Format
YYYYMMDDBHH:MI:SS.S(F)Z
YYYYMMDDBHH:MI:SS.S(F)Z
Associated View
QryLogExceptions
QryLogExceptionsV
163
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ClientAddr
Returns the IP address of the client who submitted the query.
Data Type
Compatibility View
Unicode View
CHAR(45)
LATIN
CHAR(45)
LATIN
Format
X(45)
X(45)
Associated View
QryLog
QryLogSummary
QryLogV
QryLogSummaryV
Compatibility View
Unicode View
CHAR(30)
UNICODE
CHAR(30)
UNICODE
Format
X(30)
X(30)
Associated View
QryLog
QryLogSummary
QryLogV
QryLogSummaryV
Column Name
Description
ClientID
Returns the client ID.
Data Type
Column Name
Description
ColCheck
Returns the unresolved text for the column-level check condition.
Data Type
164
Compatibility View
Unicode View
VARCHAR(8192)
LATIN/KANJI1
VARCHAR(8192)
UNICODE
Format
X(8192)
X(255)
Associated View
ShowColChecks[X]
ShowColChecksV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
CollationName
Returns the name of the CHARSET_COLL collation.
If ConstraintCollation is not U, it is the constraint collation name; otherwise, the value is
NULL.
Data Type
Compatibility View
Unicode View
VARCHAR(128)
UNICODE
VARCHAR(128)
UNICODE
Format
X(128)
X(128)
Associated View
IndexConstraints[X]
IndexConstraintsV[X]
Column Name
Description
CollectTimeStamp
Returns a timestamp unique to each buffer cache.
Data Type
Data Dictionary
Compatibility View
Unicode View
TIMESTAMP(2)
NOT NULL
TIMESTAMP(2)
NOT NULL
Format
YYYY-MM-DDBHH:MI:SS
YYYY-MM-DDBHH:MI:SS
Associated View
QryLog
QryLogObjects
QryLogSummary
QryLogSteps
QryLogSQL
QryLogExplain
QryLogTDWMSum
QryLogTDWM
QryLogEvents
QryLogEventHis
QryLogExceptions
QryLogV
QryLogObjectsV
QryLogSummaryV
QryLogStepsV
QryLogSQLV
QryLogExplainV
QryLogTDWMSumV
QryLogTDWMV
QryLogEventsV
QryLogEventHisV
QryLogExceptionsV
QryLogXMLV
165
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
CollEqvClass
Returns the value of the equivalence class assigned to each character.
Equivalence also is the first level of comparison in determining the collation sequence.
Data Type
Compatibility View
Unicode View
BYTE(256)
NOT NULL
BYTE(256)
NOT NULL
Format
X(512)
X(512)
Associated View
Collations
CollationsV
Column Name
Description
CollInstall
Returns the install flag for the collation.
The option returns Y (yes) if the collation is installed when the Teradata Database is started
and N (no) if the collation is not installed when the Teradata Database is started. This flag
applies only to multinational collation. Other collations are never installed.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
Collations
CollationsV
Column Name
Description
CollName
Returns the name of the collation sequence.
Only the collation sequence with name MULTINATIONAL and the collInstall flag set to Y is
installed on the Teradata Database.
Data Type
166
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
CHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Collations
CollationsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
CollOrderCS
Returns the value assigned to each character to determine the relative order of the characters
within the same class for second level, case-specific comparison.
Data Type
Compatibility View
Unicode View
BYTE(256)
NOT NULL
BYTE(256)
NOT NULL
Format
X(512)
X(512)
Associated View
Collations
CollationsV
Column Name
Description
CollOrderUC
Returns the value assigned to each character to determine the relative order of the characters
within the same class for second level, uppercase comparison.
Data Type
Compatibility View
Unicode View
BYTE(256)
NOT NULL
BYTE(256)
NOT NULL
Format
X(512)
X(512)
Associated View
Collations
CollationsV
Column Name
Description
ColumnConstraint
Returns the condition text for column-level check.
Data Type
Data Dictionary
Compatibility View
Unicode View
VARCHAR(8192)
LATIN/KANJI1
VARCHAR(8192)
UNICODE
Format
X(8192)
X(255)
Associated View
Columns[X]
ColumnsV[X]
167
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ColumnFormat
Returns the format of a column or parameter.
Data Type
Compatibility View
Unicode View
CHAR(30)
UNICODE
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
Columns[X]
ColumnStats
IndexStats
MultiColumnStats
ColumnsV[X]
ColumnStatsV
IndexStatsV
MultiColumnStatsV
Column Name
Description
ColumnId
Returns a two-byte value specifying the internal identifier for this column.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
Columns[X]
ColumnsV[X]
Column Name
Description
ColumnLength
Returns the length of a column as the maximum number of bytes used to physically store a
column value in a table row.
Data Type
168
Compatibility View
Unicode View
INTEGER
INTEGER
Format
Z,ZZZ,ZZZ,ZZ9 (explicit)
Z,ZZZ,ZZZ,ZZ9 (explicit)
Associated View
Columns[X]
IndexStats
MultiColumnStats
ColumnStats
ColumnsV[X]
IndexStatsV
MultiColumnStatsV
ColumnStatsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ColumnName
Returns the column name that was entered on the access log.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
AccessLog
AccessLogV
Returns the column name or parameter.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
Columns[X]
Indices[X]
ColumnStats
IndexStats
AllRoleRights
UserRoleRights
MultiColumnStats
ColumnsV[X]
IndicesV[X]
ColumnStatsV
IndexStatsV
AllRoleRightsV
UserRoleRightsV
MultiColumnStatsV
Returns the column name to which a privilege has been granted.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
AllRights[X]
UserGrantedRights
UserRights
AllRightsV[X]
UserGrantedRightsV
UserRightsV
169
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ColumnName
(Continued)
Returns the column name having column-level checks.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
ShowColChecks[X]
ShowColChecksV[X]
Column Name
Description
ColumnPosition
Returns the position of the column in the index.
For a composite index, this indicates the order of the columns making up the index.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
Z9 (explicit)
Z9 (explicit)
Associated View
Indices[X]
IndexStats
MultiColumnStats
IndicesV[X]
IndexStatsV
MultiColumnStatsV
Column Name
Description
ColumnsStatistics
Returns the collected statistics on a set of columns.
Data Type
170
Compatibility View
Unicode View
VARBYTE(16383)
VARBYTE(16383)
Format
X(255)
X(255)
Associated View
MultiColumnStats
MultiColumnStatsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ColumnTitle
Returns any column heading.
Data Type
Compatibility View
Unicode View
VARCHAR(60)
UNICODE
VARCHAR(256)
UNICODE
Format
X(60)
X(256)
Associated View
Columns[X]
ColumnsV[X]
Column Name
Description
ColumnType
Returns a column name or parameter in the following formats:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Data Dictionary
AT = TIME
BF = BYTE
BO = BLOB
BV = VARBYTE
CF = CHAR
CO = CLOB
CV = VARCHAR
D = DECIMAL
DA = DATE
DH = INTERVAL DAY TO HOUR
DM = INTERVAL DAY TO MINUTE
DS = INTERVAL DAY TO SECOND
DY = INTERVAL DAY
F = FLOAT
HM = INTERVAL HOUR TO MINUTE
HR = INTERVAL HOUR
HS = INTERVAL HOUR TO SECOND
I1 = BYTEINT
I2 = SMALLINT
I8 = BIGINT
I = INTEGER
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
MI = INTERVAL MINUTE
MO = INTERVAL MONTH
MS = INTERVAL
MINUTE TO SECOND
PD = PERIOD(DATE)
PM = PERIOD
(TIMESTAMP(n) WITH TIME
ZONE)
PS = PERIOD
(TIMESTAMP(n))
PT = PERIOD(TIME(n))
PZ = PERIOD(TIME(n) WITH
TIME ZONE)
SC = INTERVAL SECOND
SZ = TIMESTAMP WITH
TIME ZONE
TS = TIMESTAMP
TZ = TIME WITH TIME
ZONE
YM = INTERVAL YEAR TO
MONTH
YR = INTERVAL YEAR
UT = UDT Type
171
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ColumnType
(Continued)
Data Type
Compatibility View
Unicode View
CHAR(2)
LATIN
UPPERCASE
CHAR(2)
LATIN
UPPERCASE
Format
X(2)
X(2)
Associated View
Columns[X]
ColumnStats
IndexStats
MultiColumnStats
ColumnsV[X]
ColumnStatsV
IndexStatsV
MultiColumnStatsV
Column Name
Description
ColumnUDTName
Returns the name of a UDT if the column type is UDT.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
UPPERCASE
VARCHAR(128)
UNICODE
UPPERCASE
Format
X(30)
X(128)
Associated View
Columns[X]
ColumnsV[X]
Column Name
Description
CommentString
Returns user-supplied text or commentary on the column, database, table, view, macro,
user-defined function, user-defined types, user-defined methods, stored procedure, role,
profile, or user.
Data Type
172
Compatibility View
Unicode View
VARCHAR(255)
UNICODE
VARCHAR(255)
UNICODE
Format
X(255)
X(255)
Associated View
Columns[X]
Databases[X]
Tables[X]
Users
ProfileInfo[X]
RoleInfo[X]
ColumnsV[X]
DatabasesV[X]
TablesV[X]
UsersV
ProfileInfoV[X]
RoleInfoV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
CommitOpt
Specifies the ON COMMIT option for a temporary table.
These are the values:
• P = ON COMMIT PRESERVE ROWS
• D = ON COMMIT DELETE ROWS
• N = the object is not a temporary table
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
Tables[X]
TablesV[X]
Column Name
Description
CommitOrRollback
Returns a code to indicate whether the transaction was committed or rolled back.
These are the values:
• C = Committed
• R = Rolled Back
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
DeleteOldInDoubt
InDoubtLog
DeleteOldInDoubtV
InDoubtLogV
173
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
CompletionDate
Returns the date the in-doubt transaction was resolved.
Data Type
Compatibility View
Unicode View
DATE
NOT NULL
DATE
NOT NULL
Format
YY/MM/DD
YY/MM/DD
Associated View
DeleteOldInDoubt
InDoubtLog
DeleteOldInDoubtV
InDoubtLogV
Column Name
Description
Completions
Returns the number of queries that completed in this WD in this interval (dashboard or
logging) with:
1 No error code or an error code of 3158 (Teradata dynamic workload management
software notification)
2 No abort flag
3 Either an AMP count of > 0 or parser CPU > 0
Note: Dashboard interval is used for the API data, and logging interval is used for logging
data to the disk.
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Column Name
Description
CompletionTime
Returns the time the in-doubt transaction was resolved.
Data Type
174
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
99:99:99
99:99:99
Associated View
DeleteOldInDoubt
InDoubtLog
DeleteOldInDoubtV
InDoubtLogV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
Compressible
Returns a C (Compress) if the COMPRESS phrase is defined for the column.
These are the values:
• A = ALC columns
• C = MVC columns
• N = Non-compress columns
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
CHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
Columns[X]
ColumnsV[X]
Compatibility View
Unicode View
VARCHAR(255)
UNICODE
VARCHAR(255)
UNICODE
Format
X(255)
X(255)
Associated View
Columns[X]
ColumnsV[X]
Column Name
Description
CompressValue
Returns NULL.
Data Type
Column Name
Description
CompressValueList
Returns the algorithm names in addition to the compress values.
Data Type
Data Dictionary
Compatibility View
Unicode View
VARCHAR(8192)
UNICODE
VARCHAR(8192)
UNICODE
Format
X(8192)
X(8192)
Associated View
Columns[X]
ColumnsV[X]
175
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ConfigId
Returns the common ID given to all records in the Teradata dynamic workload management
software that comprise a single configuration.
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogEventHis
QryLogEventHisV
Column Name
Description
ConstCat
(Title: Cat)
Returns the constant category.
For legacy and subops profile types, these are the constant categories:
• C = a cost prediction parameter
• I = an initialization parameter
Data Type
CHAR(1)
LATIN
NOT NULL
Format
X(1)
Associated View
CostProfileValues_V
Column Name
Description
ConstDesc
Returns the description of the constant.
176
Data Type
VARCHAR(2048)
LATIN
Format
X(2048)
Associated View
CostProfileValues_V
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ConstId
(Title: C-Id)
Returns the constant identifier number.
Data Type
INTEGER
NOT NULL
Format
-----9
Associated View
CostProfileValues_V
Column Name
Description
ConstName
(Title: Constant Name)
Returns the name of the constant in the cost profile.
Data Type
CHAR(30)
LATIN
NOT NULL
Format
X(30) (explicit)
Associated View
CostProfileValues_V
Column Name
Description
ConstVal
(Title: Value)
Returns the constant numeric value that overrides the default numeric value for the cost
profile type.
Data Dictionary
Data Type
FLOAT
Format
----,---,--9.9999 (explicit)
Associated View
CostProfileValues_V
177
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ConstraintCollation
Returns the collation to be used in evaluating the index constraint as:
•
•
•
•
•
•
A = ASCII
C = CHARSET_COLL
E = EBCDIC
J = JIS_COLL
M = MULTINATIONAL
U = Use the session collation
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
IndexConstraints[X]
IndexConstraintsV[X]
Column Name
Description
ConstraintCount
Returns the count of table level constraints referencing this column.
Data Type
178
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
Columns[X]
ColumnsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ConstraintName
Returns the name of the table-level check. This field is NULL if this is an unnamed table
check.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
Table_LevelConstraints[X]
Table_LevelConstraintsV[X]
Column Name
Description
ConstraintText
Returns the unresolved text for the table-level check condition.
Data Type
Compatibility View
Unicode View
VARCHAR(8192)
LATIN/KANJI1
CASESPECIFIC
VARCHAR(8192)
UNICODE
CASESPECIFIC
Format
X(255)
X(255)
Associated View
Table_LevelConstraints[X]
Table_LevelConstraintsV[X]
Returns the unresolved condition text of the index constraint (that is, the implied constraint
determined from the partitioning expressions for the index).
Data Type
Compatibility View
Unicode View
VARCHAR(8192)
LATIN
CASESPECIFIC
VARCHAR(8192)
UNICODE
CASESPECIFIC
Format
X(255)
X(255)
Associated View
IndexConstraints[X]
IndexConstraintsV[X]
For information on how implied constraint differs for multi-level from single-level, and how
to query index constraints to get the multi-level partitioned tables, see Database Design.
Data Dictionary
179
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ConstraintType
Returns one of the following possible values:
• C = Explicit table-level constraint check.
• Q = Implicit primary index partitioning constraint check.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
IndexConstraints[X]
IndexConstraintsV[X]
Column Name
Description
CoordTaskId
Returns the coordinator that had the in-doubt transaction.
Data Type
180
Compatibility View
Unicode View
VARBYTE (30)
NOT NULL
VARBYTE (30)
NOT NULL
Format
X(60)
X(60)
Associated View
DeleteOldInDoubt
InDoubtLog
DeleteOldInDoubtV
InDoubtLogV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
CPUTime
Returns total CPU time in seconds (with resolution of .01 second) used on an AMP (or on
all AMPs if SUM aggregate is specified).
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
---,---,---,--9.99 (explicit)
---,---,---,--9.99 (explicit)
Associated View
AMPUsage[X]
AMPUsageV[X]
Returns the amount of CPU time in seconds (with resolution of .01 second) used on AMPs
for the step or for a set of parallel steps. The first step in a set of parallel steps contains the
sum of the CPU time.
Data Type
Data Dictionary
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZ,ZZZ,ZZ9.999 (explicit)
ZZ,ZZZ,ZZ9.999 (explicit)
Associated View
QryLogSteps
QryLogStepsV
181
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
CPUTimeNorm
Returns the normalized AMP CPU time for co-existence systems.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZ,ZZZ,ZZ9.999 (explicit)
ZZ,ZZZ,ZZ9.999 (explicit)
Associated View
QryLogSteps
QryLogStepsV
Returns the normalized cpu usage and is calculated as CPU x scaling factor.
Note: The calculation is made for each PE in the system. It is used for systems with “coexistent” processors where each node may have CPUs with different scaling factors.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
---,---,---,--9.99 (explicit)
---,---,---,--9.99 (explicit)
Associated View
AMPUsage[X]
AMPUsageV[X]
Column Name
Description
CreateDate
Returns the date that the event took place.
Data Type
182
Compatibility View
Unicode View
DATE
NOT NULL
DATE
NOT NULL
Format
YY/MM/DD
YY/MM/DD
Associated View
Events[X]
Events_Configuration[X]
Events_Media[X]
EventsV[X]
Events_ConfigurationV[X]
Events_MediaV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
CreateTime
Returns the time that the event took place.
Data Type
Compatibility View
Unicode View
DATE
NOT NULL
DATE
NOT NULL
Format
YY/MM/DD
YY/MM/DD
Associated View
Events[X]
Events_Configuration[X]
Events_Media[X]
EventsV[X]
Events_ConfigurationV[X]
Events_MediaV[X]
Column Name
Description
CreateTimeStamp
Returns the date and time the Data Dictionary row was created.
Data Type
Data Dictionary
Compatibility View
Unicode View
TIMESTAMP(0)
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
YYYY-MM-DDBHH:MI: SS
Associated View
AccLogRules
AllRights[X]
All_RI_Children[X]
All_RI_Parents[X]
Columns[X]
Databases[X]
Indices[X]
LogonRules
RI_Child_Tables[X]
RI_Distinct_Children[X]
RI_Distinct_Parents[X]
RI_Parent_Tables[X]
ShowColChecks[X]
ShowTblChecks[X]
Tables[X]
Table_LevelConstraints[X]
Triggers[X]
UserGrantedRights
UserRights
Users
AllRoleRights
UserRoleRights
ProfileInfo[X]
IndexConstraints[X]
RoleInfo[X]
ArchiveLoggingObjs[X]
ConnectRules
AccLogRulesV
AllRightsV[X]
All_RI_ChildrenV[X]
All_RI_ParentsV[X]
ColumnsV[X]
DatabasesV[X]
IndicesV[X]
LogonRulesV
RI_Child_TablesV[X]
RI_Distinct_ChildrenV[X]
RI_Distinct_ParentsV[X]
RI_Parent_TablesV[X]
ShowColChecksV[X]
ShowTblChecksV[X]
TablesV[X]
Table_LevelConstraintsV[X]
TriggersV[X]
UserGrantedRightsV
UserRightsV
UsersV
AllRoleRightsV
UserRoleRightsV
ProfileInfoV[X]
IndexConstraintsV[X]
RoleInfoV[X]
ErrorTblsV[X]
ArchiveLoggingObjsV[X]
ConnectRulesV
183
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
CreateTxtOverflow
Identifies that the CreateText for the object overflowed DBC.TVM when set to ’C,’ and the
complete text is stored in DBC.TextTbl.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
CHAR(1)
LATIN
UPPERCASE
Format
X(1)
X(1)
Associated View
Triggers[X]
TriggersV[X]
Column Name
Description
CreatorName
Returns either the name of the user who created the database or table, or the name of the
creator.
For the view DBC.AllRights, CreatorName contains the name of the grantor when the right
was granted explicitly. But in cases a right was granted automatically as the result of creating
an object, CreatorName contains the name of the user who executed the CREATE statement.
Data Type
184
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE NOT NULL
Format
X(30)
X(128)
Associated View
AccLogRules
AllRights[X]
All_RI_Children[X]
All_RI_Parents[X]
Columns[X]
Databases[X]
Indices[X]
LogonRules
RI_Child_Tables[X]
RI_Distinct_Children[X]
RI_Distinct_Parents[X]
RI_Parent_Tables[X]
ShowColChecks[X]
ShowTblChecks[X]
Tables[X]
Table_LevelConstraints[X]
Triggers[X]
UserGrantedRights
UserRights
Users
RoleInfo[X]
AccLogRulesV
AllRightsV[X]
All_RI_ChildrenV[X]
All_RI_ParentsV[X]
ColumnsV[X]
DatabasesV[X]
IndicesV[X]
LogonRulesV
RI_Child_TablesV[X]
RI_Distinct_ChildrenV[X]
RI_Distinct_ParentsV[X]
RI_Parent_TablesV[X]
ShowColChecksV[X]
ShowTblChecksV[X]
TablesV[X]
Table_LevelConstraintsV[X]
TriggersV[X]
UserGrantedRightsV
UserRightsV
UsersV
RoleInfoV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
CreatorName
(Continued)
Returns the name of the user who created the profile.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
ProfileInfo[X]
ProfileInfoV[X]
Returns the name of the user that created the index constraint.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
IndexConstraints[X]
IndexConstraintsV[X]
Returns the name of the error table creator.
Data Type
Unicode View
VARCHAR(128)
UNICODE
Format
X(128)
Associated View
ErrorTblsV[X]
Returns the name of the user who created the archive logging.
Data Type
Unicode View
VARCHAR(128)
UNICODE
NOT NULL
Data Dictionary
Format
X(128)
Associated View
ArchiveLoggingObjsV[X]
185
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
CreatorName
(Continued)
Returns the name of the user who created the rule.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
ConnectRules
ConnectRulesV
Column Name
Description
CurrByteCount
Returns the number of bytes reconfig processed so far.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigInfoV
Column Name
Description
CurrentCollation
Returns the current collation of the session with the following values:
•
•
•
•
•
•
A = ASCII
E = EBCDIC
H = Host
M = Multinational
C = CharSet_Coll
J = JIS_Coll
Data Type
186
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
UPPERCASE
CHAR(1)
LATIN
NOT NULL
UPPERCASE
Format
X(1)
X(1)
Associated View
SessionInfo[X]
SessionInfoV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
CurrentPerm
Returns an integer that represents the permanent space, in bytes, that is currently being used
by the database or table.
Unless a specific AMP is requested, this value includes all AMPs.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
---,---,---,---,--9 (explicit)
---,---,---,---,--9 (explicit)
Associated View
AllSpace[X}
DiskSpace[X]
TableSize[X]
AllSpaceV[X}
DiskSpaceV[X]
TableSizeV[X]
Column Name
Description
CurrentRole
Returns the current role for a session
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
SessionInfo[X]
SessionInfoV[X]
Column Name
Description
CurrentSpool
Returns an integer that represents the spool space, in bytes, that is currently being used by
the database on a specified AMP (or on all AMPs if the SUM aggregate is specified).
Data Type
Data Dictionary
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
---,---,---,---,--9 (explicit)
---,---,---,---,--9 (explicit)
Associated View
AllSpace[X]
DiskSpace[X]
AllSpaceV[X]
DiskSpaceV[X]
187
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
CurrentTemp
Returns the number of bytes currently used by a temporary table per vproc.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
---,---,---,---,--9 (explicit)
---,---,---,---,--9 (explicit)
Associated View
AllSpace[X}
DiskSpace[X]
AllSpaceV[X}
DiskSpaceV[X]
Column Name
Description
CurrTabDeleteCount
Returns the number of tables reconfig deleted so far.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigInfoV
Column Name
Description
CurrTabRedistCount
Returns the number of tables reconfig redistributed so far.
Data Type
Unicode View
FLOAT
NOT NULL
188
Format
----,---,---,---,--9
Associated View
ReconfigInfoV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
DatabaseId
Returns the ID of the database with the indicated count of unresolved references.
Data Type
Compatibility View
Unicode View
BYTE(4)
NOT NULL
BYTE(4)
NOT NULL
Format
X(8)
X(8)
Associated View
Databases2[X]
Databases2V[X]
Returns the ID of the database which contains both the Child and Parent tables.
Data Type
Data Dictionary
Compatibility View
Unicode View
BYTE(4)
NOT NULL
BYTE(4)
NOT NULL
Format
X(8)
X(8)
Associated View
Tables2[X]
Tables2V[X]
189
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
DatabaseName
Returns the database or user name of the object for which this log entry was made.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
AccessLog
SecurityLog[X]
AccessLogV
SecurityLogV[X]
Returns the database in which the function resides.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Functions[X]
FunctionsV[X]
Returns the name of the database on which a privilege was granted.
These are the values:
• ALL
• PUBLIC (indicates performance monitoring rights)
Data Type
190
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
AllRights[X]
AllRightsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
DatabaseName
(Continued)
Returns the name of a database or one of the following special system keywords:
• ALL
• DEFAULT
• PUBLIC (denotes that a user granted performance monitoring rights is granted those
rights on all users of the system [the PUBLIC]). The values for MaxPerm, CurrentPerm,
PeakPerm, CurrentSpool, PeakSpool, CurrentTemp, and Peak Temp are 0 for the
PUBLIC database.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
AllSpace[X]
Databases[X]
DiskSpace[X]
UserGrantedRights
UserRights
AllSpaceV[X]
DatabasesV[X]
DiskSpaceV[X]
UserGrantedRightsV
UserRightsV
Returns the name of the database or user space in which the imported object now resides.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Association[X]
AssociationV[X]
191
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
DatabaseName
(Continued)
Returns the name of a database.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Columns[X]
Indices[X]
TableSize[X]
AllRoleRights
UserRoleRights
TableText[X]
MultiColumnStats
AccLogRules
ColumnsV[X]
IndicesV[X]
TableSizeV[X]
AllRoleRightsV
UserRoleRightsV
TableTextV[X]
MultiColumnStatsV
AccLogRulesV
ReconfigRedistOrderV
ReconfigDeleteOrderV
ReconfigTableStatsV
JoinIndicesV
ResolvedDTSV[X]
Returns the name of a database for which a default journal table has been defined.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Database_Default_Journals[X]
Database_Default_JournalsV[X]
Returns the name of a database with the indicated count of unresolved references.
Data Type
192
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Databases2[X]
Databases2V[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
DatabaseName
(Continued)
Returns the name of the database that was affected by the event.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Events[X]
EventsV[X]
Returns the name of a database containing a table with a column-level check.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
ShowColChecks[X]
ShowColChecksV[X]
Returns the name of a database containing a table with a table-level check.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
ShowTblChecks[X]
Table_LevelConstraints[X]
ShowTblChecksV[X]
Table_LevelConstraintsV[X]
193
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
DatabaseName
(Continued)
Returns the name of the database in which the table resides.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Tables[X]
TableText[X]
IndexConstraints[X]
TablesV[X]
TableTextV[X]
IndexConstraintsV[X]
Returns the name of the database where the trigger resides.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Triggers[X]
TriggersV[X]
Returns the databasename of the table, for which the column or index statistics are
requested.
Data Type
194
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
ColumnStats
IndexStats
ColumnStatsV
IndexStatsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
DatabaseName
(Continued)
Returns the database in which the External Stored Procedure resides.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
ExternalSPs[X]
ExternalSPsV[X]
Returns the database in which the authorization resides.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Authorizations[X]
AuthorizationsV[X]
Returns the database in which the archive logs reside.
Data Type
Unicode View
VARCHAR(128)
UNICODE
NOT NULL
Data Dictionary
Format
X(128)
Associated View
ArchiveLoggingObjsV[X]
195
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
DataSetName
Returns the client system data set name for a dump or restore event.
Data Type
Compatibility View
Unicode View
VARCHAR(44)
LATIN
VARCHAR(44)
LATIN
Format
X(44)
X(44)
Associated View
Events[X]
Events_Media[X]
EventsV[X]
Events_MediaV[X]
Column Name
Description
DBKind
Returns information that indicates whether the row information represents a database (D)
or a user (U).
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Databases[X]
DatabasesV[X]
Column Name
Description
DBlockSize
Returns the data block size (Default 0).
Data Type
Unicode View
INTEGER
NOT NULL
196
Format
ZZZZZZZZZ9
Associated View
ReconfigTableStatsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
DecimalFractionalDigits
Returns an integer indicating the total number of fractional digits (if the column is defined
as a decimal).
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
Z9 (explicit)
Z9 (explicit)
Associated View
Columns[X]
ColumnStats
IndexStats
MultiColumnStats
ColumnsV[X]
ColumnStatsV
IndexStatsV
MultiColumnStatsV
Column Name
Description
DecimalTotalDigits
Returns an integer indicating the total number of decimal digits (if the column is defined as
a decimal).
Data Type
Data Dictionary
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
Z9 (explicit)
Z9 (explicit)
Associated View
Columns[X]
ColumnStats
IndexStats
MultiColumnStats
ColumnsV[X]
ColumnStatsV
IndexStatsV
MultiColumnStatsV
197
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
DefaultAccount
Returns the name of the default account, if any, for the user.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
Users
UsersV
Returns the name of the default account, if any, for the profile.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
ProfileInfo[X]
ProfileInfoV[X]
Column Name
Description
DefaultCharSet
Returns the name of the character set to be used as the default for this client system.
These are the values:
• EBCDIC
• ASCII
• The name of a user-defined character set as displayed in the CharSets view.
Data Type
198
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
HostsInfo
HostsInfoV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
DefaultCharType
Returns the type of the user default character type.
These are the values:
•
•
•
•
•
1 - Latin
2 - Unicode
3 - KanjiSJIS
4 - Graphic
5 - Kanji1
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
Users
UsersV
Column Name
Description
DefaultCollation
Returns the default collation for the user as defined in a CREATE/MODIFY USER
statement; if not defined, the DefaultCollation is the collation of the logon client system.
These are the values:
•
•
•
•
•
•
A = ASCII
E = EBCDIC
H = Host
M = Multinational
C = CharSet_Coll
J = JIS_Coll
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Users
UsersV
199
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
DefaultDatabase
Returns the name of the current default database for the user.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
SessionInfo[X]
SessionInfoV[X]
Returns the name of the current default database used in the query.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
QryLog
QryLogTDWM
QryLogV
QryLogTDWMV
Returns the name of the default database for the user as defined in a CREATE/MODIFY
USER statement; if not defined, the DefaultDatabase is the user space and the value returned
is NULL.
Note that at logon, this may be superseded by a default account in a profile, if the user has a
profile, and the profile specifies a default account.
Data Type
200
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
Users
UsersV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
DefaultDateForm
Returns either an INTEGERDATE or ANSIDATE that is set for a USER with the CREATE or
MODIFY statement.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
CHAR(1)
LATIN
UPPERCASE
Format
X(1)
X(1)
Associated View
Users
UsersV
Column Name
Description
DefaultDB
Returns the name of the default database.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
ProfileInfo[X]
ProfileInfoV[X]
Column Name
Description
DefaultOpt
Indicates whether this is a default rule.
Data Type
Unicode View
CHAR(1) LATIN
UPPERCASE
Data Dictionary
Format
X(1)
Associated View
RepCaptureRulesV
201
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
DefaultRole
Returns whether a role is a default role for the grantee.
If the grantee is a USER and has the role as his default role, DefaultRole is ’Y’; otherwise, the
value is ’N.’
Data Type
Compatibility View
Unicode View
VARCHAR(1)
UNICODE
VARCHAR(1)
UNICODE
Format
X(1)
X(1)
Associated View
RoleMembers[X]
RoleMembersV[X]
Column Name
Description
DefaultValue
Returns any default value assigned to the column or parameter.
Data Type
Compatibility View
Unicode View
VARCHAR(1024)
UNICODE
VARCHAR(1024)
UNICODE
Format
X(1024)
X(1024)
Associated View
Columns[X]
ColumnsV[X]
Column Name
Description
DelAmpCount
Returns the number of AMPs reconfig deleted.
Data Type
Unicode View
SMALLINT
202
Format
ZZZZ9
Associated View
ReconfigInfoV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
DelayedQueries
Returns the number of queries that are delayed for this WD.
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Column Name
Description
DelayTime
Indicates whether the query was delayed by the Teradata dynamic workload management
software.
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWM
QryLogTDWMV
Column Name
Description
DelayedCount
Indicates how many of all the queries that were completed in the summary interval for the
WD were delayed.
Data Type
Data Dictionary
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWMSum
QryLogTDWMSumV
203
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
Description
Returns the description of the Reconfig.
Data Type
Unicode View
VARCHAR(512) UNICODE
NOT CASESPECIFIC
Format
X(512)
Associated View
ReconfigInfoV
Column Name
Description
DeterministicOpt
Returns whether the function returns the same results for identical inputs or not.
These are the values:
• Y = deterministic
• N = not deterministic
The default is N.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Functions[X]
FunctionsV[X]
Column Name
Description
DiskIO
Returns the total number of reads and writes to disk by each AMP in the system (or the total
for all AMPs if the sum aggregate is specified).
Data Type
204
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
---,---,---,--9 (explicit)
---,---,---,--9 (explicit)
Associated View
AMPUsage[X]
AMPUsageV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
DupeDumpSet
Returns a code to indicate whether the dump event created a duplicate archive dataset.
These are the values:
• Y = Yes for a duplicate dataset
• N = No for a single dataset; the first dataset created
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
Events[X]
Events_Media[X]
RCC_Media[X]
EventsV[X]
Events_MediaV[X]
RCC_MediaV[X]
Column Name
Description
E2I
Returns the client system (external) to Teradata Database (internal) Hex translation codes.
Data Type
Compatibility View
Unicode View
BYTE(256)
NOT NULL
BYTE(256)
NOT NULL
Format
X(512)
X(512)
Associated View
CharTranslations
CharTranslationsV
Column Name
Description
E2IUp
Returns the client system (external) to Teradata Database (internal) and uppercase Hex
translation codes.
Data Type
Data Dictionary
Compatibility View
Unicode View
BYTE(256)
NOT NULL
BYTE(256)
NOT NULL
Format
X(512)
X(512)
Associated View
CharTranslations
CharTranslationsV
205
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ElapsedTime
Returns the difference between last response time and start time.
Data Type
Compatibility View
Unicode View
INTERVAL HOUR TO
SECOND
INTERVAL HOUR TO
SECOND
Format
-h(2):mm:ss.s(6)
-h(2):mm:ss.s(6)
Associated View
QryLog
QryLogV
Data Type
Compatibility View
Unicode View
INTERVAL HOUR TO
SECOND
INTERVAL HOUR TO
SECOND
Format
-h(4):mm:ss.s(6)
-h(4):mm:ss.s(6)
Associated View
QryLogSteps
QryLogStepsV
Column Name
Description
EnabledFlag
Returns a code that indicates whether the trigger is enabled or disabled.
These are the values:
• Y = Yes (default)
• N = No
Data Type
206
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Triggers[X]
TriggersV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
EndCalcHBTimeStamp
Returns the timestamp at which reconfig Phase 1(Calculate Hash Buckets) ends.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
EndDelHBNewTimeStamp
Returns the timestamp at which reconfig Phase 4.9.2 (Delete New Hash Bucket Maps) ends.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
EndDelTimeStamp
Returns the timestamp at which the reconfig Deletion phase ends.
Data Type
Unicode View
TIMESTAMP(0)
Data Dictionary
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
207
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
EndFBHBNewTimeStamp
Returns the timestamp at which reconfig Phase 4.4 (Update New Backup Hash Buckets)
ends.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
EndPHBNewTimeStamp
Returns the timestamp at which reconfig Phase 4.3 (Update New Primary Hash Buckets)
ends.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
EndRedistTimeStamp
Returns the timestamp at which the reconfig Redistribution phase ends.
Data Type
Unicode View
TIMESTAMP(0)
208
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
EndTimeStamp
For ReconfigTableStatsV, returns the timestamp for the end of the reconfig phase for this
table.
For ReconfigInfoV, returns the timestamp for the end of the Reconfiguration.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigTableStatsV
ReconfigInfoV
Column Name
Description
EndVProcCfgTimeStamp
Returns the timestamp at which the final reconfig phase (Update VprocCfg GDO) ends.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
EndWrBkupIdTimeStamp
Returns the timestamp at which reconfig Phase 4.9 (Update Backup-IDs-Array) ends.
Data Type
Unicode View
TIMESTAMP(0)
Data Dictionary
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
209
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
EndWrBMTimeStamp
Returns the timestamp at which reconfig Phase 4.9.1 (Update BMHashTbl GDO) ends.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
EndWrCfgNewTimeStamp
Returns the timestamp at which reconfig Phase 4.8 (Update New Configuration Map) ends.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
EndWrCfgTimeStamp
Returns the timestamp at which reconfig Phase 4.7 (Update Current Configuration Map)
ends.
Data Type
Unicode View
TIMESTAMP(0)
210
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
EndWrFBHBTimeStamp
Returns the timestamp at which reconfig Phase 4.6 (Update Current Backup Hash Buckets)
ends.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
EndWrPHBTimeStamp
Returns the timestamp at which reconfig Phase 4.5 (Update Current Primary Hash Buckets)
ends.
Data Type
Unicode View
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
Column Name
Description
EndWrSpaceTimeStamp
Returns the timestamp at which reconfig Phase 4.1 (Store Database Space Info) ends.
Data Type
Unicode View
TIMESTAMP(0)
Data Dictionary
Format
YYYY-MM-DDBHH:MI: SS
Associated View
ReconfigInfoV
211
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
EntryID
Returns the internal ID of the causing construct.
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogEventHis
QryLogEventHisV
Column Name
Description
EntryKind
Indicates what kind of event-related construct caused something to happen.
These are the values:
•
•
•
•
•
EVENT
EXPRESSION
SYSCON
OPENV
STATE
Data Type
Compatibility View
Unicode View
CHAR(10)
LATIN
NOT CASESPECIFIC
CHAR(10)
LATIN
NOT CASESPECIFIC
Format
X(10)
X(10)
Associated View
QryLogEventHis
QryLogEventHisV
Column Name
Description
EntryName
Returns the name of the causing construct.
Data Type
212
Compatibility View
Unicode View
VARCHAR(128)
UNICODE
NOT CASESPECIFIC
VARCHAR(128)
UNICODE
NOT CASESPECIFIC
Format
X(128)
X(128)
Associated View
QryLogEventHis
QryLogEventHisV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
EntryTS
Returns the timestamp when the entry occurred.
Data Type
Compatibility View
Unicode View
TIMESTAMP(2)
NOT NULL
TIMESTAMP(2)
NOT NULL
Format
YYYY-MM-DDBHH:MI:SS.S(F)Z
YYYY-MM-DDBHH:MI:SS.S(F)Z
Associated View
QryLogEventHis
QryLogEventHisV
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLog
QryLogV
Column Name
Description
ErrorCode
Returns an error code.
Data Type
Column Name
Description
ErrorCount
Returns the number of queries that finished in this WD in this interval (dashboard or logging)
with an error code > 0 but not 3158 (Teradata dynamic workload management software
notification) or 3156 (Teradata dynamic workload management software abort).
Note: Dashboard interval is used for the API data, and logging interval is used for logging data to
the disk.
Data Type
Data Dictionary
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWMSum
QryLogTDWMSumV
213
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ErrorText
Returns the text from the error if ErrorCode is not 0.
Data Type
Compatibility View
Unicode View
CHAR(255)
LATIN/KANJI1
VARCHAR(1024)
UNICODE
Format
X(255)
X(255)
Associated View
QryLog
QryLogExceptions
QryLog[V]
QryLogExceptionsV
Column Name
Description
ErrTblDbName
Returns the name of the database where the error table resides.
Data Type
Unicode View
VARCHAR(128)
UNICODE
NOT NULL
Format
X(128)
Associated View
ErrorTblsV[X]
Column Name
Description
ErrTblName
Returns the name of the error table.
Data Type
Unicode View
VARCHAR(128)
UNICODE
NOT NULL
214
Format
X(128)
Associated View
ErrorTblsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
EstCPUCost
Returns an estimate (from the optimizer) of the milliseconds of CPU time for the step.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZ,ZZZ,ZZ9.999
ZZ,ZZZ,ZZ9.999
Associated View
QryLogSteps
QryLogStepsV
Column Name
Description
EstDeleteSecs
Returns the estimated Deletion/NUSI Rebuild elapsed time.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
ReconfigInfoV
Column Name
Description
EstHRCost
Returns an estimate (from the optimizer) of other costs for the step.
There is no comparable actual data for this estimate.
Data Type
Data Dictionary
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZ,ZZZ,ZZ9.999
ZZ,ZZZ,ZZ9.999
Associated View
QryLogSteps
QryLogStepsV
215
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
EstIOCost
Returns an estimate (from the optimizer) of service time in milliseconds for IO for the step.
There is no comparable actual data for this estimate.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZ,ZZZ,ZZ9.999
ZZ,ZZZ,ZZ9.999
Associated View
QryLogSteps
QryLogStepsV
Column Name
Description
EstNetCost
Returns an estimate (from the optimizer) of the BYNET service time in milliseconds for the
step.
There is no comparable actual data for this estimate.
Data Type
216
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZ,ZZZ,ZZ9.999
ZZ,ZZZ,ZZ9.999
Associated View
QryLogSteps
QryLogStepsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
EstProcTime
Returns the estimated processing time from the Optimizer.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---,---,--9.999
----,---,---,---,--9.999
Associated View
QryLogSteps
QryLogStepsV
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZ,ZZZ,ZZ9.999
ZZ,ZZZ,ZZ9.999
Associated View
QryLog
QryLogV
Column Name
Description
EstRedistSecs
Returns the estimated Redistribution phase time in seconds.
Data Type
Unicode View
FLOAT
NOT NULL
Data Dictionary
Format
----,---,---,---,--9
Associated View
ReconfigInfoV
ReconfigTableStatsV
217
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
EstRemainDeleteSecs
Returns the estimated remaining time (in seconds) for the Deletion/Rebuild NUSI phase.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigInfoV
Column Name
Description
EstRemainRedistSecs
Returns the estimated remaining time (in seconds) for the Redistribution phase.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigInfoV
Column Name
Description
EstRowCount
Returns the estimated row count from the Optimizer.
Data Type
218
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---,---,--9
----,---,---,---,--9
Associated View
QryLogSteps
QryLogStepsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
E_TableId
Returns the identifier for the materialized (effective) temporary table for a base global
temporary table.
Data Type
Compatibility View
Unicode View
BYTE(6)
NOT NULL
BYTE(6)
NOT NULL
Format
X(12)
X(12)
Associated View
AllTempTables[X]
AllTempTablesV[X]
Column Name
Description
Event
Returns a description of the type of action, using the following descriptions:
• Logon
• Logoff
• Logon failed
The value "Logon failed" means a logon failed for reasons other than "Bad User," "Bad
Account," or "Bad Password." Currently, those other reasons are a failure to conform to
Logon Rules or an attempt to log on without a password, where the TDP logon exit does
not approve the logon.
• Bad user
• Bad account
The value "Bad account" means the user provided an account string during logon time,
but that string does not match any of the account names specified for the user in the
CREATE USER or MODIFY USER SQL statement.
• Bad password
• Bad profile
The external profile associated with the logon request does not exist. External profiles are
stored in the directory server.
• Forced Off (indicates that the user session was terminated from the Teradata Database
console or the PM/API).
• IP restriction
User is not permitted to log on from the IP address used.
• Authentication failed
TDGSS has failed to authenticate the user.
• Bad authentication
Other authentication errors: bad authentication field, deprecated logons, decryption
failure, and so forth.
Data Dictionary
219
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
Event
(Continued)
Data Type
Compatibility View
Unicode View
CHAR(12)
LATIN
NOT NULL
CHAR(12)
LATIN
NOT NULL
Format
X(12)
X(12)
Associated View
LogOnOff[X]
LogOnOffV[X]
Returns a code to signify which of the following SQL statements fires the trigger:
• U = UPDATE
• I = INSERT
• D = DELETE
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Triggers[X]
TriggersV[X]
Column Name
Description
EventCode
Returns a Teradata error code.
Data Type
220
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogEvents
QryLogEventsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
EventCount
Returns the number of duplicate rows (that is, same occurrences) that preceded
a’LAST-occurrence- only’ row.
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
AccessLog
AccessLogV
Column Name
Description
EventInfo
Returns information about the event that occurred.
Data Type
Data Dictionary
Compatibility View
Unicode View
VARCHAR(200)
LATIN/KANJI1
VARCHAR(200)
UNICODE
Format
X(200)
X(200)
Associated View
QryLogEvents
QryLogEventsV
221
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
EventNum
Returns the client system event number of the restore operation.
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
Association[X]
AssociationV[X]
Returns the value assigned by the Teradata Database to each user archive or recovery
statement processed.
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
Events[X]
RCC_Media[X]
Events_Configuration[X]
Events_Media[X]
EventsV[X]
RCC_MediaV[X]
Events_ConfigurationV[X]
Events_MediaV[X]
Returns the value assigned by the Teradata Database to each utility function performed or
CHECKPOINT statement processed.
Data Type
222
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
RCC_Configuration[X]
RCC_ConfigurationV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
EventSubCode
This field is reserved for future use.
The value will be 0.
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogEvents
QryLogEventsV
Column Name
Description
Event_Tag
(Title: Event Tag)
Returns an integer value made up of the subsystem ID, the event code, and the subevent code. The
event tag is a unique identifier for the type of event that occurred.
For Database Query Manager, the Event_Tag contains the error code for the DBQM error that
occurred. You can find the text of the error in the Text column. (The text of the error possibly
spreads over multiple lines, so you must use the line number to extract it.)
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
Z99-99999-99
Z99-99999-99
Associated View
Software_Event_Log
Software_Event_LogV
Column Name
Description
EventTime
Identifies the time when the event occurred.
Data Type
Data Dictionary
Compatibility View
Unicode View
TIMESTAMP(2)
NOT NULL
TIMESTAMP(2)
NOT NULL
Format
YYYY-MM-DDBHH:MI:SS.S(F)Z
YYYY-MM-DDBHH:MI:SS.S(F)Z
Associated View
QryLogEvents
QryLogEventsV
223
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
EventType
Returns the type of event that occurred.
These are the values:
•
•
•
•
•
•
CHECKPOINT
RESTORE
DELETE
ROLLBACK
DUMP
ROLLFORWARD
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN
NOT NULL
CHAR(30)
LATIN
NOT NULL
Format
X(30)
X(30)
Associated View
Events[X]
Events_Configuration[X]
Events_Media[X]
EventsV[X]
Events_ConfigurationV[X]
Events_MediaV[X]
Column Name
Description
EventValue
Returns the current (latest) value of the primary event criterion, such as number of AMP
Worker Tasks (AWTs).
Data Type
224
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---, ---,--9
----,---,---, ---,--9
Associated View
QryLogEventHis
QryLogEventHisV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ExceptionAbCount
Returns the number of queries that were aborted due to an exception action for this WD
during this interval.
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Column Name
Description
ExceptionAction
Specifies the action taken from the list below.
•
•
•
•
•
•
A - Abort. Cannot be combined with other actions.
C - Change workload definition. NewWlcId contains the new WD.
L - Log.
E - Execute Program. ExProgram contains the program name.
T - Alert. ExAlert contains to alert name.
N - No action. Cannot be combined with other actions. This option disables exception
detection.
• S - Abort if the statement is a SELECT and no update has been done in the current (user)
transaction.
• Q - Post to queue table.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(10)
LATIN
NOT CASESPECIFIC
CHAR(10)
LATIN
NOT CASESPECIFIC
Format
X(10)
X(10)
Associated View
QryLogExceptions
QryLogExceptionsV
225
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ExceptionCoCount
Returns the number of queries that encountered an exception but continued in this WD
during this interval.
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Column Name
Description
ExceptionCode
Returns the error code encountered.
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogExceptions
QryLogExceptionsV
Column Name
Description
ExceptionCount
Returns the number of queries with exceptions in this WD in this collection period.
Data Type
226
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ExceptionMvCount
Returns the number of queries that moved to another WD due to an exception action for this WD
during this interval.
Data Type
ExceptionSubCode
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Returns an additional error code to further define the situation.
These codes have not yet been defined.
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogExceptions
QryLogExceptionsV
Column Name
Description
ExceptionTime
Returns the time when the query encountered an exception.
Data Type
Data Dictionary
Compatibility View
Unicode View
TIMESTAMP(2)
NOT NULL
TIMESTAMP(2)
NOT NULL
Format
YYYY-MM-DDBHH:MI:SS.S(F)Z
YYYY-MM-DDBHH:MI:SS.S(F)Z
Associated View
QryLogExceptions
QryLogExceptionsV
227
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ExceptionValue
Specifies what type of exception occurred from the following list:
0x00000001 - Exception time limit exceeded.
0x00000002 - CPU time (AMP and PE) limit exceeded.
0x00000004 - Blocked time limit exceeded.
0x00000008 - Disk to CPU ratio exceeded.
0x00000010 - AMP CPU skew limit exceeded.
0x00000020 - AMP I/O count limit exceeded.
0x00000040 - AMP I/O skew limit exceeded.
0x00000080 - Max row count (for a step) exceeded.
0x00000100 - Max row count (for a query) exceeded.
0x00000200 - Spool space limit exceeded.
0x00000400 - Number of AMPs used in query exceeded.
These values show up as an integer. A conversion to hex is used to extract the bit values. For
example - a value of 1024 converted to hex is 400.
Data Type
228
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogExceptions
QryLogTDWM
QryLogExceptionsV
QryLogTDWMV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ExecProtectionMode
Returns whether the function can be executed directly with a call statement (not protected)
or indirectly as a separate process (protected).
These are the values:
• P = protected mode
• U = unprotected mode
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Functions[X]
FunctionsV[X]
Indicates the execution protection mode of an External Stored Procedure.
These are the values:
• P = protected mode
• U = unprotected mode
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
ExternalSPs[X]
ExternalSPsV[X]
Column Name
Description
ExpandAcctString
Returns the expanded logon string of the user.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
UNICODE
CHAR(30)
UNICODE
Format
X(30)
X(30)
Associated View
QryLog
QryLogV
229
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ExpirePassword
Returns the number of days to elapse before the password expires. 0 indicates the password
does not expire.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
SecurityDefaults
SecurityDefaultsV
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
ProfileInfo[X]
ProfileInfoV[X]
Column Name
Description
ExpiredPassword
Returns a code that indicates whether or not the defined session is in the process of a logon
for a user with an expired password.
These are the values:
• Y = Yes, by Session Control procedures
• N = No, by the Parser when a new password is assigned to the user
Data Type
230
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
CHAR(1)
LATIN
UPPERCASE
Format
X(1)
X(1)
Associated View
SessionInfo[X]
SessionInfoV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ExplainFlag
(Title: Explain)
The following codes are used:
T = Explain text is stored in DBC.DBQLExplainTbl
F = No Explain text is provided
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
DBQLRules
DBQLRulesV
Column Name
Description
ExplainText
Returns a full Explain Text segment.
Data Type
Compatibility View
Unicode View
VARCHAR(31000)
UNICODE
NOT NULL
VARCHAR(31000)
UNICODE
NOT NULL
Format
X(31000)
X(31000)
Associated View
QryLogExplain
QryLogExplainV
Column Name
Description
ExpRowNo
Needed in case multiple rows are used for Explain text.
If the additional Explain text uses more than 31000 characters, the system generates multiple
rows.
Data Type
Data Dictionary
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogExplain
QryLogExplainV
231
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ExternalName
Returns the external name of a function.
For SQL UDFs, the value is always SQLUDF.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN
CASESPECIFIC
NOT NULL
CHAR(30)
LATIN
CASESPECIFIC
NOT NULL
Format
X(128)
X(128)
Associated View
Functions[X]
ExternalSPs[X]
Functions[X]
ExternalSPsV[X]
Column Name
Description
ExternalProcedureId
Specifies the unique ID of an External Stored Procedure.
Data Type
Compatibility View
Unicode View
BYTE(6)
NOT NULL
BYTE(6)
NOT NULL
Format
X(12)
X(12)
Associated View
ExternalSPs[X]
ExternalSPsV[X]
Column Name
Description
ExternalProcedureName
Identifies the name of an External Stored Procedure.
Data Type
232
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
UPPERCASE
NOT NULL
Format
X(30)
X(128)
Associated View
ExternalSPs[X]
ExternalSPsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ExtFileReference
Saves the external file reference provided in the CREATE/REPLACE FUNCTION or external
stored procedure statement.
Data Type
Compatibility View
Unicode View
VARCHAR(1000)
LATIN/KANJI1
CASESPECIFIC
VARCHAR(1000)
UNICODE
CASESPECIFIC
Format
X(1000)
X(255)
Associated View
Functions[X]
ExternalSPs[X]
FunctionsV[X]
ExternalSPsV[X]
Compatibility View
Unicode View
VARCHAR(200)
LATIN/KANJI1
VARCHAR(200)
UNICODE
Format
X(200)
X(200)
Associated View
QryLogExceptions
QryLogExceptionsV
Column Name
Description
ExtraInfo
Used to track queries.
Data Type
Column Name
Description
ExtRole
Stores comma-delimited names of directory-assigned roles.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
RoleInfo[X]
RoleInfoV[X]
233
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
FallbackFlag
Returns one of the following values:
• Y = FallBack table (Default)
• N = Non-FallBack table
Data Type
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
NOT NULL
Format
X(1)
Associated View
ReconfigTableStatsV
Column Name
Description
FieldStatistics
Returns the statistics for a column in a table.
Data Type
Format
Compatibility View
Unicode View
VARBYTE (16383)
VARBYTE (16383)
X(255)
X(255)
Associated View
Column Name
Description
FinalWDID
Returns the WD in which the query completed the execution.
Data Type
Compatibility View
Unicode View
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
234
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
FirstStepTime
Returns the time the first step for this query is dispatched.
Data Type
Compatibility View
Unicode View
TIMESTAMP(2)
NOT NULL
TIMESTAMP(2)
NOT NULL
Format
YYYY-MMDDBHH:MI:SS.S(F)Z
Associated View
QryLog
QryLogV
Column Name
Description
FreqofUse
Returns the count of the number of optimizer references to the object from the parse tree.
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogObjects
QryLogObjectsV
Column Name
Description
Frequency
Returns the specified logging frequency, which is determined by the rule that caused this
entry (see AccLogRules view).
These are the values:
•
•
•
•
B = Both FIRST and LAST occurrences
E = EACH occurrence
F = FIRST occurrence only
L = LAST occurrence only
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
AccessLog
AccessLogV
235
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
FSGIOCount
Returns the count of IOs done at the reconfig FSG (File Segment Group) cache.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
Column Name
Description
FSysMiscCount
Returns the count of miscellaneous reconfig file system operations.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
Column Name
Description
FSysReadCount
Returns the count of reconfig file system Read operations.
Data Type
Unicode View
FLOAT
NOT NULL
236
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
FSysWriteCount
Returns the count of reconfig file system Write operations.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
Column Name
Description
FunctionId
Returns the unique ID of a function.
Data Type
Compatibility View
Unicode View
BYTE(6)
NOT NULL
BYTE(6)
NOT NULL
Format
X(12)
X(12)
Associated View
Functions[X]
FunctionsV[X]
Column Name
Description
FunctionName
Returns the user-assigned name in internal format.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
UPPERCASE
NOT NULL
Format
X(30)
X(128)
Associated View
Functions[X]
FunctionsV[X]
237
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
FunctionType
Returns the type of function.
These are the values:
•
•
•
•
•
A = aggregate function
B = combined aggregate and statistical function
F = scalar function
R = table function
S = statistical function
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Functions[X]
FunctionsV[X]
Column Name
Description
GLOPSetDatabaseName
Returns the name of the database to which the GLOP set belongs for the member clause.
Data Type
238
Compatibility View
Unicode View
VARCHAR(128)
UNICODE
UPPERCASE
VARCHAR(128)
UNICODE
UPPERCASE
Format
X(128)
X(128)
Associated View
ExternalSPs[X]
Functions[X]
ExternalSPsV[X]
FunctionsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
GLOPSetMemberName
Returns the name of the GLOP set to which the XSP/UDF/UDM belongs.
It is zero length when the external routine or UDF/UDM is not a member of the set.
Data Type
Compatibility View
Unicode View
VARCHAR(128)
UNICODE
UPPERCASE
VARCHAR(128)
UNICODE
UPPERCASE
Format
X(128)
X(128)
Associated View
ExternalSPs[X]
Functions[X]
ExternalSPsV[X]
FunctionsV[X]
Column Name
Description
GrantAuthority
Returns the WITH GRANT OPTION attribute of the privilege held by the user.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
AllRights[X]
UserGrantedRights
UserRights
AllRightsV[X]
UserGrantedRightsV
UserRightsV
239
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
Grantee
Returns the name of a user who was granted a privilege; ALL can be specified.
Returns the name of a user or role who was granted a role.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
NOT NULL
CHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
UserGrantedRights
RoleMembers[X]
UserGrantedRightsV
RoleMembersV[X]
Column Name
Description
GranteeKind
Returns the kind of a grantee. It is either User or Role.
Data Type
Compatibility View
Unicode View
VARCHAR(4)
UNICODE
NOT NULL
VARCHAR(4)
UNICODE
NOT NULL
Format
X(4)
X(4)
Associated View
RoleMembers[X]
RoleMembersV[X]
Column Name
Description
Grantor
Returns the name of the user who granted the role.
Data Type
240
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
RoleMembers[X]
RoleMembersV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
GrantorName
Returns the name of the grantor who granted the privilege.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
AllRights[X]
UserRights
AllRoleRights
UserRoleRights
AllRightsV[X]
UserRightsV
AllRoleRightsV
UserRoleRightsV
Column Name
Description
GrantStatus
Indicates whether the rule grants the CONNECT THROUGH privilege (G), or whether it
has been revoked (R).
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
ConnectRules
ConnectRulesV
Column Name
Description
GroupName
Returns the name of a replication group.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
RepTables[X]
RepTablesV[X]
RepCaptureRulesV
241
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
HighByteCount
Returns the highest count of bytes processed by an AMP.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
Column Name
Description
HighByteCountAmp
Returns the number of the AMP with the highest byte count.
Data Type
Unicode View
SMALLINT
Format
ZZZZ9
Associated View
ReconfigTableStatsV
Column Name
Description
HighCPUSecsCount
Returns the highest count of CPU seconds used by an AMP.
Data Type
Unicode View
FLOAT
NOT NULL
242
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
HighCPUSecsCountAmp
Returns the number of the AMP with the highest CPU seconds count.
Data Type
Unicode View
SMALLINT
Format
ZZZZ9
Associated View
ReconfigTableStatsV
Column Name
Description
HighHist
Returns the highest value specified as a query execution time differentiation. Used with the
"SUMMARY" SQL option only.
If THRESHOLD is used, HighHist is 0.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NULL
Format
----,---,---,---,--9.999
----,---,---,---,--9.999
Associated View
QryLogSummary
QryLogSummaryV
Column Name
Description
HighIOCount
Returns the highest count of IOs on an AMP.
Data Type
Unicode View
FLOAT
NOT NULL
Data Dictionary
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
243
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
HighIOCountAmp
Returns the number of the AMP with the highest IO count.
Data Type
Unicode View
SMALLINT
Format
ZZZZ9
Associated View
ReconfigTableStatsV
Column Name
Description
HighRowCount
Returns the highest count of rows processed by an AMP.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
Column Name
Description
HighRowCountAmp
Returns the number of the AMP with the highest row count.
Data Type
Unicode View
SMALLINT
244
Format
ZZZZ9
Associated View
ReconfigTableStatsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
HostName
Returns the unique name defined for this client system.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
HostsInfo
HostsInfoV
Column Name
Description
HostNo
Returns the number of the client system through which the user logged on to the Teradata
Database.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
SessionInfo[X]
CSPSessionInfo
AllTempTables[X]
SessionInfoV[X]
CSPSessionInfoV
AllTempTablesV[X]
Column Name
Description
I2E
Returns the Teradata Database (internal) to client system (external) Hex translation codes.
Data Type
Data Dictionary
Compatibility View
Unicode View
BYTE(256)
NOT NULL
BYTE(256)
NOT NULL
Format
X(512)
X(512)
Associated View
CharTranslations
CharTranslationsV
245
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
I2EUp
Returns the Teradata Database (internal) to client system (external) and uppercase Hex
translation codes.
Data Type
Compatibility View
Unicode View
BYTE(256)
NOT NULL
BYTE(256)
NOT NULL
Format
X(512)
X(512)
Associated View
CharTranslations
CharTranslationsV
Column Name
Description
IdColType
Indicates if a column is a regular column or an identity column.
These are the values:
• NULL = non-identity column
• GA = generated always
• GD = generated by default
Data Type
Compatibility View
Unicode View
CHAR(2)
LATIN
UPPERCASE
CHAR(2)
LATIN
UPPERCASE
Format
X(2)
X(2)
Associated View
Columns[X]
ColumnsV[X]
Column Name
Description
IFPNo
Returns the vproc number of the PE through which the session was connected or assigned.
Data Type
246
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
-(5)9
-(5)9
Associated View
AccessLog
LogOnOff[X]
SessionInfo[X]
AccessLogV
LogOnOffV[X]
SessionInfoV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
InconsistencyFlag
A code indicating whether inconsistencies may exist between the definitions of the related
parent-child objects after being restored (using ARC), as follows:
• Y = Yes, the definitions could be inconsistent
• N = No, the definitions are consistent
Note: If Y, it may be possible to validate the reference indexes that have been marked as
inconsistent.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
All_RI_Children[X]
All_RI_Parents[X]
RI_Child_Tables[X]
RI_Distinct_Children[X]
RI_Distinct_Parents[X]
RI_Parent_Tables[X]
All_RI_ChildrenV[X]
All_RI_ParentsV[X]
RI_Child_TablesV[X]
RI_Distinct_ChildrenV[X]
RI_Distinct_ParentsV[X]
RI_Parent_TablesV[X]
Column Name
Description
IndexId
Returns the reference index number.
Note: This is not the same as IndexNumber.
Data Type
Data Dictionary
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
All_RI_Children[X]
All_RI_Parents[X]
RI_Child_Tables[X]
RI_Distinct_Children[X]
RI_Distinct_Parents[X]
RI_Parent_Tables[X]
All_RI_ChildrenV[X]
All_RI_ParentsV[X]
RI_Child_TablesV[X]
RI_Distinct_ChildrenV[X]
RI_Distinct_ParentsV[X]
RI_Parent_TablesV[X]
247
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
IndexName
Returns the name of the reference index.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
All_RI_Children[X]
All_RI_Parents[X]
Indices[X]
RI_Child_Tables[X]
RI_Distinct_Children[X]
RI_Distinct_Parents[X]
RI_Parent_Tables[X]
All_RI_ChildrenV[X]
All_RI_ParentsV[X]
IndicesV[X]
RI_Child_TablesV[X]
RI_Distinct_ChildrenV[X]
RI_Distinct_ParentsV[X]
RI_Parent_TablesV[X]
Returns the name of the index. This field is NULL if the index does not have a name.
Data Type
248
Compatibility View
Unicode View
CHAR(30)
LATIN
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
IndexConstraints[X]
IndexConstraintsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
IndexNumber
Returns an internal number assigned to the index. A primary index has an index number of
1.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
ZZ9 (explicit)
ZZ9 (explicit)
Associated View
Indices[X]
IndicesV[X]
Returns an internal number assigned to the index. A primary index has an index number of
1.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
IndexStats
IndexStatsV
Returns an internal number assigned to the index. A primary index has an index number of
1.
Data Type
Data Dictionary
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
IndexConstraints[X]
IndexConstraintsV[X]
249
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
IndexPresent
Returns Y (yes) or N (no) to indicate whether or not the INDEX option was used in a dump
event.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
CHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
Events[X]
EventsV[X]
Column Name
Description
IndexStatistics
Returns the statistics relating to the index.
Data Type
250
Compatibility View
Unicode View
VARBYTE (16383)
VARBYTE (16383)
Format
X(255)
X(255)
Associated View
IndexStats
IndexStatsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
IndexType
Returns the type of an index as:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
P (Nonpartitioned Primary)
Q (Partitioned Primary)
S (Secondary)
J (join index)
N (hash index)
K (primary key)
U (unique constraint)
V (value ordered secondary)
H (hash ordered ALL covering secondary)
O (valued ordered ALL covering secondary)
I (ordering column of a composite secondary index)
M (Multi-Column Statistics)
D (Derived column partition statistics)
1 (field1 column of a join or hash index)
2 (field2 column of a join or hash index)
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Indices[X]
IndexStats
IndicesV[X]
IndexStatsV
JoinIndicesV
Column Name
Description
InfoData
Returns the attribute identified by the value of the InfoKey field.
Data Type
Data Dictionary
Compatibility View
Unicode View
VARCHAR(16384)
LATIN/KANJI1
VARCHAR(16384)
UNICODE
Format
X(16384)
X(16384)
Associated View
DBCInfo
DBCInfoV
251
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
InfoKey
Returns the key identifying the attribute value in the InfoData field.
Data Type
Compatibility View
Unicode View
VARCHAR(30)
LATIN
NOT NULL
VARCHAR(30)
LATIN
NOT NULL
Format
X(30)
X(30)
Associated View
DBCInfo
DBCInfoV
Column Name
Description
InstallFlag
Returns a code to indicate whether this character set is to be installed as currently available
on the Teradata Database. A maximum of six character sets can be installed at one time.
These are the values:
• Y = Yes
• N = No
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
CharTranslations
CharTranslationsV
Column Name
Description
InterimFldSize
Returns the interim field size defined for an aggregate user-defined function.
Data Type
252
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
Functions[X]
FunctionsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
InternalRequestNum
Returns the internal request number used by the Teradata Database.
For statements other than those within a stored procedure, the internal request number and
the client request number (RequestNum field) are the same.
When a stored procedure is invoked in a session, the internal request number is incremented
by one for every request made by the stored procedure. All other queries issued by the
session also increment the InternalRequestNum value.
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLog
QryLogV
Column Name
Description
IntervalDelayCnt
Returns the number of queries that are currently delayed during this interval.
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Column Name
Description
IOCount
Returns the number of IOs from AMPs that were generated by the step or set of parallel steps
which follow if the second step level is 1. For parallel steps, StepLev2Num is greater than 1.
The first step in a set of parallel steps contains the sum of the IOs.
Data Type
Data Dictionary
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---,---,--9
----,---,---,---,--9
Associated View
QryLogSteps
QryLogStepsV
253
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
JoinIdxDataBaseName
Returns the join index database name.
Data Type
Unicode View
VARCHAR(128)
UNICODE
NOT NULL
Format
X(128)
Associated View
JoinIndicesV
Column Name
Description
JoinIdxName
Returns the join index name.
Data Type
Unicode View
VARCHAR(128)
UNICODE
NOT NULL
Format
X(128)
Associated View
JoinIndicesV
Column Name
Description
Journal_DB
Returns the name of the database or user space in which the default journal table for
DatabaseName resides.
Data Type
254
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Database_Default_Journals[X]
User_Default_Journals[X]
Database_Default_JournalsV[X]
User_Default_JournalsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
JournalFlag
Returns a code to indicate the journaling in effect for the table, or the journal default for the
tables in the user space or in the database. The first character indicates the BEFORE setting
and the second character indicates the AFTER setting.
These are the values:
•
•
•
•
N = No journal (default)
S = Single journal
D = Dual journal
L = Local AFTER journal (not used for BEFORE)
Data Type
Compatibility View
Unicode View
CHAR(2)
LATIN
UPPERCASE
NOT NULL
CHAR(2)
LATIN
UPPERCASE
NOT NULL
Format
X(2)
X(2)
Associated View
Databases[X]
Tables[X]
Users
DatabasesV[X]
TablesV[X]
UsersV
Column Name
Description
JournalName
Returns the name of the journal table defined as the default for UserName.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Database_Default_Journals[X]
Journals[X]
User_Default_Journals[X]
Database_Default_JournalsV[X]
JournalsV[X]
User_Default_JournalsV[X]
255
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
JournalSaved
Returns one of the following codes to indicate whether or not the SAVE option was used in
the event:
• Y = Yes
• N = No
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
CHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
Events[X]
EventsV[X]
Column Name
Description
Journals_DB
Returns the name of the database in which a journal table resides.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Journals[X]
JournalsV[X]
Column Name
Description
JournalUsed
Returns one of the following codes to indicate which part of the journal table was used:
• C = Current
• R = Restored
• S = Saved
Data Type
256
Compatibility View
Unicode View
CHAR(1)
LATIN
CHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
Events[X]
EventsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
Kind
Returns a code that indicates whether the trigger is evaluated for:
• S = the statement (once)
• R = each row changed by the triggering action
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Triggers[X]
TriggersV[X]
Column Name
Description
LastAccessTimeStamp
Returns the time that the corresponding object was last accessed.
Data Type
Data Dictionary
Compatibility View
Unicode View
TIMESTAMP(0)
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI:SS
YYYY-MM-DDBHH:MI:SS
Associated View
Columns[X]
Databases[X]
Indices[X]
Tables[X]
Users
Triggers[X]
ColumnsV[X]
DatabasesV[X]
IndicesV[X]
TablesV[X]
UsersV
TriggersV[X]
257
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LastAlterName
Returns the name of the user who last updated the Data Dictionary row.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Columns[X]
Databases[X]
Indices[X]
Tables[X]
Triggers[X]
Users
ProfileInfo[X]
ColumnsV[X]
DatabasesV[X]
IndicesV[X]
Tables[X]
TriggersV[X]
UsersV
ProfileInfoV[X]
Column Name
Description
LastAlterTimeStamp
Returns the time the Data Dictionary row was last updated.
Data Type
Compatibility View
Unicode View
TIMESTAMP(0)
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI:SS
YYYY-MM-DDBHH:MI:SS
Associated View
Columns[X]
Databases[X]
Indices[X]
Tables[X]
Triggers[X]
Users
ColumnsV[X]
DatabasesV[X]
IndicesV[X]
TablesV[X]
TriggersV[X]
UsersV
Returns the time the Data Dictionary row was last updated.
Data Type
258
Compatibility View
Unicode View
TIMESTAMP(0)
NOT NULL
TIMESTAMP(0)
NOT NULL
Format
YYYY-MM-DDBHH:MI:SS
YYYY-MM-DDBHH:MI:SS
Associated View
ProfileInfo[X]
ProfileInfoV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LastStateChange
Returns the time of the last state change via the Teradata dynamic workload management
software.
Data Type
Compatibility View
Unicode View
TIMESTAMP(2)
TIMESTAMP(2)
Format
YYYY-MM-DDBHH:MI:SS(F)Z
YYYY-MM-DDBHH:MI:SS(F)Z
Associated View
QryLogTDWM
QryLogTDWMV
Column Name
Description
LastValue
Returns the value collected over the last interval for this event.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---, ---,--9
----,---,---, ---,--9
Associated View
QryLogEventHis
QryLogEventHisV
Column Name
Description
LDAP
Indicates whether a session is LDAP-based.
The LDAP column contains "Y" if the session is LDAP-based; otherwise, the column
contains "N."
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
SessionInfo[X]
SessionInfoV[X]
259
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LikeEscape
Returns an optional escape character to be used with LikePattern.
Data Type
Unicode View
CHAR(1) UNICODE
Format
X(1)
Associated View
RepCaptureRulesV
Column Name
Description
LikePattern
Returns a pattern string that is matched using the LIKE operator to the names of objects of
the specified kind.
Data Type
Unicode View
VARCHAR(300) UNICODE
Format
X(300)
Associated View
RepCaptureRulesV
Column Name
Description
Line
Returns the number that corresponds to the line of text for a multi-line error message.
For Database Query Manager, the Line column identifies sequential portions of the error
message that may be spread over multiple lines.
Data Type
260
Compatibility View
Unicode View
BYTEINT
NOT NULL
BYTEINT
NOT NULL
Format
ZZ9
ZZ9
Associated View
Software_Event_Log
Software_Event_LogV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LineNo
Returns the number that corresponds to the running sequence number of the multiple rows
of text stored in DBC.TextTbl.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
TableText[X]
TableTextV[X]
Column Name
Description
LinkingEventNum
Returns the terminating event number specified by the user for a rollforward or
rollbackward event.
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
Events[X]
EventsV[X]
Column Name
Description
LockedCount
Returns the number of successive unsuccessful attempts to logon to the user with an
erroneous password. A null or 0 value indicates there have been no attempts since the last
successful logon.
Data Type
Data Dictionary
Compatibility View
Unicode View
BYTEINT
BYTEINT
Format
---9
---9
Associated View
Users
UsersV
261
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LockedDate
Returns the Julian date on which the Dbase row was locked to logons due to excessive
erroneous passwords. A null or 0 value indicates the row was never locked.
Data Type
Compatibility View
Unicode View
DATE
DATE
Format
YY/MM/DD
YY/MM/DD
Associated View
Users
UsersV
Column Name
Description
LockedTime
Returns the time (number of minutes after midnight) when the Dbase row was locked to
logons due to excessive erroneous passwords. Value = 0 through 1439; a null or 0 value
indicates the row was never locked.
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
99:99
99:99
Associated View
Users
UsersV
Column Name
Description
LockedUserExpire
Returns the number of minutes to elapse before a locked user is unlocked.
0 indicates immediate unlock.
-1 indicates user is locked indefinitely.
Data Type
262
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
SecurityDefaults
SecurityDefaultsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LockedUserExpire
(Continued)
Returns the number of minutes to elapse before a locked user is unlocked.
0 indicates immediate unlock.
-1 indicates user is locked indefinitely.
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
ProfileInfo[X]
ProfileInfoV[X]
Column Name
Description
LockMode
Returns a code to indicate the type of lock used by the event. The codes are as follows:
• A = ACCESS or Group READ
• R = full READ
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
CHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
Events[X]
EventsV[X]
Column Name
Description
LogDate
Returns the date that the access log entry was made.
Data Type
Data Dictionary
Compatibility View
Unicode View
DATE
NOT NULL
DATE
NOT NULL
Format
YY/MM/DD
YY/MM/DD
Associated View
AccessLog
LogOnOff[X]
SecurityLog[X]
AccessLogV
LogOnOffV[X]
SecurityLogV[X]
263
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogDate
(Continued)
Returns any calendar date that precedes the current date by more than 30 days.
Data Type
Compatibility View
Unicode View
DATE
NOT NULL
DATE
NOT NULL
Format
YY/MM/DD
YY/MM/DD
Associated View
DeleteAccessLog[X]
DeleteAccessLogV[X]
Column Name
Description
LogicalHostId
Returns a unique identifier of the logon source for the logged query.
A value of zero indicates an internal session.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
ZZZ9 (explicit)
ZZZ9 (explicit)
Associated View
AccessLog
QryLog
AccessLogV
QryLogV
Returns the ID of the client system from which the session logged on to the Teradata
Database.
Data Type
264
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
ZZZ9
ZZZ9
Associated View
QryLogExceptions
QryLogEvents
QryLogSummary
QryLogExceptionsV
QryLogEventsV
QryLogSummaryV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogicalHostId
(Continued)
Returns the ID of the client system that had the in-doubt transaction.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
DeleteOldInDoubt
InDoubtLog
DeleteOldInDoubtV
InDoubtLogV
Returns the identifier of the client system connection as defined by the hardware
configuration data.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
ZZZ9
ZZZ9
Associated View
HostsInfo
HostsInfoV
Returns the number of the client system through which the user logged on to the Teradata
Database.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
ZZZ9
ZZZ9
Associated View
LogOnOff[X]
LogOnOffV[X]
Returns the client system identifier, as defined by the hardware configuration data, to which
the rule applies.
Data Type
Data Dictionary
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
ZZZ9 (explicit)
ZZZ9 (explicit)
Associated View
LogonRules
LogonRulesV
265
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogicalHostId
(Continued)
Returns the identity of the client system connector, based on the hardware configuration
data, through which the user logged on.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
ZZZ9
ZZZ9
Associated View
SessionInfo[X]
SessionInfoV[X]
Column Name
Description
LogLevel
Indicates whether the online archive logging is activated at either a table level or database
level.
These are the values:
• T = Online Archive Logging was activated at table level.
• D = Online Archive Logging was activated at database level.
• O = Non-table objects.
Data Type
Unicode View
CHAR(1)
LATIN
NOT NULL
266
Format
X(1)
Associated View
ArchiveLoggingObjsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogonAcct
Returns the account string used when a session is established.
This is the explicit account name provided when a user logged on or, if no account name was
provided at logon, as determined as follows:
• If the user is assigned to a profile, and that profile has a default account name (that is, the
default account name for the profile is not null), then the default account name from that
profile is used.
• If the user is not assigned to a profile, or the user is assigned to a profile and the default
account name for that profile is null, the default account name, if any, assigned to the
user is used.
• If the user does not have a default account name, then the name of the user is used.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
SessionInfo[X]
SessionInfoV[X]
Column Name
Description
LogonDate
Returns the date that the session for which the log entry was made was logged on to the
Teradata Database.
Data Type
Compatibility View
Unicode View
DATE
NOT NULL
DATE
NOT NULL
Format
YY/MM/DD
YY/MM/DD
Associated View
AccessLog
AccessLogV
Returns the date on which logon for the session occurred.
Data Type
Data Dictionary
Compatibility View
Unicode View
DATE
NOT NULL
DATE
NOT NULL
Format
YY/MM/DD
YY/MM/DD
Associated View
LogOnOff[X]
LogOnOffV[X]
267
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogonDate
(Continued)
Returns the date of logon for the session being reported.
Data Type
Compatibility View
Unicode View
DATE
NOT NULL
DATE
NOT NULL
Format
YY/MM/DD
YY/MM/DD
Associated View
SessionInfo[X]
SessionInfoV[X]
Column Name
Description
LogonDateTime
Returns the date and time that the session was logged on.
Data Type
Compatibility View
Unicode View
TIMESTAMP(2)
NOT NULL
TIMESTAMP(2)
NOT NULL
Format
YYYY-MM-DDBHH:MI:SS
YYYY-MM-DDBHH:MI:SS
Associated View
QryLog
QryLogV
Column Name
Description
LogonSequenceNo
Returns the logon sequence number of the session.
Data Type
268
Compatibility View
Unicode View
BYTE(4)
BYTE(4)
Format
X(8)
X(8)
Associated View
SessionInfo[X]
SessionInfoV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogonSource
Returns the origin of the CLIv2 mainframe session being reported, such as the user ID or
session number of the client system. LogonSource can contain the following names and
identifiers.
Channel-Attached Systems
Using the CLIv2 API
Unless otherwise noted, each of the LogonSource string fields contains eight characters.
Field Name
Description
Operating
System Name
Name of the client operating system for this logon.
The valid name is MVS.
(Field 1)
TDP ID
Unique identifier for the mainframe TDP controlling this logon.
(Field 2)
Job Name
This is the job name.
(Field 3)
Environment
Name
(Field 4)
User ID from
Security Product
The valid environments are:
•
•
•
•
BATCH
CICS
IMS
TSO
This is the user ID provided by the security product in use.
If no security product is in use, this is blank.
(Field 5)
Group from
Security Product
This is the group ID provided by the security product in use.
If no security product is in use, this is blank.
(Field 6)
Data Dictionary
269
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogonSource
Channel-Attached Systems
Using the CLIv2 API
Field Name
Description
Program Name
Use of this field is deprecated because it is not possible to determine
whether it specifies an executable application name or a unique
identifier provided by an application using the CLIv2 Workload
specification (see Teradata Call-Level Interface Version 2 Reference for
Mainframe-Attached Systems).
(Field 7)
(Continued)
Instead, you should use the Actual Program Name field, which
provides a reliable name for the executable application.
Coordinator
Name
Name of the Coordinator if the logon is part of a two-phase commit
logon.
(Field 8)
This is used only by the CICS and IMS mainframe transaction
managers; otherwise, it is blank.
Transaction ID
Unique identifier for the transaction as determined by the transaction
manager.
(Field 9)
This is used only by the CICS and IMS mainframe transaction
managers; otherwise, it is blank.
Terminal ID
Unique identifier for the terminal as determined by CICS.
(Field 10)
This is used only for CICS; otherwise, it is blank.
User/Operator
ID
Unique identifier for the user or operator as determined by CICS.
This is used only for CICS; otherwise, it is blank.
(Field 11)
Actual Program
Name
This field contains the name of the executable application.
(Field 12)
Job ID
This field contains the job ID.
(Field 13)
Format ID
(Field 14)
Format identifier that can be used to parse the earlier positional
information in the LogonSource attribute. If the field ends with the
four characters ‘ LSS’, then the format ID is present.
The first set of two characters indicate the number of values found
before the Actual Program Name, which is either 07 or 11.
The second set of two characters indicates the version of the format
ID. If the value is:
• 01, then the field contains the Job ID.
• 02, then the field contains both the Actual Program Name and the
Job ID value.
If no Format ID is present, then no Job ID value exists and only the
first 7 or 11 fields of the LogonSource string are present.
270
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogonSource
The following self-defining EBCDIC items in Field 15 or later have variable lengths and
contain the specified information within the parentheses that follow the field name in the
LogonSource string.
Channel-Attached Systems
Using the CLIv2 API
(Continued)
Data Dictionary
Field
Description
TDP()
TDP release identifier. See Teradata Director Program Reference.
CL2()
CLIv2 release identifier. See Teradata Call-Level Interface Version 2
Reference for Mainframe-Attached Systems.
SESSDESC()
Descriptive information specified by the application using the CLIv2
Session-desc specification. See Teradata Call-Level Interface Version 2
Reference for Mainframe-Attached Systems.
WORKLOAD()
Information specified by the application using the CLIv2 Workload
specification. The information is intended to be used by Teradata
Database. See Teradata Call-Level Interface Version 2 Reference for
Mainframe-Attached Systems.
271
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogonSource
If the length of the self-defining items causes the LogonSource string to exceed 128
characters, Teradata Database truncates them as necessary and indicates the truncation with
the string ‘…)’ if enough space remains to do so.
Channel-Attached Systems
Using the CLIv2 API
Example: MultiLoad job under MVS
(Continued)
MVS TDQ3 ME0121 BATCH PTEP1 SOCAL MULTLOAD MLOAD JOB080541102
LSS,TDP(12.00.00)
Field contents:
Field
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Contents
MVS
TDQ3
ME0121
BATCH
PTEP1
SOCAL
MULTLOAD
blank
blank
blank
blank
MLOAD
JOB08054
1102 LSS
Description
Operating system name
TDP name
Job name
Environment name
User ID from the security product used
User group from the security product used
Program Name
Coordinator name
Transaction identifier
Terminal identifier
User/operator identifier
Actual program name
Job ID
Format ID showing that this is a new
LogonSource type. The value “1101 LSS” means
LSS version 01 with 11 preceding fields.
TDP(12.00.00) TDP release identifier
Note: Older client software might not generate information for all the fields, and does not
contain a Format ID field.
Example: CLIv2 Batch
MVS TDP7
SS18533JBATCH
SS18533 SOCAL
TPUMP
JOB046351102 LSS,TDP(13.10.00)
TPUMP
Example: CLIv2 TSO
MVS TDP7
ASG
TSO
ASG
SOCAL
IKJEFT01TSU051671102 LSS,TDP(13.10.00)
IKJEFT01
Example: CLIv2 CICS
MVS TDP7
SPCICS CICS
JT18524 SOCAL
DFHSIP
CICSUSERDFHSIP JOB048741102 LSS,TDP(13.10.00)
272
C9YT21
T1
3A20
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogonSource
Returns the origin of the CLIv2 network-attached session being reported, such as the user
ID or session number of the client system.
Network-Attached Systems
Using the CLIv2 API
Field Name
Description
Mode
The literal string(TCP/IP), indicating the connection type.
(Field 1)
This field is always 8 characters long.
TCP Port or Socket
Number
Hexadecimal TCP port or socket number on the
network-attached client system.
(Field 2)
This field contains 4 hexadecimal characters. The maximum
length is 64K - 1 characters.
IP Address
IP address of the network-attached client system.
(Field 3)
This field contains a maximum of 16 characters.
TDP ID
Unique identifier for the network TDP controlling this logon.
(Field 4)
The number of characters depends on the value for the TDP ID
that was specified when you logged on.
Client Process ID
Identifier for the process on the network-attached client system.
(Field 5)
This field contains a maximum of 10 decimal digits.
Client User ID
User ID for the logged on user as defined for the network-attached
client system.
(Field 6)
This field contains a maximum of 92 characters.
Client Program
Identifier for the CLIv2-based client program.
(Field 7)
This field contains a maximum of 256 characters.
Format ID
Format identifier that can be used to parse the earlier positional
information in the LogonSource attribute. If the field ends with
the four characters ‘ LSS’, then the format ID is present.
(Field 8)
This field is always 6 characters long.
LSINFO
Optional text derived from the LSINFO environment variable.
(Field 9)
The size of LSINFO depends on how many characters remain
available in LogonSource after fields 1 through 8 have been
assembled.
If the size of LSINFO exceeds the remaining space in
LogonSource, CLIv2 truncates the data to fit the available space.
Data Dictionary
273
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
LogonSource
Description
Example: an archive job
(TCP/IP)
Network-Attached Systems
Using the CLIv2 API
(Continued)
07DC 10.243.71.25 DW_OLD
2482 ROOT ARCMAIN 01 LSS
Field contents:
Field
1
2
3
4
5
6
7
8
Contents
TCP/IP
07DC
10.243.71.25
DW_OLD
2482
ROOT
ARCMAIN
01 LSS
Description
Connection mode
TCP port or societ identifier
IP address of the client system
TDP ID for the TDP making the connection
with Teradata Database for this logon
Client process identifier
Client system user ID
Client program
Format ID
Example: a BTEQ job
(TCP/IP) 0675 141.206.34.18 CS4400S1
IS A TEST!"
2304
AG110058
BTEQ
01 LSS "THIS
Column Name
Description
LogonSource
Returns the origin of the JDBC session being reported, such as the user ID or process ID of
the client system.
JDBC Driver API
When the application writing to LogonSource connects to Teradata Database using the
JDBC driver, the definitions of the LogonSource string fields are as follows.
Field Name
Definition
Mode
The literal string (TCP/IP), indicating the connection type.
(Field 1)
This field is always 8 characters long.
Provided by Teradata Database.
TCP Port or Socket
Number
(Field 2)
Hexadecimal TCP port or socket number on the client system.
This field contains 4 hexadecimal characters. The maximum is
64K - 1 characters.
Provided by Teradata Database.
IP Address
IP address of the client system.
(Field 3)
This field contains a maximum of 16 characters.
Provided by Teradata Database.
274
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
LogonSource
JDBC Driver API
Description
TDP ID
(Field 4)
TDP ID for the TDP making the connection with Teradata
Database for this logon.
This field fills whatever space remains after fields 5 through 8 have
been filled.
(Continued)
This field contains a maximum of 97 characters, and is truncated
to the space remaining after all the other fields have been written.
This field comprises 5 components:
• Teradata Database host name specified by the application.
• SEMICOLON character.
• Host name or IP address of the Teradata Database node that
was connected.
• COLON character.
• Port number of the Teradata Database node that was
connected.
Provided by the Teradata JDBC driver.
Client Process/
Thread ID
(Field 5)
An identifier for the Java process or thread on the client system.
The field contains a maximum of 12 characters.
Because Java threads are not tied to particular database
connections, any thread can execute requests on a connection that
was originally created by a different thread.
To avoid confusion, the Teradata JDBC driver provides a unique
connection ID, which is derived from the hash code of the
connection object.
This field comprises 2 components:
• The four-character literal string CID=.
• The unique connection ID.
Provided by the Teradata JDBC driver.
Client User ID
User ID for the logged on user as defined for the client system.
(Field 6)
This field contains a maximum of 20 characters.
Provided by the Teradata JDBC driver.
Client Program
An identifier for the Java client program.
(Field 7)
This field contains a maximum of 26 characters.
This field comprises 4 components and is retrieved using the
System.getProperty(“java.version”) method:
• The literal string JDBC.
• The JDBC driver version.
• SEMICOLON character.
• The system getProperty version number.
Provided by the Teradata JDBC driver.
Data Dictionary
275
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogonSource
Field Name
Description
JDBC Driver API
Format ID
(Continued)
(Field 8)
A format identifier that can be used to parse the earlier positional
information in the LogonSource attribute. If the field ends with
the four characters ‘ LSS’, then the format ID is present.
This field is always 6 characters long.
For JDBC connections, this value is always 01 LSS.
Provided by the Teradata JDBC driver.
Example: Teradata JDBC Driver
(TCP/IP) 137D 153.64.135.140 CS4400S1;CS4400S1COP1/153.64.208.223:1025
CID=337D0F TN180005 JDBC13.10.00.00;1.4.2_04 01 LSS
Field contents:
Field Contents
1
TCP/IP
2
137D
3
4
5
6
7
8
276
Description
Connection mode
TCP port/societ number on the network
system
153.64.135.140 IP address of the network client system
CS4400S1;CS4400S1COP1/153.64.208.223:1025
TDP ID for the TDP making the connection
with Teradata Database for this logon
CID=337DoF
Client Java process/thread ID
TN180005
Client user ID
JDBC13.10.00.00;1.4.2_o4
Name of the Java client program
01 LSS
Format ID
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogonSource
Returns the origin of the ODBC session being reported, such as the user ID or process ID of
the client system.
ODBC Driver API
When the application writing to LogonSource connects to Teradata Database using the
ODBC driver, the definitions of the LogonSource string fields are as follows.
Field Name
Description
Mode
The literal string (TCP/IP), indicating the connection type.
(Field 1)
This field is always 8 characters long.
Provided by Teradata Database.
TCP Port or Socket
Number
Hexadecimal TCP port or socket number on the network client
system.
(Field 2)
This field contains 4 hexadecimal characters. The maximum is
64K - 1 characters.
Provided by Teradata Database.
IP Address
IP address of the network client system.
(Field 3)
This field contains a maximum of 16 characters.
Provided by Teradata Database.
TDP ID
(Field 4)
TDP ID for the network TDP making the connection with
Teradata Database for this logon.
This field fills whatever space remains after fields 5 and 6 have
been filled.
This field comprises 5 components:
• Teradata Database host name specified by the application.
• SEMICOLON character.
• Host name or IP address of the Teradata Database node that
was connected.
• COLON character.
• Port number of the Teradata Database node that was
connected.
Provided by the Teradata ODBC driver.
Client Process ID
Identifier for the ODBC process on the network client system.
(Field 5)
This field contains a maximum of 12 characters.
This information is not provided by the Teradata ODBC driver.
Data Dictionary
277
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogonSource
Field Name
Description
ODBC Driver API
Client User ID
(Continued)
(Field 6)
User ID for the logged on user as defined for the network client
system.
This field contains a maximum of 20 characters.
Provided by the Teradata ODBC driver.
Example: Teradata ODBC Driver
(TCP/IP) 0F6D 141.206.34.228
CS4400S1.TD.TERADATA.COM
3780
GR120994
Field contents:
Field Contents
1
TCP/IP
2
0F6D
3
4
5
6
278
Description
Connection mode
TCP port/societ number on the network
system
141.206.34.228 IP address of the network client system
CS4400S1.FP.TERADATA.COM
TDP ID for the TDP making the connection
with Teradata Database for this logon
3780
Process ID
GR120994
Client user ID
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogonSource
Returns the origin of the .NET Data Provider for Teradata session being reported, such as
the user ID or process ID of the client system. LogonSource can contain the following
names and identifiers.
.NET Data Provider for
Teradata API
When the application writing to LogonSource connects to Teradata Database using the
.NET Data Provider driver, the definitions of the LogonSource string fields are as follows.
Field Name
Description
Mode
The literal string (TCP/IP), indicating the connection type.
(Field 1)
This field is always 8 characters long.
Provided by Teradata Database.
TCP Port or Socket
Number
Hexadecimal TCP port or socket number on the network client
system.
(Field 2)
This field usually contains 4 hexadecimal characters. The
maximum value is 64K.
Provided by Teradata Database.
IP Address
IP address of the network client system.
(Field 3)
This field contains a maximum of 16 characters.
Provided by Teradata Database.
The data in fields 4 through 7 can be truncated or removed entirely from the LogonSource
string as required to ensure that the total length of the fields provided by .NET Data
Provider for Teradata does not exceed 97 characters.
When field values must be eliminated, they are eliminated in the following order:
1 TDP ID (Field 4)
2 Client User ID (Field 6)
3 Client Process/Thread ID (Field 5)
Data Dictionary
279
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogonSource
.NET Data Provider for
Teradata API
Field Name
Description
TDP ID
TDP ID for the network TDP making the connection with
Teradata Database for this logon.
(Field 4)
(Continued)
This field fills whatever space remains after fields 5 through 8 have
been filled.
Fields 4 through 8 contains a maximum of 97 characters, and
Teradata Database truncates the TDP ID field to the space
remaining after all the other fields have been written.
If not enough space remains, then the data for TDP ID is removed
from the LogonSource string.
This field comprises 5 components:
•
•
•
•
•
DataSource name specified by the application.
COLON character.
IP address of the Teradata Database node that was connected.
COLON character.
Port number of the Teradata Database node that was
connected.
Provided by .NET Data Provider for Teradata.
Client Process ID
Identifier for the client process.
(Field 5)
.NET Data Provider removes this field if both the TDP ID and
Client User ID fields have been removed, but the resulting string is
still longer than the allotted 97 characters for .NET Data Provider
for Teradata-supplied fields in LogonSource.
The field is retrieved using the
Process.GetCurrentProcessID().ID function call.
Provided by .NET Data Provider for Teradata.
280
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogonSource
.NET Data Provider for
Teradata API
Field Name
Description
Client User ID
User ID for the logged on user as defined for the client system.
(Field 6)
The field comprises 3 components:
(Continued)
• The domain name.
This value is retrieved using the
System.Environment.UserDomainName function
call.
If a security exception is encountered, the field contains a
QUESTION MARK character.
• REVERSE SOLIDUS character.
The REVERSE SOLIDUS character is often referred to as a
backslash.
• The user name.
The value is retrieved using the
System.Environment.UserName function call.
If a security exception is encountered, the field contains a
QUESTION MARK character.
Provided by .NET Data Provider for Teradata.
Client Program
Identifier for the program running on the client system.
(Field 7)
This field comprises 7 components:
• The program name.
This value is retrieved using the
Process.GetCurrentProcess().ProcessName
function call.
If a security exception is encountered, the field contains a
QUESTION MARK character.
• COLON character.
• The literal character string NET.
This identifies .NET Data Provider for Teradata.
• COLON character.
• The literal character string SS
This identifies the session as a standard SQL session.
• COLON character.
• The 12-character release number for the .NET Data Provider
for Teradata in the format nn.nn.nn.nnn, where n represents an
integer value.
Provided by .NET Data Provider for Teradata.
Data Dictionary
281
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogonSource
.NET Data Provider for
Teradata API
Field Name
Description
Format ID
Format identifier that can be used to parse the earlier positional
information in the LogonSource attribute. if the field ends with
the four characters ‘ LSS’, then the format ID is present.
(Field 8)
(Continued)
This field is always 6 characters long.
For .NET Data Provider for Teradata connections, this value is
always 01 LSS.
Provided by .NET Data Provider for Teradata.
Example: .NET Data Provider for Teradata
(TCP/IP) 057E 153.64.135.76 SALES:153.64.116.95:1025 3808 CORP\TDUSER
TESTAPP:NET:SS:12.00.00.000 01 LSS
Field contents:
Field Contents
1
TCP/IP
2
057E
3
4
5
6
7
8
282
Description
Connection mode
TCP port/societ number on the network
system
153.64.135.76 IP address of the network client system
SALES:153.64.116.95:1025
TDP ID for the TDP making the connection
with Teradata Database for this logon
3608
Client process ID
CORP\TDUSER
Client user ID
TESTAPP:NET:SS:12.00.00.000
Client program
01 LSS
The literal 01 LSS, indicating LogonSource
string version 01
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogonSource
Returns the origin of the PDE internal session being reported, such as the node name or
process ID of the client system. LogonSource can contain the following names and
identifiers.
PDE Internal Session
Field Name
Description
Library Name
Name of the library that logged the session on.
(Field 1)
Process ID
(Field 2)
Application Name
Unique identifier for the application process running on the client
system.
Name of the application running on the client system.
(Field 3)
Node Name
Number of the node on which the application logged on.
(Field 4)
Example: PDE Internal Session
108E 153.64.137.84 LNXMPP 35
Field contents:
Field Contents
1
108E
2
153.64.137.84
3
LNXMPP
client system.
4
35
Description
Number of the library (LIBDBSUTIL) that
logged this session on.
Unique ID for the application process
running on the client system.
Name of the application running on the
Number of the node on which the application
logged on.
Column Name
Description
LogonSource
The data types for the compatibility and Unicode views are the same for all versions of the
LogonSource column and are documented by the following table:
Data Types for Unicode and
Compatibility Views
Data Dictionary
Data Type
Compatibility View
Unicode View
VARCHAR(128)
CHARACTER SET
LATIN/KANJI1
VARCHAR(128) CHARACTER
SET UNICODE
Format
X(128)
X(128)
Associated View
LogOnOff[X]
SessionInfo[X]
CSPSessionInfo
QryLog
LogOnOffV[X]
SessionInfoV[X]
CSPSessionInfoV
QryLogV
283
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogonStatus
Returns if the rule grants (G) or refuses (R) permission for the named user to log on from
the identified client system.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
LogonRules
LogonRulesV
Column Name
Description
LogonTime
Returns the time on which logon for the session occurred (useful on logoff events).
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
99:99:99.99
99:99:99.99
Associated View
LogOnOff[X]
LogOnOffV[X]
Returns the time that the session for which the log entry was made was logged on to the
Teradata Database.
Data Type
284
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
99:99:99 (explicit)
99:99:99 (explicit)
Associated View
AccessLog
AccessLogV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogonTime
(Continued)
Returns the time of logon for the session being reported.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
99:99:99.99
99:99:99.99
Associated View
SessionInfo[X]
SessionInfoV[X]
Column Name
Description
LogonUserName
Returns the ID of the user who ran the in-doubt transaction.
Data Type
Compatibility View
Unicode View
VARCHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
DeleteOldInDoubt
InDoubtLog
DeleteOldInDoubtV
InDoubtLogV
Column Name
Description
LogProcessor
Returns the logical processor ID for an AMP not affected by the event.
Data Type
Data Dictionary
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
-(5)9
-(5)9
Associated View
Events_Configuration[X]
RCC_Configuration[X]
Events_ConfigurationV[X]
RCC_ConfigurationV[X]
285
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LogTime
Returns the time of day that the event occurred as HH:MM:SS.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
99:99:99 (explicit)
99:99:99 (explicit)
Associated View
AccessLog
AccessLogV
Returns the time of day that the event occurred as HH:MM:SS.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
99:99:99
99:99:99
Associated View
DeleteAccessLog[X]
SecurityLog[X]
DeleteAccessLogV[X]
SecurityLogV[X]
Returns the time of day that the event occurred as HH:MM:SS.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
99:99:99.99
99:99:99.99
Associated View
LogOnOff[X]
LogOnOffV[X]
Column Name
Description
LogType
Returns the kind of statement for which the access log entry was made.
Data Type
286
Compatibility View
Unicode View
BYTEINT
BYTEINT
Format
---,--9
---,--9
Associated View
SecurityLog[X]
SecurityLogV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LowByteCount
Returns the lowest count of bytes processed by an AMP.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
Column Name
Description
LowByteCountAmp
Returns the number of the AMP with the lowest byte count.
Data Type
Unicode View
SMALLINT
Format
ZZZZ9
Associated View
ReconfigTableStatsV
Column Name
Description
LowCPUSecsCount
Returns the lowest CPU count in seconds, used by an AMP.
Data Type
Unicode View
FLOAT
NOT NULL
Data Dictionary
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
287
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LowCPUSecsCountAmp
Returns the number of the AMP with the lowest CPU seconds count.
Data Type
Unicode View
SMALLINT
Format
ZZZZ9
Associated View
ReconfigTableStatsV
Column Name
Description
LowHist
Returns the lowest value specified as a query execution differentiation for the "SUMMARY"
SQL option.
For the "THRESHOLD" option, this is the threshold value given by the user.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
QryLogSummary
QryLogSummaryV
Format
Associated View
Column Name
Description
LowIOCount
Returns the lowest count of IOs on an AMP.
Data Type
Unicode View
FLOAT
NOT NULL
288
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LowIOCountAmp
Returns the number of the AMP with the lowest IO count.
Data Type
Unicode View
SMALLINT
Format
ZZZZ9
Associated View
ReconfigTableStatsV
Column Name
Description
LowRowCount
Returns the lowest count of rows processed by an AMP.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
Column Name
Description
LowRowCountAmp
Returns the number of the AMP with the lowest row count.
Data Type
Unicode View
SMALLINT
Data Dictionary
Format
ZZZZ9
Associated View
ReconfigTableStatsV
289
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
LSN
Is used in the case of a load utility.
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLog
QryLogTDWM
QryLogSteps
QryLogV
QryLogTDWMV
QryLogStepsV
Column Name
Description
MaxAMPCPUTime
Returns the CPU time of the highest CPU utilized AMP in the query.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZ,ZZZ,ZZ9.999
ZZ,ZZZ,ZZ9.999
Associated View
QryLog
QryLogSteps
QryLogV
QryLogStepsV
Column Name
Description
MaxAMPCPUTimeNorm
Returns the normalized maximum CPU Time for AMP.
Data Type
290
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZ,ZZZ,ZZ9.999
ZZ,ZZZ,ZZ9.999
Associated View
QryLog
QryLogSteps
QryLogV
QryLogStepsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
MaxAmpIO (renamed from
HotAmpIO)
Returns the I/O count of the highest I/O utilized AMP in the step.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---,---,--9
----,---,---,---,--9
Associated View
QryLog
QryLogSteps
QryLogV
QryLogStepsV
Column Name
Description
MaxAMPSpool
Returns the highest spool usage on an AMP.
This is the number of bytes of spool at the step level.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---,---,--9
----,---,---,---,--9
Associated View
QryLogSteps
QryLogStepsV
Column Name
Description
MaxCPUAmpNumber
Returns the number of the AMP with the highest CPU activity.
Data Type
Data Dictionary
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
QryLog
QryLogSteps
QryLogV
QryLogStepsV
291
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
MaxCPUAmpNumberNorm
Returns the number of the AMP with the highest CPU activity.
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
QryLog
QryLogSteps
QryLogV
QryLogStepsV
Column Name
Description
MaxCPUTime
Returns the most CPU time of all queries completed in the summary interval for the WD.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
ZZZZZZ.99
ZZZZZZ.99
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Column Name
Description
MaxIOAmpNumber
Returns the number of the AMP with the highest IO usage for this step.
Data Type
292
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
QryLog
QryLogSteps
QryLogV
QryLogStepsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
MaxLogonAttempts
Returns the number of erroneous logons allowed, at which time the user becomes locked.
For example, a 1 indicates that one erroneous logon locks the user. 0 indicates that a user is
never locked.
Data Type
Compatibility View
Unicode View
BYTEINT
NOT NULL
BYTEINT
NOT NULL
Format
---9
---9
Associated View
SecurityDefaults
SecurityDefaultsV
Returns the number of erroneous logons allowed, at which time the user becomes locked.
For example, a 1 indicates that one erroneous logon locks the user. 0 indicates that a user is
never locked.
Data Type
Compatibility View
Unicode View
BYTEINT
BYTEINT
Format
---9
---9
Associated View
ProfileInfo[X]
ProfileInfoV[X]
Column Name
Description
MaxOutParameters
Returns the maximum output parameters for a table function.
For FunctionType=’R,’ the column has values ranging from 0 to 2048.
• 0 = a table function with fixed output parameters.
• 1 to 2048 = a varying output column table function.
For all other FunctionType, the column returns a zero value.
Data Type
Data Dictionary
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9 (explicit)
---,--9 (explicit)
Associated View
Functions[X]
FunctionsV[X]
293
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
MaxPerm
Returns an integer that represents the maximum permanent space, in bytes, that is allocated
to the database on a specified AMP (or on all AMPs if the SUM aggregate is specified).
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
---,---,---,---,--9 (explicit)
---,---,---,---,--9 (explicit)
Associated View
Allspace[X]
DiskSpace[X]
AllspaceV[X]
DiskSpaceV[X]
Column Name
Description
MaxProfileSpool
Returns the profile SPOOL space limit per AMP for the user if the user is assigned a profile
which has a SPOOL space setting. Otherwise, this column has a null value.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
---,---,---,---,--9 (explicit)
---,---,---,---,--9 (explicit)
Associated View
Allspace[X]
DiskSpace[X]
AllspaceV[X]
DiskSpaceV[X]
Column Name
Description
MaxProfileTemp
Returns the profile TEMPORARY space limit per AMP for the user if the user is assigned a
profile which has a TEMPORARY space setting. Otherwise, this column has a null value.
Data Type
294
Compatibility View
Unicode View
FLOAT
FLOAT
Format
---,---,---,---,--9 (explicit)
---,---,---,---,--9 (explicit)
Associated View
Allspace[X]
DiskSpace[X]
AllspaceV[X]
DiskSpaceV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
MaxRespTime
Returns the slowest response time of all queries completed in the summary interval for the
WD.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
ZZZZZZ.99 (explicit)
ZZZZZZ.99 (explicit)
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Column Name
Description
MaxSpool
Returns an integer that represents the maximum spool space, in bytes, that is allocated to the
database on a specified AMP (or on all AMPs if the SUM aggregate is specified).
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
---,---,---,---,--9 (explicit)
---,---,---,---,--9 (explicit)
Associated View
Allspace[X]
DiskSpace[X]
AllspaceV[X]
DiskSpaceV[X]
Column Name
Description
MaxSpoolAmpNumber
Returns the number of the AMP with high spool usage.
Data Type
Data Dictionary
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
QryLogSteps
QryLogStepsV
295
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
MaxStepsInPar
Returns the maximum number of (level 2) steps done in parallel for this query.
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
QryLog
QryLogV
Column Name
Description
MaxTemp
Returns an integer that represents the maximum temporary space, in bytes, that is allocated
to the database on a specified AMP (or on all AMPs if the SUM aggregate is specified).
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
---,---,---,---,--9 (explicit)
---,---,---,---,--9 (explicit)
Associated View
Allspace[X]
DiskSpace[X]
AllspaceV[X]
DiskSpaceV[X]
Column Name
Description
MetSLGCount
Indicates how many of all the queries completed in the summary interval for the WD met
their SLG objectives. Note that queries may not have met the SLG but not have been treated
as exceptions either.
Data Type
296
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
MinAmpCPUTime
Returns the CPU time of the lowest CPU utilized AMP in the step.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZ,ZZZ,ZZ9.999
ZZ,ZZZ,ZZ9.999
Associated View
QryLog
QryLogSteps
QryLogV
QryLogStepsV
Column Name
Description
MinAmpCPUTimeNorm
Returns the normalized minimum CPU Time for AMP.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZ,ZZZ,ZZ9.999
ZZ,ZZZ,ZZ9.999
Associated View
QryLog
QryLogSteps
QryLogV
QryLogStepsV
Column Name
Description
MinAmpIO (renamed from
LowAmpIO)
Returns the I/O count of the lowest I/O utilized AMP in the query.
Data Type
Data Dictionary
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---,---,--9
----,---,---,---,--9
Associated View
QryLog
QryLogSteps
QryLogV
QryLogStepsV
297
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
MinAMPSpool
Returns the lowest Spool usage on an AMP.
This is the number of bytes of spool at the step level.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---,---,--9
----,---,---,---,--9
Associated View
QryLogSteps
QryLogStepsV
Column Name
Description
MinCPUTime
Returns the least CPU time of all queries completed in the summary interval for the WD.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
ZZZZZZ.99 (explicit)
ZZZZZZ.99 (explicit)
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Column Name
Description
MinRespTime
Returns the fastest response time of all queries completed in the summary interval for the
WD.
Data Type
298
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
ZZZZZZ.99 (explicit)
ZZZZZZ.99 (explicit)
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ModAmpCount
Returns the number of modified AMPs.
A modified AMP is one on which the cluster number has been changed.
Data Type
Unicode View
SMALLINT
Format
ZZZZ9
Associated View
ReconfigInfoV
Column Name
Description
Model
Returns the PMA (Processor Module Assembly) model information for the Vproc for which
an event was logged.
Data Type
Compatibility View
Unicode View
CHAR(4)
LATIN
NOT NULL
CHAR(4)
LATIN
NOT NULL
Format
X(4)
X(4)
Associated View
AMPUsage[X]
AMPUsageV[X]
Column Name
Description
MovAmpCount
Returns the number of AMPs moved.
Data Type
Unicode View
SMALLINT
Data Dictionary
Format
ZZZZ9
Associated View
ReconfigInfoV
299
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
MovedInCount
Returns the number of queries that were moved into this WD due to an exception during
this interval.
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Column Name
Description
MsgMiscCount
Returns the count of miscellaneous messaging operations.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
Column Name
Description
MsgRcvCount
Returns the count of messages received.
Data Type
Unicode View
FLOAT
NOT NULL
300
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
MsgSendCount
Returns the count of messages sent.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
Column Name
Description
MsgWaitMiscTime
Returns the total elapsed time waiting on miscellaneous messaging operations.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
Column Name
Description
MsgWaitRcvTime
Returns the total time elapsed waiting to receive messages.
Data Type
Unicode View
FLOAT
NOT NULL
Data Dictionary
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
301
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
MsgWaitSendTime
Returns the total time elapsed sending messages.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
Column Name
Description
NamedTblCheckCount
Returns the count of named table-level check constraint for the table.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
Tables[X]
TablesV[X]
Column Name
Description
NewWDID
Specifies the WD into which the query was moved because of exception handling.
Data Type
302
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogExceptions
QryLogExceptionsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
NoClassification
Indicates that the query was not reclassified. The query is running in the WD selected by the
user, not the Teradata dynamic workload management software.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
CHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
QryLogTDWM
QryLogTDWMV
Column Name
Description
NodeCount
Returns the number of nodes in the new Config map.
Data Type
Unicode View
SMALLINT
NOT NULL
Format
ZZZZ9
Associated View
ReconfigInfoV
Column Name
Description
NoMemFlushCount
Returns the count of memory flushes when the memory is full.
Data Type
Unicode View
INTEGER
NOT NULL
Data Dictionary
Format
ZZZZZZZZZ9
Associated View
ReconfigTableStatsV
303
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
NoSQLDataAccess
Returns the access indicated in the ‘Create Procedure’ statement. These are the values:
•
•
•
•
Y = No SQL in the external stored procedures
C = Contains SQL.
R = Reads SQL data
M = Modifies SQL data
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Functions[X]
ExternalSPs[X]
FunctionsV[X]
ExternalSPsV[X]
Column Name
Description
NotLikeEscape
Returns an optional escape character to be used with NotLikePattern.
Data Type
Unicode View
CHAR(1)
UNICODE
Format
X(1)
Associated View
RepCaptureRulesV
Column Name
Description
NotLikePattern
Returns an optional pattern string.
If it is not null, it is used to exclude objects that would otherwise match this rule.
Data Type
Unicode View
VARCHAR(300)
UNICODE
304
Format
X(300)
Associated View
RepCaptureRulesV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
Nullable
Returns a code to indicate whether or not a column may have a null value. The following
codes are used:
• Y = Yes
• N = No
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
CHAR(1)
LATIN
UPPERCASE
Format
X(1)
X(1)
Associated View
Columns[X]
ColumnsV[X]
Column Name
Description
NullCall
Returns whether the function is called on null input.
The following codes are used:
• Y = if that is the case
• N = if it returns null on null input
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Functions[X]
FunctionsV[X]
305
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
NullPassword
Returns a code that specifies whether the rule allows this user to log on without a password
from the specified client system. The following codes are used:
• T = True/yes
• F = False/no
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
LogonRules
LogonRulesV
Column Name
Description
NumOfActiveAMPs
Returns the number of AMPS that were active for this query.
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLog
QryLogSteps
QryLogV
QryLogStepsV
Column Name
Description
NumParameters
Returns the number of parameters of a function.
Data Type
306
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
Functions[X]
FunctionsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
NumParameterss
(Continued)
Returns the number of parameters of an External Stored Procedure.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
ExternalSPs[X]
ExternalSPsV[X]
Column Name
Description
NumResultRows
Returns the total number of rows returned for the query.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---,---,--9
----,---,---,---,--9
Associated View
QryLog
QryLogV
Column Name
Description
NumSteps
Returns the total number of (level 1) steps for this query.
Data Type
Data Dictionary
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
QryLog
QryLogV
307
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
NumStepswPar
Returns the number of (level 1) steps with parallel steps.
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
QryLog
QryLogV
Column Name
Description
NUSICount
Returns the number of NUSIs for the table.
Data Type
Unicode View
SMALLINT
NOT NULL
Format
ZZZZ9
Associated View
ReconfigTableStatsV
Column Name
Description
ObjectColumnName
Returns the name of the column.
If the object type is 'I' or Index, the system returns the name of the column associated with
the index.
Data Type
308
Compatibility View
Unicode View
CHAR(30)
UNICODE
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
QryLogObjects
QryLogObjectsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ObjectDatabaseName
Returns the name of the database.
Data Type
Compatibility View
Unicode View
CHAR(30)
UNICODE
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
QryLogObjects
QryLogObjectsV
Column Name
Description
ObjectID
Returns the internal ID of the object.
Data Type
Compatibility View
Unicode View
BYTE (4)
NOT NULL
BYTE (4)
NOT NULL
Format
X(8)
X(8)
Associated View
QryLogObjects
QryLogObjectsV
Column Name
Description
ObjectKind
Returns the kind of Data Dictionary object to which this rule is matched. Object kinds are
encoded as TableKind in the DBC.TVM table, as follows:
•
•
•
•
•
•
T = Table
V = View
M = Macro
G = Trigger
I = Join index, Hash index
C = Temporary Table
Data Type
Unicode View
CHAR (1) LATIN
UPPERCASE
Data Dictionary
Format
X(1)
Associated View
RepCaptureRulesV
309
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ObjectNum
Used for indexes or columns.
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogObjects
QryLogObjectsV
Column Name
Description
ObjectTableName
Returns the name of the table.
Data Type
Compatibility View
Unicode View
CHAR(30)
UNICODE
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
QryLogObjects
QryLogObjectsV
Column Name
Description
ObjectType
Returns a code to indicate the type of object associated with the event.
These are the values:
•
•
•
•
D = Database
J = Journal table
Q = Backup or restore of selected partitions
T = Table
Data Type
310
Compatibility View
Unicode View
CHAR(1)
LATIN
CHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
Events[X]
EventsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ObjectType
(Continued)
Returns a code to indicate the type of object associated with the event. The following codes
are used:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Agg = User defined aggregate function
Ags = User defined aggregate STAT function
Aut = Security Authorization
Col = Column
DB = Database
GLp = GLOP Set
Hix = Hash index
Idx = Index
JIx = Join Index
Jrl = Journal
Mac = Macro
NoT = No Type (Unknown)
SP = Stored Procedure
Sta = User defined STAT function
Tab = Table
TbF = Table function
Tmp = Temporary
Trg = Trigger
UDF = User Defined Function
UDM = User Defined Method
UDT = User Defined Type
Viw = View
Vol = Volatile
XSP = External Stored Procedure
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(3)
LATIN
NOT NULL
CHAR(3)
LATIN
NOT NULL
Format
X(3)
X(3)
Associated View
QryLogObjects
QryLogObjectsV
311
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ObjFlag
(Title: Object)
The following codes are used:
• T = Object data (columns, databases, tables, and indexes) are stored in
DBC.DBQLObjTbl
• F = No object data
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
DBQLRules
DBQLRulesV
Column Name
Description
OpEnvID
Returns the ID of the operational environment currently activated by the Teradata dynamic
workload management software.
Data Type
312
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogExceptions
QryLogTDWM
QryLogEvents
QryLogTDWMSum
QryLogExceptionsV
QryLogTDWMV
QryLogEventsV
QryLogTDWMSumV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
OperationInProcess
Returns a code to indicate whether the event is still processing. The following codes are used:
• Y = Yes
• N = No
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
Events[X]
EventsV[X]
Column Name
Description
Options
This field is assigned to NULL initially. It is not used by the system and users may update this
one-character column to suit their needs.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
CHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
InDoubtLog
InDoubtLogV
313
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
OrderNumber
Optionally specifies when triggers bearing the same action time and event executes.
If the value is 32767, OrderNumber signifies that no explicit order was included in the
trigger definition.
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
Triggers[X]
TriggersV[X]
Returns the position or priority within an ordered sequence of numbers.
Data Type
Unicode View
INTEGER
NOT NULL
Format
ZZZZZZZZZ9
Associated View
ReconfigRedistOrderV
ReconfigDeleteOrderV
Column Name
Description
Original_CommentString
Returns the original comment on the imported table.
Data Type
314
Compatibility View
Unicode View
VARCHAR(255)
UNICODE
VARCHAR(255)
UNICODE
Format
X(255)
X(255)
Associated View
Association[X]
AssociationV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
Original_CreatorName
Returns the original creator of the imported table.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
NOT NULL
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Association[X]
AssociationV[X]
Column Name
Description
Original_DatabaseName
Returns the name of the original database in which the object resided.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
NOT NULL
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Association[X]
AssociationV[X]
315
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
Original_JournalFlag
Returns a code to indicate the original journaling for the imported object. The first character
indicates the BEFORE-image status and the second character indicates the AFTER-image
status. The following codes are used:
• N = No journal
(default value)
• S = Single journal
• D = Dual journal
• L = Local AFTER journal
(not used for BEFORE)
Data Type
Compatibility View
Unicode View
CHAR(2)
LATIN
NOT NULL
CHAR(2)
LATIN
NOT NULL
Format
X(2)
X(2)
Associated View
Association[X]
AssociationV[X]
Column Name
Description
Original_ProtectionType
Returns the original protection type of the imported object, using the following codes:
• F = Fallback
• N = None
Data Type
316
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Association[X]
AssociationV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
Original_TableKind
Returns the original kind of the imported object. Possible values are as follows:
•
•
•
•
•
•
•
•
•
•
•
•
T = Data Table
V = View
M = Macro
J = Journal Table
I = Join Index Table
P= Stored Procedure
G = Trigger
F = Scalar UDF
A = Aggregate UDF
N = Hash Index Table
U = User-defined data type
H = Instance or Constructor
Method
• E = External Stored
Procedure
• R = Table Function
• X = Authorization
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Association[X]
AssociationV[X]
Column Name
Description
Original_TableName
Returns the name of the original object.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
NOT NULL
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Association[X]
AssociationV[X]
317
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
Original_Version
Returns the original version of the imported object.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
Association[X]
AssociationV[X]
Column Name
Description
OSDomainName
Returns the domain that the user belongs to.
Data Type
Compatibility View
Unicode View
VARCHAR(256)
LATIN
CASESPECIFIC
VARCHAR(256)
LATIN
CASESPECIFIC
Format
X(256)
X(256)
Associated View
Authorizations[X]
AuthorizationsV[X]
Column Name
Description
OSUserName
Returns the OS user name.
Data Type
318
Compatibility View
Unicode View
VARCHAR(256)
LATIN
CASESPECIFIC
VARCHAR(256)
LATIN
CASESPECIFIC
Format
X(256)
X(256)
Associated View
Authorizations[X]
AuthorizationsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
OwnerName
Returns the name of the owner of the objects targeted by the view, stored procedure, macro,
user-defined types, user-defined methods, or user-defined function referenced in the
request that generated this log entry.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
AccessLog
AccessLogV
Returns the name of the database owner.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
NOT NULL
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Databases[X]
DatabasesV[X]
Returns the name of the owner of the user.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
NOT NULL
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Users
UsersV
319
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ParameterDataTypes
Returns the parameter list of a function with a two-character string representing the data
type for each parameter.
The maximum parameter is 128.
Data Type
Compatibility View
Unicode View
VARCHAR(256)
LATIN
UPPERCASE
VARCHAR(256)
LATIN
UPPERCASE
Format
X(255)
X(255)
Associated View
Functions[X]
FunctionsV[X]
Column Name
Description
ParameterStyle
Returns the parameter passing convention for the function or an External Stored Procedure.
The following codes are used:
• S = SQL
• G = TD_GENERAL
• I = for internal
Data Type
320
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Functions[X]
ExternalSPs[X]
FunctionsV[X]
ExternalSPsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ParameterUDTIds
Returns a series of 4-byte UDT- type identifiers.
Data Type
Compatibility View
Unicode View
VARBYTE(512)
VARBYTE(512)
Format
X(512)
X(512)
Associated View
Functions[X]
ExternalSPs[X]
FunctionsV[X]
ExternalSPsV[X]
Column Name
Description
Parent
Returns the name of a parent database or user.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
NOT NULL
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Children[X]
ChildrenV[X]
Column Name
Description
ParentCount
Returns the number of parent tables for the table specified in the TVM row.
Data Type
Data Dictionary
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
Tables[X]
Tables2[X]
TablesV[X]
Tables2V[X]
321
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ParentDb
Returns the name of the referenced database.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
All_RI_Children[X]
All_RI_Parents[X]
RI_Distinct_Children[X]
RI_Distinct_Parents[X]
All_RI_ChildrenV[X]
All_RI_ParentsV[X]
RI_Distinct_ChildrenV[X]
RI_Distinct_ParentsV[X]
Column Name
Description
ParentDbId
Returns the database ID of the referenced table.
Data Type
Compatibility View
Unicode View
BYTE(4)
NOT NULL
BYTE(4)
NOT NULL
Format
X(8)
X(8)
Associated View
RI_Child_Tables[X]
RI_Parent_Tables[X]
RI_Child_TablesV[X]
RI_Parent_TablesV[X]
Column Name
Description
ParentKeyColumn
Returns the name of the column in a referenced key.
Data Type
322
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
All_RI_Children[X]
All_RI_Parents[X]
All_RI_ChildrenV[X]
All_RI_ParentsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ParentKeyFID
Returns the field ID of a column in the referenced key.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
RI_Child_Tables[X]
RI_Parent_Tables[X]
RI_Child_TablesV[X]
RI_Parent_TablesV[X]
Column Name
Description
ParentTable
Returns the name of the referenced table.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
All_RI_Children[X]
All_RI_Parents[X]
RI_Distinct_Children[X]
RI_Distinct_Parents[X]
All_RI_ChildrenV[X]
All_RI_ParentsV[X]
RI_Distinct_ChildrenV[X]
RI_Distinct_ParentsV[X]
Column Name
Description
ParentTID
Returns the table ID of the referenced table.
Data Type
Data Dictionary
Compatibility View
Unicode View
BYTE(6)
NOT NULL
BYTE(6)
NOT NULL
Format
X(12)
X(12)
Associated View
RI_Child_Tables[X]
RI_Parent_Tables[X]
RI_Child_TablesV[X]
RI_Parent_TablesV[X]
323
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ParExpreqTime
Returns hundredths of seconds of elapsed time (35 represents .35 seconds) in instrumented
parser express requests.
For example, if your query incurs .35 seconds of parser express request elapsed time, this
field will say 35.
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
QryLog
QryLogV
Column Name
Description
ParserCPUTime
Returns the total parser and dispatcher CPU time used for the query.
Data Type
324
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZ,ZZZ,ZZ9.999
ZZ,ZZZ,ZZ9.999
Associated View
QryLog
QryLogV
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZZ,ZZZ.999
ZZZ,ZZZ.999
Associated View
QryLogSummary
QryLogSummaryV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ParserCPUTimeNorm
Returns the normalized parser CPU time for co-existence systems.
Data Type
Data Dictionary
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZ,ZZZ,ZZ9.999
ZZ,ZZZ,ZZ9.999
Associated View
QryLog
QryLogV
325
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
Partition
Returns the name of the Teradata Database partition to which the user is currently attached.
Possible values are as follows:
•
•
•
•
•
•
DBC/SQL
EXPORT
FASTLOAD
HUTPARSE
MLOAD
MONITOR
• NONE
=
=
=
=
=
=
an SQL session
a FASTEXPORT session
a FASTLOAD session
an ARC data session
a MULTILOAD session
sessions running in a performance monitoring
application
= session is recognized but not yet assigned
Data Type
Compatibility View
Unicode View
CHAR(16)
LATIN
CHAR(16)
LATIN
Format
X(20)
X(20)
Associated View
SessionInfo[X]
SessionInfoV[X]
Returns the number of the Teradata Database partition in which the task that resulted in the
logged event was running.
Possible values are:
Number
-----7
8
9
10
11
12
13
14
15
17
18
19
47
Defines the
-------------------------------------------------console Utility Partition number
partition in which DBC console procedures will be
started by the Host utility
File System Partition number
Gateway partition number
Worker Task Partition number
Session Control Partition number
Dispatcher Partition number
Parser Partition number
Startup Partition number
RSSStartUp Partition number
DDF Server Partition number
RSG Partition number
DBS RSG Partition number
Data Type
326
Compatibility View
Unicode View
BYTEINT
BYTEINT
Format
Z9
Z9
Associated View
Software_Event_Log
Software_Event_LogV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
PartitionCount
Returns the number of partitions for a table.
The default is 1, which means the table is not a PPI (Partitioned Primary Index) table.
Data Type
Unicode View
INTEGER
NOT NULL
Format
ZZZZZZZZZ9
Associated View
ReconfigTableStatsV
Column Name
Description
PasswordChgDate
Returns the Julian date on which the current password was assigned to the user. This value is
0 for a new user.
Data Type
Compatibility View
Unicode View
DATE
DATE
Format
YY/MM/DD
YY/MM/DD
Associated View
Users
UsersV
Column Name
Description
PasswordDigits
Returns a code to indicate if digits are to be allowed in the password. The following codes are
used:
• Y, y = allow digits in the password string
• N, n = no digits are allowed in the password string
• R, r = at least one digit is required in the password string
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
SecurityDefaults
SecurityDefaultsV
327
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
PasswordDigits
(Continued)
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
CHAR(1)
LATIN
UPPERCASE
Format
X(1)
X(1)
Associated View
ProfileInfo[X]
ProfileInfoV[X]
Column Name
Description
PasswordLastModDate
Returns the date that the user password was last modified.
Data Type
Compatibility View
Unicode View
DATE
DATE
Format
YY/MM/DD
YY/MM/DD
Associated View
Users
UsersV
Column Name
Description
PasswordLastModTime
Returns the time that the user password was last modified.
Data Type
328
Compatibility View
Unicode View
TIME
TIME
Format
HH:MI:SS
HH:MI:SS
Associated View
Users
UsersV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
PasswordMaxChar
Returns the maximum number of characters in a valid password string. PasswordMaxChar
must be equal to or greater than PasswordMinChar.
Data Type
Compatibility View
Unicode View
BYTEINT
BETWEEN1 AND 30
NOT NULL
BYTEINT
BETWEEN1 AND 30
NOT NULL
Format
--9
--9
Associated View
SecurityDefaults
SecurityDefaultsV
Data Type
Compatibility View
Unicode View
BYTEINT
BYTEINT
Format
--9
--9
Associated View
ProfileInfo[X]
ProfileInfoV[X]
Column Name
Description
PasswordMinChar
Returns the minimum number of characters in a valid password string.
Data Type
Data Dictionary
Compatibility View
Unicode View
BYTEINT BETWEEN1 AND
30
NOT NULL
BYTEINT BETWEEN1 AND
30
NOT NULL
Format
--9
--9
Associated View
SecurityDefaults
SecurityDefaultsV
Data Type
Compatibility View
Unicode View
BYTEINT
BYTEINT
Format
--9
--9
Associated View
ProfileInfo[X]
ProfileInfoV[X]
329
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
PasswordRestrictWords
Indicates whether to restrict certain words from being contained within a password string.
These are the valid values:
• Y (Yes)
• N (No)
The default is N.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
UPPERCASE
CHAR(1)
LATIN
NOT NULL
UPPERCASE
Format
X(1)
X(1)
Associated View
SecurityDefaults
SecurityDefaultsV
Column Name
Description
PasswordReuse
Returns the number of days to elapse before a password can be reused. 0 indicates
immediate reuse.
Data Type
330
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
--9
--9
Associated View
SecurityDefaults
SecurityDefaultsV
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
ProfileInfo[X]
ProfileInfoV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
PasswordSpecChar
Returns a code to indicate if special characters are to be allowed in the password. For the
definition of the codes, see DBC.SysSecDefaults.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
SecurityDefaults
SecurityDefaultsV
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
CHAR(1)
LATIN
UPPERCASE
Format
X(1)
X(1)
Associated View
ProfileInfo[X]
ProfileInfoV[X]
Column Name
Description
PeakPerm
Returns the maximum amount of permanent space per AMP that has been used by the
database since the last time the DBC.ClearPeakDisk macro was run.
Data Type
Data Dictionary
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
---,---,---,---,--9 (explicit)
---,---,---,---,--9 (explicit)
Associated View
AllSpace[X]
DiskSpace[X]
TableSize[X]
AllSpaceV[X]
DiskSpaceV[X]
TableSizeV[X]
331
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
PeakSpool
Returns an integer that represents the maximum spool space, in bytes, that was used at any
one time by the database on a specified AMP (or on all AMPs if the SUM aggregate is
specified).
Note: The ClearPeakDisk macro allows the Teradata Database administrator to clear this
field.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
---,---,---,---,--9 (explicit)
---,---,---,---,--9 (explicit)
Associated View
AllSpace[X]
DiskSpace[X]
AllSpaceV[X]
DiskSpaceV[X]
Column Name
Description
PeakTemp
Returns the peak number of bytes used at one time by a temporary table per vproc.
Note: The ClearPeakDisk macro allows the Teradata Database administrator to clear this
field.
Data Type
332
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
---,---,---,---,--9 (explicit)
---,---,---,---,--9 (explicit)
Associated View
AllSpace[X]
DiskSpace[X]
AllSpaceV[X]
DiskSpaceV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
PermSpace
Returns an integer indicating the total space allocated to the database on all AMPs.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
ZZZ,ZZZ,ZZZ,ZZZ,ZZ9
(explicit)
ZZZ,ZZZ,ZZZ,ZZZ,ZZ9
(explicit)
Associated View
Databases[X]
DatabasesV[X]
Returns an integer that indicates the permanent space allocated to the user.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
---,---,---,---,--9 (explicit)
---,---,---,---,--9 (explicit)
Associated View
Users
UsersV
Column Name
Description
Phase
Returns the Reconfiguration phase.
These are the values:
• R = Redistribution phase
• D = Deletion/rebuild NUSI phase
Data Type
Unicode View
CHAR(1)
LATIN
NOT CASESPECIFIC
Data Dictionary
Format
X(1)
Associated View
ReconfigTableStatsV
333
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
PhyProcessor
Returns the physical processor ID for an AMP not affected by the event.
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
ZZZZ9
ZZZZ9
Associated View
Events_Configuration[X]
RCC_Configuration[X]
Events_ConfigurationV[X]
RCC_ConfigurationV[X]
Column Name
Description
Platform
Returns the platform of the system on which the object is compiled.
This flag is significant when the system has performed a restore operation from a different
platform. It determines whether a function object is valid or compatible with the current
platform.
The following values are used:
•
•
•
•
MPRAS = MPRAS
W2K = Windows 32-bit
WINNET = Windows 64-bit
LINUX64 = Linux 64-bit (This is used for SUSE Linux Enterprise Server 9 and 10)
Data Type
334
Compatibility View
Unicode View
CHAR(8)
LATIN
UPPERCASE
NOT NULL
CHAR(8)
LATIN
UPPERCASE
NOT NULL
Format
X(8)
X(8)
Associated View
Functions[X]
ExternalSPs[X]
FunctionsV[X]
ExternalSPsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
PMA
Identifies the Processor Module Assembly (PMA) on which the event occurred.
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
ZZ9-99
ZZ9-99
Associated View
Software_Event_Log
Software_Event_LogV
Column Name
Description
PrepareCount
Returns the single character field representing the Prepare Count statistical option.
The following codes are used:
• Y = the PrepareCount option is selected for the statistical function.
• N = the PrepareCount option is not selected.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
CHAR(1)
LATIN
UPPERCASE
Format
X(1)
X(1)
Associated View
Functions[X]
FunctionsV[X]
Column Name
Description
PrimaryKeyIndexId
Returns information about the identification of the table used as the primary index.
Data Type
Data Dictionary
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
Tables[X]
TablesV[X]
335
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ProcessOffline
These are the values:
• Y = table should be redistributed offline
• N = table should be redistributed online (default)
Data Type
Unicode View
CHAR(1)
LATIN
UPPERCASE
Format
X(1)
Associated View
ReconfigRedistOrderV
ReconfigDeleteOrderV
Column Name
Description
ProcessorState
Returns D (the event was for all AMPs and the processor was down) or U (the event was for
specific AMPs).
Data Type
336
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
Events_Configuration[X]
RCC_Configuration[X]
Events_ConfigurationV[X]
RCC_ConfigurationV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ProcID
Returns the process ID of the dispatcher.
Data Type
Compatibility View
Unicode View
DECIMAL(5,0)
NOT NULL
DECIMAL(5,0)
NOT NULL
Format
-(5)9
-(5)9
Associated View
QryLog
QryLogObjects
QryLogSummary
QryLogSteps
QryLogSQL
QryLogExplain
QryLogTDWMSum
QryLogExceptions
QryLogEvents
QryLogTDWM
QryLogEventHis
QryLogV
QryLogObjectsV
QryLogSummaryV
QryLogStepsV
QryLogSQLV
QryLogExplainV
QryLogTDWMSumV
QryLogExceptionsV
QryLogEventsV
QryLogTDWMV
QryLogEventHisV
QryLogXMLV
Column Name
Description
ProfileCat
(Title: Cat)
Returns the cost profile category.
The following are the values:
F = profile instances which are fixed and cannot be changed
V = profile instances which can be modified
Data Dictionary
Data Type
CHAR(1)
LATIN
Format
X(1)
Associated View
CostProfiles_v
337
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ProfileCat (Title: Cat)
(Continued)
Returns the constant category.
For legacy and subops profile types, the constant categories are:
• C = the constant is a cost prediction parameter
• I = the constant is an initialization parameter
Data Type
CHAR(1)
LATIN
NOT NULL
Format
X(1)
Associated View
CostProfileValues_v
Column Name
Description
ProfileDesc
(Title: Description)
Returns the description of the profile.
Data Type
VARCHAR(2048)
LATIN
Format
X(2048)
Associated View
CostProfiles_v
Column Name
Description
ProfileId
(Title: P-Id)
Returns the unique number assigned to the cost profile instance in the system.
338
Data Type
INTEGER
NOT NULL
Format
-----9
Associated View
CostProfileValues_v
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ProfileId
Returns the profile ID.
Data Type
Compatibility View
Unicode View
BYTE(4)
BYTE(4)
Format
X(8)
X(8)
Associated View
QryLog
QryLogSummary
QryLogV
QryLogSummaryV
Returns the unique number assigned to the cost profile instance in the system.
Data Type
INTEGER
NOT NULL
Format
--------9 (explicit)
Associated View
CostProfiles_v
Column Name
Description
ProfileName
Returns the name of the profile.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
NOT NULL
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
ProfileInfo[X]
ProfileInfoV[X]
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
Users
SessionInfo[X]
UsersV
SessionInfoV[X]
339
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ProfileName
(Title: Profile Name)
Returns the unique name assigned to the cost profile instance in the system.
Data Type
CHAR(30)
LATIN/KANJI1
NOT NULL
Format
X(30)
Associated View
CostProfiles_v
Column Name
Description
ProfileTypeDesc
(Title: Description)
Returns the description of the profile.
Data Type
VARCHAR(2048)
LATIN
Format
X(2048)
Associated View
CostProfileTypes_v
Column Name
Description
ProfileTypeName
(Title: Type Name)
Returns the name for each cost profile type.
340
Data Type
CHAR(30)
LATIN
NOT NULL
Format
X(30)
Associated View
CostProfileTypes_v
Data Type
CHAR(30)
NOT NULL
Format
X(15) (explicit)
Associated View
CostProfiles_v
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ProtectionType
Returns F (Fallback) or N (None) to indicate whether the tables in the database are
protected by the Fallback option.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Databases[X]
Tables[X]
Users
DatabasesV[X]
TablesV[X]
UsersV
Column Name
Description
ProxyCurRole
Returns the current role of the proxy user.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT CASESPECIFIC
Format
X(30)
X(128)
Associated View
SessionInfo[X]
SessionInfoV[X]
Column Name
Description
ProxyRole1 - ProxyRole15
Returns the role that can be set for the proxy user in a proxy connection.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT CASESPECIFIC
Format
X(30)
X(128)
Associated View
ConnectRules
ConnectRulesV
341
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ProxyUser
Returns the name of the proxy user.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT CASESPECIFIC
Format
X(30)
X(128)
Associated View
SessionInfo[X]
ConnectRules
QryLog
AccessLog
SessionInfoV[X]
ConnectRulesV
QryLogV
AccessLogV
Column Name
Description
ProxyUserType
Returns one of the following proxy user types:
• P - A Teradata permanent user
• A - An application user
Data Type
342
Compatibility View
Unicode View
VARCHAR(1)
UNICODE
VARCHAR(1)
UNICODE
Format
X(1)
X(1)
Associated View
ConnectRules
ConnectRulesV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
QueryBand
Returns the band under which the query is submitted.
Data Type
Compatibility View
Unicode View
VARCHAR(6160)
UNICODE
VARCHAR(6160)
UNICODE
Format
X(6160)
X(6160)
Associated View
QryLog
Accesslog
QryLogV
AccesslogV
Returns the query band assigned to the session.
Data Type
Compatibility View
Unicode View
VARCHAR(2048)
UNICODE
VARCHAR(2048)
UNICODE
Format
X(2048)
X(2048)
Associated View
SessionInfo[X]
SessionInfoV[X]
Column Name
Description
QueryCount
Returns the number of queries run in a 10-minute interval. Used with the "SUMMARY" or
"THRESHOLD" SQL option only.
Data Type
Data Dictionary
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogSummary
QryLogSummaryV
343
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
QueryID
Returns a system-wide unique ID to identify the query.
Data Type
Compatibility View
Unicode View
DECIMAL (18,0)
NOT NULL
DECIMAL (18,0)
NOT NULL
Format
--Z(17)9
--Z(17)9
Associated View
QryLog
QryLogObjects
QryLogSteps
QryLogSQL
QryLogExplain
QryLogExceptions
QryLogTDWM
QryLogV
QryLogObjectsV
QryLogStepsV
QryLogSQLV
QryLogExplainV
QryLogExceptionsV
QryLogTDWMV
QryLogXMLV
Column Name
Description
QuerySeconds
Returns the total number of seconds used by QueryCount. QuerySeconds can be used to
obtain an average.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
----,---,---,---,--9.999
----,---,---,---,--9.999
Associated View
QryLogSummary
QryLogSummaryV
Column Name
Description
QueryText
Returns the query text. The default size is 200 characters.
Data Type
344
Compatibility View
Unicode View
VARCHAR(10000)
UNICODE
VARCHAR(10000)
UNICODE
Format
X(10000)
X(10000)
Associated View
QryLog
QryLogV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
QueueFlag
Stores the queuing option for the table from the values listed below.
• Y = Yes (queuing option is set)
• N = No (queuing option is not set)
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Tables[X]
TablesV[X]
Column Name
Description
ReconfigId
Returns the ID for a Reconfig.
This is the unique ID for each Reconfiguration.
Data Type
Unicode View
INTEGER
NOT NULL
Format
ZZZZZZZZZ9
Associated View
ReconfigTableStatsV
ReconfigInfoV
Column Name
Description
ReconfigType
Returns the following types of Reconfig:
• 1 = Online Reconfig
• 2 = Offline Reconfig
Data Type
Unicode View
BYTEINT
NOT NULL
Data Dictionary
Format
ZZ9
Associated View
ReconfigInfoV
345
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
RejectedCount
Returns the number of queries that were rejected by the Teradata dynamic workload
management software for this WD during this interval.
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Column Name
Description
RejectionCat
Contains the category of the Teradata dynamic workload management software rules that
caused this rejection.
These are the values:
• 1 - a rejection due to a Category 1(Filter) rule
• 2 - a rejection due to a Category 2 (Throttle) rule
• 3 - a rejections due to a Category 3 (WD) rule
Data Type
346
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
ZZZ9
ZZZ9
Associated View
QryLogExceptions
QryLogExceptionsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
RepStatus
These are the possible values:
•
•
•
•
•
•
•
C = connected
D = defined
F = failed
S = suspended
T = terminated
I = Initiated
NULL
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
CHAR(1)
LATIN
UPPERCASE
Format
X(1)
X(1)
Associated View
Tables[X]
TablesV[X]
Column Name
Description
RequestNum
Returns the client request number for all queries.
For stored procedure CALL statements, the request number for the statements that occur
within the stored procedure all reports the same number as the CALL itself.
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLog
QryLogV
Returns the request number of the query that has an exception.
Data Type
Data Dictionary
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogExceptions
QryLogExceptionsV
347
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
RequestText
Returns the text of the most recent data definition statement that was used to change the
table, view, join index, trigger, macro, user-defined types, user-defined methods, or user
defined function.
Data Type
Compatibility View
Unicode View
VARCHAR(12,500)
UNICODE
VARCHAR(12,500)
UNICODE
Format
X(255)
X(255)
Associated View
Tables[X]
TablesV[X]
Returns the actual request text that was used to create the trigger.
Data Type
Compatibility View
Unicode View
VARCHAR(12,500)
UNICODE
VARCHAR(12,500)
UNICODE
Format
X(255)
X(255)
Associated View
Triggers[X]
TriggersV[X]
Returns the text of the most recent data definition statement used to change the table, view,
or macro.
Data Type
Compatibility View
Unicode View
VARCHAR(32000) per row
UNICODE
VARCHAR(32000) per row
UNICODE
Format
X(255)
X(255)
Associated View
TableText[X]
TableTextV[X]
Column Name
Description
ResolvedCurrent_Date
Returns the last resolved value of CURRENT_DATE.
348
Data Type
DATE
Format
YY/MM/DD
Associated View
ResolvedDTSV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ResolvedCurrent_Date
Returns the date value that defines the last reconciled date if the object is a join index or a
table that is defined using DATE or CURRENT_DATE; otherwise, the system returns a
NULL value.
(Continued)
Data Type
Compatibility View
Unicode View
DATE
DATE
Format
YY/MM/DD
YY/MM/DD
Associated View
Table_LevelConstraints[X]
ShowTblChecks[X]
Tables[X]
IndexConstraints[X]
Table_LevelConstraintsV[X]
ShowTblChecksV[X]
TablesV[X]
IndexConstraintsV[X]
Column Name
Description
ResolvedCurrent_TimeStamp
Returns the last resolved value of CURRENT_TIMESTAMP.
Data Type
TIMESTAMP WITH TIME
ZONE
Format
YYYY-MMDDBHH:MI:SS.S(F)Z
Associated View
ResolvedDTSV[X]
Returns the timestamp value that defines the last reconciled timestamp if join index or a
table that is defined using CURRENT_TIMESTAMP; otherwise, the system returns a NULL
value.
Data Type
Data Dictionary
Compatibility View
Unicode View
TIMESTAMP WITH TIME
ZONE
TIMESTAMP WITH TIME
ZONE
Format
YYYY-MMDDBHH:MI:SS.S(F)Z
YYYY-MMDDBHH:MI:SS.S(F)Z
Associated View
Table_LevelConstraints[X]
ShowTblChecks[X]
Tables[X]
IndexConstraints[X]
Table_LevelConstraintsV[X]
ShowTblChecksV[X]
TablesV[X]
IndexConstraintsV[X]
349
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ResolvingUserLogonName
Returns the identity of the user who resolved the in-doubt transaction.
Data Type
Compatibility View
Unicode View
CHAR (30)
LATIN/KANJI1
NOT NULL
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
DeleteOldInDoubt
InDoubtLog
DeleteOldInDoubtV
InDoubtLogV
Column Name
Description
RestartSeqNum
Returns an integer (0 through n) to indicate the number of times that the Teradata Database
had to be restarted during the event. 0 indicates that no restarts took place.
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
Events[X]
Events_Configuration[X]
EventsV[X]
Events_ConfigurationV[X]
Returns an integer (0 through n) indicating the iteration of the event for which the processor
is defined. A 0 value indicates that a restart did not take place. This number matches the
RestartSeqNum value in a row of the Events view.
Data Type
350
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
RCC_Configuration[X]
RCC_ConfigurationV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
RestrictedWord
Returns a default list of restricted word.
For a complete list of restricted words, see SQL Fundamentals.
Data Type
Compatibility View
Unicode View
VARCHAR(60)
UNICODE
UPPERCASE
NOT NULL
VARCHAR(60)
UNICODE
UPPERCASE
NOT NULL
Format
X(128)
X(128)
Associated View
RestrictedWords
RestrictedWordsV
Column Name
Description
RoleName
Returns the name of a role.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
RoleMembers[X]
AllRoleRights
UserRoleRights
RoleInfo[X]
RoleMembersV[X]
AllRoleRightsV
UserRoleRightsV
RoleInfoV[X]
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
Users
UsersV
351
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
RoutineKind
Returns a single character indicating the family of the routine.
These are the values:
C = Constructor
D = Decompress UDF
E = Compress UDF
M = Mutator
O = Observer
R = Regular Function
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Functions[X]
ExternalSPs[X]
FunctionsV[X]
ExternalSPsV[X]
Column Name
Description
RowCount
Returns the number of rows inserted for the MultiLoad EXE step and the Merge Row
Multiple (MRM) step.
For other steps, RowCount is the number of rows returned by the step.
Data Type
352
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---,---,--9
----,---,---,---,--9
Associated View
QryLogSteps
QryLogStepsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
RowCount2
Returns the number of rows updated by the MultiLoad EXE step or the MRM step.
For FastLoad LFI step, RowCount2 is the number of rows loaded by the step.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---,---,--9
----,---,---,---,--9
Associated View
QryLogSteps
QryLogStepsV
Column Name
Description
RowsWComprColumns
For each step, the system returns the number of rows which contains at least one compressed
column.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---,---,--9
----,---,---,---,--9
Associated View
QryLogSteps
QryLogStepsV
Column Name
Description
RuleID
Returns the rule ID that caused the Teradata dynamic workload management software to
reject a query or logon.
Note: This field is not populated in all cases.
Data Type
Data Dictionary
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogExceptions
QryLogExceptionsV
353
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
RuleSetName
Returns the mixed-case user-defined rule set name.
Data Type
Unicode View
VARCHAR(128) UNICODE
NOT NULL
Format
X(128)
Associated View
RepCaptureRulesV
Column Name
Description
RunUnitId
Returns the identity of the run unit that had the in-doubt transaction.
Data Type
Compatibility View
Unicode View
VARBYTE(30)
NOT NULL
VARBYTE(30)
NOT NULL
Format
X(60)
X(60)
Associated View
DeleteOldInDoubt
InDoubtLog
DeleteOldInDoubtV
InDoubtLogV
Column Name
Description
ScopeValue
Identifies the scope of the event from the values listed below.
1 - System level
2 - Session level
3 - Request level
Data Type
354
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
--9
--9
Associated View
QryLogEvents
QryLogEventsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
SeqNo
Returns a sequence number used to help the user understand the sequence of events,
expression, syscon, and openv changes that have occurred.
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
ZZZ9
ZZZ9
Associated View
QryLogEventHis
QryLogEventHisV
Column Name
Description
SeqNumber
Returns column sequence numbers derived from the field ID. The output is sorted in the
order of the sequence numbers.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
ColumnStats
ColumnStatsV
Column Name
Description
SessionID
Returns the session identifier.
Data Type
Data Dictionary
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLog
QryLogSummary
QryLogV
QryLogSummaryV
355
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
SessionID
(Continued)
Returns the session identifier.
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogEvents
QryLogEventsV
Returns the session identifier under which the exception occurred.
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogExceptions
QryLogExceptionsV
Column Name
Description
SessionMode
Returns the name of the session mode used to determine the default case sensitivity in
evaluating the index constraint. These are the values:
• A = ANSI
• T = Teradata
For index constraints not involving comparison of character data, the value is NULL.
Data Type
356
Compatibility View
Unicode View
CHAR(1) LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
IndexConstraints[X]
IndexConstraintsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
SessionNo
Returns the session identifier assigned to the session by the TDP or LAN interface.
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
AccessLog
LogOnOff[X]
SessionInfo[X]
AllTempTables[X]
CSPSessionInfo
AccessLogV
LogOnOffV[X]
SessionInfoV[X]
AllTempTablesV[X]
CSPSessionInfoV
Column Name
Description
SessionNumber
Returns the session identifier of the session that had the in-doubt transaction.
Note: SessionID, SessionNo,
and SessionNumber have
the same meaning.
Data Type
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
DeleteOldInDoubt
InDoubtLog
DeleteOldInDoubtV
InDoubtLogV
Column Name
Description
SessionTemporalQualifier
Returns the session temporal qualifier for the session apart from the SQL stored.
Data Type
Data Dictionary
Compatibility View
Unicode View
VARCHAR(1024)
LATIN
NOT CASESPECIFIC
VARCHAR(1024)
LATIN
NOT CASESPECIFIC
Format
X(1024)
X(1024)
Associated View
QryLog
QryLogV
357
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
Severity
The Severity option returns a code identifying the severity of a software event. Possible
values are as follows:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
0 = Hardware and software are informational events (Occurrence)
10 = Software abnormality--informational (SW Abnormality)
20 = Hardware abnormality--informational (HW Abnormality)
30 = Recoverable user error (UserError Retry)
40 = Unrecoverable user error (UserError)
50 = Unrecoverable user error, no user restart (UserFatal)
60 = Unrecoverable Vproc error, Vproc restart required (VprocError)
70 = Unrecoverable Vproc error, no Vproc restart (VprocFatal)
80 = Recoverable PDE error (OSErrorRetry)
90 = Unrecoverable PDE error, restart required (OSError)
100 = Unrecoverable PDE error, restart not possible (OSFatal)
110 = Unrecoverable CPU hardware error, restart required (CPUError)
120 = Unrecoverable CPU hardware error, CPU stay down (CPUFatal)
130 = Unrecoverable PMA hardware error, PMA restart required (PMAError)
140 = Unrecoverable PMA hardware error, PMA stays down (PMAFatal)
200 = Unrecoverable system error, system restart required (SystemError)
210 = Unrecoverable system error, restart not possible (SystemFatal)
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
ZZ9
ZZ9
Associated View
Software_Event_Log
Software_Event_LogV
Column Name
Description
SLGMet
Indicates that the query met the Service Level Goals (SLG) of the WD.
Data Type
358
Compatibility View
Unicode View
CHAR(1)
LATIN
CHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
QryLogTDWM
QryLogTDWMV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
SpecificName
Returns the specific (unique) name of a function.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Functions[X]
FunctionsV[X]
Column Name
Description
SpoolSpace
Returns an integer indicating the maximum spool space allowed for the database.
SpoolSpace is 0 if DatabaseName is PUBLIC.
Data Type
Data Dictionary
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
ZZZ,ZZZ,ZZZ,ZZZ,ZZ9
(explicit)
ZZZ,ZZZ,ZZZ,ZZZ,ZZ9
(explicit)
Associated View
Databases[X]
DatabasesV[X]
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
---,---,---,---,--9 (explicit)
---,---,---,---,--9 (explicit)
Associated View
Users
UsersV
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---,---,--9
----,---,---,---,--9
Associated View
ProfileInfo[X]
ProfileInfoV[X]
359
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
SpoolUsage
The maximum amount of spool used while processing the query.
If SpoolUsage is 0, there is no usage. If SpoolUsage is NULL, the data was not valid.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---,---,--9
----,---,---,---,--9
Associated View
QryLog
QryLogSteps
QryLogV
QryLogStepsV
Column Name
Description
SPParameterType
Returns the data type of a stored procedure parameter and is also used as the data type of a
UDF/UDM.
Possible types are:
B = INOUT parameter (for Stored Procedure only)
C = Column for Table Function
E = Result type of the external function or method
I = Input parameter of a function or method
O = OUT parameter of a function or method
S = SELF parameter
Data Type
360
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
Columns[X]
ColumnsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
SqlFlag
(Title: SQL)
The following codes are used:
• T = SQL text is stored in DBC.DBQLSqlTbl
• F = SQL text is not stored in DBC.DBQLSqlTbl
Up to 10,000 characters can be stored in DBC.DBQLogTbl.
The entire SQL statement is stored in DBQLSqlTbl unless an error is encountered, or the
SQL is aborted.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
DBQLRules
DBQLRulesV
Column Name
Description
SqlRowNo
Needed in case multiple rows are used for the SQL.
If the additional SQL text or the SQL text exceeds 32KB, the system generates multiple rows.
Data Type
Data Dictionary
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogSQL
QryLogSQLV
361
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
SqlTextInfo
Returns a full SQL text segment unless an error is encountered, or the SQL is aborted.
These are the values:
• Unavailable
• Null(?)
There are conditions where the SQL is not available to DBQL at the end of the query or
when a query fails. In this instance, the SqlTextInfo may be Null (?), or it may be
"Unavailable." The word "Unavailable" is seen when it fails to translate correctly, for
example, when the SQL is submitted from a mainframe in EBCDIC format or when
UNICODE translation is required.
Data Type
Compatibility View
Unicode View
VARCHAR (31000)
UNICODE
NOT NULL
VARCHAR (31000)
UNICODE
NOT NULL
Format
X(31000)
X(31000)
Associated View
QryLogSQL
QryLogSQLV
Column Name
Description
SrcFileLanguage
Returns the source file language used to implement a user-defined function (UDF).
These are the options:
• C=C
• P = C++
• J = JAVA
• S = SQL
Data Type
362
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Functions[X]
ExternalSPs[X]
FunctionsV[X]
ExternalSPsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
StartColTime
Indicates the time at the start of the summary interval.
Data Type
Compatibility View
Unicode View
TIMESTAMP(2)
NOT NULL
TIMESTAMP(2)
NOT NULL
Format
YYYY-MMDDBHH:MI:SS.S(F)Z
YYYY-MMDDBHH:MI:SS.S(F)Z
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Column Name
Description
StartMBox
Returns the client/platform mailbox ID where the SQL request is sent.
Data Type
Compatibility View
Unicode View
BYTE
BYTE
Format
X(20)
X(20)
Associated View
CSPSessionInfo
CSPSessionInfoV
Column Name
Description
StartTime
Returns the time the query is submitted.
Data Type
Data Dictionary
Compatibility View
Unicode View
TIMESTAMP(2)
NOT NULL
TIMESTAMP(2)
NOT NULL
Format
YYYY-MMDDBHH:MI:SS.S(F)Z
YYYY-MMDDBHH:MI:SS.S(F)Z
Associated View
QryLog
QryLogV
363
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
StartupString
Returns the startup string (macro or SQL statement) specified for the user.
Data Type
Compatibility View
Unicode View
VARCHAR(255)
UNICODE
VARCHAR(255)
UNICODE
Format
X(255)
X(255)
Associated View
Users
UsersV
Column Name
Description
StatementGroup
Returns the grouping for the query, whether it is a DDL, DML, or SELECT statement. For a
multistatement request, it returns the number of statement types in the DML request. This
information is an enhancement to StatementType because it reports the grouping and
instead of just the final statement in the multistatement request, the range of statements is
reported. These two fields can be used to characterize a workload.
Data Type
364
Compatibility View
Unicode View
VARCHAR(128)
UNICODE
VARCHAR(128)
UNICODE
Format
X(128)
X(128)
Associated View
QryLog
QryLogTDWM
QryLogV
QryLogTDWMV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
StatementType
Returns the type of statement issued by the query. If the query is a multistatement request,
this field contains the type of the final statement in the request.
The StatementType uses a 20-character field to describe the statement.
Data Type
Compatibility View
Unicode View
VARCHAR(20)
LATIN
NOT NULL
VARCHAR(20)
LATIN
NOT NULL
Format
X(20)
X(20)
Associated View
AccessLog
AccessLogV
Data Type
Compatibility View
Unicode View
CHAR(20)
LATIN
CHAR(20)
LATIN
Format
X(20)
X(20)
Associated View
QryLog
QryLogV
Column Name
Description
StatementText
Returns (if so defined in the associated rule) the text of the statement that caused the
privilege check for which this log entry was made.
Data Type
Data Dictionary
Compatibility View
Unicode View
VARCHAR (8192)
UNICODE
VARCHAR (8192)
UNICODE
Format
X(8192)
X(8192)
Associated View
AccessLog
AccessLogV
365
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
StatisticsId
Returns the internal number assigned to the statistics.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
MultiColumnStats
MultiColumnStatsV
Column Name
Description
Status
Returns the status of the table.
These are the values:
• 0 = Not completed
• 1 = Completed
• 2 = Retry
Data Type
Unicode View
BYTEINT
366
Format
ZZ9
Associated View
ReconfigTableStatsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
Statuss
(Continued)
Returns the current status of the Reconfig.
These are the values:
•
•
•
•
•
•
•
•
•
•
•
•
Start
Redist
Delete
Checktable
Abort
Idle
Pause
Offline
Complete
RedistFail
DeleteFail
RcoFail
Data Type
Unicode View
CHAR(10)
LATIN
NOT CASESPECIFIC
NOT NULL
Format
X(10)
Associated View
ReconfigInfoV
Column Name
Description
StepFlag
(Title: Step)
The following codes are used:
• T = Step-level data is stored in DBC.DBQLStepTbl
• F = Step-level data is not provided in DBC.DBQLStepTbl
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
DBQLRules
DBQLRulesV
367
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
StepLev1Num
Returns the level 1 step number.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
QryLogSteps
QryLogStepsV
Column Name
Description
StepLev2Num
Returns the level 2 step number.
For parallel steps, the second level number is the indication that it is a parallel step. For
example, the step number for the first parallel step of step 4 would read “04 01.”
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
QryLogSteps
QryLogStepsV
Column Name
Description
StepName
Returns an abbreviation of the step name.
For example: DEL for delete step.
Data Type
368
Compatibility View
Unicode View
CHAR(6)
LATIN
NOT NULL
CHAR(6)
LATIN
NOT NULL
Format
X(6)
X(6)
Associated View
QryLogSteps
QryLogStepsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
StepStartTime
Returns the date and time the step is sent to the AMP.
Data Type
Compatibility View
Unicode View
TIMESTAMP(6)
TIMESTAMP(6)
Format
YYYY-MM-DDBHH:MI:SS.S(F)Z
YYYY-MMDDBHH:MI:SS.S(F)Z
Associated View
QryLogSteps
QryLogStepsV
Column Name
Description
StepStopTime
Returns the date and time the step returns from the AMP.
Data Type
Compatibility View
Unicode View
TIMESTAMP(6)
TIMESTAMP(6)
Format
YYYY-MM-DDBHH:MI:SS.S(F)Z
YYYY-MMDDBHH:MI:SS.S(F)Z
Associated View
QryLogSteps
QryLogStepsV
Column Name
Description
StepWD
Returns the identifier of the workload for the step.
Data Type
Data Dictionary
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogSteps
QryLogStepsV
369
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
SubjectTableDatabaseName
Returns the name of the database or user in which the subject table of the trigger resides.
You can use this to check for potential orphan triggers.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Triggers[X]
TriggersV[X]
Column Name
Description
SummaryFlag
(Title: Summary)
The following codes are used:
• T = Summary information is stored in DBC.DBQLSummaryTbl
• F = Data is not summarized
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
DBQLRules
DBQLRulesV
Column Name
Description
SummaryVal1
(Title: Summary//Low)
Returns the Threshold value if ThresholdFlag is True.
Returns the high value for interval 1 if SummaryFlag is True.
The value can be in seconds, IOs, or hundredths of CPU seconds (see ThreshValue).
Data Type
370
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
DBQLRules
DBQLRulesV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
SummaryVal2
(Title: Med)
Returns the high value for interval 2 if SummaryFlag is True
The value can be in seconds, IOs, or hundredths of CPU seconds (see ThreshValue).
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
DBQLRules
DBQLRulesV
Column Name
Description
SummaryVal3
(Title: High)
Returns the high value for interval 3 if SummaryFlag is True.
This same value is used for interval 4.
The value can be in seconds, IOs, or hundredths of CPU seconds (see ThreshValue).
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
DBQLRules
DBQLRulesV
Column Name
Description
SW_Version
(Title: SW Version)
Identifies the software version running at the time the event was logged.
Data Type
Data Dictionary
Compatibility View
Unicode View
VARCHAR(64)
LATIN
VARCHAR(64)
LATIN
Format
X(64)
X(64)
Associated View
Software_Event_Log
Software_Event_LogV
371
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
SysConID
Returns the ID of the system condition currently activated by the Teradata dynamic
workload management software.
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogExceptions
QryLogTDWM
QryLogEvents
QryLogTDWMSum
QryLogExceptionsV
QryLogTDWMV
QryLogEventsV
QryLogTDWMSumV
Column Name
Description
SystemDefinedJI
Records whether a join index is system-defined or user-defined.
These are the values:
• Y = The TVM row describes a join index defined by the system. Such an index is defined
when there are temporal constraints on the underlying base table.
• NULL = Any other objects in the system, or a user-defined join index.
Data Type
372
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
Indices[X]
IndexStats
IndicesV[X]
IndexStatsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
SystemDefinedJI
Records whether a table level object kind is a system-defined join index or any other object
such as table, view, macro, user-defined join index, or stored procedure.
(Continued)
These are the values:
• Y = If the entry is corresponding to a system-defined join index
• N = Any other objects in the system
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
Tables[X]
TablesV[X]
Column Name
Description
TableKind
Returns the table type as one of the following:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Data Dictionary
A = Aggregate function
B = Combined aggregate and ordered analytical function
D = JAR
E = External Stored Procedure
F = Standard function
G = Trigger
H = Instance or Constructor Method
I = Join Index
J = Journal
M = Macro
N = Hash Index
O = No Primary Index
P = SQL Procedure
Q = Queue Table
R = Table function
S = Ordered analytical function
T = Table
U = User-defined data type
V = View
X = Authorization
Y = GLOP Set
373
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
TableKind
(Continued)
374
Description
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Tables[X]
TableText[X]
Authorizations[X]
TablesV[X]
TableTextV[X]
AuthorizationsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TableName
Returns the name of a table, view, stored procedure, trigger, macro, user-defined types, userdefined methods, or user-defined function on which a privilege was granted.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
AllRights[X]
AllRightsV[X]
Returns the name of a table, join index, or hash index.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
AllSpace[X]
Indices[X]
Tables[X]
TableSize[X]
AllRoleRights
UserRoleRights
TableText[X]
MultiColumnStats
RepTables[X]
AllSpaceV[X]
IndicesV[X]
TablesV[X]
TableSizeV[X]
AllRoleRightsV
UserRoleRightsV
TableTextV[X]
MultiColumnStatsV
RepTablesV[X]
JoinIndicesV
ResolvedDTSV[X]
375
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TableName
(Continued)
Returns the name of a table, view, stored procedure, or macro.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Columns[X]
UserGrantedRights
UserRights
ColumnsV[X]
UserGrantedRightsV
UserRightsV
ReconfigRedistOrderV
ReconfigDeleteOrderV
ReconfigTableStatsV
Returns the imported object name.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Association[X]
AssociationV[X]
Returns the name of the table affected by the event. If the object is a database, then the value
is set to NULL.
Data Type
376
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Events[X]
EventsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TableName
(Continued)
Returns the name of a data table that has change images recorded in a journal table.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Journals[X]
JournalsV[X]
Returns the name of the table, view, stored procedure, or macro for this log entry.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
SecurityLog[X]
SecurityLogV[X]
Returns the name of a table having column-level check constraints.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
ShowColChecks[X]
ShowColChecksV[X]
377
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TableName
(Continued)
Returns the name of a table having table-level check constraints.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
ShowTblChecks[X]
Table_LevelConstraints[X]
ShowTblChecksV[X]
Table_LevelConstraintsV[X]
Returns the name of the table the trigger is defined against.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Triggers[X]
TriggersV[X]
Returns the name of the table containing the column for which statistics are requested.
Data Type
378
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
ColumnStats
IndexStats
ColumnStatsV
IndexStatsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TableName
(Continued)
Returns the name of the table on which the index is built.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
IndexConstraints[X]
IndexConstraintsV[X]
Column Name
Description
Tables_DB
Returns the name of the database in which a data table resides that has change images
written to a journal table.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Journals[X]
Journals[X]
Column Name
Description
Task
Returns the unique task number assigned to each task as it is created for execution.
Data Type
Data Dictionary
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
ZZZZ9
ZZZZ9
Associated View
Software_Event_Log
Software_Event_Log
379
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TblCheck
Returns the unresolved text for the table-level check condition.
Data Type
Compatibility View
Unicode View
VARCHAR(8192)
LATIN/KANJI1
CASESPECIFIC
VARCHAR(8192)
UNICDOE
CASESPECIFIC
Format
X(8192)
X(256)
Associated View
ShowTblChecks[X]
ShowTblChecksV[X]
Column Name
Description
TDWMAllAmpFlag
Indicates whether one of the steps in the query was an all-AMP step.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
CHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
QryLogTDWM
QryLogTDWMV
Column Name
Description
TDWMConfLevelUsed
Returns the minimum confidence level that the Teradata dynamic workload management
software is allowed to use in looking at estimated data.
Data Type
380
Compatibility View
Unicode View
CHAR(1)
LATIN
CHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
QryLogTDWM
QryLogTDWMV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TDWMEstLastRows
Returns the estimated last step row number as generated by the Optimizer.
This column is used to classify queries into WD.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---,---,--9
----,---,---,---,--9
Associated View
QryLogTDWM
QryLogTDWMV
Column Name
Description
TDWMEstMaxRows
Returns the estimated maximum rows as generated by the Optimizer.
This column is used to classify queries into WD.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---,---,--9
----,---,---,---,--9
Associated View
QryLogTDWM
QryLogTDWMV
Column Name
Description
TDWMEstTotalTime
Returns the estimated total time as generated by the Optimizer.
This column is used to classify queries into WD.
Data Type
Data Dictionary
Compatibility View
Unicode View
FLOAT
FLOAT
Format
ZZZZ9.999999 (explicit)
ZZZZ9.999999 (explicit)
Associated View
QryLogTDWM
QryLogTDWMV
381
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TemporalProperty
Indicates whether the table/view/join index is a nontemporal, ValidTime, TransactionTime,
or bi-temporal table.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
Tables[X]
TablesV[X]
Column Name
Description
TemporalQualifier
Resets the qualifier in the session across a database restart.
Data Type
382
Compatibility View
Unicode View
VARCHAR(1024)
LATIN
NOT CASESPECIFIC
VARCHAR(1024)
LATIN
NOT CASESPECIFIC
Format
X(1024)
X(1024)
Associated View
SessionInfo[X]
SessionInfoV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TempSpace
Returns the maximum temporary space allocated for a database, profile, or user in bytes.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
ZZZ,ZZZ,ZZZ,ZZZ,ZZ9
(explicit)
ZZZ,ZZZ,ZZZ,ZZZ,ZZ9
(explicit)
Associated View
Databases[X]
DatabasesV[X]
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
---,---, ---,---,--9 (explicit)
---,---, ---,---,--9 (explicit)
Associated View
Users
UsersV
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---, ---,---,--9
----,---, ---,---,--9
Associated View
ProfileInfo[X]
ProfileInfoV[X]
Column Name
Description
Text
Returns the text associated with the numbered event in the error log.
For Database Query Manager, the Text column returns error messages that are broken into
sections that can fit within the 255-character field.
Data Type
Data Dictionary
Compatibility View
Unicode View
VARCHAR(8192)
UNICODE
VARCHAR(8192)
UNICODE
Format
X(8192)
X(8192)
Associated View
SecurityLog[X]
SecurityLogV[X]
383
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
Text
(Title: Message Text)
Returns the text associated with the logged event.
Data Type
Compatibility View
Unicode View
VARCHAR(30000)
LATIN/KANJI1
NOT NULL
VARCHAR(30000)
UNICODE
NOT NULL
Format
X(30000)
X(255)
Associated View
Software_Event_Log
Software_Event_LogV
Column Name
Description
TextSizeLimit
(Title: TextSize)
Returns the number of characters of SQL text to be stored in the DBQLogTbl.
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---, ---,--9
--,---, ---,--9
Associated View
DBQLRules
DBQLRulesV
Column Name
Description
TheDate
(Title: Date)
Returns the calendar date on which the event was logged.
Data Type
384
Compatibility View
Unicode View
DATE
NOT NULL
DATE
NOT NULL
Format
YY/MM/DD
YY/MM/DD
Associated View
Software_Event_Log
Software_Event_LogV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TheFunction
(Title: Function)
Returns the identification string for the entity reporting a software event.
Data Type
Compatibility View
Unicode View
VARCHAR(32)
LATIN
VARCHAR(32)
LATIN
Format
X(32)
X(32)
Associated View
Software_Event_Log
Software_Event_LogV
Column Name
Description
TheTime
(Title: Time)
Returns the clock time at which the event was logged, based on a 24-hour clock (hh:mm:ss).
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
99:99:99.999999
99:99:99.999999
Associated View
Software_Event_Log
Software_Event_LogV
Column Name
Description
ThresholdFlag
(Title: Threshold)
The following codes are used:
T = Count queries shorter or equal to SummaryVal1 in DBC.DBQLSummaryTbl, detailed
data on long queries in DBC.DBQLogTbl.
F = Provide detailed data for all queries in DBC.DBQLogTbl unless SummaryFlag is True.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
DBQLRules
DBQLRulesV
385
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TimeDimension
Returns the ValidTime and TransactionTime properties for a period column.
These are the values:
•
•
•
•
•
N = Nontemporal column (default)
NULL = View column
R = Temporal Relationship Constraint (TRC)
T = TransactionTime column
V = ValidTime column
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
Columns[X]
ColumnsV[X]
TimeDimension
Indicates whether the table/join index/view is one of the following:
(Continued)
•
•
•
•
•
NULL = a nontemporal for a view
N = a nontemporal for a table/join index
V = ValidTime
T = TransactionTime
B = Bi-temporal table
Data Type
386
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
ShowColChecks[X]
IndexStats
ShowColChecksV[X]
IndexStatsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TimeZoneHour
Returns the format of the time zone as signed integer values from -12:59 to +13:00.
Data Type
Compatibility View
Unicode View
BYTEINT
BYTEINT
Format
---9
---9
Associated View
Users
UsersV
Column Name
Description
TimeZoneMinute
Returns the format of the time zone as signed integer values from -12:59 to +13:00.
Data Type
Compatibility View
Unicode View
BYTEINT
BYTEINT
Format
---9
---9
Associated View
Users
UsersV
Column Name
Description
TotalIOCount
Returns the number of IOs from AMPs that were generated by the query.
Data Type
Data Dictionary
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---,---,--9
----,---,---,---,--9
Associated View
QryLog
QryLogSummary
QryLogV
QryLogSummaryV
387
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TotByteCount
Returns the total number of bytes processed during the time period defined by
BeginTimeStamp and EndTimeStamp.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
ReconfigInfoV
Column Name
Description
TotCatchUpByteCount
Returns the total number of bytes processed for catch-up.
Catch-up is defined as the process of applying updates recorded in
DBC.ReconfigJournalTbl to the new AMPs.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigInfoV
Column Name
Description
TotCPUSecs
Returns the total number of CPU seconds used during the time period defined by
BeginTimeStamp and EndTimeStamp.
Data Type
Unicode View
FLOAT
NOT NULL
388
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TotIOCount
Returns the total number of IOs done during the time period defined by BeginTimeStamp
and EndTimeStamp.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
Column Name
Description
TotJournalByteCount
Returns the ReconfigJournalTbl size.
Data Type
Unicode View
FLOAT
NOT NULL
Format
----,---,---,---,--9
Associated View
ReconfigInfoV
Column Name
Description
TotRowCount
Returns the total number of rows processed during the time period defined by
BeginTimeStamp and EndTimeStamp.
Data Type
Unicode View
FLOAT
NOT NULL
Data Dictionary
Format
----,---,---,---,--9
Associated View
ReconfigTableStatsV
389
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TotTableCount
Returns the total number of tables processed.
Data Type
Unicode View
INTEGER
NOT NULL
Format
ZZZZZZZZZ9
Associated View
ReconfigInfoV
Column Name
Description
TotTaskCount
Returns the total number of tasks involved in the Reconfig.
Data Type
Unicode View
SMALLINT
NOT NULL
Format
ZZZZ9
Associated View
ReconfigInfoV
Column Name
Description
Transaction_Mode
Returns one of the following codes to indicate the mode of the session:
• T = TDBS
• A = ANSI
Data Type
390
Compatibility View
Unicode View
CHAR(1)
LATIN
CHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
SessionInfoV
SessionInfoV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TransLog
Specifies whether transaction journals are generated. These are the values:
• Y = transaction journals are generated
• N = no logging for transaction journals
Data Type
Compatibility View
Unicode View
CHAR(1)
NOT NULL
LATIN
CHAR(1)
NOT NULL
LATIN
Format
X(1)
X(1)
Associated View
Tables[X]
TablesV[X]
Column Name
Description
TriggerComment
Returns the optional comment for the trigger.
Data Type
Compatibility View
Unicode View
VARCHAR(255)
UNICODE
VARCHAR(255)
UNICODE
Format
X(255)
X(255)
Associated View
Triggers[X]
TriggersV[X]
Column Name
Description
TriggerName
Returns the name of the trigger.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Triggers[X]
TriggersV[X]
391
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TrustOnly
Indicates whether the ProxyUser must be set in a Trusted request.
These are the values:
• Y = Setting the ProxyUser requires a trusted request
• N = Setting the ProxyUser does not require a trusted request
The default is N.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN/KANJI1
NOT NULL
CHAR(1)
LATIN/KANJI1
NOT NULL
Format
X(1)
X(1)
Associated View
ConnectRules
ConnectRulesV
Column Name
Description
TrustUser
Returns the permanent user that has been granted the CONNECT THROUGH privilege.
Data Type
392
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
ConnectRules
ConnectRulesV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TTCheckType
Returns the TransactionTime dimension for the CHECK constraint on a table with
TransactionTime.
These are the values:
• NULL = No TransctionTime Dimension.
• C = Current TransactionTime.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
Columns[X]
Table_LevelConstraints[X]
ShowTblChecks[X]
ShowColChecks[X]
IndexConstraints[X]
ColumnsV[X]
Table_LevelConstraintsV[X]
ShowTblChecksV[X]
ShowColChecksV[X]
IndexConstraintsV[X]
Column Name
Description
TTConstraintType
Returns one of the following values:
• C = Current
• S = Sequenced
• N = Nonsequenced
• Null = Used for all rows on a table that does not support TransactionTime
If the table supports TransactionTime, a value of NULL indicates that the row is for an index
and not a temporal unique/primary constraint.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
Indices[X]
IndexStats
IndicesV[X]
IndexStatsV
393
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TTEventType
Records the TransactionTime qualifier on the subject table.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
Triggers[X]
TriggersV[X]
Column Name
Description
TTFKType
Returns the TransactionTime dimension for the foreign key.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
RI_Parent_Tables[X]
RI_Child_Tables[X]
RI_Parent_TablesV[X]
RI_Child_TablesV[X]
Column Name
Description
TTPKType
Returns the TransactionTime dimension for the parent key.
Data Type
394
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
RI_Parent_Tables[X]
RI_Child_Tables[X]
RI_Parent_TablesV[X]
RI_Child_TablesV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TTQualifier
Records the temporal qualifier for TransactionTime dimension.
These are the values:
•
•
•
•
NULL = No TransactionTime Dimension
C = Current TransactionTime
S = Sequenced TransactionTime
N = Non-Sequenced TransactionTime
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
Tables[X]
TablesV[X]
Column Name
Description
TVMId
Returns the internal ID of the table.
Data Type
Data Dictionary
Compatibility View
Unicode View
BYTE(6)
NOT NULL
BYTE(6)
NOT NULL
Format
X(12)
X(12)
Associated View
Tables2[X]
Tables2V[X]
395
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TVMName
Returns the table, view, stored procedure, macro, user-defined types, user-defined methods,
or user-defined function name of the object for which this log entry was made.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
AccessLog
AccessLogV
Returns the table, view, stored procedure, macro, or user-defined function to which the
access logging rule applies.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
AccLogRules
AccLogRulesV
Returns the name of the table.
Data Type
396
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Tables2[X]
Tables2V[X]
ArchiveLoggingObjsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TwoPCMode
Returns one of the following codes:
• 2 = 2PC mode
• N = non-2PC mode
Data Type
Column Name
Compatibility View
Unicode View
VARCHAR(1)
LATIN
VARCHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
SessionInfo[X]
SessionInfoV[X]
Compatibility View
Unicode View
VARCHAR(22)
UNICODE
VARCHAR(22)
UNICODE
Format
X(22)
X(22)
Associated View
DBQLRules
DBQLRulesV
Description
TypeOfCriterion
Data Type
Column Name
Description
TypeOfRule
These are the values:
• Logging enabled
• WITH NONE (No logging)
Data Type
Data Dictionary
Compatibility View
Unicode View
VARCHAR(22)
UNICODE
VARCHAR(22)
UNICODE
Format
X(22)
X(22)
Associated View
DBQLRules
DBQLRulesV
397
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
TypeofUse
Returns the use of the object.
These are the values:
•
•
•
•
•
•
•
1 = Found in the resolver
2 = Accessed during query processing
4 = Found in a conditional context
8 = Found in inner join condition
16 = Found in outer join condition
32 = Found in a sum node
64 = Found in a full outer join condition
Data Type
Compatibility View
Unicode View
BYTEINT
BYTEINT
Format
--9
--9
Associated View
QryLogObjects
QryLogObjectsV
Column Name
Description
UniqueFlag
Returns a code to indicate whether the index is unique. The following codes are used:
• Y = Yes; index is unique
• N = No; index is not unique
Data Type
398
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Indices[X]
IndexStats
IndicesV[X]
IndexStats
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
UniqueOrPK
Returns one of these values:
• U = Unique
• K = Primary Key
• NULL = The unique or primary key constraint is not associated with a time dimension,
or the row is not for a unique or primary key constraint description.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
Indices[X]
IndexStats
IndicesV[X]
IndexStatsV
Column Name
Description
UnnamedTblCheckExist
Returns an indicator for whether the table has an unnamed table-level check constraint, as
follows:
• Y = Yes
• N = No
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
Tables[X]
TablesV[X]
399
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
UnResolvedRICount
Returns the total number of unresolved Referential Integrity (RI) constraints in the
database.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
Databases2[X]
Databases2[X]
Column Name
Description
UpperCaseFlag
Returns the case indicator flag for the column, and whether comparisons on the column are
case specific. The column uses one of the following codes:
• U = Uppercase, not specific
• C = Not uppercase, specific
• N = Not uppercase, not specific
• B = Both
Note: Case flags U, C, and B are valid only for CHAR, VARCHAR, and LONG VARCHAR
columns.
Data Type
400
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
CHAR(1)
LATIN
UPPERCASE
Format
X(1)
X(1)
Associated View
Columns[X]
ColumnsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
UserID
Returns the ID of the user.
Data Type
Compatibility View
Unicode View
BYTE(4)
NOT NULL
BYTE(4)
NOT NULL
Format
X(8)
X(8)
Associated View
QryLog
QryLogTDWM
QryLogV
QryLogTDWMV
Data Type
Compatibility View
Unicode View
BYTE(4)
BYTE(4)
Format
X(8)
X(8)
Associated View
QryLogSummary
QryLogSummaryV
Column Name
Description
UserLogonDate
Returns the date that the specified user logged on.
Data Type
Data Dictionary
Compatibility View
Unicode View
DATE
NOT NULL
DATE
NOT NULL
Format
YY/MM/DD
YY/MM/DD
Associated View
DeleteOldInDoubt
InDoubtLog
DeleteOldInDoubtV
InDoubtLogV
401
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
UserLogonTime
Returns the time that the specified user logged on.
Data Type
Compatibility View
Unicode View
FLOAT
NOT NULL
FLOAT
NOT NULL
Format
99:99:99
99:99:99
Associated View
DeleteOldInDoubt
InDoubtLog
DeleteOldInDoubtV
InDoubtLogV
Column Name
Description
UserName
(Title: Name)
Returns the name or profile of a user.
Data Type
402
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
AccountInfo[X]
AccountInfoV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
UserName
Returns the name of the user for whom the log entry was made.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
AccessLog
SecurityLog[X]
AccessLogV
SecurityLogV[X]
Returns the user to which the access logging rule applies; ALL may be specified.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
AccLogRules
AccLogRulesV
Returns the name of a user.
Note: SYSTEMUSERID is a system user name that tracks console utility activity such as
table rebuild, Diskcopy, or Scandisk.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
AMPUsage[X]
Users
AMPUsageV[X]
UsersV
403
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
UserName
Returns the name of a user to whom the privilege was granted.
(Continued)
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
AllRights[X]
AllRightsV[X]
Returns the username associated with the event.
Note: For the DBC.LogOnOff view, when a user tries to log on with a bad username, a
username of “Non-existent User” is returned.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Events[X]
Events_Configuration[X]
LogOnOff[X]
EventsV[X]
Events_ConfigurationV[X]
LogOnOffV[X]
Returns the name of the user to whom the rule applies; DEFAULT may be specified.
Data Type
404
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
LogonRules
LogonRulesV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
UserName
Returns the Teradata Database userid of the user who is currently logged on.
(Continued)
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
SessionInfo[X]
SessionInfoV[X]
Returns the name of a user space for which a default journal table has been defined.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
User_Default_Journals[X]
User_Default_JournalsV[X]
Returns the username associated with the client system utility dump or restore event.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
Events_Media[X]
Events_MediaV[X]
Returns the username associated with the client system utility dump or restore event.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
AllTempTables[X]
AllTempTablesV[X]
405
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
UserName
Returns the name of the user who issued the query.
(Continued)
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
Format
X(30)
X(128)
Associated View
QryLog
QryLogExceptions
QryLogTDWM
QryLogV
QryLogExceptionsV
QryLogTDWMV
Returns the name of the user associated with the rule.
Data Type
Compatibility View
Unicode View
CHAR(30)
LATIN/KANJI1
VARCHAR(128)
UNICODE
NOT NULL
Format
X(30)
X(128)
Associated View
DBQLRules
DBQLRulesV
Column Name
Description
UserOrProfile
Returns an indication whether the account name is for a user or a profile using the following
values:
• User
• Profile
Data Type
406
Compatibility View
Unicode View
CHAR(7)
UNICODE
NOT NULL
CHAR(7)
UNICODE
NOT NULL
Format
X(7)
X(7)
Associated View
AccountInfo[X]
AccountInfoV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
UtilityTableId
Returns the table ID for the load utilities.
Data Type
Compatibility View
Unicode View
BYTE(4)
BYTE(4)
Format
X(8)
X(8)
Associated View
QryLogSteps
QryLogStepsV
Column Name
Description
UtilityRowCount
Returns the number of rows loaded by FastLoad or MultiLoad.
Data Type
Compatibility View
Unicode View
FLOAT
FLOAT
Format
----,---,---,---,--9
----,---,---,---,--9
Associated View
QryLog
QryLogV
Column Name
Description
UtilVersion
Returns the utility version count.
This column is modified to match the Version column when a significant change of the table
definition occurs that would prohibit an incremental restore or copy of selected partitions
from an archive.
Data Type
Data Dictionary
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
-----9 (explicit)
-----9 (explicit)
Associated View
Tables[X]
TablesV[X]
407
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
ValueType
Returns the type that was used to determine the threshold from the values listed below.
C = CPU seconds
I = IO count
S = Elapsed time in seconds
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
CHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
QryLogSummary
QryLogSummaryV
Column Name
Description
Version
Returns the version count, which is incremented each time the table is altered with a data
definition statement.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
ZZZZ(9)
ZZZZ(9)
Associated View
Tables[X]
TablesV[X]
Returns the version count, which is incremented each time the authorization is being
replaced.
Data Type
408
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
---,--9
---,--9
Associated View
Authorizations[X]
AuthorizationsV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
VolSequenceNum
Returns the sequence number of the volume, which defines the position of the volume in a
multi-volume set.
Data Type
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
---,--9
---,--9
Associated View
RCC_Media[X]
Events_Media[X]
RCC_MediaV[X]
Events_MediaV[X]
Column Name
Description
VolSerialId
Returns the unique six character volume serial assigned to a device.
Data Type
Compatibility View
Unicode View
CHAR(6)
LATIN
NOT NULL
CHAR(6)
LATIN
NOT NULL
Format
X(6)
X(6)
Associated View
Events_Media[X]
RCC_Media[X]
Events_MediaV[X]
RCC_MediaV[X]
Column Name
Description
Vproc
Identifies the virtual processor for which an event was logged.
Data Type
Data Dictionary
Compatibility View
Unicode View
SMALLINT
SMALLINT
Format
-(5)9
-(5)9
Associated View
Events_Configuration[X]
RCC_Configuration[X]
Software_Event_Log
Events_ConfigurationV[X]
RCC_ConfigurationV[X]
Software_Event_LogV
409
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
Vproc
(Continued)
Identifies the virtual processor for which an event was logged.
Data Type
Compatibility View
Unicode View
SMALLINT
NOT NULL
SMALLINT
NOT NULL
Format
-(5)9
-(5)9
Associated View
AllSpace[X]
AMPUsage[X]
DiskSpace[X]
TableSize[X]
AllSpaceV[X]
AMPUsageV[X]
DiskSpaceV[X]
TableSizeV[X]
Column Name
Description
VprocType
Returns the type of Vproc for which an event was logged.
Data Type
410
Compatibility View
Unicode View
CHAR(4)
LATIN
NOT NULL
CHAR(4)
LATIN
NOT NULL
Format
X(4)
X(4)
Associated View
AMPUsage[X]
AMPUsageV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
VTCheckType
Returns the ValidTime dimension information for the CHECK condition.
These are the values:
•
•
•
•
NULL = no ValidTime Dimension.
C = Current ValidTime.
S = Sequenced ValidTime.
N = Nonsequenced ValidTime.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
Columns[X]
Table_LevelConstraints[X]
ShowTblChecks[X]
ShowColChecks[X]
IndexConstraints[X]
ColumnsV[X]
Table_LevelConstraintsV[X]
ShowTblChecksV[X]
ShowColChecksV[X]
IndexConstraintsV[X]
Column Name
Description
VTConstraintType
Returns one of the following values:
• C = Current
• S = Sequenced
• N = Nonsequenced
• Null = Used for all rows on a table that does not support ValidTime
If the table supports ValidTime, a value of NULL indicates that the row is for an index and
not a temporal unique/primary constraint.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
Indices[X]
IndexStats
IndicesV[X]
IndexStatsV
411
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
VTEventType
Records the ValidTime qualifier on the subject table.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
Triggers[X]
TriggersV[X]
Column Name
Description
VTFKType
Returns the ValidTime dimension for the foreign key.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
RI_Parent_Tables[X]
RI_Child_Tables[X]
RI_Parent_TablesV[X]
RI_Child_TablesV[X]
Column Name
Description
VTPKType
Returns the ValidTime dimension for the parent key.
Data Type
412
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
RI_Parent_Tables[X]
RI_Child_Tables[X]
RI_Parent_TablesV[X]
RI_Child_TablesV[X]
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
VTQualifier
Records the temporal qualifier for validtime dimension.
These are the values:
•
•
•
•
NULL = No ValidTime Dimension
C = Current ValidTime
S = Sequenced ValidTime
N = Non-Sequenced ValidTime
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
CHAR(1)
LATIN
UPPERCASE
NOT CASESPECIFIC
Format
X(1)
X(1)
Associated View
Tables[X]
TablesV[X]
Column Name
Description
WarningOnly
Returns warning code T for true if the error was reported while running the Teradata
dynamic workload management software in the warning mode, or it is not logged at all.
A null '?' is found in the field if WarningOnly is not true.
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
CHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
QryLog
QryLogExceptions
QryLogV
QryLogExceptionsV
413
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
WDDelayTime
Returns the number of seconds the query was delayed in a WD delay.
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWM
QryLogTDWMV
Column Name
Description
WDID
Returns the WD under which the query was classified.
Data Type
414
Compatibility View
Unicode View
INTEGER
NOT NULL
INTEGER
NOT NULL
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWMSum
QryLogTDWMSumV
Data Type
Compatibility View
Unicode View
INTEGER
INTEGER
Format
--,---,---,--9
--,---,---,--9
Associated View
QryLogTDWM
QryLogEvents
QryLogExceptions
QryLogTDWMV
QryLogEventsV
QryLogExceptionsV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
WDOverride
Indicates that the WD was overridden by the user.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
CHAR(1)
LATIN
Format
X(1)
X(1)
Associated View
QryLogTDWM
QryLogTDWMV
Column Name
Description
WhenGranted
Returns the date a role was granted.
Data Type
Compatibility View
Unicode View
TIMESTAMP(0)
TIMESTAMP(0)
Format
YYYY-MM-DDBHH:MI:SS
YYYY-MM-DDBHH:MI:SS
Associated View
RoleMembers[X]
RoleMembersV[X]
Column Name
Description
WithAdmin
Returns 'Y' if Admin Option comes with the role grant; otherwise, the value is ‘N.’
Data Type
Data Dictionary
Compatibility View
Unicode View
CHAR(1)
LATIN
UPPERCASE
NOT NULL
CHAR(1)
LATIN
UPPERCASE
NOT NULL
Format
X(1)
X(1)
Associated View
RoleMembers[X]
RoleMembersV[X]
415
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
WithoutRole
Returns the following possible values:
• Y = the rule was created with the Without Role clause to indicate that the privileges of the
permanent proxy user should be used.
• N = the rule was created with Roles specified.
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT NULL
CHAR(1)
LATIN
NOT NULL
Format
X(1)
X(1)
Associated View
ConnectRules
ConnectRulesV
Column Name
Description
XMLPlanFlag
(Title: XMLPlan)
Indicates whether XML query plan logging is on or off. These are the values:
• T = On
• F = Off
Data Type
Compatibility View
Unicode View
CHAR(1)
LATIN
NOT CASESPECIFIC
NOT NULL
CHAR(1)
LATIN
NOT CASESPECIFIC
NOT NULL
Format
X(1)
X(1)
Associated View
DBQLRules
DBQLRulesV
Column Name
Description
XMLRowNo
Indicates the row number for multiple rows used to capture the XML query plan.
If the XML text is greater than 31000 characters, the system generates multiple rows.
416
Data Type
INTEGER NOT NULL
Format
--,---,---,--9
Associated View
QryLogXMLV
Data Dictionary
Chapter 2: Data Dictionary Views
System Views Columns Reference
Column Name
Description
XMLTextInfo
Returns the query plan represented as an XML document.
Data Dictionary
Data Type
VARCHAR(31000) UNICODE
NOT CASESPECIFIC
NOT NULL
Format
X(31000)
Associated View
QryLogXMLV
417
Chapter 2: Data Dictionary Views
System Views Columns Reference
418
Data Dictionary
CHAPTER 3
Data Dictionary Views: Usage and
Examples
This chapter explains the purpose of each of the DBC Data Dictionary system views. The
views are presented in alphabetical case-insensitive order by view name and include the
following information:
•
View form
•
a view that has an X version is shown in the form “ViewName[X]”
•
Unicode version is shown in the form “ViewName [V]”
•
User Type
•
Columns that the view selects from the system table
•
Corresponding system tables
•
Usage notes about special information or uses of the view.
•
Examples, where available, of the results returned by a SELECT request on the view. If
applicable to the type or quantity of information being selected, the example shows the X
version of the view in the statement reference
•
Other Teradata Database documents that can provide additional information about this
view
The output of some views extends beyond an 80-character display. To see all the columns, the
user has to do either of the following:
•
Cast the name columns to shorter lengths
•
Use the SET FOLDLINE and SET SIDETITLES options in BTEQ
Note: The results shown in the examples are for illustration purposes only. Utilities and tools,
such as BTEQ, or other third-party products, can be used to enter queries and format the
results differently.
Note: If a statement returns a “security violation” error, a reference to the alternate version of
the view name may yield results. If neither version is available, use the HELP statement to
inquire about individual objects. If this is not adequate, the user should consult the Teradata
Database administrator.
Data Dictionary
419
Chapter 3: Data Dictionary Views: Usage and Examples
AccessLog[V]
AccessLog[V]
The AccessLog view returns logging entries generated by the application of access logging
rules (see “AccLogRules[V]” on page 421).
View Name
User Type
Columns Selected
DBC.AccessLog[V]
Teradata Database
Security
Administrator
LogDate
LogTime
LogonDate
LogonTime
LogicalHostId
IFPNo
SessionNo
UserName
AccountName (expanded)
OwnerName
AccessType
Frequency
EventCount
AccLogResult
DatabaseName
TVMName
ColumnName
StatementType
StatementText
QueryBand
ProxyUser
Corresponding System Table
The corresponding system table for DBC.AccessLog[V] is DBC.AccLogTbl.
Usage Notes
Each row AccessLog displays indicates the results of a privilege check. Whether a privilege
check is logged depends on the presence and the criteria of an access logging rule (see
“AccLogRules[V]” on page 421).
420
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
AccLogRules[V]
Example
The following SELECT retrieves the name of the submitting user from the AccessLog, the type
of request, and the request text of each request that caused a privilege check to be logged on a
specific date. The response shows that one request caused a privilege check to be logged on
that date. (The statement text column has been truncated in the results.)
==> SELECT LogDate, UserName, AccessType, StatementText FROM
DBC.AccessLog WHERE LogDate = 890510;
LogDate
-------89/05/10
UserName
-------Jones
AccessType
---------CT
StatementText
-----------------------------CREATE TABLE Jones.EmpDup (Em
AccLogRules[V]
The AccLogRules view provides information about logging rules that are currently in effect on
the system. The underlying table is populated as a result of successfully processed BEGIN
LOGGING statements.
Data Dictionary
View Name
User Type
Columns Selected
DBC.AccLogRules[V]
Teradata Database
Security Administrator
UserName
DatabaseName
TVMName
AcrAlterFunction
AcrCheckpoint
AcrCreateDatabase
AcrCreateFunction
AcrCreateMacro
AcrCreateTable
AcrCreateUser
AcrCreateView
AcrCreateProcedure
AcrCreExtProcedure
AcrDelete
AcrDropDatabase
AcrDropFunction
AcrDropMacro
AcrDropTable
AcrDropUser
AcrDropView
AcrDropProcedure
AcrDump
AcrExecute
AcrExecuteFunction
AcrExecuteProcedure
AcrGrant
AcrIndex
AcrInsert
421
Chapter 3: Data Dictionary Views: Usage and Examples
AccLogRules[V]
View Name
User Type
Columns Selected
DBC.AccLogRules[V]
(Continued)
Teradata Database
Security Administrator
AcrReference
AcrRestore
AcrSelect
AcrUpdate
AcrCreateTrigger
AcrDropTrigger
AcrCreateRole
AcrDropRole
AcrCreateProfile
AcrDropProfile
AcrAlterProcedure
AcrAlterExtProcedure
AcrRepControl
AcrUDTUsage
AcrUDTType
AcrUDTMethod
AcrCreAuthorization
AcrDropAuthorization
AcrStatistics
AcrCreOwnerProcedure
AcrConnectThrough
CreatorName
CreateTimeStamp
AcrCreateGLOP
AcrDropGLOP
AcrGLOPMember
AcrShow
Corresponding System Tables
The corresponding system tables for DBC.AccLogRules[V] are:
•
DBC.AccLogRuleTbl
•
DBC.DBase
•
DBC.TVM
Usage Notes
The underlying table of this view is populated only if the security macro is installed and the
Teradata Database or security administrator has executed one or more BEGIN LOGGING
statements.
Each row in the underlying table defines a rule controlling what privilege check is to be logged
when a specific user attempts to access a specific object.
When a request is submitted that involves any of the rule criteria, the details of the
involvement are recorded in the access log (see “AccLogRules[V]” on page 421).
422
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
AccLogRules[V]
In AccLogRules, each Access Rule (Acr...) column is named for a particular privilege, which is
also associated with an access action and a SQL statement. In each column, each character
position represents the frequency with which checks performed on that privilege are to be
logged, as follows:
1
2
3
Data Dictionary
Position 1 (every privilege check) indicates how often to log checks on this privilege when
performed against any requests (submitted by a specified user) that attempt to access the
specified object. Possible values that could appear in each position are as follows:
a
B Both FIRST and LAST occurrences are to be logged.
b
E Each occurrence is to be logged.
c
F FIRST occurrence is to be logged.
d
L LAST occurrence is to be logged.
e
blank No logging.
Position 2 indicates how often to log checks on this privilege when performed against
requests (submitted by a specified user) that are not allowed to access the specified object
(that is, check results are Denials).
a
B Both FIRST and LAST occurrences are to be logged.
b
E Each occurrence is to be logged.
c
F FIRST occurrence is to be logged.
d
L LAST occurrence is to be logged.
e
blank No logging.
Position 3 (save text of request) indicates whether to record the text of the requests that
cause a check on this privilege.
a
- Save text only for Denial entries.
b
+ Save text for all entries.
c
= Save text for all entries (specified in multiple BEGIN LOGGING statements).
d
blank No WITH TEXT option specified.
423
Chapter 3: Data Dictionary Views: Usage and Examples
AccountInfo[V][X]
Example
If the following statements are submitted, a SELECT statement retrieving the AccLogRules
entries for User1 returns the rows as shown:
BEGIN LOGGING ON EACH CREATE TABLE BY Jones ON USER Jones ;
BEGIN LOGGING DENIALS WITH TEXT ON FIRST CREATE DATABASE
BY Jones ON DATABASE Personnel ;
==> SELECT * FROM DBC.AccLogRules WHERE UserName = ’Jones’ ;
UserName
DatabaseName
TVMName
Jones
Jones
All
Jones
Personnel
All
CPT
CDB
CMC
CTB
CUS
E
...
F-
...
•
In the first row, the UserName “Jones”, the DatabaseName “Jones”, and the “E” in the first
position of the CTB column indicate that a log entry is to be made each time a check for
the CREATE TABLE privilege is performed in response to a request by Jones to create a
table in his own space.
•
In the second row, the UserName “Jones”, the DatabaseName “Personnel”, and the “F” in
the second position of the CDB column indicate that a log entry is to be made the first
time a check for a CREATE DATABASE privilege that results in a denial is performed in
response to a request by Jones to create a database in the Personnel database. The “-” in the
third position of the CDB column indicates that the text of the denied statement is to be
saved in the log entry.
AccountInfo[V][X]
The AccountInfo view provides information about valid accounts.
View Name
User Type
Columns Selected
DBC.AccountInfo[V][X]
Supervisory
UserName
AccountName
UserOrProfile
Teradata Database
Administrator
[X]End User
Corresponding System Tables
The corresponding system tables for DBC.AccountInfo[V] are:
424
•
DBC.Accounts
•
DBC.DBase
•
DBC.Profiles
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
AllRights[V][X]
The corresponding system tables for DBC.AccountInfo[V]X are:
•
DBC.Accounts
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.Profiles
This view also references the DBC.userdb view.
Example
==> SELECT * FROM DBC.AccountInfo;
Name
------------DBC
CONSOLE
SystemFe
Crashdumps
TDPUSER
SysAdmin
Sys_Calendar
V2R5IN
AccountName
------------DBC
DBC
SystemFe
Crashdumps
$H
SysAdmin
Sys_Calendar
DBC
UserOrProfile
-------------User
User
User
User
User
User
User
User
Related Topics
See Database Design for more information on controlling access, space, and ownership.
See SessionInfo[X] for the current account name (unexpanded) in effect for a session.
See Databases[X] or Users system views to determine the default account name for a user or
database.
See Profile[X] for default account name if set by profile for a user or database.
AllRights[V][X]
The AllRights view provides information about all users who have been explicitly or
automatically granted privileges, and the objects on which the privileges were granted
including: databases, users, tables, views, stored procedures, macros, user-defined types, userdefined methods, and user-defined functions.
The AllRights view also returns PUBLIC rights.
Data Dictionary
View Name
User Type
Columns Selected
DBC.AllRights[V][X]
Teradata Database
Administrator
UserName
DatabaseName
TableName
ColumnName
AccessRight
425
Chapter 3: Data Dictionary Views: Usage and Examples
AllRights[V][X]
View Name
User Type
Columns Selected
DBC.AllRights[V][X]
(Continued)
Teradata Database
Administrator
GrantorName
AllnessFlag
CreatorName
CreateTimeStamp
Corresponding System Tables
The corresponding system tables for DBC.AllRights[V] are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.TVM
•
DBC.TVFields
The corresponding system tables for DBC.AllRights[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.TVM
•
DBC.TVFields
•
DBC.Roles
•
DBC.RoleGrants
Usage Notes
The AllRights view does not return information about implicit privileges for a user, only
explicit privileges granted on the object. The explicit privileges include the following:
426
•
AE = ALTER EXTERNAL PROCEDURE
•
AF = ALTER FUNCTION
•
AP = ALTER PROCEDURE
•
AS = ABORT SESSION
•
CA = CREATE AUTHORIZATION
•
CD = CREATE DATABASE
•
CE = CREATE EXTERNAL PROCEDURE
•
CF = CREATE FUNCTION
•
CG = CREATE TRIGGER
•
CM = CREATE MACRO
•
CO = CREATE PROFILE
•
CP = CHECKPOINT
•
CR = CREATE ROLE
•
CT = CREATE TABLE
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
AllRights[V][X]
Data Dictionary
•
CU = CREATE USER
•
CV = CREATE VIEW
•
D
•
DA = DROP AUTHORIZATION
•
DD = DROP DATABASE
•
DF = DROP FUNCTION
•
DG = DROP TRIGGER
•
DM = DROP MACRO
•
DO = DROP PROFILE
•
DP = DUMP
•
DR = DROP ROLE
•
DT = DROP TABLE
•
DU = DROP USER
•
DV = DROP VIEW
•
E
•
EF = EXECUTE FUNCTION
•
GC = CREATE GLOP
•
GD = DROP GLOP
•
GM = GLOP MEMBER
•
I
•
IX = INDEX
•
MR = MONITOR RESOURCE
•
MS = MONITOR SESSION
•
NT = NONTEMPORAL
•
OD = OVERRIDE DELETE POLICY (Reserved for future use)
•
OI = OVERRIDE INSERT POLICY (Reserved for future use)
•
OP = CREATE OWNER PROCEDURE
•
OS = OVERRIDE SELECT POLICY (Reserved for future use)
•
OU = OVERRIDE UPDATE POLICY (Reserved for future use)
•
PC = CREATE PROCEDURE
•
PD = DROP PROCEDURE
•
PE = EXECUTE PROCEDURE
•
R
•
RF = REFERENCE
•
RO = REPLCONTROL
•
RS = RESTORE
•
SA = SECURITY CONSTRAINT ASSIGNMENT
•
SD = SECURITY CONSTRAINT DEFINITION
= DELETE
= EXECUTE
= INSERT
= RETRIEVE/SELECT
427
Chapter 3: Data Dictionary Views: Usage and Examples
AllRoleRights[V]
•
SH = SHOW
•
SR = SET RESOURCE RATE
•
SS = SET SESSION RATE
•
ST = STATISTICS
•
TH = CTCONTROL
•
U
•
UM = UDT Method
•
UT = UDT Type
•
UU = UDT Usage
= UPDATE
Example
The following SELECT statement displays the privileges user Jones has on tables.
==> SELECT Tablename, AccessRight, GrantorName
FROM DBC.AllRights WHERE UserName = ’Jones’;
TableName
---------project
project
project
project
project
project
project
employee
employee
AccessRight
----------RS
DP
DT
D
I
U
R
I
U
GrantorName
------------SYSTEMAD
SYSTEMAD
SYSTEMAD
SYSTEMAD
SYSTEMAD
SYSTEMAD
SYSTEMAD
SYSTEMAD
SYSTEMAD
AllRoleRights[V]
The AllRoleRights view lists all privileges granted to each role.
View Name
User Type
Columns Selected
DBC.AllRoleRights[V]
Teradata Database Security
Administrator
RoleName
DatabaseName
TableName
ColumnName
AccessRight
Teradata Database
Administrator
Supervisory
DBC.AllRoleRights[V]
(Continued)
Teradata Database Security
Administrator
GrantorName
CreateTimeStamp
Teradata Database
Administrator
Supervisory
428
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
AllRoleRights[V]
Corresponding System Tables
The corresponding system tables for DBC.AllRoleRights[V] are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.Roles
•
DBC.TVM
•
DBC.TVFields
Usage Notes
The AllRoleRights view is similar to the AllRights view except that it does not have the
following columns:
•
AllnessFlag
•
CreatorName columns
Example
The following SELECT statement returns all the privileges granted to each role.
==> SELECT CAST(RoleName as CHAR(16)) as RoleName,
CAST(DatabaseName as CHAR(15)) as Databases,
CAST(TableName as CHAR(15)) as TVMs
--,CAST(ColumnName as CHAR(10)) as Columns,
CAST(AccessRight as CHAR(5)) as AccRights
CAST(GrantorName as CHAR(15)) as Grantor
FROM DBC.AllRoleRights
WHERE RoleName like 'roles017%'
ORDER BY 1,2,3,5;
*** Query completed. 6 rows found. 5 columns returned.
*** Total elapsed time was 1 second.
RoleName
---------------roles017_dbc_r1b
roles017_r1a
roles017_r1c
roles017_r1f
roles017_r2d
roles017_r2e
Data Dictionary
Databases
--------------roles017_3_db
roles017_3_db
roles017_3_db
roles017_3_db
roles017_3_db
roles017_3_db
TVMs
--------------roles017_3_m3
roles017_3_t1
roles017_3_t4
roles017_3_v2
roles017_3_v2
roles017_3_t5
AccRights
--------E
R
R
R
R
R
Grantor
--------------roles017_3
roles017_3
monthly
roles017_3
roles017_3
monthly
429
Chapter 3: Data Dictionary Views: Usage and Examples
AllSpace[V][X]
AllSpace[V][X]
The AllSpace view provides AMP-by-AMP information about disk space usage (including
spool) for each user database, data table, or journal table.
View Name
User Type
Columns Selected
DBC.AllSpace[V][X]
Teradata Database
Administrator
Vproc
DatabaseName
AccountName (unexpanded)
TableName
MaxPerm
MaxSpool
MaxTemp
CurrentPerm
CurrentSpool
CurrentTemp
PeakPerm
PeakSpool
PeakTemp
MaxProfileSpool
MaxProfileTemp
[X]End User
Supervisory
Corresponding System Tables
The corresponding system tables for DBC.AllSpace[V] are:
•
DBC.DataBaseSpace
•
DBC.DBase
The corresponding system tables for DBC.AllSpace[V]X are:
•
DBC.AccessRights
•
DBC.DataBaseSpace
•
DBC.DBase
•
DBC.Owners
•
DBC.Roles
•
DBC.RoleGrants
•
DBC.TVM
Usage Notes
When a database, user, or table is created, allocated disk space is divided evenly among all
AMPs. The AllSpace view returns one row of usage information for each AMP in the Teradata
Database configuration (or for all AMPs if the SUM aggregate is used).
430
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
AllTempTables[V][X]
When a database is created, a space row is added to each AMP, with the processor field in each
row initialized to 0. The first time the space row is updated (such as when a table is created in
the database, or when the system is restarted), the processor field in each row is updated to
indicate the actual processor number.
When a query applies a SUM aggregate to either of those columns without a WHERE clause,
or with a WHERE clause that references only one TableName or DatabaseName, the returned
values are double the desired result.
For example, the following query, which returns the correct amount of space allocated to
Peterson, also returns twice the amount of space currently being used by Peterson (see
“DiskSpace[V][X]” on page 460 and “TableSize[V][X]” on page 528).
SELECT SUM(MaxPerm), SUM(CurrentPerm)
FROM DBC.AllSpace
WHERE DatabaseName = ’Peterson’;
Example
The following SELECT statement displays how the space currently used by the data table
named Department is distributed on each AMP.
==> SELECT DatabaseName,TableName,AMP,CurrentPerm FROM DBC.AllSpace
WHERE TableName=’Department’ ORDER BY 1,2,3 ;
DatabaseName
-----------Test
Test
Test
Test
PERSONNEL
PERSONNEL
PERSONNEL
PERSONNEL
User1
User1
User1
User1
TableName
---------DEPARTMENT
DEPARTMENT
DEPARTMENT
DEPARTMENT
department
department
department
department
department
department
department
department
AMP
---1-0
1-1
1-2
1-3
1-0
1-1
1-2
1-3
1-0
1-1
1-2
1-3
CurrentPerm
-----------1,024
512
1,024
512
2,048
1,536
1,536
1,536
2,048
1,536
1,536
1,536
AllTempTables[V][X]
The AllTempTables view provides information about all global temporary tables materialized
in the system.
A global temporary table is created by explicitly stating the keywords GLOBAL TEMPORARY
in the CREATE TABLE statement. The temporary table defined during the CREATE TABLE
statement is referred to as the base temporary table.
When referenced in an SQL session, a local temporary table is materialized with the exact
same definition as the base table. Once the temporary table is materialized, subsequent DML
statements referring to that table are mapped to the materialized instance.
Data Dictionary
431
Chapter 3: Data Dictionary Views: Usage and Examples
All_RI_Children[V][X]
A materialized temporary table is automatically dropped at the end of a session.
View Name
User Type
Columns Selected
DBC.AllTempTables[V][X]
Teradata Database
Administrator
HostNo
SessionNo
UserName
B_DatabaseName
B_TableName
E_TableId
[X]End User
Corresponding System Tables
The corresponding system tables for DBC.AllTempTables[V][X] are:
•
DBC.DBase
•
DBC.SessionTbl
•
DBC.TempTables
•
DBC.TVM
Usage Notes
A materialized temporary table is different from a permanent table in the following ways:
•
It is always empty at the start of a session.
•
The contents of the materialized table cannot be shared by other sessions.
•
It can optionally be emptied at the end of each transaction.
•
It is automatically dropped at the end of each session.
Example
After a global temporary table definition is created, you can use the INSERT statement to
create a local instance of the global temporary table for use during the session.
The following statement shows all temporary tables materialized by the login user in the
system.
==> SELECT * FROM DBC.AllTempTablesX;
HostNo
SessionNo
DatabaseName
TableName
TableId
52
3,409
TEST
GTEMP1
00800A000000
All_RI_Children[V][X]
The All_RI_Children view provides information about all tables in child-parent order. It is
similar to the RI_Child_Tables view but returns the names of databases, tables, and columns
instead of IDs.
432
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
All_RI_Children[V][X]
View Name
User Type
Columns Selected
DBC.All_RI_Children[V][X]
All users
IndexID
IndexName
ChildDB
ChildTable
ChildKeyColumn
ParentDB
ParentTable
ParentKeyColumn
InconsistencyFlag
CreatorName
CreateTimeStamp
Corresponding System Tables
The corresponding system tables for DBC.All_RI_Children[V] are:
•
DBC.DBase
•
DBC.ReferencingTbls
•
DBC.TVFields
•
DBC.TVM
The corresponding system tables for DBC.All_RI_Children[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.ReferencingTbls
•
DBC.Roles
•
DBC.RoleGrants
•
DBC.TVFields
•
DBC.TVM
Usage Notes
The All_RI_Children view is designed for use in a SELECT statement with a WHERE clause to
narrow the selection criteria.
The All_RI_Children view is similar to the RI_Child_Tables view but returns the database,
table, and column names instead of the IDs for access control purposes. The administrator
can control who has access to internal ID numbers by limiting the access to the
RI_Child_Tables view while allowing more (or all) users to access the names via the
All_RI_Children view.
Data Dictionary
433
Chapter 3: Data Dictionary Views: Usage and Examples
All_RI_Parents[V][X]
All_RI_Parents[V][X]
The All_RI_Parents view provides information about all tables in parent-child order. It is
similar to the RI_Parent_Tables view but returns the names of databases, tables, and columns
instead of IDs.
View Name
User Type
Columns Selected
DBC.All_RI_Parents[V][X]
All users
IndexID
IndexName
ParentDB
ParentTable
ParentKeyColumn
ChildDB
ChildTable
ChildKeyColumn
InconsistencyFlag
CreatorName
CreateTimeStamp
Corresponding System Tables
The corresponding system tables for DBC.All_RI_Parents[V] are:
•
DBC.DBase
•
DBC.ReferencedTbls
•
DBC.TVFields
•
DBC.TVM
The corresponding system tables for DBC.All_RI_Parents[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.ReferencedTbls
•
DBC.Roles
•
DBC.RoleGrants
•
DBC.TVFields
•
DBC.TVM
Usage Notes
The All_RI_Parents view is designed for use in a SELECT statement with a WHERE clause to
narrow the selection criteria. This view is similar to the RI_Parent_Tables view, but returns the
database, table, and column names instead of the IDs for access control purposes.
434
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
AMPUsage[V][X]
The administrator can control who has access to internal ID numbers by limiting the access to
the RI_Parent_Tables view while allowing more (or all) users to access the names via the
All_RI_Parents view.
AMPUsage[V][X]
The AMPUsage view provides information about the usage of each AMP for each user and
account.
AMPUsage monitors logical I/Os explicitly requested by the AMP database software or file
system that is running in the context of an AMP worker task for the purpose of executing a
step in the user query. I/Os done by UNIX for swapping are not included in AMPUsage, nor
are the I/Os caused by parsing the user query.
A logical I/O is charged even if the requested segment is cached and no physical I/O is done.
View Name
User Type
Columns Selected
DBC.AMPUsage[V][X]
Teradata Database
Administrator
AccountName
UserName
CPUTime
DiskIO
CPUTimeNorm
Vproc
VprocType
Model
Corresponding System Table
The corresponding system table for DBC.AMPUsage[V][X] is DBC.Acctg.
Note that AccountName is the expanded account name used when the usage information was
collected.
Example
The following SELECT statement displays, for a given account, total CPU time and total disk
accesses for all AMPs.
==> SELECT AccountName,SUM(CPUTime),SUM(Diskio)
FROM DBC.AMPusage WHERE AccountName=’7654’
GROUP BY AccountName;
AccountName
----------7654
Sum(CPUTime)
-----------204,352.88
Sum(DiskIO)
------------5,226,742
Related Topics
See Database Design for more information on controlling access, space, and ownership.
Data Dictionary
435
Chapter 3: Data Dictionary Views: Usage and Examples
ArchiveLoggingObjsV[X]
ArchiveLoggingObjsV[X]
The ArchiveLoggingObjsV view provides information about the tables that have online
archive active logs and their online archive logging levels.
View Name
User Type
Columns Selected
ArchiveLoggingObjsV[X]
Teradata Database
Administrator
DatabaseName
TVMName
LogLevel
CreatorName
CreateTimeStamp
Corresponding System Table
The corresponding system table for ArchiveLoggingObjsV[X] is
DBC.ArchiveLoggingObjsTbl.
Example
The following SELECT statement displays information about the tables that have online
archive active logs and their online archive logging levels. In this example, the logging levels
are either T or D (O is also a possible value).
•
T = Online Archive Logging was activated on the table level.
•
D = Online Archive Logging was activated on the database level.
•
O = Non-table objects.
==> SELECT databasename, tvmname, loglevel FROM dbc.archiveloggingobjsv;
DatabaseName
--------------oarc_otop005db1
oarc_oth007db1
oarc_oth007db1
oarc_otop010db1
oarc_oth007db1
oarc_otop010db1
oarc_otop016db1
oarc_oth008db1
oarc_otop010db1
oarc_otop001db1
oarc_otop018db1
oarc_comb002db1
TVMName
------Tab_nfb
Tab_nfb
tab_fb
Tab_nfb
tab_ppi
tab_nusi
Tab_nfb
Tab_queue
tab_bigcol
Tab_nfb
Tab_nfb
tab_fb
LogLevel
-------T
D
D
D
D
D
T
T
D
T
T
T
Association[V][X]
The Association view allows the user to retrieve information about an object that was
imported from another Teradata Database.
436
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
Association[V][X]
View Name
User Type
Columns Selected
DBC.Association[V][X]
Operations Control
DatabaseName
TableName
EventNum
Original_DatabaseName
Original_TableName
Original_TableKind
Original_Version
Original_ProtectionType
Original_JournalFlag
Original_CreatorName
Original_CommentString
Corresponding System Tables
The corresponding system tables for DBC.Association[V] are:
•
DBC.DBCAssociation
•
DBC.DBase
•
DBC.TVM
The corresponding system tables for DBC.Association[V]X are:
•
DBC.AccessRights
•
DBC.DBCAssociation
•
DBC.DBase
•
DBC.Owner
•
DBC.RoleGrants
•
DBC.Roles
•
DBC.TVM
Usage Notes
The Association view contains information about entities that were restored using the Archive
and Recovery COPY utility. If a copied object is subsequently dropped, then the information
is deleted and is no longer available.
Example
The following SELECT statement selects information about tables copied into the Personnel
database.
==> SELECT Original_DatabaseName,Original_TableName,TableName
FROM DBC.Association WHERE DatabaseName = ’Personnel’;
Original_DatabaseName
--------------------OldPersonnel
Personnel2
Data Dictionary
Original_TableName
-----------------Empl_Addr
Empl_Dept
TableName
----------Emp_Address
Empl_Dept
437
Chapter 3: Data Dictionary Views: Usage and Examples
Authorizations[V][X]
Related Topics
The following references provide additional usage information on recovery control.
Book
Chapter
Section
Database Administration
Archiving, Restoring, and
Recovering Data
Recovery Control Views
Teradata Archive/Recovery
Utility Reference
Archive/Recovery Control
Language
All
Authorizations[V][X]
The Authorizations view provides information about an authorization.
View Name
User Type
Columns Selected
DBC.Authorizations[V][X]
Teradata Database
Administrator
DatabaseName
AuthorizationName
AuthorizationId
TableKind
Version
AuthorizationType
AuthorizationSubType
OSDomainName
OSUserName
Corresponding System Tables
The corresponding system tables for DBC.Authorizations[V] are:
•
DBC.DBase
•
DBC.TVM
The corresponding system tables for DBC.Authorizations[V]X are:
•
DBC.DBase
•
DBC.TVM
•
DBC.AccessRights
•
DBC.Owner
Usage Notes
None.
438
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
CharSets[V]
Example
==> SELECT * FROM Authorizations WHERE databasename = 'dba';
*** Query completed. 2 rows found. 9 columns returned.
*** Total elapsed time was 1 second.
DatabaseName
AuthorizationName
AuthorizationId
TableKind
Version
AuthorizationType
AuthorizationSubType
OSDomainName
OSUserName
DatabaseName
AuthorizationName
AuthorizationId
TableKind
Version
AuthorizationType
AuthorizationSubType
OSDomainName
OSUserName
dba
INVOKER_DEFAULT
00001F0A0000
X
1
I
D
gdUsrGrp
dba
myinvoker
00001E0A0000
X
1
I
D
gdUsrGrp
CharSets[V]
The CharSets view returns the names assigned to user-defined character sets. If the view does
not exist, or if no rows are found, then no special character sets are currently available.
View Name
User Type
Columns Selected
DBC.CharSets[V]
End User
CharSetName
Corresponding System Table
The corresponding system table for DBC.CharSets[V] is DBC.Translation.
Usage Notes
The Teradata Database can support many user-defined character sets (see
“CharTranslations[V]” on page 440). You can install a maximum of 12 character sets at any
given time. The CharSets view returns the names of character sets that are currently installed
and thus can be specified at the session level. If the view does not exist or no rows are found,
then no user-defined character sets are available.
Each name shown in CharSets can be used as the identifier in the BTEQ [.]SET SESSION
CHARSET <’name’> command or the CLIv2 call CHARSET <name>. However, the specified
character set should be compatible with the internal code of the logon client system.
Data Dictionary
439
Chapter 3: Data Dictionary Views: Usage and Examples
CharTranslations[V]
If a CharSetName is ambiguous as to its compatibility with the logon client system of the
viewer session, consult the Teradata Database administrator.
Example
The following example shows that two user-defined character sets are available for the
requesting user.
==> SELECT * FROM DBC.CharSets ;
CharSetName
French_EBCDIC
Swedish_EBCDIC
CharTranslations[V]
The CharTranslations view shows hexadecimal codes inserted by the Teradata Database
system administrator to form translation tables that enable the Teradata Database to store and
manipulate non-English character sets. Such translation tables usually define character sets for
languages that use diacritical characters.
If the view is empty or no rows are found, then no user-defined character sets are available.
View Name
User Type
Columns Selected
DBC.CharTranslations[V]
End User
CharSetName
CharSetId
InstallFlag
E2I
E2IUp
I2E
I2EUp
Corresponding System Table
The corresponding system table for DBC.CharTranslations[V] is DBC.Translation.
Usage Notes
The underlying table of this view is populated by the Teradata Database system administrator
or other responsible user. Each row in the table comprises a translation table for one character
set. The amount of character sets that can be defined is limited only by the disk space available
for the table. However, a maximum of 12 sets can be installed as currently available at any one
time.
440
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
Children[V][X]
The Teradata Database must be reset to install the rows containing a Y in the InstallFlag field.
If the value of InstallFlag is Y in 12 rows or less, each Y row is loaded. If InstallFlag is Y in more
than 12 rows, then the CharSetName values are sorted in ascending ASCII sequence, and rows
are loaded in alphabetical order until 12 sets are installed or the names are exhausted.
If client system connections are to use the defined character sets, the Teradata Database system
administrator specifies which character set is assigned to which client system (see
“HostsInfo[V]” on page 472). Otherwise, the standard default is used. Also, the user may
specify a defined character set after a session is started (see “CharSets[V]” on page 439).
When specifying a character set for a session, the choice should be compatible with the
internal code of the logon client system; that is, an EBCDIC-compatible character set for
sessions initiated from an IBM mainframe, ASCII-compatible sets for all others. It is
suggested, therefore, that a convention be used for naming character sets which differentiates
between EBCDIC and ASCII compatibility (see the example below).
Example
The example below shows that the hexadecimal translation tables for 6 character sets have
been defined, and that two of these are flagged for loading.
==> SELECT * FROM DBC.CharTranslations;
CharSetName
---------------German_EBCDIC
Italian_EBCDIC
Spanish_EBCDIC
French_EBCDIC
Norwegian_EBCDIC
Swedish_EBCDIC
Set Id
-----100
105
103
104
101
102
Flag
----N
N
N
Y
N
Y
E2I
-------------------------00010203A809A97FD1D2D3...
00010203A809A97F2395EE...
00010203A809A97FD1D2D3...
00010203A809A97FD1D2D3...
00010203A809A97FD1D2D3...
00010203A809A97FD1D2D3...
Children[V][X]
The Children view lists the names of databases and users and their parents in the hierarchy.
View Name
User Type
Columns Selected
DBC.Children[V][X]
Supervisory
Child
Parent
Corresponding System Tables
The corresponding system tables for DBC.Children[V] are:
•
DBC.DBase
•
DBC.Owners
The corresponding system tables for DBC.Children[V]X are:
Data Dictionary
441
Chapter 3: Data Dictionary Views: Usage and Examples
Collations[V]
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
The X view also references the userdb view.
Example
The following SELECT statement displays databases and users that are owned by the Finance
database.
==> SELECT Parent, Child FROM DBC.Children
WHERE Parent = ’Finance’;
Parent
-------Finance
Finance
Finance
Child
---------Personnel
Jones
Accounting
Collations[V]
The Collations view provides definitions for the standard Japanese, Swedish, and Norwegian
predefined collation sequences that can be used when the collation for a user or session is set
to MULTINATIONAL.
It also defines custom collation sequence definitions, if any exist. The Collations view provides
a view on all columns of the DBC.CollationTbl.
View Name
User Type
Columns Selected
DBC.Collations[V]
End User
CollName
CollInstall
CollEqvClass
CollOrderCS
CollOrderUC
Corresponding System Table
The corresponding system table for DBC.Collations[V] is DBC.CollationTbl.
Usage Notes
The DBC.Collations view initially contains five rows:
442
•
KANJI5026_STANDARD
•
KANJIKATA_STANDARD
•
KANJI5035_STANDARD
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
Collations[V]
•
NORWEGIAN_STANDARD
•
SWEDISH_STANDARD
Database administrators can run the CollInstallMulti macro to specify which row in the
DBC.Collations view to use as the collation sequence when the user or session COLLATION
option is set to MULTINATIONAL. You must reset (initialize) the Teradata Database before
the new collation sequence can take effect.
When you define a new collation with a name other than ’MULTINATIONAL,’ set the
CollInstall flag to N to avoid extra processing during startup.
Example
The following statement returns the collation information for all collation sequences defined
in the Collations view:
SELECT CollName
FROM DBC.Collations;
The result is the following list:
CollName
--------------------------KANJI5026_STANDARD
KANJIKATA_STANDARD
KANJI5035_STANDARD
NORWEGIAN_STANDARD
SWEDISH_STANDARD
Related Topics
For more information on the MULTINATIONAL collation sequence, see International
Character Set Support.
Data Dictionary
443
Chapter 3: Data Dictionary Views: Usage and Examples
Columns[V][X]
Columns[V][X]
The Columns view provides information from the DBC.TVFields table about stored
procedures, join indexes, the parameters of macros, user-defined types, user-defined methods,
user-defined functions, and the columns of any table or view.
View Name
User Type
Columns Selected
DBC.Columns[V][X]
[X]End User
DatabaseName
TableName
ColumnName
ColumnFormat
ColumnTitle
SPParameterType
ColumnType
ColumnUDTName
ColumnLength
DefaultValue
Nullable
CommentString
DecimalTotalDigits
DecimalFractionalDigits
ColumnId
UpperCaseFlag
Compressible
CompressValue
ColumnConstraint
ConstraintCount
CreatorName
CreateTimeStamp
LastAlterName
LastAlterTimeStamp
CharType
IdColType
AccessCount
LastAccessTimeStamp
CompressValueList
TimeDimension
VTCheckType
TTCheckType
Teradata Database
Administrator
Corresponding System Tables
The corresponding system tables for DBC.Columns[V] are:
•
DBC.DBase
•
DBC.TVFields
•
DBC.TVM
The corresponding system tables for DBC.Columns[V]X are:
•
444
DBC.AccessRights
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
Columns[V][X]
•
DBC.DBase
•
DBC.Owners
•
DBC.RoleGrants
•
DBC.Roles
•
DBC.TVFields
•
DBC.TVM
Usage Notes
When querying DBC.Columns for a view, information on column attributes (for example,
length and type) is null. Because column attributes correspond to the table for which they
were defined, they are not stored in the Data Dictionary and are not accessible through this
view. Information on the columns of views can be obtained with the HELP COLUMN
statement.
Example 1
This example shows a statement that selects from DBC.Columns the name, format, null
status, and data type of all columns in the Personnel.Employee table:
==> SELECT ColumnName,ColumnFormat,Nullable,ColumnType
FROM DBC.Columns WHERE DatabaseName=’Personnel’
AND TableName = ’Employee’;
ColumnName
---------EmpNo
Name
DeptNo
JobTitle
Salary
YrsExp
.
.
.
Data Dictionary
ColumnFormat
-----------9(5)
X(12)
999
X(12)
zzz,zz9.99
z9
.
.
.
Nullable
-------N
N
Y
Y
Y
Y
.
.
.
ColumnType
------------I
CV
I
CV
D
I
.
.
.
445
Chapter 3: Data Dictionary Views: Usage and Examples
ColumnStats[V]
Example 2
This example shows a statement that selects any available commentary about columns in the
Employee table:
==> SELECT ColumnName,CommentString FROM DBC.Columns
WHERE DatabaseName=’Personnel’ AND
TableName=’Employee’
ORDER BY Columnid;
ColumnName
----------EmpNo
Name
DeptNo
JobTitle
Salary
YrsExp
CommentString
--------------------------------------Employee serial number.
Employee name, last then first initial.
ColumnStats[V]
The ColumnStats view provides information on statistics collected on an individual column
(other than a system-derived column PARTITION). This includes individual non-indexed
columns as well as columns for which a single-column index has been defined. It is important
to note that when statistics are collected on a single-column index using the INDEX keyword
in the COLLECT STATISTICS syntax, the statistics are saved in DBC.TVFields, which is the
underlying base table on which the ColumnStats view is defined.
View Name
User Type
Columns Selected
DBC.ColumnStats[V]
All users
DatabaseName
TableName
ColumnName
ColumnType
ColumnLength
ColumnFormat
DecimalTotalDigits
DecimalFractionalDigits
FieldStatistics
SeqNumber
Corresponding System Tables
The corresponding system tables for DBC.ColumnStats[V] are:
446
•
DBC.DBase
•
DBC.TVFields
•
DBC.TVM
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
ColumnStats[V]
Usage Notes
This view is used by the following client tools:
•
Teradata System Emulation Tool (TSET)
•
Teradata Visual Explain
This view is also used by any client application that requires the statistical information. TSET
exports the statistical information for data tables as part of Target Level Emulation.
The information returned includes the following:
•
Field Statistics for each column, table name, and database name
•
Column data type
•
Column sequence number of the column
The columns on which no statistics have been collected return an output row whose
FieldStatistics column is NULL. Users may wish to filter such rows out of the output.
Note: This view does not include entries for system-derived column PARTITION even if the
statistics were collected as single-column statistics. You must use the MultiColumnsStats[V]
view to get these entries.
Example
This example assumes the following statistics have been collected:
COLLECT STATISTICS ON Charges INDEX (Proj_id);
COLLECT STATISTICS ON Charges COLUMN WkEnd;
The following statement determines which Charges columns have statistics.
Note: Statistics are stored and returned in binary form.
SELECT ColumnName, FieldStatistics
FROM DBC.ColumnStats
WHERE DatabaseName = 'Personnel' AND TableName = 'Charges'
AND FieldStatistics IS NOT NULL
ORDER BY SeqNumber;
*** Query completed. 2 rows found. 2 columns returned.
*** Total elapsed time was 1 second.
ColumnName
---------Proj_id
WkEnd
FieldStatistics
-----------------------------------------------------D4070A060E35063C0200000000000000000000000000
D4070A060E35072C0200000000000000000000000000
Note: The FieldStatistics information appears in an internal format. The client tools TSET or
Teradata Visual Explain can interpret this information.
Data Dictionary
447
Chapter 3: Data Dictionary Views: Usage and Examples
ConnectRules[V]
ConnectRules[V]
The ConnectRules view retrieves information about connect through rules generated as a
result of successfully processed GRANT CONNECT THROUGH statements.
View Name
User Type
Columns Selected
DBC.ConnectRules[V]
Teradata Database
security administrator
TrustUser
ProxyUser
ProxyUserType
GrantStatus
WithoutRole
ProxyRole1
ProxyRole2
ProxyRole3
ProxyRole4
ProxyRole5
ProxyRole6
ProxyRole7
ProxyRole8
ProxyRole9
ProxyRole10
ProxyRole11
ProxyRole12
ProxyRole13
ProxyRole14
ProxyRole15
CreatorName
CreateTimeStamp
TrustOnly
Corresponding System Tables
The corresponding system tables for DBC.ConnectRules[V] are:
•
DBC.Dbase
•
DBC.ConnectRulesTbl
Usage Notes
ProxyUserType returns one of the following proxy user types:
448
•
P - a Teradata permanent user
•
A - an application user
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
ConnectRules[V]
Example 1
The following select statement returns the connect through privileges for all proxy users:
SELECT TrustUser (FORMAT 'X(20)'), ProxyUser (FORMAT 'X(20)'),
ProxyUserType FROM DBC.ConnectRules order by 2;
*** Query completed. 8 rows found. 3 columns returned.
*** Total elapsed time was 1 second.
TrustUser
-------------------trustuser1
trustuser1
trustuser1
trustuser1
trustuser1
trustuser1
trustuser1
trustuser1
ProxyUser
-------------------APPPXYUSER1
APPPXYUSER2
APPPXYUSER3
APPPXYUSER4
PXYUSER1
PXYUSER2
PXYUSER3
PXYUSER4
ProxyUserType
------------A
A
A
A
P
P
P
P
Example 2
The following select statement returns the connect through privilege for a specified proxy user
including the granted roles:
SELECT * FROM DBC.ConnectRules WHERE ProxyUser='PxyUser3';
*** Query completed. One row found. 23 columns returned.
*** Total elapsed time was 1 second.
TrustUser
ProxyUser
ProxyUserType
GrantStatus
WithoutRole
ProxyRole1
ProxyRole2
ProxyRole3
ProxyRole4
ProxyRole5
ProxyRole6
ProxyRole7
ProxyRole8
ProxyRole9
ProxyRole10
ProxyRole11
ProxyRole12
ProxyRole13
ProxyRole14
ProxyRole15
CreatorName
CreateTimeStamp
TrustOnly
Data Dictionary
trustuser6
PXYUSER3
P
G
N
ROLESHORT1
PROXYROLEMEDIUM8
ROLEFORPROXYROLEFORPROXYMAXX11
?
?
?
?
?
?
?
?
?
?
?
?
secureuser1
2010-01-11 06:42:04
N
449
Chapter 3: Data Dictionary Views: Usage and Examples
CostProfiles_V
CostProfiles_V
The CostProfiles_V view provides the cost profile instances available for use by the optimizer.
View Name
User Type
Columns Selected
DBC.CostProfiles_V
All users
ProfileTypeName
ProfileName
ProfileId
ProfileCat
ProfileDesc
Corresponding System Tables
The corresponding system tables for DBC.CostProfiles_V are:
•
DBC.CostProfiles
•
DBC.CostProfileTypes
Usage Notes
None.
Example
The following example lists the cost profiles defined for the system.
SELECT ProfileName (FORMAT 'X(16)', TITLE 'Name')
, ProfileId (FORMAT '-----9', TITLE 'Id')
, ProfileCat (FORMAT 'X', Title 'Cat')
, ProfileDesc (FORMAT 'X(64)', Title 'Description')
FROM DBC.CostProfiles_v
ORDER BY 2;
Name
Id
Cat
------------- ------ --SysDefault
0
F
V2R4
1
F
V2R5
2
F
V2R5_Solaris
3
F
V2R4_Bynet
4
F
V2R5_Bynet_V1
5
F
V2R5_Bynet_V2
6
F
symbios_half
7
F
symbios_full
8
F
emc
9
F
lsi6283
10
F
lsi6288_40
11
F
lsi6288_52
12
F
lsi6840_28
13
F
lsi6840_40
14
F
lsi6840_56
15
F
lsi6285_20
16
F
450
Description
--------------------------------------------SysDefault DBS cost values only. Partial pro
V2R4 DBS cost values only. Partial profi
V2R5 DBS cost values only. Partial profil
V2R5 DBS cost values only. Specific to
Bynet cost values for V2R4. Partial profile
Bynet V1 cost values for V2R5. Partial prof
Bynet V2 cost values for V2R5. Partial pro
Disk array cost values for Half Populated
Disk array cost values for Fully Populated
Disk array cost values for EMC. Partial
Disk array cost values for LSI 6283 array.
Disk array cost values for LSI 6288 array
Disk array cost values for LSI 6288 array
Disk array cost values for LSI 6840 array
Disk array cost values for LSI 6840 array
Disk array cost values for LSI 6840 array
Disk array cost values for LSI 6285 array
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
CostProfileTypes_V
lsi6285_40
V2R4_Array
V2R5_Array
17
18
19
F
F
F
Disk array cost values for LSI 6285 array
Disk array cost values for V2R4 Default.
Disk array cost values for V2R5 Default.
CostProfileTypes_V
The CostProfileTypes_V view provides the profile type name and description for each cost
profile type.
View Name
User Type
Columns Selected
DBC.CostProfileTypes_V
All users
ProfileTypeName
ProfileTypeDesc
Corresponding System Table
The corresponding system table for DBC.CostProfileTypes_V is DBC.CostProfileTypes.
Usage Notes
None.
Example
The following example shows how to list the defined profile types. Only one type is defined.
==> SELECT ProfileTypeName (TITLE 'Type Name', FORMAT 'X(8)'),
ProfileTypeDesc (TITLE 'Description', FORMAT 'X(80)')
FROM DBC.CostProfileTypes_v;
Type Name
--------Legacy
Description
---------------------------------------------------------Traditional (V2R6 & prior releases) cost values for legacy
CostProfileValues_V
The CostProfileValues_V view provides the values for the constants in a cost profile instance.
Data Dictionary
View Name
User Type
Columns Selected
DBC.CostProfileValues_V
All users
ProfileName
ProfileId
ConstName
ConstId
ConstCat
ConstVal
ConstDesc
451
Chapter 3: Data Dictionary Views: Usage and Examples
CostProfileValues_V
Corresponding System Tables
The corresponding system tables for DBC.CostProfileValues_V are:
•
DBC.ConstantDefs
•
DBC.ConstantValues
•
DBC.CostProfiles
Usage Notes
None.
Example
The following example lists the parameter values for the new profile.
SELECT ConstName (TITLE 'Profile Name')
, ConstId (TITLE 'Id', FORMAT '--9')
, ConstVal (TITLE 'Value')
, ConstCat (TITLE 'Cat')
FROM DBC.CostProfileValues_v
WHERE ProfileName = 'V2R5_UseSpoolLimit'
ORDER BY 4 DESC, 1; <Note T="Result">
Profile Name
-----------------------------ApplySpoolLimit
OptBitInst
OptBMAndRowInst
OptCharFieldInst
OptIndexBlockSize
OptMaxBldKeySize
OptMaxRowIdsIndex
OptNumFieldInst
OptOutputRowInst
OptOvhdOfRowCompInst
OptRedistributeInst
OptRowAccessInst
OptRowIdInst
OptRowidSize
OptSpoolBlockSize
OptSynonymInst
OptTableBlockSize
SpoolLimitPercent
452
Id
--65
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
73
Value
-------------1.0
33.0
98,500.0
261.0
49,152.0
1,000.0
8,030.0
37.0
1,641.0
242.0
73,389.0
409.0
27,139.0
12.0
131,072.0
27,139.0
49,152.0
100.0
Cat
--I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
Databases[V][X]
Databases[V][X]
The Databases view provides information about both databases and users from the
DBC.DBase table.
View Name
User Type
Columns Selected
DBC.Databases[V][X]
[X]End User
DatabaseName
CreatorName
OwnerName
AccountName
ProtectionType
JournalFlag
PermSpace
SpoolSpace
TempSpace
CommentString
CreateTimeStamp
LastAlterName
LastAlterTimeStamp
DBKind
AccessCount
LastAccessTimeStamp
Teradata Database
Administrator
Corresponding System Tables
The corresponding system table for DBC.Databases[V] is DBC.Dbase
The corresponding system tables for DBC.Databases[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.RoleGrants
•
DBC.Roles
Usage Notes
The indicators in the JournalFlag column depend on the following:
•
the FALLBACK and JOURNAL settings for the database, which serve as the default for all
tables created in that database
•
any FALLBACK and JOURNAL settings defined in the CREATE TABLE and ALTER
TABLE statements
Settings defined for an individual table override the database defaults. For all the account
names associated with a database or user, use the AccountInfo[X] system view.
Note that AccountName is the unexpanded default account name for the user or database. A
database can only have one account. A user may have a default account plus other accounts.
Data Dictionary
453
Chapter 3: Data Dictionary Views: Usage and Examples
Databases2[V][X]
Example
The statement shown in the following selects information about the Personnel database.
==> SELECT AccountName,ProtectionType,PermSpace,SpoolSpace
FROM DBC.Databases WHERE DatabaseName = ’Personnel’;
AccountName
--------------Teradata_Sample
ProtectionType
-------------F
PermSpace
--------100,000
SpoolSpace
------------1,339,884,032
Databases2[V][X]
The Databases2 view provides database ID and Referential Integrity (RI) information.
View Name
User Type
Columns Selected
DBC.Databases2[V][X]
Teradata Database
Administrator
DatabaseName
DatabaseId
UnResolvedRICount
Corresponding System Tables
The corresponding system table for DBC.Databases2[V] is DBC.Dbase.
The corresponding system tables for DBC.Databases2[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.RoleGrants
•
DBC.Roles
Usage Notes
The Databases2 view is similar to the Databases view but returns the ID of the database
instead of the various other information associated with the database. See the columns of the
Databases view for comparison.
The administrator can control who has access to internal ID numbers by limiting the access to
the Databases2 view while allowing more (or all) users to access the names via the Databases
view.
454
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
Database_Default_Journals[V][X]
Database_Default_Journals[V][X]
The Database_Default_Journals view provides information on each database that is defined as
having a default journal table.
View Name
User Type
Columns Selected
DBC.Database_Default_Journals[V][X]
[X]End
DatabaseName
Journal_DB
JournalName
Teradata Database
Administrator
Corresponding System Tables
The corresponding system table for DBC.Database_Default_Journals[V] is DBC.DBase.
The corresponding system tables for DBC.Database_Default_Journals[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.RoleGrants
•
DBC.Roles
•
DBC.TVM
Usage Notes
A journal table does not need to reside in the database which it serves.
Example
The following SELECT statement selects the information on each database accessible by the
requesting user for which a default journal table is defined.
==> SELECT * FROM DBC.Database_Default_JournalsX;
DatabaseName
-----------DtBs1
DtBs2
DtBs3
Data Dictionary
Journal_DB
---------DtBs1
DtBs2
DtBs1
JournalName
-----------DtBs1Jrnl
DtBs2Jrnl
DtBs1Jrnl
455
Chapter 3: Data Dictionary Views: Usage and Examples
DBCInfo[V]
DBCInfo[V]
The DBCInfo view provides information about specific attributes of the Teradata Database,
such as the current software version and release level. It is updated during each system restart.
View Name
User Type
Columns Selected
DBC.DBCInfo[V]
All users
InfoKey
InfoData
Corresponding System Table
The corresponding system table for DBC.DBCInfo[V] is DBC.DBCInfoTbl.
Usage Notes
Three attributes are currently maintained in DBC.DBCInfo. They are:
•
VERSION—Version of the software currently running on the Teradata Database
•
RELEASE—Release level of the software currently running on the PDE
•
LANGUAGE SUPPORT MODE - Standard or Japanese support mode
Example
The following SELECT statement retrieves the version and release of the current Teradata
Database software.
==> SELECT infokey (format ‘x(30)’),
infodata (format ‘x(20)’)
FROM dbcinfo
ORDER BY infokey;
*** Query completed. 3 rows found. 2 columns returned.
*** Total elapsed time was 1 second.
InfoKey
--------------------LANGUAGE SUPPORT MODE
RELEASE
VERSION
InfoData
-------------------Japanese
13.10j.00.00
13.10j.00.00
For the language support mode, InfoData is either Standard or Japanese.
The values for Version and Release are broken down into 4 parts:
456
•
Major release
•
Minor release
•
Maintenance release
•
E-fix release
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
DBQLRules[V]
For example, 12.01.02.03 represents the following:
•
12 = major release number
•
01 = minor release number
•
02 = maintenance release number
•
03 = e-fix or patch release number
DBQLRules[V]
The DBQLRules view displays the rules in effect for users.
View Name
User Type
Columns Selected
DBC.DBQLRules[V]
Teradata Database
Administrator
UserName
AccountString
ApplName
TypeOfRule
ExplainFlag
ObjFlag
SqlFlag
StepFlag
XMLPlanFlag
SummaryFlag
ThresholdFlag
TextSizeLimit
SummaryVal1
SummaryVal2
SummaryVal3
TypeOfCriterion
Supervisory
Corresponding System Tables
The corresponding system tables for DBC.DBQLRules[V] are:
•
DBC.DBase (user name)
•
DBC.DBQLRuleTbl
Usage Notes
Only users with DBC or SystemFE privileges are able to use this view.
Data Dictionary
457
Chapter 3: Data Dictionary Views: Usage and Examples
DeleteAccessLog[V]
Example
The following SELECT statement retrieves the rules in effect for users.
==> SELECT * FROM DBC.DBQLRules;
*** Query completed. One row found. 15 columns returned.
*** Total elapsed time was 1 second.
UserName
Account
ApplicationName
TypeOfRule
Explain
Object
SQL
Step
XMLPlan
Summary
Threshold
TextSize
Summary//Low
Med
High
TypeOfCriterion
All
Logging enabled
F
F
F
F
F
F
T
1,000
3
?
?
ElapsedSec
Note: This rule was initiated as BEGIN QUERY LOGGING LIMIT THRESHOLD = 3 and
SQLText =1,000 on All;
Queries longer than 3 seconds are logged in the DBQLogTbl (QryLog view). Shorter queries
are counted and appear in the DBQLSummaryTbl (QryLogSummary view).
Summary Low is for either Threshold or Summary.
DeleteAccessLog[V]
The DeleteAccessLog view is referenced in a DELETE statement to remove from the access log
all entries that are more than 30 days old.
View Name
User Type
Columns Selected
DBC.DeleteAccessLog[V]
Teradata Database
Security
Administrator
LogDate
LogTime
Corresponding System Table
The corresponding system table for DBC.DeleteAccessLog[V] is DBC.AccLogTbl.
Usage Notes
The access log contains entries according to the application of the access logging rules (see
“AccessLog[V]” on page 420 and “AccLogRules[V]” on page 421).
458
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
DeleteOldInDoubt[V]
The DeleteAccessLog view purges entries from the log that are more than 30 days old.
The view also may be used to display information about records that are eligible for deletion
before the delete operation is performed.
Example
The following statement deletes entries logged more than 30 days before the current calendar
date.
==> DELETE FROM DBC.DeleteAccessLog ALL;
DELETE COMPLETED.
79 RECORDS DELETED.
DeleteOldInDoubt[V]
The DeleteOldInDoubt view displays those rows in the DBC.InDoubtResLog table that are
more than 30 days old. The table contains a row for each transaction that had been in-doubt,
and that was subsequently manually resolved.
View Name
User Type
Columns Selected
DBC.DeleteOldInDoubt[V]
Teradata Database
Administrator
LogicalHostId
SessionNumber
CoordTaskId
RunUnitId
LogonUserName
ResolvingUserLogonName
CommitOrRollback
UserLogonDate
UserLogonTime
CompletionDate
CompletionTime
Options
Corresponding System Table
The corresponding system table for this view is DBC.InDoubtResLog.
Usage Notes
The DeleteOldInDoubt view purges entries from the in-doubt transaction log that are more
than 30 days old. Before a delete operation is performed the view may also be used to display
information about records eligible for deletion.
Example
The following statement deletes entries logged against in-doubt transactions that were entered
more than 30 days before the current calendar date.
Data Dictionary
459
Chapter 3: Data Dictionary Views: Usage and Examples
DiskSpace[V][X]
==> DELETE FROM DBC.DeleteOldInDoubt ALL;
DELETE COMPLETED. 5 ROWS REMOVED.
DiskSpace[V][X]
The DiskSpace view provides AMP-by-AMP vproc information about disk space usage
(including spool) for any database or account.
View Name
User Type
Columns Selected
DBC.DiskSpace[V][X]
Teradata Database
Administrator
Vproc
DatabaseName
AccountName (unexpanded)
MaxPerm
MaxSpool
MaxTemp
CurrentPerm
CurrentSpool
CurrentTemp
PeakPerm
PeakSpool
PeakTemp
MaxProfileSpool
MaxProfileTemp
[X]End User
Supervisory
Corresponding System Tables
The corresponding system tables for DBC.DiskSpace[V] are:
•
DBC.DataBaseSpace
•
DBC.DBase
The corresponding system tables for DBC.DiskSpace[V]X are:
•
DBC.AccessRights
•
DBC.DataBaseSpace
•
DBC.DBase
•
DBC.Owners
•
DBC.RoleGrants
•
DBC.Roles
The X view also references the userdb view.
Usage Notes
When a database or user is created, allocated disk space is divided evenly among all AMPs. The
DiskSpace view returns one row of usage information for each AMP in the Teradata Database
(or for all AMPs if the SUM aggregate is used).
460
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
DiskSpace[V][X]
When a database is created, a space row is added on each AMP, with the processor field in each
row initialized to 0. The first time the space row is updated, such as when a table is created in
the database or the system is restarted, the processor field in each row is updated to reflect the
actual processor number.
You can use the DiskSpace view to build and maintain a table of disk space usage statistics for
each username/accountname.
To create the history table, enter the following statement:
CREATE TABLE DiskSpaceHist ( DataBaseName VARCHAR(30),
AccountName VARCHAR(30),
MaxPerm FLOAT,
MaxSpool FLOAT,
CurrentPerm FLOAT,
PeakPerm FLOAT,
PeakSpool FLOAT,
CollectDate DATE,
CollectTime FLOAT )
PRIMARY INDEX (DataBaseName, AccountName);
Periodically, you can collect usage statistics using the following procedure:
1
Select statistics from the DiskSpace view and insert them in the history table.
2
Reset DiskSpace counters to zero for the next collection period.
Note: The maximum and peak DiskSpace counters are reset to zero using the ClearPeakDisk
macro, which is provided on the release tape. Execute the ClearPeakDisk macro provided in
the Teradata Database Data Dictionary, to reset to zero the maximum and peak DiskSpace
counters.
This procedure can be carried out using the following BTEQ script.
.LOGON username, password
INSERT INTO DiskSpaceHist
SELECT DataBaseName, AccountName,
SUM(MaxPerm),
SUM(MaxSpool),
SUM(CurrentPerm),
SUM(PeakPerm),
SUM(PeakSpool),
DATE, TIME
FROM DBC.DiskSpace
GROUP BY DataBaseName, AccountName, DATE, TIME;
EXECUTE DBC.ClearPeakDisk;
.QUIT
Data Dictionary
461
Chapter 3: Data Dictionary Views: Usage and Examples
ErrorTblsV[X]
Example
The following SELECT statement displays the permanent disk space across all AMPs.
==> SELECT AMP,DatabaseName,CurrentPerm,MaxPerm FROM DBC.DiskSpace;
AMP
--.
.
0-0
0-0
1-0
1-0
1-0
1-0
.
.
1-1
1-1
1-1
1-1
.
.
1-2
DatabaseName
-----------.
.
stst14
ud12
atest
a1
btest
b2test
.
.
atest
a1
btest
b2test
.
.
atest
CurrentPerm
----------.
.
0
0
1,536
0
3,584
49,664
.
.
1,536
0
3,584
50,688
.
.
1,536
MaxPerm
--------.
.
125,000
125,000
125,000
247,500
5,000
250,000
.
.
125,000
247,500
5,000
250,000
.
.
125,000
ErrorTblsV[X]
The ErrorTblsV view provides information on relationships between data and error tables
accessible to the current user:
View Name
User Type
Columns Selected
DBC.ErrorTblsV[X]
Operations Control
ErrTblDbName
ErrTblName
BaseTblDbName
BaseTblName
CreatorName
CreateTimeStamp
Corresponding System Tables
The corresponding system tables for DBC.ErrorTblsV are:
462
•
DBC.Dbase
•
DBC.TVM
•
DBC.ErrorTbls
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
Events[V][X]
The corresponding system tables for DBC.ErrorTblsVX are:
•
DBC.Dbase
•
DBC.TVM
•
DBC.ErrorTbls
•
DBC.AccessRights
•
DBC.Owner
•
DBC.RoleGrants
•
DBC.Roles
Usage Notes
None.
Example
The following example shows base data table u2.t1 has an error table u2.ET_t1, which is
created by u2.
==> SELECT ErrTblDbName (char(8)),
ErrTblName (char(8)),
BaseTblDbName (char(8)),
BaseTblName (char(8)),
CreatorName (char(4)),
CreateTimeStamp
FROM
DBC.ErrorTblsV;
*** Query completed. One row found. 6 columns returned.
*** Total elapsed time was 1 second.
ErrTblDbName
-----------u2
ErrTblName
---------ET_t1
BaseTblDbName
------------u2
BaseTblName
----------t1
CreatorName
----------u2
CreateTimeStamp
------------------2006-08-28 11:47:56
Events[V][X]
The Events view provides information about the execution of checkpoint statements and
client system utility functions.
Data Dictionary
View Name
User Type
Columns Selected
DBC.Events[V][X]
Operations Control
CreateDate
CreateTime
EventNum
EventType
UserName
DatabaseName
ObjectType
AllAMPsFlag
463
Chapter 3: Data Dictionary Views: Usage and Examples
Events[V][X]
View Name
User Type
Columns Selected
DBC.Events[V][X]
(Continued)
Operations Control
RestartSeqNum
OperationInProcess
TableName
CheckpointName
LinkingEventNum
DataSetName
LockMode
JournalUsed
JournalSaved
IndexPresent
DupeDumpSet
Corresponding System Tables
The corresponding system table for DBC.Events[V] is DBC.RCEvent.
The corresponding system tables for DBC.Events[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.RCEvent
•
DBC.RoleGrants
•
DBC.Roles
The X view also references the userdb view.
Usage Notes
The Events view returns a row for each archive or recovery activity. The types of event rows are
as follows.
Type of event row …
A row is created for each …
Checkpoint
journal checkpointed.
Delete
journal deleted.
Dump
database or table dumped.
Restore
database or table restored.
Rollback
database or table rolled back.
Rollforward
database or table rolled forward.
The Events view contains the following standard and optional fields.
464
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
Events[V][X]
Standard fields
Optional fields
EventNum
DataSetName
CreateDate
TableName
CreateTime
CheckpointName
UserName
LinkingEventNum
EventType
LockMode
DatabaseName
JournalUsed
ObjectType
JournalSaved
AllAMPsFlag
IndexPresent
RestartSeqNum
DupeDumpSet
The CreateDate and CreateTime fields are updated by the PE on which the session is running;
thus, all events for a given session are timestamp-ordered.
However, if multiple or concurrent sessions are running on different PEs, any discrepancy in
AMP clocks may be reflected in the timestamp sequence. This may also occur if a Teradata
Database connects to more than one client system and the client system clocks are not
synchronized.
Example
The following SELECT statement selects information associated with the requesting user from
the DBC.EventsX view.
==> SELECT CreateDate, CreateTime, EventType, JournalUsed FROM
DBC.EventsX;
CreateDate
---------87/03/18
87/03/18
87/03/19
87/02/12
Data Dictionary
CreateTime
---------11:10:45
11:18:20
12:06:34
14:13:38
EventType
----------Rollforward
Restore
Rollforward
Dump
JournalUsed
----------R
R
R
S
465
Chapter 3: Data Dictionary Views: Usage and Examples
Events_Configuration[V][X]
Events_Configuration[V][X]
The Events_Configuration view provides information about utility events that did not affect
all AMPs.
View Name
User Type
Columns Selected
DBC.Events_Configuration[V][X]
Operations
Control
CreateDate
CreateTime
EventNum
EventType
UserName
LogProcessor
PhyProcessor
Vproc
ProcessorState
RestartSeqNum
Corresponding System Tables
The corresponding system tables for DBC.Events_Configuration[V] are:
•
DBC.RCConfiguration
•
DBC.RCEvent
The corresponding system tables DBC.Events_Configuration[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.RCConfiguration
•
DBC.RCEvent
•
DBC.RoleGrants
•
DBC.Roles
The X view also references the userdb view.
Usage Notes
The Events_Configuration view contains rows for each archive activity that does not affect all
AMPs in the Teradata Database configuration.
If the activity is for all AMPs and there are AMPs off-line, a row is inserted for each off-line
AMP. If the activity is for specific AMPs, a row is inserted for each AMP that is specified and
online.
The CreateDate and CreateTime fields are updated by the PE on which the session is running;
thus, all events for a given session are timestamp-ordered. However, if multiple or concurrent
sessions are running on different PEs, any discrepancy in AMP clocks may be reflected in the
466
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
Events_Media[V][X]
timestamp sequence. This may also occur if a Teradata Database is connected to more than
one client system and the client system clocks are not synchronized.
Example
The statement on the following screen selects information concerning the requesting user
from the DBC.Events_ConfigurationX view.
==> SELECT CreateDate, CreateTime, EventNum, EventType
FROM DBC.Events_ConfigurationX;
CreateDate
---------87/03/18
87/03/18
87/03/18
87/03/20
87/03/18
87/03/18
87/03/18
CreateTime
---------08:53:48
08:57:49
08:54:42
11:26:26
09:00:05
09:30:59
08:57:02
EventNum
-------30
44
33
98
52
55
41
EventType
-----------Rollforward
Rollforward
Rollforward
Dump
Rollforward
Restore
Rollforward
Events_Media[V][X]
The Events_Media view provides information about the execution of a client system utility
dump or restore function that created or used removable media.
View Name
User Type
Columns Selected
DBC.Events_Media[V][X]
Operations Control
CreateDate
CreateTime
EventNum
EventType
UserName
DataSetName
VolSerialId
VolSequenceNum
DupeDumpSet
Corresponding System Tables
The corresponding system tables for DBC.Events_Media[V] are:
Data Dictionary
•
DBC.RCEvent
•
DBC.RCMedia
467
Chapter 3: Data Dictionary Views: Usage and Examples
Events_Media[V][X]
The corresponding system tables for DBC.Events_Media[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.RCEvent
•
DBC.RCMedia
•
DBC.RoleGrants
•
DBC.Roles
The X view also references the userdb view.
Usage Notes
The CreateDate and CreateTime fields are updated by the PE on which the session is running;
therefore, all events for a given session are timestamp-ordered. However, if multiple or
concurrent sessions are running on different PEs, any discrepancy in AMP clocks may be
reflected in the timestamp sequence.
This may also occur if a Teradata Database is connected to more than one client system and
the client system clocks are not synchronized.
Example
In this example, the requesting user is researching the Events_Media view for events associated
with the user named ’PAL’.
==> SELECT DataSetName,VolSerialId,DupeDumpSet
FROM DBC.Events_Media WHERE UserName = ’PAL’ ;
DataSetName
------------BRM.DBC.TEXT1
BRM.DBC.TEXT1
BRM.DBC.TEXT2
BRM.DBC.TEXT2
BRM.DBC.TEXT1
BRM.DBC.TEXT1
BRM.DBC.TEXT2
BRM.DBC.TEXT2
468
VolSerialId
----------000469
000469
000469
000469
BRM001
BRM002
BRM001
BRM002
DupeDumpSet
----------N
N
N
N
Y
Y
N
N
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
ExternalSPs[V][X]
ExternalSPs[V][X]
The ExternalSPs view extracts the External Stored Procedure (XSP) details from
DBC.UDFInfo, DBC.DBase, and DBC.TVM.
View Name
User Type
Columns Selected
DBC.ExternalSPs[V][X]
Teradata Database
Administrator
DatabaseName
ExternalProcedureName
ExternalProcedureId
NumParameters
ExternalName
SrcFileLanguage
NoSQLDataAccess
ParameterStyle
ExecProtectionMode
ExtFileReference
CharacterType
Platform
RoutineKind
ParameterUDTIds
AuthIdUsed
AppCategory
GLOPSetDatabaseName
GLOPSetMemberName
Corresponding System Tables
The corresponding system tables for DBC.ExternalSPs[V] are:
•
DBC.DBase
•
DBC.TVM
•
DBC.UDFInfo
The corresponding system tables for DBC.ExternalSPs[V]X are:
Data Dictionary
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.RoleGrants
•
DBC.Roles
•
DBC.TVM
•
DBC.UDFInfo
469
Chapter 3: Data Dictionary Views: Usage and Examples
Functions[V][X]
Example
The following SELECT statement returns information about the external stored procedures in
database ’dba’.
==> SELECT * FROM DBC.ExternalSPs
WHERE databasename = ‘dba’;
DataDatabaseName
ExternalProcedureName
ExternalProcedureId
NumParameters
ExternalName
SrcFileLanguage
NoSQLDataAccess
ParameterStyle
ExecProtectionMode
ExtFileReference
CharacterType
Platform
RoutineKind
ParameterUDTIds
AuthIdUsed
AppCategory
dba
XSP_100
00006E0F0000
2
xsp_100
C
Y
S
P
CS!xsp_100!/home/i18n/ckl/udftest/xsp_100.c
1
MPRAS
R
00001E0A0000
S
GLOPSetDatabaseName ?
GLOPSetMemberName
?
Functions[V][X]
The Functions view contains all the function information.
470
View Name
User Type
Columns Selected
DBC.Functions[V][X]
Teradata Database
Administrator
DatabaseName
FunctionName
SpecificName
FunctionId
NumParameters
ParameterDataTypes
FunctionType
ExternalName
SrcFileLanguage
NoSQLDataAccess
ParameterStyle
DeterministicOpt
NullCall PrepareCount
ExecProtectionMode
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
Functions[V][X]
View Name
User Type
Columns Selected
DBC.Functions[V][X]
(Continued)
Teradata Database
Administrator
ExtFileReference
CharacterType
Platform
InterimFldSize
RoutineKind
ParameterUDTIds
AuthIdUsed
MaxOutParameters
GLOPSetDatabaseName
GLOPSetMemberName
Corresponding System Tables
The corresponding system tables for DBC.Functions[V] are:
•
DBC.Dbase
•
DBC.TVM
•
DBC.UDFInfo
The corresponding system tables for DBC.Functions[V]X are:
•
DBC.AccessRights
•
DBC.Dbase
•
DBC.Owners
•
DBC.TVM
•
DBC.UDFInfo
Example
The following SELECT statement displays information about the overloaded functions named
'concat' in 'dba' database:
==> SELECT SpecificName, NumParameters, ParameterDataTypes FROM
Functions WHERE DatabaseName = 'dba' and FunctionName = 'concat'
order by 1,2,3;
Data Dictionary
SpecificName
NumParameters
------------------ -------------
ParameterDataTypes
--------------------------
concat
concat_3
concat_4
CFCF
CFCFCF
CFCFCFCF
2
3
4
471
Chapter 3: Data Dictionary Views: Usage and Examples
HostsInfo[V]
HostsInfo[V]
The HostsInfo view displays information about any user-defined character sets assigned by
the Teradata Database system administrator as the default for the client systems in the
Teradata Database configuration. (See also “CharSets[V]” on page 439 and
“CharTranslations[V]” on page 440.)
View Name
User Type
Columns Selected
DBC.HostsInfo[V]
End User
LogicalHostId
HostName
DefaultCharSet
Teradata Database
Administrator
Corresponding System Table
The corresponding system table for this view is DBC.Hosts.
Usage Notes
If this view does not exist or no rows are found, the default character set of each logon client
system is in effect.
Example
The following SELECT statement selects any character sets assigned by the user as the defaults
for the client systems in the Teradata Database configuration.
==> SELECT * FROM DBC.HostsInfo;
LogicalHostId
------------136
137
HostName
--------VM
LAN
DefaultCharSet
---------------Norwegian_EBCDIC
ASCII
Related Topics
For more information on user-defined character sets and the values in DBC.HostsInfo, see
International Character Set Support.
472
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
IndexConstraints[V][X]
IndexConstraints[V][X]
The IndexConstraints view provides information about index constraints on tables. Index
constraints are implied constraints derived from a partitioning expression.
View Name
User Type
Columns Selected
DBC.IndexConstraints[V][X]
End User
DatabaseName
TableName
IndexName
IndexNumber
ConstraintType
ConstraintText
ConstraintCollation
CollationName
CreatorName
CreateTimeStamp
CharSetId
SessionMode
VTCheckType
TTCheckType
ResolvedCurrent_Date
ResolvedCurrent_TimeStamp
Teradata Database
Administrator
Corresponding System Tables
The corresponding system tables for DBC.IndexConstraints[V] are:
•
DBC.DBase
•
DBC.TableConstraints
•
DBC.TVM
The corresponding system tables for DBC.IndexConstraints[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.TableConstraints
•
DBC.TVM
•
DBC.RoleGrants
•
DBC.Roles
Usage Notes
Implicit Table-Level Index CHECK Constraints for SLPPI Tables
A single-level partitioned primary index (SLPPI) table has one of the following two implied
table-level index CHECK constraints, depending on whether the partitioning expression has
an INTEGER data type or not.
Data Dictionary
473
Chapter 3: Data Dictionary Views: Usage and Examples
IndexConstraints[V][X]
CHECK
(
BETWEEN
A
(
CAST ( partitioning_expression )
1
AND
AS INTEGER
)
)
A
max
1094A080
CHECK
(
partitioning_expression
BETWEEN
1
AND
max
1094A081
where:
Syntax element …
Specifies the …
partitioning_expression
partition number returned by the SLPPI partitioning expression.
max
maximum number of partitions defined by partitioning_expression.
IF the partitioning expression is
defined with …
THEN the value of max is …
other than just a RANGE_N or
CASE_N function
65,535.
only a RANGE_N or CASE_N
function
the number of partitions defined
by the function.
For more information on the two implied table-level index CHECK constraints and the
single-level partitioned primary indexes, see Database Design.
Implicit Table-Level Index CHECK Constraints for MLPPI Tables
A multilevel partitioned primary index (MLPPI) table has the following implied table-level
index CHECK constraint, which the system stores in DBC.TableConstaints.
CHECK
A
( / * nn * /
AND
partitioning_expression_1
IS NOT NULL
A
partitioning_expression_2
IS NOT NULL
B
B
)
13
AND
partitioning_expression_n
IS NOT NULL
1094A079
where:
Syntax element …
Specifies the …
nn
number of levels or partitioning expressions, in the MLPPI.
nn can range between 02 and 15, inclusive.
474
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
IndexStats[V]
Syntax element …
Specifies the …
partitioning_expression_1
the first MLPPI partitioning expression.
partitioning_expression_2
the second MLPPI partitioning expression.
partitioning_expression_n
the nth MLPPI partitioning expression.
Note that if the MLPPI has 3 levels, there are 3 NOT NULL
partitioning expressions in the implied constraint, if the MLPPI has 10
levels, there are 10 NOT NULL partitioning expressions in the implied
constraint, and so on.
For more information on the implied table-level index CHECK constraint and the multilevel
partitioned primary indexes, see Database Design.
Example 1
The following query retrieves a list of tables and join indexes that have PPIs and their index
constraint text:
SELECT DatabaseName, TableName (TITLE 'Table/Join Index Name'),
ConstraintText
FROM DBC.IndexConstraints
WHERE ConstraintType = 'Q'
ORDER BY DatabaseName, TableName;
Example 2
The following query retrieves a list of tables and join indexes that have SLPPIs:
SELECT DatabaseName, TableName (TITLE 'Table/Join Index Name')
FROM DBC.IndexConstraints
WHERE ConstraintType = 'Q'
AND (
SUBSTRING(ConstraintText FROM 1 FOR 13) < 'CHECK (/*02*/'
OR SUBSTRING(ConstraintText FROM 1 FOR 13) > 'CHECK (/*15*/')
ORDER BY DatabaseName, TableName;
IndexStats[V]
The IndexStats view provides information on statistics collected on multicolumn indexes,
namely those indexes for which two or more columns have been defined. When statistics are
collected on such indexes, the statistics are saved in DBC.Indexes, which is the underlying base
table on which the IndexStats view is defined. For information regarding statistics collected on
single column indexes, see “ColumnStats[V]” on page 446.
Data Dictionary
475
Chapter 3: Data Dictionary Views: Usage and Examples
IndexStats[V]
View Name
User Type
Columns Selected
DBC.IndexStats[V]
End User
DatabaseName
TableName
IndexNumber
IndexName
IndexType
UniqueFlag
ColumnPosition
ColumnName
ColumnType
ColumnLength
ColumnFormat
DecimalTotalDigits
DecimalFractionalDigits
IndexStatistics
UniqueOrPK
VTConstraintType
TTConstraintType
SystemDefinedJI
TimeDimension
Teradata Database
Administrator
Corresponding System Tables
The corresponding system tables for this view are:
•
DBC.DBase
•
DBC.Indexes
•
DBC.TVFields
•
DBC.TVM
Usage Notes
This view is used by the following client tools:
•
Teradata System Emulation Tool (TSET)
•
Teradata Visual Explain
This view is also is also used by any client application that requires statistical information.
The information returned includes the following:
•
Index statistics
•
Table name
•
Database name
•
Index number
•
Details of the column on which the index is defined.
By default, the output from this view includes a result row for each column of each index. For
indexes with collected statistics, only the first column (the one whose FieldPosition is 1), has
statistics returned in the IndexStatistics column. All other columns of the index return rows
476
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
IndexStats[V]
whose IndexStatistics value is NULL. If no statistics were collected on the index, the row in
which FieldPosition equals 1 has the corresponding IndexStatistics set to NULL as well. Users
can filter out those rows in which IndexStatistics is NULL.
By default, the output from this view includes a result row for indexes defined on single
columns. Such rows have the IndexStatistics field set to NULL. Users can filter out such rows,
and should use instead the ColumnStats view to retrieve statistics for single-column indexes.
Example
This example assumes the following statistics have been collected:
COLLECT STATISTICS ON Charges INDEX (EmpNo, Proj_id);
The following statement retrieves statistics collected on the “Charges” table.
==> SELECT IndexNumber, IndexType, ColumnPosition, ColumnName,
IndexStatistics
FROM DBC.IndexStats
WHERE DatabaseName = 'Personnel' AND TableName = 'Charges'
AND IndexStatistics IS NOT NULL
ORDER BY IndexNumber;
The output of this statement is:
*** Query completed. One row found. 5 columns returned.
*** Total elapsed time was 1 second.
IndexNumber 1
IndexType P
ColumnPosition 1
ColumnName EmpNo
IndexStatistics
D4070A060E3508280200000000000000000000000000000000002020202
Note: The IndexStatistics information appears in an internal format. The client tools TSET or
Teradata Visual Explain can interpret this information.
Data Dictionary
477
Chapter 3: Data Dictionary Views: Usage and Examples
Indices[V][X]
Indices[V][X]
The Indices view provides information about each indexed column of the DBC.Indexes table.
View Name
User Type
Columns Selected
DBC.Indices[V][X]
[X]End User
DatabaseName
TableName
IndexNumber
IndexType
UniqueFlag
IndexName
ColumnName
ColumnPosition
CreatorName
CreateTimeStamp
LastAlterName
LastAlterTimeStamp
IndexMode
AccessCount
LastAccessTimeStamp
UniqueOrPK
VTConstraintType
TTConstraintType
SystemDefinedJI
Teradata Database
Administrator
Corresponding System Tables
The corresponding system tables for DBC.Indices[V] are:
•
DBC.DBase
•
DBC.Indexes
•
DBC.TVFields
•
DBC.TVM
The corresponding system tables for DBC.Indices[V]X are:
478
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Indexes
•
DBC.Owners
•
DBC.Roles
•
DBC.RoleGrants
•
DBC.TVFields
•
DBC.TVM
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
InDoubtLog[V]
Usage Notes
One row is returned from the Indices view for each column in each index. Therefore, a query
on an index made up of multiple columns returns multiple rows.
Example
The following SELECT statement displays index information for all the tables in the Personnel
database.
==> SELECT TableName,ColumnName,ColumnPosition,IndexType,UniqueFlag FROM
DBC.Indices
WHERE DatabaseName= ’Personnel’
ORDER BY TableName,ColumnPosition ;
The results of this query are as follows:
TableName
---------Charges
Charges
Charges
Department
Employee
Employee
Project
ColumnName
---------Proj_id
EmpNo
Proj_id
DeptNo
EmpNo
Name
Proj_id
ColumnPosition
-------------1
1
2
1
1
1
1
IndexType
--------S
P
P
P
P
S
P
UniqueFlag
---------N
N
N
Y
Y
N
Y
InDoubtLog[V]
The InDoubtLog view displays the contents of the DBC.InDoubtResLog table. The table
contains a row for each transaction that had been in-doubt, and that was subsequently
manually resolved.
View Name
User Type
Columns Selected
DBC.InDoubtLog[V]
Teradata Database
Administrator
LogicalHostId
SessionNumber
CoordTaskId
RunUnitId
LogonUserName
ResolvingUserLogonName
CommitOrRollBack
UserLogonDate
UserLogonTime
CompletionDate
CompletionTime
Options
Corresponding System Table
The corresponding system table for this view is DBC.InDoubtResLog.
Data Dictionary
479
Chapter 3: Data Dictionary Views: Usage and Examples
JoinIndicesV
JoinIndicesV
The JoinIndicesV view joins DBC.Indexes with DBC.TVM and DBC.Databasename to get the
actual names of the tables, join indexes, and their databases.
View Name
User Type
Columns Selected
DBC.JoinIndicesV
Teradata Database
Administrator
DataBaseName
TableName
JoinIdxDataBaseName
JoinIdxName
IndexType
Corresponding System Tables
The corresponding system tables for DBC.JoinIndicesV are:
•
DBC.DBase
•
DBC.TVM
•
DBC.Indexes
Usage Notes
None.
Example
The following statement displays the join indexes defined on the table user1.oneoneone.
==> SELECT joinidxdatabasename, joinidxname
FROM joinindicesv
WHERE databasename = 'user1' and tablename = 'oneoneone';
*** Query completed. One row found. 2 columns returned.
*** Total elapsed time was 1 second.
JoinIdxDataBaseName
------------------user1
480
JoinIdxName
-----------ji
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
Journals[V][X]
Journals[V][X]
The Journals view provides information about the journal table for each data table that uses
journal protection. The restricted version of the view displays only those objects that the
requesting user either owns or holds privileges to.
View Name
User Type
Columns Selected
DBC.Journals[V][X]
[X]End User
Tables_DB
TableName
Journals_DB
JournalName
Teradata Database
Administrator
Corresponding System Tables
The corresponding system tables for DBC.Journals[V] are:
•
DBC.DBase
•
DBC.TVM
The corresponding system tables for DBC.Journals[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.RoleGrants
•
DBC.Roles
•
DBC.TVM
Example
The statement on the following screen selects information from the Journals view for the table
named PriceA.
==> SELECT TableName,Tables_DB,Journals_DB,JournalName
FROM DBC.Journals WHERE Tablename = ’PriceA’ ;
TableName
--------PriceA
.
.
.
Data Dictionary
Tables_DB
--------Acctng
.
.
.
Journals_DB
----------Acctng
.
.
.
JournalName
-----------JNLA
.
.
.
481
Chapter 3: Data Dictionary Views: Usage and Examples
LogOnOff[V][X]
LogOnOff[V][X]
The LogOnOff view supplies information about logon and logoff activity, including attempted
logons.
View Name
User Type
Columns Selected
DBC.LogOnOff[V][X]
Teradata Database
Security Administrator
LogDate
LogTime
UserName
AccountName
Event
LogicalHostId
IFPNo
SessionNo
LogonDate
LogonTime
LogonSource
Teradata Database
Administrator
Supervisory
Corresponding System Table
The corresponding system table for this view is DBC.Eventlog.
Usage Notes
Event data is useful in determining why a logon attempt was not successful. Information
about logon and logoff activity is also maintained on the client system.
Note that AccountName is the unexpanded account name for the session at the time of the
event.
Example
The following SELECT statement displays information about the logon and logoff activity of a
specific user for a particular date:
==> SELECT LogDate,LogTime,Event,LogicalHostId,IFPNo
FROM DBC.LogOnOff WHERE LogDate=’87/09/29’
AND UserName=’Tester’ ORDER BY LogTime;
LogDate
-------87/09/29
87/09/29
87/09/29
87/09/29
87/09/29
87/09/29
87/09/29
87/09/29
87/09/29
.
482
LogTime
-------12:35:54
12:35:60
13:30:37
13:31:45
13:52:52
13:56:03
14:05:27
14:12:12
14:14:04
.
Event
LogicalHostId
-----------------Logon
116
Logon
116
Logoff
116
Logoff
116
Logon
116
Logoff
116
Logon
116
Logoff
116
Logon failed
116
.
.
IFPNo
----1-4
1-4
1-4
1-4
1-4
1-4
1-4
1-4
1-4
.
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
LogonRules[V]
Related Topics
For more information on controlling access, space, and ownership, see Database Design.
LogonRules[V]
The LogonRules view retrieves information about logon rules generated as a result of
successfully processed GRANT LOGON statements.
View Name
User Type
Columns Selected
DBC.LogonRules[V]
Teradata Database
Security Administrator
UserName
LogicalHostId
LogonStatus
NullPassword
CreatorName
CreateTimeStamp
Corresponding System Tables
The corresponding system tables for this view are:
•
DBC.DBase
•
DBC.LogonRuleTbl
Usage Notes
The LOGON rules can be used to redefine the Teradata Database defaults. See SQL Data
Definition Language for more information.
The initial defaults are that all users can log on from all client systems and that every logon
string must contain a password.
MultiColumnStats[V]
The MultiColumnStats view provides partition statistical (single-column or multicolumn
partition) information for groups of non-indexed columns. This view also includes
information about tables where partition statistics have been collected.
View Name
User Type
Columns Selected
DBC.MultiColumnStats[V]
End User
DatabaseName
TableName
StatisticsId
ColumnPosition
ColumnName
ColumnType
Teradata Database
Administrator
Data Dictionary
483
Chapter 3: Data Dictionary Views: Usage and Examples
MultiColumnStats[V]
View Name
User Type
Columns Selected
DBC.MultiColumnStats[V]
(Continued)
End User
ColumnLength
ColumnFormat
DecimalTotalDigits
DecimalFractionalDigits
ColumnsStatistics
Teradata Database
Administrator
Corresponding System Tables
The corresponding system tables for this view are:
•
DBC.DBase
•
DBC.Indexes
•
DBC.TVFields
•
DBC.TVM
When statistics are collected on a group of two or more non-indexed columns of a table, the
information is saved in the base table DBC.Indexes. Such rows within DBC.Indexes are often
described as being "pseudo" indexes because of the fact that they are simply a placeholder for
storing non-indexed statistics.
Usage Notes
The following client tools use this view:
•
Teradata System Emulation Tool (TSET)
•
Teradata Visual Explain
Any client application that requires statistical information used by the Optimizer also uses this
view. The information returned includes the following:
•
Columns Statistics
•
Table Name
•
Database Name
•
Statistics ID
•
Details of the columns on which the statistics are collected.
By default, the output from this view includes a result row for each column on which
multicolumn statistics or single-column PARTITION statistics were collected. For those
columns of multicolumn statistics, only the first column, namely the one whose FieldPosition
is 1, has statistics returned in the ColumnsStatistics column. All other columns of the
multicolumn statistics return rows whose ColumnsStatistics value is NULL. Users may wish to
filter out those rows in which ColumnsStatistics is NULL.
The information stored in the ColumnsStatistics column is stored in an internal format. The
client tools TSET or Teradata Visual Explain can interpret this information.
484
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
ProfileInfo[V][X]
Example
The following statement retrieves information about statistics collected on groups of nonindexed columns for table T1. The results assume that statistics have been previously collected
on column groups (colA,colB) and (colC,colD,colE).
SELECT ColumnName, StatisticsId
FROM DBC.MultiColumnStats
WHERE DatabaseName = 'Statstesting1' AND TableName = 'T1'
ORDER BY StatisticsId;
The output of this statement is:
ColumnName
---------colA
colB
colC
colD
colE
StatisticsId
------------129
129
130
130
130
ProfileInfo[V][X]
The ProfileInfo view lists all profiles and their parameter settings, and the ProfileInfoX view
lists the profile, if any, and its parameter settings for the current user.
View Name
User Type
Columns Selected
DBC.ProfileInfo[V][X]
[X]End User
ProfileName
DefaultAccount
DefaultDB
SpoolSpace
TempSpace
ExpirePassword
PasswordMinChar
PasswordMaxChar
PasswordDigits
PasswordSpecChar
PasswordRestrictWords
MaxLogonAttempts
LockedUserExpire
PasswordReuse
CommentString
CreatorName
CreateTimeStamp
LastAlterName
LastAlterTimeStamp
Teradata Database
Security Administrator
Teradata Database
Administrator
Supervisory
Data Dictionary
485
Chapter 3: Data Dictionary Views: Usage and Examples
ProfileInfo[V][X]
Corresponding System Tables
The corresponding system tables for this view are:
•
DBC.DBase
•
DBC.Profiles
Usage Notes
In ProfileInfo[X], if no profile is set up for the user or for ProfileInfo and if no profile is
defined, the view returns the following message:
No rows found
If the profile creator has been dropped, the ProfileInfo[X] view returns the information of that
profile, which is shown with the text "Dropped User" for CreatorName or LastAlterName.
Example
The following query lists the parameter settings of all profiles in the system together with their
parameter settings:
SELECT CAST(ProfileName
AS CHAR(15)),
CAST (DefaultDB
AS CHAR(15)),
CAST (AccountName AS CHAR(15)) (NAMED DefaultAccount),
SpoolSpace,
TempSpace
FROM DBC.ProfileInfo ORDER BY 1;
*** Query completed. 3 rows found. 5 columns returned.
*** Total elapsed time was 1 second.
ProfileName
----------kanji
HResources
NTGroup
DefaultDB
--------japan
personnel
NT
DefaultAccount
-------------i18n
?
ncrsandiego
SpoolSpace
---------50000
?
50000
TempSpace
-----------50000
?
50000
If multiple accounts are specified for the ACCOUNT parameters, only the first account (the
default account) in the list is reflected in the display. The remaining accounts in the list can be
retrieved by performing a SELECT on the existing view DBC.AccountInfo. Parameter settings
for the profile assigned to the user may similarly be displayed by performing a SELECT on the
new system view DBC.ProfilesInfoX.
486
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
QryLog[V]
QryLog[V]
The QryLog view specifies the main view for DBQL.
Data Dictionary
View Name
User Type
Columns Selected
DBC.QryLog[V]
Teradata Database
Administrator
ProcID
CollectTimeStamp
QueryID
UserID
UserName
DefaultDatabase
AcctString
ExpandAcctString
SessionID
LogicalHostID
RequestNum
InternalRequestNum
LogonDateTime
AcctStringTime
AcctStringHour
AcctStringDate
LogonSource
AppID
ClientID
ClientAddr
QueryBand
ProfileID
StartTime
FirstStepTime
FirstRespTime
ElapsedTime
NumSteps
NumStepswPar
MaxStepsInPar
NumResultRows
TotalIOCount
AMPCPUTime
ParserCPUTime
UtilityRowCount
ErrorCode
ErrorText
WarningOnly
AbortFlag
CacheFlag
StatementType
StatementGroup
QueryText
NumOfActiveAMPs
MaxAMPCPUTime
MaxCPUAmpNumber
MinAmpCPUTime
MaxAmpIO
487
Chapter 3: Data Dictionary Views: Usage and Examples
QryLog[V]
View Name
User Type
Columns Selected
DBC.QryLog
(Continued)
Teradata Database
Administrator
MaxIOAmpNumber
MinAmpIO
SpoolUsage
LSN
EstResultRows
EstProcTime
EstMaxRowCount
AMPCPUTimeNorm
ParserCPUTimeNorm
MaxAMPCPUTimeNorm
MaxCPUAmpNumberNorm
MinAmpCPUTimeNorm
ParExpreqTime
ProxyUser
ProxyRole
SessionTemporalQualifier
Corresponding System Table
The corresponding system table for this view is DBC.DBQLogTbl.
Usage Notes
If logging is invoked for a user/account, each query has one row logged in the QryLog. Note
that the account string logged is the account string in effect at the end of the query.
Example
The following SELECT statement retrieves the main view for DBQL:
SELECT QueryID, UserName, AcctString, SessionID, LogicalHostID,
RequestNum, LogonDateTime, StartTime, NumSteps, NumStepswPar,
MaxStepsInPar, NumResultRows, CacheFlag, QueryText
FROM DBC.QryLog where QueryID = 201205134619838011;
QueryID
UserName
AcctString
SessionID
LogicalHostID
RequestNum
LogonDateTime
StartTime
NumSteps
NumStepswPar
MaxStepsInPar
NumResultRows
488
201205134619838011
Chanbr
6000
1106
1
27
2004-06-27 17:18:40.03
2004-06-27 17:18:43.01
6
0
0
?
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
QryLogEventHis[V]
CacheFlag
QueryText
T
SELECT * FROM
Department order by Deptno;
QryLogEventHis[V]
The QryLogEventHis view provides a means by which an end user can discover the sequence
of states and events that occurred at any point in time.
View Name
User Type
Columns Selected
DBC.QryLogEventHis[V]
Teradata Database
Administrator
ProcID
CollectTimeStamp
EntryTS
EntryKind
EntryID
EntryName
EventValue
LastValue
Activity
ActivityId
ActivityName
ConfigId
SeqNo
Spare1
Spare2
Spare3
Corresponding System Table
The corresponding system table for this view is DBC.TDWMEventHistory.
Usage Notes
None.
Data Dictionary
489
Chapter 3: Data Dictionary Views: Usage and Examples
QryLogEvents[V]
Example
The following is an example SQL statement that demonstrates how data can be extracted from
the QryLogEventHis view to give an explanation of the expression and events which caused a
RED SysCon.
WITH RECURSIVE
CausalAnalysis(EntryTS,
EntryKind, EntryID, EntryName, Activity, ActiveId) AS
(
SELECT EntryTS,
EntryKind, EntryID, EntryName, Activity, ActiveId
FROM test.QryLogEventHis
WHERE EntryKind = 'SYSCON'
AND EntryName = 'RED'
AND Activity = 'ACTIVE'
UNION ALL
SELECT Cause.EntryTS,
Cause.EntryKind,
Cause.EntryID,
Cause.EntryName,
Cause.Activity,
Cause.ActiveId
FROM CausalAnalysis Condition INNER JOIN
test.QryLogEventHis Cause
ON Condition.EntryKind = Cause.Activity AND
Condition.EntryID = Cause.ActiveID
)
SELECT *
FROM CausalAnalysis
ORDER BY 1 DESC;
*** Query completed. 4 rows found. 6 columns returned.
*** Total elapsed time was 1 second.
EntryTS
----------------------2006-03-22 14:20:49.12
2006-03-22 14:19:49.06
2006-03-22 14:17:48.53
2006-03-22 14:16:48.51
EntryKind
---------SYSCON
EXPRESS
EVENT
EVENT
EntryID EntryName
-------- -----------30
RED
20
AWT & NODE
11
NODE DOWN
10
LOW AWTS
Activity
---------ACTIVE
SYSCON
EXPRESS
EXPRESS
ActiveId
--------0
30
20
20
QryLogEvents[V]
The QryLogEvents view contains the Teradata Database events that affect or are affected by the
Teradata dynamic workload management software.
490
View Name
User Type
Columns Selected
DBC.QryLogEvents[V]
Teradata Database
Administrator
ProcID
CollectTimeStamp
SessionID
LogicalHostID
WDID
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
QryLogEvents[V]
View Name
User Type
Columns Selected
DBC.QryLogEvents[V] (Continued)
Teradata Database
Administrator
OpEnvID
SysConID
EventTime
EventCode
EventSubCode
EventInfo
Corresponding System Table
The corresponding system table for this view is DBC.TDWMEventLog.
Usage Notes
These events may include a Teradata dynamic workload management software rule update or
errors encountered during a Teradata dynamic workload management software rule activate
or deactivate.
Example
The following statement retrieves rows from the view QryLogEvents:
SELECT * from DBC.QryLogEvents;
The output of this statement is:
ProcID
CollectTimeStamp
SessionID
LogicalHostID
WDID
OpEnvID
SysConID
EventTime
EventCode
EventSubCode
EventInfo TDWM
Data Dictionary
16383
2004-06-22 14:51:32
?
?
?
?
?
2004-06-22 14:43:32.58
3,158
?
rules have been updated
491
Chapter 3: Data Dictionary Views: Usage and Examples
QryLogExceptions[V]
QryLogExceptions[V]
The QryLogExceptions view contains the results of the query affected by Teradata dynamic
workload management software exception handling.
View Name
User Type
Columns Selected
DBC.QryLogExceptions[V]
Teradata Database
Administrator
ProcID
CollectTimeStamp
QueryID
UserName
SessionID
RequestNum
LogicalHostID
AcctString
WDID
OpEnvID
SysConID
ClassificationTime
ExceptionTime
ExceptionValue
ExceptionAction
NewWDID
ExceptionCode
ExceptionSubCode
ErrorText
ExtraInfo
RuleID
WarningOnly
RejectionCat
Corresponding System Table
The corresponding system table for this view is DBC.TDWMExceptionLog.
Usage Notes
This view contains entries for the following:
492
1
Logons rejected due to the Teradata dynamic workload management software throttle
limits
2
Queries rejected due to the Teradata dynamic workload management software object
access violations
3
Queries rejected due to the Teradata dynamic workload management software throttle
limits if abort option is chosen
4
Queries subject to WD exception handling
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
QryLogExplain[V]
Example
The following SELECT statement retrieves the main view for QryLogExceptions:
SELECT * from DBC.QryLogExceptions;
The output of this statement is:
ProcID
CollectTimeStamp
QueryID
UserName
SessionID
RequestNum
LogicalHostID
AcctString
WDID
OpEnvID
SysConID
ClassificationTime
ExceptionTime
ExceptionValue
ExceptionAction
NewWDID
ExceptionCode
ExceptionSubCode
ErrorText
ExtraInfo
RuleID
WarningOnly
RejectionCat
16383
2004-06-21 16:38:34.21
201205134619838011
TEST1
?
?
1
DBC
?
?
?
?
2004-06-21 17:38:34.21
?
?
?
3,152
?
No access allowed, For all requests, For user TEST1,
Regulation applies from 00:00 to 24:00
?
?
?
?
QryLogExplain[V]
The QryLogExplain view contains the "Explain" of the query.
View Name
User Type
Columns Selected
DBC.QryLogExplain[V]
Teradata Database
Administrator
ProcID
CollectTimestamp
QueryID
ExpRowNo
ExplainText
Corresponding System Table
The corresponding system table for this view is DBC.DBQLExplainTbl.
Usage Notes
Since the explain can be larger than 64KB, it may use multiple rows to hold the data.
Data Dictionary
493
Chapter 3: Data Dictionary Views: Usage and Examples
QryLogExplain[V]
Example
SELECT Queryid, Explaintext
FROM Qrylogexplain WHERE Queryid = 201205134619838011;
The output is:
QueryID
201205134619838011
ExplainText
1) First, we lock a distinct DBC."pseudo table" for read on a RowHash to
prevent global deadlock for DBC.DBSpace.
2) Next, we lock DBC.DBSpace for read, we lock DBC.dbase for access, and
we lock DBC.SessionTbl for access.
3) We flush the DISKSPACE and AMPUSAGE caches.
4) We execute the following steps in parallel.
1) We do an all-AMPs RETRIEVE step from DBC.dbase by way of an
all-rows scan into Spool 2 (all_amps), which is built
locally on the AMPs. Then we do a SORT to order
Spool 2 by row hash. The size of Spool 2 is estimated with
low confidence to be 10 rows. The estimated time for this
step is 1 hour and 1 minute.
2) We do an all-AMPs RETRIEVE step from DBC.SessionTbl by way
of an all-rows scan with no residual conditions into
Spool 4 (all_amps), which is redistributed by hash
code to all AMPs. Then we do a SORT to order Spool 4 by
the sort key in spool field1 eliminating duplicate rows.
The size of Spool 4 is estimated with low confidence to
be 2 rows. The estimated time for this step is 1 hour and 1
minute.
5) We do an all-AMPs RETRIEVE step from Spool 4 (Last Use) by way of an
all-rows scan into Spool 3 (all_amps), which is duplicated on all AMPs.
Then we do a SORT to order Spool 3 by row hash. The size of Spool 3 is
estimated with no confidence to be 4 rows.
6) We execute the following steps in parallel.
1) We do an all-AMPs JOIN step from Spool 2 (Last Use) by way
of an all-rows scan, which is joined to Spool 3 (Last Use)
by way of an all-rows scan. Spool 2 and Spool 3
are joined using an exclusion merge join, with a join
condition of ("DatabaseName = UserName"). The result
goes into Spool 5 (all_amps), which is duplicated on all
AMPs. The size of Spool 5 is estimated with index join
confidence to be20 rows. The estimated time for this step is
1 hour and 1 minute.
2) We do an all-AMPs RETRIEVE step from DBC.DBSpace by way of
an all-rows scan into Spool 6 (all_amps), which is built
locally on the AMPs. The size of Spool 6 is estimated with
low confidence to be 134 rows. The estimated time for this
step is 1 hour and 1 minute.
7) We do an all-AMPs JOIN step from Spool 5 (Last Use) by way of an allrows scan, which is joined to Spool 6 (Last Use) by way of an all-rows
scan. Spool 5 and Spool 6 are joined using a single partition hash join,
with a join condition of ("DatabaseId = DatabaseId"). The result goes
into Spool 1 (group_amps), which is built locally on the AMPs. Then we
do a SORT to order Spool 1 by the sort key in spool field1. The size of
Spool 1 is estimated with index join confidence to be 134 rows. The
estimated time for this step is 1 hour and 1 minute.
8) Finally, we send out an END TRANSACTION step to all AMPs involved in
processing the request. -> The contents of Spool 1 are sent back to the
494
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
QryLogObjects[V]
user as the result of statement 1.
and 1 minute.
The total estimated time is 1 hour
Note: The ExplainText does not contain any format. It is just one long string. The example
was manually edited to add the line breaks to make it look more presentable.
QryLogObjects[V]
The QryLogObjects view is populated if object information is requested for the query in
addition to the default information row.
A row for each object (database, table, column, and index) is used. If the object is a secondary
index, its number and use are logged.
View Name
User Type
Columns Selected
DBC.QryLogObjects[V]
Teradata Database
Administrator
ProcID
CollectTimeStamp
QueryID
ObjectDatabaseName
ObjectTableName
ObjectColumnName
ObjectID
ObjectNum
ObjectType
FreqofUse
TypeofUse
Corresponding System Table
The corresponding system table for this view is DBC.DBQLObjTbl.
Usage Notes
If objects are requested, object information is stored in a DBQL table that contains a row for
each object used in the query.
IF the object is …
THEN …
an index
the field ID is logged instead of a name.
a column
• the field ID is logged instead of a name
• the object ID can be used to quality the field ID, which is
not unique across the system.
Object frequency can also be logged. This is the number of times an object is used in a query.
Data Dictionary
495
Chapter 3: Data Dictionary Views: Usage and Examples
QryLogSQL[V]
Example
The following SELECT statement retrieves the object information of a query:
SELECT QueryID, ObjectDatabaseName (Named ObjDBName), ObjectTableName (Named ObjTblName),
ObjectColumnName (Named ObjColName), ObjectID (Named ObjId), ObjectNum (Named ObjNum),
ObjectType (Named ObjType), FreqofUse
FROM DBC.QryLogObjects where queryid = 201205134619838031;
QueryID
-----------------201205134619838031
201205134619838031
201205134619838031
201205134619838031
201205134619838031
201205134619838031
ObjDBName
ObjTblName ObjColName ObjID
ObjNum
ObjType FreqofUse
----------- ---------- ---------- -------- ------- -------- --------D_PERSONNEL ?
?
00001604
0
DB
1
D_PERSONNEL DEPARTMENT
?
00009005
0
Tab
1
D_PERSONNEL DEPARTMENT
DeptNo
00009005
1,025
Col
2
D_PERSONNEL DEPARTMENT
DeptName 00009005
1,026
Col
1
D_PERSONNEL DEPARTMENT
EmpCount 00009005
1,027
Col
1
D_PERSONNEL DEPARTMENT
Loc
00009005
1,028
Col
1
QryLogSQL[V]
The QryLogSQL view holds the full SQL text.
View Name
User Type
Columns Selected
DBC.QryLogSQL[V]
Teradata Database
Administrator
ProcID
CollectTimestamp
QueryID
SqlRowNo
SqlTextInfo
Corresponding System Table
The corresponding system table for this view is DBC.DBQLSQLTbl.
Usage Notes
This view is populated if the SQL is requested for the query in addition to the default
information row. If the additional SQL text is greater than 64KB, multiple rows are generated.
Example
The following SELECT statement retrieves the SQL text information of a query:
SELECT QueryID, SqlRowNo, SqlTextInfo from DBC.QryLogSQL
WHERE QueryId=201205134619838024;
QueryID
SqlRowNo
------------------ --------201205134619838024
1
496
SqlTextInfo
---------------------------CREATE TABLE table1A,
FALLBACK, NO BEFORE JOURNAL,
NO AFTER JOURNAL (i INTEGER,
i2 INTEGER)
PRIMARY INDEX( i );
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
QryLogSteps[V]
Note: The SQL text is not edited to remove any blanks; it is stored the same way you entered
the text.
QryLogSteps[V]
The QryLogSteps view is populated by step-level information.
View Name
User Type
Columns Selected
DBC.QryLogSteps[V]
Teradata Database
Security
Administrator
ProdID
CollectTimestamp
QueryID
StepLev1Num
StepLev2Num
StepName
StepStartTime
StepStopTime
ElapsedTime
EstProcTime
EstCPUCost
CPUtime
IOcount
EstRowCount
RowCount
RowCount2
NumOfActiveAMPs
MaxAmpCPUTime
MaxCPUAmpNumber
MinAmpCPUTime
MaxAmpIO
MaxIOAmpNumber
MinAmpIO
SpoolUsage
MaxAMPSpool
MaxSpoolAmpNumber
MinAMPSpool
StepWD
LSN
UtilityTableId
RowsWComprColumns
EstIOCost
EstNetCost
EstHRCost
CPUTimeNorm
MaxAmpCPUTimeNorm
MaxCPUAmpNumberNorm
MinAmpCPUTimeNorm
Corresponding System Table
The corresponding system table for this view is DBC.DBQLStepTbl.
Data Dictionary
497
Chapter 3: Data Dictionary Views: Usage and Examples
QryLogSummary[V]
Usage Notes
If the step information of the query is requested, a step table is populated with a row for each
step.
Example
The following SELECT statement retrieves the step-level information of a query:
SELECT QueryID, StepLev1Num (Named StepLev1),
StepLev2Num (Named StepLev2), StepName, StepStartTime, StepStopTime,
RowCount
FROM DBC.QryLogSteps where QueryID = 201205134619838027;
QueryID
StepLev1 StepLev2 StepName StepStartTime
StepStopTime
RowCount
------------------ -------- -------- -------- ------------------------- --------------------------- -------201205134619838027
1
0
MLK
2004-07-08 20:37:22.76000 2004-07-08 20:37:23.100000
1
201205134619838027
2
0
MLK
2004-07-08 20:37:23.34000 2004-07-08 20:37:23.130000
1
201205134619838027
3
0
MLK
2004-07-08 20:37:23.28000 2004-07-08 20:37:23.150000
1
201205134619838027
4
1
SAT
2004-07-08 20:37:23.43000 2004-07-08 20:37:23.230000
0
201205134619838027
4
2
SAT
2004-07-08 20:37:23.23000 2004-07-08 20:37:23.150000
0
201205134619838027
4
3
INS
2004-07-08 20:37:23.14000 2004-07-08 20:37:23.290000
1
201205134619838027
4
4
INS
2004-07-08 20:37:23.24000 2004-07-08 20:37:23.150000
1
201205134619838027
4
5
INS
2004-07-08 20:37:23.11000 2004-07-08 20:37:24.120000
1
201205134619838027
4
6
INS
2004-07-08 20:37:23.13000 2004-07-08 20:37:24.180000
1
201205134619838027
4
7
CTRts 2004-07-08 20:37:24.17000 2004-07-08 20:37:25.190000
1
201205134619838027
5
0
Ctb
2004-07-08 20:37:25.20000 2004-07-08 20:37:25.240000
1
201205134619838027
6
0
Edt
2004-07-08 20:37:25.22000 2004-07-08 20:37:25.280000
1
In this example, Step 4 contains seven parallel steps. The remaining five steps are single steps.
QryLogSummary[V]
The QryLogSummary view is populated only if summary information is requested or a
threshold value is used.
498
View Name
User Type
Columns Selected
DBC.QryLogSummary[V]
Teradata Database
Security
Administrator
ProcID
CollectTimeStamp
UserID
AcctString
LogicalHostID
AppID
ClientID
ClientAddr
ProfileID
SessionID
QueryCount
ValueType
QuerySeconds
AverageTime
TotalIOCount
AverageIO
AMPCPUTime
AverageAmpCPU
ParserCPUTime
AverageParserCPU
AMPCPUTimeNorm
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
QryLogSummary[V]
View Name
User Type
Columns Selected
DBC.QryLogSummary[V]
(Continued)
Teradata Database
Security
Administrator
AverageAmpCPUNorm
ParserCPUTimeNorm
AverageParserCPUNorm
LowHist
HighHist
Corresponding System Table
The corresponding system table for this view is DBC.DBQLSummaryTbl.
Usage Notes
For the summary case, a row exists for each collection if the count of the queries run in that
time frame (LowHist to HighHist) is greater than 0.
For threshold, one row (with LowHist=ThreshValue and HighHist=0) exists for the collection
if there were queries shorter than LowHist seconds.
Example
The following SELECT statement retrieves the summary information of a session:
If logging was initiated with “Begin Query Logging limit Summary = 5,10,20 IOcount on all;”
SELECT sessionid, valuetype, querycount, averageio, totaliocount,lowhist
FROM Qrylogsummary
WHERE sessionid = 1048 or sessionid = 1049 or sessionid = 1050
ORDER BY collecttimestamp, sessionid, lowhist;
SessionID
--------1,048
1,048
1,048
1,048
1,049
1,050
1,050
Data Dictionary
ValueType
--------I
I
I
I
I
I
I
QueryCount
AverageIO
---------- ----------31
6
9
15
15
54
65
2
981
1
8
1
24
TotalIOCount
-----------4
56
224
3,519
1,962
8
24
LowHist
------0.00
5.00
10.00
20.00
20.00
5.00
20.00
499
Chapter 3: Data Dictionary Views: Usage and Examples
QryLogTDWM[V]
QryLogTDWM[V]
The QryLogTDWM view displays a subset of the DBC.DBQLogTbl fields. In addition to the
general identification fields, only fields that are connected with the Teradata dynamic
workload management software are displayed.
View Name
User Type
Columns Selected
DBC.QryLogTDWM[V]
Teradata Database
Administrator
ProcID
CollectTimeStamp
QueryID
UserID
UserName
DefaultDatabase
AcctString
LastStateChange
DelayTime
WDDelayTime
WDID
OpenvID
SysConID
LSN
NoClassification
WDOverride
SLGMet
ExceptionValue
FinalWDID
TDWMEstMaxRows
TDWMEstLastRows
TDWMEstTotalTime
TDWMAllAmpFlag
TDWMConfLevelUsed
StatementGroup
Corresponding System Table
The corresponding system table for this view is DBC.DBQLogTbl.
Usage Notes
The non-unique primary index for this view is a combination of two fields: ProcID and
CollectTimeStamp. This combination causes each dispatcher to write its DBQL cache entries
to a single AMP. This is important for database efficiency.
500
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
QryLogTDWMSum[V]
Example
The following SELECT statement retrieves the main view for QryLogTDWM:
SELECT * from DBC.QryLogTDWM;
The output of this statement is:
ProcID
CollectTimeStamp
QueryID
UserID
UserName
DefaultDatabase
AcctString
LastStateChange
DelayTime
WDDelayTime
WDID
OpEnvID
SysConID
LSN
NoClassification
WDOverride
SLGMet
ExceptionValue
FinalWDID
TDWMEstMaxRows
TDWMEstLastRows
TDWMEstTotalTime
TDWMAllAmpFlag
TDWMConfLevelUsed
StatementGroup
16383
2007-10-10 10:23:32
163831422988553055
00000100
DBC
DBC
DBC
2007-10-09 17:25:48.90
?
?
1
1
1
?
T
?
1
6
6
0.033949
T
N
DDL Grant
QryLogTDWMSum[V]
Each row in the QryLogTDWMSum view contains the summary of the WD activity per WD/
WDPeriod per vproc for a pre-determined period.
Data Dictionary
View Name
User Type
Columns Selected
DBC.QryLogTDWMSum[V]
Teradata Database
Administrator
ProcID
CollectTimeStamp
WDID
OpEnvID
SysConID
StartColTime
Arrivals
ActiveCount
Completions
MinRespTime MaxRespTime
AvgRespTime
MinCPUTime
501
Chapter 3: Data Dictionary Views: Usage and Examples
QryLogTDWMSum[V]
View Name
User Type
Columns Selected
DBC.QryLogTDWMSum[V]
(Continued)
Teradata Database
Administrator
MaxCPUTime
AvgCPUTime
DelayedCount
AvgDelayTime
ExceptionAbCount
ExceptionMvCount
ExceptionCoCount
ExceptionCount
MetSLGCount
AbortCount
ErrorCount
RejectedCount
MovedInCount
IntervalDelayCnt
DelayedQueries
Corresponding System Table
The corresponding system table for this view is DBC.TDWMSummaryLog.
Usage Notes
This view contains a historical record of WD activity. The default option is for a WD to log
summary information.
Example
The following SELECT statement retrieves the main view for QryLogTDWMSum:
SELECT * from DBC.QryLogTDWMSum;
The output of this statement is:
ProcID
CollectTimeStamp
WDID
OpEnvID
SysConID
StartColTime
Arrivals
ActiveCount
Completions
MinRespTime
MaxRespTime
AvgRespTime
MinCPUTime
MaxCPUTime
AvgCPUTime
DelayedCount
AvgDelayTime
ExceptionAbCount
ExceptionMvCount
ExceptionCoCount
ExceptionCount
502
16383
2005-04-07 11:17:04
1
?
?
2005-04-07 11:15:03.89
209
1
208
.00
1.70
.05
.00
40
.03
0
0
0
0
0
0
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
QryLogXMLV
MetSLGCount
AbortCount
ErrorCount
RejectedCount
MovedInCount
IntervalDelayCnt
DelayedQueries
208
0
0
0
0
0
0
QryLogXMLV
The QryLogXMLV view allows users to access XML query plan.
View Name
User Type
Columns Selected
DBC.QryLogXMLV
Teradata Database
Administrator
ProcID
CollectTimeStamp
QueryID
XMLRowNo
XMLTextInfo
Corresponding System Table
The corresponding system table for this view is DBC.DBQLXMLTbl.
Example
The following example shows how to use Teradata XML Services to extract query plan
information from the DBC.QryLogXMLV view.
SELECT
cast(t.result_value as char(30)) as "ColumnName"
FROM (SELECT QueryID, XMLTextInfo
FROM DBC.QryLogXMLV
WHERE QueryID = 163833139835340224) as x(QueryID, XMLTextInfo),
table(
sysxml.xmlextractvalues(cast(x.QueryID as varchar(18)), x.XMLTextinfo,
null, '//Field[@JoinAccessFrequency>0]/@Name')) as t
ORDER BY 1;
*** Query completed. 2 rows found. One column returned.
*** Total elapsed time was 1 second.
ColumnName
-----------------------------a1
b1
Data Dictionary
503
Chapter 3: Data Dictionary Views: Usage and Examples
RCC_Configuration[V][X]
RCC_Configuration[V][X]
The RCC_Configuration view is the product of a join on the Events table and the
Configuration table (see “Events[V][X]” on page 463 and “Events_Configuration[V][X]” on
page 466). It provides information about checkpoint statements and client system utility
functions that did not affect all AMPs.
View Name
User Type
Columns Selected
DBC.RCC_Configuration[V][X]
Operations Control
EventNum
LogProcessor
PhyProcessor
Vproc
ProcessorState
RestartSeqNum
Corresponding System Tables
The corresponding system table for DBC.RCC_Configuration[V] is DBC.RCConfiguration.
The corresponding system tables for DBC.RCC_Configuration[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.RCConfiguration
•
DBC.RCEvent
•
DBC.RoleGrants
•
DBC.Roles
The X view also references the userdb view.
Usage Notes
The RCC_Configuration view contains rows for each client system utility function or
CHECKPOINT statement that was executed on a subset of the AMP processors.
504
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
RCC_Media[V][X]
Example
The following SELECT statement selects event and processor information from the
RCC_Configuration view.
==> SELECT EventNum, LogProcessor, PhyProcessor
FROM RCC_Configuration;
EventNum
-------21
75
88
.
.
21
75
.
.
LogProcessor
-----------1
1
1
.
.
2
2
.
.
PhyProcessor
-----------1-0
1-0
1-0
.
.
1-2
1-2
.
.
RCC_Media[V][X]
The RCC_Media view is produced by a join on the Events table and the Media table. It
provides information about a client system utility dump or restore function that created or
used removable media.
View Name
User Type
Columns Selected
DBC.RCC_Media[V][X]
Operations Control
EventNum
VolSerialId
VolSequenceNum
DupeDumpSet
Corresponding System Tables
The corresponding system table for DBC.RCC_Media[V] is DBC.RCMedia.
The corresponding system tables for DBC.RCC_Media[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.RCEvent
•
DBC.RCMedia
•
DBC.RoleGrants
•
DBC.Roles
The X view also references the userdb view.
Data Dictionary
505
Chapter 3: Data Dictionary Views: Usage and Examples
ReconfigDeleteOrderV
Example
The following SELECT statement selects all rows and all columns from the RCC_Media view.
==> SELECT * FROM DBC.RCC_Media;
EventNum
-------21
76
66
19
66
37
77
.
.
VolSerialID
----------KAZ002
RDB003
RDB007
KAZ002
RDB008
MET001
RDB003
.
.
VolSequenceNum
-------------1
1
1
1
2
1
1
.
.
DupeDumpSet
----------N
N
N
N
N
N
N
.
.
ReconfigDeleteOrderV
The ReconfigDeleteOrderV view returns the order in which tables are processed in the
Deletion phase.
View Name
User Type
Columns Selected
DBC.ReconfigDeleteOrderV
All
OrderNumber
DatabaseName
TableName
CheckTableOption
ProcessOffline
Corresponding System Table
The corresponding system table for ReconfigDeleteOrderV is DBC.ReconfigDeleteOrderTbl.
Usage Notes
The ReconfigDeleteOrderV view provides the end users a way to access the
ReconfigDeleteOrderTbl. Users with the appropriate privileges can SELECT, INSERT,
UPDATE, or DELETE on the base table via the view. Note that only SELECT, INSERT,
UPDATE, and/or DELETE should be granted to end users by user DBC.
506
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
ReconfigInfoV
ReconfigInfoV
The ReconfigInfoV view provides status and summary information for Reconfig.
Data Dictionary
View Name
User Type
Columns Selected
DBC.ReconfigInfoV
All
ReconfigId
Description
ReconfigType
BeginTimeStamp
EndTimeStamp
BeginRedistTimeStamp
EndRedistTimeStamp
BeginDelTimeStamp
EndDelTimeStamp
Status
CurrByteCount
CurrTabRedistCount
CurrTabDeleteCount
EstRemainRedistSecs
EstRemainDeleteSecs
AddAmpCount
DelAmpCount
MovAmpCount
ModAmpCount
NodeCount
TotTaskCount
TotTableCount
TotByteCount
TotCatchUpByteCount
TotJournalByteCount
ActualRedistSecs
ActualDeleteSecs
EstRedistSecs
EstDeleteSecs
BeginCalcHBTimeStamp
EndCalcHBTimeStamp
BeginWrSpaceTimeStamp
EndWrSpaceTimeStamp
BeginPHBNewTimeStamp
EndPHBNewTimeStamp
BeginFBHBNewTimeStamp
EndFBHBNewTimeStamp
BeginWrPHBTimeStamp
EndWrPHBTimeStamp
BeginWrFBHBTimeStamp
EndWrFBHBTimeStamp
BeginWrCfgTimeStamp
EndWrCfgTimeStamp
BeginWrCfgNewTimeStamp
EndWrCfgNewTimeStamp
BeginWrBkupIdTimeStamp
507
Chapter 3: Data Dictionary Views: Usage and Examples
ReconfigRedistOrderV
View Name
User Type
Columns Selected
DBC.ReconfigInfoV
(Continued)
All
EndWrBkupIdTimeStamp
BeginWrBMTimeStamp
EndWrBMTimeStamp
BeginDelHBNewTimeStamp
EndDelHBNewTimeStamp
BeginVProcCfgTimeStamp
EndVProcCfgTimeStamp
Corresponding System Table
The corresponding system table for ReconfigInfoV is DBC.ReconfigInfoTbl.
Usage Notes
The ReconfigInfoV view provides the end user a way to access the ReconfigInfoTbl. Users with
the appropriate privileges can SELECT or DELETE from the base table via the view. Note that
only SELECT and/or DELETE privileges should be granted to end users by user DBC.
ReconfigRedistOrderV
The ReconfigRedistOrderV view returns the order in which tables are processed in the
Redistribution phase.
View Name
User Type
Columns Selected
DBC.ReconfigRedistOrderV
All
OrderNumber
DatabaseName
TableName
ProcessOffline
Corresponding System Table
The corresponding system table for ReconfigRedistOrderV is DBC.ReconfigRedistOrderTbl.
Usage Notes
The ReconfigRedistOrderV view provides the end user a way to access the
ReconfigRedistOrderTbl. Users with the appropriate privileges can SELECT, INSERT,
UPDATE, or DELETE on the base table via the view. Note that only SELECT, INSERT,
UPDATE, and/or DELETE should be granted to end users by user DBC.
508
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
ReconfigTableStatsV
ReconfigTableStatsV
The ReconfigTableStatsV provides statistics collected on each table during the Redistribution
Phase and the Deletion Phase of a RCC_Configuration.
Data Dictionary
View Name
User Type
Columns Selected
DBC.ReconfigTableStatsV
All
DatabaseName
TableName
ReconfigId
Phase
Status
BeginTimeStamp
EndTimeStamp
TotRowCount
TotByteCount
TotCPUSecs
TotIOCount
LowRowCount
LowRowCountAmp
HighRowCount
HighRowCountAmp
LowByteCount
LowByteCountAmp
HighByteCount
HighByteCountAmp
LowCPUSecsCount
LowCPUSecsCountAmp
HighCPUSecsCount
HighCPUSecsCountAmp
LowIOCount
LowIOCountAmp
HighIOCount
HighIOCountAmp
NUSICount
FallBackFlag
DBlockSize
PartitionCount
ActualRedistSecs
ActualDeleteSecs
EstRedistSecs
EstDeleteSecs
FSGIOCount
FSysReadCount
FSysWriteCount
FSysMiscCount
MsgRcvCount
MsgSendCount
MsgMiscCount
509
Chapter 3: Data Dictionary Views: Usage and Examples
RepCaptureRulesV
View Name
User Type
Columns Selected
DBC.ReconfigTableStatsV
(Continued)
All
MsgWaitRcvTime
MsgWaitSendTime
MsgWaitMiscTime
NoMemFlushCount
CkptFlushCount
Corresponding System Table
The corresponding system table for ReconfigTableStatsV is DBC.ReconfigTableStatsTbl.
Usage Notes
The ReconfigTableStatsV view provides the end user a way to access the
ReconfigTableStatsTbl. Users with the appropriate privileges can SELECT or DELETE from
the base table via the view. Note that only SELECT and/or DELETE privileges should be
granted to end users by user DBC.
RepCaptureRulesV
The RepCaptureRulesV view provides information regarding all replication capture rules
defined in the system.
View Name
User Type
Columns Selected
DBC.RepCaptureRulesV
All
RuleSetName
GroupName
ObjectKind
DefaultOpt
LikePattern
LikeEscape
NotLikePattern
NotLikeEscape
Corresponding System Tables
The corresponding system tables for RepCaptureRulesV are:
510
•
DBC.RepRulesetTbl
•
DBC.RepCaptureRulesTbl
•
DBC.RepGroup
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
RepCaptureRulesV
Example 1
The following SELECT statement selects all non-default rules defined for a table object.
==> SELECT GroupName, RulesetName, LikePattern, LikeEscape,
NotLikePattern, NotLikeEscape
FROM DBC.RepCaptureRulesV
WHERE DefaultOpt = 'N' AND ObjectKind = 'T'
ORDER BY GroupName, RulesetName, LikePattern, LikeEscape,
NotLikePattern, NotLikeEscape;
*** Query completed. 2 rows found. 6 columns returned.
*** Total elapsed time was 1 second.
GroupName
RuleSetName
LikePattern
LikeEscape
NotLikePattern
NotLikeEscape
GroupName
RuleSetName
LikePattern
LikeEscape
NotLikePattern
NotLikeEscape
repgroup
prmtablers
repuser.prmtab%
?
?
?
repgroup
subtablers
repuser.subtab%
?
repuser.subtabx%
?
Example 2
The following SELECT statement selects all query rules defined for the replication group ‘G1’.
==> SELECT RuleSetName, ObjectKind, LikePattern, LikeEscape,
NotLikePattern, NotLikeEscape
FROM DBC.RepCaptureRulesV
WHERE GroupName = 'G1'
ORDER BY ObjectKind, RuleSetName;
*** Query completed. One row found. 6 columns returned.
*** Total elapsed time was 1 second.
RuleSetName
ObjectKind
LikePattern
LikeEscape
NotLikePattern
NotLikeEscape
Data Dictionary
r1
T
sr.rep%
?
?
?
511
Chapter 3: Data Dictionary Views: Usage and Examples
RepTables[V][X]
RepTables[V][X]
The RepTables view returns all the replication groups defined in the system and all their
member tables.
View Name
User Type
Columns Selected
DBC.RepTables[V][X]
All
GroupName
TableName
Corresponding System Table
The corresponding system tables for RepTables[V][X] are:
•
DBC.TVM
•
DBC.RepGroup
ResolvedDTSV[X]
The ResolvedDTSV view returns the last reconciled date and timestamp associated with a
table or join index.
View Name
User Type
Columns Selected
DBC.ResolvedDTSV[X]
All users
ResolvedCurrent_Date
ResolvedCurrent_TimeStamp
TableName
DatabaseName
Corresponding System Tables
The corresponding system tables for DBC.ResolvedDTSV[X] are:
•
DBC.DBase
•
DBC.TableConstraints
•
DBC.TVM
Example
The following SELECT statement selects the last resolved date from the ResolvedDTSV view.
==> SELECT ResolvedCurrent_Date
FROM ResolvedDTSV
WHERE TableName='Customer'
AND DatabaseName='Sales'
AND ResolvedCurrent_Date IS NOT NULL;
512
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
RestrictedWords[V]
*** Query completed. One row found. One column returned.
*** Total elapsed time was 1 second.
ResolvedCurrent_Date
-------------------09/01/01
RestrictedWords[V]
The RestrictedWords view returns a list of words that can be restricted from being part of a
password string.
For a complete list of restricted words, see Security Administration.
View Name
User Type
Columns Selected
DBC.RestrictedWords[V]
All
RestrictedWord
Corresponding System Table
The corresponding system table for RestrictedWords[V] is DBC.PasswordRestrictions.
RI_Child_Tables[V][X]
The RI_Child_Tables view provides information about tables in child-parent order. It is
similar to the All_RI_Children view but returns the internal IDs of databases, tables, and
columns instead of names.
Data Dictionary
View Name
User Type
Columns Selected
DBC.RI_Child_Tables[V][X]
All users
IndexID
IndexName
ChildDbID
ChildTID
ChildKeyFID
ParentDbID
ParentTID
ParentKeyFID
InconsistencyFlag
CreatorName
CreateTimeStamp
VTFKType
TTFKType
VTPKType
TTPKType
513
Chapter 3: Data Dictionary Views: Usage and Examples
RI_Distinct_Children[V][X]
Corresponding System Tables
The corresponding tables for DBC.RI_Child_Tables[V] is DBC.ReferencingTbl.
The corresponding tables for DBC.RI_Child_Tables[V]X are:
•
DBC.AccessRights
•
DBC.Dbase
•
DBC.Owners
•
DBC.ReferencingTbls
•
DBC.RoleGrants
•
DBC.Roles
Usage Notes
The RI_Child_Tables view is similar to the All_RI_Children view but returns the IDs of
databases, tables, and columns instead of the names for access control purposes. The
administrator can control who has access to internal ID numbers by limiting the access to the
RI_Child_Tables view while allowing more (or all) users to access the names via the
All_RI_Children view.
RI_Distinct_Children[V][X]
The RI_Distinct_Children view provides information about tables in child-parent order
without the duplication that could result from multi-column foreign keys.
View Name
User Type
Columns Selected
DBC.RI_Distinct_Children[V][X]
All users
IndexID
IndexName
ChildDB
ChildTable
ParentDB
ParentTable
InconsistencyFlag
CreatorName
CreateTimeStamp
Corresponding System Tables
The corresponding system tables for DBC.RI_Distinct_Children[V] are:
514
•
DBC.DBase
•
DBC.ReferencingTbls
•
DBC.TVM
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
RI_Distinct_Parents[V][X]
The corresponding system tables for DBC.RI_Distinct_Children[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.ReferencingTbls
•
DBC.RoleGrants
•
DBC.Roles
•
DBC.TVM
RI_Distinct_Parents[V][X]
The RI_Distinct_Parents view provides information about tables in parent-child order
without the duplication that could result from multi-column foreign keys.
View Name
User Type
Columns Selected
DBC.RI_Distinct_Parents[V][X]
All users
IndexID
IndexName
ParentDB
ParentTable
ChildDB
ChildTable
InconsistencyFlag
CreatorName
CreateTimeStamp
Corresponding System Tables
The corresponding system tables for DBC.RI_Distinct_Parents[V] are:
•
DBC.Dbase
•
DBC.ReferencedTbls
•
DBC.TVM
The corresponding system tables for DBC.RI_Distinct_Parents[V]X are:
Data Dictionary
•
DBC.AccessRights
•
DBC.Dbase
•
DBC.Owners
•
DBC.ReferencedTbls
•
DBC.RoleGrants
•
DBC.Roles
•
DBC.TVM
515
Chapter 3: Data Dictionary Views: Usage and Examples
RI_Parent_Tables[V][X]
RI_Parent_Tables[V][X]
The RI_Parent_Tables view provides information about all tables in parent-child order.
View Name
User Type
Columns Selected
DBC.RI_Parent_Tables[V][X]
All users
IndexID
IndexName
ParentDbID
ParentTID
ParentKeyFID
ChildDbID
ChildTID
ChildKeyFID
InconsistencyFlag
CreatorName
CreateTimeStamp
VTPKType
TTPKType
VTFKType
TTFKType
Corresponding System Tables
The corresponding system table for DBC.RI_Parent_Tables[V] is DBC.ReferencedTbls.
The corresponding system tables for DBC.RI_Parent_Tables[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.ReferencedTbls
•
DBC.RoleGrants
•
DBC.Roles
Usage Notes
The RI_Parent_Tables view is similar to the All_RI_Parents view but returns the IDs of
databases, tables, and columns instead of the names for access control purposes.
The administrator can control who has access to internal ID numbers by limiting the access to
the RI_Parent_Tables view while allowing more (or all) users to access the names via the
All_RI_Parents view.
516
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
RoleInfo[V][X]
RoleInfo[V][X]
The RoleInfo view returns the names of the role creators corresponding to each role.
View Name
User Type
Columns Selected
DBC.RoleInfo[V][X]
Teradata Database
Security Administrator
RoleName
CreatorName
CommentString
CreateTimeStamp
ExtRole
[X]End User
Corresponding System Table
The corresponding system table for this view is DBC.Dbase.
Example
The following SELECT statement returns the names of the role creators:
==> SELECT rolename (char(8)), creatorname (char(8)), commentstring
(char(20)), createtimestamp, ExtRole from DBC.Roleinfo;
*** Query completed. 2 rows found. 4 columns returned.
*** Total elapsed time was 1 second.
RoleName
-------r1
CreatorName
----------u1
CommentString
-------------------Comments on r1
CreateTimeStamp
ExtRole
------------------- ------2002-08-13 10:26:19 N
r2
u2
Comments on r2
2002-08-13 10:26:25 Y
RoleMembers[V][X]
The RoleMembers view lists each role that has members and all of its members. The
RoleMembersX view lists all roles, if any, directly granted to the user.
View Name
User Type
Columns Selected
DBC.RoleMembers[V][X]
Teradata Database
Security
Administrator
RoleName
Grantee
GranteeKind
Grantor
WhenGranted
DefaultRole
WithAdmin
[X]End User
Corresponding System Tables
The corresponding system tables for this view are:
Data Dictionary
517
Chapter 3: Data Dictionary Views: Usage and Examples
SecurityDefaults[V]
•
DBC.Dbase
•
DBC.RoleGrants
•
DBC.Roles
Usage Notes
The RoleMembersX view does not have the Grantee and GranteeKind columns.
Roles without members are excluded from the result set of RoleMembers.
Example
The following query lists all roles and their members:
SELECT CAST(rolename AS CHAR(15)),
CAST(grantee AS CHAR(20)),
CAST(grantor AS CHAR(20)),
whengranted
FROM DBC.RoleMembers ORDER BY 1,2;
*** Query completed. 113 rows found.
*** Total elapsed time was 1 second.
RoleName
---------role_a
role_a
role_b
. . .
Grantee
-------user_1
user_2
user_1
. . .
Grantor
-------DBA
DBA
SysFe
. . .
4 columns returned.
WhenGranted
-------------------97-10-15 14:32:59
97-10-15 11:00:01
98-04-24 09:10:15
. . .
SecurityDefaults[V]
The SecurityDefaults view describes the password features selected for the site.
View Name
User Type
Columns Selected
DBC.SecurityDefaults[V]
Teradata Database
Security
Administrator
ExpirePassword
PasswordMinChar
PasswordMaxChar
PasswordDigits
PasswordSpecChar
PasswordRestrictWords
MaxLogonAttempts
LockedUserExpire
PasswordReuse
Corresponding System Table
The corresponding system table for this view is DBC.SysSecDefaults.
518
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
SecurityLog[V][X]
Related Topics
For more information on controlling access, space, and ownership, see the following manuals:
•
Database Administration
•
Database Design
•
Security Administration
SecurityLog[V][X]
The SecurityLog view provides a subset of the information available through the AccessLog
view. It is retained to provide compatibility with earlier releases.
View Name
User Type
Columns Selected
DBC.SecurityLog[V][X]
Teradata Database
Security
Administrator
LogDate
LogTime
LogType
UserName
AccountName
DatabaseName
TableName
Text
Corresponding System Tables
The corresponding system table for DBC.SecurityLog[V] is DBC.AccLogTbl.
The corresponding system tables for DBC.SecurityLog[V]X are:
•
DBC.AccLogTbl
•
DBC.DBase
•
DBC.Owners
This view also references the userdb view.
Note: Note that the column named DatabaseName was previously named ObjectName.
Usage Notes
For an explanation of the BEGIN/END LOGGING statements, see Security Administration.
Data Dictionary
519
Chapter 3: Data Dictionary Views: Usage and Examples
SessionInfo[V][X]
SessionInfo[V][X]
The SessionInfo view provides information about users who are currently logged on.
View Name
User Type
Columns Selected
DBC.SessionInfo[V][X]
Teradata Database
Administrator
UserName
AccountName
SessionNo
DefaultDatabase
IFPNo
Partition
LogicalHostId
HostNo
CurrentCollation
LogonDate
LogonTime
LogonSequenceNo
LogonSource
ExpiredPassword
TwoPCMode
Transaction_Mode
CurrentRole
ProfileName
LogonAcct
LDAP
AuditTrailId
CurIsolationLevel
QueryBand
ProxyUser
ProxyCurRole
TemporalQualifier
Teradata Database
Security Administrator
Supervisory
[X]End User
Corresponding System Table
The corresponding system table for this view is DBC.SessionTbl.
Usage Notes
Information about current session pools, which are a collection of sessions that are logged on
to the Teradata Database under the same logonid, may be accessed by entering the DISPLAY
POOL command. For more information on DISPLAY POOL, see Teradata Director Program
Reference.
Note that AccountName is the current unexpanded account name for the session.
520
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
ShowColChecks[V][X]
Example
The following SELECT statement displays information on all current sessions:
==> SELECT UserName, SessionNo, DefaultDatabase, LogonSource
FROM DBC.SessionInfo;
UserName SessionNo DefaultDatabase LogonSource
--------- --------- --------------- ---------------------------DBC
1,005
DBC
<TCP/IP> EB9F 141.206.1.84
Example: LogonSource
The following screen displays LogonSource information from the current sessions:
==>sel logonsource from dbc.sessiontbl;
(TCP/IP) EB9F 141.206.1.84 L3PC024 21767 BC120317 BTEQ 0
ShowColChecks[V][X]
The ShowColChecks view provides information about column constraints.
View Name
User Type
Columns Selected
DBC.ShowColChecks[V][X]
End User
DatabaseName
TableName
ColumnName
ColCheck
CreatorName
CreateTimeStamp
TimeDimension
VTCheckType
TTCheckType
Teradata Database
Administrator
Corresponding System Tables
The corresponding system tables for DBC.ShowColChecks[V] are:
•
DBC.DBase
•
DBC.TVFields
•
DBC.TVM
The corresponding system tables for DBC.ShowColChecks[V]X are:
Data Dictionary
•
DBC.DBase
•
DBC.Owners
•
DBC.RoleGrants
•
DBC.Roles
•
DBC.TVFields
•
DBC.TVM
521
Chapter 3: Data Dictionary Views: Usage and Examples
ShowTblChecks[V][X]
ShowTblChecks[V][X]
The ShowTblChecks view provides information about table constraints.
If you look at the ShowTblChecks view and the Table_LevelConstraints view, they have the
same columns selected. The main difference is ShowTblChecks selects the uppercased
databasename and tablename while Table_LevelConstraints selects the databasename and
tablename as they were entered by the user. Also the column names are named with some
differences.
View Name
User Type
Columns Selected
DBC.ShowTblChecks[V][X]
End User
DatabaseName
TableName
CheckName
TblCheck
CreatorName
CreateTimeStamp
VTCheckType
TTCheckType
ResolvedCurrent_Date
ResolvedCurrent_TimeStamp
Teradata Database
Administrator
Corresponding System Tables
The corresponding system tables for DBC.ShowTblChecks[V] are:
•
DBC.DBase
•
DBC.TableContraints
•
DBC.TVM
The corresponding system tables for DBC.ShowTblChecks[V]X are:
522
•
DBC.DBase
•
DBC.Owners
•
DBC.RoleGrants
•
DBC.Roles
•
DBC.TableConstraints
•
DBC.TVM
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
Software_Event_Log[V]
Software_Event_Log[V]
The Software_Event_Log view provides information about logged software events originating
in the Parallel Data Extensions (PDE) or the Teradata Database.
View Name
User Type
Columns Selected
DBC.Software_Event_Log[V]
Operations Control
TheDate
TheTime
Event_Tag
Category
Severity
PMA
Vproc
Partition
Task
TheFunction
SW_Version
Line
Text
Corresponding System Table
The corresponding system table for this view is DBC.SW_Event_Log.
Usage Notes
For Database Query Manager, the following fields are not used:
Data Dictionary
•
Category
•
Severity
•
PMA
•
Vproc
•
Partition
•
Task
•
TheFunction
•
SW_Version
523
Chapter 3: Data Dictionary Views: Usage and Examples
Table_LevelConstraints[V][X]
Example
The following statement requests the software event log information for any event with a
severity level of 50 (unrecoverable user error, no user restart):
SELECT TheDate, TheTime, Category, Severity
FROM Software_Event_Log
Where Severity = ‘50’ ;
The result has the following form:
TheDate
-------92/08/20
TheTime
-------10:10:30
Category
-------4
Severity
-------50
Table_LevelConstraints[V][X]
The Table_LevelConstraints view provides information about table constraints.
If you look at the ShowTblChecks view and the Table_LevelConstraints view, they have the
same columns selected. The main difference is ShowTblChecks selects the uppercased
databasename and tablename while Table_LevelConstraints selects the databasename and
tablename as they were entered by the user. Also, the column names are named with some
differences.
View Name
User Type
Columns Selected
DBC.Table_LevelConstraints[V][X]
End User
DatabaseName
TableName
ConstraintName
ConstraintText
CreatorName
CreateTimeStamp
VTCheckType
TTCheckType
ResolvedCurrent_Date
ResolvedCurrent_TimeStamp
Teradata Database
Administrator
Corresponding System Tables
The corresponding system tables for DBC.Table_LevelConstraints[V] are:
524
•
DBC.DBase
•
DBC.TableContraints
•
DBC.TVM
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
Tables[V][X]
The corresponding system tables for DBC.Table_LevelConstraints[V]X are:
•
DBC.DBase
•
DBC.Owners
•
DBC.RoleGrants
•
DBC.Roles
•
DBC.TableContraints
•
DBC.TVM
Tables[V][X]
The Tables view provides information about tables, views, stored procedures, join indexes,
macros, user-defined types, user-defined methods, and user-defined functions.
View Name
User Type
Columns Selected
DBC.Tables[V][X]
[X]End User
DatabaseName
TableName
Version
TableKind
ProtectionType
JournalFlag
CreatorName
RequestText
CommentString
ParentCount
ChildCount
NamedTblCheckCount
UnnamedTblCheckExist
PrimaryKeyIndexId
RepStatus
CreateTimeStamp
LastAlterName
LastAlterTimeStamp
RequestTxtOverFlow
AccessCount
LastAccessTimeStamp
UtilVersion
QueueFlag
CommitOpt
TransLog
CheckOpt
TemporalProperty
ResolvedCurrent_Date
ResolvedCurrent_Timestamp
SystemDefinedJI
VTQualifier
TTQualifier
Teradata Database
Administrator
Data Dictionary
525
Chapter 3: Data Dictionary Views: Usage and Examples
Tables[V][X]
Corresponding System Tables
The corresponding system tables for DBC.Tables[V] are:
•
DBC.DBase
•
DBC.TVM
The corresponding system tables for DBC.Tables[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.RoleGrants
•
DBC.Roles
•
DBC.TVM
Note: The DBC.TVM table contains one row for each table, view, stored procedures, join
indexes, macros, user-defined types, user-defined methods, or user-defined functions.
Usage Notes
The RequestText data reflects the definitions specified by the user. This may not always match
the data returned by the SHOW TABLE statement, which reflects the reconstructed
definitions as they exist in the Teradata Database Data Dictionary.
For example, when obsolete syntax that is still supported is converted internally to current
syntax, RequestText returns the submitted (obsolete) syntax, while SHOW TABLE returns the
converted (current) syntax.
If the table is renamed, the RequestText still contains the old table name. The new table name
is not put in the RequestText.
The UtilVersion column may be zero or null for tables created prior to V2R6.0. For tables
created in V2R6.0 or later, both Version and UtilVersion are initially one.
The following table shows when the UtilVersion column is modified, and how it’s modified:
New Value or
UtilVersion
UtilVersion Current Value
Data Definition Change
Any value
Significant change (by an ALTER TABLE
statement) to keep an archive from being
restored or copied.
= Version
Null or zero
Not significant
Version -1
Any other value
Not significant
No change
The Version column is increased by one for any data definition change other than enabling or
disabling journaling for the table. Version in the above table is the version after it’s been
incremented.
526
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
Tables2[V][X]
The following table shows how the UtilVersion column is checked when selected partitions are
restored or copied:
UtilVersion Value
Requirements
Null or zero
The Version of the archive must match the Version of the table.
Any other value
If the archive UtilVersion is zero, the Version of the Archive must
match the UtilVersion of the table; otherwise, the UtilVersion
column of the archive must equal the UtilVersion of the table.
Note: To restore or copy selected partitions, the table must already exist.
Example
The following SELECT statement displays information about tables, views, and macros in the
Personnel database.
==> SELECT TableName,CreatorName,TableKind,ProtectionType FROM
DBC.Tables WHERE DatabaseName = ’Personnel’ ;
TableName
-----------NewEmp
EmployeeInfo
Employee
Department
Project
Charges
CreatorName
----------GREENE
GREENE
DBC
DBC
JONES
JONES
TableKind
--------M
V
T
T
T
T
ProtectionType
-------------F
F
F
F
F
F
Tables2[V][X]
The Tables2 view provides ID definition and RI count information about tables. It is similar to
the Tables view but includes the ID of the table and database instead of the other information
(Version, TableKind, and so forth) provided by the Tables view.
View Name
User Type
Columns Selected
DBC.Tables2[V][X]
Teradata Database
Administrator
TVMName
TVMId
DatabaseId
ParentCount
ChildCount
Supervisory
Corresponding System Table
The corresponding system table for DBC.Tables2[V] is DBC.TVM.
The corresponding system tables for DBC.Tables2[V]X are:
Data Dictionary
527
Chapter 3: Data Dictionary Views: Usage and Examples
TableSize[V][X]
•
DBC.AccessRights
•
DBC.Owners
•
DBC.RoleGrants
•
DBC.Roles
•
DBC.TVM
TableSize[V][X]
The TableSize view provides AMP-by-AMP vproc information about disk space usage (not
including spool) for each database, table (including journal tables), stored procedure, join
index, hash index, or account.
View Name
User Type
Columns Selected
DBC.TableSize[V][X]
End User
Vproc
DatabaseName
AccountName (unexpanded account name)
TableName
CurrentPerm
PeakPerm
Teradata Database
Administrator
Corresponding System Tables
The corresponding system tables for DBC.TableSize[V] are:
•
DBC.DatabaseSpace
•
DBC.DBase
•
DBC.TVM
The corresponding system tables for DBC.TableSize[V]X are:
•
DBC.AccessRights
•
DBC.DatabaseSpace
•
DBC.DBase
•
DBC.Owners
•
DBC.RoleGrants
•
DBC.Roles
•
DBC.TVM
Usage Notes
When a database or table is created, the allocated disk space is divided evenly among all AMPs.
The TableSize view returns one row of usage information for each AMP in the Teradata
Database (or for all AMPs if the SUM aggregate is used).
528
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
TableText[V][X]
Example
The following SELECT statement is used to contrast the total disk space currently being used
by the Employee table with its peak usage figure.
==> SELECT SUM(PeakPerm), SUM(CurrentPerm)
FROM DBC.TableSize WHERE TableName=’Employee’ ;
Sum(PeakPerm)
------------260,608
Sum(CurrentPerm)
---------------260,608
TableText[V][X]
The TableText view provides complete RequestText for an object of T, V, and M kinds when
the RequestTxtOverFlow in the TVM for the object is set to ’R.’
View Name
User Type
Columns Selected
DBC.TableText[V][X]
End User
DatabaseName
TableName
TableKind
RequestText
LineNo
Teradata Database
Administrator
Corresponding System Tables
The corresponding system tables for DBC.TableText[V] are:
•
DBC.DBase
•
DBC.TextTbl
•
DBC.TVM
The corresponding system tables for DBC.TableText[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.RoleGrants
•
DBC.Roles
•
DBC.TextTbl
•
DBC.TVM
Usage Notes
The Request Text data reflects the definitions specified by the user for the object.
Data Dictionary
529
Chapter 3: Data Dictionary Views: Usage and Examples
Triggers[V][X]
IF the request text …
THEN the request text is saved in …
is up to 12500 characters
TVM
exceeds 12500 characters
DBC.TextTbl
The RequestTxtOverFlow flag is set to ’R.’
This view returns the complete text of the object
definition.
Note: Users do not need to use this view if there is
no overflow in TVM.
The Request Text for an object could be stored in one or more rows depending on the size of
the text. The LineNo column provides the sequence of multiple rows stored in the TextTbl for
the object.
To put the text in a proper sequence, the user should select the text using ORDER BY clause
on LineNo from this view.
Example
The following SELECT statement displays information about tables, views, and macros in the
Personnel database, assuming that text for the database object is more than 12500 characters.
SELECT TableName,TableKind, LineNo, RequestText( char(50)) FROM
DBC.TableText WHERE DatabaseName = 'Personnel' ORDER BY TableName,
LineNo;
Triggers[V][X]
The Triggers view provides information about event-driven, specialized procedures attached
to a single table and stored in the database.
530
View Name
User Type
Columns Selected
DBC.Triggers[V][X]
Teradata Database
Administrator
DatabaseName
SubjectTableDatabaseName
TableName
TriggerName
EnabledFlag
ActionTime
Event
Kind
OrderNumber
TriggerComment
RequestText
CreatorName
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
Triggers[V][X]
View Name
User Type
Columns Selected
DBC.Triggers[V][X]
(Continued)
Teradata Database
Administrator
CreateTimeStamp
LastAlterName
LastAlterTimeStamp
AccessCount
LastAccessTimeStamp
CreateTxtOverflow
VTEventType
TTEventType
Corresponding System Tables
The corresponding system tables for DBC.Triggers[V] are:
•
DBC.DBase
•
DBC.TriggersTbl
•
DBC.TVM
The corresponding system tables for DBC.Triggers[V]X are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.RoleGrants
•
DBC.Roles
•
DBC.TriggersTbl
•
DBC.TVM
Usage Notes
A trigger is defined by a CREATE TRIGGER data definition statement. An INSERT, UPDATE,
or DELETE statement on the specified table whether directly or through a view based on the
specified table causes the database to execute the trigger.
Triggers can be of two types: ROW or STATEMENT. When a triggered statement fires a
trigger, cascading ensues that can, in some instances, fire other triggers and become triggering
statements.
Data Dictionary
531
Chapter 3: Data Dictionary Views: Usage and Examples
UserGrantedRights[V]
Example 1For more information on triggers, see SQL Data Definition Language.
Example 2
The following SELECT returns the following:
•
Name of the database in which the triggering table is defined for those cases in which a
trigger is defined in a different database than the triggering table
•
Names of the triggering tables
•
Names of the database in which the trigger is defined
•
Trigger names
This query identifies those triggers for which the trigger must be dropped if the database
containing the triggering table is deleted.
SELECT SubjectTableDatabaseName, TableName, DatabaseName, TriggerName
FROM Triggers
WHERE DatabaseName <> SubjectTableDatabaseName
ORDER BY 1, 2, 3, 4;
Example 3
This query identifies those triggers for which the trigger must be dropped if the database
containing the triggering table is deleted.
SELECT SubjectTableDatabaseName, TableName, DatabaseName, TriggerName
FROM Triggers
WHERE DatabaseName <> SubjectTableDatabaseName
ORDER BY 1, 2, 3, 4;
UserGrantedRights[V]
The UserGrantedRights view provides information about objects on which the current user
has explicitly granted privileges to other users.
View Name
User Type
Columns Selected
DBC.UserGrantedRights[V]
End User
DatabaseName
TableName
ColumnName
Grantee
AccessRight
GrantAuthority
AllnessFlag
CreatorName
CreateTimeStamp
Corresponding System Tables
The corresponding system tables for this view are:
532
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
UserRights[V]
•
DBC.AccessRights
•
DBC.DBase
•
DBC.TVFields
•
DBC.TVM
This view also references the ownerdb view.
Example
The following SELECT statement displays all privileges that the current user has granted to
other users.
==> SELECT DatabaseName,TableName,Grantee,AccessRight
FROM DBC.UserGrantedRights;
DatabaseName
-----------Personnel
Personnel
TableName
--------Employee
Employee
Grantee
------Greene
Greene
Personnel
Employee
Greene
AccessRight
----------R
U
I
UserRights[V]
The UserRights view provides information about objects on which the user has explicitly or
automatically been granted privileges including the following: tables, views, join indexes,
columns, stored procedures, macros, user-defined types, user-defined methods, or userdefined functions.
View Name
User Type
Columns Selected
DBC.UserRights[V]
End User
DatabaseName
TableName
ColumnName
AccessRight
GrantAuthority
GrantorName
CreatorName
CreateTimeStamp
Corresponding System Tables
Corresponding system tables for this view include the following:
Data Dictionary
•
DBC.AccessRights
•
DBC.DBase
•
DBC.TVFields
•
DBC.TVM
533
Chapter 3: Data Dictionary Views: Usage and Examples
UserRoleRights[V]
This view also references the userdb view.
Usage Notes
To display the privileges that the user has been granted on database D, the SELECT statement
must specify:
WHERE DatabaseName = ’D’ AND TableName = ’All’ ;
If privileges have been granted on the database, a row is returned for each privilege.
The UserRights view does not return information about implicit privileges of a user due to
ownership of objects, nor does it return information about privileges inherited by a user from
PUBLIC or roles.
To obtain information about privileges inherited from roles, use the view UserRoleRights. For
implicit privileges, use the views Children[X] and Tables[X] to determine all the objects
owned by a user.
Example
The following SELECT statement displays information about all tables in the Personnel
database on which privileges were granted to the requesting user.
==> SELECT * FROM DBC.UserRights
WHERE DatabaseName=’Personnel’
AND TableName = ’All’ ;
DatabaseName
-----------Personnel
Personnel
Personnel
TableName
--------Employee
Employee
Employee
AccessRight
----------R
U
I
GrantorName
----------DBC
DBC
DBC
UserRoleRights[V]
The UserRoleRights view lists all privileges granted to the current role of the user and its
nested roles.
534
View Name
User Type
Columns Selected
DBC.UserRoleRights[V]
End User
RoleName
DatabaseName
TableName
ColumnName
AccessRight
GrantorName
CreateTimeStamp
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
UserRoleRights[V]
Corresponding System Tables
The corresponding system tables for this view are:
•
DBC.AccessRights
•
DBC.Dbase
•
DBC.Roles
•
DBC.TVFields
•
DBC.TVM
Usage Notes
The UserRoleRights view is similar to the AllRoleRights view. However, UserRoleRights has
additional WHERE conditions that restrict the result set to rows belonging to the current role
of the user and all roles nested within that.
Example
The following SELECT statement returns all privileges granted to the current role of the user
and the roles nested within the current role.
==> SELECT CAST(RoleName as CHAR(16)) as RoleName,
CAST(DatabaseName as CHAR(15)) as Databases,
CAST(TableName as CHAR(15)) as TVMs --,
CAST(ColumnName as CHAR(10)) as Columns,
CAST(AccessRight as CHAR(5)) as AccRights,
CAST(GrantorName as CHAR(15)) as Grantor
FROM DBC.UserRoleRights
ORDER BY 1,2,3,5;
*** Query completed. 2 rows found. 5 columns returned.
*** Total elapsed time was 1 second.
RoleName
-------------roles017_r1f
roles017_r2d
Data Dictionary
Databases
--------------roles017_3_db
roles017_3_db
TVMs
--------------roles017_3_v2
roles017_3_v2
AccRights
--------R
R
Grantor
--------roles017_3
roles017_3
535
Chapter 3: Data Dictionary Views: Usage and Examples
Users[V]
Users[V]
The Users view provides information about username space that the requesting user created
or owns.
View Name
User Type
Columns Selected
DBC.Users[V]
End User
UserName
CreatorName
PasswordLastModDate
PasswordLastModTime
OwnerName
PermSpace
SpoolSpace
TempSpace
ProtectionType
JournalFlag
StartupString
DefaultAccount
DefaultDatabase
CommentString
DefaultCollation
PasswordChgDate
LockedDate
LockedTime
LockedCount
TimeZoneHour
TimeZoneMinute
DefaultDateForm
CreateTimeStamp
LastAlterName
LastAlterTimeStamp
DefaultCharType
RoleName
ProfileName
AccessCount
LastAccessTimeStamp
Teradata Database
Administrator
Supervisory
Corresponding System Tables
The corresponding system tables for this view are:
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
•
DBC.Profiles
This view also references the userdb view.
536
Data Dictionary
Chapter 3: Data Dictionary Views: Usage and Examples
User_Default_Journals[V][X]
Usage Notes
The default account name is the unexpanded account name that is defined as the default for
the user.
This may be overridden by the default account in the profile if the user is assigned to a profile
when the user logs on. During a session, the account name may be changed. For the current
account name of the session, see SessionInfo[X].
Example
The following SELECT statement displays information about all users owned or created by the
current user, Jones.
==> SELECT UserName,CreatorName,PermSpace,SpoolSpace
FROM DBC.Users;
UserName
CreatorName
PermSpace
SpoolSpace
----------------------------------Jones
sysadmin
1,000,000
1,000,000
Peterson
Jones
100,000
1,000,000
Moffit
Jones
100,000
1,000,000
Chin
Jones
100,000
1,000,000
Greene
Jones
100,000
1,000,000
Related Topics
See Database Design for more information on controlling access, space, and ownership.
User_Default_Journals[V][X]
The User_Default_Journals view provides information on user databases that have a default
journal specification.
View Name
User Type
Columns Selected
DBC.User_Default_Journals[V][X]
[X]End User
UserName
Journal_DB
JournalName
Teradata Database
Administrator
Corresponding System Tables
The corresponding system tables for DBC.User_Default_Journals[V] are:
•
DBC.DBase
•
DBC.TVM
The corresponding system tables for DBC.User_Default_Journals[V]X are:
Data Dictionary
•
DBC.AccessRights
•
DBC.DBase
•
DBC.Owners
537
Chapter 3: Data Dictionary Views: Usage and Examples
User_Default_Journals[V][X]
•
DBC.RoleGrants
•
DBC.Roles
•
DBC.TVM
Usage Notes
A journal table need not reside in the user space that it serves.
Example
The following SELECT statement selects information on each user database to which the
requesting user has access, and for which a default journal table is defined.
==> SELECT * FROM DBC.User_Default_JournalsX;
UserName
-------Usr1
Usr2
Usr3
538
Journal_DB
---------Usr1
Usr2
Usr3
JournalName
----------Usr1Jrnl
Usr2Jrnl
Usr3Jrnl
Data Dictionary
CHAPTER 4
Data Dictionary Tables
The following sections list the system tables contained by user DBC. The primary and
secondary indexes are indicated for each table.
Table Column Formats
Some column formats are explicit, while others are not. "Explicit" means that the format
string is specified by the Table Initializer program. When "explicit" is not specified, the format
is taken from the default format for the data type for the column.
AccessRights
Contains the privilege for users and databases.
Columns
Referenced Column(s)
Data Type
Format
UserId (Composite NUPI)
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
DatabaseId (Composite
NUPI)
Dbase.DatabaseId
TVM.DatabaseId
TVMId (NUSI)
TVM.TVMId
TVFields.Tableid
BYTE(6) NOT NULL
X(12)
FieldId
TVFields.Fieldid
SMALLINT NOT NULL
---,--9 (explicit)
AccessRight
None
CHAR(2) LATIN UPPERCASE
NOT CASESPECIFIC NOT
NULL
X(2)
WithGrant
None
CHAR(1) LATIN
UPPERCASE NOT
CASESPECIFIC NOT NULL
X(1)
GrantorID
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
AllnessFlag
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT
NULL
X(1)
CreateUID
Dbase.DatabaseId
BYTE(4)
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
None
INTEGER
--,---,---,--9 (explicit)
LastAccessTimeStamp
AccessCount
Data Dictionary Quick Reference
539
Chapter 4: Data Dictionary Tables
Table Column Formats
AccLogRuleTbl
Controls the logging of access privilege checks for the specified users or references to the
specified objects.
Columns
Referenced Column(s)
Data Type
Format
UserID (Composite UPI)
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
TVMId (Composite UPI)
TVM.TVMId
BYTE(6) NOT NULL
X(12)
ColumnId (Composite
UPI)
TVFields.FieldId
SMALLINT NOT NULL
---,--9 (explicit)
AcrCheckPoint
None
CHAR(3) LATIN NOT
CASESPECIFIC NOT NULL
X(3)
DatabaseID (Composite
UPI)
AcrCreateDataBase
AcrCreateMacro
AcrCreateTable
AcrCreateUser
AcrCreateView
AcrDelete
AcrDropDatabase
AcrDropMacro
AcrDropTable
AcrDropUser
AcrDropView
AcrDump
AcrExecute
AcrGrant
AcrInsert
AcrIndex
AcrReference
AcrRestore
AcrSelect
AcrUpdate
AcrCreateTrigger
540
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
AcrDropTrigger
None
CHAR(3) LATIN NOT
CASESPECIFIC NOT NULL
X(3)
CreateUID
Dbase.DatabaseId
BYTE(4)
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
AccessCount
None
INTEGER
--,---,---,--9 (explicit)
AcrUDTUsage
None
CHAR(3) LATIN NOT
CASESPECIFIC NOT NULL
X(3)
None
BYTE(4)
X(8)
AcrCreateProcedure
AcrDropProcedure
AcrExecuteProcedure
AcrCreateRole
AcrDropRole
AcrCreateProfile
AcrDropProfile
ArcCreateFunction
ArcDropFunction
ArcAlterFunction
AcrExecuteFunction
AcrAlterProcedure
AcrRepControl
LastAccessTimeStamp
AcrUDTType
AcrUDTMethod
AcrCreExtProcedure
AcrAlterExtProcedure
AcrCreAuthorization
AcrDropAuthorization
AcrStatistics
AcrConnectThrough
AcrCreateGLOP
AcrDropGLOP
AcrGLOPMember
ConstraintId
Data Dictionary Quick Reference
541
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
AcrConstrDef
None
CHAR(3) LATIN NOT
CASESPECIFIC
X(3)
AcrConstrAsgn
AcrOverrideIns
AcrOverrideSel
AcrOverrideUpd
AcrOverrideDel
AcrCreOwnerProcedure
AcrShow
AccLogTbl
Contains the result of the logging activity controlled by the AccLogRuleTbl.
Columns
Referenced Column(s)
Data Type
Format
LogonDate
(Composite NUPI)
None
DATE NOT NULL
YY/MM/DD (explicit)
LogonTime
(Composite NUPI)
None
FLOAT NOT NULL
99:99:99 (explicit)
TheDate
None
DATE NOT NULL
YY/MM/DD (explicit)
TheTime
None
FLOAT NOT NULL
99:99:99 (explicit)
LogicalHostId
None
SMALLINT NOT NULL
ZZZ9 (explicit)
IFPNo
None
SMALLINT NOT NULL
-(5)9
SessionNo
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
UserId
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
UserName
SessionTbl.AuditTrailId
X(128)
AccountName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
AccLogResult
None
CHAR(1) LATIN NOT
CASESPECIFIC NOT NULL
X(1)
SeqInHash
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
AccessType
None
CHAR(2) LATIN
NOT CASESPECIFIC NOT NULL
X(2)
Accesskind
None
BYTEINT NOT NULL
--9 (explicit)
Frequency
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
542
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
EventCount
None
INTEGER
--,---,---,--9 (explicit)
OwnerName
Dbase.DatabaseName
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
DatabaseName
Dbase.DatabaseName
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
TVMName
TVM.TVMName
X(128)
ColumnName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
ObjectLevel
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
ObjectId
Dbase.DatabaseId
TVM.TVMId
BYTE(4) NOT NULL
X(8)
ColumnId
None
SMALLINT
---,--9 (explicit)
StatementType
None
VARCHAR(20) LATIN
NOT CASESPECIFIC NOT NULL
X(20)
StatementText
None
VARCHAR(8192) UNICODE
NOT CASESPECIFIC
X(8192)
QueryBand
None
VARCHAR(6160) UNICODE
NOT CASESPECIFIC
X(6160)
ProxyUser
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
ConstraintId
None
BYTE(4)
X(8)
StatementKind
Accounts
Contains a row for each account with which a user can log on.
Columns
Referenced Column(s)
Data Type
Format
UserId (NUPI)
None
BYTE(4) NOT NULL
X(8)
AccountName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
RowType
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
Data Dictionary Quick Reference
543
Chapter 4: Data Dictionary Tables
Table Column Formats
Acctg
Contains a row for each account a user owns on each AMP.
Note: This is a non-fallback and non-hashed table.
Columns
Referenced Column(s)
Data Type
Format
AccountName
(Composite UPI)
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
UserName (Composite
UPI)
Dbase.DatabaseName
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
CPU
None
FLOAT NOT NULL
---,---,---,--9.99 (explicit)
IO
None
FLOAT NOT NULL
--,---,---,--9 (explicit)
CPUNorm
None
FLOAT NOT NULL
---,---,---,--9.99 (explicit)
Vproc
None
SMALLINT NOT NULL
-(5)9
VprocType
None
CHAR(4) LATIN
NOT CASESPECIFIC NOT NULL
X(4)
Model
ArchiveLoggingObjsTbl
Records tables that have online archive logs and their online archive logging levels.
Note: Users can only retrieve the information in this table via its system views, which are
DBC.ArchiveLoggingObjsV and DBC.ArchiveLoggingObjsVX.
Columns
Referenced Column(s)
Data Type
Format
DatabaseId (NUPI)
None
BYTE(4) NOT NULL
X(8)
TableId
None
BYTE (6) NOT NULL
X(12)
LogLevel
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
CreateUID
None
BYTE(4) NOT NULL
X(8)
CreateTimeStamp
None
TIMESTAMP(0) NOT NULL
YYYY-MM-DDBHH:MI:SS
LogSyncPoint
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
CommentString
None
VARCHAR(255) UNICODE
NOT CASESPECIFIC
X(255)
Dummy1
None
INTEGER
--,---,---,--9
Dummy2
544
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
AsgdSecConstraints
Defines the name value pairs assigned to a user or profile for a security constraint.
Note: Although this table is visible and has been defined, it is not populated with any rows. It
will be populated with rows in a future release.
Columns
Referenced Column(s)
Data Type
Format
AssigneeId (NUPI)
None
BYTE(4) NOT NULL
X(8)
ConstraintVal
None
SMALLINT NOT NULL
(5)9
IsDefault
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
AssignorId
None
BYTE(4) NOT NULL
X(8)
AssigneeKind
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
AssignTimeStamp
None
TIMESTAMP(0) NOT NULL
YYYY-MM-DDBHH:MI:SS
ConstraintId (NUSI)
IsBitPos
CollationTbl
Contains user-definable collation definitions.
Columns
Referenced Column(s)
Data Type
Format
CollName (UPI)
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
CollInstall
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
CollEqvClass
None
BYTE(256) NOT NULL
X(512)
CollOrderCS
CollOrderUC
ColumnCorrelation
Stores the column correlation information.
Columns
Referenced Column(s)
Data Type
Format
CorrelationName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
LeftDBId
Dbase.DatabaseID
BYTE(4) NOT NULL
X(8)
Data Dictionary Quick Reference
545
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
LeftTVId (NUPI)
TVM.TVMId
BYTE(6) NOT NULL
X(12)
LeftFieldKey
None
VARCHAR(255) LATIN
NOT CASESPECIFIC NOT NULL
X(255)
RightDBId
Dbase.DatabaseID
BYTE(4)
X(8)
RightTVId
TVM.TVMId
BYTE(6)
X(12)
RightFieldKey
None
VARCHAR(255) LATIN
NOT CASESPECIFIC NOT NULL
X(255)
AvgNCorr
None
VARCHAR(255) LATIN
NOT CASESPECIFIC NOT NULL
X(255)
MaxNCorr
None
FLOAT
-----,---,---,--9.99 (explicit)
SamplePCT
None
FLOAT NOT NULL
----,---,---,---,--9.9999
(explicit)
CommentString
None
VARCHAR(255) UNICODE
NOT CASESPECIFIC
X(255)
CorrelationEnabled
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
CreateUID
Dbase.DatabaseID
BYTE(4) NOT NULL
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
LastAlterUID
Dbase.DatabaseID
BYTE(4)
X(8)
LastAlterTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
AlterCount
None
INTEGER
--,---,---,--9 (explicit)
MinNCorr
546
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
ConnectRulesTbl
Stores information about CONNECT THROUGH privileges.
Columns
Referenced Column(s)
Data Type
Format
TrustUserID (Composite
UPI, NUSI)
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
ProxyUser (Composite
UPI)
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
ProxyUserID (Composite
NUSI)
Dbase.DatabaseId
BYTE(4)
X(8)
ProxyRole1
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
None
CHAR(1) LATIN NOT NULL
X(1)
CreateUID
Dbase.DatabaseId
BYTE(4)
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
TrustOnly
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
ProxyRole2
ProxyRole3
ProxyRole4
ProxyRole5
ProxyRole6
ProxyRole7
ProxyRole8
ProxyRole9
ProxyRole10
ProxyRole11
ProxyRole12
ProxyRole13
ProxyRole14
ProxyRole15
WithoutRole
GrantStatus (Composite
NUSI)
Data Dictionary Quick Reference
547
Chapter 4: Data Dictionary Tables
Table Column Formats
ConstantDefs
Defines the set of individual constants that make up a cost profile type including a description
of the constant and the default value.
Note: This table is constructed at installation time, and it may not be customized for any
reason.
Note: This table is for internal use only.
Columns
Referenced Column(s)
Data Type
Format
ProfileTypeId (NUPI,
Composite USI)
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
ConstName
None
CHAR(64) LATIN
NOT CASESPECIFIC NOT NULL
X(64)
ConstCat
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
ConstVal
None
FLOAT
----,---,---,---,--9.9999
(explicit)
ConstString
None
VARCHAR(2048) LATIN
CASESPECIFIC
X(2048)
ConstDesc
None
VARCHAR(2048) LATIN
NOT CASESPECIFIC
X(2048)
ConstId (Composite USI)
ConstantValues
Contains the actual values specified for each cost profile instance.
Note: This table is for internal use only.
Columns
Referenced Column(s)
Data Type
Format
ProfileId (NUPI,
Composite USI)
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
ProfileCat
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
ConstId (Composite
USI)
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
ConstVal
None
FLOAT
----,---,---,---,--9.9999 (explicit)
ConstString
None
VARCHAR(2048) LATIN
CASESPECIFIC
X(2048)
548
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
ConstraintFunctions
Defines the UDFs for a security constraint object.
Note: The ConstraintFunctions table is reserved for future use.
Columns
Referenced Column(s)
Data Type
Format
ConstraintId (NUPI,
Composite USI)
None
BYTE(4) NOT NULL
X(8)
StatementAction
(Composite USI)
None
CHAR(2) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(2)
FunctionDBId
None
BYTE(4) NOT NULL
X(8)
FunctionId (NUSI)
None
BYTE(6) NOT NULL
X(12)
FunctionName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
ConstraintNames
Contains a row for each named index or referential constraint defined on a table in the system.
Columns
Referenced Column(s)
Data Type
Format
DatabaseId (Composite
NUPI)
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
TableId (Composite
NUPI)
TVM.TVMId
BYTE(6) NOT NULL
X(12)
Name
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
NameI
None
VARCHAR(128) UNICODE
UPPERCASE NOT
CASESPECIFIC NOT NULL
X(128)
ConstraintType
None
CHAR(1) LATIN
UPPERCASE NOT
CASESPECIFIC NOT NULL
X(1)
IndexId
None
SMALLINT
---,--9 (explicit)
CreateUID
Dbase.DatabaseId
BYTE(4)
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
AccessCount
None
INTEGER
--,---,---,--9 (explicit)
JoinIndexId
None
BYTE(6)
X(12)
LastAccessTimeStamp
Data Dictionary Quick Reference
549
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
UniqueOrPK
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
VTConstraintType
TTConstraintType
ConstraintValues
Defines the name and value pairs for a security constraint object.
Note: This table is reserved for future use.
Columns
Referenced Column(s)
Data Type
Format
ConstraintId (NUPI,
Composite USI)
None
BYTE(4) NOT NULL
X(8)
ConstraintVal
(Composite USI)
None
SMALLINT NOT NULL
(5)9
ValueName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
IsBitPos
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
CostProfiles
Contains Teradata-supplied and user-defined cost profile instances.
Teradata-supplied profiles cannot be modified, although they may be copied to a user-defined
profile that can be modified.
Note: This table is for internal use only.
Columns
Referenced Column(s)
Data Type
Format
ProfileId (UPI)
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
ProfileName (USI)
None
CHAR(30) LATIN
NOT CASESPECIFIC NOT NULL
X(30)
ProfileTypeId
CostProfileTypes.ProfileTypeId
INTEGER NOT NULL
--,---,---,--9 (explicit)
ProfileCat
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
ProfileDesc
None
VARCHAR(2048) LATIN
NOT CASESPECIFIC
X(2048)
550
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
CostProfileTypes
Defines the cost profile type name, ID, and description.
The cost profile type definitions are fixed by Teradata and must not be changed.
This table is used to define Optimizer cost profiles.
Note: This table is for internal use only.
Columns
Referenced Column(s)
Data Type
Format
ProfileTypeId (UPI)
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
ProfileTypeName (USI)
None
CHAR(30) LATIN
NOT CASESPECIFIC NOT NULL
X(30)
ProfileTypeDesc
None
CHAR(2048) LATIN
NOT CASESPECIFIC
X(2048)
DataBaseSpace
Performs space accounting for each database and each table in a database.
Note: This is a non-fallback and non-hashed table.
Columns
Referenced Column(s)
Data Type
Format
DatabaseId (Composite
UPI)
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
TableId (Composite UPI)
None
BYTE(6) NOT NULL
X(12)
Vproc
None
SMALLINT NOT NULL
-(5)9
MaxPermSpace
None
FLOAT NOT NULL
----,---,---,---,--9 (explicit)
None
FLOAT
----,---,---,---,--9 (explicit)
MaxSpoolSpace
PeakPermSpace
PeakSpoolSpace
CurrentPermSpace
CurrentSpoolSpace
MaxTempSpace
PeakTempSpace
CurrentTempSpace
MaxProfileSpoolSpace
MaxProfileTempSpace
Data Dictionary Quick Reference
551
Chapter 4: Data Dictionary Tables
Table Column Formats
Dbase
Contains a row for each database and user in the system.
Columns
Referenced Column(s)
Data Type
Format
DatabaseNameI (UPI)
None
VARCHAR(128) UNICODE
UPPERCASE
NOT CASESPECIFIC NOT NULL
X(128)
DatabaseId (USI)
Accounts.UserId
BYTE(4) NOT NULL
X(8)
Databasespace.
Databaseid
Accessrights.UserId
Owners.ownerid
TVM.databaseId
ReferencingTbls.
ReferencingDbId
DBCAssociation.
DatabaseId
Owners.owneeid
ReferencedTbls.
ReferencedDbId
TableConstraints.
DbaseId
Triggerstbl.
DatabaseId
UDFInfo.DatabaseId
OwnerId
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
EncryptionFlag
None
BYTE(1)
X(2)
PasswordSalt
None
BYTE(2)
X(4)
EncryptedPassword
None
VARBYTE(512)
X(1024)
PasswordModTime
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
ProtectionType
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
JournalFlag
None
CHAR(2) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(2)
PermSpace
None
FLOAT NOT NULL
----,---,---,---,--9 (explicit)
None
VARCHAR(255) UNICODE
NOT CASESPECIFIC
X(255)
SpoolSpace
StartupString
CommentString
552
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
AccountName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
CreatorName
Dbase.DatabaseName
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
DatabaseName
RCEvent.Database
Name
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
AcclogTbl.User
Name
JournalId
None
BYTE(6)
X(12)
Version
None
SMALLINT NOT NULL
---,--9 (explicit)
OwnerName
Dbase.DatabaseName
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
NumFallBackTables
None
SMALLINT NOT NULL
---,--9 (explicit)
DefaultDatabase
Dbase.DatabaseName
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
LogonRules
None
SMALLINT NOT NULL
---,--9 (explicit)
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
None
INTEGER
--,---,---,--9 (explicit)
LockedTime
None
SMALLINT
---,--9 (explicit)
LockedCount
None
BYTEINT
---9 (explicit)
UnResolvedRICount
None
SMALLINT NOT NULL
---,--9 (explicit)
TimeZoneHour
None
BYTEINT
---9 (explicit)
DefaultDateForm
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
CreateUID
Dbase.DatabaseId
BYTE(4)
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
LastAlterUID
Dbase.DatabaseId
BYTE(4)
X(8)
LastAlterTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
NumLogProtTables
AccLogRules
AccLogUsrRules
DefaultCollation
RowType
PasswordChgDate
LockedDate
TimeZoneMinute
Data Dictionary Quick Reference
553
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
TempSpace
None
FLOAT NOT NULL
----,---,---,---,--9 (explicit)
LastAccessTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
AccessCount
None
INTEGER
--,---,---,--9 (explicit)
DefaultCharType
None
SMALLINT
---,--9 (explicit)
RoleName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
ProfileName
UDFLibRevision
AppCat1Revision
AppCat2Revision
AppCat3Revision
AppCat4Revision
JarLibRevision
TimeZoneString
DBCAssociation
Contains the results of the porting of a data table between Teradata systems by Archive/
Recovery software.
Columns
Referenced Column(s)
Data Type
Format
TVMId (UPI)
TVM.TVMId
BYTE(6) NOT NULL
X(12)
DatabaseId
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
JournalId
None
BYTE(6)
X(12)
EventNum
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
Original_DatabaseName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
Original_DataBaseId
None
BYTE(4) NOT NULL
X(8)
Original_TVMNameI
None
VARCHAR(128) UNICODE
UPPERCASE NOT
CASESPECIFIC NOT NULL
X(128)
Original_LogicalHostId
None
SMALLINT
ZZZ9 (explicit)
Original_SessionNo
None
INTEGER
--,---,---,--9 (explicit)
Original_TVMId
None
BYTE(6) NOT NULL
X(12)
554
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
Original_TableKind
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
Original_TempFlag
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
Original_HashFlag
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
Original_NextIndexId
None
SMALLINT NOT NULL
---,--9 (explicit)
Original_RequestText
None
VARCHAR(12500) UNICODE
NOT CASESPECIFIC
X(255) (explicit)
Original_CommentString
None
VARCHAR(255) UNICODE
NOT CASESPECIFIC
X(255)
Original_CreatorName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
Original_JournalFlag
None
CHAR(2) LATIN
NOT CASESPECIFIC NOT NULL
X(2)
Original_JournalID
None
BYTE(6)
X(12)
Original_UtilVersion
None
SMALLINT
---,--9 (explicit)
Original_ProtectionType
Original_NextFieldId
Original_Version
Original_TVMName
DBCInfoTbl
Contains current information, such as the database version, PDE release, and language
support mode.
Columns
Referenced Column(s)
Data Type
Format
InfoKey (UPI)
None
VARCHAR(30) LATIN
NOT CASESPECIFIC NOT NULL
X(30)
InfoData
None
VARCHAR(16384) UNICODE
NOT CASESPECIFIC
X(16384)
Data Dictionary Quick Reference
555
Chapter 4: Data Dictionary Tables
Table Column Formats
DBQLExplainTbl
Contains the explain of the query. Since the explain can be larger than 64KB, it may use
multiple rows to hold the data.
Columns
Referenced Column(s)
Data Type
Format
ProcID (Composite NUPI)
None
DECIMAL(5,0) NOT NULL
-(5)9 (explicit)
CollectTimestamp
(Composite NUPI)
None
TIMESTAMP(2) NOT NULL
YYYY-MM-DDBHH:MI:SS
QueryID
None
DECIMAL(18,0) NOT NULL
--Z(17)9
ExpRowNo
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
ExplainText
None
VARCHAR (31000) UNICODE
NOT CASESPECIFIC NOT NULL
X(31000)
DBQLObjTbl
Is populated if object information is requested for the query in addition to the default
information row.
A row for each object (database, table, column, and index) is used. If the object is a secondary
index, its number and use are logged.
Columns
Referenced Column(s)
Data Type
Format
ProcID (Composite
NUPI)
None
DECIMAL(5,0) NOT NULL
-(5)9 (explicit)
CollectTimeStamp
(Composite NUPI)
None
TIMESTAMP(2) NOT NULL
YYYY-MM-DDBHH:MI:SS
QueryID
None
DECIMAL(18,0) NOT NULL
--Z(17)9
ObjectDatabaseName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
ObjectID
None
BYTE(4) NOT NULL
X(8)
ObjectNum
None
INTEGER
--,---,---,--9 (explicit)
ObjectType
None
CHAR(3) LATIN
NOT CASESPECIFIC NOT NULL
X(3)
FreqofUse
None
INTEGER
--,---,---,--9 (explicit)
TypeofUse
None
BYTEINT
--9 (explicit)
ObjectTableName
ObjectColumnName
556
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
DBQLogTbl
Specifies the main table for DBQL.
Columns
Referenced Column(s)
Data Type
Format
ProcID (Composite
NUPI)
None
DECIMAL(5,0) NOT NULL
-(5)9 (explicit)
CollectTimestamp
(Composite NUPI)
None
TIMESTAMP(2) NOT NULL
YYYY-MM-DDBHH:MI:SS
QueryID
None
DECIMAL(18,0) NOT NULL
--Z(17)9
UserID
None
BYTE(4) NOT NULL
X(8)
AcctString
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
SessionID
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
LogicalHostID
None
SMALLINT NOT NULL
ZZZ9 (explicit)
RequestNum
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
InternalRequestNum
None
INTEGER NOT NULL
--,---,---,--9
LogonDateTime
None
TIMESTAMP(2) NOT NULL
YYYY-MM-DDBHH:MI:SS
AcctStringTime
None
FLOAT
99:99:99 (explicit)
AcctStringHour
None
SMALLINT
--9 (explicit)
AcctStringDate
None
DATE
YY/MM/DD (explicit)
LogonSource
None
CHAR(128) LATIN
NOT CASESPECIFIC
X(128)
AppID
None
CHAR(30) UNICODE
NOT CASESPECIFIC
X(30)
ClientAddr
None
CHAR(45) LATIN
NOT CASESPECIFIC
X(45)
QueryBand
None
VARCHAR(6160) UNICODE
NOT CASESPECIFIC
X(6160)
ProfileID
None
BYTE(4)
X(8)
StartTime
None
TIMESTAMP(2) NOT NULL
YYYY-MM-DDBHH:MI:SS.S(F)Z
(explicit)
None
TIMESTAMP(2)
YYYY-MM-DDBHH:MI:SS.S(F)Z
(explicit)
None
SMALLINT NOT NULL
---,--9 (explicit)
ExpandAcctString
ClientID
FirstStepTime
FirstRespTime
LastStateChange
NumSteps
Data Dictionary Quick Reference
557
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
NumStepswPar
None
SMALLINT
---,--9 (explicit)
None
FLOAT
----,---,---,---,--9 (explicit)
None
FLOAT
----,---,---,---,--9.999 (explicit)
None
FLOAT
----,---,---,---,--9 (explicit)
ErrorCode
None
INTEGER
--,---,---,--9 (explicit)
ErrorText
None
VARCHAR(1024) UNICODE
NOT CASESPECIFIC
X(255)
WarningOnly
None
CHAR(1) LATIN
NOT CASESPECIFIC
X(1)
DelayTime
None
INTEGER
--,---,---,--9 (explicit)
None
CHAR(1) LATIN
NOT CASESPECIFIC
X(1)
StatementType
None
CHAR(20) LATIN
NOT CASESPECIFIC
X(20)
QueryText
None
VARCHAR(10000) UNICODE
NOT CASESPECIFIC
X(10000)
NumOfActiveAMPs
None
INTEGER
--,---,---,--9 (explicit)
MaxAMPCPUTime
None
FLOAT
----,---,---,---,--9.999 (explicit)
MaxCPUAmpNumber
None
SMALLINT
---,--9 (explicit)
MinAmpCPUTime
None
FLOAT
----,---,---,---,--9.999 (explicit)
MaxAmpIO (renamed
from HotAmpIO)
None
FLOAT
----,---,---,---,--9 (explicit)
MaxIOAmpNumber
None
SMALLINT
---,--9 (explicit)
MinAmpIO (renamed
from LowAmpIO)
None
FLOAT
----,---,---,---,--9 (explicit)
MaxStepsInPar
NumResultRows
TotalIOCount
AMPCPUTime
ParserCPUTime
UtilityByteCount
UtilityRowCount
WDDelayTime
AbortFlag
CacheFlag
SpoolUsage
558
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
WDID
None
INTEGER
--,---,---,--9 (explicit)
None
CHAR(1) LATIN
NOT CASESPECIFIC
X(1)
None
INTEGER
--,---,---,--9 (explicit)
None
FLOAT
----,---,---,---,--9 (explicit)
None
CHAR(1) LATIN
NOT CASESPECIFIC
X(1)
Twirled
None
INTEGER
--,---,---,--9 (explicit)
UserName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
None
FLOAT
----,---,---,---,--9.999 (explicit)
MaxCPUAmpNumber
Norm
None
SMALLINT
---,--9 (explicit)
MinAmpCPUTime
Norm
None
FLOAT
----,---,---,---,--9.999 (explicit)
EstResultRows
None
FLOAT
----,---,---,---,--9 (explicit)
EstProcTime
None
FLOAT
----,---,---,---,--9.999 (explicit)
EstMaxRowCount
None
FLOAT
----,---,---,---,--9 (explicit)
ProxyUser
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
OpEnvID
SysConID
LSN
NoClassification
WDOverride
SLGMet
ExceptionValue
FinalWDID
TDWMEstMaxRows
TDWMEstLastRows
TDWMEstTotalTime
TDWMAllAmpFlag
TDWMConfLevelUsed
DefaultDatabase
AMPCPUTimeNorm
ParserCPUTimeNorm
MaxAMPCPUTime
Norm
ProxyRole
StatementGroup
Data Dictionary Quick Reference
559
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
SessionTemporal
Qualifier
None
VARCHAR(1024) LATIN NOT
CASESPECIFIC
X(1024)
ExtraField1
None
INTEGER
--,---,---,--9 (explicit)
ExtraField3
None
SMALLINT
---,--9 (explicit)
ExtraField4
None
TIMESTAMP(2)
YYYY-MM-DDBHH:MI:SS.S(F)Z
ExtraField5
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
ExtraField6
None
FLOAT
----,---,---,---,--9 (explicit)
ExtraField2
ExtraField7
DBQLRuleCountTbl
This table is reserved for internal use only.
Columns
Referenced Column(s)
Data Type
Format
CountNameString (UPI)
None
CHAR(8) LATIN
NOT CASESPECIFIC NOT NULL
X(30) (explicit)
NumberOfRules
None
INTEGER
--,---,---,--9 (explicit)
DBQLRuleTbl
Specifies the rule table for DBQL.
Columns
Referenced Column(s)
Data Type
Format
UserID (Composite UPI)
None
BYTE(4) NOT NULL
X(8)
AccountString
(Composite UPI)
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
AppIName (Composite
UPI)
None
CHAR(30) LATIN
NOT CASESPECIFIC NOT NULL
X(30)
ExplainFlag
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
ObjFlag
SqlFlag
StepFlag
XMLPlanFlag
SummaryFlag
560
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
ThresholdFlag
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
TextSizeLimit
None
INTEGER
--,---,---,--9 (explicit)
SummaryVal1
None
SMALLINT
---,--9 (explicit)
CreateID
None
BYTE(4) NOT NULL
X(8)
TimeCreated
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
SummaryVal2
SummaryVal3
TypeOfCriterion
TimeAccessed
DBQLSqlTbl
Is populated if the SQL is requested for the query in addition to the default information row. If
the additional SQL text is greater than 64KB, multiple rows are generated.
Columns
Referenced Column(s)
Data Type
Format
ProcID (Composite
NUPI)
None
DECIMAL(5,0) NOT NULL
-(5)9 (explicit)
CollectTimestamp
(Composite NUPI)
None
TIMESTAMP(2) NOT NULL
YYYY-MM-DDBHH:MI:SS
QueryID
None
DECIMAL(18,0) NOT NULL
--Z(17)9
SqlRowNo
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
SqlTextInfo
None
VARCHAR (31000) UNICODE
NOT CASESPECIFIC NOT NULL
X(31000)
DBQLStepTbl
Is populated by step level information. If the step information of the query is requested, a step
table is populated with a row for each step.
Columns
Referenced
Column(s)
Data Type
Format
ProdID (Composite NUPI)
None
DECIMAL(5,0) NOT NULL
-(5)9 (explicit)
CollectTimestamp
(Composite NUPI)
None
TIMESTAMP(6) NOT NULL
YYYY-MM-DDBHH:MI:SS
(explicit)
QueryID
None
DECIMAL(18,0) NOT NULL
--Z(17)9
Data Dictionary Quick Reference
561
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced
Column(s)
Data Type
Format
StepLev1Num
None
SMALLINT NOT NULL
---,--9 (explicit)
StepLev2Num
None
SMALLINT
---,--9 (explicit)
StepName
None
CHAR(6) LATIN
NOT CASESPECIFIC NOT NULL
X(6)
StepStartTime
None
TIMESTAMP(6)
YYYY-MM-DDBHH:MI:SS.S(F)Z
(explicit)
None
FLOAT
----,---,---,---,--9.999 (explicit)
None
FLOAT
----,---,---,---,--9 (explicit)
NumOfActiveAMPs
None
INTEGER
--,---,---,--9 (explicit)
MaxAmpCPUTime
None
FLOAT
----,---,---,---,--9.999 (explicit)
MaxCPUAmpNumber
None
SMALLINT
---,--9 (explicit)
MinAmpCPUTime
None
FLOAT
----,---,---,---,--9.999 (explicit)
MaxAmpIO (renamed from
HotAmpIO)
None
FLOAT
----,---,---,---,--9 (explicit)
MaxIOAmpNumber
None
SMALLINT
---,--9 (explicit)
MinAmpIO (renamed from
LowAmpIO)
None
FLOAT
----,---,---,---,--9 (explicit)
MaxSpoolAmpNumber
None
SMALLINT
---,--9 (explicit)
MinAMPSpool
None
FLOAT
----,---,---,---,--9 (explicit)
StepWD
None
INTEGER
--,---,---,--9 (explicit)
UtilityTableID
None
BYTE(4)
X(8)
RowsWComprColumns
None
FLOAT
----,---,---,---,--9 (explicit)
StepStopTime
EstProcTime
EstCPUCost
CPUtime
IOcount
EstRowCount
RowCount
RowCount2
RowCount3
SpoolUsage
MaxAMPSpool
LSN
562
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced
Column(s)
Data Type
Format
EstIOCost
None
FLOAT
----,---,---,---,--9.999 (explicit)
MaxCPUAmpNumberNorm
None
SMALLINT
---,--9 (explicit)
MinAmpCPUTimeNorm
None
FLOAT
----,---,---,---,--9.999 (explicit)
ExtraField1
None
FLOAT
----,---,---,---,--9 (explicit)
None
INTEGER
--,---,---,--9 (explicit)
EstNetCost
EstHRCost
CPUtimeNorm
MaxAmpCPUTimeNorm
ExtraField2
ExtraField3
ExtraField4
DBQLSummaryTbl
Is populated only if summary information is requested or a threshold value is used. For the
summary case, a row exists for each collection if the count of the queries run in that time
frame (LowHist to HighHist) is greater than 0.
For threshold, one row (with LowHist=ThreshValue and HighHist=0) exists for the collection
if there were queries shorter than LowHist seconds.
Columns
Referenced Column(s)
Data Type
Format
ProcID (Composite NUPI)
None
DECIMAL(5,0) NOT NULL
-(5)9 (explicit)
CollectTimeStamp
(Composite NUPI)
None
TIMESTAMP(2) NOT NULL
YYYY-MM-DDBHH:MI:SS
UserID
None
BYTE(4)
X(8)
AcctString
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
LogicalHostID
None
SMALLINT
ZZZ9 (explicit)
AppID
None
CHAR(30) UNICODE
NOT CASESPECIFIC
X(30)
ClientAddr
None
CHAR(45) LATIN
NOT CASESPECIFIC
X(45)
ProfileID
None
BYTE(4)
X(8)
ClientID
Data Dictionary Quick Reference
563
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
SessionID
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
ValueType
None
CHAR(1) LATIN
NOT CASESPECIFIC
X(1)
QuerySeconds
None
FLOAT NOT NULL
----,---,---,---,--9.999 (explicit)
TotalIOCount
None
FLOAT
----,---,---,---,--9 (explicit)
AMPCPUTime
None
FLOAT
----,---,---,---,--9.999 (explicit)
None
FLOAT NOT NULL
----,---,---,---,--9.999 (explicit)
QueryCount
ParserCPUTime
AMPCPUTimeNorm
ParserCPUTimeNorm
LowHist
HighHist
DBQLXMLTbl
Stores the query plan as an XML document.
Columns
Referenced Column(s)
Data Type
Format
ProcID (Composite NUPI)
None
DECIMAL(5,0) NOT NULL
-(5)9
CollectTimeStamp
(Composite NUPI)
None
TIMESTAMP(2) NOT NULL
YYYY-MM-DDBHH:MI:SS
QueryID
None
DECIMAL(18,0) NOT NULL
--Z(17)9
XMLRowNo
None
INTEGER NOT NULL
--,---,---,--9
XMLTextInfo
None
VARCHAR(31000) UNICODE
NOT CASESPECIFIC NOT NULL
X(31000)
564
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Dependency
Stores relationships among a UDT, its dependent routines, User-Defined Casts, User-Defined
Transforms, User-Defined Orderings, and any dependency on any other database object. The
table also stores dependency information between JAR objects.
Columns
Referenced Column(s)
Data Type
Format
Object1Id (NUPI)
None
BYTE(6) NOT NULL
X(12)
Object1Name
None
VARCHAR(128) UNICODE
UPPERCASE NOT CASESPECIFIC
X(128)
Database1Id
None
BYTE(4) NOT NULL
X(8)
Database1Name
None
VARCHAR(128) UNICODE
UPPERCASE NOT CASESPECIFIC
X(128)
Object2Id
None
BYTE(6) NOT NULL
X(12)
Object2Name
None
VARCHAR(128) UNICODE
UPPERCASE NOT CASESPECIFIC
X(128)
Database2Id
None
BYTE(4) NOT NULL
X(8)
Database2Name
None
VARCHAR(128) UNICODE
UPPERCASE NOT CASESPECIFIC
X(128)
RelationshipCode
None
CHAR(2) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(2)
ErrorMsgs
Stores all error messages returned to the user.
Columns
Referenced Column(s)
Data Type
Format
ErrorCode (UPI)
None
SMALLINT NOT NULL
---,--9 (explicit)
ErrorText
None
VARCHAR(255) UNICODE
NOT CASESPECIFIC NOT NULL
X(255)
Data Dictionary Quick Reference
565
Chapter 4: Data Dictionary Tables
Table Column Formats
ErrorTbls
Stores data and error table relations.
Columns
Referenced Column(s)
Data Type
Format
BaseTID (USI)
None
BYTE(6) NOT NULL
X(12)
BaseDID
None
BYTE(4) NOT NULL
X(8)
ErrorTID (UPI)
None
BYTE(6) NOT NULL
X(12)
ErrorDID
None
BYTE(4) NOT NULL
X(8)
None
TIMESTAMP(0) NOT NULL
YYYY-MM-DDBHH:MI:SS
CreateUID
CreateTimeStamp
EventLog
Contains a row for every session event.
Columns
Referenced Column(s)
Data Type
Format
DateFld (Composite
NUPI)
None
DATE NOT NULL
YY/MM/DD (explicit)
TimeFld (Composite
NUPI)
None
FLOAT NOT NULL
99:99:99.99 (explicit)
UserName
SessionTbl.AuditTrailId
X(128)
AccountName
Dbase.AccountName
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
Event
None
CHAR(12) LATIN
NOT CASESPECIFIC NOT NULL
X(12)
LogicalHostId
None
SMALLINT NOT NULL
ZZZ9 (explicit)
IFPNo
None
SMALLINT NOT NULL
-(5)9
SessionNo
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
LogonDate
None
DATE NOT NULL
YY/MM/DD (explicit)
LogonTime
None
FLOAT NOT NULL
99:99:99.99 (explicit)
LogonSource
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
ClientConnectionType
None
BYTEINT
--9
566
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
ClientCoordName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
ClientTcpPortNumber
None
INTEGER
--,---,---,--9
ClientTdHostName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
ClientIpAddress
None
VARCHAR(45) UNICODE
NOT CASESPECIFIC
X(45)
ClientProgramName
None
VARCHAR(1024) UNICODE
NOT CASESPECIFIC
X(1024)
ClientSystemUserId
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
AuthMethod
None
BYTEINT
--9
AuthUser
None
VARCHAR(256) UNICODE
UPPERCASE NOT CASESPECIFIC
X(256)
MechanismOid
None
VARBYTE(32)
X(64)
ClientEnvName
ClientJobId
ClientJobName
ClientOsName
ClientProcThreadId
ClientSecProdGrp
ClientSecProdUserId
ClientTerminalId
ClientTransactionId
ClientUserOperId
ClientVmName
ClientVmUserId
MechanismName
ClientTDPReleaseId
ClientCLIv2ReleaseId
ClientSessionDesc
ClientWorkload
ClientJobData
Data Dictionary Quick Reference
567
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
RFU1
None
VARCHAR(256) UNICODE
NOT CASESPECIFIC
X(256)
RFU2
RFU3
RFU4
RFU5
RFU6
Global
Is only used internally to the DBC. It contains information such as, whether logons to the
DBC are enabled or disabled. This table is used by session control during start up.
Columns
Referenced Column(s)
Data Type
Format
Key (UPI)
None
CHAR(2) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(2)
Blob
None
VARBYTE(2048) NOT NULL
X(2048) (explicit)
Hosts
Contains one row per host that defines the default character set for that host.
Columns
Referenced Column(s)
Data Type
Format
LogicalHostId (UPI)
None
SMALLINT NOT NULL
ZZZ9 (explicit)
HostName (USI)
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
DefaultCharSet
IdCol
Contains the parameters of every identity column defined in the system.
Columns
Referenced Column(s)
Data Type
Format
TableId (UPI)
TVM.TVMId
BYTE(6) NOT NULL
X(12)
DatabaseId
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
568
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
AvailValue
None
DECIMAL(18,0) NOT NULL
----,---,---,---,---,--9
(explicit)
Increment
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
Cyc
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
StartValue
MinValue
MaxValue
Indexes
Contains a row for each column that is an index.
Columns
Referenced Column(s)
Data Type
Format
TableId (NUPI)
TVM.TVMId
BYTE(6) NOT NULL
X(12)
IndexType
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
IndexNumber
None
SMALLINT NOT NULL
---,--9 (explicit)
UniqueFlag
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
FieldId
TVFields.FieldId
SMALLINT NOT NULL
---,--9 (explicit)
FieldPosition
None
SMALLINT NOT NULL
---,--9 (explicit)
IndexMode
None
CHAR(1) LATIN
NOT CASESPECIFIC
X(1)
DatabaseId
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
IndexStatistics
None
VARBYTE(16383)
X(255) (explicit)
Name
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
CreateUID
Dbase.DatabaseId
BYTE(4)
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
LastAlterUID
Dbase.DatabaseId
BYTE(4)
X(8)
LastAlterTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
AccessCount
None
INTEGER
--,---,---,--9 (explicit)
JoinIndexTableID
TVM.TVMId
BYTE(6)
X(12)
LastAccessTimeStamp
Data Dictionary Quick Reference
569
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
UniqueOrPK
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
IndexTypeID
None
BYTE(6)
X(12)
IndexVersion
None
SMALLINT
---,--9
IndexParameterString
None
VARCHAR(1024) UNICODE
NOT CASESPECIFIC
X(255)
VTConstraintType
TTConstraintType
SystemDefinedJI
InDoubtResLog
Contains a row for each transaction that had been in doubt.
Columns
Referenced Column(s)
Data Type
Format
LogicalHostId
(Composite NUPI)
None
SMALLINT NOT NULL
---,--9 (explicit)
SessionNumber
(Composite NUPI)
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
CoordTaskId (Composite
NUPI)
None
VARBYTE(30) NOT NULL
X(60)
Dbase.DatabaseName
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
CommitOrRollback
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
UserLogonDate
None
DATE NOT NULL
YY/MM/DD (explicit)
UserLogonTime
None
FLOAT NOT NULL
99:99:99 (explicit)
CompletionDate
None
DATE NOT NULL
YY/MM/DD (explicit)
CompletionTime
None
FLOAT NOT NULL
99:99:99 (explicit)
Options
None
CHAR(1) LATIN
NOT CASESPECIFIC
X(1)
RunUnitId (Composite
NUPI)
LogonUserName
ResolvingUserLogonName
570
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
JARS
Contains one row for each JAR object installed on the database system.
Columns
Referenced Column(s)
Data Type
Format
DatabaseId (NUPI)
Dbase.DatabaseId
TVM.DatabaseId
BYTE(4) NOT NULL
X(8)
JarId (USI)
TVM.TVMId
BYTE(6) NOT NULL
X(12)
JarName
None.
VARCHAR(128) UNICODE
UPPERCASE NOT
CASESPECIFIC NOT NULL
X(128)
JarRevision
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
ExtFileReference
None
VARCHAR(1000) UNICODE
CASESPECIFIC
X(255)
JAR_JAR_Usage
Contains one row for each JAR included in the SQL-Java path of another JAR.
The SQL-Java path is created, altered, or dropped by calling SQLJ.Alter_Java_Path.
Columns
Referenced Column(s)
Data Type
Format
JarId (NUPI)
TVM.TVMId
BYTE(6) NOT NULL
X(12)
JarName
None
VARCHAR(128) UNICODE
UPPERCASE NOT
CASESPECIFIC NOT NULL
X(128)
PathJarId
TVM.TVMId
BYTE(6) NOT NULL
X(12)
PathJarName
None
VARCHAR(128) UNICODE
UPPERCASE NOT
CASESPECIFIC NOT NULL
X(128)
DatabaseId
Dbase.DatabaseId
TVM.DatabaseId
BYTE(4) NOT NULL
X(8)
ReferencedClsName
None
VARCHAR(1000) LATIN
CASESPECIFIC
X(255)
Data Dictionary Quick Reference
571
Chapter 4: Data Dictionary Tables
Table Column Formats
LogonRuleTbl
Indicates what users can legally logon from what host, and whether a password is necessary.
Columns
Referenced Column(s)
Data Type
Format
UserId (Composite UPI)
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
LogicalHostId
(Composite UPI)
None
SMALLINT NOT NULL
ZZZ9 (explicit)
LogonStatus
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
CreateUID
Dbase.DatabaseId
BYTE(4)
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
None
INTEGER
--,---,---,--9 (explicit)
NullPassword
LastAccessTimeStamp
AccessCount
MDSRecoveryTbl
Contains databasename and tableid affected by DDL statements that Teradata cannot send to
the Relay Services Gateway (RSG) when the Meta Data Services Gateway is down. TableID is
TVM.TVMId for table level DDL and 0 for a database level DDL request.
Columns
Referenced Column(s)
Data Type
Format
DBName (UPI)
Dbase.DatabaseName
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
TVMId
None
BYTE(6) NOT NULL
X(12)
Migration
This is an internal table.
Columns
Referenced Column(s)
Data Type
Format
RowNum (NUPI)
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
Field1
None
BYTEINT NOT NULL
---9 (explicit)
572
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Next
Contains the next internal identifiers the DBC uses for processing.
Columns
Referenced Column(s)
Data Type
Format
RowNum (UPI)
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
DatabaseId
None
BYTE(4) NOT NULL
X(8)
None
INTEGER NOT NULL
ZZZZZZZZZ9
TableId
ProcsRowLoc
EventNum
LogonSequenceNo
TempTableID
StatsQueryID
ReconfigID
OldPasswords
Contains a history of passwords used by a user in the system.
Columns
Referenced Column(s)
Data Type
Format
UserName (NUPI)
Dbase.DatabaseName
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
PasswordDate
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
EncryptionFlag
None
BYTE(1)
X(2)
PasswordSalt
None
BYTE(2)
X(4)
EncryptedPassword
None
VARBYTE(512)
X(1024)
Owners
Shows information for each database in the system.
Columns
Referenced Column(s)
Data Type
Format
OwnerId (NUPI)
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
OwneeId
Dbase.DatabaseId
TVM.DatabaseId
BYTE(4) NOT NULL
X(8)
Data Dictionary Quick Reference
573
Chapter 4: Data Dictionary Tables
Table Column Formats
ParentChildCorrelation
Shows the parent-child date correlation.
Note: This table is reserved for future use.
Columns
Referenced Column(s)
Data Type
Format
ParentDbId (Composite
NUPI)
None
BYTE(4) NOT NULL
X(8)
ParentTblID (Composite
NUPI)
None
BYTE(6) NOT NULL
X(12)
ChildDbID (Composite
NUPI)
None
BYTE(4) NOT NULL
X(8)
ChildTblID (Composite
NUPI)
None
BYTE(6) NOT NULL
X(12)
ParentTblDateFID
None
SMALLINT NOT NULL
---,--9 (explicit)
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
None
FLOAT NOT NULL
---,---,---,--9.99 (explicit)
ChildTblDateFID
CorrelationLowerBound
CorrelationUpperBound
CorrelationTightness
Parents
Shows the parentage for each database in the system. This table is the inverse of Owners.
Columns
Referenced Column(s)
Data Type
Format
DbId (NUPI)
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
ParentId
PasswordRestrictions
Restricts a password from being created that contains any word listed in the table.
Columns
Referenced Column(s)
Data Type
Format
RestrictedWord (UPI)
None
VARCHAR(30) UNICODE
UPPERCASE
NOT CASESPECIFIC NOT NULL
X(30)
574
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Profiles
Controls the user password security and the amount of system resources (default database,
spool space, temporary space, and account) that the user is allowed to consume.
Note: The user password security controls affect only those passwords authenticated by
Teradata Database and does not affect externally authenticated user passwords.
Columns
Referenced Column(s)
Data Type
Format
ProfileNameI (UPI)
None
VARCHAR(128) UNICODE
UPPERCASE
NOT CASESPECIFIC NOT NULL
X(128)
ProfileName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
ProfileId (USI)
None
BYTE(4) NOT NULL
X(8)
DefaultAccount
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
None
FLOAT
----,---,---,---,--9 (explicit)
ExpirePassword
None
SMALLINT
---,--9 (explicit)
PasswordMinChar
None
BYTEINT
--9 (explicit)
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
PasswordRestrictWords
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
MaxLogonAttempts
None
BYTEINT
---9 (explicit)
LockedUserExpire
None
SMALLINT
---,--9 (explicit)
Version
None
SMALLINT NOT NULL
---,--9 (explicit)
CommentString
None
VARCHAR(255) UNICODE
NOT CASESPECIFIC
X(255)
CreateUID
None
BYTE(4) NOT NULL
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
LastAlterUID
None
BYTE(4) NOT NULL
X(8)
LastAlterTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
DefaultDataBase
SpoolSpace
TempSpace
PasswordMaxChar
PasswordDigits
PasswordSpecChar
PasswordReuse
Data Dictionary Quick Reference
575
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
CostProfName
CostProfiles.ProfileName
CHAR(30) LATIN
NOT CASESPECIFIC
X(128)
QueryStatsTbl
Saves information about collected statistics on the queries.
Note: Although this table is visible and has been defined, it is not populated with any rows. It
will be populated with rows in a future release.
Columns
Referenced Column(s)
Data Type
Format
HashValue (NUPI)
None
BYTE(4) NOT NULL
X(8)
QueryId (USI)
None
BYTE(6) NOT NULL
X(12)
DatabaseId (Composite
USI)
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
QueryName (Composite
USI)
None
VARCHAR(128) UNOCODE
NOT CASESPECIFIC NOT NULL
X(128)
RequestText
None
VARCHAR(12500) UNICODE
NOT CASESPECIFIC
X(255)
RequestTextOverFlow
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
CreateText
None
VARCHAR(12500) UNICODE
UPPERCASE
NOT CASESPECIFIC
X(255)
CreateTextOverFlow
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
RowCount
None
FLOAT
----,---,---,---,--9
ValidStats
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
Source
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
DBSVersion
None
CHAR(32) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(32)
IntReserved1
None
INTEGER
--,---,---,--9
None
FLOAT
----,---,---,---,--9
IntReserved2
FloatReserved1
FloatReserved2
576
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
CharReserved1
None
CHAR(5)
X(1)
CharReserved3
None
CHAR(1)
X(1)
AccessCount
None
INTEGER
--,---,---,--9
LastAccessTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
CreateUID
None
BYTE(4)
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
LastAlterUID
None
BYTE(4)
X(8)
LastAlterTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
CharReserved2
RCConfiguration
Contains information about the AMPs configuration for an event in the RCEvent table.
Columns
Referenced Column(s)
Data Type
Format
EventNum (NUPI)
RCEvent.EventNum
INTEGER NOT NULL
--,---,---,--9 (explicit)
LogProcessor
None
SMALLINT
-(5)9
PhyProcessor
None
SMALLINT
ZZZZ9 (explicit)
ProcessorState
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
RestartSeqNum
None
SMALLINT
---,--9 (explicit)
Vproc
None
SMALLINT
-(5)9
RCEvent
Contains a row for each event executed by the Host Utilities.
Columns
Referenced Column(s)
Data Type
Format
EventNum (NUPI)
RCConfiguration.
EventNum
INTEGER NOT NULL
--,---,---,--9 (explicit)
RCMedia.Event
Number
CreateDate
None
DATE NOT NULL
YY/MM/DD (explicit)
CreateTime
None
FLOAT NOT NULL
99:99:99.99 (explicit)
Data Dictionary Quick Reference
577
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
EventType
None
CHAR(30) LATIN
NOT CASESPECIFIC NOT NULL
X(30)
UserName
Dbase.DatabaseName
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
ObjectId
None
BYTE(4) NOT NULL
X(8)
ObjectType
None
CHAR(1) LATIN
NOT CASESPECIFIC
X(1)
AllAmpsFlag
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
RestartSeqNum
RCConfiguration.
RestartSeqNum
SMALLINT
---,--9 (explicit)
TableName
TVM.TVMName
X(128)
CheckPointName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
LinkingEventNum
None
INTEGER
--,---,---,--9 (explicit)
OperationInProcess
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
DataSetName
None
VARCHAR(44) UNICODE
NOT CASESPECIFIC
X(44)
LockMode
None
CHAR(1) LATIN
NOT CASESPECIFIC
X(1)
RCMedia.Dupe
DumpSet
CHAR(1) LATIN
NOT CASESPECIFIC
X(1)
DatabaseName
JournalUsed
JournalSaved
IndexPresent
DupeDumpSet
RCMedia
Contains identification of storage media for events.
Columns
Referenced Column(s)
Data Type
Format
EventNumber (NUPI)
RCMediaEvent
Number
INTEGER NOT NULL
--,---,---,--9 (explicit)
VolSerialId
None
CHAR(6) LATIN
NOT CASESPECIFIC NOT NULL
X(6)
VolSequenceNum
None
SMALLINT
---,--9 (explicit)
578
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
DupeDumpSet
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
ReconfigDeleteOrderTbl
Establishes the order in which tables are processed in the Deletion phase. This Data
Dictionary table is accessed by both online and offline Reconfig.
Columns
Referenced Column(s)
Data Type
Format
OrderNumber (UPI)
None
INTEGER NOT NULL
ZZZZZZZZZ9
DatabaseName
(Composite USI)
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
CheckTableOption
None
BYTEINT
ZZ9
Reserved
None
VARCHAR(10000) LATIN
NOT CASESPECIFIC
X(10000)
ProcessOffline
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
TableName (Composite
USI)
ReconfigInfoTbl
Provides status and summary information for Reconfig.
Columns
Referenced
Column(s)
Data Type
Format
ReconfigId (UPI)
None
INTEGER NOT NULL
ZZZZZZZZZ9
Description
None
VARCHAR(512) UNICODE
NOT CASESPECIFIC
X(512)
ReconfigType
None
BYTEINT NOT NULL
ZZ9
BeginTimeStamp
None
TIMESTAMP(0) NOT NULL
YYYY-MM-DDBHH:MI:SS
EndTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
BeginRedistTimeStamp
EndRedistTimeStamp
BeginDelTimeStamp
EndDelTimeStamp
Data Dictionary Quick Reference
579
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced
Column(s)
Status
CurrByteCount
Data Type
Format
None
CHAR(10) LATIN
NOT CASESPECIFIC NOT NULL
X(10)
None
FLOAT NOT NULL
----,---,---,---,--9
None
SMALLINT
ZZZZ9
None
SMALLINT NOT NULL
ZZZZ9
TotTableCount
None
INTEGER NOT NULL
ZZZZZZZZZ9
TotByteCount
None
FLOAT NOT NULL
----,---,---,---,--9
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
CurrTabRedistCount
CurrTabDeleteCount
EstRemainRedistSecs
EstRemainDeleteSecs
AddAmpCount
DelAmpCount
MovAmpCount
ModAmpCount
NodeCount
TotTaskCount
TotCatchUpByteCount
TotJournalByteCount
ActualRedistSecs
ActualDeleteSecs
EstRedistSecs
EstDeleteSecs
BeginCalcHBTimeStamp
EndCalcHBTimeStamp
BeginWrSpaceTimeStamp
EndWrSpaceTimeStamp
BeginPHBNewTimeStamp
EndPHBNewTimeStamp
BeginFBHBNewTimeStamp
EndFBHBNewTimeStamp
BeginWrPHBTimeStamp
580
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced
Column(s)
Data Type
Format
EndWrPHBTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
None
VARCHAR(10000) LATIN
NOT CASESPECIFIC
X(10000)
BeginWrFBHBTimeStamp
EndWrFBHBTimeStamp
BeginWrCfgTimeStamp
EndWrCfgTimeStamp
BeginWrCfgNewTimeStamp
EndWrCfgNewTimeStamp
BeginWrBkupIdTimeStamp
EndWrBkupIdTimeStamp
BeginWrBMTimeStamp
EndWrBMTimeStamp
BeginDelHBNewTimeStamp
EndDelHBNewTimeStamp
BeginVProcCfgTimeStamp
EndVProcCfgTimeStamp
BeginTimeStamp1
EndTimeStamp1
BeginTimeStamp2
EndTimeStamp2
BeginTimeStamp3
EndTimeStamp3
BeginTimeStamp4
EndTimeStamp4
BeginTimeStamp5
EndTimeStamp5
Reserved
Data Dictionary Quick Reference
581
Chapter 4: Data Dictionary Tables
Table Column Formats
ReconfigRedistOrderTbl
Establishes the order in which tables are processed in the Redistribution phase.
This Data Dictionary table is accessed by both online and offline Reconfig.
Columns
Referenced Column(s)
Data Type
Format
OrderNumber (UPI)
None
INTEGER NOT NULL
ZZZZZZZZZ9
DatabaseName
(Composite USI)
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
Reserved
None
VARCHAR(10000) LATIN
NOT CASESPECIFIC
X(10000)
ProcessOffline
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
TableName (Composite
USI)
ReconfigTableStatsTbl
Stores Reconfig statistics.
Columns
Referenced Column(s)
Data Type
Format
DatabaseName
(Composite UPI)
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
ReconfigId (Composite
UPI)
None
INTEGER NOT NULL
ZZZZZZZZZ9
Phase (Composite UPI)
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
Status
None
BYTEINT
ZZ9
BeginTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
None
FLOAT NOT NULL
----,---,---,---,--9
None
SMALLINT
ZZZZ9
TableName (Composite
UPI)
EndTimeStamp
TotRowCount
TotByteCount
TotCPUSecs
TotIOCount
LowRowCount
LowRowCountAmp
582
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
HighRowCount
None
FLOAT NOT NULL
----,---,---,---,--9
HighRowCountAmp
None
SMALLINT
ZZZZ9
LowByteCount
None
FLOAT NOT NULL
----,---,---,---,--9
LowByteCountAmp
None
SMALLINT
ZZZZ9
HighByteCount
None
FLOAT NOT NULL
----,---,---,---,--9
HighByteCountAmp
None
SMALLINT
ZZZZ9
LowCPUSecsCount
None
FLOAT NOT NULL
----,---,---,---,--9
LowCPUSecsCountAmp
None
SMALLINT
ZZZZ9
HighCPUSecsCount
None
FLOAT NOT NULL
----,---,---,---,--9
HighCPUSecsCountAmp
None
SMALLINT
ZZZZ9
LowIOCount
None
FLOAT NOT NULL
----,---,---,---,--9
LowIOCountAmp
None
SMALLINT
ZZZZ9
HighIOCount
None
FLOAT NOT NULL
----,---,---,---,--9
HighIOCountAmp
None
SMALLINT
ZZZZ9
NUSICount
None
SMALLINT NOT NULL
ZZZZ9
FallBackFlag
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
DBlockSize
None
INTEGER NOT NULL
ZZZZZZZZZ9
None
FLOAT NOT NULL
----,---,---,---,--9
PartitionCount
ActualRedistSecs
ActualDeleteSecs
EstRedistSecs
EstDeleteSecs
FSGIOCount
FSysReadCount
FSysWriteCount
FSysMiscCount
MsgRcvCount
MsgSendCount
MsgMiscCount
MsgWaitRcvTime
Data Dictionary Quick Reference
583
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
None
INTEGER NOT NULL
ZZZZZZZZZ9
None
FLOAT NOT NULL
----,---,---,---,--9
Count10
None
FLOAT NOT NULL
----,---,---,---,--9
Reserved
None
VARCHAR(10000) LATIN
NOT CASESPECIFIC
X(10000)
MsgWaitSendTime
MsgWaitMiscTime
NoMemFlushCount
CkptFlushCount
Count1
Count2
Count3
Count4
Count5
Count6
Count7
Count8
Count9
ReferencedTbls
Contains information about the parent table of a referential constraint.
Columns
Referenced Column(s)
Data Type
Format
ReferencedDbID
(Composite NUPI)
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
ReferencedTblID
(Composite NUPI)
TVM.TVMId
TVFields.TableId
BYTE(6) NOT NULL
X(12)
ReferenceIdx
None
SMALLINT NOT NULL
---,--9 (explicit)
ParentKeyFID
TVFields.FieldId
SMALLINT NOT NULL
---,--9 (explicit)
ReferencingDbID
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
ReferencingTblID
TVM.TVMId
TVFields.TableId
BYTE(6) NOT NULL
X(12)
ForeignKeyFID
TVFields.FieldId
SMALLINT NOT NULL
---,--9 (explicit)
InconsistentFlag
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
584
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
ReferenceIdxName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
CreateUID
Dbase.DatabaseId
BYTE(4)
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
AccessCount
None
INTEGER
--,---,---,--9 (explicit)
VTPKType
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
LastAccessTimeStamp
TTPKType
VTFKType
TTFKType
ReferencingTbls
Contains information about the child table of a referential constraint.
Columns
Referenced Column(s)
Data Type
Format
ReferencingDbID
(Composite NUPI)
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
ReferencingTblID
(Composite NUPI)
TVM.TVMId
TVFields.TableId
BYTE(6) NOT NULL
X(12)
ReferenceIdx
None
SMALLINT NOT NULL
---.--9 (explicit)
ForeignKeyFID
TVFields.FieldId
SMALLINT NOT NULL
---.--9 (explicit)
ReferencedDbID
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
ReferencedTblID
TVM.TVMId
TVMFields.TableId
BYTE(6) NOT NULL
X(12)
ParentKeyFID
TVfields.FieldId
SMALLINT NOT NULL
---,--9 (explicit)
InconsistentFlag
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
ReferenceIdxName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
CreateUID
Dbase.DatabaseId
BYTE(4)
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
None
INTEGER
--,---,---,--9 (explicit)
LastAccessTimeStamp
AccessCount
Data Dictionary Quick Reference
585
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
VTFKType
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
TTFKType
VTPKType
TTPKType
RepBatchStatus
This table is an internal table.
Columns
Referenced Column(s)
Data Type
Format
RSQualifier (UPI)
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
BatchNum
None
BYTEINT NOT NULL
--9 (explicit)
CompletionStatus
None
CHAR(1) LATIN
NOT CASESPECIFIC
X(1)
CommitSeqNumber
None
BTYE(16)
X(32)
RepCaptureRulesTbl
Stores the user-defined replication capture rules.
Columns
Referenced Column(s)
Data Type
Format
GroupId (NUSI)
RepGroup.GroupId
RepRulesetTbl.GroupId
INTEGER NOT NULL
--,---,---,--9 (explicit)
RuleSetId (NUSI)
RepRulesetTbl.GroupId
INTEGER NOT NULL
--,---,---,--9 (explicit)
ObjectKind (NUPI)
None
CHAR(1) LATIN
UPPERCASE NOT
CASESPECIFIC NOT NULL
X(1)
LikePattern
None
VARCHAR(300) UNICODE
NOT CASESPECIFIC NOT
NULL
X(300)
LikeEscape
None
CHAR(1) UNICODE NOT
CASESPECIFIC
X(1)
NotLikePattern
None
VARCHAR(300) UNICODE
NOT CASESPECIFIC
X(300)
NotLikeEscape
None
CHAR(1) UNICODE NOT
CASESPECIFIC
X(1)
DefaultOption
586
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
RepGroup
Defines each replication group in the platform.
Columns
Referenced Column(s)
Data Type
Format
GroupNameI (UPI)
None
VARCHAR(128) UNICODE
UPPERCASE NOT CASESPECIFIC
NOT NULL
X(128)
GroupId (USI)
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
GroupLockId
None
BYTE(4) NOT NULL
X(8)
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
LastAlterUID
None
BYTE(4)
X(8)
LastAlterTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
Version
None
SMALLINT NOT NULL
---,--9 (explicit)
CommentString
None
VARCHAR(255) UNICODE
NOT CASESPECIFIC
X(255)
RequestText
None
VARCHAR(12500) UNICODE
NOT CASESPECIFIC
X(255) (explicit)
GroupName
CreateUID
GroupOperation
GroupStatus
ProtectMode
RepGroupTables
Lists each base table that is a member of a replication group.
Columns
Referenced Column(s)
Data Type
Format
GroupId (NUPI)
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
BaseTblId
None
BYTE (6) NOT NULL
X(12)
ErrorTblId
Data Dictionary Quick Reference
587
Chapter 4: Data Dictionary Tables
Table Column Formats
RepRulesetTbl
Contains one row for each rule set defined for a replication group.
Columns
Referenced Column(s)
Data Type
Format
GroupId (NUPI,
Composite USI)
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
RuleSetName (Composite
USI)
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT
NULL
X(128)
RuleSetId
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
Roles
Assigns privileges that allow the user to access different objects and operations.
Columns
Referenced Column(s)
Data Type
Format
RoleNameI (UPI)
None
VARCHAR(128) UNICODE
UPPERCASE NOT
CASESPECIFIC NOT NULL
X(128)
RoleName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
RoleId (USI)
AccessRights.UserId
BYTE(4) NOT NULL
X(8)
CreateUID
None
BYTE(4) NOT NULL
X(8)
CommentString
None
VARCHAR(255) UNICODE
NOT CASESPECIFIC
X(255)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
ExtRole
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
RoleGrants
Contains roles granted to users or other roles.
Columns
Referenced Column(s)
Data Type
Format
GranteeId (NUPI,
Composite USI)
None
BYTE(4) NOT NULL
X(8)
GranteeKind
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
RoleId (Composite USI)
Roles.RoleId
BYTE(4) NOT NULL
X(8)
588
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
WithAdmin
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
GrantorID
None
BYTE(4) NOT NULL
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
Routine_JAR_Usage
Contains one row for each Java external stored procedure or Java user-defined function that
names a JAR in its external Java reference string.
This table shows the dependency of a Java external stored procedure on a given JAR.
Columns
Referenced Column(s)
Data Type
Format
JarId (NUPI)
TVM.TVMId
BYTE(6) NOT NULL
X(12)
JarName
None
VARCHAR(128) UNICODE
UPPERCASE NOT
CASESPECIFIC NOT NULL
X(128)
RoutineId (USI)
TVM.TVMId
BYTE(6) NOT NULL
X(12)
RoutineName
None
VARCHAR(128) UNICODE
UPPERCASE NOT
CASESPECIFIC NOT NULL
X(128)
DatabaseId
Dbase.DatabaseId
TVM.DatabaseId
BYTE(4) NOT NULL
X(8)
Signature
None
VARCHAR(6400) LATIN
CASESPECIFIC
X(255)
SecConstraints
Contains the security constraint objects defined for a system.
Note: The SecConstraints table is reserved for future use.
Columns
Referenced Column(s)
Data Type
Format
ConstraintName (UPI)
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
ConstraintId (USI)
None
BYTE(4) NOT NULL
X(8)
DataType
None
CHAR(2) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(2)
ColumnWidth
None
SMALLINT NOT NULL
-(5)9
InUseCount
Data Dictionary Quick Reference
589
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
Nullable
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
RequestText
None
VARCHAR(12500) UNICODE
NOT CASESPECIFIC
X(255)
RequestTxtOverflow
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
CreateUID
None
BYTE(4) NOT NULL
X(8)
CommentString
None
VARCHAR(255) UNICODE
NOT CASESPECIFIC
X(255)
CreateTimeStamp
None
TIMESTAMP(0) NOT NULL
YYYY-MMDDBHH:MI:SS.S(F)
LastAlterTimeStamp
None
TIMESTAMP(0) NOT NULL
YYYY-MMDDBHH:MI:SS.S(F)
LastAlterUID
None
BYTE(4) NOT NULL
X(8)
SessionTbl
Contains current user logon information.
Columns
Referenced Column(s)
Data Type
Format
HostNo (Composite UPI)
TempTables.HostNo
SMALLINT NOT NULL
---,--9 (explicit)
SessionNo (Composite
UPI)
TempTables.
SessionNo
INTEGER NOT NULL
--,---,---,--9 (explicit)
IFPNo
None
SMALLINT NOT NULL
-(5)9
LogonDate
None
DATE NOT NULL
YY/MM/DD (explicit)
LogonTime
None
FLOAT NOT NULL
99:99:99.99 (explicit)
LogonCollation
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
LogonDatabase
Dbase.DatabaseName
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
CurrentCollation
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
CurrentDatabase
Dbase.DatabaseName
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
UserId
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
AccountName
Dbase.AccountName
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
UserName
590
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
StartMBox
None
BYTE(10)
X(20)
Partition
None
CHAR(16) LATIN
NOT CASESPECIFIC
X(20) (explicit)
PartCode
None
BYTEINT
--9 (explicit)
LogonSource
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
LogonSequenceNo
None
BYTE(4)
X(8)
LogicalHostId
None
SMALLINT NOT NULL
ZZZ9 (explicit)
ConnectFunction
None
SMALLINT NOT NULL
---,--9 (explicit)
Options
None
CHAR(10) LATIN
NOT CASESPECIFIC NOT NULL
X(10)
ExpiredPassword
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
TimeZoneHour
None
BYTEINT
---9 (explicit)
CurrentDateForm
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
DefaultCharType
None
SMALLINT NOT NULL
---,--9 (explicit)
RepSesOverride
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
CurrentRole
Roles.RoleName
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
LogonAcct
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
ProfileName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
LDAP
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
ExternalRoles
None
VARCHAR(1934) UNICODE
NOT CASESPECIFIC
X(464)
AuditTrailId
None
VARCHAR(128) UNICODE
UPPERCASE NOT
CASESPECIFIC NOT NULL
X(128)
SessionVproc
None
SMALLINT
---,--9 (explicit)
ContMBox
AbortMBox
TimeZoneMinute
Data Dictionary Quick Reference
591
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
ExtAuth
None
CHAR(1) LATIN
NOT CASESPECIFIC
X(1)
AuthMethod
None
BYTEINT
--9 (explicit)
AuthUser
None
VARCHAR(256) UNICODE
UPPERCASE NOT
CASESPECIFIC
X(256)
MechanismOid
None
VARBYTE(32)
X(64)
MechData
None
VARBYTE(528)
X(1056)
IsolationLevel
None
CHAR(2) LATIN
NOT CASESPECIFIC NOT NULL
X(2)
RFU
None
VARBYTE(1024)
X(2048)
ClientLogonDiagnostics
None
VARCHAR(1024) LATIN
NOT CASESPECIFIC
X(1024)
ExtendedLogonSource
None
VARCHAR(2048) UNICODE
NOT CASESPECIFIC
X(2048)
ClientIpAddress
None
VARCHAR(45) UNICODE
NOT CASESPECIFIC
X(45)
ClientProgramName
None
VARCHAR(1024) UNICODE
NOT CASESPECIFIC
X(1024)
ClientSystemUserId
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
QueryBand
None
VARCHAR(2048) UNICODE
NOT CASESPECIFIC
X(2048)
LogonCharSet
None
BYTEINT NOT NULL
ZZ9
ProxyUser
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
ProxyUserId
None
BYTE(4)
X(8)
ProxyCurRole
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
ProxyDfltRole
None
CHAR(1) LATIN NOT
CASESPECIFIC
X(1)
TimeZoneString
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
TemporalQualifier
None
VARCHAR(1024) LATIN NOT
CASESPECIFIC
X(1024)
CalendarName
None
VARCHAR(128) UNICODE NOT
CASESPECIFIC
X(128)
592
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
Constraint1Id
None
BYTE(4)
X(8)
Constraint1Val
None
SMALLINT
-(5)9
Constraint2Id
None
BYTE(4)
X(8)
Constraint2Val
None
SMALLINT
-(5)9
Constraint3Id
None
BYTE(4)
X(8)
Constraint3Val
None
SMALLINT
-(5)9
Constraint4Id
None
BYTE(4)
X(8)
Constraint4Val
None
SMALLINT
-(5)9
Constraint5Id
None
BYTE(4)
X(8)
Constraint5Val
None
VARBYTE(32)
X(64)
Constraint6Id
None
BYTE(4)
X(8)
Constraint6Val
None
VARBYTE(32)
X(64)
Constraint7Id
None
BYTE(4)
X(8)
Constraint7Val
None
VARBYTE(32)
X(64)
Constraint8Id
None
BYTE(4)
X(8)
Constraint8Val
None
VARBYTE(32)
X(64)
ClientConnectionType
None
BYTEINT
--9
ClientCoordName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
ClientTcpPortNumber
None
INTEGER
--,---,---,--9
ClientTdHostName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
ClientEnvName
ClientJobId
ClientJobName
ClientOsName
ClientProcThreadId
ClientSecProdGrp
ClientSecProdUserId
ClientTerminalId
ClientTransactionId
ClientUserOperId
ClientVmName
Data Dictionary Quick Reference
593
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
ClientVmUserId
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
MechanismName
ClientTDPReleaseId
ClientCLIv2ReleaseId
ClientSessionDesc
ClientWorkload
ClientJobData
StatsTbl
Saves the information about collected statistics on base tables, hash and join indexes, views,
and queries.
Note: Although this table is visible and has been defined, it is not populated with any rows. It
will be populated with rows in a future release.
Columns
Referenced Column(s)
Data Type
Format
DatabaseId
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
TableId (NUPI,
Composite USI)
TVM.TVMId
BYTE(6) NOT NULL
X(12)
ParentId
TVM.TVMId
BYTE(6)
X(12)
QueryStatsTbl.
TableId
QueryStatsTbl.
TableId
StatsId (Composite USI)
None
INTEGER NOT NULL
--,---,---,--9
SampleSizePct
None
SMALLINT
--9
IndexNumber
Indexes.IndexNumber
SMALLINT
---,--9
StatsType
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
DBSVersion
None
CHAR(32) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(32)
ExpressionList
None
VARCHAR(10000) UNICODE
UPPERCASE NOT
CASESPECIFIC
X(255)
ExpressionListOverFlow
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
594
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
ExpressionDataType
None
VARCHAR(1000) LATIN
UPPERCASE
NOT CASESPECIFIC
X(255)
ExpressionCount
None
SMALLINT
---,--9
FieldId
TVFields.FieldId
SMALLINT
---,--9
PartitionList
None
VARCHAR(5000) LATIN
UPPERCASE NOT
CASESPECIFIC
X(255)
RefObjects
None
VARCHAR(5000) UNICODE
UPPERCASE NOT
CASESPECIFIC
X(255)
RefObjectsOverFlow
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
RefColumns
None
VARCHAR(5000) UNICODE
UPPERCASE
NOT CASESPECIFIC
X(255)
RefColumnsOverFlow
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
GroupByList
None
VARCHAR(5000) UNICODE
UPPERCASE
NOT CASESPECIFIC
X(255)
GroupByListOverFlow
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
BuiltInFcnValues
None
VARCHAR(1000) UNICODE
UPPERCASE NOT
CASESPECIFIC
X(255)
RefCount
None
INTEGER
--,---,---,--9
Source
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
ObjectState
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
NumAMPs
None
SMALLINT
---,--9
CPUCost
None
FLOAT
----,---,---,---,--9.99
None
FLOAT
----,---,---,---,--9
RollingExpression
EstPerDayGrowthPct
RowCount
Data Dictionary Quick Reference
595
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
BaseRowCount
None
FLOAT
----,---,---,---,--9
OneAMPRASDeviation
Pct
None
FLOAT
-----,---,---,--9.99
AllAMPRASDeviationPct
None
FLOAT
-----,---,---,--9.99
ValidStats
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
UsageType
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
IntReserved1
None
INTEGER
--,---,---,--9
None
FLOAT
----,---,---,---,--9
None
CHAR(5) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
CharReserved3
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
AccessCount
None
INTEGER
--,---,---,--9
LastAccessTimeStamp
None
TIMESTAMP(0)
YYYY-MMDDBHH:MI:SS.S(F)
CreateUID
None
BYTE(4)
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MMDDBHH:MI:SS.S(F)
LastAlterUID
None
BYTE(4)
X(8)
LastAlterTimeStamp
None
TIMESTAMP(0)
YYYY-MMDDBHH:MI:SS.S(F)
Histogram
None
BLOB (10285760)
X(255)
UniqueValueCount
NullCount
AllNullCount
HighModeFreq
ThresholdPct
Entropy
IntReserved2
FloatReserved1
FloatReserved2
CharReserved1
CharReserved2
596
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
SW_Event_Log
Contains information about database system errors and software events and is used by
Teradata Database field engineers. The system inserts rows in response to software error
conditions.
Columns
Referenced Column(s)
Data Type
Format
TheDate (Composite
NUPI)
None
DATE NOT NULL
YY/MM/DD (explicit)
TheTime (Composite
NUPI)
None
FLOAT NOT NULL
99:99:99.999999 (explicit)
Event_Tag
None
INTEGER NOT NULL
Z99-99999-99 (explicit)
Category
None
BYTEINT
Z9 (explicit)
Severity
None
SMALLINT
ZZ9 (explicit)
PMA
None
INTEGER
ZZ9-99 (explicit)
Vproc
None
INTEGER
-(5)9 (explicit)
Partition
None
BYTEINT
Z9 (explicit)
Task
None
SMALLINT
ZZZZ9 (explicit)
TheFunction
None
VARCHAR(32) LATIN
NOT CASESPECIFIC
X(32)
SW_Version
None
VARCHAR(64) LATIN
NOT CASESPECIFIC
X(64)
Line
None
BYTEINT NOT NULL
ZZ9 (explicit)
Text
None
VARCHAR(30000) UNICODE
NOT CASESPECIFIC NOT NULL
X(255)
SysSecDefaults
Provides system security default information.
Note: The user password security controls affect only those passwords authenticated by
Teradata Database and does not affect externally authenticated user passwords.
Columns
Referenced Column(s)
Data Type
Format
PrimeIndex (UPI)
None
BYTEINT NOT NULL
--9 (explicit)
ExpirePassword
None
SMALLINT NOT NULL
---,--9 (explicit)
PasswordMinChar
None
BYTEINT NOT NULL
--9 (explicit)
PasswordMaxChar
Data Dictionary Quick Reference
597
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
PasswordDigits
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
PasswordSpecChar
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
MaxLogonAttempts
None
BYTEINT NOT NULL
---9 (explicit)
LockedUserExpire
None
SMALLINT NOT NULL
---,--9 (explicit)
PasswordRestrictWords
PasswordReuse
598
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
SystemQTbl
Allows programs to be notified about exceptions or events that have occurred.
Columns
Referenced Column(s)
Data Type
Format
QEventTS (NUPI)
None
TIMESTAMP(6) NOT NULL
YYYY-MMDDBHH:MI:SS.S(F)
RowType
None
INTEGER NOT NULL
--,---,---,--9
EventComboName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
EventComboID
None
INTEGER
--,---,---,--9
EventComboStatus
None
SMALLINT
ZZZ9
EventHistoryTS
None
TIMESTAMP(6)
YYYY-MMDDBHH:MI:SS.S(F)
EventBeginComment
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
None
INTEGER
--,---,---,--9
LogicalHostID
None
SMALLINT
ZZZ9
AccountString
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
QueryID
None
DECIMAL(18,0)
--Z(17)9
ExtraValue
None
INTEGER
--,---,---,--9
None
FLOAT
----,---,---,---,--9
Teradata
EventEndComment
Teradata
UserName
SessionID
RequestNum
Teradata
ExtraValue2
TableConstraints
Contains a row for each table-level constraint defined in the system.
Columns
Referenced Column(s)
Data Type
Format
TVMId (NUPI)
TVM.TVMId
BYTE(6) NOT NULL
X(12)
Name
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
Data Dictionary Quick Reference
599
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
DBaseId
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
TableCheck
None
VARCHAR(16000) UNICODE
CASESPECIFIC
X(255) (explicit)
CreateUID
Dbase.DatabaseId
BYTE(4)
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
AccessCount
None
INTEGER
--,---,---,--9 (explicit)
ConstraintType
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
IndexNumber
None
SMALLINT
---,--9 (explicit)
ConstraintCollation
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
CollName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
CharSetID
None
BYTEINT
ZZ9
SessionMode
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
TTCheckType
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
ResolvedCurrent_Date
None
DATE
YY/MM/DD
ResolvedCurrent_Time
stamp
None
TIMESTAMP(6)
YYYY-MMDDBHH:MI:SS.S(F)Z
LastAccessTimeStamp
• Teradata
VTCheckType
600
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
TDWMEventHistory
Provides a means by which an end user can discover the sequence of states and events that
occurred at any point in time.
Columns
Referenced Column(s)
Data Type
Format
ProcID (Composite
NUPI)
None
DECIMAL(5,0) NOT NULL
-(5)9 (explicit)
BufferTS (Composite
NUPI)
None
TIMESTAMP(2) NOT NULL
YYYY-MM-DDBHH:MI:SS
(explicit)
EntryTS
None
TIMESTAMP(2) NOT NULL
YYYY-MM-DDBHH:MI:SS.S(F)Z
EntryKind
None
CHAR(10) LATIN
NOT CASESPECIFIC
X(10)
EntryID
None
INTEGER
--,---,---,--9 (explicit)
EntryName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
EventValue
None
FLOAT
----,---,---, ---,--9 (explicit)
Activity
None
CHAR(10) LATIN
NOT CASESPECIFIC
X(10)
ActivityId
None
INTEGER
--,---,---,--9 (explicit)
ActivityName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
ConfigId
None
INTEGER
--,---,---,--9 (explicit)
SeqNo
None
SMALLINT
ZZZ9
Spare1
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
Spare2
None
INTEGER
--,---,---,--9 (explicit)
Spare3
None
FLOAT
----,---,---, ---,--9 (explicit)
LastValue
Data Dictionary Quick Reference
601
Chapter 4: Data Dictionary Tables
Table Column Formats
TDWMEventLog
Contains Teradata Database events that could affect the Teradata dynamic workload
management software.
Columns
Referenced Column(s)
Data Type
Format
ProcID (Composite
NUPI)
None
DECIMAL(5,0) NOT NULL
-(5)9 (explicit)
BufferTS (Composite
NUPI)
None
TIMESTAMP(2) NOT NULL
YYYY-MM-DDBHH:MI:SS
(explicit)
SessionID
None
INTEGER
--,---,---,--9 (explicit)
LogicalHostID
None
SMALLINT
ZZZ9 (explicit)
WDID
None
INTEGER
--,---,---,--9 (explicit)
EventTime
None
TIMESTAMP(2) NOT NULL
YYYY-MMDDBHH:MI:SS.S(F)Z (explicit)
EventCode
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
EventSubCode
None
INTEGER
--,---,---,--9 (explicit)
ScopeValue
None
SMALLINT
ZZZ9 (explicit)
EventInfo
None
VARCHAR(200) UNICODE
NOT CASESPECIFIC
X(200)
OpenEnvID
SysConID
TDWMExceptionLog
Contains the results of the query affected by Teradata dynamic workload management
software exception handling.
Columns
Referenced Column(s)
Data Type
Format
ProcID (Composite
NUPI)
None
DECIMAL(5,0) NOT NULL
-(5)9 (explicit)
BufferTS (Composite
NUPI)
None
TIMESTAMP(2) NOT NULL
YYYY-MM-DDBHH:MI:SS
(explicit)
QueryID
None
DECIMAL(18,0) NOT NULL
--Z(17)9
UserName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
SessionID
None
INTEGER
--,---,---,--9 (explicit)
RequestNum
None
INTEGER
--,---,---,--9 (explicit)
602
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
LogicalHostID
None
SMALLINT
ZZZ9 (explicit)
AcctString (unexpanded)
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
WDID
None
INTEGER
--,---,---,--9 (explicit)
ClassificationTime
None
TIMESTAMP(2)
YYYY-MMDDBHH:MI:SS.S(F)Z
(explicit)
ExceptionTime
None
TIMESTAMP(2) NOT NULL
YYYY-MMDDBHH:MI:SS.S(F)Z
(explicit)
ExceptionValue
None
INTEGER
--,---,---,--9 (explicit)
ExceptionAction
None
CHAR(10) LATIN
NOT CASESPECIFIC
X(10)
NewWDID
None
INTEGER
--,---,---,--9 (explicit)
ExceptionCode
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
ExceptionSubCode
None
INTEGER
--,---,---,--9 (explicit)
ErrorText
None
VARCHAR(1024) UNICODE
NOT CASESPECIFIC
X(255)
ExtraInfo
None
VARCHAR(200) UNICODE
NOT CASESPECIFIC
X(200)
RuleID
None
INTEGER
--,---,---,--9 (explicit)
WarningOnly
None
CHAR(1) LATIN
NOT CASESPECIFIC
X(1)
RejectionCat
None
SMALLINT
ZZZ9
OpEnvID
SysConID
TDWMSummaryLog
Contains a summary of the activity of each WD.
Columns
Referenced Column(s)
Data Type
Format
ProcID (Composite
NUPI)
None
DECIMAL(5,0) NOT NULL
-(5)9 (explicit)
BufferTS (Composite
NUPI)
None
TIMESTAMP(2) NOT NULL
YYYY-MM-DDBHH:MI:SS
(explicit)
WDID
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
Data Dictionary Quick Reference
603
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
OpEnvID
None
INTEGER
--,---,---,--9 (explicit)
StartColTime
None
TIMESTAMP(2) NOT NULL
YYYY-MMDDBHH:MI:SS.S(F)Z
(explicit)
Arrivals
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
None
FLOAT NOT NULL
----,---,---,---,--9 (explicit)
DelayedCount
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
AvgDelayTime
None
FLOAT NOT NULL
----,---,---,---,--9 (explicit)
ExceptionAbCount
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
SysConID
ActiveCount
Completions
MinRespTime
MaxRespTime
AvgRespTime
MinCPUTime
MaxCPUTime
AvgCPUTime
ExceptionMvCount
ExceptionCoCount
MetSLGCount
AbortCount
ErrorCount
RejectedCount
MovedInCount
IntervalDelayCnt
DelayedQueries
604
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
OtherCount
Returns the number of
queries that finished in
this WD in this
dashboard interval (used
for the API data) or
logging interval (used for
logging to disk) with:
1 No error code
2 No abort flag
3 No AMP count
4 No parser CPU
TempTables
Contains a row for each materialized global temporary table in the system.
Columns
Referenced Column(s)
Data Type
Format
HostNo (Composite
NUPI)
SessionTbl.HostNo
SMALLINT NOT NULL
---,--9 (explicit)
SessionNo (Composite
NUPI)
SessionTbl.SessionNo
INTEGER NOT NULL
--,---,---,--9 (explicit)
TableId
TVM.TVMId
BYTE(6) NOT NULL
X(12)
BaseDbId
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
BaseTableId
TVM.TVMId
BYTE(6) NOT NULL
X(12)
AccountDbId
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
StatisticsCnt
None
SMALLINT NOT NULL
---,--9 (explicit)
TextTbl
Saves the "CreateText" and/or "RequestText" in case the text cannot fit in the DBC.TVM row.
Columns
Referenced Column(s)
Data Type
Format
TextId (NUPI)
None
BYTE(6) NOT NULL
X(12)
TextType
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
LineNo
None
SMALLINT NOT NULL
---,--9 (explicit)
TextString
None
VARCHAR(32000) UNICODE
NOT CASESPECIFIC NOT NULL
X(255) (explicit)
Data Dictionary Quick Reference
605
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
DatabaseId
None
BYTE(4) NOT NULL
X(8)
Translation
Contains information about the character translation tables used.
Columns
Referenced Column(s)
Data Type
Format
TranslateName (UPI)
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
TranslateID (USI)
None
BYTEINT NOT NULL
ZZ9 (explicit)
Install
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
TranslateIn
None
BYTE(256) NOT NULL
X(512)
TranslateInUp
TranslateOut
TranslateOutUp
TriggersTbl
Contains a row for each trigger in the system.
Columns
Referenced Column(s)
Data Type
Format
TableId (NUPI)
TVM.TVMId
BYTE(6) NOT NULL
X(12)
DatabaseID
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
TriggerName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
TriggerEnabled
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
TriggerOrder
None
SMALLINT
---,--9 (explicit)
CommentString
None
VARCHAR(255) UNICODE
NOT CASESPECIFIC
X(255)
CreateText
None
VARCHAR(13000) UNICODE
NOT CASESPECIFIC
X(255)
TriggerId (USI)
ActionTime
TriggerEvent
Kind
606
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
CreateUID
Dbase.DatabaseId
BYTE(4)
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
LastAlterUID
Dbase.DatabaseId
BYTE(4)
X(8)
LastAlterTimeStamp
None
TIMESTAMP(0)
YYYY-MM-DDBHH:MI:SS
AccessCount
None
INTEGER
--,---,---,--9 (explicit)
SubjectTabDbaseId
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
CreateTxtOverflow
TVM.CreateTxt
Overflow
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
VTEventType
None
CHAR(1) LATIN NOT
CASESPECIFIC
X(1)
TTEventType
None
CHAR(1) LATIN NOT
CASESPECIFIC
X(1)
LastAccessTimeStamp
TSETQueryText
When a query fails with a 3610 error, DBC.TSETQueryText table receives diagnostic
information about the SQL statement that caused the error. Teradata Vital Infrastructure
(TVI) notifies the DBA to run the command line Teradata System Emulation Tool (Teradata
SET) to export this information, which TVI sends to the Global Support Center for use in
debugging.
Columns
Referenced Column(s)
Data Type
Format
QueryID (UPI)
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
ErrorCode
None
INTEGER NOT NULL
----------9 (explicit)
Handled
None
BYTEINT NOT NULL
--9 (explicit)
Quartette
None
TIMESTAMP(0) NOT NULL
YYYY-MM-DDBHH:MI:SS
DefaultDatabase
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
QueryText
None
VARCHAR(31000) UNICODE
NOT CASESPECIFIC NOT NULL
X(31000)
TemporalQualifier
None
VARCHAR(1024) LATIN NOT
CASESPECIFIC
X(1024)
Teradata
Data Dictionary Quick Reference
607
Chapter 4: Data Dictionary Tables
Table Column Formats
TVFields
Contains one row for each occurrence of the following objects in the system:
•
Column of a table, view, join index, and hash index.
•
Parameter for a macro, stored procedure, user-defined type, user-defined method, userdefined function, and external stored procedure.
Columns
Referenced Column(s)
Data Type
Format
TableId (NUPI, Composite
USI)
Accessrights.TVMId
BYTE(6) NOT NULL
X(12)
ReferencingTbls.
ReferencingTblId
ReferencedTbls.
ReferencedTblId
TVM.TVMId
FieldName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
FieldId (Composite USI)
Accessrights.FieldId
SMALLINT NOT NULL
---,--9 (explicit)
ReferencingTbls.
ForeignKeyFID
ReferencedTbls.
ParentKeyFID
Indexes.FieldId
Nullable
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
FieldType
None
CHAR(2) LATIN UPPERCASE
NOT CASESPECIFIC
X(2)
None
CHAR(2) LATIN UPPERCASE
NOT CASESPECIFIC
X(2)
Note: Data Dictionary
None
CHAR(2) LATIN UPPERCASE
NOT CASESPECIFIC
X(2)
MaxLength
None
INTEGER
--,---,---,--9 (explicit)
DefaultValue
None
VARCHAR(1024) UNICODE
NOT CASESPECIFIC
X(1024) (explicit)
DefaultValueI
None
VARBYTE(1024)
X(1024)
TotalDigits
None
SMALLINT
---,--9 (explicit)
FieldFormat
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
FieldTitle
None
VARCHAR(256) UNICODE
NOT CASESPECIFIC
X(256)
ImpliedPoint
608
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
CommentString
None
VARCHAR(255) UNICODE
NOT CASESPECIFIC
X(255)
CollationFlag
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
DatabaseId
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
Compressible
None
CHAR(1) LATIN
NOT CASESPECIFIC
X(1)
CompressValueList
None
VARCHAR(8192) UNICODE
NOT CASESPECIFIC
X(8192)
FieldStatistics
None
VARBYTE(16383)
X(255) (explicit)
ColumnCheck
None
VARCHAR(8192) UNICODE
NOT CASESPECIFIC
X(255) (explicit)
CheckCount
None
SMALLINT NOT NULL
---,--9 (explicit)
CreateUID
Dbase.DatabaseId
BYTE(4)
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MMDDBHH:MI:SS
LastAlterUID
Dbase.DatabaseId
BYTE(4)
X(8)
LastAlterTimeStamp
None
TIMESTAMP(0)
YYYY-MMDDBHH:MI:SS
AccessCount
None
INTEGER
--,---,---,--9 (explicit)
SPParameterType
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
CharType
None
SMALLINT
---,--9 (explicit)
IdColType
None
CHAR(2) LATIN UPPERCASE
NOT CASESPECIFIC
X(2)
UDTypeId
None
BYTE(6)
X(12)
UDTName
None
VARCHAR(128) UNICODE
UPPERCASE
NOT CASESPECIFIC
X(128)
TimeDimension
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
UpperCaseFlag
LastAccessTimeStamp
LobSequenceNo
Returns the ValidTime and
TransactionTime properties
for a period column.
VTCheckType
Data Dictionary Quick Reference
609
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
TTCheckType
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
ConstraintID
None
BYTE(4)
X(8)
TVM
Contains one row for each table, view, trigger, stored procedure, join index, hash index,
macro, user-defined type, user-defined method, user-defined function, external stored
procedure, and JAR in the system.
Columns
Referenced Column(s)
Data Type
Format
DatabaseId (Composite UPI)
Accessrights.DatabaseId
BYTE(4) NOT NULL
X(8)
Owners.owneeId
Dbase.DatabaseId
TVMNameI (Composite
UPI)
None
VARCHAR(128) UNICODE
UPPERCASE NOT
CASESPECIFIC NOT NULL
X(128)
LogicalHostId
None
SMALLINT
ZZZ9 (explicit)
SessionNo
None
INTEGER
--,---,---,--9 (explicit)
TVMId (USI)
AccLogRuleTbl.TVMId
BYTE(6) NOT NULL
X(12)
DatabaseSpace.TableId
Accessrights.TVMId
Temptables.BaseTableId
ReferencingTbls.
ReferencingTblId
ReferencedTbls.
ReferencedTblId
DBCAssociation.TVMId
TVFields.TableId
Dbase.JournalId
Indexes.TableId
Tableconstraints.TVMId
UDFInfo.FunctionId
TableKind
UDFInfo.Function
Type
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
ProtectionType
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
610
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
TempFlag
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
HashFlag
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
NextIndexId
None
SMALLINT NOT NULL
---,--9
Version
None
SMALLINT NOT NULL
---,--9 (explicit)
RequestText
None
VARCHAR(12500) UNICODE
NOT CASESPECIFIC
X(255)
CreateText
None
VARCHAR(13000) UNICODE
NOT CASESPECIFIC
X(255)
CommentString
None
VARCHAR(255) UNICODE
NOT CASESPECIFIC
X(255)
CreatorName
Dbase.DatabaseName
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
TVMName (NUSI)
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC NOT NULL
X(128)
JournalFlag
None
CHAR(2) LATIN
NOT CASESPECIFIC NOT NULL
X(2)
JournalId
None
BYTE(6)
X(12)
UtilVersion
None
SMALLINT
---,--9 (explicit)
AccLogRules
None
CHAR(1) LATIN
NOT CASESPECIFIC NOT NULL
X(1)
ColumnAccRules
None
SMALLINT NOT NULL
---,--9 (explicit)
CheckOpt
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
ParentCount
None
SMALLINT NOT NULL
---,--9 (explicit)
UnnamedTblCheckExist
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
PrimaryKeyIndexId
None
SMALLINT
---,--9 (explicit)
CreateUID
Dbase.DatabaseId
BYTE(4)
X(8)
CreateTimeStamp
None
TIMESTAMP(0)
YYYY-MMDDBHH:MI:SS
LastAlterUID
Dbase.DatabaseId
BYTE(4)
X(8)
NextFieIdId
ChildCount
NamedTblCheckCount
Data Dictionary Quick Reference
611
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
LastAlterTimeStamp
None
TIMESTAMP(0)
YYYY-MMDDBHH:MI:SS
TriggerCount
None
SMALLINT NOT NULL
---,--9 (explicit)
CommitOpt
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
LastAccessTimeStamp
None
TIMESTAMP(0)
YYYY-MMDDBHH:MI:SS
AccessCount
None
INTEGER
--,---,---,--9 (explicit)
SPObjectCodeRows
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
RSGroupID
None
INTEGER
--,---,---,--9 (explicit)
TblRole
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
TblStatus
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
QueueFlag
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
XSPExternalName
None
CHAR(30) LATIN
CASESPECIFIC
X(30)
XSPOptions
None
CHAR(3) LATIN UPPERCASE
NOT CASESPECIFIC
X(3)
XSPExtFileReference
None
VARCHAR(1000) UNICODE
CASESPECIFIC
X(255) (explicit)
ExecProtectionMode
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
CharacterType
None
SMALLINT
---,--9 (explicit)
Platform
None
CHAR(8) LATIN UPPERCASE
NOT CASESPECIFIC
X(8)
AuthIdUsed
None
BYTE(6)
X(8) (explicit)
AuthorizationType
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
None
VARCHAR(256) LATIN
CASESPECIFIC
X(256)
None
VARBYTE(256)
X(512)
TransLog
RequestTxtOverflow
CreateTxtOverflow
AuthorizationSubType
OSDomainName
OSUserName
SecInfo
612
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
AuthName
None
VARCHAR(128) UNICODE
UPPERCASE NOT
CASESPECIFIC
X(128)
TemporalProperty
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
ResolvedCurrent_Date
None
DATE
YY/MM/DD
ResolvedCurrent_Time
stamp
None
TIMESTAMP(6)
YYYY-MMDDBHH:MI:SS.S(F)Z
SystemDefinedJI
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
VTQualifier
TTQualifier
UDFInfo
Contains all the function and method information.
Columns
Referenced Column(s)
Data Type
Format
DatabaseId (Composite
NUPI)
Dbase.DatabaseId
TVM.DatabaseId
BYTE(4) NOT NULL
X(8)
FunctionName
(Composite NUPI)
None
VARCHAR(128) UNICODE
UPPERCASE
NOT CASESPECIFIC NOT NULL
X(128)
FunctionId (USI)
TVM.TVMId
BYTE(6) NOT NULL
X(12)
NumParameters
None
SMALLINT NOT NULL
---,--9 (explicit)
ParameterDataTypes
None
VARCHAR(256) LATIN
UPPERCASE
NOT CASESPECIFIC
X(255) (explicit)
FunctionType
TVM.TableKind
CHAR(1) LATIN
UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
ExternalName
None
CHAR(30) LATIN
CASESPECIFIC NOT NULL
X(128)
SrcFileLanguage
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
NoSQLDataAccess
ParameterStyle
DeterministicOpt
NullCall
Data Dictionary Quick Reference
613
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
PrepareCount
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
ExecProtectionMode
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
ExtFileReference
None
VARCHAR(1000) UNICODE
CASESPECIFIC
X(255) (explicit)
CharacterType
None
SMALLINT NOT NULL
---,--9 (explicit)
Platform
None
CHAR(8) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(8)
RoutineKind
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
ParameterUDTIds
None
VARBYTE(512)
X(512) (explicit)
InterimFldSize
None
INTEGER NOT NULL
--,---,---,--9 (explicit)
MaxOutParameters
None
SMALLINT NOT NULL
---,--9 (explicit)
AppCategory
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
GLOPSetDatabaseName
None
VARCHAR(128) UNICODE
UPPERCASE NOT
CASESPECIFIC
X(128)
GLOPSetMemberName
UnResolvedReferences
Contains information about all the unresolved referential constraints that currently exist in
the system.
Columns
Referenced Column(s)
Data Type
Format
DatabaseID (Composite
NUPI)
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
ParentTblName
(Composite NUPI)
TVM.TVMNameI
VARCHAR(128) UNICODE
UPPERCASE
NOT CASESPECIFIC NOT NULL
X(128)
UserID
Dbase.DatabaseId
BYTE(4) NOT NULL
X(8)
ReferenceIdx
None
SMALLINT NOT NULL
---,--9 (explicit)
ChildTblID
TVM.TVMId
BYTE(6) NOT NULL
X(12)
ForeignKeyFID
TVMFields.TVMId
SMALLINT NOT NULL
---,--9 (explicit)
FKPosition
None
614
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
Columns
Referenced Column(s)
Data Type
Format
ParentKeyName
None
VARCHAR(128) UNICODE
UPPERCASE
NOT CASESPECIFIC
X(128)
ReferenceIdxName
None
VARCHAR(128) UNICODE
NOT CASESPECIFIC
X(128)
VTFKType
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
TTFKType
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
UDTCast
Contains information on the source and target data types that are involved in the casting
operation.
Columns
Referenced Column(s)
Data Type
Format
PrimaryUDTypeId
(Composite NUPI,
Composite USI)
None
BYTE(6) NOT NULL
X(12)
IsSourcePrimary
(Composite NUPI,
Composite USI)
None
CHAR(2) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(2)
PDTFamily (Composite
NUPI)
None
CHAR(2) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(2)
SecondaryUDTypeId
(Composite USI)
None
BYTE(6) NOT NULL
X(12)
PDTCode
None
CHAR(2) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(2)
PDTMaxLength
None
INTEGER
--,---,---,--9 (explicit)
PDTTotalDigits
None
SMALLINT
---,--9 (explicit)
PDTImpliedPoint
None
SMALLINT
---,--9 (explicit)
ImplicitAssignment
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
CastRoutineId
None
BYTE(6) NOT NULL
X(12)
PDTCharType
Data Dictionary Quick Reference
615
Chapter 4: Data Dictionary Tables
Table Column Formats
UDTInfo
Contained within the CREATE TYPE statement.
Columns
Referenced Column(s)
Data Type
Format
TypeId (UPI)
None
BYTE(6) NOT NULL
X(12)
DatabaseId
None
BYTE(4) NOT NULL
X(8)
TypeName
None
VARCHAR(128) UNICODE
UPPERCASE
NOT CASESPECIFIC NOT NULL
X(128)
TableKind
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
OperatorAll
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
DefaultTransformGroup
None
VARCHAR(128) UNICODE
UPPERCASE
NOT CASESPECIFIC
X(128)
OrderingForm
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC NOT NULL
X(1)
OrderingCategory
None
CHAR(1) LATIN UPPERCASE
NOT CASESPECIFIC
X(1)
OrderingRoutineId
None
BYTE(6)
X(12)
CastCount
None
BYTEINT NOT NULL
--9 (explicit)
ExtFileReference
None
VARCHAR(1000) UNICODE
CASESPECIFIC
X(255) (explicit)
INSTANTIABLE
FINAL
Encryption
Compression
616
Data Dictionary Quick Reference
Chapter 4: Data Dictionary Tables
Table Column Formats
UDTTransform
Contains the transform group name and the routine identifiers.
Columns
Referenced Column(s)
Data Type
Format
UDTypeId (Composite
UPI)
None
BYTE(6) NOT NULL
X(12)
GroupName (Composite
UPI)
None
VARCHAR(128) UNICODE
UPPERCASE NOT CASESPECIFIC
NOT NULL
X(128)
ToSQLRoutineId
None
BYTE(6)
X(12)
FromSQLRoutineId
Data Dictionary Quick Reference
617
Chapter 4: Data Dictionary Tables
Table Column Formats
618
Data Dictionary Quick Reference
CHAPTER 5
Macros
To load macros and other views, specific SQL scripts must be executed using the DIP utility.
Examples of these include the DIPSYSFE utility for SQL scripts for System FE Macros and the
DIPRUM utility for SQL scripts for ResUsage macros.
To load all the views, tables, and macros, the DIPALL script must be run.
This chapter contains information about the following system macros:
•
TwoPCRule macro
•
ResUsage macros
•
DIPVIEWS macros
The following macros are not covered in this manual:
Macros
Purpose
For more information, see...
SystemFE
Track system health
SystemFE Macros
AccLogRule
Enables access logging
• Database Administration
• Security Administration
TwoPCRule Macro
This macro is an empty macro. Its purpose is to determine the privilege the user holds.
Creating the TwoPCRule Macro
You use the following CREATE statement for this macro:
CREATE MACRO DBC.TwoPCRule AS (;);
TwoPCRule and the Resolver Base Module
If the user has the EXECUTE privilege on this macro, the system allows him to logon to the
Resolver Base Module.
Without the privilege, the user cannot logon to the module.
Resolving Indoubt Transactions
You must have the EXECUTE privilege on this macro to use the Resolver Base Module to
resolve indoubt transactions.
Data Dictionary
619
Chapter 5: Macros
ResUsage Macros
To resolve indoubt transactions, the TDP must have access to DBC.InDoubtResLog, and must
be allowed to logon to the Resolver Base Module. The following SQL statements define a TDP
userid and attributes, and establish the necessary privileges for the access and logon:
CREATE USER TDPUSER
AS PERM=0 PASSWORD=passwd ACCOUNT=’$H’;
GRANT LOGON ON ALL TO TDPUSER WITH NULL PASSWORD;
GRANT SELECT, DELETE ON DBC.InDoubtLog TO TDPUSER;
GRANT EXECUTE ON DBC.TwoPCRule TO TDPUSER;
Note: The TDP userid in the preceding CREATE and GRANT statements can be changed with
the INITIAL USER clause in the TDP parameter dataset.
Note: The CREATE USER statement for the TDP userid must include the ACCOUNT=$H
priority attribute.
ResUsage Macros
Like other Teradata Database macros, ResUsage macros consist of one or more Teradata
Structured Query Language (SQL) statement stored in the Teradata Database and executed by
a single EXECUTE statement.
Usage Notes
ResUsage macros allow you to analyze key operational statistics, ResUsage data, that you can
use to evaluate the performance of your system. You must have the EXECUTE privilege to use
this macro.
In addition to the name of the macro, the EXECUTE statement for ResUsage macros can
include optional parameters to specify the following:
•
Starting and ending dates and times
•
Starting and ending nodes of a range of nodes
•
A specific single node
Example
The following statement executes the ResCPUByAMP macro, producing a report for the
period beginning 8:00 a.m. on December 25, 1997, and ending 12:00 p.m., midnight, on
December 31, 1997. It includes data for nodes 123-02 through 125-04.
EXECUTE ResCPUByAmp('1997-12-25', '1997-12-31', '08:00:00', '24:00:00',
'123-02', '125-04');
620
Data Dictionary
Chapter 5: Macros
DIPVIEWS Macros
where:
Statement Element …
Description
ResCPUByAmp
Name of the ResUsage macro
‘1997-12-25’
Starting date of December 25, 1997
‘1997-12-31’
Ending date of December 31, 1997
080000
Starting time of 8:00 a.m.
240000
Ending time of 12:00 midnight
‘123-02’
Starting node of a range of nodes
‘125-04’
Ending node of a range of nodes
For More Information
For information on using these macros, see Resource Usage Macros and Tables.
DIPVIEWS Macros
The DIPVIEWS script contains several macros, including:
Data Dictionary
Macro Name
Function
ARC_NonEmpty_List[M]
Returns the names of the databases or users, owned by the
indicated database, that contain the specified objects.
ClearAccounting
Resets the CPU and IO columns of the DBC.Acctg table.
ClearAllDatabaseUse Count
Clears the AccessCount and LastAccessTimeStamp information
for all of the objects in the system.
ClearDatabaseUseCount
Clears the AccessCount and LastAccessTimeStamp information
for all of the objects in the given database.
ClearPeakDisk
Resets the PEAKPERM, PEAKSPOOL, and PEAKTEMP columns
for the DISKSPACE information.
ClearTVMUseCount
Clears the AccessCount and LastAccessTimeStamp information
for all of the objects associated with the given table, view, trigger,
stored procedure, join index, macro, user-defined type, userdefined method, or user-defined function.
CollAddStandard
Defines the standard collation sequences supplied with the
Teradata Database and places them into the DBC.CollationTbl.
621
Chapter 5: Macros
ARC_NonEmpty_List[M] Macro
Macro Name
Function
CollInstallMulti
Allows database administration to install an Teradata-supplied
standard collation (Swedish, Norwegian, or Japanese) or a
user-defined collation from the DBC.CollationTbl as the
definition for Multinational collation.
CopyCostProfile
Copies an existing cost profile to a new one which can
subsequently be modified using DBC.InsertConstantValue.
CreateNewCostProfile
Creates an empty new cost profile of a given type.
DBQLAccessMacro
Allows database administrator to grant privileges to the BEGIN
QUERY LOGGING and END QUERY LOGGING statements.
DeleteConstantValue
Deletes a constant value from an existing cost profile.
DeleteCostProfile
Deletes all constant values for an existing cost profile and then
deletes the cost profile.
DIPMarkNSIO
Acts as a release marker to indicate a valid Data Dictionary.
ListCostProfiles
Lists all cost profiles.
ListCostProfiles1
Lists cost profiles that match the parameters given.
ListCostProfiles2
Lists cost profiles that match the parameters given.
InsertConstantString
Inserts a constant string to an existing cost profile.
InsertConstantValue
Inserts a constant value to an existing cost profile.
LogonRule
Allows database administrator to determine who has execute
privileges for the GRANT/REVOKE LOGON statements.
MergeCostProfile
Merges the constant values specified in the existing ‘source’ cost
profile with those in the existing ‘target’ cost profile.
ShowCostProfile
Lists the SQL statements needed to reproduce the named cost
profile.
ShowCostProfileAs
Lists the SQL statements needed to produce a new cost profile
based on an existing cost profile.
This section provides a brief description of each of the macros in the table, including any
necessary parameters. If you need to see the macro itself, refer to the DIPVIEWS script.
ARC_NonEmpty_List[M] Macro
This macro returns the names of the databases or users, owned by the indicated database, that
contain the specified objects.
622
Data Dictionary
Chapter 5: Macros
ARC_NonEmpty_List[M] Macro
This macro uses the following parameters:
Parameter
Description
ParentDb
Indicates the name of the database containing the objects returned by
this macro.
Data type is CHAR.
Format is ’X(30)’.
TKinds
Indicates the type of tables returned.
Data type is VARCHAR.
Format is ’X(100)’.
The possible values include the following:
Data Dictionary
Value
Meaning
A
Aggregate function
B
Combined aggregate and ordered analytical function
D
JAR
E
External Stored Procedure
F
Standard function
G
Trigger
H
Instance or Constructor Method
I
Join Index
J
Journal
M
Macro
N
Hash Index
O
No Primary Index
P
SQL Procedure
Q
Queue Table
R
Table function
S
Ordered analytical function
T
Table
U
User-defined datatype
V
View
X
Authorization
623
Chapter 5: Macros
ClearAccounting Macro
Usage Notes
The macro can return database names for which the executing user does not have privileges.
Example 1
To run the ARC_NonEmpty_List macro, issue the following:
exec arc_nonempty_list ('newemp2','tjivm');
*** Query completed. One row found. One column returned.
*** Total elapsed time was 1 second.
Translate(DatabaseNameI using UNICODE_TO_LOCALE)
-----------------------------------------------NEWEMP2
Example 2
To run the ARC_NonEmpty_ListM macro, issue the following:
exec arc_nonempty_listm ('newemp2','tjivm');
*** Query completed. One row found. One column returned.
*** Total elapsed time was 1 second.
DatabaseNameI
-------------------------------------------------------------------NEWEMP2
ClearAccounting Macro
This macro resets the CPU and IO columns of the DBC.Acctg table.
Usage Notes
This macro resets resource usage counters back to zero. The following scenarios show how the
ClearAccounting macro can be used:
1
A systems administrator uses the CPU usage information in DBC.Acctg to bill users every
month. At the beginning of each month, the systems administrator runs ClearAccounting
to reset the resource usage counters back to zero.
2
A person diagnosing system performance problems needs to look at DBC.Acctg when
certain jobs are run. He first runs ClearAccounting to reset the resource usage counters.
Example
To run the ClearAccounting macro, issue the following:
EXEC DBC.ClearAccounting;
*** Update completed. 10 rows changed.
*** Total elapsed time was 1 second.
624
Data Dictionary
Chapter 5: Macros
ClearAllDatabaseUseCount
ClearAllDatabaseUseCount
This macro clears the AccessCount and LastAccessTimeStamp information for all of the
objects in the system.
Usage Notes
A user must be granted the appropriate privileges to be able to execute this macro.
Example
To run the ClearAllDatabaseUseCount macro, issue the following:
EXEC DBC.ClearAllDatabaseUseCount;
***
***
***
***
***
Update completed. 13 rows changed.
Total elapsed time was 1 second.
Update completed. 242 rows changed.
Update completed. 2068 rows changed.
Update complete. 220 rows changed.
ClearDatabaseUseCount
This macro clears the AccessCount and LastAccessTimeStamp information for all of the
objects in the given database.
Usage Notes
A user must be granted the appropriate privileges to be able to execute this macro.
Example
To run the ClearDatabaseUseCount macro, issue the following:
EXEC DBC.ClearDatabaseUseCount(‘db2’);
***
***
***
***
***
Data Dictionary
Update completed. one row changed.
Total elapsed time was 2 seconds.
Update completed. 2 rows changed.
Update completed. 2 rows changed.
Update completed. 2 rows changed.
625
Chapter 5: Macros
ClearPeakDisk Macro
ClearPeakDisk Macro
This macro resets to zero the following columns of the DISKSPACE information:
•
PEAKPERM
•
PEAKSPOOL
•
PEAKTEMP
Usage Notes
You are able to determine the maximum amount of permanent space, the maximum amount
of spool space, and the maximum amount of temporary space used at any one time by the
database for a specified AMP (or all AMPs if the SUM aggregate is specified) since the last
time the ClearPeakDisk macro was run.
Example
To run the ClearPeakDisk macro, issue the following:
EXEC DBC.ClearPeakDisk;
ClearTVMUseCount
This macro clears the AccessCount and LastAccessTimeStamp information for all of the
objects associated with the given table, view, trigger, stored procedure, join index, macro,
user-defined type, user-defined method, or user-defined function.
Usage Notes
A user must be granted the appropriate privileges to be able to execute this macro.
Example
To run the ClearTVMUseCount macro, issue the following:
EXEC DBC.ClearTVMUseCount (‘db1’, ‘tab1’);
***
***
***
***
Update completed. One row changed.
Total elapsed time was 1 second.
Update completed. 2 rows changed.
Update completed. 2 rows changed
CollAddStandard Macro
This macro defines the standard collation sequences supplied with the Teradata Database and
places them into the DBC. CollationTbl.
626
Data Dictionary
Chapter 5: Macros
CollInstallMulti Macro
Usage Notes
If the existing standard collations in the DBC.CollationTbl have been corrupted or removed,
this macro replaces them. Also, when we provide additional standard collations, you can add
them using this macro.
For information on collation sequences, see International Character Set Support.
Example
The following macro places the supplied collations into DBC.CollationTbl:
EXEC DBC.CollAddStandard();
CollInstallMulti Macro
This macro installs an Teradata-supplied standard collation or a user-defined collation from
the DBC.CollationTbl as the definition for Multinational collation.
This macro uses the following parameter.
Parameter
Description
CollationName
The CollationName parameter identifies the collation defined in the
DBC.CollationTbl.
Data type is CHAR.
FORMAT is ‘X(30)’.
Usage Notes
The name assigned to the collation can be any valid name except “MULTINATIONAL.”
To install the supplied standard collation, you must run the macro DBC.CollAddStandard
before you run the CollInstallMulti macro.
You must run this macro before any users have logged onto the system. The redefinition of
Multinational collation takes effect after a full Teradata Database restart.
For information on collation sequences, see International Character Set Support.
Example
The following statement redefines the Multinational collation sequence as the
SWEDISH_STANDARD collation:
EXEC DBC.CollInstallMulti (‘SWEDISH_STANDARD’);
This next statement redefines the Multinational collation sequence as the user-defined
collation, “MULTINATIONAL_USER”:
EXEC CollInstallMulti (‘MULTINATIONAL_USER’);
Data Dictionary
627
Chapter 5: Macros
CopyCostProfile Macro
CopyCostProfile Macro
The CopyCostProfile macro copies an existing cost profile to a new one which can
subsequently be modified using DBC.InsertConstantValue. It uses the following parameters.
Parameter
Description
ProfileName
Specifies the name of the new profile.
Data type is CHAR.
FORMAT is ‘X(30)’.
Note: The new cost profile (ProfileName) is a variable cost profile.
ProfileDesc
Describes the new profile.
Data type is VARCHAR.
FORMAT is ‘X(2048)’.
SourceProfileName
Specifies the name of the source profile.
Data type is CHAR.
FORMAT is ‘X(30)’.
Usage Notes
The new cost profile is first created with the same cost profile type as the SourceProfile. The
new cost profile must not already exist. The ConstantValues entries associated with the Source
Profile are duplicated and assigned to the new cost profile.
To copy cost constants to an existing cost profile, use the DBC.MergeCostProfile macro
instead.
Example
EXEC DBC.CopyCostProfile ('V2R5Copy','Description', 'V2R5');
CreateNewCostProfile Macro
The CreateNewCostProfile macro creates a new empty variable cost profile of a given type. It
uses the following parameters.
Parameter
Description
ProfileName
Specifies the name of the new profile.
Data type is CHAR.
FORMAT is ‘X(30)’.
628
Data Dictionary
Chapter 5: Macros
DBQLAccessMacro Macro
Parameter
Description
ProfileDesc
Describes the new profile.
Data type is VARCHAR.
FORMAT is ‘X(2048)’.
ProfileTypeName
Defines the profile type name for the profile type ID.
Data type is CHAR.
FORMAT is ‘X(30)’.
Usage Notes
To complete the definition of the cost profile, specify the constant values that make up the cost
profile by using the DBC.InsertConstantValue macro.
Alternatively, the new cost profile may get its definitions from another cost profile using the
DBC.MergeCostProfile macro.
Example
EXEC DBC.CreateNewCostProfile ('My Profile 10', 'My special profile for
test runs', 'Legacy');
DBQLAccessMacro Macro
This macro allows database administrators to grant privileges to users who wish to do query
logging with the BEGIN QUERY LOGGING and END QUERY LOGGING statements.
Usage Notes
None.
Example
None.
Data Dictionary
629
Chapter 5: Macros
DeleteConstantValue Macro
DeleteConstantValue Macro
The DeleteConstantValue macro removes the constant value or constant string (if there is
one) from an existing cost profile. You can use this macro only with variable cost profiles. It
uses the following parameters.
Parameter
Description
ProfileName
Specifies the name of the new profile.
Data type is CHAR.
FORMAT is ‘X(30)’.
ConstantName
Specifies the constant name or the wildcard name in the SQL ‘LIKE’
format.
Data type is VARCHAR.
FORMAT is ‘X(64)’.
Usage Notes
The ConstantName is matched using the SQL ‘LIKE’ format, so you may use wildcards. For
example ''%Row%'' matches those constants with ''Row'' in their name. Also, ''%'' matches all.
Example
EXEC DBC.DeleteConstantValue ('New Profile 1', 'OPTROWACCESSINST');
DeleteCostProfile Macro
The DeleteCostProfile macro deletes all constant values for an existing cost profile and then
the cost profile itself. You can use this macro only with variable cost profiles. It uses the
following parameter.
Parameter
Description
ProfileName
Specifies the name of the new profile.
Data type is CHAR.
FORMAT is ‘X(30)’.
Usage Notes
None.
Example
EXEC DBC.DeleteCostProfile ('Profile 1');
630
Data Dictionary
Chapter 5: Macros
DIPMarkNSIO Macro
DIPMarkNSIO Macro
The DIPMarkNSIO macro is an empty macro in database DBC which acts as a release marker
to indicate a valid Data Dictionary. This macro does not have any parameters.
The Teradata Database uses the presence or absence of this macro to determine whether a
conversion originates from a DBC/1012 to the Teradata Database.
Usage Notes
When you restore database DBC from a DBC/1012 to the Teradata Database, the
DIPMarkNSIO macro is deleted before the conversion begins and is recreated at the end of the
conversion process.
If the conversion was not successful, the macro is not created, and you see a message
instructing you to run the necessary conversion script.
InsertConstantString Macro
Note: The InsertConstantString macro is for internal use only
The InsertConstantString macro inserts a constant string to an existing cost profile. It uses the
following parameters.
Parameter
Description
ProfileName
Specifies the name of the new profile.
Data type is CHAR.
FORMAT is ‘X(30)’.
ConstantName
Specifies the constant name or the wildcard name in the SQL ‘LIKE’
format.
Data type is CHAR.
FORMAT is ‘X(64)’.
Note: You must add ConstantName previously using
InsertConstantValue.
ConstString
Specifies the constant string.
Data type is VARCHAR.
FORMAT is ‘X(2048)’.
Usage Notes
If the constant already has a value, that value is replaced.
Data Dictionary
631
Chapter 5: Macros
InsertConstantValue Macro
Example
EXEC DBC.InsertConstantString ('New Profile 1', 'OPTROWACCESSINST',
‘String_Constant’);
InsertConstantValue Macro
The InsertConstantValue macro inserts a constant value to an existing cost profile. It uses the
following parameters.
Parameter
Description
ProfileName
Specifies the name of the new profile.
Data type is CHAR.
FORMAT is ‘X(30)’.
ConstantName
Specifies the constant name or the wildcard name in the SQL ‘LIKE’
format.
Data type is CHAR.
FORMAT is ‘X(64)’.
ConstVal
Specifies the constant value.
Data type is FLOAT.
Usage Notes
If the constant already has a value, that value is replaced.
Example
EXEC DBC.InsertConstantValue ('New Profile 1', 'OPTROWACCESSINST',
1300);
ListCostProfiles Macro
The ListCostProfiles macro lists all cost profiles.
Usage Notes
632
If …
THEN use the following macro …
you want to list a subset of all the profiles
DBC.ListCostProfiles1
the profile description is needed
DBC.ListCostProfiles2
Data Dictionary
Chapter 5: Macros
ListCostProfiles1 Macro
Example
EXEC DBC.ListCostProfiles;
ListCostProfiles1 Macro
The ListCostProfiles1 macro lists the cost profiles that match the parameters given. It uses the
following parameters.
Parameter
Description
ProfileName
Specifies the name of the profile or the wildcard name in the SQL
‘LIKE’ format.
Data type is CHAR.
FORMAT is ‘X(30)’.
ProfileCat
Specifies the constant name or the wildcard name in the SQL ‘LIKE’
format.
Data type is VARCHAR.
FORMAT is ‘X(1)’.
ProfileType
Specifies the profile type name or the wildcard name in the SQL
‘LIKE’ format.
Data type is CHAR.
FORMAT is ‘X(30)’.
Description
Specifies the description of the profile or the wildcard name in the
SQL ‘LIKE’ format.
Data type is VARCHAR.
FORMAT is ‘X(2048)’.
Note: ProfileName is matched using SQL ‘LIKE,’ so you may use wildcards. For example
''%V2R5%'' matches those profiles with ''V2R5'' in their name. Also, ''%'' matches all.'
Usage Notes
If …
THEN use the following …
you want to list all the cost profiles.
DBC.ListCostProfiles
the profile description is needed
DBC.ListCostProfiles2
Example
EXEC DBC.ListCostProfiles1(,,,);
Data Dictionary
633
Chapter 5: Macros
ListCostProfiles2 Macro
ListCostProfiles2 Macro
The ListCostProfiles2 macro lists the cost profiles that match the parameters given. It uses the
following parameters.
Parameter
Description
ProfileName
Specifies the name of the profile or the wildcard name in the SQL
‘LIKE’ format.
Data type is CHAR.
FORMAT is ‘X(30)’.
ProfileCat
Specifies the constant name or the wildcard name in the SQL ‘LIKE’
format.
Data type is VARCHAR.
FORMAT is ‘X(1)’.
ProfileType
Specifies the profile type name or the wildcard name in the SQL
‘LIKE’ format.
Data type is CHAR.
FORMAT is ‘X(30)’.
Description
Specifies the description of the new profile or the wildcard name in
the SQL ‘LIKE’ format.
Data type is VARCHAR.
FORMAT is ‘X(2048)’.
Note: ProfileName is matched using SQL ‘LIKE,’ so you may use wildcards. For example
''%V2R5%'' matches those profiles with ''V2R5'' in their name. Also, ''%'' matches all.'
Usage Notes
If …
THEN use the following macro …
the profile description is not needed
DBC.ListCostProfiles for columnar form
you want to list all the cost profiles
DBC.ListCostProfiles
Example
EXEC DBC.ListCostProfiles2('V2R5',,,);
634
Data Dictionary
Chapter 5: Macros
LogonRule Macro
LogonRule Macro
This macro determines who has execute privileges for the GRANT/REVOKE LOGON
statements.
When database administration grants the execute privilege on this macro to a user, that user
can then use the GRANT/REVOKE logon statements.
For complete information on using this macro, see Security Administration.
MergeCostProfile Macro
The MergeCostProfile macro merges the constant values specified in the existing source cost
profile with those in the existing target cost profile. It uses the following parameters.
Parameter
Description
TargetProfileName
Specifies the name of the existing target profile.
Data type is CHAR.
FORMAT is ‘X(30)’.
SourceProfileName
Specifies the name of the source profile.
Data type is CHAR.
FORMAT is ‘X(30)’.
Usage Notes
If the constant value exists in the target, that value is replaced; otherwise, it is added. Other
constants existing in the target profile are not changed nor deleted.
The TargetProfile must be the same cost profile type as the SourceProfile.
Example
EXEC DBC.MergeCostProfile ('MyTest', 'V2R5');
Data Dictionary
635
Chapter 5: Macros
ShowCostProfile Macro
ShowCostProfile Macro
The ShowCostProfile macro lists the SQL statements needed to reproduce the particular cost
profile. It uses the following parameter.
Parameter
Description
ProfileName
Specifies the name of the profile.
Data type is CHAR.
FORMAT is ‘X(30)’.
Usage Notes
None.
Example
EXEC DBC.ShowCostProfile('V2R5');
ShowCostProfileAs Macro
The ShowCostProfileAs macro lists the SQL statements needed to produce a new cost profile
based on an existing one. It uses the following parameters.
Parameter
Description
ProfileName
Specifies the name of the source profile.
Data type is CHAR.
FORMAT is ‘X(30)’.
NewProfileName
Specifies the name of the output profile.
Data type is CHAR.
FORMAT is ‘X(30)’.
Description
Specifies the description for the output profile.
Data type is VARCHAR.
FORMAT is ‘X(2048)’.
Usage Notes
None.
Example
EXEC DBC.ShowCostProfileAs('V2R5');
636
Data Dictionary
Chapter 5: Macros
For More Information
For More Information
Many additional macros exist for determining system efficiency. These resource usage macros
are described in Resource Usage Macros and Tables.
Data Dictionary
637
Chapter 5: Macros
For More Information
638
Data Dictionary
APPENDIX A
How to Read Syntax Diagrams
This appendix describes the conventions that apply to reading the syntax diagrams used in
this book.
Syntax Diagram Conventions
Notation Conventions
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 typing a number with more than 3 digits.
Word
Keywords and variables.
• UPPERCASE LETTERS represent a keyword.
Syntax diagrams show all keywords in uppercase, unless operating system
restrictions require them to be in lowercase.
• lowercase letters represent a keyword that you must type in lowercase, such as a
UNIX command.
• lowercase italic letters represent a variable such as a column or table name.
Substitute the variable with a proper value.
• lowercase bold letters represent an excerpt from the diagram. The excerpt is
defined immediately following the diagram that contains it.
• UNDERLINED LETTERS represent the default value.
This applies to both uppercase and lowercase words.
Spaces
Use one space between items such as keywords or variables.
Punctuation
Type all punctuation exactly as it appears in the diagram.
Paths
The main path along the syntax diagram begins at the left with a keyword, 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.
Data Dictionary
639
Appendix A: How to Read Syntax Diagrams
Syntax Diagram Conventions
Continuation Links
Paths that are too long for one line use continuation links. Continuation links are circled
letters indicating the beginning and end of a link:
A
A
FE0CA002
When you see a circled letter in a syntax diagram, go to the corresponding circled letter and
continue reading.
Required Entries
Required entries appear on the main path:
SHOW
FE0CA003
If you can choose from more than one entry, the choices appear vertically, in a stack. The first
entry appears on the main path:
SHOW
CONTROLS
VERSIONS
FE0CA005
Optional Entries
You may choose to include or disregard optional entries. Optional entries appear below the
main path:
SHOW
CONTROLS
640
FE0CA004
Data Dictionary
Appendix A: How to Read Syntax Diagrams
Syntax Diagram Conventions
If you can optionally choose from more than one entry, all the choices appear below the main
path:
READ
SHARE
JC01A010
ACCESS
Some commands and statements treat one of the optional choices as a default value. This
value is UNDERLINED. It is presumed to be selected if you type the command or statement
without specifying one of the options.
Strings
String literals appear in apostrophes:
'msgtext '
JC01A004
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.
SHOW
CONTROLS
CONTROL
FE0CA042
In the above syntax, the following formats are valid:
•
SHOW CONTROLS
•
SHOW CONTROL
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:
,
,
(
cname
3
4
)
JC01B012
Data Dictionary
641
Appendix A: How to Read Syntax Diagrams
Syntax Diagram Conventions
Read loops from right to left.
The following conventions apply to loops:
IF...
THEN...
there is a maximum number of
entries allowed
the number appears in a circle on the return path.
there is a minimum number of
entries required
the number appears in a square on the return path.
a separator character is required
between entries
the character appears on the return path.
In the example, you may type cname a maximum of 4 times.
In the example, you must type at least three groups of column
names.
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.
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 each side of the break. The
name for the excerpted piece appears between the terminators in boldface type.
The boldface excerpt name and the excerpted phrase appears immediately after the main
diagram. The excerpted phrase starts and ends with a plain horizontal line:
LOCKING
excerpt
A
A
HAVING
con
excerpt
where_cond
,
cname
,
col_pos
JC01A014
642
Data Dictionary
Appendix A: How to Read Syntax Diagrams
Syntax Diagram Conventions
Multiple Legitimate Phrases
In a syntax diagram, it is possible for any number of phrases to be legitimate:
dbname
DATABASE
tname
TABLE
vname
VIEW
JC01A016
In this example, any of the following phrases are legitimate:
•
dbname
•
DATABASE dbname
•
tname
•
TABLE tname
•
vname
•
VIEW vname
Sample Syntax Diagram
,
CREATE VIEW
viewname
AS
A
LOCKING
cname
CV
LOCK
ACCESS
dbname
A
DATABASE
tname
FOR
SHARE
IN
READ
TABLE
WRITE
EXCLUSIVE
vname
VIEW
EXCL
,
B
SEL
B
MODE
expr
,
FROM
qual_cond
tname
C
.aname
C
HAVING cond
;
qual_cond
,
WHERE cond
GROUP BY
cname
,
col_pos
JC01A018
Data Dictionary
643
Appendix A: How to Read Syntax Diagrams
Syntax Diagram Conventions
Diagram Identifier
The alphanumeric string that appears in the lower right corner of every diagram is an internal
identifier used to catalog the diagram. The text never refers to this string.
644
Data Dictionary
Glossary
2PC
Two-Phase Commit
ALC
Algorithmic Compression
AMP
Access Module Process or Access Module Processor
ANSI American National Standards Institute
API Application Programming Interface
ASCII American Standard Code for Information Interchange
AWS
Administration Workstation
BTEQ Basic Teradata Query
CICS
Customer Information Control System (IBM)
CLI Call-Level Interface
CPU
Central Processing Unit
DBA
Database Administrator
DBC Name of database with Teradata Database system tables
DBQL
Database Query Logging
DBS
Database System or Database Software
DDL
Data Definition Language
DIP Database Initialization Program, DBC Initialization Procedure, or DBC/1012
Initialization Program
DML
Data Manipulation Language
EBCDIC
Extended Binary-Coded Decimal Interchange Code
HI Hash Index
HW
ID
Hardware
Identifier/Identification
I/O Input/Output
IMS
Information Management System
JI Join Index
Data Dictionary
645
Glossary
KB Kilobytes
LAN
Local Area Network
LDAP Lightweight Directory Access Protocol
LFI Data Load End Loading
MRM
Merge Row Multiple
MVC
Multi-Value Compression
NPPI
Non-partitioned Primary Index
NUPI
Non-unique Primary Index
NUSI Non-unique Secondary Index
ODBC
Open Database Connectivity
OLCP
Online Complex Processing
OS
Operating System
PC
Personal Computer
PDE
Parallel Data Extension
PE
Parser Engine
PI
Primary Index (unique or non-unique)
PJ
Permanent Journal
PM/API
PMA
PPI
Performance Monitor Application Programming Interface
Processor Module Assembly
Partitioned Primary Index
RCC Recovery Control Catalog
ResUsage Resource Usage
RI Referential Integrity
SLG
Service Level Goals
SQL
Structured Query Language
SW
Software
TDN
Teradata Network
TDP
Teradata Director Program
TP Transaction Processor
646
Data Dictionary
Glossary
TSET
Teradata System Emulation Tool
TSO
Time Sharing Option (IBM)
UDF
User-Defined Function
UDM
User-Defined Method
UDT
User-Defined Type
UPI Unique Primary Index
USI
VMS
Unique Secondary Index
Virtual Memory System
WD Workload Definition
WDID Workload Definition ID
XSP
Z/OS
Data Dictionary
External Stored Procedure
IBM System z Operating System
647
Glossary
648
Data Dictionary
Index
A
AbortCount column 114, 604
AbortFlag column 114, 558
AbortMBox column 591
AccessCount column 114, 539, 541, 549, 554, 569, 572, 577,
585, 596, 600, 607, 609, 612
Accesskind column 542
AccessLog view 67, 420
AccessRight column 115, 116, 539
AccessRights table 539
AccessType column 117, 542
AccLogResult column 118, 542
AccLogRules column 553, 611
AccLogRules view 68, 69, 421
AccLogRuleTbl table 540
AccLogTbl table 542
AccLogUsrRules column 553
Account String Expansion 49
AccountDbId column 605
AccountInfo view 69, 424
AccountName column 119, 542, 543, 544, 553, 566, 590
Accounts table 543
AccountString column 119, 560, 599
Acctg system table 47
Acctg table 544
AcctString column 120, 557, 563, 603
AcctStringDate column 120, 557
AcctStringHour column 120, 557
AcctStringTime column 121, 557
AcrAlterExtProcedure column 121, 541
AcrAlterFunction column 121
AcrAlterProcedure column 122, 541
AcrCheckPoint column 122, 540
AcrConnectThrough column 122, 541
AcrConstrAsgn column 542
AcrConstrDef column 542
AcrCreateDatabase column 123, 540
AcrCreateFunction column 123
AcrCreateGLOP column 123, 541
AcrCreateMacro column 124, 540
AcrCreateProcedure column 124, 541
AcrCreateProfile column 124, 541
AcrCreateRole column 125, 541
AcrCreateTable column 125, 540
AcrCreateTrigger column 125, 540
AcrCreateUser column 126, 540
Data Dictionary
AcrCreateView column 126, 540
AcrCreAuthorization column 126, 541
AcrCreExtProcedure column 127, 541
AcrCreOwnerProcedure column 127, 542
AcrDelete column 127, 540
AcrDropAuthorization column 128, 541
AcrDropDatabase column 128, 540
AcrDropFunction column 128
AcrDropGLOP column 129, 541
AcrDropMacro column 129, 540
AcrDropProcedure column 129, 541
AcrDropProfile column 130, 541
AcrDropRole column 130, 541
AcrDropTable column 130, 540
AcrDropTrigger column 131, 541
AcrDropUser column 131, 540
AcrDropView column 131, 540
AcrDump column 132, 540
AcrExecute column 132, 540
AcrExecuteFunction column 132, 541
AcrExecuteProcedure column 133, 541
AcrGLOPMember column 133, 541
AcrGrant column 133, 540
AcrIndex column 134, 540
AcrInsert column 134, 540
AcrOverrideDel column 542
AcrOverrideIns column 542
AcrOverrideSel column 542
AcrOverrideUpd column 542
AcrReference column 134, 540
AcrRepControl column 135, 541
AcrRestore column 135, 540
AcrSelect column 135, 540
AcrShow column 136, 542
AcrStatistics column 136, 541
AcrUDTMethod column 136, 541
AcrUDTType column 137, 541
AcrUDTUsage column 137, 541
AcrUpdate column 137, 540
ActionTime column 138, 606
ActiveCount column 138, 604
Activity column 139, 601
ActivityID column 139
ActivityId column 601
ActivityName column 140, 601
ActualDeleteSecs column 140, 580, 583
ActualRedistSecs column 140, 580, 583
649
Index
AddAmpCount column 141, 580
All_RI_Children view 71, 432
All_RI_Parents view 71, 434
AllAMPRASDeviationPct column 596
AllAMPsFlag column 141, 578
AllnessFlag column 141, 539
AllNullCount column 596
AllRights view 70, 425
AllRoleRights view 70, 428
AllSpace view 70, 430
AllTempTables view 71, 431
AlterCount column 546
AMPCPUTime column 142, 558, 564
AMPCPUTimeNorm column 142, 559, 564
AMPUsage view 72, 435
AppCat1Revision column 554
AppCat2Revision column 554
AppCat3Revision column 554
AppCat4Revision column 554
AppCategory column 143, 614
AppID column 143, 557, 563
AppIName column 560
ApplName column 144
ARC_NonEmpty macro 622
ARC_NonEmpty_List macro 622, 624
ARC_NonEmpty_ListM macro 624
ArcAlterFunction column 541
ArcCreateFunction column 541
ArcDropFunction column 541
ArchiveLoggingObjsTbl table 544
ArchiveLoggingObjsV view 72, 436
Arrivals column 144, 604
AsgdSecConstraints table 545
AssigneeId column 545
AssigneeKind column 545
AssignorId column 545
AssignTimeStamp column 545
Association view 72, 436
AuditTrailId column 144, 591
AuthIdUsed column 145, 612
AuthMethod column 567, 592
AuthName column 613
AuthorizationId column 145
AuthorizationName column 145
Authorizations view 73, 438
AuthorizationSubType column 146, 612
AuthorizationType column 146, 612
AuthUser column 567, 592
AvailValue column 569
AverageAmpCPU column 146
AverageIO column 147
AverageParserCPU column 147
AverageTime column 147
AvgCPUTime column 148, 604
650
AvgDelayTime column 148, 604
AvgNCorr column 546
AvgRespTime column 148, 604
B
B_DatabaseName column 154
B_TableName column 155
BaseDbId column 605
BaseDID column 566
BaseRowCount column 596
BaseTableId column 605
BaseTblDbName column 149
BaseTblId column 587
BaseTblName column 149
BaseTID column 566
BatchNum column 586
BeginCalcHBTimeStamp column 149, 580
BeginDelHBNewTimeStamp column 150, 581
BeginDelTimeStamp column 150, 579
BeginFBHBNewTimeStamp column 150, 580
BeginPHBNewTimeStamp column 151, 580
BeginRedistTimeStamp column 151, 579
BeginTimeStamp column 151, 579, 582
BeginTimeStamp1 column 581
BeginTimeStamp2 column 581
BeginTimeStamp3 column 581
BeginTimeStamp4 column 581
BeginTimeStamp5 column 581
BeginVProcCfgTimeStamp column 152, 581
BeginWrBkupIdTimeStamp column 152, 581
BeginWrBMTimeStamp column 152, 581
BeginWrCfgNewTimeStamp column 153, 581
BeginWrCfgTimeStamp column 153, 581
BeginWrFBHBTimeStamp column 153, 581
BeginWrPHBTimeStamp column 154, 580
BeginWrSpaceTimeStamp column 154, 580
Blob column 568
BTEQ script 48
BufferTS column 601, 602, 603
BuiltInFcnValues column 595
C
CacheFlag column 155, 558
Calendar view 51
CalendarName column 592
CastCount column 616
CastRoutineId column 615
Category column 156, 597
CharacterType column 156, 612, 614
CharReserved1 column 577, 596
CharReserved2 column 577, 596
CharReserved3 column 577, 596
CharSetID column 600
Data Dictionary
Index
CharSetId column 157
CharSetName column 157
CharSets view 73, 439
CharTranslations view 73, 440
CharType column 158, 609
CheckCount column 609
CheckName column 158
CheckOpt column 159, 611
CheckPointName column 159, 578
CheckTableOption column 160, 579
Child column 160
ChildCount column 161, 611
ChildDb column 161
ChildDbId column 161, 574
ChildKeyColumn column 162
ChildKeyFID column 162
Children view 73, 441
ChildTable column 162
ChildTblDateFID column 574
ChildTblID column 574, 614
ChildTID column 163
CkptFlushCount column 163, 584
ClassificationTime column 163, 603
ClearAccounting macro 624
ClearAllDatabaseUseCount macro 625
ClearDatabaseUseCount macro 625
ClearPeakDisk macro 626
ClearTVMUseCount macro 626
ClientAddr column 164, 557, 563
ClientCLIv2ReleaseId column 567, 594
ClientConnectionType column 566, 593
ClientCoordName column 567, 593
ClientEnvName column 567, 593
ClientID column 164, 557, 563
ClientIpAddress column 567, 592
ClientJobData column 567, 594
ClientJobId column 567, 593
ClientJobName column 567, 593
ClientLogonDiagnostics column 592
ClientOsName column 567, 593
ClientProcThreadId column 567, 593
ClientProgramName column 567, 592
ClientSecProdGrp column 567, 593
ClientSecProdUserId column 567, 593
ClientSessionDesc column 567, 594
ClientSystemUserId column 567, 592
ClientTcpPortNumber column 567, 593
ClientTdHostName column 567, 593
ClientTDPReleaseId column 567, 594
ClientTerminalId column 567, 593
ClientTransactionId column 567, 593
ClientUserOperId column 567, 593
ClientVmName column 567, 593
ClientVmUserId column 567, 594
Data Dictionary
ClientWorkload column 567, 594
ColCheck column 164
CollAddStandard macro 626
CollationFlag column 609
CollationName column 165
Collations view 73, 442
CollationTbl table 545
CollectTimeStamp column 564
CollectTimestamp column 165, 556, 557, 561, 563
CollEqvClass column 166, 545
CollInstall column 166, 545
CollInstallMulti macro 627
CollName column 166, 545, 600
CollOrderCS column 167, 545
CollOrderUC column 167, 545
ColumnAccRules column 611
ColumnCheck column 609
ColumnConstraint column 167
ColumnCorrelation table 545
ColumnFormat column 168
ColumnId column 168, 540, 543
ColumnLength column 168
ColumnName column 169, 543
ColumnPosition column 170
Columns view 74, 444
ColumnsStatistics column 170
ColumnStats view 75, 446
ColumnTitle column 171
ColumnType column 171, 172
ColumnUDTName column 172
ColumnWidth column 589
COMMENT statement 36
CommentString column 172, 544, 546, 552, 575, 587, 588,
590, 606, 609, 611
CommitOpt column 173, 612
CommitOrRollback column 173, 570
CommitSeqNumber column 586
CompletionDate column 174, 570
Completions column 174, 604
CompletionStatus column 586
CompletionTime column 174, 570
Compressible column 175
Compression column 616
CompressValue column 175
CompressValueList column 175, 609
ConfigId column 176, 601
ConnectFunction column 591
ConnectRules view 75, 448
ConnectRulesTbl table 547
ConstantDefs table 548
ConstantValues table 548
ConstCat column 176, 548
ConstDesc column 176, 548
ConstId column 177, 548
651
Index
ConstName column 177, 548
Constraint1Id column 593
Constraint1Val column 593
Constraint2Id column 593
Constraint2Val column 593
Constraint3Id column 593
Constraint3Val column 593
Constraint4Id column 593
Constraint4Val column 593
Constraint5Id column 593
Constraint5Val column 593
Constraint6Id column 593
Constraint6Val column 593
Constraint7Id column 593
Constraint7Val column 593
Constraint8Id column 593
Constraint8Val column 593
ConstraintCollation column 178, 600
ConstraintCount column 178
ConstraintFunctions table 549
ConstraintID column 610
ConstraintId column 541, 543, 545, 549, 550, 589
ConstraintName column 179, 589
ConstraintNames table 549
ConstraintText column 179
ConstraintType column 180, 549, 600
ConstraintVal column 545, 550
ConstraintValues table 550
ConstString column 548
ConstVal column 177, 548
ContMBox column 591
CoordTaskId column 180, 570
CopyCostProfile macro 628
CorrelationEnabled column 546
CorrelationLowerBound column 574
CorrelationName column 545
CorrelationTightness column 574
CorrelationUpperBound column 574
CostProfiles table 550
CostProfiles_V view 76, 450
CostProfileTypes table 551
CostProfileTypes_V view 76, 451
CostProfileValues_V view 76, 451
CostProfName column 576
Count1 column 584
Count10 column 584
Count2 column 584
Count3 column 584
Count4 column 584
Count5 column 584
Count6 column 584
Count7 column 584
Count8 column 584
Count9 column 584
652
CountNameString column 560
CPU column 544
CPUCost column 595
CPUNorm column 544
CPUTime column 181, 562
CPUTimeNorm column 182, 563
CreateDate column 182, 577
CreateID column 561
CreateNewCostProfile macro 628
CreateText column 576, 606, 611
CreateTextOverFlow column 576
CreateTime column 183, 577
CreateTimeStamp column 183, 539, 541, 544, 546, 547, 549,
553, 566, 569, 572, 575, 577, 585, 587, 588, 589, 590, 596,
600, 607, 609, 611
CreateTxtOverflow column 184, 607, 612
CreateUID column 539, 541, 544, 546, 547, 549, 553, 566,
569, 572, 575, 577, 585, 587, 588, 590, 596, 600, 607, 609,
611
CreatorName column 184, 553, 611
CSPSessionInfo view 76
CurrByteCount column 186, 580
CurrentCollation column 186, 590
CurrentDatabase column 590
CurrentDateForm column 591
CurrentPerm column 187
CurrentPermSpace column 551
CurrentRole column 187, 591
CurrentSpool column 187
CurrentSpoolSpace column 551
CurrentTemp column 188
CurrentTempSpace column 551
CurrTabDeleteCount column 188, 580
CurrTabRedistCount column 188, 580
Cyc column 569
D
Data Dictionary
organization of 25
updating 24
users, types of 63
Data Dictionary views
availability of 25
database administrator 32
definition of 25
end user 33, 63
how determined 26
operations 32
operations control 64
privileges 26
recovery control 32
resource usage 46
security administrator 64
Data Dictionary
Index
security logging 29
special users 29
supervisory user 63
system administrator 29, 63
system field engineer 29
table distribution 46
Data Dictionary views. See DBC views
Database Administrator views 32
Database_Default_Journals view 77, 455
Database1Id column 565
Database1Name column 565
Database2Id column 565
Database2Name column 565
DatabaseId column 189, 539, 540, 544, 549, 551, 552, 554,
568, 569, 571, 573, 576, 589, 594, 606, 609, 610, 613, 614,
616
DatabaseName column 190, 543, 553, 578, 579, 582
DatabaseNameI column 552
Databases view 76, 453
Databases2 view 77, 454
DatabaseSpace table 551
DataSetName column 196, 578
DataType column 589
DateFld column 566
Dbase table 552
DBaseId column 600
DBC tables
AccessRights 539
AccLogRuleTbl 540
AccLogTbl 542
Accounts 543
Acctg 544
ArchiveLoggingObjsTbl 544
AsgdSecConstraints 545
CollationTbl 545
ColumnCorrelation 545
ConnectRulesTbl 547
ConstantDefs 548
ConstantValues 548
ConstraintFunctions 549
ConstraintNames 549
ConstraintValues 550
CostProfiles 550
CostProfileTypes 551
DataBaseSpace 551
Dbase 552
DBCAssociation 554
DBCInfoTbl 555
DBQLExplainTbl 556
DBQLObjTbl 556
DBQLogTbl 557
DBQLRuleCountTbl 560
DBQLRuleTbl 560
DBQLSqlTbl 561
Data Dictionary
DBQLStepTbl 561
DBQLSummaryTbl 563
DBQLXMLTbl 564
Dependency 565
ErrorMsgs 565
ErrorTbls 566
EventLog 566
Global 568
Hosts 568
IdCol 568
Indexes 569
InDoubtResLog 570
JAR_JAR_Usage 571
JARS 571
LogonRuleTbl 572
MDSRecoveryTbl 572
Migration 572
Next 573
OldPasswords 573
Owners 573
ParentChildCorrelation 574
Parents 574
PasswordRestrictions 574
Profiles 575
QueryStatsTbl 576
RCConfiguration 577
RCEvent 577
RCMedia 578
ReconfigDeleteOrderTbl 579
ReconfigInfoTbl 579
ReconfigRedistOrderTbl 582
ReconfigTableStatsTbl 582
ReferencedTbls 584
ReferencingTbls 585
RepBatchStatus 586
RepCaptureRulesTbl 586
Repgroup 587
RepGroupTables 587
RepRulesetTbl 588
RoleGrants 588
Roles 588
Routine_JAR_Usage 589
SecConstraints 589
SessionTbl 590
StatsTbl 594
SW_Event_Log 597
SysSecDefaults 597
SystemQTbl 599
TableConstraints 599
TDWMEventHistory 601
TDWMEventlog 602
TDWMExceptionLog 602
TDWMSummaryLog 603
TempTables 605
653
Index
TextTbl 605
Translation 606
TriggersTbl 606
TSETQueryText 607
TVFields 608
TVM 610
UDFInfo 613
UDTCast 615
UDTInfo 616
UDTTransform 617
UnResolvedReferences 614
DBC views
AccessLog 67, 420
AccLogRules 68, 421
AccountInfo 69, 424
All_RI_Children 71, 432
All_RI_Parents 71, 434
AllRights 70, 425
AllRoleRights 70, 428
AllSpace 70, 430
AllTempTables 71, 431
AMPUsage 72, 435
ArchiveLoggingObjsV 72, 436
Association 72, 436
Authorizations 73, 438
CharSets 73, 439
CharTranslations 73, 440
Children 73, 441
Collations 73, 442
Columns 74, 444
ColumnStats 75, 446
ConnectRules 75, 448
CostProfiles_V 76, 450
CostProfileTypes_V 76, 451
CostProfileValues_V 76, 451
CSPSessionInfo 76
Database_Default_Journals 77, 455
Databases 76, 453
Databases2 77, 454
DBCInfo 77, 456
DBQLRules 78, 457
DeleteAccessLog 78, 458
DeleteOldInDoubt 78, 459
DiskSpace 79, 460
ErrorTblsV 79, 462
Event_Configuration 80
Events 80, 463
Events_Configuration 466
Events_Media 81, 467
ExternalSPs 81, 469
Functions 82, 470
HostsInfo 82, 472
IndexConstraints 83, 473
IndexStats 84, 475
654
Indices 85, 478
InDoubtLog 85, 479
JoinIndicesV 86, 480
Journals 86, 481
LogOnOff 86, 482
LogonRules 86, 483
MultiColumnStats 87, 483
ProfileInfo 87, 485
QryLog 88, 487
QryLogEventHis 90, 489
QryLogEvents 90, 490
QryLogExceptions 91, 492
QryLogExplain 91, 493
QryLogObjects 92, 495
QryLogSQL 92, 496
QryLogSteps 92, 497
QryLogSummary 94, 498
QryLogTDWM 95, 500
QryLogTDWMSum 96, 501
QryLogXMLV 96, 503
RCC_Configuration 97, 504
RCC_Media 97, 505
ReconfigDeleteOrderV 97, 506
ReconfigInfoV 97, 98, 99, 507
ReconfigRedistOrderV 99, 508
ReconfigTableStatsV 100, 101, 509
RepCaptureRules 101
RepCaptureRulesV 510
RepTables 101, 512
ResolvedDTSV 101, 512
RestrictedWords 102, 513
RI_Child_Tables 102, 513
RI_Distinct_Children 102, 514
RI_Distinct_Parents 103, 515
RI_Parent_Tables 103, 516
RoleInfo 103, 517
RoleMembers 104, 517
SecurityDefaults 104, 518
SecurityLog 104, 519
SessionInfo 105, 520
ShowColChecks 105, 521
ShowTblChecks 106, 522
Software_Event_Log 106, 523
Table_LevelConstraints 107, 524
Tables 108, 525
Tables2 109, 527
TableSize 109, 528
TableText 109, 529
Triggers 110, 530
User_Default_Journals 113, 537
UserGrantedRights 110, 532
UserRights 111, 533
UserRoleRights 111, 534
Users 112, 536
Data Dictionary
Index
DBC views, columns of. See individual column names
DBCAssociation table 554
DBCExtension system tables 56
GLOP_Data 60
GLOP_Map 57
GLOP_Set 58
DBCInfo view 77, 456
DBCInfoTbl table 555
DbId column 574
DBKind column 196
DBlockSize column 196, 583
DBName column 572
DBQLAccessMacro macro 629
DBQLExplainTbl table 556
DBQLObjTbl table 556
DBQLogTbl table 557
DBQLRuleCountTbl table 560
DBQLRules view 78, 457
DBQLRuleTbl table 560
DBQLSqlTbl table 561
DBQLStepTbl table 561
DBQLSummaryTbl table 563
DBQLXMLTbl table 564
DBSVersion column 576, 594
DecimalFractionalDigits column 197
DecimalTotalDigits column 197
DefaultAccount column 198, 575
DefaultCharSet column 198, 568
DefaultCharType column 199, 554, 591
DefaultCollation column 199, 553
DefaultDatabase column 200, 553, 559, 575, 607
DefaultDateForm column 201, 553
DefaultDB column 201
DefaultOpt column 201
DefaultOption column 586
DefaultRole column 202
DefaultTransformGroup column 616
DefaultValue column 202, 608
DefaultValueI column 608
DelAmpCount column 202, 580
DelayedCount column 203, 604
DelayedQueries column 203, 604
DelayTime column 203, 558
DeleteAccessLog view 78, 458
DeleteConstantValue macro 630
DeleteCostProfile macro 630
DeleteOldInDoubt view 78, 459
Dependency table 565
Description column 204, 579
DeterministicOpt column 204, 613
DIP utility 26
DIPGLOP DIP script 56
DIPMarkNSIO macro 631
DIPVIEWS macros 621
Data Dictionary
DIPVIEWS script 50
DiskIO column 204
DiskSpace view 79, 460
Dummy1 column 544
Dummy2 column 544
DupeDumpSet column 205, 578, 579
E
E_TableId column 219
E2I column 205
E2IUp column 205
ElapsedTime column 206
EnabledFlag column 206
EncryptedPassword column 552, 573
Encryption column 616
EncryptionFlag column 552, 573
End User views 33
EndCalcHBTimeStamp column 207, 580
EndDelHBNewTimeStamp column 207, 581
EndDelTimeStamp column 207, 579
EndFBHBNewTimeStamp column 208, 580
EndPHBNewTimeStamp column 208, 580
EndRedistTimeStamp column 208, 579
EndTimeStamp column 209, 579, 582
EndTimeStamp1 column 581
EndTimeStamp2 column 581
EndTimeStamp3 column 581
EndTimeStamp4 column 581
EndTimeStamp5 column 581
EndVProcCfgTimeStamp column 209, 581
EndWrBkupIdTimeStamp column 209, 581
EndWrBMTimeStamp column 210, 581
EndWrCfgNewTimeStamp column 210, 581
EndWrCfgTimeStamp column 210, 581
EndWrFBHBTimeStamp column 211, 581
EndWrPHBTimeStamp column 211, 581
EndWrSpaceTimeStamp column 211, 580
Entropy column 596
EntryID column 212, 601
EntryKind column 212, 601
EntryName column 212, 601
EntryTS column 213, 601
ErrorCode column 213, 558, 565, 607
ErrorCount column 213, 604
ErrorDID column 566
ErrorMsgs table 565
ErrorTblId column 587
ErrorTbls table 566
ErrorTblsV view 79, 462
ErrorText column 214, 558, 565, 603
ErrorTID column 566
ErrTblDbName column 214
ErrTblName column 214
655
Index
EstCPUCost column 215, 562
EstDeleteSecs column 215, 580, 583
EstHRCost column 215, 563
EstIOCost column 216, 563
EstMaxRowCount column 559
EstNetCost column 216, 563
EstPerDayGrowthPct column 595
EstProcTime column 217, 559, 562
EstRedistSecs column 217, 580, 583
EstRemainDeleteSecs column 218, 580
EstRemainRedistSecs column 218, 580
EstResultRows column 559
EstRowCount column 218, 562
Event column 219, 566
Event_Tag column 223, 597
EventBeginComment column 599
EventCode column 220, 602
EventComboID column 599
EventComboName column 599
EventComboStatus column 599
EventCount column 221, 543
EventEndComment column 599
EventHistoryTS column 599
EventInfo column 221, 602
EventLog table 566
EventNum column 222, 554, 573, 577
EventNumber column 578
Events view 80, 463
Events_Configuration view 80, 466
Events_Media view 81, 467
EventSubCode column 223, 602
EventTime column 223, 602
EventType column 224, 578
EventValue column 224, 601
ExceptionAbCount column 225, 604
ExceptionAction column 225, 603
ExceptionCoCount column 226, 604
ExceptionCode column 226, 603
ExceptionCount column 226
ExceptionMvCount column 227, 604
ExceptionSubCode column 227, 603
ExceptionTime column 227, 603
ExceptionValue column 228, 559, 603
ExecProtectionMode column 229, 612, 614
ExpandAcctString column 229, 557
ExpiredPassword column 230, 591
ExpirePassword column 230, 575, 597
ExplainFlag column 231, 560
ExplainText column 231, 556
ExpressionCount column 595
ExpressionDataType column 595
ExpressionList column 594
ExpressionListOverFlow column 594
ExpRowNo column 231, 556
656
ExtAuth column 592
ExtendedLogonSource column 592
External stored procedure 38
ExternalName column 232, 613
ExternalProcedureId column 232
ExternalProcedureName column 232
ExternalRoles column 591
ExternalSPs view 81, 469
ExtFileReference column 233, 571, 614, 616
ExtraField1 column 560, 563
ExtraField2 column 560, 563
ExtraField3 column 560, 563
ExtraField4 column 560, 563
ExtraField5 column 560
ExtraField6 column 560
ExtraField7 column 560
ExtraInfo column 233, 603
ExtraValue column 599
ExtraValue2 column 599
ExtRole column 233, 588
F
FallBackFlag column 583
FallbackFlag column 234
Field1 column 572
FieldFormat column 608
FieldId column 539, 569, 595, 608
FieldName column 608
FieldPosition column 569
FieldStatistics column 234, 609
FieldTitle column 608
FieldType column 608
FINAL column 616
FinalWDID column 234, 559
FirstRespTime column 557
FirstStepTime column 235, 557
FKPosition column 614
FloatReserved1 column 576, 596
FloatReserved2 column 576, 596
ForeignKeyFID column 584, 585, 614
FreqofUse column 235, 556
Frequency column 235, 542
FromSQLRoutineId column 617
FSGIOCount column 236, 583
FSysMiscCount column 236, 583
FSysReadCount column 236, 583
FSysWriteCount column 237, 583
FunctionDBId column 549
FunctionId column 237, 549, 613
FunctionName column 237, 549, 613
Functions view 82, 470
FunctionType column 238, 613
Data Dictionary
Index
G
Global table 568
GLOPSetDatabaseName column 238, 614
GLOPSetMemberName column 239, 614
GRANT privilege 26
GrantAuthority column 239
Grantee column 240
GranteeId column 588
GranteeKind column 240, 588
Grantor column 240
GrantorID column 539, 589
GrantorName column 241
GrantStatus column 241, 547
GroupByList column 595
GroupByListOverFlow column 595
GroupId column 586, 587, 588
GroupLockId column 587
GroupName column 241, 587, 617
GroupNameI column 587
GroupOperation column 587
GroupStatus column 587
H
Handled column 607
HashFlag column 611
HashValue column 576
HELP statement 36, 419
Hex Unicode constants 62
HighByteCount column 242, 583
HighByteCountAmp column 242, 583
HighCPUSecsCount column 242, 583
HighCPUSecsCountAmp column 243, 583
HighHist column 243, 564
HighIOCount column 243, 583
HighIOCountAmp column 244, 583
HighModelFreq column 596
HighRowCount column 244, 583
HighRowCountAmp column 244, 583
Histogram column 596
HostName column 245, 568
HostNo column 245, 590, 605
Hosts table 568
HostsInfo view 82, 472
I
I2E column 245
I2EUp column 246
IdCol table 568
IdColType column 246, 609
IFPNo column 246, 542, 566, 590
ImplicitAssignment column 615
ImpliedPoint column 608
Data Dictionary
InconsistencyFlag column 247
InconsistentFlag column 584, 585
Increment column 569
IndexConstraints view 83, 473
Indexes table 569
IndexId column 247, 549
IndexMode column 569
IndexName column 248
IndexNumber column 249, 569, 594, 600
IndexParameterString column 570
IndexPresent column 250, 578
IndexStatistics column 250, 569
IndexStats view 84, 475
IndexType column 251, 569
IndexTypeID column 570
IndexVersion column 570
Indices view 85, 478
InDoubtLog view 85, 479
InDoubtResLog table 570
InfoData column 251, 555
InfoKey column 252, 555
InsertConstantString macro 631
InsertConstantValue macro 631, 632
Install column 606
InstallFlag column 252
INSTANTIABLE column 616
InterimFldSize column 252, 614
InternalRequestNum column 253, 557
IntervalDelayCnt column 253, 604
IntReserved1 column 576, 596
IntReserved2 column 576, 596
InUseCount column 589
IO column 544
IOCount column 253
IOcount column 562
IsBitPos column 545, 550
IsDefault column 545
IsolationLevel column 592
IsSourcePrimary column 615
J
JAR_JAR_Usage table 571
JarId column 571, 589
JarLibRevision column 554
JarName column 571, 589
JarRevision column 571
JARS table 571
Java external stored procedures 42
JoinIdxDatabaseName column 254
JoinIdxName column 254
JoinIndexId column 549
JoinIndexTableID column 569
JoinIndicesV view 86, 480
657
Index
Journal_DB column 254
JournalFlag column 255, 552, 611
JournalId column 553, 554, 611
JournalName column 255
Journals view 86, 481
Journals_DB column 256
JournalSaved column 256, 578
JournalUsed column 256, 578
K
Key column 568
Keywords
ALL 35
DEFAULT 35
PUBLIC 35
Kind column 257, 606
L
LastAccessTimeStamp column 257, 539, 541, 549, 554, 569,
572, 577, 585, 596, 600, 607, 609, 612
LastAlterName column 258
LastAlterTimeStamp column 258, 546, 553, 569, 575, 577,
587, 590, 596, 607, 609, 612
LastAlterUID column 546, 553, 569, 575, 577, 587, 590, 596,
607, 609, 611
LastStateChange column 259, 557
LastValue column 259, 601
LDAP column 259, 591
LeftDBId column 545
LeftFieldKey column 546
LeftTVId column 546
LikeEscape column 260, 586
LikePattern column 260, 586
Line column 260, 597
LineNo column 261, 605
LinkingEventNum column 261, 578
ListCostProfiles macro 632
ListCostProfiles1 macro 633
ListCostProfiles2 macro 634
LobSequenceNo column 609
LockedCount column 261, 553
LockedDate column 262, 553
LockedTime column 262, 553
LockedUserExpire column 262, 263, 575, 598
LockMode column 263, 578
LogDate column 263, 264
LogicalHostID column 599
LogicalHostId column 264, 542, 557, 563, 566, 568, 570, 572,
591, 602, 603, 610
LogLevel column 266, 544
Logon rules, tracking 50
LogonAcct column 267, 591
LogonCollation column 590
658
LogonDatabase column 590
LogonDate column 267, 268, 542, 566, 590
LogonDateTime column 268, 557
LogOnOff view 86, 482
LogonRule macro 635
LogonRules column 553
LogonRules view 86, 483
LogonRuleTbl table 572
LogonSequenceNo column 268, 573, 591
LogonSource column 557, 566, 591
LogonStatus column 284, 572
LogonTime column 284, 285, 542, 566, 590
LogonUserName column 285, 570
LogProcessor column 285, 577
LogSyncPoint column 544
LogTime column 286
LogType column 286
LowByteCount column 287, 583
LowByteCountAmp column 287, 583
LowCPUSecsCount column 287, 583
LowCPUSecsCountAmp column 288, 583
LowHist column 288, 564
LowIOCount column 288, 583
LowIOCountAmp column 289, 583
LowRowCount column 289, 582
LowRowCountAmp column 289, 582
LSN column 290, 559, 562
M
Macros
ARC_NonEmpty_List 622
ARC_NonEmpty_ListM 624
ClearAccounting 624
ClearAllDatabaseUseCount 625
ClearDatabaseUseCount 625
ClearPeakDisk 626
ClearTVMUseCount 626
CollAddStandard 626
CollInstallMulti 627
CopyCostProfile 628
CreateNewCostProfile 628
DBQLAccessMacro 629
DeleteConstantValue 630
DeleteCostProfile 630
DIPMarkNSIO 631
DIPVIEWS 621
InsertConstantString 631
InsertConstantValue 632
ListCostProfiles 632
ListCostProfiles1 633
ListCostProfiles2 634
LogonRule 635
MergeCostProfile 635
Data Dictionary
Index
ResUsage 620
ShowCostProfile 636
ShowCostProfileAs 636
TwoPCRule 619
MaxAMPCPUTime column 290, 558, 562
MaxAMPCPUTimeNorm column 290, 559, 563
MaxAmpIO column 291, 558, 562
MaxAMPSpool column 291, 562
MaxCPUAmpNumber column 291, 558, 562
MaxCPUAmpNumberNorm column 292, 559, 563
MaxCPUTime column 292, 604
MaxIOAmpNumber column 292, 558, 562
MaxLength column 608
MaxLogonAttempts column 293, 575, 598
MaxNCorr column 546
MaxOutParameters column 293, 614
MaxPerm column 294
MaxPermSpace column 551
MaxProfileSpool column 294
MaxProfileSpoolSpace column 551
MaxProfileTemp column 294
MaxProfileTempSpace column 551
MaxRespTime column 295, 604
MaxSpool column 295
MaxSpoolAmpNumber column 295, 562
MaxSpoolSpace column 551
MaxStepsInPar column 296, 558
MaxTemp column 296
MaxTempSpace column 551
MaxValue column 569
MDSRecoveryTbl table 572
MechanismName column 567, 594
MechanismOid column 567, 592
MechData column 592
MergeCostProfile macro 635
MetSLGCount column 296, 604
Migration table 572
MinAmpCPUTime column 297, 558, 562
MinAmpCPUTimeNorm column 297, 559, 563
MinAmpIO column 297, 558, 562
MinAMPSpool column 298, 562
MinCPUTime column 298, 604
MinNCorr column 546
MinRespTime column 298, 604
MinValue column 569
ModAmpCount column 299, 580
Model column 299, 544
MONITOR-related queries 45
MovAmpCount column 299, 580
MovedInCount column 300, 604
MsgMiscCount column 300, 583
MsgRcvCount column 300, 583
MsgSendCount column 301, 583
MsgWaitMiscTime column 301, 584
Data Dictionary
MsgWaitRcvTime column 301, 583
MsgWaitSendTime column 302, 584
MultiColumnStats view 87, 483
N
Name column 549, 569, 599
NamedTblCheckCount column 302, 611
NameI column 549
NewWDID column 302, 603
Next table 573
NextFieIdId column 611
NextIndexId column 611
NoClassification column 303, 559
NodeCount column 303, 580
NoMemFlushCount column 303, 584
Non-X view query 36
NoSQLDataAccess column 304, 613
NotLikeEscape column 304, 586
NotLikePattern column 304, 586
Nullable column 305, 590, 608
NullCall column 305, 613
NullCount column 596
NullPassword column 306, 572
NumAMPs column 595
NumberOfRules column 560
NumFallBackTables column 553
NumLogProtTables column 553
NumOfActiveAMPs column 306, 558, 562
NumParameters column 306, 307, 613
NumResultRows column 307, 558
NumSteps column 307, 557
NumStepswPar column 308, 558
NUSICount column 308, 583
O
Object1Id column 565
Object1Name column 565
Object2Id column 565
Object2Name column 565
ObjectColumnName column 308, 556
ObjectDatabaseName column 309, 556
ObjectID column 309
ObjectId column 543, 556, 578
ObjectKind column 309, 586
ObjectLevel column 543
ObjectNum column 310, 556
ObjectState column 595
ObjectTableName column 310, 556
ObjectType column 310, 556, 578
ObjFlag column 312, 560
OldPasswords table 573
OneAMPRASDeviationPct column 596
OpenEnvID column 602
659
Index
OpEnvID column 312, 559, 603, 604
OperationInProcess column 313, 578
Operations views 32
OperatorAll column 616
Options column 313, 570, 591
OrderingCategory column 616
OrderingForm column 616
OrderingRoutineId column 616
OrderNumber column 314, 579, 582
Original_CommentString column 314, 555
Original_CreatorName column 315, 555
Original_DataBaseId column 554
Original_DatabaseName column 315, 554
Original_HashFlag column 555
Original_JournalFlag column 316, 555
Original_JournalID column 555
Original_LogicalHostId column 554
Original_NextFieldId column 555
Original_NextIndexId column 555
Original_ProtectionType column 316, 555
Original_RequestText column 555
Original_SessionNo column 554
Original_TableKind column 317, 555
Original_TableName column 317
Original_TempFlag column 555
Original_TVMId column 554
Original_TVMName column 555
Original_TVMNameI column 554
Original_UtilVersion column 555
Original_Version column 318, 555
OSDomainName column 318, 612
OSUserName column 318, 612
OtherCount column 605
OwneeId column 573
OwnerId column 552, 573
OwnerName column 319, 543, 553
Owners table 573
P
ParameterDataTypes column 320, 613
ParameterStyle column 320, 613
ParameterUDTIds column 321, 614
Parent column 321
ParentChildCorrelation table 574
ParentCount column 321, 611
ParentDb column 322
ParentDbId column 322, 574
ParentId column 574, 594
ParentKeyColumn column 322
ParentKeyFID column 323, 584, 585
ParentKeyName column 615
Parents table 574
ParentTable column 323
660
ParentTblDateFID column 574
ParentTblID column 574
ParentTblName column 614
ParentTID column 323
ParExpreqTime column 324
ParserCPUTime column 324, 558, 564
ParserCPUTimeNorm column 325, 559, 564
PartCode column 591
Partition column 326, 591, 597
PartitionCount column 327, 583
PartitionList column 595
PasswordChgDate column 327, 553
PasswordDate column 573
PasswordDigits column 327, 328, 575, 598
PasswordLastModDate column 328
PasswordLastModTime column 328
PasswordMaxChar column 329, 575, 597
PasswordMinChar column 329, 575, 597
PasswordModTime column 552
PasswordRestrictions table 574
PasswordRestrictWords column 330, 575, 598
PasswordReuse column 330, 575, 598
PasswordSalt column 552, 573
PasswordSpecChar column 331, 575
PathJarId column 571
PathJarName column 571
PDTCharType column 615
PDTCode column 615
PDTFamily column 615
PDTImpliedPoint column 615
PDTMaxLength column 615
PDTTotalDigits column 615
PeakPerm column 331
PeakPermSpace column 551
PeakSpool column 332
PeakSpoolSpace column 551
PeakTemp column 332
PeakTempSpace column 551
PermSpace column 333, 552
Phase column 333, 582
PhyProcessor column 334, 577
Platform column 334, 612, 614
PM/API 44
MONITOR-related queries 45
Queries 44
PMA column 335, 597
PrepareCount column 335, 614
PrimaryKeyIndexId column 335, 611
PrimaryUDTypeId column 615
PrimeIndex column 597
Privileges
Compatibility system views 66
Extending view 26
External stored procedures 39
Data Dictionary
Index
Insert/Update/Delete/Select 66
JARs 41
Java external stored procedures 42
Java user-defined functions 43
PM/API 44
SELECT 24
tracking 50
User-defined functions 40
UserRights view 50
ProcessOffline column 336, 579, 582
ProcessorState column 336, 577
ProcID column 337, 556, 557, 561, 563, 564, 601, 602, 603
ProcsRowLoc column 573
ProdID column 561
ProfileCat column 337, 338, 548, 550
ProfileDesc column 338, 550
ProfileID column 557, 563
ProfileId column 338, 339, 548, 550, 575
ProfileInfo view 87, 485
ProfileName column 339, 340, 348, 349, 550, 554, 575, 591
ProfileNameI column 575
Profiles table 575
ProfileTypeDesc column 340, 551
ProfileTypeId column 548, 550, 551
ProfileTypeName column 340, 551
ProtectionType column 341, 552, 610
ProtectMode column 587
ProxyCurRole column 341, 592
ProxyDfltRole column 592
ProxyRole column 559
ProxyRole1 - ProxyRole15 columns 341
ProxyRole1 column 547
ProxyRole10 column 547
ProxyRole11 column 547
ProxyRole12 column 547
ProxyRole13 column 547
ProxyRole14 column 547
ProxyRole15 column 547
ProxyRole2 column 547
ProxyRole3 column 547
ProxyRole4 column 547
ProxyRole5 column 547
ProxyRole6 column 547
ProxyRole7 column 547
ProxyRole8 column 547
ProxyRole9 column 547
ProxyUser column 342, 543, 547, 559, 592
ProxyUserID column 547
ProxyUserId column 592
ProxyUserType column 342
Q
QEventTS column 599
Data Dictionary
QryLog view 88, 487
QryLogEventHis view 90, 489
QryLogEvents view 90, 490
QryLogExceptions view 91, 492
QryLogExplain view 91, 493
QryLogObjects view 92, 495
QryLogSQL view 92, 496
QryLogSteps view 92, 497
QryLogSummary view 94, 498
QryLogTDWM view 95, 500
QryLogTDWMSum view 96, 501
QryLogXMLV view 96, 503
QueryBand column 343, 543, 557, 592
QueryCount column 343, 564
QueryID column 344, 556, 557, 561, 564, 599, 602, 607
QueryId column 576
QueryName column 576
QuerySeconds column 344, 564
QueryStatsTbl table 576
QueryText column 344, 558, 607
QueryTime column 607
QueueFlag column 345, 612
R
RCC_Configuration view 97, 504
RCC_Media view 97, 505
RCConfiguration table 577
RCEvent table 577
RCMedia table 578
ReconfigDeleteOrderTbl table 579
ReconfigDeleteOrderV view 97, 506
ReconfigID column 573
ReconfigId column 345, 579, 582
ReconfigInfoTbl table 579
ReconfigInfoV view 97, 98, 99, 507
ReconfigRedistOrderTbl table 582
ReconfigRedistOrderV view 99, 508
ReconfigTableStatsTbl table 582
ReconfigTableStatsV view 100, 101, 509
ReconfigType column 345, 579
Recovery Control views 32
RefColumns column 595
RefColumnsOverFlow column 595
RefCount column 595
ReferencedClsName column 571
ReferencedDbID column 584, 585
ReferencedTblID column 584, 585
ReferencedTbls table 584
ReferenceIdx column 584, 585, 614
ReferenceIdxName column 585, 615
ReferencingDbID column 584, 585
ReferencingTblID column 584, 585
ReferencingTbls table 585
661
Index
RefObjects column 595
RefObjectsOverFlow column 595
RejectedCount column 346, 604
RejectionCat column 346, 603
RelationshipCode column 565
RepBatchStatus table 586
RepCaptureRules view 101
RepCaptureRulesTbl table 586
RepCaptureRulesV view 510
Repgroup table 587
RepGroupTables table 587
RepRulesetTbl table 588
RepSesOverride column 591
RepStatus column 347
RepTables view 101, 512
RequestNum column 347, 557, 599, 602
RequestText column 348, 576, 587, 590, 611
RequestTextOverFlow column 576
RequestTxtOverflow column 612
Reserved column 579, 581, 582, 584
ResNode macro 49
ResolvedCurrent_Date column 600, 613
ResolvedCurrent_Timestamp column 600, 613
ResolvedDTSV view 101, 512
ResolvingUserLogonName column 350, 570
Resource usage
AMPs 47
example 47
monitoring 46
RestartSeqNum column 350, 577, 578
RestrictedWord column 351, 574
RestrictedWords view 102, 513
ResUsage macros 620
RFU column 592
RFU1 column 568
RFU2 column 568
RFU3 column 568
RFU4 column 568
RFU5 column 568
RFU6 column 568
RI_Child_Tables view 102, 513
RI_Distinct_Children view 102, 514
RI_Distinct_Parents view 103, 515
RI_Parent_Tables view 103, 516
RightDBId column 546
RightFieldKey column 546
RightTVId column 546
RoleGrants table 588
RoleId column 588
RoleInfo view 103, 517
RoleMembers view 104, 517
RoleName column 351, 554, 588
RoleNameI column 588
Roles table 588
662
RollingExpression column 595
Routine_JAR_Usage table 589
RoutineId column 589
RoutineKind column 352, 614
RoutineName column 589
RowCount column 352, 562, 576, 595
RowCount2 column 353, 562
RowCount3 column 562
RowNum column 572, 573
RowsWComprColumns column 353, 562
RowType column 543, 553, 599
RSGroupID column 612
RSQualifier column 586
RuleID column 353, 603
RuleSetId column 586, 588
RuleSetName column 354, 588
RunUnitId column 354, 570
S
SamplePCT column 546
SampleSizePct column 594
ScopeValue column 354, 602
SecConstraints table 589
SecInfo column 612
SecondaryUDTypeId column 615
Security Logging views 29
SecurityDefaults view 104, 518
SecurityLog view 104, 519
SELECT privileges 24, 26, 36
SeqInHash column 542
SeqNo column 355, 601
SeqNumber column 355
SessionID column 355, 356, 557, 564, 599, 602
SessionInfo view 105, 520
SessionMode column 356, 600
SessionNo column 357, 542, 566, 590, 605, 610
SessionNumber column 357, 570
SessionTbl table 590
SessionTemporalQualifier column 357, 560
SessionVproc column 591
Severity column 358, 597
ShowColChecks view 105, 521
ShowCostProfile macro 636
ShowCostProfileAs macro 636
ShowTblChecks view 106, 522
Signature column 589
SLGMet column 358, 559
Software_Event_Log view 106, 523
Source column 576, 595
Spare1 column 601
Spare2 column 601
SpecificName column 359
SPObjectCodeRows column 612
Data Dictionary
Index
SpoolSpace column 359, 552, 575
SpoolUsage column 360, 558, 562
SPParameterType column 360, 609
SqlFlag column 361, 560
SQLJ system views 53
JAR_JAR_USAGE 53
JARS 54
ROUTINE_JAR_USAGE 55
SqlRowNo column 361, 561
SqlTextInfo column 362, 561
SrcFileLanguage column 362, 613
StartColTime column 363, 604
StartMBox column 363, 591
StartTime column 363, 557
StartupString column 364, 552
StartValue column 569
StatementAction column 549
StatementGroup column 364, 559
StatementKind column 543
StatementText column 365, 543
StatementType column 365, 543, 558
StatisticsCnt column 605
StatisticsId column 366
StatsId column 594
StatsTableID column 573
StatsTbl table 594
StatsType column 594
Status column 366, 367, 580, 582
StepFlag column 367, 560
StepLev1Num column 368, 562
StepLev2Num column 368, 562
StepName column 368, 562
StepStartTime column 369, 562
StepStopTime column 369, 562
StepWD column 369, 562
Stored procedure
Data Dictionary tables containing 38
privileges 37
status 37
SubjectTabDbaseId column 607
SubjectTableDatabaseName column 370
SummaryFlag column 370, 560
SummaryVal1 column 370, 561
SummaryVal2 column 371, 561
SummaryVal3 column 371, 561
SW_Event_Log
ABORT SESSION 44
SET RESOURCE 44
SET SESSION 44
SW_Event_Log table 597
SW_Version column 371, 597
Syntax, how to read 639
Sys_Calendar system database 51
SysConID column 372, 559, 602, 603, 604
Data Dictionary
SysSecDefaults table 597
System Administrator views 29
System databases
Sys_Calendar 51
System Field Engineer views 29
System logs
maintaining 61
purging 61
System view versions
Non-X 27
X 27
System views
Calendar 51
SystemDefinedJI column 372, 373, 570, 613
SystemQTbl table 599
T
Table_LevelConstraints view 107, 524
TableCheck column 600
TableConstraints table 599
TableId column 544, 549, 551, 568, 569, 573, 594, 605, 606,
608
TableKind column 373, 374, 610
TableName column 375, 578, 579, 582
Tables view 108, 525
Tables_DB column 379
Tables2 view 109, 527
TableSize view 109, 528
TableText view 109, 529
Task column 379, 597
TblCheck column 380
TblRole column 612
TblStatus column 612
TDWMAllAmpFlag column 380, 559
TDWMConfLevelUsed column 380, 559
TDWMEstLastRows column 381, 559
TDWMEstMaxRows column 381, 559
TDWMEstTotalTime column 381, 559
TDWMEventHistory table 601
TDWMEventlog table 602
TDWMExceptionLog table 602
TDWMRuleId column 559
TDWMSummaryLog table 603
TempFlag column 611
TemporalProperty column 382, 613
TemporalQualifier column 382, 592, 607
TempSpace column 383, 554, 575
TempTableID column 573
TempTables table 605
Text column 383, 597
TextId column 605
TextSizeLimit column 384, 561
TextString column 605
663
Index
TextTbl table 605
TextType column 605
TheDate column 384, 542, 597
TheFunction column 385, 597
TheTime column 385, 542, 597
ThresholdFlag column 385, 561
ThresholdPct column 596
TimeAccessed column 561
TimeCreated column 561
TimeDimension column 386, 609
TimeFld column 566
TimeZoneHour column 387, 553, 591
TimeZoneMinute column 387, 553, 591
TimeZoneString column 554, 592
ToSQLRoutineId column 617
TotalDigits column 608
TotalIOCount column 387, 558, 564
TotByteCount column 388, 580, 582
TotCatchUpByteCount column 388, 580
TotCPUSecs column 388, 582
TotIOCount column 389, 582
TotJournalByteCount column 389, 580
TotRowCount column 389, 582
TotTableCount column 390, 580
TotTaskCount column 390, 580
Transaction_Mode column 390
TranslateID column 606
TranslateIn column 606
TranslateInUp column 606
TranslateName column 606
TranslateOut column 606
TranslateOutUp column 606
Translation table 606
TransLog column 391, 612
TriggerComment column 391
TriggerCount column 612
TriggerEnabled column 606
TriggerEvent column 606
TriggerId column 606
TriggerName column 391, 606
TriggerOrder column 606
Triggers view 110, 530
TriggersTbl table 606
TrustOnly column 392
TrustUser column 392
TrustUserID column 547
TSETQueryText table 607
TTCheckType column 393, 600, 610
TTConstraintType column 393, 550, 570
TTEventType column 394, 607
TTFKType column 394, 585, 586, 615
TTPKType column 394, 585, 586
TTQualifier column 395, 613
TVFields table 608
664
TVM table 610
TVMId column 395, 539, 540, 554, 572, 599, 610
TVMName column 396, 543, 611
TVMNameI column 610
TwoPCMode column 397
TwoPCRule macro 619
TypeId column 616
TypeKind column 616
TypeName column 616
TypeOfCriterion column 397, 561
TypeOfRule column 397
TypeofUse column 398, 556
U
UDFInfo table 613
UDFLibRevision column 554
UDTCast table 615
UDTInfo table 616
UDTName column 609
UDTTransform table 617
UDTypeId column 609, 617
UniqueFlag column 398, 569
UniqueOrPK column 399, 550, 570
UniqueValueCount column 596
UnnamedTblCheckExist column 399, 611
UnResolvedReferences table 614
UnResolvedRICount column 400, 553
UpperCaseFlag column 400, 609
Usage statistics, compiling 48
UsageType column 596
User_Default_Journals view 113, 537
User-defined functions 40, 43
User-defined methods 39
UserGrantedRights view 110, 532
UserId column 401, 539, 540, 542, 543, 557, 560, 563, 572,
590, 614
UserLogonDate column 401, 570
UserLogonTime column 402, 570
UserName column 402, 403, 542, 544, 559, 566, 573, 578, 590,
599, 602
UserOrProfile column 406
UserRights view 111, 533
UserRoleRights view 111, 534
Users view 112, 536
UtilityByteCount column 558
UtilityRowCount column 407, 558
UtilityTableId column 407, 562
UtilVersion column 407, 611
V
ValidStats column 576, 596
ValueName column 550
ValueType column 408, 564
Data Dictionary
Index
Version column 408, 553, 575, 587, 611
VolSequenceNum column 409, 578
VolSerialId column 409, 578
Vproc column 409, 410, 544, 551, 577, 597
VprocType column 410, 544
VTCheckType column 411, 600, 609
VTConstraintType column 411, 550, 570
VTEventType column 607
VTFKType column 412, 585, 586, 615
VTPKType column 412, 585, 586
VTQualifier column 413, 613
W
WarningOnly column 413, 558, 603
WDDelayTime column 414, 558
WDID column 414, 559, 602, 603
WDOverride column 415, 559
WhenGranted column 415
WithAdmin column 415, 589
WithGrant column 539
WithoutRole column 416, 547
X
X view query 36
XMLPlanFlag column 416, 560
XMLRowNo column 416, 564
XMLTextInfo column 417, 564
XSPExternalName column 612
XSPExtFileReference column 612
XSPOptions column 612
Data Dictionary
665
Index
666
Data Dictionary
Download PDF
Similar pages