Data Labs - 2212 105K

What would you do if you knew?
Teradata Data Lab

User Guide
Release 15.11
B035-2212-105K
October 2015
The product or products described in this book are licensed products of Teradata Corporation or its affiliates.
Teradata, Active Data Warehousing, Active Enterprise Intelligence, Applications-Within, Aprimo Marketing Studio, Aster, BYNET,
Claraview, DecisionCast, Gridscale, MyCommerce, QueryGrid, SQL-MapReduce, Teradata Decision Experts, "Teradata Labs" logo, Teradata
ServiceConnect, Teradata Source Experts, WebAnalyst, and Xkoto are trademarks or registered trademarks of Teradata Corporation or its
affiliates in the United States and other countries.
Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc.
AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc.
Apache, Apache Avro, Apache Hadoop, Apache Hive, Hadoop, and the yellow elephant logo are either registered trademarks or trademarks
of the Apache Software Foundation in the United States and/or other countries.
Apple, Mac, and OS X all are registered trademarks of Apple Inc.
Axeda is a registered trademark of Axeda Corporation. Axeda Agents, Axeda Applications, Axeda Policy Manager, Axeda Enterprise, Axeda
Access, Axeda Software Management, Axeda Service, Axeda ServiceLink, and Firewall-Friendly are trademarks and Maximum Results and
Maximum Support are servicemarks of Axeda Corporation.
Data Domain, EMC, PowerPath, SRDF, and Symmetrix are registered trademarks of EMC Corporation.
GoldenGate is a trademark of Oracle.
Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company.
Hortonworks, the Hortonworks logo and other Hortonworks trademarks are trademarks of Hortonworks Inc. in the United States and other
countries.
Intel, Pentium, and XEON are registered trademarks of Intel Corporation.
IBM, CICS, RACF, Tivoli, and z/OS are registered trademarks of International Business Machines Corporation.
Linux is a registered trademark of Linus Torvalds.
LSI is a registered trademark of LSI Corporation.
Microsoft, Active Directory, Windows, Windows NT, and Windows Server are registered trademarks of Microsoft Corporation in the United
States and other countries.
NetVault is a trademark or registered trademark of Dell Inc. in the United States and/or other countries.
Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries.
Oracle, Java, and Solaris are registered trademarks of Oracle and/or its affiliates.
QLogic and SANbox are trademarks or registered trademarks of QLogic Corporation.
Quantum and the Quantum logo are trademarks of Quantum Corporation, registered in the U.S.A. and other countries.
Red Hat is a trademark of Red Hat, Inc., registered in the U.S. and other countries. Used under license.
SAP is the trademark or registered trademark of SAP AG in Germany and in several other countries.
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 e-mail: 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 2011 - 2015 by Teradata. All Rights Reserved.
Table of Contents
Preface.............................................................................................................................................................7
Audience................................................................................................................................................................ 7
Revision History................................................................................................................................................... 7
Additional Information........................................................................................................................................7
Related Links..................................................................................................................................................7
Related Documentation ...............................................................................................................................7
Customer Education..................................................................................................................................... 8
Product Safety Information.................................................................................................................................8
Chapter 1:
Overview........................................................................................................................................................9
Introduction to Teradata Data Lab.....................................................................................................................9
Data Labs Workflow................................................................................................................................... 10
Data Labs...................................................................................................................................................... 10
Lab Groups................................................................................................................................................... 10
Teradata Database Privileges.............................................................................................................. 11
Data Lab Users.............................................................................................................................................11
Chapter 2:
Managing Lab Groups and Labs........................................................................................... 13
Connecting to a System..................................................................................................................................... 13
Disconnecting from a System........................................................................................................................... 13
Changing Systems...............................................................................................................................................13
Setting Email Notifications............................................................................................................................... 13
Working with Lab Groups................................................................................................................................. 14
Access and Approval Controls for Lab Groups....................................................................................... 14
Access Controls.................................................................................................................................... 14
Approval Controls................................................................................................................................ 15
Adding a Lab Group....................................................................................................................................16
Request Limits...................................................................................................................................... 20
Changing Allocated Space..........................................................................................................................20
Changing the Lab Group Description...................................................................................................... 20
Teradata Data Lab User Guide, Release 15.11
Table of Contents
Changing Access for Viewing Users and Roles.........................................................................................21

Changing Default Lab Group Owner Email Notifications..................................................................... 21
Changing Lab Group Default Users...........................................................................................................21
Changing Lab Group Owners.....................................................................................................................22
Changing Lab Group Privacy..................................................................................................................... 23
Changing Lab Group Thresholds and Approvers.................................................................................... 24
Deleting a Lab Group...................................................................................................................................24
Working with Labs...............................................................................................................................................25
Changing the Default Lab Size................................................................................................................... 25
Changing the Default Lab Expiration........................................................................................................25
Changing Default Lab Instructions............................................................................................................26
Changing Default Lab Request Limits.......................................................................................................26
Changing Default Lab Owner Email Notifications................................................................................. 27
Deleting Expired Labs..................................................................................................................................27
Data Labs Settings View......................................................................................................................................27
Managing Default Settings.......................................................................................................................... 28
Setting Display Thresholds..........................................................................................................................28
Chapter 3:
Monitoring Lab Groups, Labs, and Tables...................................................................31
Monitoring............................................................................................................................................................31
Viewing Lab Group Details......................................................................................................................... 32
Viewing Lab Details......................................................................................................................................33
Viewing Sample Rows.................................................................................................................................. 33
Exporting Data.....................................................................................................................................................33
Metrics for Monitoring, Approvals, and Requests Tabs................................................................................. 34
Chapter 4:
Managing Requests and Approvals................................................................................... 39
Requests................................................................................................................................................................ 39
Requesting a Lab...........................................................................................................................................40
Request Status............................................................................................................................................... 41
Viewing Request Status................................................................................................................................ 42
Viewing the Request Log............................................................................................................................. 42
Metrics for Request Log........................................................................................................................43
Requesting a Lab Size Increase................................................................................................................... 44
Requesting a Lab Size Decrease..................................................................................................................45
Requesting the Addition of a User............................................................................................................. 45
Table of Contents
Requesting the Removal of a User.............................................................................................................47

Requesting the Addition of an Owner......................................................................................................47
Requesting the Removal of an Owner...................................................................................................... 48
Requesting a Lab Deletion......................................................................................................................... 49
Requesting a Lab Extension....................................................................................................................... 50
Requesting a Change in Lab Details......................................................................................................... 51
Requesting a Table Description Edit.........................................................................................................52
Requesting Reinstatement of a Lab...........................................................................................................52
Sending Other Requests............................................................................................................................. 53
Requesting to Drop a Table........................................................................................................................ 54
Deleting a Request.......................................................................................................................................54
Resubmitting a Failed Request.................................................................................................................. 55
Approvals............................................................................................................................................................. 55
Viewing Requests for Approval..................................................................................................................56
Approving Requests.................................................................................................................................... 57
Denying Requests........................................................................................................................................ 57
Chapter 5:
Reporting.................................................................................................................................................... 59
Reports................................................................................................................................................................. 59
Viewing Reports...........................................................................................................................................60
Table of Contents
Preface
Audience
This guide is intended for use by:
Database administrators
System administrators
Application developers and users
Revision History
Date
Release
Description
October 2015
15.11
Initial release.
Added content to support reports.
Additional Information
Related Links
URL
Description
https://tays.teradata.com
Use Teradata At Your Service to access Orange Books, technical

alerts, and knowledge repositories, view and join forums, and
download software packages.
www.teradata.com
External site for product, service, resource, support, and other

customer information.
Related Documentation
Documents are located at www.info.teradata.com.
Title
Publication ID
Teradata Viewpoint User Guide
B035-2206
Describes the Teradata Viewpoint portal, portlets, and system administration

features.
Preface
Title
Publication ID
Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers
B035-2207
Describes how to install Viewpoint software, configure settings, and upgrade a

Teradata Viewpoint server.
Customer Education
Teradata Customer Education delivers training for your global workforce, including
scheduled public courses, customized on-site training, and web-based training. For
information about the classes, schedules, and the Teradata Certification Program, go to
www.teradata.com/TEN/.
Product Safety Information

This document may contain information addressing product safety practices related to data
or property damage, identified by the word Notice. A notice indicates a situation which, if not
avoided, could result in damage to property, such as equipment or data, but not related to
personal injury.
Example
Notice: Improper use of the Reconfiguration utility can result in data loss.
CHAPTER 1
Overview
Introduction to Teradata Data Lab

A data lab is a separate dedicated space within a production data warehouse for agile
development of new analytic queries that can combine personal, ad hoc, or temporary data
with production data. Use a data lab to quickly analyze, reorganize, model, and prototype a
sample of real-time data, and experiment without any risk to production data.
A data lab benefits your organization in the following ways:
Model data to see value before it is formally incorporated into the data warehouse
Analyze data to see if it supports a prototype or proof of concept
Access production space quickly and easily
Manage workloads for data separately from production service level goals
Explore data in production tables while maintaining data integrity
Evaluate data on a short-term basis, such as for a merger or acquisition
Reduce the database administrator workload by allowing users to manage data
independently
Chapter 1 Overview
Data Labs Workflow

