VARBYTE Data Type - Teradata Vantage NewSQL Engine - 16.20

Teradata Vantageā„¢ Data Types and Literals

prodname
Teradata Database
Teradata Vantage NewSQL Engine
vrm_release
16.20
category
Programming Reference
featnum
B035-1143-162K

Purpose

Represents a variable-length binary string.

Syntax



n
The number of bytes in the string.
The maximum value for n is 64000.
attributes
Appropriate data type, column storage, or column constraint attributes.
See Core Data Type Attributes and Storage and Constraint Attributes for specific information.

ANSI Compliance

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

External Representation of VARBYTE

The following table lists the client representations for the Teradata SQL VARBYTE data type.

Define the length of the VARBYTE string as k, where 0 <= k <= n.

Client CPU Architecture Client Internal Data Format
IBM mainframe k + 2 bytes 16-bit SMALLINT (2 byte) length count k followed by k bytes of BYTE data.
  • UTS
  • RISC
  • Motorola 68000
  • WE 32000
  • Intel
k + 2 bytes 16-bit SMALLINT (2 byte) length count k followed by k bytes of BYTE data.

Example: VARBYTE Data Type

In the following example, the column named BinaryData is assigned the VARBYTE data type and has an upper limit of 1200 bytes:

CREATE TABLE DocTable
  (DocType INTEGER
  ,DocName CHAR(26)
  ,BinaryData VARBYTE(1200));