Professional Documents
Culture Documents
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 Hadoop, Hadoop, and the yellow elephant logo are either registered trademarks or trademarks of the Apache Software
Foundation in the United States and/or other countries.
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
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
Chapter 3:
Monitoring Lab Groups, Labs, and Tables...................................................................31
About 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................................................................................... 37
About Requests.................................................................................................................................................... 37
Requesting a Lab...........................................................................................................................................38
Request Status............................................................................................................................................... 39
Viewing Request Status................................................................................................................................ 40
Viewing the Request Log............................................................................................................................. 40
Metrics for Request Log........................................................................................................................41
Requesting a Lab Size Increase................................................................................................................... 42
Requesting a Lab Size Decrease..................................................................................................................43
Requesting the Addition of a User............................................................................................................. 43
Audience
This guide is intended for use by:
• Database administrators
• System administrators
• Application developers and users
Revision History
Date Release Description
March 15.10 Added content to support:
2015 • Merging of the existing portlets into a single Data Labs portlet
• New Lab Group Setup Wizard
• Custom date ranges for data lab expiration and deletion
• Maximum data lab size and extension
• User and role display for a lab group and at the data lab levels
• Request log export
Additional Information
Related Links
URL Description
http://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.
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 designs, develops and delivers education that builds adept
skills and capabilities for our data warehousing technology customers, enabling them to
maximize their Teradata investment. Teradata offers a variety of delivery formats to suit your
needs. The combination of web technology through the Teradata Education Network, along
with hands-on classroom training, provides each user level with a wide range of
opportunities to gain knowledge about our data warehousing tools.
Our flexible education options build upon and complement one another to give you a cost
effective, robust education offering. On this website, you can view and enroll in any Teradata
Customer Education training offering.
As the premier on-line learning environment for Teradata users, Teradata Education
Network (TEN) is a membership-based learning community that allows you to harness the
power of the internet and expand your knowledge of Teradata data warehousing tools at your
own pace ... anytime, anywhere.
If you do not have a membership that includes web-based training courses, you can purchase
courses at www.teradata.com/TEN/ or Teradata University.
Notice: Improper use of the Reconfiguration utility can result in data loss.
Overview
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.
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.
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
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.
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
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.
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.
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.
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.
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
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.
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.
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.
f [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.
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 to move that user (owner) to
the Selected users box.
If there are more than 500 users, use the User list filter.
b Select a role from the Available roles box and click to move that role to the
Selected roles box.
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 Click Next if you do not want to place any restrictions on which Teradata Database
private 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 to move that user to the
Selected users box.
If there are more than 500 users, use the User list filter.
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.
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.
e. Click Next.
6 In Default Users (step 5), do one of the following to provide access to all labs in this lab
group:
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 or read-only access to all labs in
a lab group.
Give a. Select the Give access to selected users and roles check box to give lab access
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
or read-only access to all labs in the lab group.
b. Select a user from the Available users box, and click to move that user to
the Selected users box.
If there are more than 500 users, use the User list filter.
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 Click Create if you do not want to set thresholds and want the lab group
group owner owner to approve all request types by default.
approval
Automatic a. In the top section, specify thresholds under Automatic approval so that
approval 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.
Lab owner a. 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.
Lab group In the top section, requests for increasing lab size and extending a lab greater
owner 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.
Option Description
b. Click Create.
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).
1 From the Lab Groups table in the Monitoring tab, click next to the lab group, and
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 • Use to move the selected users and roles from the Selected boxes to the
current lab Available boxes.
group • Use to move the selected users and roles from the Available boxes to the
default users
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 • Use to move one or more selected users and roles in the Available boxes to
lab group the Selected boxes.
default users • [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.
Option Description
Change current • Use to move the selected lab group owner and role from the Selected
lab group owner boxes to the Available boxes.
• Use to move the selected owner (user) and role from the Available
boxes to the Selected boxes.
Option Description
Add more lab • Use to move one or more selected users and roles from the Available
group owners boxes to the Selected boxes.
If there are more than 500 users, use the User list filter.
4 [Optional] In the User list filter box, type to filter the list of available users.
5 Click Save.
1 From the Lab Groups table in the Monitoring tab, click next to the lab group, and
select Edit.
2 Click the Approvers tab.
3 Do any of the following to set thresholds:
Option Description
Automatic Specify a threshold under Automatic approval so that lab requests that are
approval 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.
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.
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.
5 Click Save.
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.
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.
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.
About 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 Columns Available Navigation
Lab groups Monitor all the lab groups on the Teradata • Lab Group From the Monitoring tab, the
Database systems that contain labs that you • Space Lab Groups table appears in the
either own or have access to. • Size top pane.
The bar chart in the Space column shows • Allocated
the total space allocated to the lab group in • % Allocated
gray, the space allocated to labs in the lab • Used
group in dark green, and the space in use • % Used
within all labs in the lab group in light • Owners (lab group)
green.
• Location
The content appears red in the Allocated • Private
and % Allocated columns when the • Created
allocated space is within the threshold set • Parent DB
for Lab Group Size in the Settings view.
• Description
Labs Monitor all the labs that you either own or • Lab From the Monitoring tab, when
have access to. • Space you click a lab group row, the
• Size Labs table appears in the middle
The bar chart in the Space column shows
• Used pane.
the total space allocated to the lab in gray
and the amount of space in use within the • % Used
lab in dark gray. • Expires
The content appears red in the Used and % • Owners (lab)
Used columns when the used lab space is • Location
within the threshold set for Lab Size in the • Description
Settings view.
Tables Monitor all the tables in a lab. • Table (name) From the Monitoring tab, when
• Size you click a lab group row, and
• Skew then click a lab row, the Tables
• Created (date) table appears in the bottom pane.
• Created by
• Location
1 From the Lab Groups table in the Monitoring tab, click next to the lab group, and
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.
1 From the Labs table in the Monitoring tab, click next to the lab, and select View Lab
Details.
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 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.
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 next to the table, and select View
Sample Rows.
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. 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.
The file is saved to your download area or to a location that you specify, depending on
the browser settings.
About 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.
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 a. In the Lab Groups table, click the name of the lab group to which you
Monitoring tab want to add a lab.
b. In the Labs table, click next to LABS.
The lab group is selected for you.
Option Description
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 Select the Expire lab after check box and either select the
on the lab 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
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.
You can view a log of submitted requests and export the data in the request log depending on
what type of user you are.
• 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.
Option Description
From the a. Click next to the lab, and select Increase Lab Size.
Monitoring tab
The lab group and lab are selected for you. To change the lab group or
lab, use the Requests tab to submit your request.
You will receive an email notification after your request has been approved, depending
on your email notification settings.
After your request has been approved, the total space allocated to the lab appears in the Size
column in the Monitoring tab.
Option Description
From the a. Click next to the lab, and select Decrease Lab Size.
Monitoring tab
The lab group and lab are selected for you. To change the lab group or
lab, use the Requests tab to submit your request.
After your request has been approved, the total space allocated to the lab appears in the Size
column in the Monitoring tab.
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:
Option Description
From the a. Click next to the lab, and select Add User.
Monitoring tab
The lab group and lab are selected for you. To change the lab group or lab,
use the Requests tab to submit your request.
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)
a. 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.
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 to
move them to the Selected users box.
If there are more than 500 users, use the User list filter.
• In the Available roles box, select one or more Teradata Database roles and click to
move them to the Selected roles box.
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.
5 [Optional] Enter a comment up to 500 characters.
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.
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 a. Click next to the lab, and select Remove User.
Monitoring tab
The lab group and lab are selected for you. To change the lab group or
lab, use the Requests tab to submit your request.
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 to
move them to the Users to remove box.
• In the Current roles box, select one or more Teradata Database roles and click to
move them to the Roles to remove box.
4 [Optional] Enter a comment up to 500 characters.
5 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
removed from the Request Details pane in the Requests tab, displayed in groups as Full
control and Read-only.
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:
Option Description
From the a. Click next to the lab, and select Add Owner.
Monitoring tab
The lab group and lab are selected for you. To change the lab group or
lab, use the Requests tab to submit your request.
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 to move
them to the Selected users box.
If there are more than 500 users, use the User list filter.
• 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.
3 [Optional] Enter a comment up to 500 characters.
4 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, the user (owner) you added appears in the Owners
column in the Labs table in the Monitoring tab.
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 a. Click next to the lab, and select Remove Owner.
Monitoring tab
The lab group and lab are selected for you. To change the lab group or
lab, use the Requests tab to submit your request.
Option Description
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.
4 [Optional] Enter a comment up to 500 characters.
5 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, the owner you removed no longer appears in the
Owners column in the Labs table in the Monitoring tab.
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 read-
only 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 a. Click next to the lab, and select Delete Lab.
Monitoring tab
The lab group and lab are selected for you. To change the lab group or
lab, use the Requests tab to submit your request.
After your request has been approved, the deleted lab no longer appears in the Monitoring
tab.
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.
Teradata Database users or roles that have read-only access to a lab cannot send requests to
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 a. Click next to the lab, and select Extend Lab.
Monitoring tab
The lab group and lab are selected for you. To change the lab group or
lab, use the Requests tab to submit your request.
Option Description
Set a renewal time frame on the Select Renew lab for and either select the number of days
lab from the menu or type a number from 1 to 9999 and press
Enter.
Set no expiration on the lab Select No expiration.
After your request has been approved, the new expiration date appears in the Expires
column in the Monitoring tab.
A lab owner or a lab group owner can submit a request to change lab details, which includes
the lab description, lab instructions, and email notifications. 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 a. Click next to the lab, and select Edit Lab Details.
Monitoring tab
The lab group and lab are selected for you. To change the lab group or
lab, use the Requests tab to submit your request.
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 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 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, the changes you made appear when you view lab
details.
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.
Teradata Database users or roles that have read-only access to a lab cannot send requests to
edit the table description.
1 From the Monitoring tab, click 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.
You will receive an email notification after your request has been approved, depending on
your email notification settings.
The updated table description appears in the Description column in the Tables table in the
Monitoring tab.
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 a. Click next to the lab, and select Reinstate Lab.
Monitoring tab
The lab group and lab are selected for you. To change the lab group or
lab, use the Requests tab to submit your request.
Option Description
Set an expiration time frame Select the Expire lab after check box and either select the
on the lab 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.
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.
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 a. Click next to the lab, and select Other.
Monitoring tab
The lab group and lab are selected for you. To change the lab group or
lab, use the Requests tab to submit your request.
3 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, 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.
The Request Details pane appears at the bottom.
3 To delete one or more requests, do the following:
Option Description
Delete one request From the Request Details pane, click Delete.
Delete more than one a. From the Requests tab, click the Table Actions menu, and select
request Delete.
b. Select one or more check boxes in the table rows.
c. Click Delete.
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 next to the status.
2 Click 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.
About 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.
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.
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:
Button Request Types
Lab Add Lab
Delete Lab
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.
The Request Details pane appears at the bottom.
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. From the Approvals tab, click the Table Actions menu, and
request 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.
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.