出力データの TRUNCATE および STRIP オプションの指定

特定のタイプのデータについては、出力データの長さよりも短い出力フィールドに、 データをアンロードすることができます。このデータの切り捨ては、TRUNCATE オプションが 明示的に指定されたときにだけ行われます。最初に CCSID 変換が行われ、 次に出力用にエンコードされたデータに対して、切り捨てが行われます。

ビット・ストリングに対しては、切り捨てはバイト境界で行われます。 文字タイプ・データに対しては、切り捨ては文字境界で行われます (マルチバイト文字は分割されません)。 大/小文字混合タイプのデータが固定サイズの出力フィールドで切り捨て られた場合は、切り捨てられたストリングは指定されたフィールドのサイズよりも短くなる可能性があります。 このような場合は、出力 CCSID でブランクが右側に埋め込まれます。 大/小文字混合タイプ・フィールドの出力データが EBCDIC である場合、 切り捨てが行われるとき、DBCS サブストリングを囲む SO (シフトアウト) と SI (シフトイン) 文字は、 保持されます。

UNLOAD ユーティリティーの TRUNCATE オプションはストリング・データを切り捨てるもので あり、SQL TRUNCATE スカラー関数とは目的が異なります。

VARCHAR、VARGRAPHIC、および VARBINARY 出力フィールド に対しては、TRUNCATE オプションに加えて、指定された文字、 先行ブランクまたは末尾ブランク (あるいはその両方) を除去するために、STRIP オプションが 提供されています。除去操作は、出力用にエンコードされたデータに適用され ます。TRUNCATE と STRIP の両方のオプションが指定されている場合は、 最初に切り捨てが行われ、その後にストリップが適用されます。 例えば、VARCHAR(5) 出力フィールドに対して TRUNCATE オプションと STRIP オプションが指定されている UNLOAD ジョブの出力は、 次の表のようになります。 この表では、下線は除去される文字を表しています。 どの場合でも、ソース・ストリングが最初に '_ABC_' (VARCHAR(5) フィールドに収まる 5 文字のストリング) に 切り捨てられ、次に、ストリップの操作が適用されます。

表 1. UNLOAD で、TRUNCATE と STRIP の両方のオプションを指定した場合の結果
指定された STRIP
オプション
ソース・ストリング 切り捨てられたストリング 出力ストリング 指定された length
STRIP BOTH
'_ABC_DEF'
'_ABC_'
'ABC'
3
STRIP LEADING
'_ABC_DEF'
'_ABC_'
'ABC_'
4
STRIP TRAILING
'_ABC_DEF'
'_ABC_'
'_ABC'
4

次の制御ステートメントは、STRIP オプションの使用例を 示します。

この例では STRIP TRAILING '_' が、TEXT 列のフィールド仕様に含まれています。 TEXT 列は、VARCHAR(8) の指定による、最大長 8 文字の 可変長文字データを含みます。この UNLOAD ユーティリティーでは、 表をアンロードするときに、TEXT 列のデータの終わりにある「_」(下線) 文字 のすべてのオカレンスをデータから削除します。

    UNLOAD TABLESPACE DB.TS
           PUNCHDDN SYSPUNCH
           UNLDDN UNLDD2
           FROM TABLE TB
             (EMPNO    POSITION(*)  CHAR(6),
              TEXT     POSITION(*)  VARCHAR(8) STRIP TRAILING '_',
              DEPTNO   POSITION(*)  CLOB(4),
              ROWID    POSITION(*)  ROWID,
              LAST_UPDATE   POSITION(*)  TIME EXTERNAL)

以下の表で、STRIP オプションについて詳細に説明します。

表 2. UNLOAD の STRIP オプションを指定した結果の例
元のデータ STRIP 指定 除去後のデータ 最終長
'_ABC_' STRIP LEADING '_' 'ABC_' 4
'_ABC_' STRIP TRAILING '_' '_ABC' 4
'_ABC_' STRIP BOTH '_' 'ABC' 3