Data labs are created and maintained by the Teradata Database Administrator (DBA) or by
designated owners depending on the needs of the organization. A best practice is to create a
team that defines the needs of the organization and establishes governance, practices, and
characteristics for the data labs.
The Data Labs portlet allows you to add lab groups. As part of the lab group creation,
defaults are defined for each data lab provisioned within the lab group. Additionally, access
and approval controls and lab instructions can be established. Lab instructions provide
guidance and best practices to help lab users. For example, provide information for loading
data into tables using Teradata Data Mover or load utilities such as FastLoad or MultiLoad.
Make a lab group private for security or other reasons so the labs in the lab group are only
available to a restricted set of Teradata Database users and roles. After the lab group is
created, the DBA has the ability to provision a data lab within the lab group and can assign
lab group owners who approve user and space requests. Some of those requests can be set to
be automatically approved. After a request to add a lab is approved, the lab can be
immediately used.
The DBA can load data from external sources or aggregate data from production tables. If the
user decides data is ready to go into production, they can email the owner or send a request.
A request sends a message to the lab owner. The lab owner or the DBA can move the tables
into production in accordance with corporate policies.
Data Labs
A data lab is a separate dedicated space within a production data warehouse used for agile
development of new analytic queries that can combine personal, ad hoc, or temporary data
with production data. Data labs are governed by the DBA or by designated users, depending
on the needs of the organization.
The Teradata Viewpoint Administrator can use the Roles Manager portlet to assign portlet
permissions to the roles. Setting the Manage Lab Groups permission enables the role to
create, edit, and delete lab groups. Enabling the Dictionary data collector in the Monitored
Systems portlet ensures displayed data stays fresh in the Data Labs portlet and permissions
are synchronized with the Teradata Database.
There are several types of data lab users who use the portlet. Lab group owners, lab owners,
and lab users submit requests for actions they want to do, such as adding or deleting a lab,
increasing or decreasing the lab size, extending the lab expiration date, and so on.
The Settings view allows you to set thresholds that turn information red in the portlet view.
From the portlet frame, you can set criteria for receiving email notifications.
Lab Groups
A lab group is used to allocate space for labs. Organize lab groups in ways that best suit your
organization, such as by function, department, country, or region. For example, you may
10
Chapter 1 Overview
have four lab groups and eleven labs. You must have permission from the DBA to create,
edit, and delete lab groups. Labs can be set to expire.
Teradata Database Privileges
A lab group is a database that is created in the underlying parent database that is selected
when a lab group is created. A child database is created in the underlying Lab Group
database when an add lab request is approved.
The actions in the portlet affect the Teradata Database privileges or accessibility on the
underlying Lab databases as listed below.
Action in the Portlet
Privileges or Accessibility on the Lab Database
When a lab expires
READ and WRITE commands cannot be performed.
When a lab is reinstated
READ and WRITE commands can be performed.
When a lab is deleted
A DROP command is performed.
When a Teradata Database user or

role is made read-only
Users can only issue SELECT statements, but not other DML
statements or DDL. This prevents users or roles from creating,
modifying, or dropping Teradata Database tables in a lab.
After a lab extension is approved on The lab owner gets access to the Lab database.
an expired lab
Data Lab Users

DBAs
The DBA, typically your Teradata Database Administrator, ensures the integrity and
health of the production system. They also want to share the workload where it
11
Chapter 1 Overview
makes sense. The portlet provides integration aspects into Teradata workload
management strategies, in particular Teradata Active System Management (TASM),
allowing the data lab environment to be managed using wildcard classifications.
After workload management is set up and a portion of database space is allocated,
data labs management can be given to one or more data lab owners.
Typically, your DBA architects the lab group structure, creates lab groups, assigns
lab group owners to manage approvals, manages space, configures workload
management, and can approve requests.
Also, the DBA ensures the proper Teradata Database privileges are given and works
with the Teradata Viewpoint Administrator to ensure the Data Labs portlet
permissions are assigned to the Viewpoint role allowing users in that role to create,
edit, and delete lab groups.
Power Users
The power user, typically owns and manages data labs, is an IT representative for
their team where they manage the external repositories for data proofing. They act
as the liaison between the DBA and the business analyst and end users. With the
Data Lab framework and appropriate Viewpoint portlets, management
responsibilities are simplified and are more efficient with more productive results.
Typically, your power user can be either the lab group owner or the lab owner.
As the lab group owner, they send and approve requests, can delegate approval
authority, and receive lab group email notifications.
As the lab owner, they manage labs, can approve requests if given approval
authority, receive lab email notifications, and use labs to analyze data.
End Users
The end user, typically a business analyst, explores data and tests theories. They want
to easily implement the proofing of data and then migrate new data into production
information. Data labs provide proof that test results will be consistent when
implemented in production. The end user receives fresh data and does not have to
wait for periodic data loads from production.
Typically, the end user sends requests, views tables in a lab, and uses labs to analyze
data.
12
CHAPTER 2
Managing Lab Groups and Labs
Connecting to a System
1 In the Connect to System dialog box, select a system from the list.
2 Type your Teradata Database user ID and password.
3 [Optional] Do any of the following:
Enter an Account String

Select an Authentication Mechanism from the list
Select a Character Set from the list
4 Click Connect.
Disconnecting from a System

1 From the portlet frame, click
next to the system name, and select Disconnect.
Changing Systems
1 From the portlet frame, click
next to the system name, and select Change System.
2 Select a system from the list.

3 Enter your Teradata Database user ID and other login information.
4 Click Connect.
Setting Email Notifications

You can set criteria for receiving email notifications. The notifications you set are specific to
you as a requester, approver, lab owner, or lab group owner. Changes are applied to all your
instances of the Data Labs portlet.
The Data Labs portlet is dependent on the Teradata alert service to send email notifications.
1 Click
in the portlet frame, and select My Notifications.
13
Chapter 2 Managing Lab Groups and Labs

2 Select or clear the check boxes for email notification.
3 Click OK.
Working with Lab Groups

A lab group is used by the lab group owner to allocate space for labs. A lab group in Teradata
Viewpoint is a database in the Teradata Database and data labs are children of the that
database.
The Teradata Viewpoint Administrator assigns portlet permissions to a role allowing that role
to create, edit, and delete lab groups. When a lab group is created, the available space
allocated to the lab group is defined, as well as the default lab size, default lab expiration,
when an expired lab is automatically deleted, and a lab prefix when new labs are added to the
lab group. A lab prefix precedes your lab name to help manage workloads and is optional. For
new labs, users can request any lab size or expiration date.
The following settings can be applied either when a lab group is created or after a lab group is
created:
Control access to a lab group for security or other reasons so the labs in the lab group are
only available to a restricted set of Teradata Database users and roles.
Control who approves requests. For example, a lab group owner can temporarily give the
lab owner control of approving requests while the lab group owner is on vacation.
Provide lab instructions for a lab group that provide guidance and best practices to help
lab users. For example, provide information for loading data into tables using Teradata
Data Mover or load utilities such as FastLoad or MultiLoad. These instructions are
optional.
Assign read-only access to prevent Teradata Database users and roles from creating or
modifying tables in the lab. Read-only users cannot send requests to remove a user,
increase or decrease lab size, delete, extend, or reinstate a lab, drop a table, or edit lab
details. Users or roles with read-only access can send requests to add a lab, add a user, or
send an Other request.
Access and Approval Controls for Lab Groups

Access Controls
Access controls determine who can access the labs for security or other reasons and whether
lab users can view lab group details and lab details. These controls are typically set when a lab
group is created, however, the controls can be added or changed later.
The access controls are described below.
14

Control
Control Locations
Enable display of
users and roles for
the lab group and
labs
Restrict access to
selected users and
roles check box
Read-only check box
Give access to
selected users and
roles check box
Control Description
Step 1 Lab Group in the Add Lab

Select to enable lab users to see the Users tab when
Group wizard when you add a lab group viewing lab group details and lab details.
Lab Group tab after the lab group has
been created
Step 4 Private in the Add Lab Group
wizard when you add a lab group
Private tab after the lab group has been
created
Select to restrict which Teradata Database users and

roles can access the labs in the lab group.
Step 4 Private in the Add Lab Group

wizard when you add a lab group
Private tab after the lab group has been
created
Select to prevent Teradata Database users and roles

from creating or modifying tables in the lab.
Read-only users cannot send requests to remove a user,
increase or decrease lab size, delete, extend, or reinstate
a lab, drop a table, or edit lab details. Users or roles with
read-only access can send requests to add a lab, add a
user, or send an Other request.
Step 5 Default Users in the Add Lab

Select to give default Teradata Database users and roles
Group wizard when you add a lab group access to all labs in this lab group.
Default Users tab after the lab group has
been created
Approval Controls
Approval controls determine who approves requests or if requests are automatically

