One-Dimensional ARRAY - Teradata Form - Teradata Vantage

Teradata® VantageCloud Lake
Deployment
VantageCloud
Edition
Lake
Product
Teradata Vantage
Published
January 2023
Language
English (United States)
Last Update
2024-04-03
dita:mapPath
phg1621910019905.ditamap
dita:ditavalPath
pny1626732985837.ditaval
dita:id
phg1621910019905
SYSUDTLIB
The optional name of the containing database for array_type name.
The only valid database name is SYSUDTLIB.
array_type_name
The name of the one-dimensional ARRAY type to be created.
For information about naming database objects, see Object Names.
If the UDF library for your database contains any objects with multibyte characters in their name, you cannot use a single-byte session character set to create a new UDF, UDT, method, or Java stored procedure object even if the new object name contains only single-byte characters. Otherwise, the system returns an error to the requestor. Instead, use a multibyte session character set.
data_type
The data type on which the one-dimensional ARRAY type is based.
The element types of an array must be chosen from an existing Vantage data type categories, including Distinct UDTs, Structured UDTs, and Period data types.
You can specify any Vantage predefined data types except for the following:
  • BLOB
  • CLOB
  • Distinct and structured LOB-based UDT
  • Geospatial
  • One-dimensional ARRAY types
  • Multidimensional ARRAY types
  • JSON
  • XML and XMLTYPE
  • DATASET
You cannot specify a character server data set of KANJI1. Otherwise, the system returns an error to the requestor.
For information about the predefined data types, see Data Types and Literals.
number_of_elements
The number of elements in the one-dimensional ARRAY type being created. This must be an unsigned INTEGER value.
A one-dimensional ARRAY type can have a maximum size of 64,256 bytes.
The maximum size of the auto-generated transform string for the ARRAY is 64,256 bytes. The size of an auto-generated transform string for an ARRAY is limited to the maximum size of a DBS VARCHAR type. The overall limit on the number of elements is dependent on the size of the elements and the size of the transform. For details on how the size of the transform is calculated, see ARRAY/VARRAY Data Type Rules and Guidelines.
DEFAULT NULL
Initialize all of the elements of array_type_name to null when the type is constructed.