getQueryBandNumPairs(String QBandBuf, int QB_SearchType) - Analytics Database - Teradata Vantage

SQL External Routine Programming

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
VMware
Product
Analytics Database
Teradata Vantage
Release Number
17.20
Published
June 2022
Language
English (United States)
Last Update
2023-07-11
dita:mapPath
iiv1628111441820.ditamap
dita:ditavalPath
qkf1628213546010.ditaval
dita:id
B035-1147
lifecycle
latest
Product Category
Teradata Vantageā„¢

Returns the number of name-value pairs in the query band that meet the search criteria specified by the QB_SearchType argument.

Syntax

getQueryBandNumPairs(String QBandBuf, int QB_SearchType)

Syntax Elements

QBandBuf
A query band string, where the query band can be:
  • Returned by QueryBand.getQueryBand()
  • Retrieved from the DBC.DBQLogTbl.QueryBand column
  • Specified by the caller
QB_SearchType
Specifies whether getQueryBandNumPairs() searches for name-value pairs in the transaction, session, and/or profile query band.
If the value is...
  • QueryBand.QB_FIRST, then return the number of name-value pairs in the transaction, session, and profile query bands, where each name is unique. If the transaction, session, or profile query bands contain the same name, getQueryBandNumPairs() counts only one name-value pair.
  • QueryBand.QB_TXN, then return the number of name-value pairs in the transaction query band.
  • QueryBand.QB_SESSION, then return the number of name-value pairs in the session query band.
  • QueryBand.QB_PROFILE, then return the number of name-value pairs in the profile query band.