approved. These controls are typically set when a lab group is created, however, the controls
can be changed later. Set approval controls in Step 6 Approvers of the Add Lab Group
wizard when a lab group is created or from the Approvers tab after a lab group is created.
When a lab group is created, you have the option to set request limits on automatic
approvals for increase lab size and lab extension requests.
The approval controls are described below.
Control
Control Description
Automatic
Requests that are less than or equal to the size or duration are automatically approved.
Lab Owner
Requests that are less than or equal to the size or duration, and greater than Automatic, are
approved by either the lab owner or lab group owner.
Lab Group Owner
Requests with a size or duration greater than the Automatic or Lab Owner thresholds are
approved by the lab group owner.
The types of requests that a lab group owner can delegate to the lab owner to approve are:
Add or remove user
Add or remove owner
Delete lab
Decrease lab size
Drop table
15
The lab group owner can also delegate authority to the lab owner to approve requests to
increase lab size to a specified size and extend a lab by a specified time frame or specify no
expiration.
Adding a Lab Group

Prerequisite: The Teradata Viewpoint Administrator must assign the Manage Lab Groups
permission using Roles Manager for your Viewpoint role.
The Teradata Database user ID you use when you log in to the portlet must have the DROP
USER Teradata Database privilege to update or delete a lab group and the following
privileges to create a lab group:
CREATE USER
CREATE ROLE WITH GRANT OPTION
GRANT EXECUTE ON DBC.LogonRule
A wizard at the top of the screen guides you through the steps to create a new lab group. You
can return to completed steps by clicking the numbered step.
After a lab group is created, most settings can be changed at a later time by the Viewpoint
role with Manage Lab Groups permission.
Thresholds can be set and approvers selected for each request type. By default, all requests are
sent to the lab group owner for approval. Approvals can be delegated to lab owners or set to
automatically approve.
1 From the Monitoring tab, click
next to LAB GROUPS.
2 In Lab Group (step 1), do the following to specify lab group details and the lab group
owner email notification:
a Type a lab group name up to 18 characters.

b [Optional] Type a lab group description up to 500 characters.
c Type or select a parent database from the list.
d Type the amount of space to allocate to the lab group.
If the space is too low, lab users will be unable to request to add more labs in the lab
group.
e [Optional] Select the Enable display of users and roles for the lab group and labs
check box to enable lab users to see the Users tab when viewing lab group details and
lab details.
16
Type a percentage from 1% to 100%.

When the allocated space is within the specified percentage of the lab group size, the
lab group owner receives an email notification, depending on the email notification
settings.
g Click Next.
3 In Labs (step 2), specify the default lab settings, request limits, and lab owner email
notifications, and click Next.

The default lab settings appear when labs are created, but users can submit a request to
overwrite the settings for their specific labs. Default lab settings can be changed by the
Viewpoint role with Manage Lab Groups permission after the lab group is created
except where noted.
a Type a size for the default lab.
If the size is too low, users will be unable to load more data into the lab, requiring the
lab user to send frequent requests to increase the lab size.
b [Optional] Select the Expire lab after check box and either select the number of days
from the menu or type a number from 1 to 9999 and press Enter.
If the check box is not selected, no lab expiration is set.
c [Optional] For lab groups that have an expiration duration for its labs, select the
Remove the "No expiration" option from requests check box to inform lab users
that the labs must expire. The No expiration option will not appear for users
requesting a lab to be added or extended.
d [Optional] Select the Delete expired after check box and either select the number of
days from the menu or type the number of days from 1 to 9999 and press Enter if you
want an expired lab to delete automatically when the set value is reached.
e [Optional] Select the Grant lab users CREATE TABLE privilege check box to allow
lab users to create Teradata Database tables in the underlying Lab database using the
CREATE TABLE statement.
This setting cannot be changed after the lab group is created.
[Optional] Type a lab prefix up to six characters.

The lab prefix precedes all lab names in the lab group to help manage workloads. The
lab prefix cannot be changed after the lab group is created.
g [Optional] Type lab instructions up to 500 characters.
Lab instructions provide guidance and best practices to help lab users.
h [Optional] Under Request Limits, specify a maximum size in MB, GB, or TB from 1
to 9999 for all labs in a lab group.
Requests to increase a lab size that exceed the specified maximum lab size will be sent
to the lab group owner for approval. For more information, see Request Limits.
i
[Optional] Under Request Limits, select the check box, and then select the number
of days from the menu or type the number of days from 1 to 9999 and press Enter to
limit the maximum cumulative life for all labs in the lab group.
17
Requests to extend a lab that exceed the specified number of days will be sent to the
lab group owner for approval. For more information, see Request Limits.
j
Under Lab Owner Email Notifications, select the number of days before a lab expires
in which to trigger an email notification.
An email notification is sent to the lab owner when the number of days is reached,
depending on the email notification settings.
k Under Lab Owner Email Notifications, type a percentage from 1% to 99%.
An email notification is sent to the lab owner when the available space for the lab falls
below the percentage you set, depending on the email notification settings.
4 In Owners (step 3), select which Viewpoint users and roles own the lab group:
a Select a user from the Available users box and click
the Selected users box.
to move that user (owner) to
If there are more than 500 users, use the User list filter.
b Select a role from the Available roles box and click
Selected roles box.
to move that role to the
c [Optional] In the User list filter box, type to filter the list of available users.
d Click Next.
5 In Private (step 4), do one of the following to restrict access to the lab group:
Option
Description
Not
private
Click Next if you do not want to place any restrictions on which Teradata Database
users and roles can access labs in this lab group.
Private
a.
Select the Restrict access to selected users and roles check box to restrict which
Teradata Database users and roles can access the lab group.
b. Select a user from the Available users box, and click

Selected users box.
to move that user to the
c.
Select a role from the Available roles box, and click to move that role to the
Selected roles box.
d. [Optional] Select the Read-only check box if you want to give read-only access
to labs in this lab group.
e.
Read-only users cannot send requests to remove a user, increase or decrease lab
size, delete, extend, or reinstate a lab, drop a table, or edit lab details.
Click Next.
6 In Default Users (step 5), do one of the following to provide access to all labs in this lab
group:
18

Option
Description
Do not
Click Next if you do not want to create any default users. A default user is a
give access Teradata Database user or role that has either full control or is read-only for all labs
in a lab group.
Give
access
a.
Select the Give access to selected users and roles check box to give lab access
to selected Teradata Database users and roles in the lab group.
Note: When you give access to default users and roles, they will have either full
control or are read-only for all labs in the lab group.
b. Select a user from the Available users box, and click

the Selected users box.
to move that user to
c.
Select a role from the Available roles box, and click to move that role to the
Selected roles box.
d. [Optional] Select the Read-only check box if you do not want the user or role
to create, modify, or drop Teradata Database tables in the labs in the lab group.
e. Click Next.
7 In Approvers (step 6), do one of the following to set approvers for each request type:
For more information, see approval controls.

Option
Description
Default lab
group owner
approval
Click Create if you do not want to set thresholds and want the lab group
owner to approve all request types by default.
Automatic
approval
a.
Lab owner
a.
Lab group
owner
In the top section, specify thresholds under Automatic approval so that

requests that are less than or equal to the setting are approved
automatically for increasing lab size, extending a lab, and adding a lab.
b. In the bottom section, select Automatic approval for each request if no
approval is required.
c. Click Create.
In the top section, specify thresholds under Lab owner so that requests
that are less than or equal to the settings for increasing lab size and
extending a lab, and greater than Automatic approval, are approved by
the lab owner or lab group owner.
b. In the bottom section, select Lab owner for each request if approval is
required from the lab owner or the lab group owner.
c. Click Create.
In the top section, requests for increasing lab size and extending a lab greater
than the Automatic approval or Lab owner thresholds are approved
automatically by the lab group owner.
a.
In the bottom section, select Lab group owner for each request if approval
is required from the lab group owner.
19

Option
Description
b. Click Create.
A confirmation message appears.

8 Click Done.
Request Limits
The lab group owner has the option to set the following request limits on automatic approvals
for requests to increase lab size and for lab extensions:
Maximum size
If a lab has exceeded its size threshold, automatic approvals no longer apply and the
lab group owner must approve requests to increase the lab size by the setting
specified (1 to 9999 MB, GB, or TB).
Limit the maximum cumulative life
If a lab has exceeded its life threshold by repeated extensions, automatic approvals no
longer apply and the lab group owner must approve requests to extend or reinstate a
lab by the number of days specified (1 to 9999).
Changing Allocated Space

After a lab group is created, you can change the allocated space for the lab group.
1 From the Lab Groups table in the Monitoring tab, click
select Edit.
next to the lab group, and
2 From the Lab Group tab, enter a new amount of allocated space in the New size box.
The amount in the New size box must be less than or equal to the sum of the available
space of the parent database (displayed in the Available space box) and the current
allocated lab group space (displayed in the Size box).
3 Click Save.
The updated allocated space appears in the Allocated column in the Lab Groups table.
Changing the Lab Group Description

After a lab group is created, you can change the lab group description.
select Edit.
20

2 From the Lab Group tab, change the description.
3 Click Save.
The updated description appears in the Description column in the Lab Groups table.
Changing Access for Viewing Users and Roles

After a lab group is created, you can change who can see the users and roles assigned to a lab
group or data lab.
select Edit.
2 From the Lab Group tab, do one of the following for the Enable display of users and
roles for the lab group and labs check box:

