17.00 - IGNORE QUERY_BAND VALUES - Advanced SQL Engine - Teradata Database

Teradata Vantage™ - SQL Data Definition Language Syntax and Examples

Product
Advanced SQL Engine
Teradata Database
Release Number
17.00
Release Date
September 2020
Content Type
Programming Reference
Publication ID
B035-1144-170K
Language
English (United States)
Defines the set of name-value pairs to ignore if specified in a SET QUERY_BAND statement for all users assigned the profile. When a user with the profile issues a SET QUERY_BAND statement containing a name-value pair matching a IGNORE QUERY_BAND VALUES name-value pair, the system performs the following actions:
  • The matching name-value pair is ignored.
  • The query band is set with the remaining name-value pairs.
  • A warning message displays.

You must enclose the set of name=value pairs for the query band with APOSTROPHE characters (').

The number of name=value pairs is limited to the maximum length of the string, which is 4,096 UNICODE characters, including pad characters.

Pair names and values cannot contain any of the following characters:
  • SEMICOLON (;)
  • a null
Setting a pair_name to an empty string value indicates that a name-value pair with the pair_name and any value will be discarded. For example:
pair_name=;
To specify multiple values for the same pair_name, each name-value pair must be specified separately. For example:
    IGNORE QUERY_BAND VALUES = 
        ’TVSTemperature=HOT;TVSTemperature=WARM;’

If an APOSTROPHE character is embedded within a pair name or value, you must type it twice, to escape it. Otherwise, the system interprets it as a pair_name=pair_value string terminator.

IGNORE QUERY_BAND VALUES
Keywords to introduce query band options to ignore.
pair_name
Name component of a query band specification.
The maximum size for each pair_name is 128 UNICODE characters. For more information about database object names, see Teradata Vantage™ - SQL Fundamentals, B035-1141.
pair_value
Value component of a query band specification.
pair_value can be up to 256 UNICODE characters in length.

Usage Notes

If a profile has a query band that is defined as NOT DEFAULT, it is redundant to define the IGNORE QUERY_BAND VALUES with name-value pairs having the same names as defined in the profile query band. The NOT DEFAULT profile query band causes the SET QUERY_BAND statement to discard any name-value pair matching the names in the profile query band.