Method Invocation | SQL Operators & User-Defined Functions | Teradata Vantage - Method Invocation - Advanced SQL Engine - Teradata Database

SQL Operators and User-Defined Functions

Product
Advanced SQL Engine
Teradata Database
Release Number
17.00
Published
September 2020
Language
English (United States)
Last Update
2023-04-27
dita:mapPath
qqu1556127655717.ditamap
dita:ditavalPath
lze1555437562152.ditaval
dita:id
B035-1210
lifecycle
previous
Product Category
Teradata Vantage™

Purpose

Invokes a method associated with a UDT.

Syntax

{ [ [ database_name. ]  table_name. ] column_name |

  udf_name ( [ argument_1 [,...] ] ) |

  CAST ( expression AS udt_name ) |

  [ NEW [SYSUDTLIB.] ] constructor_name ( [ argument_2 [,...] ] )

}.method_name_spec [,...]
method_name_spec
method_name ( [ argument_3 [,...] ] )
database_name
A qualifier for the column_name.
table_name
A qualifier for the column_name.
column_name

The name of a distinct or structured UDT column.

Constructor methods have the same name as the UDT with which they are associated.

udf_name

The name of a distinct or structured UDT data type.

Constructor methods have the same name as the UDT with which they are associated.

argument

An argument to the UDF.

An argument to pass to the constructor.

An argument to pass to the method.

Parentheses must appear even though the argument list may be empty.

CAST

A CAST expression that converts a source data type to a distinct or structured UDT.

Data type conversions involving UDTs require appropriate cast definitions for the UDTs. To define a cast for a UDT, use the CREATE CAST statement. For more information on CREATE CAST, see Teradata Vantage™ - SQL Data Definition Language Syntax and Examples, B035-1144.

expression
An expression that results in a data type that is compatible as the source type of a cast definition for the target UDT.
NEW
An expression that constructs a new instance of a structured type and initializes it using the specified constructor method.
SYSUDTLIB.

The database in which the constructor exists.

Teradata Database only searches the SYSUDTLIB database for UDT constructors, regardless of whether the database name appears in the expression.

constructor_name

The name of a constructor method associated with a UDT.

Constructor methods have the same name as the UDT with which they are associated.

method_name

The name of an observer, mutator, or user-defined method (UDM).

You must precede each method name with a period.