Select to show the Users tab in the View Lab Group Details and the View Lab
Details dialog boxes.
Clear to hide the Users tab in the View Lab Group Details and the View Lab Details
dialog boxes.
The General and Owners tabs in the View Lab Group Details and the View Lab Details
dialog boxes cannot be hidden.
3 Click Save.
Changing Default Lab Group Owner Email Notifications

After a lab group is created, you can change their default email notifications. The My
Notifications view allows you to enable or disable email notifications.
The Teradata Viewpoint Administrator must complete the email configuration before email
notifications can be triggered.
select Edit.
2 From the Lab Group tab, under Email Notification, enter a percentage from 1% to 99%
for Send email if available space is less than.
3 Click Save.
An email notification is triggered to the lab group owner if available space for the lab
group falls below the percentage.
Changing Lab Group Default Users

21
After a lab group is created, you can change the lab group default users. When the lab group
owner gives access to default Teradata Database users and roles, they can have either full
control or are read-only for all labs in the lab group.
select Edit.
2 Click the Default Users tab.

3 Select the Give access to selected users and roles check box.
4 Change the Teradata Database users and roles that can access all labs in a lab group:
Option
Description
Change
current lab
group
default users
Use to move the selected users and roles from the Selected boxes to the
Available boxes.
Use to move the selected users and roles from the Available boxes to the
Selected boxes.
[Optional] Select the Read-only check box if you want to give read-only
access to labs in this lab group.
Read-only users cannot send requests to remove a user, increase or decrease
lab size, delete, extend, or reinstate a lab, drop a table, or edit lab details.
Add more
lab group
default users
Use to move one or more selected users and roles in the Available boxes to
the Selected boxes.
[Optional] Select the Read-only check box if you want to give read-only
access to labs in this lab group.
Read-only users cannot send requests to remove a user, increase or decrease
lab size, delete, extend, or reinstate a lab, drop a table, or edit lab details.
5 [Optional] In the User list filter box, type to filter the list of available users.
6 Click Save.
Changing Lab Group Owners

After a lab group is created, you can change the current lab group owner or add more lab
group owners.
select Edit.
2 Click the Owners tab.

3 Change the lab group owners:
22

Option
Description
Change current
lab group owner
Use to move the selected lab group owner and role from the Selected
boxes to the Available boxes.
Use to move the selected owner (user) and role from the Available
boxes to the Selected boxes.
Use to move one or more selected users and roles from the Available
boxes to the Selected boxes.
Add more lab

group owners
4 [Optional] In the User list filter box, type to filter the list of available users.
5 Click Save.
Changing Lab Group Privacy

After a lab group is created, you can change the lab group privacy.
Make a lab group private for security or other reasons so the labs in the lab group are only
available to a restricted set of Teradata Database users and roles.
select Edit.
2 Click the Private tab.

3 Do one of the following to set privacy limitations:
Select the Restrict access to selected users and roles check box to restrict which
Teradata Database users and roles can access the lab group.
Clear the Restrict access to selected users and roles check box to allow all Teradata
Database users and roles access to the lab group.
4 If you selected the check box, do the following to designate those who have access:
Use to move one or more selected Teradata Database users and roles from the
Available boxes to the Selected boxes.
[Optional] Select the Read-only check box if you want to give read-only access to
labs in this lab group.
Read-only users cannot send requests to remove a user, increase or decrease lab size,
delete, extend, or reinstate a lab, drop a table, or edit lab details.
[Optional] In the User list filter box, type to filter the list of available users.
5 Click Save.
23
Changing Lab Group Thresholds and Approvers

After a lab group is created, you can change the lab group thresholds and approval controls.
Set the thresholds and select approvers for each request type. If no settings are specified, all
approval and threshold requests for a lab are sent to the lab group owner by default.
select Edit.
2 Click the Approvers tab.

3 Do any of the following to set thresholds:
Option
Description
Automatic
approval
Specify a threshold under Automatic approval so that lab requests that are
less than or equal to the size or duration of the setting are approved
automatically.
Lab owner
Specify a threshold under Lab owner so that lab requests that are less than
or equal to the size or duration, and greater than Automatic approval, are
approved by the lab owner.
Lab group owner Requests with a size or duration greater than the Automatic approval or
Lab owner threshold are approved by the lab group owner.
4 Do any of the following to select approvers for each request type:
By default, all requests are sent to the lab group owner for approval. Approvals can be
delegated to lab owners or set to automatically approve.
Option
Description
Automatic approval Select Automatic approval when approval is not required.

Lab owner
Select Lab owner when the request requires approval from the lab owner
or lab group owner.
Lab group owner
Select Lab group owner when the request requires approval from the lab
group owner.
5 Click Save.
Deleting a Lab Group

Prerequisite:
The Teradata Viewpoint Administrator must assign the Manage Lab Groups permission
using Roles Manager for your Viewpoint role.
The Teradata Database user ID you use when you log in to the portlet must have the
DROP USER Teradata Database privilege.
select Delete Lab Group.
A confirmation message appears.

24

2 Click Delete.
The lab group no longer appears in the Lab Groups table.
Working with Labs

using Roles Manager for your Viewpoint role to change the default settings. This role can
change the default settings for the lab size, lab expiration, lab instructions, lab request limits,
lab owner email notifications, or deleting expired labs.
You can submit a new request to add a lab using the Requests tab if at least one lab group
exists. You will receive an email notification that either approves or denies your request.
You can submit a request to be added to a lab if at least one lab exists. The Add User button
appears after you add the Data Labs portlet from the Add Content view and log in, allowing
you to submit a request. You will receive an email notification after your request has been
approved, depending on your email notification settings.
Changing the Default Lab Size

select Edit.
2 Click the Labs tab.

3 Under Default Lab Settings, change the Size for the default lab.
4 Click Save.
The updated size appears in the Size column in the Labs table.
Changing the Default Lab Expiration

select Edit.

3 Under Default Lab Settings, select the Expire lab after check box and either select the
number of days from the menu or type a number from 1 to 9999 and press Enter.
The updated expiration date appears in the Expires column in the Labs table.
4 [Optional] If you decide to expire the lab, you can select the Remove the "No
expiration" option from requests check box.
25
The No expiration option no longer appears for users to select when requesting a lab to
be added or extended.
5 Click Save.
Changing Default Lab Instructions

select Edit.

3 Under Default Lab Settings, add or update lab instructions in the Lab Instructions box.
4 Click Save.
The updated lab instructions appear when the approver views the Request Details pane
in the Approvals tab.
Changing Default Lab Request Limits

You can specify a maximum lab size for all labs in a lab group. If a request for an increase in
lab size exceeds the specified maximum size, it must be approved by the lab group owner or
lab owner.
You can limit the maximum cumulative life for all labs in a lab group. If a request to extend a
lab exceeds the specified number of days, it must be approved by the lab group owner or lab
owner.
select Edit.

3 [Optional] Under Request Limits, specify a maximum size in MB, GB, or TB from 1 to
9999 for all labs in a lab group.
Requests to increase a lab size that exceed the specified maximum lab size will be sent to
the lab group owner or lab owner for approval.
4 [Optional] Under Request Limits, do the following:
a Select the check box.
b Select the number of days from the menu or type a number from 1 to 9999 and press
Enter to limit the maximum cumulative life for all labs in a lab group.
Requests to extend a lab that exceed the specified number of days will be sent to the lab
group owner or lab owner for approval.
26

5 Click Save.
Changing Default Lab Owner Email Notifications

Prerequisite:
using Roles Manager for your Viewpoint role.
The Teradata Viewpoint Administrator must complete the email configuration before
email notifications can be triggered.
select Edit.

3 [Optional] Under Lab Owner Email Notifications, select the number of days before a
lab expires in which to trigger an email notification.
An email notification is sent to the lab owner when the number of days is reached.
4 [Optional] Under Lab Owner Email Notifications, enter a percentage from 1% to 99%.
An email notification is sent to the lab owner when the available space for the lab falls
below the percentage you set.
5 Click Save.
Deleting Expired Labs

You can change when expired labs are automatically deleted from a lab group.
select Edit.

3 Under Default Lab Settings, select the Delete expired after check box and either select
the number of days from the menu or type a number from 1 to 9999 and press Enter.
4 Click Save.
The expired lab is automatically deleted when the set value is reached.
Data Labs Settings View

The Settings view allows you to set thresholds that turn information red in the portlet view.
Set thresholds that turn information red in the tables if any of the following statements are
true:
27
a lab group or data lab is running out of space

approvals have not been responded to
a lab is expiring
table skew has been exceeded
Managing Default Settings

In the Settings view, you can set or clear user-defined default settings for the portlet.
1 Click
in the portlet frame and select Settings.
2 Set or clear the user-defined default settings for the portlet:

Option
Description
Save as Default Click to use the current user-defined settings as the default configuration each
time you add this portlet to a portal page.
Clear Defaults Click to clear all user-defined default settings created for this portlet.
3 Click Close.
4 Click OK.
Setting Display Thresholds

