Argument Types and Rules - Teradata Vantage - Analytics Database

SQL Data Types and Literals

Deployment
VantageCloud
VantageCore
Edition
VMware
Enterprise
IntelliFlex
Product
Analytics Database
Teradata Vantage
Release Number
17.20
Published
June 2022
ft:locale
en-US
ft:lastEdition
2025-11-06
dita:mapPath
uds1628112204571.ditamap
dita:ditavalPath
qkf1628213546010.ditaval
dita:id
exs1472253032394
lifecycle
latest
Product Category
Teradata Vantageā„¢
Expressions passed to this function must have the following data types:
  • instring = VARBYTE or BLOB
  • out_encoding = VARCHAR(64)

If out_encoding is not one of the supported encodings, an error is returned.

If the resulting conversion overflows the result data type length, Analytics Database returns an error.

If either instring or out_encoding is NULL, the result is NULL.

The character set of the return type is set to either Latin or Unicode. The character set of the return type is set to match the character set of the encoding input parameter.

You can also pass arguments with data types that can be converted to these data types using the implicit data type conversion rules that apply to UDFs.

The UDF implicit type conversion rules are more restrictive than the implicit type conversion rules normally used by Vantage. If an argument cannot be converted to the required data type following the UDF implicit conversion rules, it must be explicitly cast.

The maximum input or output for CLOB or BLOB size is 2 GB. An error is reported if the size is exceeded.

The FROM_BYTES function converts from a VARBYTE and a character string. Byte strings are interpreted as negative if the high order bit is 1.

FROM_BYTES does not convert from byte to byte encodings, as the data is interpreted differently. Additionally, the byte encodings do not use positive or negative signs, which FROM_BYTES needs to decipher if the data is a positive or negative number.

If you must use byte to byte conversion, use two TO_BYTE functions. (Note the syntax is TO_BYTE, not TO_BYTES.)