VARGRAPHIC Rules - Teradata Vantage

Teradata® VantageCloud Lake

Deployment
VantageCloud
Edition
Lake
Product
Teradata Vantage
Published
January 2023
ft:locale
en-US
ft:lastEdition
2024-12-11
dita:mapPath
phg1621910019905.ditamap
dita:ditavalPath
pny1626732985837.ditaval
dita:id
phg1621910019905

VARGRAPHIC reports an error if the session character set is UTF8 or a single-byte character set, such as ASCII. If the argument is of type KANJI1, the only valid session character set is KanjiEBCDIC.

All characters in the string are converted into one or more graphics that are valid for the character set of the current session. For more information, see VARGRAPHIC Function Conversion Tables.

The argument cannot be of type GRAPHIC.

A result that exceeds the maximum length of a VARCHAR CHARACTER SET GRAPHIC data type generates an error.

Specific rules apply to the server character set of character_string_expression.

Server Character Set Effect
KANJI1 Shift-Out/Shift-In characters in the character_string_expression do not appear in the result string. These characters are required only to indicate the transition between single byte characters and multibyte characters.

Improperly placed Shift-Out/Shift-Ins are replaced by the illegal character for the character set of the session.

The SPACE CHARACTER translates to the IDEOGRAPHIC SPACE CHARACTER.

UNICODE
  • Characters with fullwidth representation in the UNICODE compatibility zone translate to that fullwidth representation.
  • Halfwidth characters from the compatibility zone translate to the corresponding characters outside the compatibility zone.
  • The SPACE CHARACTER translates to the IDEOGRAPHIC SPACE CHARACTER.
  • The control characters U+0000 - U+001F and character U+007F are converted to the VARGRAPHIC error character.
  • Other characters are left untranslated.
anything else The result is as if string were first converted to UNICODE and then translated according to the rules for UNICODE.

KANJI1 support is deprecated. KANJI1 is not allowed as a default character set; the system changes the KANJI1 default character set to the UNICODE character set. Creation of new KANJI1 objects is highly restricted. Although many KANJI1 queries and applications may continue to operate, sites using KANJI1 must convert to another character set.