TITLEDASHES - Basic Teradata Query

Basic Teradata Query リファレンス

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

目的

この制御によって、ユーザーは、列データの上と、SQL文で返される集計データの上にダッシュ文字の行を出力するかどうかを指定できます。

ONとOFFを指定せずにTITLEDASHESコマンドが使用すると、BTEQは列タイトルに対してのみTITLEDASHESをONに設定します。

構文



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

withlist
TITLEDASHESコマンドに関連するWITH句を識別する1~10の数値。数値は、カンマで区切って指定します。

1で最初のWITH句を、2で2番目のWITH句を指定します。

withlistではなく0を指定した場合には、応答のうち、WITH句によって要約されない任意の部分に対してタイトル ダッシュの出力が抑制されます。

使用上の注意

TITLEDASHESコマンドを使用すると、指定したサマリー行の直前にダッシュ文字の行が挿入されて、レポートの内容が強調されます。サマリー行は、SELECT文の中の各WITH句によって生成されます。 SELECT文には9個のWITH句を使用でき、それぞれのWITH句には10個の式を指定することができます。

SELECTの結果のすべてのサマリー行の前にダッシュ行が出力されるようにする(デフォルトの構成である)には、withlistを指定せずに .SET TITLEDASHES ONを指定します。 このコマンドを使用して、前のコマンドで出力が抑制されていたダッシュ行を復元することもできます。

特定のサマリー行に対してタイトル ダッシュの出力を可能または禁止するには、該当するwithnumberにONまたはOFFを指定した状態で、TITLEDASHESコマンドを使用します。withnumber文が指定されていない場合、このステートメントはWITH句で要約されていないデータに適用されます。

SQL文のタイトルにNULL値を使用して、特定の列でダッシュの使用を禁止することもできます(例: TITLE '')。タイトルのダッシュを維持するには、TITLE' 'のように1つのスペース文字で構成されたタイトルを使用します。

TITLEDASHES設定が影響するのはフィールド モードの出力のみです。レコード モード、標識モード、またはマルチパート標識モードの出力には影響しません。

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

例1 – TITLEDASHES

次の例は、3番目のWITH句により指定されたサマリー行の直前のダッシュ行を抑制する場合を示しています。

.SET TITLEDASHES OFF 3
.SET FORMAT ON
SELECT deptno, empno, salary, edlev
FROM employee
WITH COUNT(empno) BY deptno
WITH SUM(salary) BY deptno
WITH AVG(edlev) BY deptno;

BTEQの応答

出力には、次に示すように、3列目のサマリー行の前にダッシュ行が出力されません。

*** Query completed. 36 rows found. 4 columns returned.
*** Total elapsed time was 4.71 seconds.
    
 95/05/16 SELECT deptno, empno, salary, edlev from employee Page 1
   
DeptNo        EmpNo      Salary  EdLev
------  -----------  ----------  -----
   100        10002   35,000.00     18
   100        10017   32,500.00     16
   100        10001   25,000.00     12
   100        10011   38,000.00     16
        -----------
Count(EmpNo)      4
                     ----------
        Sum(Salary)  130,500.00
   
                 Average(EdLev)     16
   
   300        10018   65,000.00     16
   300        10008   55,000.00     18
   300        10003   23,000.00     16
        -----------
Count(EmpNo)      3
                     ----------
        Sum(Salary)  143,000.00
   
                 Average(EdLev)     17
   
   500        10009   22,000.00     18
   500        10016   44,000.00     20
   500        10010   30,000.00     16
   500        10014   34,000.00     16
   500        10015   40,000.00     16
   500        10004   42,000.00     18
   500        10012   56,000.00     20
        -----------
Count(EmpNo)      7
                     ----------
        Sum(Salary)  268,000.00
   
                 Average(EdLev)     18
   
   600        10007   45,000.00     16
   600        10006   29,000.00     12
   600        10019   28,600.00     12
   600        10013   44,000.00     16
        -----------
Count(EmpNo)      4
                     ----------
        Sum(Salary)  146,600.00
   
                 Average(EdLev)     14
   
   700        10021   45,000.00     16
   700        10020   30,000.00     16
   700        10022   38,000.00     16
        -----------
Count(EmpNo)      3
                      ----------
         Sum(Salary)  113,000.00
   
                 Average(EdLev)     16

例2 – マクロによって出力されるTITLEDASHES

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

ECHO '.SET TITLEDASHES OFF 3';
SELECT deptno, empno, salary, edlev
FROM employee
WITH COUNT(empno) BY deptno
WITH SUM(salary) BY deptno
WITH AVG(edlev) BY deptno;