Professional Documents
Culture Documents
Administrator Guide
Release 14.00
B035-3118-071A
November 2011
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, Managing the Business of Marketing, MyCommerce, Raising Intelligence, Smarter. Faster. Wins., SQL-MapReduce, Teradata Decision
Experts, Teradata Labs Logo, Teradata Raising Intelligence Logo, Teradata Source Experts, WebAnalyst, and Xkoto are trademarks or registered
trademarks of Teradata Corporation or its affiliates in the United States and other countries.
Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc.
AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc.
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.
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.
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 1999-2011 by Teradata Corporation. All Rights Reserved.
Preface
Purpose
This book provides information about Teradata Meta Data Services, a Teradata Tools and
Utilities product. Teradata Tools and Utilities is a group of products designed to work with
Teradata Database.
This book supports the operational responsibilities of the Teradata Meta Data Services
administrator.
For detailed installation information, see the Teradata Tools and Utilities Installation Guide for
the appropriate operating system.
Programming information and descriptions of the Application Programming Interfaces
(APIs) included with MDS are provided in the Teradata Meta Data Services Programmer
Guide.
Audience
This book is intended for use by:
Supported Releases
This book supports the following releases:
Go to http://www.info.teradata.com/.
Click Search.
Preface
Prerequisites
6
Open the version of the Teradata Tools and Utilities ##.##.## Supported Platforms and
Product Versions spreadsheet associated with this release.
The spreadsheet includes supported Teradata Database versions, platforms, and product
release numbers.
Prerequisites
The following prerequisite knowledge is required for this product:
Teradata Database
Linux
Description
November 2011
14.00
Preface
Additional Information
Additional Information
Additional information that supports this product and Teradata Tools and Utilities is available
at the web sites listed in the table that follows. In the table, mmyx represents the publication
date of a manual, where mm is the month, y is the last digit of the year, and x is an internal
publication code. Match the mmy of a related publication to the date on the cover of this book.
This ensures that the publication selected supports the same release.
Type of Information
Description
Access to Information
Release overview
1 Go to http://www.info.teradata.com/.
Late information
Preface
Additional Information
Type of Information
Description
Access to Information
Additional product
information
1 Go to http://www.info.teradata.com/.
2 Under the Online Publications subcategory,
1 Go to http://www.info.teradata.com/.
2 Under the Online Publications subcategory,
Preface
Additional Information
Type of Information
Description
Access to Information
Ordering
information for
manuals
1 Go to http://www.info.teradata.com/.
2 Under Print & CD Publications, click How to
Order.
3 Follow the ordering instructions.
General information
about Teradata
1 Go to Teradata.com.
2 Select a link.
Preface
Additional Information
Table of Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Supported Releases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
Changes to This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
Additional Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
Chapter 1:
Teradata Meta Data Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
The MDS Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Application Information Metamodels (AIMs). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Administration and Support Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MetaManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MetaSurf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MetaBrowse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Metacreate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Metaviews . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Metamigrate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Metaload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MetaClient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Metadelete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MetaXML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28
28
28
28
29
29
29
29
29
30
30
Special Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Application Programming Interfaces (APIs). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sample Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Versioning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Retain Associated Business Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Automatic DIM Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
XML Bridge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SQL Views. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30
30
30
31
31
32
32
32
33
Table of Contents
Chapter 2:
Configuration of Meta Data Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
Teradata MDS Configuration Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
Set the Workstation or Server Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
Linux Workstations or Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
Windows Workstations or Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
Create the Meta Data Repository. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
Windows Workstation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
Linux Workstation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42
Migrate the Meta Data Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42
Create A Virtual Directory or Web Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44
Chapter 3:
Administer MDS with MetaManager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45
Start MetaManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45
MetaManager Main Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
Tool Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48
Status Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48
Tree View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48
View Common Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49
View Unique Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
Teradata Database Systems and MetaManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
Add Teradata Database Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
Modify Teradata Database Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
Delete a Teradata Database System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
Teradata Databases and MetaManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
Load Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54
Unload Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58
Resynchronize Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60
Get the DIM Update Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61
Set MetaLoad LoadTypes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61
Set MDS Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64
Audit Trail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65
Activity Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
Retain Associated Business Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
View or Delete MDS Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
10
Table of Contents
Chapter 4:
MetaBrowse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Start MetaBrowse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
MetaBrowse Main Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Tool Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Application Metamodels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
77
77
79
79
79
102
103
103
104
104
104
104
Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Common Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Unique Properties of a Relationship . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Unique Properties of a Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Unique Properties of a Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Unique Properties for the Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Security Profile for the Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
View the Labels Applied to the Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
105
105
106
106
107
108
108
109
Finding Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Get Class Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Get Class Objects by Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Get Object Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
109
110
112
114
11
Table of Contents
Chapter 5:
Permissions, User Names, Passwords and Security Profiles . . .
123
MDS User Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123
Teradata MDS Users and Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124
Changing MDS User Passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124
Accessing User Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124
Application Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126
Adding a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126
Delete Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127
Membership Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128
Managing Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130
Adding a User. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130
Deleting Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
Security Profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133
Accessing Security Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134
Adding a Security Profile/Editing a Security Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135
Adding and Deleting Users and Application Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137
Assigning Security Profiles to Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138
Assigning AIM Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138
Assigning Class Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138
Assigning Object Profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139
Chapter 6:
MDS Utility Programs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143
mdsconfig (Linux only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143
12
Table of Contents
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Requirement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
metaclient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Operating Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Running metaclient from MetaBrowse or MetaManager . . . . . . . . . . . . . . . . . . . . . . . .
Command Line and Parameter File Operation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
144
144
144
145
145
145
147
150
150
metacreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
151
151
152
152
152
metaload. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
File Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Warning Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
152
152
153
156
157
metadelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
157
157
157
157
metaviews. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
metaxml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Running metaxml from MetaBrowse or MetaManager . . . . . . . . . . . . . . . . . . . . . . . . . .
Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
158
158
158
159
159
159
161
161
161
162
13
Table of Contents
Chapter 7:
Automatic DIM Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .163
Automatic DIM Update Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .163
Relay Services Gateway (RSG) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164
DDL Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164
MDS Action Processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164
MDS Recovery Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164
Database Connection Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165
Out of Sync Recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165
Teradata Database System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165
RSG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166
DDL Gateway Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166
Configuring Automatic DIM Update in MetaManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166
Adding a Teradata Database System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167
Adding Teradata Nodes to a Teradata Database System . . . . . . . . . . . . . . . . . . . . . . . . . .167
Loading Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .168
Enabling Automatic DIM Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169
Checking DIM Update Status with MetaManager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .170
Starting/Stopping the DDL Gateway. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .170
Starting/Stopping the MDS Action Processor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .171
Chapter 8:
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173
Troubleshooting - Programming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173
Troubleshooting - Miscellaneous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .174
Appendix A:
Teradata Metadata - Database Information Metamodel . . . . .177
DIM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .177
DIM Class Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .179
DIM Class Property Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .180
Database System Class Property Descriptions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .180
Database Class Property Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .182
Table Class Property Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183
Column Class Property Descriptions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183
View Class Property Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .185
14
Table of Contents
186
187
187
188
188
188
189
189
189
190
191
191
191
192
192
192
193
193
194
194
195
195
196
197
198
199
Appendix B:
Client Load Utility Metadata - Client Load Metamodel . . . . . . . 203
Client Load Metamodel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
CLM Class Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
CLM Class Property Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Script Class Property Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Source Class Property Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Source Field Class Property Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Target Class Property Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
205
205
206
206
207
15
Table of Contents
Appendix C:
SQL Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .209
MDS SQL Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .209
meta_BusinessAttrColumns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .210
meta_BusinessAttributeRules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
meta_BusinessAttributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
meta_BusinessAttrViewCols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .212
meta_BusinessEntities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .212
meta_BusinessEntityAttrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
meta_BusinessEntityTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
meta_BusinessEntityViews. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
meta_BusinessRules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
meta_BusinessRuleValues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
meta_CheckConstraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215
meta_ColumnHasTriggers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215
meta_Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
meta_DatabaseBusEntities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .218
meta_DatabaseBusinessRules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .218
meta_DatabaseOwnsDatabases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .219
meta_Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .219
meta_DatabaseSubjectAreas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .220
meta_StoredProcedureMacros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .220
meta_FunctionParameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221
meta_HashIndexIndices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .222
meta_HashIndexTableColumns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .223
meta_HashIndexTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .224
meta_IndexColumns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .224
meta_Indexes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .225
meta_JoinIndexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .226
meta_JoinIndexFunctions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .227
meta_JoinIndexIndices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .227
meta_JoinIndexTableColumns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228
meta_JoinIndexTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
meta_MacroHashIndexes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
meta_MacroJoinIndexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230
meta_MacroParameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230
meta_MacroReferencesMacros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .232
16
Table of Contents
meta_Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
meta_MacroStoredProcedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
meta_MacroTableColumns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
meta_MacroTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
meta_MacroTriggers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
meta_MacroViewColumns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
meta_MacroViews . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
meta_RefConstraintColumns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
meta_RefConstraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
meta_SPParameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
meta_StoredProcedureMacros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
meta_StoredProcedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
meta_StoredProcedureTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
meta_StoredProcedureViews. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
meta_StoredProcHashIndexes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
meta_StoredProcJoinIndexes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
meta_StoredProcRefsSPs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
meta_StoredProcTableColumns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
meta_StoredProcViewColumns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
meta_SubjectAreaEntities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
meta_SubjectAreas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
meta_SystemMetaloadTypes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
meta_SystemNodes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
meta_TableColumns. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
meta_TableHasTriggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
meta_Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
meta_TriggerMacros. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
meta_Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
meta_TriggerTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
meta_TV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
meta_TVColumns. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
meta_TVM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
meta_ValidValues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
meta_ViewColumnConstants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
meta_ViewColumnFunctions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
meta_ViewColumns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
meta_ViewColumnTableColumns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
meta_ViewReferencesViews. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
17
Table of Contents
meta_Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .256
meta_ViewTableColumns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .256
meta_ErrorTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .257
meta_ColumnUDTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .257
meta_MacroFunctions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .257
meta_MacroParameterUDTs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .258
meta_SPParameterUDTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .258
meta_TriggerFunctions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .259
meta_TriggerUDTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .259
meta_UDFFunctions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .260
meta_UDFs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .260
meta_UDTAttributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .261
meta_UDTAttributeUDTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .261
meta_UDTFunctions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .262
meta_UDTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .262
meta_ViewColumnUDTs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .263
meta_ViewFunctions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .263
meta_ViewTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .263
Appendix D:
XML Bridge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .265
XML Bridge Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .265
Supported tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .266
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .266
How to Use XML Bridge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .267
OMG CWM to MDS CWM_Metamodel mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .270
Current limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .277
Updates not supported . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .277
Not linking to DIM objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .277
Technical Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .278
Importing XML via the GUIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .278
Exporting from the MDS repository into the tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .279
User Bridge Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .280
FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .280
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .283
18
List of Figures
19
List of Figures
20
List of Tables
21
List of Tables
22
List of Tables
23
List of Tables
Table 104: Columns, Data Types, and Values of the meta_MacroParameters View . . . . . . .230
Table 105: Columns and Data Types of the meta_MacroReferencesMacros View . . . . . . . .232
Table 106: Columns and Data Types of the meta_Macros View . . . . . . . . . . . . . . . . . . . . . . .232
Table 107: Columns and Data Types of the meta_MacroStoredProcedures View . . . . . . . . .233
Table 108: Columns and Data Types of the meta_MacroTableColumns View . . . . . . . . . . .233
Table 109: Columns and Data Types of the meta_MacroTables View . . . . . . . . . . . . . . . . . .234
Table 110: Columns and Data Types of the meta_MacroTriggers View . . . . . . . . . . . . . . . . .234
Table 111: Columns and Data Types of the meta_MacroViewColumns View . . . . . . . . . . . .234
Table 112: Columns and Data Types of the meta_MacroViews View . . . . . . . . . . . . . . . . . . .235
Table 113: Columns and Data Types of the meta_RefConstraintColumns View. . . . . . . . . .235
Table 114: Columns and Data Types of the meta_RefConstraints View . . . . . . . . . . . . . . . . .236
Table 115: Columns, Data Types, and Values of the meta_SPParameters View. . . . . . . . . . .237
Table 116: Columns and Data Types of the meta_StoredProcedureMacros View . . . . . . . . .238
Table 117: Columns and Data Types of the meta_StoredProcedures View . . . . . . . . . . . . . .238
Table 118: Columns and Data Types of the meta_StoredProcedureTables View. . . . . . . . . .239
Table 119: Columns and Data Types of the meta_StoredProcedureViews View . . . . . . . . . .240
Table 120: Columns and Data Types of the meta_StoredProcHashIndexes View . . . . . . . . .240
Table 121: Columns and Data Types of the meta_StoredProcJoinIndexes View . . . . . . . . . .240
Table 122: Columns and Data Types of the meta_StoredProcRefsSPs View . . . . . . . . . . . . .241
Table 123: Columns and Data Types of the meta_StoredProcTableColumns View . . . . . . .241
Table 124: Columns and Data Types of the meta_StoredProcViewColumns View . . . . . . . .242
Table 125: Columns and Data Types of the meta_SubjectAreaEntities View . . . . . . . . . . . . .242
Table 126: Columns and Data Types of the meta_SubjectAreas View. . . . . . . . . . . . . . . . . . .243
Table 127: Columns and Data Types of the meta_SystemMetaloadTypes View . . . . . . . . . .243
Table 128: Columns and Data Types of the meta_SystemNodes View . . . . . . . . . . . . . . . . . .244
Table 129: Columns, Data Types, and Values of the meta_TableColumns View. . . . . . . . . .244
Table 130: Columns and Data Types of the meta_TableHasTriggers View . . . . . . . . . . . . . .246
Table 131: Columns and Data Types of the meta_Tables View . . . . . . . . . . . . . . . . . . . . . . . .246
Table 132: Columns and Data Types of the meta_TriggerMacros View . . . . . . . . . . . . . . . . .247
Table 133: Columns, Data Types, and Values of the meta_Triggers View . . . . . . . . . . . . . . .247
Table 134: Columns and Data Types of the meta_TriggerTables View . . . . . . . . . . . . . . . . . .248
Table 135: Columns and Data Types of the meta_TV View . . . . . . . . . . . . . . . . . . . . . . . . . . .249
Table 136: Columns and Data Types of the meta_TVColumns View . . . . . . . . . . . . . . . . . . .249
Table 137: Columns and Data Types of the meta_TVM View . . . . . . . . . . . . . . . . . . . . . . . . .250
Table 138: Columns and Data Types of the meta_ValidValues View . . . . . . . . . . . . . . . . . . .251
Table 139: Columns, Data Types, and Values of the meta_ViewColumnConstants View . .251
24
List of Tables
Table 140: Columns and Data Types of the meta_ViewColumnFunctions View. . . . . . . . . 253
Table 141: Columns, Data Types, and Values of the meta_ViewColumns View . . . . . . . . . 253
Table 142: Columns and Data Types of the meta_ViewColumnTableColumns View. . . . . 255
Table 143: Columns and Data Types of the meta_ViewReferencesViews View . . . . . . . . . . 255
Table 144: Columns and Data Types of the meta_Views View . . . . . . . . . . . . . . . . . . . . . . . 256
Table 145: Columns and Data Types of the meta_ViewTableColumns View. . . . . . . . . . . . 256
Table 146: Columns and Data Types of the meta_ErrorTables View . . . . . . . . . . . . . . . . . . 257
Table 147: Columns and Data Types of the meta_ColumnUDTs View . . . . . . . . . . . . . . . . 257
Table 148: Columns and Data Types of the meta_MacroFunctions View . . . . . . . . . . . . . . 258
Table 149: Columns and Data Types of the meta_MacroParameterUDTs View . . . . . . . . . 258
Table 150: Columns and Data Types of the meta_SPParameterUDTs View . . . . . . . . . . . . 258
Table 151: Columns and Data Types of the meta_TriggerFunctions View . . . . . . . . . . . . . . 259
Table 152: Columns and Data Types of the meta_TriggerUDTs View . . . . . . . . . . . . . . . . . 259
Table 153: Columns and Data Types of the meta_UDFFunctions View . . . . . . . . . . . . . . . . 260
Table 154: Columns and Data Types of the meta_UDFs View. . . . . . . . . . . . . . . . . . . . . . . . 260
Table 155: Columns and Data Types of the meta_UDTAttributes View. . . . . . . . . . . . . . . . 261
Table 156: Columns and Data Types of the meta_ViewTableColumns View. . . . . . . . . . . . 261
Table 157: Columns and Data Types of the meta_UDTFunctions View. . . . . . . . . . . . . . . . 262
Table 158: Columns and Data Types of the meta_UDTs View . . . . . . . . . . . . . . . . . . . . . . . 262
Table 159: Columns and Data Types of the meta_ViewTableColumns View. . . . . . . . . . . . 263
Table 160: Columns and Data Types of the meta_ViewFunctions View. . . . . . . . . . . . . . . . 263
Table 161: Columns and Data Types of the meta_ViewTables View. . . . . . . . . . . . . . . . . . . 264
Table 162: Tools supported by XML Bridge. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Table 163: Mapping OMG CWM to MDS CWM_Metamodel . . . . . . . . . . . . . . . . . . . . . . . 271
25
List of Tables
26
CHAPTER 1
Teradata Meta Data Services (MDS) provides an infrastructure for managing Teradata data
warehouse metadata and for creating tools to interchange metadata with external operational
systems, Extraction Transformation and Load (ETL) tools, Business Intelligence tools,
Database Modeling tools, and any other metadata sources.
Components of Teradata MDS include:
27
The Teradata Database Information Metamodel (DIM) is a predefined AIM for storing the
Teradata Data Dictionary information from Teradata databases and associated business
data.
The Client Load Metamodel (CLM) is a predefined AIM for storing the information
obtained from Teradata client FastLoad, MultiLoad and TPump utility scripts and output
files.
These AIMs can be extended or entirely new AIMs can be created to store other metadata in
the MDS repository.
MetaManager
MetaManager is a Windows based Graphical User Interface (GUI) program for performing
administrative tasks including:
Viewing logs
MetaSurf
Use MetaSurf s HTML files and Active Server Pages (ASP) scripts to set up a powerful Webbased application for viewing, navigating and analyzing Business and Technical metadata
stored in the MDS repository.
Access is based on the users role whether it be business, technical, or administrator through a
standard web browser.
Metasurf also provides the ability to edit metadata stored in the repository.
MetaBrowse
MetaBrowse is a Windows based GUI program for performing such tasks as:
28
Metacreate
The metacreate program creates the initial MDS repository.
Metaviews
The metaviews program installs a set of MDS views into the DBC database. If installed, the
metaload program will use the views to access the DBC tables when loading the data
dictionary information into the repository. Although not required, it is strongly
recommended that the MDS views be installed for all Teradata systems to be tracked in the
MDS repository.
If the Automatic DIM Update feature is enabled on a system, the MDS views must be installed
on any system that does not support Unicode. See Automatic DIM Update on page 32 for
more information.
Metamigrate
The metamigrate program migrates an existing repository to a newer MDS repository version.
Metaload
The metaload program is a command line alternative and the program MetaManager uses for
loading, unloading or resynchronizing databases. The metaload program loads the Teradata
metadata into the MDS repository Database Information Metamodel (DIM). The metaload
program is Unicode-enabled. It will attempt to make a UTF-16 session character set
connection to Teradata databases.
If the program can establish a UTF-16 connection, the program does not require that the
MDS views be installed into the DBC database with the metaviews program.
If the program cannot establish a UTF-16 connection, it will run in a mode that requires that
the MDS views be installed into the DBC database with the metaviews program.
Beginning with MDS 13.0, metaload offers the ability to limit the database objects that will have
metadata extracted and loaded into the repository. Limiting the metadata can improve load
time and decrease the amount of disk space required by the repository but it can also result in
incomplete information. See Set MetaLoad LoadTypes on page 61 for more information.
MetaClient
The metaclient program loads CLM information into the repository. It can be run by any
MDS user from either the command line, through MetaManager, or MetaBrowse.
29
Metadelete
The metadelete program drops all MDS repository tables, views, and macros in the MDS
repository database, effectively deleting the MDS repository.
MetaXML
The metaxml program imports data from an XML file into the repository or exports
metamodel definitions and object data to an XML file.
Special Features
In addition to the administrative support tools and utilities discussed above, Teradata MDS
also provides some special features that allow for highly customized metadata solutions.
C++
XML
Java
Samples for loading data through the APIs are also included. For additional information on
the APIs refer to theTeradata Meta Data Services Programmer Guide.
Sample Files
Teradata MDS also provides a number of different sample files that enable you to further
customize and configure your metadata solution.
Some of the sample files include:
Sample code for use with the C++, COM and Java interfaces
All of the sample files are located in individual directories below the sample directory with a
explanatory readme.txt file. Sample files are only installed if the MDS Development Kit is
installed.
30
For detailed installation information, see the Teradata Tools and Utilities Installation Guide for
the appropriate operating system.
Versioning
Teradata MDS provides the ability to retain historical copies of data objects within classes or
data versioning.
The historical copies provide the ability to see the progression of changes made to an object
after its initial creation. Applications and users will only be allowed to modify the latest
version of an object, but the earlier versions will be viewable, within the restrictions of the
applicable security profile.
Versioning applies to data objects within classes. It cannot be used with the definitions of
models, classes, relationships, properties, users, or security profiles.
If versioning is enabled for a repository, AIM or class, MDS internally tracks two types of
versions:
Published
Inactive
Specific metamodels
Specific classes
A repository with versioning enabled will require more PERM and SPOOL space on the
Teradata Database than the same repository created without versioning enabled.
31
Information option prevents this from happening and ensures that MDS reassociates any
custom descriptions and business information previously defined.
By default, a new MDS repository or a pre-12.0 repository being migrated to the current
release will not have Retain Associated Business Information enabled.
A repository with Retain Associated Business Information support enabled will require more
PERM and SPOOL space on the Teradata Database than the same repository created without
Retain Associated Business Information support enabled.
XML Bridge
XML Bridge supports the exchange of metadata between MDS repository and select businessintelligence (BI), analytic, and modeling tools. Such tools must comply with the Object
Management Group (OMG) Common Warehouse Metamodel (CWM) XML Metadata
Interchange (XMI) format. For more information, see Appendix D: XML Bridge.
SQL Views
Teradata MDS now provides SQL views for observing the relationships between tables,
macros, views, and so on, as defined in the repository.
Each view provides data on some relationship, generally organized by system and database
names. For example, the view meta_ViewTables returns the columns System, TableDatabase,
TableName, ViewDatabase, and ViewName. The view meta_MacroTables returns similar info
for macros, and so on for the other types that reference tables. For details about each view, see
Appendix C SQL Views on page 209.
32
Logging
Teradata MDS provides several different types of log files.
The Teradata MDS Audit Trail is a table in the MDS repository that contains an audit trail of
changes to the Teradata metadata. Entries are written to the table by the metaload utility.
Entries are also written to the table by the MDS DDL Gateway Integrity Servers if the
Automatic DIM Update feature is enabled. For each update to the DIM, an entry is inserted
into the audit trail table when audit logging is enabled.
The Teradata MDS Activity Log is a table in the MDS repository that, when activity logging is
enabled, tracks user access (reads, writes, deletes) of objects in the repository. The log also
indicates when access to an object is rejected because of permission conflicts. The Activity
Log, unlike the Audit Trail, is not limited to only tracking changes to the DIM.
You can view the contents of both the Activity log and the Audit Trail through MetaSurf (while
logged on as an Administrator) or by using SQL directly. The Audit Trail can be accessed
through the metaauditlog table or the mdsauditlog view. The Activity Log can be accessed
directly through the metaactivitylog table.
MDS Logs track error messages, warnings, and debug information on individual machines
where the MDS software is installed. The MDS Logs can be viewed through MetaManager.
For detailed installation information, see the Teradata Tools and Utilities Installation Guide for
the appropriate operating system.
33
34
CHAPTER 2
For detailed installation information, see the Teradata Tools and Utilities Installation Guide for
the appropriate operating system.
One or more workstations accessing the Teradata MDS repository with a web browser
An Active Server Pages (ASP) compliant web server with MetaSurf installed
Your system may also contain one or more workstations that will be used to develop or run
MDS applications and, if the Teradata MDS Automatic DIM Update feature is to be installed,
a designated DIM Update server.
35
Workstation/Laptop/Etc
with Supported Browsers
ASP
Page
HT40
2EQUEST
HT-,