getQueryBandPairs(String QBandBuf, int QB_SearchType) - Teradata Database - Teradata Vantage NewSQL Engine

Teradata Vantage™ SQL外部ルーチン プログラミング

Product
Teradata Database
Teradata Vantage NewSQL Engine
Release Number
16.20
Published
2019年3月
Language
日本語
Last Update
2019-10-29
dita:mapPath
ja-JP/uhh1512082756414.ditamap
dita:ditavalPath
ja-JP/uhh1512082756414.ditaval
dita:id
B035-1147
Product Category
Software
Teradata Vantage

クエリー バンド文字列QBandBufから、トランザクション、セッション、プロファイルの名前/値のペアを戻します。

引数

引数 説明
QBandBuf クエリー バンド文字列。クエリー バンドは、以下のいずれかにすることができます。
  • QueryBand.getQueryBand()によって戻される
  • DBC.DBQLogTbl.QueryBand列から取得される
  • 呼び出し側によって指定される
QB_SearchType getQueryBandPairs()が、トランザクション、セッション、プロファイルのクエリー バンドで名前/値ペアを検索するかどうかを指定します。
  • QueryBand.QB_FIRSTの場合、トランザクション、セッション、プロファイルのクエリー バンドで見つかった、それぞれの名前についての最初の固有名/値ペアを戻します。トランザクション、セッション、プロファイルのクエリー バンドに同じ名前が含まれる場合、getQueryBandPairs()は次の順番でクエリー バンドに見つかった最初の名前/値ペアを戻します。
    • トランザクション用クエリー バンド
    • セッション用クエリー バンド
    • プロファイル クエリー バンド
  • QueryBand.QB_TXNの場合、トランザクション クエリー バンドの名前/値ペアを戻します。
  • QueryBand.QB_SESSIONの場合、セッション クエリー バンドの名前/値ペアを戻します。
  • QueryBand.QB_PROFILEの場合、プロファイル クエリー バンドの名前/値ペアを戻します。

戻り値

バイト配列のエンコードは、名前に値が続き、さらに名前に値が続くという形式が繰り返されるものになります。サーバー文字セットがLATINである場合、各項目は1つの'\0'によって区切られ、サーバー文字セットがUNICODEである場合、各項目は2つの'\0'によって区切られます。