FOOTING - Basic Teradata Query

Basic Teradata Queryリファレンス

Product
Basic Teradata Query
Release Number
16.20
Published
2018年4月
Language
日本語
Last Update
2019-07-03
dita:mapPath
ja-JP/moy1512703123963.ditamap
dita:ditavalPath
ja-JP/moy1512703123963.ditaval
dita:id
B035-2414
Product Category
Teradata Tools and Utilities

目的

この制御によって、ユーザーは、レポートのフッター用文字列を指定できます。フッターは、各ページの一番下に出力されます。

構文



次のような場合に当てはまります。

string
フッター用の文字列。

この文字列には分離記号も入れて最大253文字まで含めることができ、最大10行にわたる文字列にすることができます。

文字列が指定されていない場合、フッターはNULLにリセットされます。

使用上の注意

FOOTINGコマンドはTeradata SQLマクロで使用できます。

特殊文字の使用

文字列の中に、特殊文字を使用しないでください。特殊文字の解釈は、出力デバイスごとに異なります。 出力を別のデバイスに送る場合には、特殊文字を含んだスクリプトの修正が必要になる場合もあります。

単一引用符の使用

文字列に単一引用符が含まれている場合は、FOOTINGコマンドの2つの形式、つまり、区切り記号として二重引用符を付けた形式を使用するか、または単一引用符を二重にします。例えば、次のようになります。

.SET FOOTING "December's Results"

または

.SET FOOTING 'December''s Results'

単一引用符が含まれていない場合には、FOOTINGコマンドの2つの形式はまったく同じです。

フッターの書式化

以下の2種類の制御文字を使って、フッターの書式を制御することができます。

制御文字 結果
二重の斜線(//) 行を分け、その位置から新しい行にする
二重の縦棒(||) 行をセクションに分割する

行の分離

改行する位置に二重の斜線(//)を挿入することにより、1行のフッターを分け、その位置から新しい行にすることができます。 FOOTINGコマンドで、最大9対の二重斜線(最大10行)を指定することができます。

行のセクションへの分割

分割する位置に二重の縦棒(||)を挿入することにより、1行のフッターを3つまでのセクションに分割することができます。 フッターの1行につき分割できるセクションの数は、最大3つ(2対の縦棒)です。

指定 処理 結果
分割文字なしのフッター 1行が1つのセクションのままとなる。 フッターは中央に配置される。
1対の分割文字 1行が2つのセクションに分割される。 行の最初の部分は左詰めで、2番目の部分は中央に配置される。
2対の分割文字 1行が3つのセクションに分割される。 行の最初の部分は左詰めで、2番目の部分は中央に、最後の部分は右詰めで配置される。
1対の切れ目のある縦棒を分離文字として使用することもできます。

限度以上の縦棒の使用

3対以上の縦棒を指定した場合には、次のように処理されます。

システムの種類 結果
メインフレーム接続 2対目より後の部分もタイトルのフッター テキストとみなされるが、2対を超える縦棒が使用されたという警告が表示される。
ワークステーション接続 2対目より後の部分の縦棒はフッターのテキストから切り捨てられる。

例えば、メインフレーム接続システムでは、次のコマンドは警告メッセージを生成し、コマンド例の下に誤ったフッター情報を示します。

コマンド

.SET FOOTING '&DATE||Confidential Report||Part Two||Page&PAGE'

警告:

*** Warning: Maximum of 2 '||' separators is allowed,
 others ignored.

誤ったフッター:

90/08/25 Confidential Report Part Two||Page2

置換変数の使用

上記の例で使用しているように、フッター文字列の任意の位置に、次の置換変数を使用することができます。

  • &DATE
  • &TIME
  • &PAGE
  • &n

使用場所:

置換変数 結果
&DATE YY/MM/DD形式の現在の日付
&TIME HH:MM形式の現在の時刻
&PAGE 現在のページ番号 (&PAGEを使用しないでフッターを指定した場合には、ページ番号は出力されません)。
&n フッターの直前に表示される、返される行のn番目の列の内容。 次のような場合、&n置換変数を使用することはできません。
  • .SET FOLDLINE ON mを指定している場合に、0よりも大きく、mの値を上回る&n
  • .SET FOLDLINE ON ALLを指定している場合

z/OS Unicodeセッション内でエクスポートされていない出力の場合、この値はLATIN1文字だけで構成されている必要があります。

ページ幅より広いフッターの指定

フッターがページ幅よりも大きい場合には、まず、中央部分が切り捨てられます。 さらに切り捨てが必要な場合には、ページ幅に収まるようになるまで、左右の部分(最初に右側)が切り捨てられます。 次にこの例を示します。

.set format on     
.set footing 'This is an example of a footing that is too long
for the page and is truncated starting from the right'

次のデータを返すSQLリクエストの結果には、次のフッターが含まれます。

  This is an example of a footing that is too long for   

フッターを指定しない場合

フッターが指定されていない場合、BTEQはページの下部にあるフッター領域の行を使用して、追加の返された行を含めます。

FORMATコマンドのオプションをOFFに設定した場合には、SHOW CONTROLSの出力の中にはフッターの指定が表示されます。FOOTINGコマンドは書式化の段階で無視されます。 フッターをレポートに入れる場合には、必ずFORMATコマンドのオプションをONに設定するようにします。

例1 – FOOTING

database workforce;
.set defaults on    
.set format on    
.set footing 'Confidential Report'
select * from department
;

BTEQの応答

*** Query completed. 5 rows found. 4 columns returned.
90/07/25      select * from department;       Page 1
DeptNo   DeptName          Loc   MgrNo
------   --------------    ---   -----
   500   Engineering       ATL   10012
   700   Marketing         NYC   10021
   300   Exec Office       NYC   10018
   600   Manufacturing     CHI   10007
   100   Administration    NYC   10011
         Confidential Report

例2 – FOOTING

database workforce;
.set defaults
.set format on
.footing "This is an example -
of a continued footing-
with incorrect spacing"
select * from department
;

BTEQの応答

   *** Query completed. 5 rows found. 4 columns returned.
   90/07/25     select * from department;        Page 1
   DeptNo   DeptName          Loc  MgrNo
   ------   --------------    ---  -----
      500   Engineering       ATL  10012
      700   Marketing         NYC  10021
      300   Exec Office       NYC  10018
      600   Manufacturing     CHI  10007
      100   Administration    NYC  10011

これは、誤ったスペーシングによる継続フッターの例です。

例3 – FOOTING

database workforce;
.set defaults
.set format on    
.footing '&date||Confidential||Page&Page'
select * from department
;

BTEQの応答

*** Query completed. 5 rows found. 4 columns returned.
90/07/25    select * from department;         Page 1
DeptNo   DeptName          Loc     MgrNo
------   --------------    ---     -----
   500   Engineering       ATL     10012
   700   Marketing         NYC     10021
   300   Exec Office       NYC     10018
   600   Manufacturing     CHI     10007
   100   Administration    NYC     10011
   
  90/07/25            Confidential            Page 1

例4 – マクロによって出力されるFOOTING

Teradata SQLマクロでは、コマンドは次のようになります。

ECHO '.SET FOOTING ''&DATE||Confidential||Page&PAGE'' ';

または

ECHO '.SET FOOTING "&DATE||Confidential||Page&PAGE"';