You can set thresholds to highlight important information in the portlet. These settings are
specific to your portlet instance so your settings will not affect other Data Lab portlet users.
1 Click
in the portlet frame and select Settings.
2 Under Lab Group Size, enter the allocated space for the lab group from 1% to 100%.
This setting helps you determine if the lab group is running out of allocated space. If
space runs out, users will be unable to request to add more labs in the lab group.
When the allocated space is within the specified percentage of the lab group size, the
value appears red in the Lab Groups table in both the Allocated and % Allocated
columns.
3 Under Lab Size, enter the lab size from 1% to 100%.
This setting helps you determine if the lab is running out of space. If space runs out, users
will be unable to load more data into the lab.
When the used space is within the specified percentage of the total lab size, the value
appears red in the Labs table in both the Used and % Used columns.
4 Under Approvals, enter the number of days for approvals from 1 to 999 days.
When a response to an approval has not been received by the specified number of days,
the date in the Date column appears red for only approvers in the Approvals table in the
Approvals tab.
5 Under Expiration, enter the number of days before you want the lab to expire from 1 to
999 days.
28
When the lab expires by the specified number of days, the date appears red in the Labs
table in the Expires column.
6 Under Skew, enter the table skew from 1% to 100%.
When the table skew is exceeded by the specified percentage, the skew appears red in the
Tables table in the Skew column.
7 Do one of the following to enable or disable each threshold setting:
Select the check box to enable the threshold setting.

Clear the check box to disable the threshold setting.
8 Click OK.
29
30
CHAPTER 3
Monitoring Lab Groups, Labs, and Tables
Monitoring
You can navigate the following tables for monitoring lab groups, labs in a lab group, and
tables in a lab. For a description of the columns in the tables, see Metrics for Monitoring,
Approvals, and Requests Tabs.
Tables
Description
Lab groups
Monitor all the lab groups on the Teradata

Database systems that contain labs that you
either own or have access to.
The bar chart in the Space column shows

the total space allocated to the lab group in
gray, the space allocated to labs in the lab
group in dark green, and the space in use
within all labs in the lab group in light
green.
The content appears red in the Allocated
and % Allocated columns when the
allocated space is within the threshold set
for Lab Group Size in the Settings view.
Lab Group
Space
Size
Allocated
% Allocated
Used
% Used
Owners (lab group)
Location
Private
Created
Parent DB
Description
From the Monitoring tab, the

Lab Groups table appears in the
top pane.
Labs
Monitor all the labs that you either own or

have access to.
The bar chart in the Space column shows
the total space allocated to the lab in gray

and the amount of space in use within the
lab in dark gray.
The content appears red in the Used and %
Used columns when the used lab space is

within the threshold set for Lab Size in the
Settings view.
Lab
Space
Size
Used
% Used
Expires
Owners (lab)
Location
Description
From the Monitoring tab, when

you click a lab group row, the
Labs table appears in the middle
pane.
Tables
Monitor all the tables in a lab.
Table (name)
Size
Skew
Created (date)
Created by
Location
From the Monitoring tab, when

you click a lab group row, and
then click a lab row, the Tables
table appears in the bottom pane.
Columns Available
Navigation
31
Chapter 3 Monitoring Lab Groups, Labs, and Tables

Tables
Description
Columns Available
Navigation
Schema Changed
Description
Viewing Lab Group Details

select View Lab Group Details.
2 Select one of the following tabs:
General tab to view the total space allocated to the lab group (Size), space allocated to
labs in this lab group (Allocated), space in use within all labs in this lab group (Used),
lab group description, and lab group owner email notifications.
Owners tab to view the Viewpoint users and roles who own this lab group.
Users tab to view the Teradata Database users and roles who have been given access to
this lab, including read-only users or roles. This tab is visible only if given permission
by the lab group owner.
3 Click OK.
32
Viewing Lab Details

1 From the Labs table in the Monitoring tab, click
Details.
next to the lab, and select View Lab
2 Select one of the following tabs:
General tab to view the total space allocated to the lab (Size), amount of space in use
within the lab (Used), lab expiration date, lab description, lab instructions, and lab
owner email notifications.
Owners tab to view the Viewpoint users and roles who own this lab.
Users tab to view all Teradata Database users and roles who have been given access to
this lab, including default and read-only users and roles. This tab is visible only if
given permission by the lab group owner.
Note: The Users tab displays if the lab group owner selects the Enable display of
users and roles for the lab group and labs check box. For more information, see
Changing Access for Viewing Users and Roles.
3 Click OK.
Viewing Sample Rows

Viewing a sample of random rows returned by the Teradata Database helps you decide if a
specific table in a lab is ready to go into production or if the table should be dropped from
the lab if it is no longer needed.
Sample rows are visible only to lab users.
1 From the Tables table in the Monitoring tab, click
Sample Rows.
next to the table, and select View
2 Review the sample of ten random rows and all columns in the Teradata Database table.
3 Click OK.
Exporting Data
You can export data to a .csv file for further analysis and formatting. The exported .csv file
contains all available data up to one million rows.
If filters are used, only filtered data is exported for most portlets. If a portlet displays more
than one million rows of data, then use the filters to display the data you want before
exporting it.
The format for the time, date, and some numeric values differs in the view and exported .csv
file.
1 Click
in the table header and select Export.
2 Save the file using the browser options.
33
The file is saved to your download area or to a location that you specify, depending on the
browser settings.
Metrics for Monitoring, Approvals, and Requests

Tabs
The metrics that appear in the Monitoring, Approvals, and Requests tabs are listed below.
A 1024 byte kilobyte is used as the base for all memory-related and space-related metrics that
display, such as spool space, disk space, memory usage, and so forth. A 1000 byte kilobyte is
used as the base for all other metrics.
Metric
Description
Tab
Table
% Allocated
Percentage of lab group space allocated to labs
Monitoring
Lab Groups
Percentage of total space in use within all labs in the lab Monitoring
group
Lab Groups
Percentage of allocated space in use within the lab
Monitoring
Labs
Monitoring
Lab Groups
The value appears red when the allocated space is

within the specified percentage of the lab group size if
you set a threshold for Lab Group Size in the Settings
view
% Used
The value appears red in the Labs table when the used
lab space is within the threshold set for Lab Size in the
Settings view
Allocated
Space allocated to labs in the lab group

The value appears red when the allocated space is
within the specified percentage of the lab group size if
you set a threshold for Lab Group Size in the Settings
view
Approver
Who approved the request, displayed as the Viewpoint

user ID
Requests
Requests
Available
Amount of unallocated space for the selected lab group
Approvals
Approvals
Comments
Comment from the requester at the time the request

was submitted
Approvals
Approvals
Created
Date the lab group was created
Monitoring
Lab Groups
Date the Teradata Database table was created
Monitoring
Tables
Created by
Creator of the Teradata Database table, displayed as the Monitoring

Teradata Database user ID
Tables
Date
Date the request was made
Approvals
34
Approvals

Metric
Description
Tab
Table
Requests
Requests
Description of the lab group
Monitoring
Lab Groups
Description of the lab
Monitoring
Labs
Description of the table
Monitoring
Tables
Date the lab expires
Approvals
Approvals
Date the lab expires
Monitoring
Labs
Name of the lab
Approvals
Approvals
Name of the lab
Monitoring
Labs
Name of the lab
Requests
Requests
Name of the lab group
Approvals
Approvals
Monitoring
Lab Groups
Requests
Requests
Fully qualified location of the table in the Teradata

Database for only drop table requests
Approvals
Approvals
Name of the lab group user in the Teradata Database
Monitoring
Lab Groups
Name of the lab database in the Teradata Database
Monitoring
Labs
Fully qualified name of the table in the Teradata

Database
Monitoring
Tables
New Expiration
Updated expiration date after an Extend Lab request

has been approved
Approvals
Approvals
Owners
Lab group owners, displayed as the Teradata Viewpoint

user ID and/or role
Monitoring
Lab Groups
Lab owners, displayed as the Teradata Viewpoint user

ID and/or role
Monitoring
Labs
Parent DB
Name of the parent Teradata Database in which the lab

group resides
Monitoring
Lab Groups
Private
A check mark indicates the lab group owner has

restricted which Teradata Database users and roles can
access the lab group
Monitoring
Lab Groups
The date appears red when a response to an approval

has not been received by the specified number of days if
you set a threshold for Approvals in the Settings view
Description
Expires
The date in the Expires column appears red in the Labs

table the specified number of days before the lab expires
if you set a threshold for Expiration in the Settings
view
Lab
Lab Group
Location
35

Metric
Description
Tab
Table
No check mark indicates users and roles are not

restricted from accessing the lab group
Requested
Amount of space by which the lab size will be increased Approvals

or decreased
Approvals
Requester
Username of the requester, displayed as the Viewpoint

user ID
Requests
Schema Changed
Date of the most recent table schema change and which Monitoring
Teradata Database user made the change
Tables
Size
Total space allocated to the lab group
Monitoring
Lab Groups
Total space allocated to the lab
Monitoring
Labs
Total size of the table
Monitoring
Tables
If a threshold is set, percentage of table skew that is

under the set threshold appears black
Monitoring
Tables
Skew
Requests
The percentage of the table skew that exceeds the set

threshold appears red in the Tables table in the Skew
column if you set a threshold for Skew in the Settings
view
Space
Bar chart showing the total space allocated to the lab

