SYSLIB.SparseMapAMPs Function | SQL Operators & UDFs | Teradata Vantage - SYSLIB.SparseMapAMPs - Analytics Database - Teradata Vantage

SQL Operators and User-Defined Functions

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
VMware
Product
Analytics Database
Teradata Vantage
Release Number
17.20
Published
June 2022
Language
English (United States)
Last Update
2024-04-05
dita:mapPath
xub1628111590556.ditamap
dita:ditavalPath
qkf1628213546010.ditaval
dita:id
drp1544241916620
lifecycle
latest
Product Category
Teradata Vantage™

SYSLIB.SparseMapAMPs is a table function that returns the AMPs with a sparse map defined for a table, join index, or hash index.

The view DBC.SparseMapAMPsV is an alternative to using the table function SYSLIB.SparseMapAMPs. The underlying system view, DBC.ObjectsInSparseMapsV, prepares all arguments for the table function. See Teradata Vantage™ - Data Dictionary, B035-1092 for more details about views DBC.SparseMapAMPsV and DBC.ObjectsInSparseMapsV.

ANSI Compliance

This statement is a Teradata extension to the ANSI SQL:2011 standard.

Syntax

[SYSLIB.] SparseMapAMPs (
  'DatabaseName',
  'ObjectName',
  'ObjectKind',
  'MapSlot',
  'NumberOfPrimaryAmps',
  'ColocationName'
)

Syntax Elements

SYSLIB.
Name of the database where the function is located.
DatabaseName
The database in which the object is defined.
ObjectName
Name of the table, join index, or hash index defined in DatabaseName. It cannot be NULL.
ObjectKind
The kind of objects, such as a table, join index or hash index, defined in the sparse map.
MapSlot
The map slot of the sparse map.
If the map containing the map slot does not exist, or is not a sparse map, an error is returned.
NumberOfPrimaryAMPs
The number of primary AMPs defined in the sparse map.
ColocationName
The colocation name string for the table.