Teradata Vantage
Teradata Vantage
Release 16.20
July 2019
B035-1725-162K
DOCS.TERADATA.COM
Copyright and Trademarks
Copyright © 2000 – 2019 by Teradata. All Rights Reserved.
All copyrights and trademarks used in Teradata documentation are the property of their respective owners. For
more information, see Trademark Information.
Product Safety
Safety type Description
Indicates a situation which, if not avoided, could result in damage to
NOTICE property, such as to equipment or data, but not related to personal injury.
Indicates a hazardous situation which, if not avoided, could result in minor
CAUTION or moderate personal injury.
Indicates a hazardous situation which, if not avoided, could result in death
WARNING or serious personal injury.
Warranty Disclaimer
Except as may be provided in a separate written agreement with Teradata or required by applicable law, 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
noninfringement.
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.
The information contained in this document may be changed or updated by Teradata at any time without
notice. Teradata may also make changes in the products or services described in this information at any time
without notice.
Feedback
To maintain the quality of our products and services, email your comments on the accuracy, clarity,
organization, and value of this document to: [email protected].
Any comments or materials (collectively referred to as "Feedback") sent to Teradata Corporation will be deemed
nonconfidential. Without any payment or other obligation of any kind and without any restriction of any kind,
Teradata and its affiliates are hereby free to (1) reproduce, distribute, provide access to, publish, transmit,
publicly display, publicly perform, and create derivative works of, the Feedback, (2) use any ideas, concepts,
know-how, and techniques contained in such Feedback for any purpose whatsoever, including developing,
manufacturing, and marketing products and services incorporating the Feedback, and (3) authorize others to do
any or all of the above.
Table of Contents
Introduction ...................................................................................................... 5
Understanding This Release ................................................................................................................... 5
Additional Information ........................................................................................................................... 5
Software and Hardware Requirements ......................................................... 6
Supported Software and Hardware ......................................................................................................... 6
Software Maintenance Schedule ............................................................................................................. 6
Teradata Database Maintenance Roadmap ......................................................................................... 7
Platform Coexistence and Coresidence Requirements ........................................................................... 7
Node Memory Recommendations .......................................................................................................... 7
Memory-Consuming Features ............................................................................................................ 8
Reserved Words .................................................................................................................................... 10
Software and Hardware Restrictions .......................................................... 11
Obsolete and Unsupported Tools, Utilities, Options, Record Types, and Other Software .................. 11
TDGSS Single Mechanism to Log-On (TDNEGO) Teradata Unity Support ...................................... 13
1 MB Perm and Response Rows ........................................................................................................... 14
Teradata Archive/Recovery Utility ....................................................................................................... 14
Deprecated Kanji1 Character Set .......................................................................................................... 14
Kanji1 Restrictions............................................................................................................................ 14
Compatibility Views ............................................................................................................................. 14
Security-Related Restrictions................................................................................................................ 15
Custom Authentication Mechanisms ................................................................................................ 15
System-Level Software Restrictions ..................................................................................................... 15
Analytic Functions ................................................................................................................................ 16
Teradata Unity ...................................................................................................................................... 16
Changes in System Behavior ......................................................................... 17
Default Feature Status ........................................................................................................................... 17
1 MB Response Rows ........................................................................................................................... 19
1 MB Maximum Request Bytes ............................................................................................................ 19
Data Dictionary Tables and Views Column Data Type Changed ........................................................ 19
DBQL Cache Sizes ............................................................................................................................... 20
DBS Control Changes ........................................................................................................................... 20
Execute SCRIPT Table Operator with a Specific Authorization/OS User ........................................... 20
Fallback ................................................................................................................................................. 21
Fallback and Clustering ........................................................................................................................ 21
Function Mapping for Native Functions ............................................................................................... 21
Function Mapping Variable Substitution .............................................................................................. 21
Legacy versus Dedicated Fallback ........................................................................................................ 22
Heatmap Table Function Integration and Enhancements ..................................................................... 22
Before you install or upgrade to this release of Teradata® Database, read the following publications:
• Release Definition, B035-1725, which provides information about basic system requirements. If you are
upgrading from an older Teradata Database release, read the Release Definition for every intervening release.
• Release Summary, B035-1098, which describes the new features in a release. If you are upgrading from an
older release of Teradata Database, you should also read the Release Summary for every intervening release to
understand how the features in the latest release differ from your current version.
Additional Information
Link Description
https://docs.teradata.com Teradata documentation (HTML)
https://www.info.teradata.com Teradata documentation (PDF)
https://access.teradata.com/ Customer portal (one stop source for Teradata services and
products)
http://www.teradata.com/products-and-services/TEN Teradata Education Network
http://developer.teradata.com/ Public downloads (also available from the customer portal)
https://community.teradata.com/ Link to Teradata community (also available from the
customer portal)
• Customers with active Service Agreements can find the Teradata Maintenance Release Roadmap at
https://access.teradata.com.
• Customers without support agreements should contact their sales or support team.
The following are the basic system requirements for mixed operating systems:
• All TPA nodes must run the same operating system, but you can mix non-TPA nodes in any
combination of the allowed operating systems.
• TPA nodes need not run on the same operating system as non-TPA nodes.
• Mixed OS allows two consecutive generations of nodes/storage across TPA and/or non-TPA nodes.
• The same version of BYNET must be deployed across the system.
Allowed platform combinations are the same as those allowed for coexistence and coresidence systems.
• Coexistence allows you to combine existing system nodes with certain newer, more powerful nodes.
You can assign an unbalanced number of AMPs per node to optimize both current and new platform
resources.
• Coresidence allows you to combine existing system nodes with certain newer, more powerful
nodes. You can assign only a fixed number of AMPs per node, which may limit the use of newer
platform resources.
• Upgrade allows you to replace processors in an existing node to make it functionally equivalent to a
more powerful node model.
Determining whether a Teradata node can coexist or coreside with other node models depends on the
platform type, performance class, operating system, and the version of BYNET installed on each node.
Coexistence and coresidence requirements are not part of the standard user documentation set. For more
information, contact the Teradata Support Center.
When upgrading to Release 16.20.xx, several factors can cause some systems, especially large ones, to
require additional memory.
The general guidelines for memory follow; however, memory requirements are workload-dependent, so
your system’s actual memory requirements may differ.
General Guidelines:
• Teradata recommends a minimum of 4 GB memory per vproc to achieve the most value and
performance from Teradata Database 16.20.xx. The absolute minimum requirement is 2 GB memory
per vproc (including AMP, PE, TVS, and GTW).
• Some Teradata Database 16.20.xx features require 512 GB per node; for example, Teradata In-
Memory Optimizations.
• Additional memory consumed is based on the size of system, AMPs per node, AWT, and feature
use.
Note: The maximum amount of memory allowed per node may be increased between database releases.
Always double-check what the maximum memory amount is for your platform.
Release 16.20.xx can run on a system with the recommended minimum RAM, but performance may not
be optimal, depending on the system configuration and the Teradata Database features you use. You
should also factor in the following to determine the optimal memory configuration:
• Workload
• Memory-consuming features
• Performance requirements
• Cost of memory
Memory-Consuming Features
These features may require more memory for optimum system performance:
Reserved Words
Teradata Database reserved words cannot be used as identifiers to name host variables, correlations,
local variables in stored procedures, objects (such as databases, tables, columns, or stored procedures),
or parameters (such as macro or stored procedure parameters).
New reserved words for this release are listed in the “Restricted Words” appendix in Release Summary,
B035-1098, available at https://www.info.teradata.com or https://docs.teradata.com.
If MAPS is enabled, you can use DSA for archive/recovery operations. For more information about
DSA, see Teradata Data Stream Architecture (DSA) User Guide, B035-3150.
During an upgrade to Teradata Database from a pre-14.0 release, the system automatically replaces
DEFAULT CHARACTER SET KANJI1 with DEFAULT CHARACTER SET UNICODE in existing
user definitions.
Kanji1 Restrictions
As part of the plans for discontinuing Kanji1 support, creation of new Kanji1 objects is highly restricted.
For example, inclusion of the phrase CHARACTER SET KANJI1 in the following statements returns a
syntax error:
Use the TRANSLATE function to convert existing Kanji1 data to Unicode or another supported server
character set. For more information, see “TRANSLATE” in Teradata Vantage™ SQL Functions,
Expressions, and Predicates, B035-1145.
Compatibility Views
Compatibility views convert the native variable-length Unicode object names into 30 bytes of either
Latin or Kanji1.This can cause loss of information by truncation or inability to convert object names
As with all character data, when object names are returned to the user they are converted to the session
character set. This conversion can produce loss of information if the characters in the object name
cannot be converted to the session character set or exceed the export width for the character data.
Teradata recommends using Unicode views. For more information, see Teradata Vantage™ Data
Dictionary, B035-1092.
Security-Related Restrictions
Custom Authentication Mechanisms
Development and deployment of a custom authentication mechanism for use with this release can only
be achieved by purchasing the Teradata Security Software Developer Kit.
Note that development and deployment of a custom authentication mechanism results in the creation of
a custom encryption software product. Distribution of a custom encryption product outside the U.S. and
Canada is regulated by the U.S. Department of Commerce (DOC). An export authorization must be filed
for and obtained from DOC in order to export such custom products. For information on obtaining an
export authorization, please see the DOC website at BIS Website.
If additional information is required, customers should contact their Teradata representative. Teradata
representatives requiring help should contact Teradata Corporate Export Compliance, Law Department.
Note: A custom authentication mechanism is a user authentication mechanism that is above and beyond
the mechanisms that are provided with Teradata Database:
1. Teradata Method 2
2. KRB5 (Kerberos authentication)
3. LDAP
4. SPNEGO (used for Kerberos authentication for logons from Windows .NET clients)
5. TDNEGO
Analytic Functions
Unicode is not supported for the nPath® and Attribution functions on NewSQL Engine.
Teradata Unity
Teradata Unity Release 16.20.33 provides Unity Passive routing support with ML Engine. Additionally,
this release of Unity continues to support Passive and Managed routing with NewSQL Engine. Unity
Managed routing with ML Engine is a roadmap item and scheduled for a future Unity release.
In previous releases, some features were enabled by default and others were manually enabled,
depending on whether the Teradata Database system had a fresh installation (sysinit) or an upgrade.
Release 16.00 and later features do not require a sysinit to be enabled. Features in earlier releases that
required a sysinit still require a sysinit (for details, see Release 15.10 Release Definition, B035-1725).
Default enabling may cause changes in system behavior compared with previous releases. Even after
enabling, some features may require additional configuration.
1 MB Response Rows
In prior releases, client-server response messages were limited to 1 MB. In Release 16.00 and later,
Teradata Database supports client-server response messages of up to 16 MB. Applications designed for
Teradata Database Release 16.00 and later can take advantage of this larger message size.
• DiskSpaceV[X][_SZ]
• TableSizeV[X][_SZ]
• DBC.AllSpaceV[X][_SZ]
Customers with pre-existing queries listing these tables and views must explicitly CAST BIGINT
columns to FLOAT.
Users can now flush the object use count cache whenever their applications require it instead of waiting
for the 10-minute system default period to expire or the cache to become full.
The following DBS Control fields are obsolete in Release 16.00 and later:
• DisplacementOnOverlap
• MDSIsEnabled
In previous releases, the ROUND and TRUNC functions returned a DATE type if they were passed a
TIMESTAMP type. In Release 16.10 and later, a new DBS Control General field
TruncRoundReturnTimestamp can be set to TRUE to have these functions return TIMESTAMP values
in this situation.
Fallback
Beginning in Teradata Database 16.20 Feature Update 1:
• Newer platforms now always use fallback enforced by software. All newly created databases,
users, indexes, and tables are set to FALLBACK, even if you specify NO FALLBACK in the
CREATE request. All databases or users are set to FALLBACK even if you specify NO
FALLBACK in the ALTER TABLE or MODIFY DATABASE/USER request.
• Older platforms that upgrade to this release still allow the NO FALLBACK option and the
default is NO FALLBACK for the CREATE TABLE, ALTER TABLE, CREATE JOIN INDEX,
CREATE HASH INDEX, CREATE DATABASE, MODIFY DATABASE, CREATE USER, and
MODIFY USER requests.
• The SERVER clause is now optional, that is, not specified for a function within a database or user.
• You can now specify multiple ANY IN TABLE clauses.
• User variables.
• System variables.
• Scalar subquery expressions (SSQs)
• Concatenated variable expressions
In prior versions of Teradata Database, legacy fallback was used. In this scheme, each AMP in a cluster
contains fallback copies of primary data from all the other AMPs in the cluster. For example, consider a
four-AMP cluster (AMPs 0, 1, 2, and 3). If AMP 0 contains nine rows of primary data, the fallback
copies of those rows are spread among AMPs 1, 2, and 3.
New maps created on systems upgraded to Teradata Database 16.10 or later use dedicated fallback;
however, tables that still use existing maps from releases prior to 16.10 use legacy fallback. For systems
that use two-AMP clusters, dedicated and legacy fallback operate identically.
Note: Users cannot install the heatmap function from Developer Zone after upgrading to Release 16.00
or later.
If the upgrade or installation detects that the Teradata Database system is currently using ipfilters, the
link-local restriction will not be imposed, and a warning message will advise adding the link-local
restriction manually.
For instructions on modifying the link-local IP address configuration, see Teradata Vantage™ NewSQL
Engine Security Administration, B035-1100.
Packageless TeraGSS
TeraGSS is now embedded in client drivers, eliminating the need for TeraGSS installation and
configuration. If there is a need to configure TeraGSS on a client, see the appendix regarding the
Teradata GSS Administrative Package in Teradata Vantage™ NewSQL Engine Security Administration,
B035-1100. Note: Teradata recommends not configuring TeraGSS.
Teradata Unity uses TDGSS instead of TeraGSS. For information about Unity, see Teradata Unity
Installation, Configuration, and Upgrade Guide for Customers, B035-2523, and Teradata Unity User
Guide, B035-2520.
As of Release 16.20 Feature Update 2, Priority Scheduler implements its own CPU throttling scheme.
Tasks running in the internal system workload, such as PDE daemon tasks, are never CPU throttled.
Tasks holding critical internal resources are not throttled. To prevent total PDE CPU usage from
• Better control: Task-level CPU throttling gives Priority Scheduler more control of when and how
long a task is throttled. Priority Scheduler will only throttle at specific preemption points.
• Better overall system performance: System daemons can be made immune to CPU throttling.
• Visibility: Tasks are throttled at the task level, so you can examine statistics to determine the impact
of hard limits or COD on a task, request, session, workload, and virtual partition.
• Process address lock contention eliminated: No CPU throttling of a task in the middle of a kernel
call.
PSF can only CPU throttle those tasks that are visible to PDE. Similar to past behavior, CPU usage
reported by the Resource Sampling Subsystem (RSS) SPMA table is different than CPU usage reported
by RSS SPS and SVPR tables. This is because SPMA reports all OS CPU usage information from /proc,
while tables like SPS/SVPR report only PDE-related usage.
For more information, see Carrie Ballinger, Workload Management Capacity on Demand and Other
Hard Limits, Teradata Database 16.20 Feature Update 2, Teradata Database Orange Book TDN0009761.
For information about the RSS tables, see Resource Usage Macros and Tables, B035-1099.
• New dictionary tables and changes to existing dictionary tables to support maps.
• User tables are defined to use TD_Map1, which includes all the AMPs in the system. It is the
system-default map.
• Data Dictionary tables are defined to use TD_DataDictionaryMap, except for nonhashed tables in
database DBC, which are defined to use TD_GlobalMap.
• When MAPS is enabled, the Teradata Archive/Recovery utility (ARC) can archive/restore only
objects contained in the all-AMPs contiguous map. For more information, see “Running Teradata
ARC in a Multiple Hash Map (MAPS) Environment” in Teradata Archive/Recovery Utility
Reference, B035-2412. If MAPS is enabled, use Teradata Data Stream Architecture (DSA) for
archive/recovery operations. For more information about DSA, see Teradata Data Stream
Architecture (DSA) User Guide, B035-3150.
If the MAPS feature is enabled, you cannot back down to a release prior to 16.10. For information on
using MAPS, see Database Administration, B035-1093.
• JDBC
• Windows .NET
For more information, see Teradata Vantage™ NewSQL Engine Security Administration, B035-1100.
• BMP from Unicode versions 6.1.0 to 9.0.0, which Teradata does not support, including Emoji
• SMP from Unicode versions, which Teradata does not support
• Unassigned characters
• Private use characters
Note: Although pass through characters can be stored in Teradata Database, they are not fully supported.
For example, collation, case sensitivity, and object name support are not included with this feature.
Noncharacter exceptions and invalid character encoding form (ill-formed code unit sequence)
exceptions will not occur for a pass through session when importing from UTF-8 or UTF-16 sessions to
the UNICODE server character set. They are changed to one or more replacement character(s),
(U+FFFD), without consuming valid successor bytes as described in the Unicode Standard (see
http://www.unicode.org/versions/Unicode8.0.0).
Unicode Pass Through is not supported with FastLoad, MultiLoad, Teradata Parallel Data Pump
(TPump), FastExport, and OLE DB Provider for Teradata. Use Teradata Parallel Transporter (TPT),
BTEQ, or the Teradata JDBC Diver to load and unload pass through data. If you do not specify Unicode
Pass Through for a session, the default is OFF.
Because the internal representation of pass through characters is UTF-16, a supplementary character is
represented in the UNICODE server character set as two 16-bit UTF-16 code units, or 4 bytes. So
VARCHAR(2) or CHAR(2) are the minimum sizes required in order to store pass through characters.
For changes in behavior that impact upgrade or migration, see Changes in System Behavior.
• Installation of this Teradata Database release on all supported platforms and operating systems.
• Migration from Teradata Database 15.00 and later. Migrations from previous releases require an
intermediate migration.
• Upgrade to this release from the releases shown in Knowledge Article IDA00108C82, available
from Teradata @ Your Service (https://access.teradata.com). To see the article, you must be logged
into Teradata @ Your Service.
If your current Teradata Database version is not listed as an approved upgrade starting version, you
must first upgrade to an approved starting version before upgrading to this release. Contact the
Teradata Support Center for details. For information on upgrades from older releases, see Upgrading
from Older Releases.
IUMB Planning
• Upgrade scripts and the upgrade estimator tool are available in the PUTTools package. Always get
the latest version. For all IUMB change controls obtain PUTTools from https://access.teradata.com.
Go to Update Your Software and then Database and Applications.
• Teradata @ Your Service (https://access.teradata.com) provides access to copies of other items
required for IUMB procedures such as:
o The certified list of software packages for each supported Teradata Database version,
including recently updated versions of software packages.
o Required application and operating system software patches, firmware, drivers, service packs
and hotfixes.
• You must upgrade your Teradata client software to at least the minimum supported release before or
at the same time as you upgrade to this release.
• Some features are enabled by default during a sysinit when upgrading or migrating and may affect
system behavior. To see if the current release is affected, see Default Feature Status.
• See the “DBS Control” coverage in Teradata Vantage™ Database Utilities, B035-1102, and review
the description of the Temporal Behavior DBS Control field.
• See the “ANSI Temporal Tables” coverage in Teradata Vantage™ Temporal Table Support, B035-
1182.
• PUT is provided with each copy of this release, but you should download the latest version of PUT
from https://access.teradata.com. Go to Update Your Software and then Database and Applications.
You can download Parallel Upgrade Tool (PUT) Reference, B035-5716, from https://docs.teradata.com.
Upward Compatibility
When using this feature, users who rely on Teradata Database to screen out unsupported characters or
the REPLACEMENT CHARACTER (U+FFFD) can no longer rely on Teradata to do so.
The hash function can handle pass through characters, including the hashing of surrogate code points (as
of Unicode version 8.0). Note: In a future release when pass through characters are fully supported, the
code points may be hashed differently.
Backward Compatibility
Because this feature stores characters that were previously unsupported, pass through characters on a
Teradata system cannot be transported to an earlier release without replacing the pass through
characters.
Prior to Unicode Pass Through, internal Unicode to internal Unicode translations of pass through
characters stored a U+FFFD in the destination string. With Unicode Pass Through and for all sessions,
including non-Pass Through Sessions, the translation of pass through characters stores, without loss,
those same pass through characters in the destination string.
Prior to Unicode Pass Through, internal Unicode to external Unicode, such as, UTF-16/UTF-8
translations of pass through characters, stored a U+FFFD or EFBFBD, respectively, in the destination
string. With Unicode Pass Through and for a pass through session, this translation of pass through
characters will instead store, without loss, those same pass through characters in the destination string.
Note: Installation of SLES 11 changes the workload management options available on the system.
You can upgrade from Release 15.x to Release 16.20 in one step.
To upgrade from Release 14.10, perform a multi-stage upgrade process. This requires two upgrades:
• 14.10 to 15.10
• 15.10 to 16.20
All customers upgrading to Release 16.20 from Release 14.10 automatically receive a copy of the
necessary intermediate versions of Teradata Database to use during the upgrade process. Customers are
licensed to use the intermediate software CD only as part of the upgrade process.
After the upgrade is complete, customers should dispose of the intermediate software CD, while
retaining the Release 16.20 CD.
Contact the Teradata Support Center if you are upgrading from a version that is more than two major
releases back.
Performance Regressions
Any regressions that Teradata identifies, either by further testing or in field-deployed systems, are fixed
as soon as possible. To find out the latest information about performance regressions that have been
identified for the new release and how they may affect your system, see: https://access.teradata.com.
It is strongly recommended that you do not run applications that are large consumers of system
resources (such as other databases) concurrently without understanding the performance and availability
impact to both the applications and Teradata Database.
• The system or node may need additional hardware (for example, memory) to support the
applications.
• Monitoring and tuning the system may be more complex.
• Compromises (for example, in the settings of tuning parameters) may be required to provide
satisfactory and consistent performance for both Teradata Database and applications.
• If a problem does occur, it may be necessary to determine whether the problem also occurs in
isolation.
If an application does not run properly or interferes with Teradata Database, it may be necessary to
move it to another node or system. For instance, such applications may:
By default, the Teradata memory allocation algorithms are based on Teradata Database using 100% of
the memory on a node. If other applications use a significant amount of node memory, you may need to
add memory, and you should adjust the option controlling this percentage. For these reasons, avoid
running non-Teradata applications on nodes running Teradata Database, if possible, as shown in the
table that follows.
Note: Even if applications are run on separate nodes (non-TPA nodes), they may still share the BYNET
and thereby potentially interfere with Teradata Database.