Monitoring
group in gray, the space allocated to labs in the lab
group in dark green, and the space in use within all labs
in the lab group in light green
Lab Groups
Bar chart showing the total space allocated to the lab in

gray and the amount of space in use within the lab in
dark gray
Monitoring
Labs
Status of the request as one of the following:

Approved
Successful
Pending
Denied
Failed
Requests
Requests
Name of the Teradata Database table
Monitoring
Tables
Name of the Teradata Database table
Approvals
Approvals
TD User
User name of the requester, displayed as the Teradata

Database user ID
Approvals
Approvals
Type
Request type
Approvals
Approvals
Request type
Requests
Requests
Space in use within all labs in the lab group
Monitoring
Lab Groups
Amount of space in use within the lab
Monitoring
Labs
Status
Failed requests appear red

Table
Used
36

Metric
Description
Tab
Table
Approvals
Approvals
The value appears red in the Labs table when the used
lab space is within the threshold set for Lab Size in the
Settings view
VP User
Viewpoint user ID of the requester
37
38
CHAPTER 4
Managing Requests and Approvals
Requests
Requests can be submitted for the following:
Add, delete, or reinstate a lab
Increase or decrease lab size
Add or remove users from labs
Add or remove owners from labs
Extend lab expiration dates
Drop tables
Edit lab details
Send other requests
Lab group owners can view or approve all requests for labs within their lab group. Lab
owners can view or approve requests for labs that they own. Lab users can view their own
requests, as well as requests submitted by other users in their lab. If you have permission to
approve a request you submit, no approval is necessary. If you are a lab owner, your requests
will be automatically approved if you have been granted approval authority.
Requests stay in the Requests tab until you delete them. You can delete any type of request
as long as it is your own request. You can see deleted requests from the request log.
From the Requests tab, you can use the Lab group and Lab menus or the state filter bar to
narrow your search for requests.
Lab users can only submit requests to add a lab or user, remove themselves as a user, increase
or decrease lab size, extend a lab, drop a table, edit lab details, or submit an Other request.
Teradata Database roles that have read-only access to a lab can only submit requests to add a
lab or a user, remove themselves as a user, or submit an Other request.
39
Chapter 4 Managing Requests and Approvals
Requesting a Lab
Anyone can submit a request to add a lab. Any lab size or expiration date can be requested.
1 Do one of the following to submit a request to add a data lab:
Option
Description
From the
Monitoring tab
In the Lab Groups table, click the name of the lab group to which you
want to add a lab.
b. In the Labs table, click next to LABS.
a.
The lab group is selected for you.

From the
Requests tab
a. Click next to REQUESTS.

b. Select Add Lab from the Request type list.
c. Select a lab group.
All lab groups appear including private lab groups where you are a user.
For new lab users if at least one lab group exists:
a.
40
Immediately after connecting to a system in the Data Labs portlet, click

Add Lab.

Option
Description
b. Select a lab group.
A lab prefix displays as read-only if a prefix was added when the lab group was created.
2 Enter a lab name up to 24 characters.
3 Enter a size up to 999 MB, GB, or TB, depending on the available allocated space for the
lab group, which is set by the lab group owner.
4 Do one of the following to select an expiration time frame for the lab:
Option
Description
Set an expiration time frame

on the lab
Select the Expire lab after check box and either select the
number of days from the menu or type a number from 1 to
9999 and press Enter.
Set no expiration on the lab
Clear the Expire lab after check box.
The expiration displayed is set by the lab group owner, but you can select any expiration
time frame.
5 [Optional] Enter a description for the lab up to 500 characters.
6 [Optional] Enter the lab instructions up to 500 characters.
Lab instructions provide guidance and best practices to help lab users. For example,
provide information for loading data into tables using Teradata Data Mover or load
utilities such as FastLoad or MultiLoad. The instructions can contain text and URLs and
can be updated at any time.
Default lab instructions may have been created by the lab group owner, but you can
overwrite the instructions for your specific lab.
7 [Optional] Select the number of days (7, 14, or 30) prior to this lab expiring that an
email notification is sent to all owners of this lab.
8 Enter a percentage (1% to 99%) of available space left at which an email notification is
sent to all owners of this lab.
9 Click Submit.
You will receive an email notification after your request has been approved, depending
on your email notification settings.
After your request has been approved, you can see the lab was added by looking for the lab
name in the Labs table in the Monitoring tab. If you do not see the lab, determine the status
of your request from the Status column in the Requests tab.
Request Status
The Status column in the Requests tab displays the following:
41
Approved
The request was approved by the approver. Approved is an intermediate status that
typically occurs quickly before a request goes to a Successful or Failed status.
Successful
A request was approved and processed without failing.
Pending
The request has been sent and is waiting to be approved or denied.
Denied
The request was denied by the lab group owner or lab owner.
Failed
The request was approved, but the execution failed, such as when the system is out of
space.
Viewing Request Status

You can view the status of any request.
1 Click the Requests tab.
2 Click any of the following states in the state filter bar to display all requests or requests
with a specific status:

All
Pending
Approved
Denied
Successful
Failed
3 [Optional] Sort by Lab Group or Lab to display the requests for that lab group or lab.
4 [Optional] Click a request to view the details of the request.
The Request Details pane appears at the bottom.

5 [Optional] For Denied and Failed requests, click
next to the status to review the

reason for the denial or failure.
If a reason for the denial was not provided by the lab group owner or lab owners who
have been granted approval authority to deny a request, the icon does not appear next
to the status.
6 [Optional] View a log of submitted requests.
Viewing the Request Log

You can view a log of submitted requests and export the data in the request log depending on
what type of user you are.
42
Lab group owners can view a log and export the data for labs within their lab group.
Lab owners can view a log and export the data for labs that they own.
Lab users can view a log and export the data for their requests and requests by other
users in their lab.
A single identification number is assigned to one request, and the Action columns displays
which steps processed in the request. By sorting on the ID number and then reviewing the
information in the Action, Date, and Status columns, you can determine the date and time
the request, approval, and execution steps were processed and the status of each step.
1 Click the Requests tab.
2 [Optional] Click View Request Log to display a list of requests for all labs on your
Teradata Database to which you have access.

For a description of all the columns in the request log, see Metrics for Request Log.
3 [Optional] To export the data in the request log, do the following:

a Click the Table Actions menu, and select Export.
b Save the file using the browser options.
The file is saved to your download area or to a location that you specify, depending
on the browser settings.
Metrics for Request Log
The metrics that appear in the request log are listed below.
Column
Description
Type
ID
Identification number assigned to a request when it is submitted

and is used to track the status of the request
Number
Action
Action (step) the request has completed as one of the following:

Approval
Execution
String
43

Column
Description
Type
Other
Request
System
System name on which the request was created
String
Type
Type of request
String
Date
Number
Lab Group
Name of the lab group on which the request was made
String
Lab
Name of the lab on which the request was made
String
Status
Status for each action (step) of the request after it is submitted
String
Approver
Who approved the request, displayed as the Viewpoint user ID
String
Requester
Username of the requester, displayed as the Viewpoint user ID
String
Error
Error messages generated by the Teradata Database or the JDBC

driver while performing actions associated with a request
String
Additional Info
Messages generated when a request is made to modify the lab size, String
expiration date, users, or owners
Requesting a Lab Size Increase

Lab users can submit a request to increase lab size.
Teradata Database users or roles that have read-only access to a lab cannot send requests to
increase lab size.
1 Do one of the following to submit a request to increase lab size:
Option
Description
From the
Monitoring tab
a.
From the
Requests tab
Click
next to the lab, and select Increase Lab Size.
The lab group and lab are selected for you. To change the lab group or
lab, use the Requests tab to submit your request.
b. Select Increase Lab Size from the Request type list.
d. Select the lab where you want to add space.
The labs that appear include those where you are a user or an owner.
2 Enter how much space you would like to increase.

3 [Optional] Enter a comment up to 500 characters.
4 Click Submit.
44
After your request has been approved, the total space allocated to the lab appears in the Size
column in the Monitoring tab.
Requesting a Lab Size Decrease

Lab users can submit a request to decrease lab size.
decrease lab size.
1 Do one of the following to submit a request to decrease lab size:
Option
Description
From the
Monitoring tab
a.
From the
Requests tab
Click
next to the lab, and select Decrease Lab Size.
b. Select Decrease Lab Size from the Request type list.
d. Select the lab where you want to decrease space.
2 Enter how much space you would like to decrease.

4 Click Submit.
After your request has been approved, the total space allocated to the lab appears in the Size
Requesting the Addition of a User

Lab users and Teradata Database users or roles that have read-only access to a lab can
submit a request to be added to a lab. If you are a lab user or read-only user, you can submit
a request for other users to be added.
1 Do one of the following to submit a request to add a user:
45

Option
Description
From the
a.
Monitoring tab
From the
Requests tab
Click
next to the lab, and select Add User.
The lab group and lab are selected for you. To change the lab group or lab,
use the Requests tab to submit your request.

b. Select Add User from the Request type list.
d. Select the lab where you want to be added to a lab.
The labs that appear include labs in private lab groups where you are a
user.
To add yourself to a lab that already exists (if at least one lab group has been
created and you are not a user in any labs)
Immediately after connecting to a system in the Data Labs portlet, click
Add User.
b. Select a lab group.
c. Select the lab where you want to be added to a lab.
a.
2 [Optional] In the User list filter box, type to filter the list of current users.
Only Teradata Database users of the lab are visible.

3 Do any of the following to add users and roles:
In the Available users box, select one or more Teradata Database users and click
move them to the Selected users box.
In the Available roles box, select one or more Teradata Database roles and click
move them to the Selected roles box.
to
to
4 [Optional] Select the Read-only check box if you want to give read-only access to labs in
this lab group.

Read-only users cannot send requests to remove a user, increase or decrease lab size,
delete, extend, or reinstate a lab, drop a table, or edit lab details.

6 Click Submit.
You will receive an email notification after your request has been approved, depending on
your email notification settings.
After your request has been approved, you can see the Teradata Database users and roles you
added from the Request Details pane in the Requests tab, displayed in groups as Full
control and Read-only.
46
Requesting the Removal of a User

A lab owner or lab group owner can submit a request to remove any user from a lab. Lab
users and read-only users can submit a request to remove themselves from a lab, but not
other users.
1 Do one of the following to submit a request to remove a user:
Option
Description
From the
Monitoring tab
a.
From the
Requests tab
Click
next to the lab, and select Remove User.
b. Select Remove User from the Request type list.
d. Select the lab where you want to be removed from a lab.
user.
2 [Optional] In the User list filter box, type to filter the list of current users.
Only Teradata Database users of the lab are visible.

3 Do any of the following to remove users and roles:
In the Current users box, select one or more Teradata Database users and click
move them to the Users to remove box.
In the Current roles box, select one or more Teradata Database roles and click
move them to the Roles to remove box.
to
to

5 Click Submit.
After your request has been approved, you can see the Teradata Database users and roles you
removed from the Request Details pane in the Requests tab, displayed in groups as Full
control and Read-only.
Requesting the Addition of an Owner

A lab owner or a lab group owner can submit a request to add an owner to a lab. Lab users
and read-only users cannot submit this type of request.
1 Do one of the following to submit a request to add an owner:
47

Option
Description
From the
Monitoring tab
a.
From the
Requests tab
Click
next to the lab, and select Add Owner.
b. Select Add Owner from the Request type list.
d. Select the lab where you want to add an owner.
user.
2 Do any of the following to add users and roles or to filter the list of available users:
In the Available users box, select one or more Viewpoint users and click
them to the Selected users box.
to move
In the Available roles box, select one or more Viewpoint roles and click to move
them to the Selected roles box.
[Optional] In the User list filter box, type to filter the list of available users.
4 Click Submit.
After your request has been approved, the user (owner) you added appears in the Owners
column in the Labs table in the Monitoring tab.
Requesting the Removal of an Owner

A lab owner or a lab group owner can submit a request to remove an owner from a lab. Lab
users and read-only users cannot submit this type of request.
1 Do one of the following to submit a request to remove an owner:
Option
Description
From the
Monitoring tab
a.
From the
Requests tab
48
Click
next to the lab, and select Remove Owner.
b. Select Remove Owner from the Request type list.

Option
Description
Select a lab group.
d. Select the lab where you want to remove an owner.
user.
c.
2 [Optional] In the User list filter box, type to filter the list of current owners.
3 Do any of the following to remove owners and roles:
In the Current owners box, select one or more Viewpoint users and click to move
them to the Remove owners box.
In the Current roles box, select one or more Viewpoint roles and click to move
them to the Remove roles box.
Only Viewpoint users and roles that are owners of the lab are visible.

5 Click Submit.
After your request has been approved, the owner you removed no longer appears in the
Owners column in the Labs table in the Monitoring tab.
Requesting a Lab Deletion

You typically request a lab be deleted when the lab is no longer useful.
A lab owner or lab group owners can submit a request to delete a lab. Lab users and readonly users cannot submit this type of request.
1 Do one of the following to submit a request to delete a lab:
Option
Description
From the
Monitoring tab
a.
From the
Requests tab
Click
next to the lab, and select Delete Lab.
b. Select Delete Lab from the Request type list.
All lab groups appear including private lab groups where you are a
user.
d. Select the lab you want to delete.
The labs that appear include those where you are an owner.
49

3 Click Submit.
After your request has been approved, the deleted lab no longer appears in the Monitoring
tab.
Requesting a Lab Extension

Lab users can submit a request to extend the lab expiration date prior to the lab expiration
date. If a lab has expired, you cannot submit a request to extend the lab expiration date;
however, you can submit a request to reinstate the lab.
extend a lab.
1 Do one of the following to submit a request to extend the lab expiration date if the lab has
not expired:
Option
Description
From the
Monitoring tab
a.
From the
Requests tab
Click
next to the lab, and select Extend Lab.
b. Select Extend Lab from the Request type list.
d. Select the lab where you want to extend the expiration date.
2 Do one of the following:

Option
Description
Set a renewal time frame on the

lab
Select Renew lab for and either select the number of days
from the menu or type a number from 1 to 9999 and press
Enter.
Select No expiration.

4 Click Submit.
50
After your request has been approved, the new expiration date appears in the Expires
Requesting a Change in Lab Details

A lab owner or a lab group owner can submit a request to change lab details, which includes
the lab description, lab instructions, email notifications, and shortening the lab expiration
date. Lab users and read-only users cannot submit this type of request.
1 Do one of the following to submit a request to change lab details:
Option
Description
From the
Monitoring tab
a.
From the
Requests tab
Click
next to the lab, and select Edit Lab Details.
b. Select Edit Lab Details from the Request type list.
d. Select the lab where you want to add an owner.
2 [Optional] Enter a new or change the existing description for the lab, up to 500
characters.
3 [Optional] Enter new or change the existing lab instructions, up to 500 characters.
Lab instructions provide guidance and best practices to help lab users. For example,
provide information for loading data into tables using Teradata Data Mover or load
utilities such as FastLoad or MultiLoad.
Default lab instructions may have been created by the lab group owner, but you can
overwrite the instructions for your specific lab.
4 [Optional] Select the number of days (7, 14, or 30) prior to this lab expiring that an
email notification is sent to the lab owners.
5 [Optional] Enter a percentage from 1% to 99% so that, if available space becomes less
than this percent, an email notification is sent to the lab owners.
6 [Optional] Select the number of days (1, 30, 60, or 90) or type a number from 1 to 9999
and press Enter to shorten the lab expiration date.

The new lab expiration date must predate the current lab expiration date.
After your request has been approved, the new expiration date appears in the Expires
7 Click Submit.
51
After your request has been approved, the changes you made appear when you view lab
details.
Requesting a Table Description Edit

The table description can be used to indicate why the table was created and the purpose of
the table.
Lab users can request an edit to the table description. The request is automatically approved
after it is submitted.
edit the table description.
next to the table, and select Edit Table Description.
2 Add a new or edit the current description, up to 500 characters.

3 Click Submit.
The updated table description appears in the Description column in the Tables table in the
Monitoring tab.
Requesting Reinstatement of a Lab

After a lab expires, data in the Tables table in the Monitoring tab cannot be viewed; however,
all users can view lab details.
Lab group owners and lab owners can submit a request to reinstate the lab or delete the lab if
they do not want to reinstate it. Requests to reinstate a lab must be approved by the lab group
owner. If the lab group owner is the requester, it is automatically approved. After the request
is approved, the lab is available for use again. Lab data, lab owners, and users are returned to
the same state they were in when the lab expired.
1 Do one of the following to submit a request to reinstate a lab:
Option
Description
From the
Monitoring tab
a.
From the
Requests tab
52
Click
next to the lab, and select Reinstate Lab.
b. Select Reinstate Lab from the Request type list.
Only lab groups that contain expired labs appear where you are a user.
d. Select the lab that you want to reinstate.

Option
Description
Only expired labs appear include labs in private lab groups where you
are a user.
2 Do one of the following:

Option
Description
Set an expiration time frame

on the lab
Select the Expire lab after check box and either select the
number of days from the menu or type a number from 1 to
9999 and press Enter.
Clear the Expire lab after check box.
These comments give information to the approver and appear in the Request Details
pane of the Approvals tab.
4 Click Submit.
After your request has been approved, you can see the same Teradata Database users and
roles that were in place prior to the lab expiration from the Request Details pane in the
Requests tab, displayed in groups as Full control and Read-only. The reinstated lab appears
in the Labs table in the Monitoring tab.
Sending Other Requests

The following are some examples of why you may want to send an other request:
Re-create a lab in a different lab group
Move a table into production
Remove corrupt data from a lab
Lab users and Teradata Database users or roles that have read-only access to a lab can
submit other requests.
1 Do one of the following to submit other requests:
Option
Description
From the
Monitoring tab
a.
From the
Requests tab
Click
next to the lab, and select Other.
b. Select Other from the Request type list.
53

Option
Description
All lab groups appear including private lab groups where you are a
user.
d. Select the lab.
2 Type a description in the Request Details box, up to 500 characters.

3 Click Submit.
Requesting to Drop a Table

Lab users can submit a request to drop a table.
drop a table.
next to the table, and select Drop Table.
The table name and location display.

2 [Optional] Enter a comment, up to 500 characters.
You can indicate why you want the table dropped.

3 Click Submit.
After your request has been approved, the Teradata Database table is dropped automatically
and no longer appears in the Tables table in the Monitoring tab.
Deleting a Request
You can delete your own request in any state and delete a Successful request. Deleting a
pending request cancels the request. If the request has already started processing, it cannot be
canceled (deleted).
1 [Optional] View the request status before you delete a request.
2 From the Requests tab, select a request to view the details of the request before deleting
it.

3 To delete one or more requests, do the following:
54

Option
Description
Delete one request
From the Request Details pane, click Delete.
Delete more than one

request
a.
From the Requests tab, click the Table Actions menu, and select
Delete.
b. Select one or more check boxes in the table rows.
c. Click Delete.
Resubmitting a Failed Request

A failed request is a request that did not process due to an error during submission,
completion, or delivery. Failed requests appear red in the Status column in the Requests tab
for all users.
1 From the Requests tab, click the failed request in the Requests table.
The Request Details appears at the bottom and displays

2 Click
next to the status.
to review the reason for the failure.
3 If you are unable to correct the issue yourself, contact your DBA.
4 After the issue is corrected, click Resubmit.
When lab users or read-only users resubmit a failed request, it is immediately processed
and does not need to be approved again.
Approvals
When a request is made, it is added to a request queue for approval. As a lab group owner or
a lab owner, you can view these unapproved requests using the Approvals tab. If you are a
lab owner, your requests will be automatically approved if you have been granted approval
authority. After viewing the requests, they can be approved or denied.
From the Approvals tab, you can use the Lab group and Lab menus or the state filter bar to
narrow your search for approvals.
You can see the approval status of your requests from the Status column on the Requests
tab.
The Total lab group space is located in the upper right of the Approvals tab and appears
after you select a lab group from the menu. These totals allow the approver to consider all
pending space requests for the lab group in order to make informed decisions regarding
individual approvals. The requested amount is the sum of lab space in megabytes of pending
Add Lab and Increase Lab Size requests for the selected lab group. The available amount is
the sum of currently available lab space in megabytes for the selected lab group. Both of
these totals adjust as each request is approved. A message appears if the approver attempts to
approve more lab space than is available for that lab group.
55
The following is an example of a request to increase lab size. If a request exceeds the request
limits, the lab group owner sees a notification indicating the requested size exceeds the
maximum set size.
Viewing Requests for Approval

A lab group owner or lab owner can view requests that are waiting for approval.
1 Click the Approvals tab.
2 [Optional] Select All or a lab group name from the Lab group menu.
3 [Optional] Select All or a lab name from the Lab menu.
4 Do one of the following to display unapproved requests:
Click the All filter button to display all unapproved requests.

Click any button to display a filtered list of the unapproved requests by request type.
For example, click Extend to display the unapproved lab extension and reinstate lab
requests.
The following lists the request type or a combination of request types that display when
you click the various buttons:
56

Button
Request Types
Lab
Add Lab
Delete Lab
Size
Increase Lab Size

Decrease Lab Size
Extend
Extend Lab
Reinstate Lab
User
Add User
Remove User
Owner
Add Owner
Remove Owner
Details
Edit Lab Details
Drop
Drop Table
Other
Other
5 [Optional] Click a request type in the Approvals pane to see the details of the request.
Approving Requests
After viewing the requests, the lab group owner or lab owners who have been granted
approval authority can approve or deny the requests.
1 From the Approvals tab, select a request to view the details of the request before
approving it.

2 To approve one or more requests, do the following:
Option
Description
Approve one request
From the Request Details pane, click Approve.
Approve more than one a.

request
From the Approvals tab, click the Table Actions menu, and
select Approve.
b. Select one or more check boxes in the table rows.
c. Click Approve.
3 Click the Requests tab to verify that the Status column for this request displays
Approved.
Denying Requests
When a request is made by a lab user or read-only user, the lab group owner or lab owners
who have been granted approval authority can deny the request.
57
After a request is denied, users can click , located next to the status in the Request Details
on the Requests tab, to review the reason for the denial. If a reason for the denial was not
provided by the lab group owner or lab owners, the icon does not appear next to the
status.
1 Click the Approvals tab.
2 Click the request to see the Request Details pane.
3 Click Deny.
4 In the Deny Request dialog box, type a reason for the denial, up to 500 characters.
5 Click Submit.
6 Click the Requests tab to verify that the Status column displays Denied for the request.
58
CHAPTER 5
Reporting
Reports
Reports give high-level information about the data labs to see access levels at the user, role,
and lab group level.
User Report
For the DBA, generates a report of all labs a Teradata Database user has access to so
periodic audits can be performed.
This report provides the following information:
Teradata Database user for whom the report was generated
Parent lab groups and labs to which the user has been given access
Teradata Database access level of the user: Full control or Read-only
Teradata Database permission level of the user: User or Role
Role Report
For the DBA, generates a report of all labs a Teradata Database role has access to so
periodic audits can be performed.
Teradata Database role for whom the report was generated
Parent lab groups and labs to which the role has been given access
Teradata Database access level of the role: Full control or Read-only
Lab Group Report
For the DBA, generates a report of any lab group to audit who has access to the lab
group and labs within the lab group.
For a lab group owner, generates a report of all lab groups you own to audit who has
access to the lab group and labs within the lab group.
Lab group for which the report was generated
All labs in the lab group
For each lab group, Teradata Database default users and roles
Note: A default user has access to all labs in the lab group.
59
Chapter 5 Reporting
For each lab, Teradata Database users who have been given full control or readonly access to the lab
For each lab, Teradata Database roles who have been given full control or readonly access to the lab
Viewing Reports
Permission to see the Reports tab is granted to individual users based on their Teradata
Viewpoint role and portlet permissions. Typically, the Teradata Viewpoint Administrator
grants permission to the DBA.
You can export data to a .csv file for further analysis and formatting. For more information,
see Exporting Data.
1 Click the Reports tab.
2 From the Report type menu, select one of the following:
User
Role
Lab Group
3 If you want to filter the list in the Match string box, do any of the following:
Type a value.
Use the * wildcard character to match zero or more characters in the position it
occupies. Type this symbol at the beginning, middle, or end of your search. This
wildcard character can be used more than once in the same search.
Type a wildcard statement.
4 Select one or more from the Available box and click
box.
Use Ctrl or Shift to select multiples.
5 [Optional] Click
to move them to the Selected
in the Match string box to clear the filter.
6 Click View Report.
60

Data Labs - 2212 105K

Încărcat de

Informații document

Titlu original

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Data Labs - 2212 105K

Încărcat de

Drepturi de autor:

Formate disponibile

What would you do if you knew?

Teradata Data Lab

Copyright 2011 - 2015 by Teradata. All Rights Reserved.

Changing Access for Viewing Users and Roles.........................................................................................21

Teradata Data Lab User Guide, Release 15.11

Requesting the Removal of a User.............................................................................................................47

Teradata Data Lab User Guide, Release 15.11

Teradata Data Lab User Guide, Release 15.11

Use Teradata At Your Service to access Orange Books, technical

External site for product, service, resource, support, and other

Teradata Viewpoint User Guide

Describes the Teradata Viewpoint portal, portlets, and system administration

Teradata Data Lab User Guide, Release 15.11

Teradata Viewpoint Installation, Configuration, and Upgrade Guide for Customers

Describes how to install Viewpoint software, configure settings, and upgrade a

Product Safety Information

Teradata Data Lab User Guide, Release 15.11

Introduction to Teradata Data Lab

Teradata Data Lab User Guide, Release 15.11

Data Labs Workflow

Teradata Data Lab User Guide, Release 15.11

Teradata Database Privileges

Privileges or Accessibility on the Lab Database

When a lab expires

READ and WRITE commands cannot be performed.

When a lab is reinstated

READ and WRITE commands can be performed.

When a lab is deleted

A DROP command is performed.

When a Teradata Database user or

Data Lab Users

Teradata Data Lab User Guide, Release 15.11

Teradata Data Lab User Guide, Release 15.11

Managing Lab Groups and Labs

Enter an Account String

Disconnecting from a System

next to the system name, and select Disconnect.

next to the system name, and select Change System.

2 Select a system from the list.

Setting Email Notifications

in the portlet frame, and select My Notifications.

Teradata Data Lab User Guide, Release 15.11

Chapter 2 Managing Lab Groups and Labs

Working with Lab Groups

Access and Approval Controls for Lab Groups

Teradata Data Lab User Guide, Release 15.11

Chapter 2 Managing Lab Groups and Labs

Read-only check box

Step 1 Lab Group in the Add Lab

Select to restrict which Teradata Database users and

Step 4 Private in the Add Lab Group

Select to prevent Teradata Database users and roles

Step 5 Default Users in the Add Lab

Approval controls determine who approves requests or if requests are automatically

Lab Group Owner

Teradata Data Lab User Guide, Release 15.11

Chapter 2 Managing Lab Groups and Labs

Adding a Lab Group

next to LAB GROUPS.

owner email notification:

a Type a lab group name up to 18 characters.

Type a percentage from 1% to 100%.

Chapter 2 Managing Lab Groups and Labs