UNLOAD 制御ステートメントの構文とオプション

UNLOAD ユーティリティー制御ステートメントは、複数のオプションを使用して、 ユーティリティー・ジョブが実行する機能を定義します。

制御ステートメントは、ISPF/PDF 編集機能を使って作成することができます。 制御ステートメントを作成した後、それを順次データ・セットまたは区分データ・セットに 保管します。 ジョブを実行するための JCL を作成するときは、SYSIN DD ステートメントを使用して、ユーティリティー 制御ステートメントを格納するデータ・セットの名前を指定してください。

構文図

>>-UNLOAD------------------------------------------------------->

                                .-------------------------.     
                                V                         |     
>--+-DATA--| from-table-spec |----+---------------------+-+-+--->
   |                              '-| from-table-spec |-'   |   
   |                  .-------------------------.           |   
   |                  V                         |           |   
   +-| source-spec |----+---------------------+-+-----------+   
   |                    '-| from-table-spec |-'             |   
   '-LIST--listdef-name-------------------------------------'   

>--| unload-spec |--+-------+----------------------------------><
                    '-CLONE-'   

source-spec:

>>-TABLESPACE--+----------------+-tablespace-name--------------->
               '-database-name.-'                   

>--+------------------------+----------------------------------->
   '-PART-+-integer-------+-'   
          '-int1--:--int2-'     

>--+---------------------------------------------------------------------------+-><
   +-FROMCOPY--data-set-name--+----------------------------------------------+-+   
   |                          '-FROMVOLUME-+-CATALOG-----------------------+-' |   
   |                                       '-vol-ser--+------------------+-'   |   
   |                                                  |              (1) |     |   
   |                                                  '-FROMSEQNO--n-----'     |   
   '-FROMCOPYDDN--ddname-------------------------------------------------------'   

注:
  1. FROMSEQNO オプションは、カタログされていないテープ・データ・セット から、イメージ・コピーをアンロードする場合に必要となります。

unload-spec:

   .-PUNCHDDN--SYSPUNCH----------.   
>>-+-----------------------------+------------------------------>
   '-PUNCHDDN--+-ddname--------+-'   
               '-template-name-'     

   .-UNLDDN--SYSREC------------.                
>--+---------------------------+--+---------+------------------->
   '-UNLDDN--+-ddname--------+-'  +-EBCDIC--+   
             '-template-name-'    +-ASCII---+   
                                  '-UNICODE-'   

>--+----------------------+--+--------+--+-------+-------------->
   |        .-,-------.   |  '-NOSUBS-'  '-NOPAD-'   
   |        V         |   |                          
   '-CCSID(---integer-+-)-'                          

   .-SPANNED--NO--.                         
>--+--------------+--+------------------+----------------------->
   '-SPANNED--YES-'  '-FORMAT--INTERNAL-'   

>--+-----------------------------------------------------------------------+-->
   |            .-COLDEL--','----.  .-CHARDEL--'"'-----.  .-DECPT--'.'---. |   
   '-DELIMITED--+----------------+--+------------------+--+--------------+-'   
                '-COLDEL -coldel-'  '-CHARDEL -chardel-'  '-DECPT--decpt-'     

   .-FLOAT--S390-.  .-MAXERR--1-------.   
>--+-------------+--+-----------------+------------------------->
   '-FLOAT--IEEE-'  '-MAXERR -integer-'   

   .-SHRLEVEL--CHANGE--ISOLATION--CS--+------------------+-.   
   |                                  '-SKIP LOCKED DATA-' |   
>--+-------------------------------------------------------+---->
   '-SHRLEVEL-+-CHANGE--ISOLATION--UR-+--------------------'   
              '-REFERENCE-------------'                        

>--+-----------------------------------------+------------------>
   '-DECFLOAT_ROUNDMODE--+-ROUND_CEILING---+-'   
                         +-ROUND_DOWN------+     
                         +-ROUND_FLOOR-----+     
                         +-ROUND_HALF_DOWN-+     
                         +-ROUND_HALF_EVEN-+     
                         +-ROUND_HALF_UP---+     
                         '-ROUND_UP--------'     

>--+--------------------------------+--------------------------->
   '-IMPLICIT_TZ--'timezone-string'-'   

   .-PARALLEL--0------------.   
>--+------------------------+----------------------------------><
   '-PARALLEL--num-subtasks-'   

FROM-TABLE-spec:

FROM-TABLE-spec の構文図およびオプションの説明については、セクションUNLOAD 制御ステートメントの構文とオプションで説明しています。

オプションの説明

DATA
from-table-spec 内の table-name で アンロードに選択されるデータを指定します。DATA キーワードは、TABLESPACE、PART、LIST キーワードと一緒には指定できません。

DATA キーワードを指定するか、TABLESPACE もしくは LIST キーワードを 省略する場合は、FROM TABLE 文節を少なくとも 1 つ指定する必要があります。

TABLESPACE
データのアンロード元の、表スペース (およびオプションで、それが 属しているデータベース) を指定します。
database-name
表スペースが属するデータベースの名前。 名前には、DSNDB01 または DSNDB07 は使用できません。

デフォルト値は、DSNDB04 です。

tablespace-name
データのアンロード元の、表スペースの名前。指定する表スペースは LOB 表スペース または XML 表スペースであってはなりません。
PART
データのアンロード元の、パーティションまたはパーティションの範囲を示します。 このキーワードは、指定された表スペースがパーティション化されている場合のみ適用され ます。PART は LIST と一緒には指定できま せん。最大は 4096 です。
整数
変更の始まり単一のパーティションを指定し ます。integer は、表スペース内の既存の物理パーティション番号を示している必要があります。変更の終わり
int1:int2
変更の始まり物理パーティション番号 int1 から物理パーティション番号 int2 までのパーティションの範囲を指定します。 int1 は、表スペース内の最大のパーティション番号より小さい、正の整数でなければなりません。 int2 は、int1 よりも 大きく、最大のパーティション番号以下の整数でなければなりません。変更の終わり

UNLOAD 制御ステートメントに PART キーワードが指定されていない場合は、 表スペース全体のデータが単一のアンロード・データ・セットにアンロードされます。

FROMCOPY data-set-name
データがイメージ・コピー・データ・セットからアンロードされることを示し ます。FROMCOPY を指定すると、UNLOAD ユーティリティーは指定されたイメージ・コピー・データ・セットのみを 処理します。 代わりに、複数のイメージ・コピー・データ・セットが単一の DD 名で連結できる場合 は、FROMCOPYDDN キーワードが使用できます。
data-set-name
単一のイメージ・コピー・データ・セットの名前を指定します。
FROMVOLUME
イメージ・コピー・データ・セットのあるボリュームを示します。
CATALOG
データ・セットがカタログされることを示します。 このオプションは、カタログ式データ・セットとして作成されたイメージ・コピーの場合にのみ 使用します (このことは、そのボリューム通し番号は SYSIBM.SYSCOPY に記録されていないことを 意味しています)。
vol-ser
データ・セットを、その最初のボリュームの、英数字ボリューム通し番号 ID で示します。 このオプションは、非カタログ式データ・セットとして作成されたイメージ・コピーの場合 にのみ使用します。1 つのデータ・セットが 複数のテープ・ボリュームに保管されている場合にそのデータ・セットを 位置指定するには、SYSCOPY レコードの最初の vol-ser を指定します。
FROMSEQNO n
イメージ・コピー・データ・セットを、そのファイル・シーケンス番号で示します。 FROMSEQNO オプションは、カタログされていないテープ・データ・セット から、イメージ・コピーをアンロードする場合に必要となります。
n
ファイル・シーケンス番号を指定します。
FROMCOPYDDN ddname
データは、指定された ddname に関連した 1 つ以上 のイメージ・コピー・データ・セットからアンロードされることを示します。 複数のイメージ・コピー・データ・セット (主に部分的なコピー) を、単一の DD 名の 下に連結できます。
DD 名 (ddname)
1 つ以上のイメージ・コピー・データ・セットの関連先の DD 名を示します。
LIST listdef-name
LISTDEF ユーティリティー制御ステートメントで定義されたオブジェクトのリストの名前を 示します。このリストには、表スペース、データベース、表、索引、およびパーティションを 含めることができます。このリストには、索引スペース、LOB 表スペース、およびディレクトリー・オブジェクトを 含めることはできません。LIST オプションを 使用してイメージ・コピー・データ・セットを指定することはできません。
LIST オプションを 使用すると、参照される LISTDEF は以下のものを指定します。
  • データのアンロード元の表スペース。LISTDEF のパターン・マッチング機能を使用できます。
  • 表スペースがパーティション化されている場合、データのアンロード元のパーティション (LISTDEF ステート メントの INCLUDE、EXCLUDE、および PARTLEVEL キーワードによって定義されます)。

UNLOAD ユーティリティーは、パーティションの並列処理がアクティブになっている場合を除き、 単一の表スペースを複数の出力データ・セットに関連付けます。 複数の表スペースを表す LISTDEF に LIST オプションを使用する場合は、すべての表スペースに 対応した TEMPLATE も定義し、template-name を UNLDDN オプション で指定する必要があります。

LOAD ステートメントを生成する場合は、UNLDDN に類似した、PUNCHDDN データ・セット用に 別の TEMPLATE を定義する必要があります。Db2® は、次に、表スペースごとに LOAD ステートメントを 1 つ生成します。CLONE キーワードが指定されている場合、このユーティリティーはクローン・データのみを処理します。 LISTDEF ステートメントで CLONED YES を使用するのでは不十分です。

パーティションまたは パーティション範囲をリストに指定できます。

PUNCHDDN
UNLOAD ユーティリティーが生成する LOAD ユーティリティー制御ステートメントを 受け取るために、1 つ以上のデータ・セット名を定義するデータ・セット DD 名 またはテンプレート名を指定します。
DD 名 (ddname)
DD 名を指定します。

デフォルト値は、SYSPUNCH です。

template-name
TEMPLATE ユーティリティー制御ステートメントで定義されたデータ・セット・テンプレート の名前を示します。

指定された名前が、DD 名 (JCL で) としても、またテンプレート名 (TEMPLATE ステートメントで) と しても定義されている場合は、その名前は DD 名として扱われます。

複数の表スペースに対して UNLOAD ユーティリティーを 実行して、対応する複数の LOAD ステートメントを生成する場合は、 生成されるすべての LOAD ステートメントを Db2 が保持 できるように、表スペースに対応する複数の出力データ・セットを用意しなければなりません。この場合、PUNCHDDN に 適切なテンプレート名を指定する必要があります。PUNCHDDN 指定を省略すると、LOAD ステートメントは 生成されません。

パーティション変数 (&PART. または &PA.) が TEMPLATE の PUNCHDDN に含まれている 場合、Db2 は &PART. または &PA 変数を、 アンロードされるパーティションのリストのうち最小のパーティション番号で置き換えます。 パーティション番号の形式は nnnnn です。

UNLDDN
データ・セットの DD 名を指定するか、あるいはデータをアンロードする先の 1 つ以上のデータ・セット名 を定義するテンプレート名を指定します。
DD 名 (ddname)
DD 名を指定します。

デフォルト値は SYSREC です。

template-name
TEMPLATE ユーティリティー制御ステートメントで定義されたデータ・セット・テンプレート の名前を示します。

指定された名前が、DD 名 (JCL で) としても、またテンプレート名 (TEMPLATE ステートメントで) と しても定義されている場合は、その名前は DD 名として扱われます。

UNLOAD ユーティリティーをパーティション表スペースに対して実行する際、 以下の条件が満たされる場合は、選択されたパーティションは並列にアンロードされます。

  1. UNLDDN でテンプレート名を指定。
  2. テンプレートのデータ・セット名は、サブストリング表記なしの変数 (&PART. または &PA.) と してパーティションを含む。 このテンプレート名は、選択されたパーティションに対応する複数のデータ・セットに拡張されます。
  3. TEMPLATE 制御ステートメントは、以下のすべてのオプションを含んでいない。
    • STACK(YES)
    • UNIT(TAPE)
    • 1 以下の UNCNT 値

条件 1 と条件 2 は満たされても、条件 3 が満たされない場合は、パーティションの並列処理 はアクティブにはならず、出力データ・セットはすべて 1 つのテープにスタックされます。

DSN 引数にパーティション変数 (&PART. または &PA.) のサブストリング表記を使用すると、データ・セット名がすべてのパーティションに対して固有でなくなる可能性があるので、Db2 はパーティションに対して並列 UNLOAD 操作を実行できません。 そのため、Db2 は &PA の値を「00000」に設定し、すべてのパーティションに単一の UNLDDN データ・セットを使用します。このアクションは、同じ表スペースの他のパーティションの後続の UNLOAD ジョブで、データ・セット重複エラーを発生させることがあります。

複数の表スペースに対して UNLOAD ユーティリティーを実行した場合は、 出力レコードは、それぞれの表スペースに対応するデータ・セットに入れられます。 したがって、出力データ・セットは物理的に異なっている必要があり、 適切なテンプレート名を UNLDDN で指定する必要があり ます。UNLDDN 指定を省略すると、SYSREC DD 名は使用されず、エラーが発生します。

パーティション 変数 (&PART. または &PA.) が TEMPLATE DSN ステートメントに含まれていて、 パーティション並列処理が利用不能である場合 (ソースが非 パーティション化表スペースまたはイメージ・コピーの場合) は、その変数は実際のデータ・セット名 では '00000' に置換されます。この場合、警告メッセージ DSNU1252I が 発行され、UNLOAD ユーティリティーは戻りコード 4 を戻します。

EBCDIC
文字タイプの出力データはすべて EBCDIC であることを指定します。 これと異なるエンコード化スキームがソース・データで使用された場合は、 データ (ビット・ストリングを除く) は EBCDIC に変換されます。

EBCDIC、ASCII、UNICODE、CCSID のいずれも指定しない場合は、 ソース・データのエンコード化スキームが保持されます。

このユーティリティーの CCSID オプションの説明を参照してください。

ASCII
文字タイプの出力データはすべて ASCII であることを指定します。 これと異なるエンコード化スキームがソース・データで使用された場合は、 データ (ビット・ストリングを除く) は ASCII に変換されます。

EBCDIC、ASCII、UNICODE、CCSID のいずれも指定しない場合は、 ソース・データのエンコード化スキームが保持されます。

このユーティリティーの CCSID オプションの説明を参照してください。

UNICODE
文字タイプ (ビット・ストリングを除く) の出力データが、すべてユニコードであることを 指定します。 これと異なるエンコード化スキームがソース・データで使用された場合は、 データはユニコードに変換されます。

EBCDIC、ASCII、UNICODE、CCSID のいずれも指定しない場合は、 ソース・データのエンコード化スキームが保持されます。

このユーティリティーの CCSID オプションの説明を参照してください。

CCSID(integer1,integer2,integer3)
コード化文字セット ID (CCSID) を最大 3 つまで指定します。 これは、出力レコードの文字タイプのデータ (外部文字フォーマットでアンロードされるデータも含む) に 使用されます。

integer1 は、SBCS データの CCSID を指定します。 integer2 は、混合データの CCSID を指定します。 integer3 は、DBCS データの CCSID を指定します。 このオプションは、サブタイプが BIT のデータには適用されません。

FORMAT DELIMITED と UNICODE の両方を指定した場合は、出力データはすべて CCSID 1208、UTF-8 に なります。その他の指定された CCSID はいずれも無視されます。

また、次の指定も有効です。

CCSID(integer1)
SBCS CCSID のみが指定されていることを示します。
CCSID(integer1,integer2)
SBCS CCSID と混合 CCSID が指定されていることを示します。
integer
有効な CCSID または 0 のいずれかを指定します。

引数の 1 つに 0 を指定するか値を省略した場合は、EBCDIC、ASCII、または UNICODE によって 指定されたコード化スキームは、対応するデータ・タイプ (SBCS、MIXED、または DBCS) であると見なされ ます。

EBCDIC、ASCII、 UNICODE のいずれも指定しない場合は、次のようになります。

  • ソース・データが文字タイプの場合、元のエンコード化スキームが保持される。
  • 数値、日付、時刻、またはタイム・スタンプ・データから変換された文字ストリングの場合、 表のデフォルトのエンコード化スキームが使用される。詳しくは、 CREATE TABLE ステートメントの CCSID オプションを参照してください。

EBCDIC、ASCII、または UNICODE を指定する場合、SBCS、DBCS、および MIXED に指定する CCSID は、指定したコード化スキームで有効な CCSID であるか、または 0 でなければなりません。

CCSID 変換が要求されると、CCSID 文字置換が出力ストリングで起こる可能性があり ます。CCSID 変換の際に起こり得る文字置換を防ぐために、NOSUBS オプションを使用してください。

NOSUBS
アンロード処理の際に、CCSID コード置換が行われないことを指定します。

ある CCSID から別の CCSID にストリングが変換される場合 (EBCDIC、 ASCII、およびユニコードを含む)、 置換文字が出力ストリングに入れられることがあります。 例えば、ソース CCSID に存在する文字 (コード・ポイントと呼ばれる) がターゲット CCSID には 存在しない場合、この置換が起こります。NOSUBS キーワードを使用すると、UNLOAD ユーティリティーに この置換をさせないようにすることができます。

NOSUBS キーワードを指定し、データのアンロード中に文字を置換しようとすると、 このアクションは変換エラーと見なされます。 エラーのあるレコードはアンロードされず、処理は、エラー件数の合計が MAXERR で指定された数 になるまで継続します。

NOPAD
アンロードされたレコードの可変長列は、実際のデータ長を占めており、追加の埋め込みは ないことを指定します。結果として、アンロードまたは廃棄されたレコードの長さが 可変長になることがあります。 ファイル参照変数を使用しないで XML 列をアンロードする場合は、NOPAD が デフォルトです。

NOPAD を指定しない場合は、次のようになります。

  • UNLOAD のデフォルトの処理では、アンロードされたレコードの可変長列はその最大長まで 埋め込みが行われ、アンロードされたレコードの長さは、それぞれの表ごとに同じになる。
  • 埋め込みなしの実際のデータ・サイズを示す長さフィールドが、埋め込みデータ・フィールドの前にある。
  • LOAD ユーティリティーを用いて出力レコードを再ロードする場合は、 埋め込みデータ・フィールドは可変長データとして扱われる。

DELIMITED を指定した場合は、可変長列では NOPAD オプションがデフォルトになります。 固定長列では、通常の埋め込み規則が適用されます。

LOAD ユーティリティーは、NOPAD オプションを使用してアンロードまたは廃棄された可変長列を持つレコードを処理しますが、このようなレコードは、定位置にあるフィールドのみを処理する アプリケーションでは処理できません。 例えば、EMP サンプル表用に生成される LOAD ステートメント は、図 1 に示されている LOAD ステートメントと似たものに なるはずです。

SPANNED
スパン・レコード・フォーマットでレコードを VBS データ・セットにアンロードするのかどうかを指示します。
YES
レコードはスパン・レコード・フォーマットでアンロードされます。

SPANNED YES を指定する場合、ソース・オブジェクトおよび UNLOAD ステートメントは以下の要件を満たしている必要があります。

  • ソース表には、少なくとも 1 つの XML 列または LOB 列が必要です。 表に XML 列も LOB 列も存在しない場合、SPANNED YES は無視されます。
  • 複数の FROM TABLE ステートメントを指定して複数の表をアンロードする場合、すべての表に少なくとも 1 つの LOB 列または XML 列が含まれている必要があります。 これが含まれていない場合、どの表もスパン・レコード・フォーマットではアンロードされません。
  • 変更の始まりUNLOAD ステートメントには、レコードの最後にすべての LOB データと XML データを指定するフィールド指定リストを含める必要があります。 LOB 列および XML 列のデータ・タイプを指定する必要があります。LOB 列および XML 列の長さまたは POSITION 値は含めないでください。 フィールド指定が含まれていないか、フィールド指定にデータ・タイプが含まれていない場合、SPANNED YES は無視されます。変更の終わり
  • 以下のオプションは、SPANNED YES と一緒に指定しないでください。
    • DELIMITED
    • FROMCOPY または FROMCOPYDDN
    • LIST (LIST を指定すると、SPANNED YES は無視されます。)

変更の始まりSPANNED YES が無視される場合、アンロード・データ・セットは、32 KB を超えるレコードを許可しない VB (可変長ブロック化) レコード・フォーマットで作成されます。変更の終わり

SPANNED YES を指定する場合、UNLOAD は以下のアクションも実行します。

  • データ・セットの RECFM 属性を無視します。
  • NOPAD オプションを使用します。
  • TRUNCATE オプションを無視します。
  • 変更の始まりいずれかの出力データ・セットによってラージ・ブロック・インターフェース (LBI) が使用されていても、LBI を無視します。変更の終わり

PUNCHDDN も指定した場合、生成された LOAD ステートメントは、LOB データおよび XML データを、UNLOAD フィールド指定リストと同じ順序でフィールド指定リストにリストします。

NO
レコードはスパン・レコード・フォーマットではアンロードされません。
FORMAT INTERNAL
出力レコード・フォーマットが Db2 内部フォーマットであることを指定します。UNLOAD は、フィールド・プロシージャー処理、データ変換、データに対する CCSID 変換を行いません。 UNLOAD 制御ステートメントにフィールド指定が含まれている場合、それは無視されます。
FORMAT INTERNAL が指定されている場合
  • UNLOAD は、LOB 列や XML 列のデータをアンロードしません。 UNLOAD は、LOB や XML のデータがアンロードされなかったことを示す警告メッセージを出します。
  • UNLOAD は、可変長列からの出力に末尾ブランクを追加しません。
  • UNLOAD は、データを圧縮解除し、編集プロシージャーによって指定されたデコードを行います。
  • UNLOAD は、UNLOAD ユーティリティー制御ステートメント内のフィールド指定を無視します。
制約事項:
  • FORMAT INTERNAL によってアンロードされたデータのロード先は、同じ表、または同じフィールド・プロシージャーを持つなどアンロードされた表定義と正確に一致する表に限定されます。
  • FORMAT INTERNAL は、以下のいずれかのオプションと一緒に指定できません。
    • ASCII
    • CCSID
    • DECFLOAT_ROUNDMODE
    • DELIMITED
    • EBCDIC
    • FLOAT
    • HEADER
    • NOPAD
    • NOSUBS
    • UNICODE
DELIMITED
出力データ・ファイルが区切り文字で区切られた形式であることを指定します。区切り文字で区切られた 形式のデータの場合、出力データ・セット内のすべてのフィールドは、 文字ストリング値または外部数値です。さらに、区切り文字で区切られたファイルのそれぞれの列は、列区切り文字によって 次の列と分離されています。

指定できるそれぞれの区切り文字タイプについて、区切り文字がターゲット・データのコード・ページで 指定されているようにしなければなりません。 区切り文字は、文字定数または 16 進定数のいずれでも指定することができます。 例えば、# を区切り文字として指定するには、COLDEL '#' または COLDEL X'23' のいずれか を指定できます。 ユーティリティー・ステートメントが出力ファイルとは異なる文字タイプでコード化されている 場合 (例えば、ユーティリティー・ステートメントは EBCDIC、出力データはユニコードでコード化 されている)、ユーティリティー・ステートメントでの区切り文字は 16 進定数として指定してください。 そのように指定しない場合は、結果は予測不能となります。

複数の区切り文字のタイプ (COLDEL、CHARDEL、および DECPT) に対して、同じ文字を 指定することはできません。

FORMAT DELIMITED オプションを指定した場合:

  • HEADER CONST を指定したり、複数の FROM TABLE ステートメントを使用することはできません。
  • UNLOAD は、UNLOAD ユーティリティー制御ステートメント内で指定された POSITION ステートメントは、いずれも無視します。

区切り文字で区切られた出力の場合、NOPAD オプションを指定しなくても、UNLOAD は可変長列に 末尾の埋め込みブランクは追加しません。 固定長列では、通常の埋め込み規則が適用されます。 例えば、VARCHAR(10) フィールドに ABC が入っている場合、UNLOAD DELIMITED は、 このフィールドを "ABC" としてアンロードします。 ただし、CHAR(10) フィールドに ABC が入っている場合は、UNLOAD DELIMITED は、 このフィールドを "ABC " としてアンロードします。

区切り文字で区切られた出力の使用および区切り文字の制約事項について は、区切り文字で区切られたファイルのアンロードを参照してください。 区切り文字で区切られたファイルの詳細については、区切り文字で区切られたファイル形式を 参照してください。
COLDEL
出力ファイルで使用する列の区切り文字を指定します。 デフォルトは、コンマ (,) です。ほとんどの ASCII と UTF-8 データの場合、この値は X'2C' であり、ほとんどの EBCDIC データの場合、この値は X'6B' です。
CHARDEL
出力ファイルで使用する文字ストリング区切り文字を指定します。 デフォルトは二重引用符 (") です。ほとんどの ASCII と UTF-8 データの場合、この値は X'22' であり、ほとんどの EBCDIC データの場合、この値は X'7F' です。

UNLOAD ユーティリティーは、すべての文字ストリングの前後に、CHARDEL 文字を追加します。 文字ストリング区切り文字を含む文字ストリングを区切るには、UNLOAD ユーティリティーは、 文字ストリングでそれが使用されているところで、文字ストリング区切り文字を繰り返します。 これによって、LOAD ユーティリティーは、区切り文字で囲まれている間で検出された区切り文字の ペアは、単一の文字と解釈します。 例えば、what a "nice warm" day という句は、 "what a ""nice warm"" day" としてアンロードされ、LOAD はこれを what a "nice warm" day と解釈します。UNLOAD ユーティリティーは、CHAR、VARCHAR、CLOB のフィールドでのみ、これらの区切り文字の ペアを認識します。

DECPT
出力ファイルで使用する小数点文字を指定します。 デフォルトはピリオド (.) です。 ほとんどの ASCII と UTF-8 データの場合、この値は X'2E' であり、 ほとんどの EBCDIC データの場合、この値は X'4B' です。
FLOAT
数値浮動小数点データの出力フォーマット式を指定します。 このオプションは、2 進出力フォーマットに対してのみ適用されます。
S390
2 進浮動小数点データを S/390® 内部形式 (16 進浮動小数点 (HFP) とも呼ばれる) で 出力レコードに書き込むことを示します。
IEEE
2 進浮動小数点データを IEEE 形式 (2 進浮動小数点、すなわち、BFP とも呼ばれている) で 出力レコードに書き込むことを示します。
MAXERR integer
許されるエラー・レコードの最大数を指定します。この値に 達すると、アンロード処理が終了します。
整数
許されるエラー・レコードの最大数を指定します。エラー件数が この数に達すると、UNLOAD ユーティリティーは DSNU1219 メッセージを出し、 戻りコード 8 で終了します。

デフォルト値は 1 です。 これは、最初のエラーが発生した時点で UNLOAD が停止することを意味します。0 または任意の負の数を指定すると、エラーのレコード数に関係なく、実行が継続されます。

複数の表スペースを処理する場合、それぞれの表スペースごとにエラーのレコード数を カウントします。LIST オプションを使用すると、UNLOAD ステートメントの前に、OPTION ユーティリティー 制御ステートメント (ITEMERROR を伴う EVENT オプション) を追加して、 エラーのある表スペースをスキップして、後続の表スペースを処理するように指定することができます。

MAXERR オプションは、UNLOAD ユーティリティーのデータ処理の続行を妨げるエラーが検出された場合に無視されます。 例えば、ファイル参照変数を使用して LOB や XML データをアンロードする際にメッセージ DSNU283I、SQLCODE -452、および理由コード 7 を受け取った場合、MAXERR に指定された値とは関係なく UNLOAD ユーティリティーが終了します。

SHRLEVEL
データのアンロード中に他の処理が表スペースまたはパーティションをアクセスあるいは 更新できるかどうか指定します。

ソース・オブジェクトがイメージ・コピー・データ・セットの場合は、UNLOAD は SHRLEVEL 指定を無視します。

デフォルト値は SHRLEVEL CHANGE ISOLATION CS です。

CHANGE
データのアンロード中に、表スペースまたはパーティションの行の読み取り、挿入、更新、 または削除を実行できることを指定します。
ISOLATION
SHRLEVEL CHANGE での分離レベルを指定します。
CS
UNLOAD ユーティリティーは、カーソル固定モードで行を読み取ることを示します。CS を 指定すると、UNLOAD ユーティリティーは CURRENTDATA(NO) と想定します。
UR
コミットされていない行が存在する場合は、アンロードすることを示します。 アンロード操作の実行は、データのアンロード元のオブジェクトに対して適用される 他の Db2 操作 からごくわずかな干渉を受けます。
SKIP LOCKED DATA
他のトランザクションによって非互換ロックが保持されている行を UNLOAD ユーティリティーが スキップすることを指定します。このオプションは、行レベルまたはページ・レベルのロックにのみ適用されます。
REFERENCE
アンロード操作の間、他の Db2 スレッドが、表の行の読み取りを 行えるが、挿入、更新、削除を実行できないことを指定します。

SHRLEVEL REFERENCE を指定すると、UNLOAD ユーティリティーは、 データのアンロード元の表スペースの書き込みプログラムをドレーンします。 データを複数のパーティションからアンロードする場合は、UTILINIT フェーズで選択された すべてのパーティションについて、ドレーンはロックされます。

DECFLOAT_ROUNDMODE
DECFLOAT が操作されるときに使用される丸めモードを指定します。 以下の丸めモードがサポートされています。
ROUND_CEILING
正の無限大方向に丸めます。破棄される桁は、すべてゼロであるか、符号が負である場合は除去 されます。それ以外の場合、結果係数は 1 だけ増やされます (切り上げ)。
ROUND_DOWN
0 方向に丸めます (切り捨て)。 破棄される数字は無視されます。
ROUND_FLOOR
負の無限大方向に丸めます。破棄される桁は、すべてゼロであるか、正である場合は除去 されます。それ以外の場合、符号は負になり、結果係数は 1 だけ増やされます (切り上げ)。
ROUND_HALF_DOWN
最も近い値に丸めます。等距離の場合、切り捨てます。破棄される桁が 0.5 より大きい場合、結果係数は 1 だけ 増やされます (切り上げ)。破棄される桁は 0.5 以下の場合は 無視されます。
ROUND_HALF_EVEN
最も近い値に丸めます。等距離である場合は、最後の数字が偶数になるように 丸めます。破棄される桁が .05 より大きい場合、結果係数は 1 だけ 増やされます (切り上げ)。破棄される桁は 0.5 より小さい場合は 無視されます。結果係数が .05 で、右端の数字が偶数である 場合、結果係数は変わりません。結果係数が .05 で、右端の数字が 奇数である場合、結果係数は 1 だけ増やされます (切り上げ)。
ROUND_HALF_UP
最も近い値に丸めます。等距離の場合、切り上げます。破棄される桁が 0.5 以上の場合、結果係数は 1 だけ 増やされます (切り上げ)。それ以外の場合、破棄された数字は無視されます。
ROUND_UP
0 から離れる方向へ丸めます。破棄される桁がすべて 0 の場合、 結果は変わりません。それ以外の場合、結果係数は 1 だけ増やされます (切り上げ)。

ユーザーが DECFLOAT_ROUNDMODE を 指定しない場合、DECFLOAT_ROUNDMODE オプションのデフォルト値は DECP からの DECFLOAT ROUNDING MODE です。

IMPLICIT_TZ
時間帯を含まない TIMESTAMP 列からタイム・スタンプ値をアンロードする 場合であり、その列のフィールド仕様が TIMESTAMP WITH TIME ZONE EXTERNAL である 場合に使用する、暗黙の時間帯を指定します。
'timezone-string'
暗黙的な時間帯値を指定します。時間帯は、現地時間と UTC 間の差 (時分単位) です。時間の範囲は -12 から 14 で構成され、分は 00 から 59 で構成されます。 時間帯は、-12:59 から +14:00 の範囲の値を使用して、±th:tm の形式で指定されます。

時間帯列がないアンロードのタイム・スタンプを時間帯列があるタイム・スタンプで使う場合は、IMPLICIT_TZ は必須キーワードです。

変更の始まりPARALLEL変更の終わり
変更の始まり

パーティション化表スペースのアンロードを処理するために並列で使用するサブタスクの最大数を指定します。 PARALLEL キーワードを省略した場合、サブタスクの最大数は、 アンロードされているパーティション数によって制限されます。

(num-subtasks)

並列処理するサブタスクの最大数を指定します。値は 0 から 32767 の整数でなければなりません。num-subtasks の指定値が 32767 より大きい場合、UNLOAD ステートメントは失敗します。 num-subtasks の値が 0 であるか、または指定されていない場合、 UNLOAD ユーティリティーは、制約を適用した後の並列サブタスクの最適数を使用します。 num-subtasks に指定された値が、計算された最適な数より大きい場合、UNLOAD ユーティリティーは並列サブタスクの数を、最適な数に制限します。

PARALLEL で指定されるサブタスク数は PARAMDEG_UTIL サブシステム・パラメーターの指定を常にオーバーライドするため、PARALLEL を PARAMDEG_UTIL の値より小さくすることも、大きくすることもできます。

変更の終わり
CLONE
指定された表スペース内のクローン表のみから UNLOAD がデータを ロードすることを指定します。CLONE キーワードが指定されている場合、このユーティリティーはクローン・データのみを処理します。 LISTDEF ステートメントで CLONED YES を使用するのでは不十分です。FROM TABLE 文節にクローン表の名前を 指定する場合、CLONE キーワードを指定する必要はありません。

FROM-TABLE-spec の 構文図およびオプションの説明

UNLOAD ユーティリティーを 1 回呼び出すだけで、 表スペースごとに複数の表またはパーティションをアンロードすることができます。 以下のことを示すために、アンロードするそれぞれの表ごとに 1 つの FROM TABLE ステートメントが必要です。

  • 行のアンロード元の、表名
  • HEADER オプションを使用して、表からアンロードする行に関連する表を示すフィールド
  • 表の行のサンプリング・オプション
  • アンロードする列を選択するための表のフィールド指定リスト
  • WHEN 文節で指定され、表からアンロードする行を修飾する選択条件

FROM TABLE ステートメントによって指定されるすべての表は、 同じ表スペースに属している必要があります。 特定の表から行をアンロードする場合、FROM TABLE 文節をそれぞれのソース表ごとに指定する必要があります。 表スペースに対して FROM TABLE 文節を指定しない場合は、その表スペースのすべての行がアンロードされます。

フィールド仕様のリストを使用して、以下の特性を指定します。

  • 列選択。アンロードする表の列名を指定します。フィールド指定のリストが与えられると、 リストされた列だけがアンロードされます。
  • 列順序。出力レコードに入れるフィールドの順序を指定します。フィールド指定のリストが 与えられると、リストされた列のデータは、リストされた列名の順番にアンロードされます。
  • 出力フィールドの属性と形式。出力レコードのデータ・タイプ、長さ、およびデータの形式を指定します。

フィールド仕様のリストを省略すると、ソース表のすべての列が、その表で定義されている 順番にアンロードされます。 列のデータ・タイプに対応するデフォルトの出力フィールド・タイプが使用されます。

XML 列または LOB 列を VBS データ・セットに アンロードすると、LOB 値および XML 値は、必要なフィールド仕様リストの指定 に従い、その値の列定義の順序でレコードの最後に書き込まれます。 この順序は、VBS データ・セットから XML 値および LOB 値を 読み取るときに LOAD ユーティリティーが使用する順序と同じです。

FROM TABLE 文節では、括弧は、フィールド選択リスト全体を囲む場合と WHEN 選択の文節の場合の 2 つ のケースでのみ使用できます。 この括弧の使い方によって、フィールド選択リストで使用されるキーワードとフィールド名が矛盾する 可能性を排除できます。FROM TABLE 文節指定の有効な例を次に示します。

UNLOAD …
  FROM TABLE tablename SAMPLE x (c1,c2) WHEN (c3>0)

LIST オプションが既に指定されている場合は、FROM TABLE は指定できません。

FROM-TABLE-spec

>>-FROM--TABLE--table-name-------------------------------------->

   .-HEADER--OBID-------------------------.   
>--+--------------------------------------+--------------------->
   '-HEADER--+-NONE---------------------+-'   
             '-CONST--+-'string'------+-'     
                      '-X'hex-string'-'       

>--+------------------+--+----------------+--------------------->
   '-SAMPLE-- decimal-'  '-LIMIT--integer-'   

>--+-----------------------------+------------------------------>
   |   .-,-------------------.   |   
   |   V                     |   |   
   '-(---field-specification-+-)-'   

>--+-----------------------------+-----------------------------><
   '-WHEN--(selection-condition)-'   

field-specification:

               .-POSITION(*)-----.   
>>-field-name--+-----------------+------------------------------>
               '-POSITION(start)-'   

>--+--------------------------------------------------------------------+-><
   +-CHAR-+----------+-+-------------------------------------------+----+   
   |      '-(length)-' +-TRUNCATE----------------------------------+    |   
   |                   '-+-DBCLOBF-+--template-name--+-----------+-'    |   
   |                     +-CLOBF---+                 '-BINARYXML-'      |   
   |                     '-BLOBF---'                                    |   
   +-VARCHAR-+----------+-+-------------------------------------------+-+   
   |         '-(length)-' +-strip-spec--------------------------------+ |   
   |                      '-+-DBCLOBF-+--template-name--+-----------+-' |   
   |                        +-CLOBF---+                 '-BINARYXML-'   |   
   |                        '-BLOBF---'                                 |   
   +-GRAPHIC-+----------+-+----------+-+----------+---------------------+   
   |         '-EXTERNAL-' '-(length)-' '-TRUNCATE-'                     |   
   +-VARGRAPHIC-+----------+-strip-spec---------------------------------+   
   |            '-(length)-'                                            |   
   +-SMALLINT-----------------------------------------------------------+   
   +-INTEGER--+-----------------------+---------------------------------+   
   |          '-EXTERNAL-+----------+-'                                 |   
   |                     '-(length)-'                                   |   
   +-BIGINT-------------------------------------------------------------+   
   +-BINARY-+----------+-+----------+-----------------------------------+   
   |        '-(length)-' '-TRUNCATE-'                                   |   
   +-+-VARBINARY------+-------------------------------------------------+   
   | '-BINARY VARYING-'                                                 |   
   +-strip-spec---------------------------------------------------------+   
   |          .-PACKED---.                                              |   
   +-DECIMAL--+----------+--+----------------------+--------------------+   
   |          +-ZONED----+  |         .-,0-----.   |                    |   
   |          '-EXTERNAL-'  '-(length-+--------+-)-'                    |   
   |                                  '-,scale-'                        |   
   +-FLOAT-+----------+-+----------+------------------------------------+   
   |       '-EXTERNAL-' '-(length)-'                                    |   
   +-DOUBLE-------------------------------------------------------------+   
   +-REAL---------------------------------------------------------------+   
   +-DATE--EXTERNAL--+----------+---------------------------------------+   
   |                 '-(length)-'                                       |   
   +-TIME--EXTERNAL--+----------+---------------------------------------+   
   |                 '-(length)-'                                       |   
   +-TIMESTAMP--EXTERNAL--+----------+----------------------------------+   
   |                      '-(length)-'                                  |   
   +-timestamp with time zone-spec--------------------------------------+   
   +-CONSTANT--+-'string'------+----------------------------------------+   
   |           '-X'hex-string'-'                                        |   
   +-ROWID--------------------------------------------------------------+   
   +-BLOB-+----------+-+----------+-------------------------------------+   
   |      '-(length)-' '-TRUNCATE-'                                     |   
   +-CLOB-+----------+-+----------+-------------------------------------+   
   |      '-(length)-' '-TRUNCATE-'                                     |   
   +-DBCLOB-+----------+-+----------+-----------------------------------+   
   |        '-(length)-' '-TRUNCATE-'                                   |   
   +-decfloat-spec------------------------------------------------------+   
   '-XML--+-----------+-------------------------------------------------'   
          '-BINARYXML-'                                                     

strip spec:

>>-+-------------------------------------------+---------------->
   |        .-BOTH ----.                       |   
   '-STRIP--+----------+--+------------------+-'   
            +-TRAILING-+  |              (1) |     
            '-LEADING--'  +-'strip-char'-----+     
                          '-X'strip-char'----'     

>--+----------+------------------------------------------------><
   '-TRUNCATE-'   

注:
  1. VARGRAPHIC、BINARY、または VARBINARY を 指定する場合は、'strip-char' を指定できません。 X'strip-char' のみを指定できます。

timestamp with time zone spec:

>>-TIMESTAMP WITH TIME ZONE--EXTERNAL--+----------+------------><
                                       '-(length)-'   

decfloat spec:

             .-(34)-------------------.   
>>-DECFLOAT--+------------------------+------------------------><
             +-(16)-------------------+   
             '-EXTERNAL--+----------+-'   
                         '-(length)-'     

selection condition:

>>-+-predicate-------------+------------------------------------>
   '-(selection-condition)-'   

   .------------------------------------.   
   V                                    |   
>----+-AND-+--+-----------------------+-+----------------------><
     '-OR--'  +-predicate-------------+     
              '-(selection-condition)-'     

predicate:

>>-+-basic predicate---+---------------------------------------><
   +-BETWEEN predicate-+   
   +-IN predicate------+   
   +-LIKE predicate----+   
   '-NULL predicate----'   

basic predicate:

>>-column-name--+-=--+--+-constant--------------------+--------><
                +-<>-+  '-labeled-duration-expression-'   
                +->--+                                    
                +-<--+                                    
                +->=-+                                    
                '-<=-'                                    

BETWEEN predicate:

>>-column-name--+-----+--BETWEEN-------------------------------->
                '-NOT-'            

>--+-constant--------------------+--AND------------------------->
   '-labeled-duration-expression-'        

>--+-constant--------------------+-----------------------------><
   '-labeled-duration-expression-'   

IN predicate:

                               .-,--------.     
                               V          |     
>>-column-name--+-----+--IN--(---constant-+-)------------------><
                '-NOT-'                         

LIKE predicate:

>>-column-name--+-----+--LIKE--string-constant------------------>
                '-NOT-'                          

>--+-------------------------+---------------------------------><
   '-ESCAPE--string-constant-'   

NULL predicate:

>>-column-name--IS--+-----+--NULL------------------------------><
                    '-NOT-'         

labeled-duration-expression:

>>-+-CURRENT_DATE--------------------------+-------------------->
   '-CURRENT_TIMESTAMP--+----------------+-'   
                        '-WITH TIME ZONE-'     

   .-------------------------------------.   
   V                                     |   
>----+- + -+--constant--+-YEAR---------+-+---------------------><
     '- - -'            +-YEARS--------+     
                        +-MONTH--------+     
                        +-MONTHS-------+     
                        +-DAY----------+     
                        +-DAYS---------+     
                        +-HOUR---------+     
                        +-HOURS--------+     
                        +-MINUTE-------+     
                        +-MINUTES------+     
                        +-SECOND-------+     
                        +-SECONDS------+     
                        +-MICROSECOND--+     
                        '-MICROSECONDS-'     

FROM TABLE のオプションの説明

table-name
行のアンロード元であり、かつ、FROM TABLE 文節のオプションが 適用される Db2 表を 指定します。

表名がスキーマ名で修飾されていない 場合、ユーティリティー・ジョブ・ステップの呼び出し側の許可 ID が、 表名のスキーマ修飾子として使用されます。名前にブランクが含まれている場合は、表名を引用符で囲みます。

ドロップされた表を FROM TABLE オプションに指定すると、UNLOAD ユーティリティーは戻りコード 4 で終了します。

HEADER
出力レコードの先頭に、定数ヘッダー・フィールドを指定します。 これを使用すると、出力レコードとそのアンロード元の表とを関連付けることができます。

ヘッダー・フィールドを指定した場合は、生成される LOAD ステートメントに ある WHEN 文節 (INTO INTO-TABLE 指定の一部) のフィールド選択基準として、 このフィールドが使用されます。

OBID
表のオブジェクト ID (OBID、2 バイトの 2 進数値) を、 表からアンロードされた出力レコードの最初の 2 バイトに入れることを指定します。

HEADER オプションを省略すると、区切り文字で区切られたファイル以外 は、HEADER OBID がデフォルトになります。

HEADER OBID を用いると、アンロードされたデータは、出力レコードの最初の 2 バイト は使用できません。例えば、次の UNLOAD ステートメントがあるとします。

UNLOAD …
  FROM TABLE table-name HEADER OBID …

上記の UNLOAD ステートメントは、次の例のような LOAD ステートメントを生成します。

LOAD …
  INTO TABLE table-name WHEN (1:2)=X'hh' …

この 例で、X'hh' は、表 table-name の OBID の 16 進表記です。

NONE
レコード・ヘッダー・フィールドが作成されないことを示します。 区切り文字で区切られているファイルの場合、HEADER NONE がデフォルト値です。

FROM TABLE 文節で HEADER NONE が指定されると、生成される LOAD ステートメントの、 対応する INTO TABLE 文節には WHEN 指定がありません。 したがって、複数の表から行がアンロードされ、1 つ以上の FROM TABLE 文節で HEADER NONE が 指定されている場合は、生成された LOAD ステートメントを編集しないと、それらの表からアンロード された行は再ロードできません。生成されたステートメントを直接、LOAD ユーティリティーと 一緒に使用すると、結果は予測できないものとなります。

CONST
レコード・ヘッダーとして定数ストリングが使用されることを指定します。与えられた ストリング・オペランドによって、ヘッダー・フィールドの長さが決まります。 ストリング値は、1 組の単一引用符の文字で囲む必要があります。

例えば、次の UNLOAD ステートメントがあるとします。

UNLOAD …
  FROM TABLE table-name HEADER CONST 'abc' …

上記の UNLOAD ステートメントは、次の例のような LOAD ステートメントを生成します。

LOAD …
  INTO TABLE table-name WHEN (1:3)='abc' …

この例では、与えられたストリングは、SBCS EBCDIC 形式であると想定してい ます。HEADER フィールドの出力ストリングは、指定されたコード化スキームまたはデフォルトのコード化スキームになります。 出力に使用されるコード化スキームが EBCDIC でない場合は、与えられたストリングが出力レコード に入る前に、そのストリングに対して SBCS CCSID 変換が適用されます。 出力 SBCS コード化スキームが EBCDIC でない場合は、生成される LOAD ステートメント の WHEN 条件には、16 進ストリングを含んでいます。

16 進数形式 X'hex-string' を使用してストリング定数を 表すこともできます。SBCS EBCDIC 以外のコード化スキームで CONST ストリング値を指定する場合は、16 進形式を使用して ください。16 進形式を使用する場合は、CCSID 変換は行われません。

SAMPLE decimal
表のサンプリングされた行だけがアンロードされることを示します。 同じ FROM TABLE 文節内で WHEN 文節によって選択条件が指定されている場合、 サンプリングは、WHEN 選択条件によって限定された行に対して行われます。
decimal
サンプリングされる行のパーセントを 10 進数形式で指定します。 精度は ddd.dddd で、有効範囲は 0 <= decimal <= 100 です。
サンプリングが行われる行数を N とすると、次のようになります。
  • decimal × N / 100 行がアンロードされる。(小数部分は、最も近い整数に丸められます。)
  • decimal > 0 かつ N > 0 の場合、 少なくとも 1 行がアンロードされる。
  • decimal = 100 の場合は、表からすべての行がアンロードされる。
  • decimal = 0 または N = 0 が指定された場合は、 表から行はアンロードされない。

サンプリングはそれぞれの表ごとに行われます。 サンプリング可能な状態で、複数の表から行がアンロードされると、 表の間の参照整合は失われる可能性があります。

LIMIT integer
表からアンロードされる最大行数を指定します。アンロードされた行数が指定された限度に達すると、その表に対してメッセージ DSNU1201 が出され、 行はそれ以上、表からアンロードされません。 処理は継続され、別の表から限定行がアンロードされます。

パーティションの並列処理がアクティブ化されている場合は、LIMIT オプションは、 表全体ではなく、それぞれのパーティションに対して適用されます。

整数
表からアンロードされる最大行数を示します。指定された数がゼロ以下であれば、行は表からアンロードされません。

SAMPLE オプションと同じように、LIMIT オプションが指定された上で複数の表がアンロードされると、 表の間の参照整合が失われる可能性があります。

field-name
ソース表にあるべき列名を示します。
POSITION(start)
出力レコードでのフィールドの位置を指定します。

位置のパラメーターは、以下のように指定します。

*
アスタリスクは、フィールドが、直前のフィールドの終わりの位置の次のバイトから 始まることを示します。
start
正の整数で、データ・フィールドの開始列を示します。

デフォルト値は POSITION(*) です。

出力レコードの最初の列 (バイト位置) は、POSITION(1) となり ます。FROM TABLE 文節で HEADER NONE を指定すると、HEADER オプションによって指定された項目は、 表からアンロードされたすべてのレコードの先頭に置かれます。 レコード・ヘッダーのスペースを考慮する必要があります。

  • HEADER OBID (デフォルト) の場合: 位置 1 から 2 バイト。
  • HEADER CONST 'string' または X'hex-string' の場合: 位置 1 から、 指定されたストリングの長さ。

ソース表 の列が NULL 可能の場合は、ユーティリティーは NULL 標識バイトを 出力レコードのデータ・フィールドの先頭に置きます。BLOBF、CLOBF、 または DBCLOBF 列の場合、NULL 値はファイル名の先頭の 1 バイトで 示されます。start パラメーター (または *) は、NULL 標識バイトの位置を指します。 生成される LOAD ステートメントで、start は (start+1 のように) 1 バイト右に シフトされるため、LOAD ステートメントでは、POSITION オプションの start パラメーター は、NULL 標識バイトの後のバイトを指します。

可変長フィールドの場合、長さフィールドが実際のデータ・フィールドの前にあり ます (該当する場合、NULL 標識バイトの後に)。BLOBF、CLOBF、または DBCLOBF 列の場合、そのファイル名の先頭の 2 バイトがファイル名の長さを示します。値を NULL にできない場合、start パラメーター (または *) は、長さフィールドの最初のバイトを指します。 長さフィールドのサイズは 4 バイト (BLOB、CLOB、または DBCLOB)、 または 2 バイト (VARCHAR または VARGRAPHIC) です。

POSITION オプションの start パラメーターを使用して (または * 形式を使用して)、 出力フィールドの位置を明示的に指定した場合は、出力フィールドの一部として以下の項目を 考慮する必要があります。
  • フィールドの値が NULL 可能の場合、NULL 標識バイト用のスペース。
  • 可変長データの場合、長さフィールド用のスペース (2 バイトまたは 4 バイトのいずれか)。

出力フィールドのレイアウトでは、POSITION オプション、NULL 標識バイト、 可変長フィールドの長さ、length パラメーター、および実際のデータ長の結びつきを フィールドのレイアウトで示しています。

POSITION オプションは、出力レコードの特定の位置に出力フィールドを置く必要がある場合に役に立ちます。 ただし、POSITION パラメーターを使用すると、出力データ・フィールドのサイズを制限することに なります。NULL 可能で可変長のフィールドに対して明示的に start パラメーターを指定する場合は、 慎重に行ってください。 出力レコードでより短いスペースにデータ項目を入れるために、TRUNCATE オプションの指定 (該当する場合) が 必要になることもあります。

最初のフィールドについて POSITION オプションを省略すると、 フィールドは、HEADER NONE が指定されていれば、位置 1 から始まります。 省略しない場合は、フィールドは、レコード・ヘッダー・フィールドの次のバイト位置から始まります。 後続のフィールドで POSITION を省略すると、そのフィールドは、直前のフィールドの終わりの位置の次に、 ギャップなしで置かれます。

NOPAD が指定されており、特定のフィールドで POSITION パラメーターを 指定すると、start パラメーター (デフォルトの * 以外) のあるフィールドは 常に出力レコードの決まった位置から始まるため、NOPAD オプションの効果がなくなることがあります。

区切り文字で区切られた出力ファイルでは、POSITION オプションは無視されます。

CHAR
出力フィールドは、固定長の文字タイプであることを示し ます。CHAR の代わりに CHARACTER を使用しても構いません。 ソース表の列が NULL 可能の場合は、区切り文字で区切られていない出力ファイルでは、 出力フィールドの先頭に NULL 標識バイトが置かれます。

EBCDIC、ASCII、UNICODE、または CCSID オプションを指定した場合、 指定したオプションに対応する出力データは、ソース・データ (SBCS または MIXED) の サブタイプに応じて、CCSID でエンコードされます。サブタイプが BIT の場合は、 変換は行われません。

(length)
出力データのサイズをバイトで指定します。

この後に BLOBF、CLOBF、または DBCLOBF が続いている場合、length は、 展開されたテンプレート名のサイズ (バイト) を指定します。

length パラメーター が省略されている場合、デフォルトは、ソース表列に定義された最大長になるか、 CHAR キーワードの後に BLOBF、CLOBF、または DBCLOBF が続いている場合は展開後のテンプレート名の長さ (バイト) になります。 length パラメーターが指定されると、次のようになります。
  • length が表の列のサイズより小さい場合、TRUNCATE キーワードが指定されていれば、 データは length の長さに切り捨てられます。そうでなければ、変換エラーが発生します。
  • 直後に BLOBF、CLOBF、または DBCLOBF が続いている場合、 length が展開後のテンプレート名のサイズより小さいとエラー が発生します。
  • length が表の列のサイズより大きい場合、 出力フィールドは、指定された長さになるまで、デフォルトの埋め込み文字が埋め込まれます。
BLOBF
この出力フィールドに、BLOB または XML が CCSID 変換なしでアンロードされる先のファイルの 名前が入ることを指定します。
BINARYXML。XML 文書が、Extensible Dynamic Binary XML Db2 Client/Server Binary XML Format (バイナリー XML) 形式でファイル参照変数を使用してアンロードされることを指定します。このオプションは、XML 列のアンロード時にのみサポートされます。
CLOBF
この出力フィールドに、必要な CCSID 変換を伴って CLOB または XML がアンロードされる先のファイルの 名前が入ることを指定します。
DBCLOBF
この出力フィールドに、必要な CCSID 変換を伴って DBCLOBF または XML がアンロードされる先のファイルの 名前が入ることを指定します。
TRUNCATE
データが出力レコード中のこのフィールドで使用可能なスペースに収まらない場合に、文字ストリング (出力用にエンコードされた後) が 右側から切り捨てられることを指示します。切り捨ては、文字境界で行われます。UNLOAD ユーティリティーで使用する切り捨ての規則については、出力データの TRUNCATE および STRIP オプションの指定を参照してくだ さい。TRUNCATE の指定がない場合は、出力フィールドのサイズがデータにとって小さすぎると、エラーが発生します。
VARCHAR
出力フィールドが可変長の文字タイプであることを指定します。 データの長さをバイトで表した 2 バイトの 2 進数フィールドが、データ・フィールドの前に 付加されます。 表列が NULL 可能の場合は、区切り文字で区切られていない出力ファイルでは、 この長さフィールドの前に NULL 標識バイトが置かれます。

EBCDIC、ASCII、UNICODE、または CCSID オプションを指定した場合、 指定したオプションに対応する出力データは、ソース・データ (SBCS または MIXED) の サブタイプに応じて、CCSID でエンコードされます。サブタイプが BIT の場合は、 変換は行われません。

(length)
実際のデータ・フィールドの最大長をバイトで指定します。また、NOPAD も指定している場合は、 出力レコードのデータの最大許容スペースを示します。指定していないない場合は、 指定した長さのスペースがデータ用に確保されます。

この後に BLOBF、CLOBF、または DBCLOBF が続いている場合、length は、 展開されたテンプレート名のサイズ (バイト) を指定します。この長さが、展開されたテンプレート名の サイズより小さい場合、エラーが発生します。

length パラメーターを省略した場合は、デフォルトは、255 とソース表の列で定義した最大長の 中、小さい方になります。

BLOBF
この出力フィールドに、BLOB または XML が CCSID 変換なしでアンロードされる先のファイルの 名前が入ることを指定します。
BINARYXML。XML 文書が、バイナリー XML 形式でファイル参照変数を使用してアンロードされることを指定します。このオプションは、XML 列のアンロード時にのみサポートされます。
CLOBF
この出力フィールドに、必要な CCSID 変換を伴って CLOB または XML がアンロードされる先のファイルの 名前が入ることを指定します。
DBCLOBF
この出力フィールドに、必要な CCSID 変換を伴って DBCLOBF または XML がアンロードされる先のファイルの 名前が入ることを指定します。
STRIP
UNLOAD がデータの先頭、末尾、または両端から、2 進ゼロを除去 (デフォルト) または指定された ストリングを除去することを指定します。UNLOAD は、VARCHAR の長さフィールド (出力フィールドの) を、除去された後のデータ長に 調整します。

ソース・データのサブタイプが BIT であれば、STRIP オプションが適用できます。この場合、指定 されたストリップ文字に対しては ('strip-char' の形式で指定されていても)、CCSID 変換は 実行されません。

STRIP オプションの効果は、SQL STRIP スカラー関数の場合と同じです。

BOTH
UNLOAD は、データの先頭および末尾から、ブランクまたは指定された除去文字があれば 除去することを示します。 デフォルトは、BOTH です。
TRAILING
UNLOAD は、データの末尾から、ブランクまたは指定された除去文字があれば 除去することを示します。
LEADING
UNLOAD は、データの先頭から、ブランクまたは指定された除去文字があれば 除去することを示します。
'strip-char'
除去される 1 バイト文字を指定します。 この文字の値は EBCDIC で指定してください。UNLOAD は、strip-char 値が除去操作 で使用される前に、出力コード化スキームに応じて、SBCS CCSID 変換を適用し ます。EBCDIC 以外のコード化スキームで strip-char 値を指定する場合 は、16 進形式を使用してください。UNLOAD は、16 進形式が使用されている場合は、CCSID 変換は行いません。
X'strip-char'
除去される 1 バイト文字を指定します。 これは、16 進形式 X'hex-string' で指定することができます。ここで、hex-string は、 単一の SBCS 文字を表す 2 つの 16 進文字です。strip-char オペランドが省略されている場合は、デフォルトはブランクであり、以下の ように指定します。
  • X'40' -- 出力が EBCDIC コード化スキームの場合
  • X'20' -- 出力が ASCII コード化スキームの場合
  • X'20' -- 出力がユニコード・コード化スキームの場合

出力文字のコード化スキームがソース・データで定義されたコード化スキームと異なる場合は、 除去操作は、文字コード変換の後で適用されます。 したがって、除去文字を 16 進形式で指定する場合は、出力で使用されるコード化スキームでその文字を 指定する必要があります。

TRUNCATE
データが出力レコード中のこのフィールドで使用可能なスペースに収まらない場合に、文字ストリング (出力用にエンコードされた後) が 右側から切り捨てられることを指示します。切り捨ては、文字境界で行われます。UNLOAD ユーティリティーで使用する切り捨ての規則については、出力データの TRUNCATE および STRIP オプションの指定を参照してくだ さい。TRUNCATE の指定がない場合は、出力フィールドのサイズがデータにとって小さすぎると、エラーが発生します。
GRAPHIC
出力フィールドが固定長のグラフィック・タイプであることを指定します。 表列が NULL 可能の場合は、区切り文字で区切られていない出力ファイルでは、 実際のデータ・フィールドの前に NULL 標識バイトが置かれます。

出力が EBCDIC の場合、データの先頭と末尾に、シフトインとシフトアウト文字は入りません。

(length)
DBCS 文字数を指定します (出力データ・サイズのバイト数は、指定された長さの 2 倍です)。 指定された length がソース・データの長さより大きい場合は、 出力フィールドはデフォルトの埋め込み文字で埋め込まれます。
TRUNCATE
グラフィック文字ストリング (出力用にエンコード) は、データが、 出力レコードのフィールドで使用可能なスペースに収まらない場合は、右側から切り捨てられることを示します。 切り捨ては、文字 (DBCS) 境界で行われます。TRUNCATE の指定がない場合は、出力フィールドのサイズがデータにとって小さすぎると、エラーが発生します。
GRAPHIC EXTERNAL
データを、外部形式のグラフィック・タイプの固定長フィールドとして 出力レコードに書き込むことを指定します。すなわち、シフトアウト (SO) 文字が開始位置に、 シフトイン (SI) 文字が終了位置に置かれます。 この出力フィールドのバイト・カウントは、常に偶数です。

GRAPHIC EXTERNAL は EBCDIC 出力モード (デフォルトで、 または EBCDIC キーワードが指定されている場合) でのみサポートされます。

POSITION オプションの start パラメーターを使用して、出力の列位置を指定する場合、 このフィールドの先頭にある (挿入された) シフトアウト文字を指します。 シフトイン文字は、データの最後の 2 バイト文字の次のバイト位置に置かれます。

(length)
DBCS 文字数を指定します。ただし、シフト文字 (CREATE TABLE ステートメントで 使用されるグラフィック・タイプ列定義と同様) も、ソース列が NULL 可能の場合は NULL 標識バイトも除き ます。length パラメーターを省略した場合は、デフォルトの出力フィールドのサイズは、 対応する表の列で定義された長さに、2 バイト (シフトアウト文字とシフトイン文字) を加えたものになります。

指定された length がデータのサイズより大きい場合、 フィールドの右側にデフォルトの DBCS 埋め込み文字が埋め込まれます。

TRUNCATE
データが出力レコード中のこのフィールドで使用可能なスペースに収まらない場合に、グラフィック文字ストリング (出力用にエンコードされている) が DBCS 文字単位で右側から切り捨てられることを指示します。TRUNCATE の指定がない場合は、出力フィールドのサイズが データにとって小さすぎると、エラーが発生します。 また、TRUNCATE オプションの指定では、使用可能なスペースが 4 バイト (GRAPHIC EXTERNAL フィールド では、シフトアウト文字、1 つの DBCS、およびシフトイン文字の 4 バイトが最小サイズ) よりも小さいか、 あるいはフィールドが NULL 可能の場合は 5 バイト (4 バイトと NULL 標識バイト) よりも小さい場合にも、 エラーが発生します。
VARGRAPHIC
出力フィールドが可変長のグラフィック・タイプであることを指定し ます。2 バイトのバイナリーの長さフィールドが、実際のデータ・フィールドの前に付加されます。 表列が NULL 可能の場合は、区切り文字で区切られていない出力ファイルでは、 この長さフィールドの前に NULL 標識バイトが置かれます。
(length)
実際のデータ・フィールドの最大長を DBCS 文字数で指定します。また、NOPAD も指定している場合は、 出力レコードのデータの最大許容スペースを示します。指定していないない場合は、 指定した長さのスペースがデータ用に確保されます。

length パラメーターを省略した場合は、デフォルトは、そのソース表の列で定義された最大長と、127 の いずれか小さい方となります。

STRIP
アンロードされたデータから UNLOAD が 2 進ゼロを除去 (デフォルト) または 指定されたストリングを除去することを指示します。UNLOAD は、VARGRAPHIC の長さフィールド (出力フィールドの) を、除去された 後のデータ (DBCS 文字数) の長さに調整します。

STRIP オプションの効果は、SQL STRIP スカラー関数の場合と同じです。

BOTH
UNLOAD は、データの先頭および末尾から、ブランクまたは指定された除去文字があれば 除去することを示します。 デフォルトは、BOTH です。
TRAILING
UNLOAD は、データの末尾から、ブランクまたは指定された除去文字があれば 除去することを示します。
LEADING
UNLOAD は、データの先頭から、ブランクまたは指定された除去文字があれば 除去することを示します。
X'strip-char'
除去される DBCS 文字を 16 進形式 X'hhhh' で指定します。 ここで、hhhh は、1 個の DBCS 文字を 表す 4 つの 16 進文字です。このオペランドが省略されている場合、デフォルトは、出力のコード化スキームの DBCS ブランク です (例えば、出力が EBCDIC コード化スキームの場合は X'4040'、 CCSID 301 の場合は X'8140')。

出力文字のコード化スキームがソース・データで定義されたコード化スキームと異なる場合は、 除去操作は、文字コード変換の後で適用されます。 したがって、除去文字を指定する場合は、出力で使用するコード化スキームで指定する必要があります。

TRUNCATE
グラフィック文字ストリング (出力用にエンコード) は、データが、 出力レコードのフィールドで使用可能なスペースに収まらない場合は、右側から切り捨てられることを示します。切り捨ては、DBCS 文字境界で行われます。TRUNCATE の指定がない場合は、出力フィールドのサイズがデータにとって小さすぎると、エラーが発生します。
SMALLINT
出力フィールドが 2 バイトの 2 進整数 (負の数は 2 の補数表記) であることを指定します。 外部形式を使用する場合は、INTEGER EXTERNAL を指定します。

ソース・データ・タイプが INTEGER、DECIMAL、FLOAT、BIGINT、または DECFLOAT (4 バイト形式または 8 バイト形式のいずれか) の場合、データが 32 767 より大きいか -32 768 より小さいと、エラーが発生します。

SMALLINT 出力フィールドには 2 バイトが必要であり、length オプションは使用できません。

INTEGER
出力フィールドが 4 バイトの 2 進整数 (負の数は 2 の補数表記) であることを指定します。

元のデータ・タイプが DECIMAL、FLOAT、BIGINT、または DECFLOAT (4 バイト形式または 8 バイト形式のいずれか) の場合、元のデータが 2 147 483 647 より大きいか -2 147 483 648 より小さいと、エラーが発生します。

INTEGER 出力フィールドには 4 バイトが必要であり、length オプションは使用できません。

INTEGER EXTERNAL
出力フィールドに整数を表す文字ストリングが入ることを指定します。
(length)
符号文字用のスペースを含む、出力データのサイズをバイトで指定し ます。length の指定があり、文字表記がスペースに収まらない場合は、エラーが起こります。 デフォルトは 20 文字 (符号文字用のスペースを含む) となります。

値が負の場合、負符号が数字の前に付きます。 出力フィールド・サイズがデータの長さより大きい場合は、出力データは左寄せにされ、 右側にブランクが埋め込まれます。

ソース・データ・タイプが DECIMAL、FLOAT (4 バイト形式または 8 バイト形式のいずれか)、または DECFLOAT (8 バイト形式または 16 バイト形式のいずれか) の場合、元のデータが 9 223 372 036 854 775 807 より大きいか -9 223 372 036 854 775 808 より小さいと、エラーが発生します。

BIGINT
出力フィールドが 8 バイトの 2 進整数 (負の数は 2 の補数表記) であることを指定します。 外部形式を使用する場合は、INTEGER EXTERNAL を指定します。

元のデータ・タイプが DECIMAL、FLOAT、または DECFLOAT (4 バイト形式または 8 バイト形式のいずれか) の場合、元のデータが 9 223 372 036 854 775 807 より大きいか -9 223 372 036 854 775 808 より小さいと、エラーが発生します。

BINARY(length)
出力フィールドが固定長のバイナリー・ストリングであることを 指定します。ソース表の列が NULL 可能である場合、 区切り文字で区切られていない出力ファイルでは、この出力フィールドの先頭に NULL 標識バイトが置かれます。 このフィールドには、データ変換は適用されません。 X'strip-char' のデフォルトは 16 進 ゼロ (X'00') です。
TRUNCATE
データが出力レコード中のフィールドで使用可能なスペースに収まらない場合に、出力バイナリー・ストリング (出力用にエンコードされた後) が 右側から切り捨てられることを指示します。TRUNCATE の指定がない場合は、出力フィールドのサイズがデータにとって小さすぎると、エラーが発生します。
VARBINARY
出力フィールドが可変長のバイナリー・ストリングであることを 指定します。データの長さをバイトで表した 2 バイトの 2 進数フィールドが、データ・フィールドの前に 付加されます。表の列が NULL 可能である場合、区切り文字で区切られていない出力ファイルでは、 長さフィールドの前に NULL 標識バイトが置かれます。このフィールドには、データ変換は適用されません。 X'strip-char' のデフォルトは 16 進 ゼロ (X'00') です。
STRIP
UNLOAD がデータの先頭、末尾、または両端から、2 進ゼロを除去 (デフォルト) または指定された ストリングを除去することを指定します。UNLOAD は、VARBINARY の長さフィールド (出力フィールドの) を、 除去された後のデータ長に調整します。
BOTH
UNLOAD がデータの先頭および末尾から 2 進ゼロまたは指定された除去文字を 除去することを指示します。 デフォルトは、BOTH です。
TRAILING
UNLOAD がデータの末尾から 2 進ゼロまたは指定された除去文字を 除去することを指示します。
LEADING
UNLOAD がデータの先頭から 2 進ゼロまたは指定された除去文字を 除去することを指示します。
X'strip-char'
除去される 1 バイト文字を指定します。 これは、16 進形式 X'hex-string' でのみ指定することができます。ここで、hex-string は、 単一の SBCS 文字を表す 2 つの 16 進文字です。
TRUNCATE
データが出力レコード中のこのフィールドで使用可能なスペースに収まらない場合に、バイナリー・ストリング (出力用にエンコードされた後) が 右側から切り捨てられることを指示します。TRUNCATE の指定がない場合は、出力フィールドのサイズがデータにとって小さすぎると、エラーが発生します。
DECIMAL
出力データが、示されている 10 進数形式 (PACKED、ZONED、または EXTERNAL のいずれか) で 表された数値であることを指定します。 キーワード DECIMAL を単独で指定した場合は、パック 10 進数形式と見なされます。
PACKED
出力データが、パック 10 進数形式で表された数値であることを指定し ます。DEC または DEC PACKED をキーワードの省略形として使用できます。

数値のパック 10 進数表記は ddd...ds の形式です。 ここで、d は 4 ビットで表される 10 進数で、s は 4 ビットの 符号文字 (正の数の場合は 16 進数の A、C、E、または F であり、負の数の場合は 16 進数の B または D) です。

長さ
出力フィールドに置かれる桁数 (符号の桁を含まず) を指定し ます。length は、1 から 31 の間でなければなりません。length が奇数の場合は出力データ・ フィールドのサイズは (length+1) / 2 バイトであり、 偶数の場合は (length / 2)+1 バイトとなります。

ソース・データ・タイプが DECIMAL で、length パラメーターが省略されている場合、 デフォルトの長さは、その表で定義された列の属性によって決まります。 それ以外の場合は、デフォルトの長さは 31 桁 (16 バイト) です。

scale
小数点の右側の桁数を指定します。(この場合、小数点は出力フィールドには含まれないことに 注意してください。) この値は、ゼロ以上の整数であり、length 以下でなければなりません。

デフォルトは表で定義された列の属性によって異なります。 ソース・データ・タイプが DECIMAL の場合、定義された scale 値が デフォルト値です。それ以外の場合、デフォルト値は 0 です。

出力フィールド・サイズをデータの長さより小さい値に指定すると、エラーが起こります。指定された フィールド・サイズがデータの長さより大きい場合、X'0' が左に埋め込まれます。

ZONED
出力データが、ゾーン 10 進数形式で表された数値であることを指定し ます。DEC ZONED をキーワードの省略形として使用できます。

数値のゾーン 10 進数表記は znznzn...z/sn です。 ここで、n は 4 ビットの 10 進数 (数値ビットと呼ばれる) を表し、z は 数値のゾーン (1 バイトの左 4 ビット) です。s は右端のオペランドであり、 これはゾーン (z) または符号値 (正の数の場合、16 進数の A、C、E、または F であり、 負の数の場合、16 進数の B または D) になります。

長さ
出力フィールドに置かれるバイト数 (すなわち、10 進数の桁数) を指定し ます。length は、1 から 31 の間でなければなりません。

ソース・データ・タイプが DECIMAL で、length パラメーターが省略されている 場合、デフォルトの length は、その表で定義された列の属性によって決まります。 それ以外の場合は、デフォルトの長さは 31 バイトです。

scale
小数点の右側の桁数を指定します。(この場合、小数点は出力フィールドには含まれないことに 注意してください。) この値は、ゼロ以上の整数であり、length 以下でなければなりません。

デフォルトは表で定義された列の属性によって異なります。 ソース・データ・タイプが DECIMAL の場合、定義された scale 値が デフォルト値です。それ以外の場合、デフォルト値は 0 です。

出力フィールド・サイズをデータの長さより小さい値に指定すると、エラーが起こります。指定された フィールド・サイズがデータの長さより大きい場合、X'F0' が左に埋め込まれます。

EXTERNAL
出力データが、±dd...d.ddd...d の形式の数値を表す 文字ストリングであることを指定します。ここで、d は 0 ~ 9 の数字 です。(正の値の正符号は、省略されます。)
長さ
出力データ全体の長さ (符号、および scale が指定されている場合は小数点も含めた文字数) を 指定します。

ソース・データ・タイプが DECIMAL で、length パラメーターが省略されている 場合、デフォルトの length は、その表で定義された列の属性によって決まります。 それ以外の場合は、デフォルトの length は 33 (31 桁の数字に符号と小数点) です。 length の最小値は 3 であり、符号と 1 桁の数字および小数点が入ります。

scale
小数点の右側の桁数を指定します。 その数値はゼロ以上の整数であり、length - 2 以下である必要があります (符号文字と 小数点を入れるため)。

ソース・データ・タイプが DECIMAL で、length パラメーターが省略されている 場合、デフォルトの scale は、その表で定義された列の属性によって決まります。そうでない場合、 デフォルト値は 0 です。

値の文字表現が、指定されている、またはデフォルトのフィールド・サイズ (精度) に 収まらない場合は、エラーが起こります。ソース・データ・タイプが浮動小数点であり、 データ項目が scale で定義された精度に対して小さすぎる場合、 ゼロの値が戻されます (エラー値ではない)。

FLOAT(length)
出力データは、2 進浮動小数点 (length が 1 から 21 の間に含まれる場合は 32 ビット、 つまり単精度 FLOAT であり、length が 22 から 53 の間に含まれる場合は 64 ビット、 つまり倍精度 FLOAT) であることを指定し ます。length パラメーターが省略された場合は、64-bit ビット形式と 見なされます (出力フィールド・サイズは 8 バイトになり ます)。FLOAT タイプの length パラメーターは、フィールド・サイズをバイトでは表さない ことに注意してください。

2 進浮動小数点出力の形式は、グローバルの FLOAT オプションによって制御されます。デフォルト は S/390 フォーマット (16 進浮動小数点 (HFP) です。FLOAT(IEEE) を指定した場合は、2 進浮動小数点出力は すべて、IEEE 形式 (2 進浮動小数点、BFP (Binary Floating Point)) になり ます。FLOAT(IEEE) を指定して、ソース・データ・タイプ DOUBLE を REAL としてアンロードすると、 ソース・データが IEEE (BFP) 32 ビット表記では表現できない場合は、エラーが起こります。

EXTERNAL(length)
出力データが浮動小数点表記 ±d.ddd...dddE±nn の文字 ストリングで表される数値であることを指定します。ここで、d は有効数字を表す数字 (0-9) であり、 文字 E、その後の nn と符号は、 指数の 2 桁の数字を表します。
(length)
フィールド全体の長さをバイトで指定します。 これには、最初の符号文字、小数点、文字 E、2 番目の符号文字、 および 2 桁の指数が含まれます。 結果の文字数が指定されている長さまたはデフォルトの長さより小さい場合は、 結果の右側にブランクが埋め込まれます。 長さを指定する場合は、8 以上でなければなりません。

出力フィールド・サイズのデフォルトは、ソース・データ・タイプが 32 ビット FLOAT の場合は 14、 それ以外の場合は 24 です。

FLOAT EXTERNAL 出力フィールドでは、最小限の浮動小数点表記が収まる最低 7 文字分の スペースが出力レコードに必要です。それが満たされない場合は、エラーが起こります。
DOUBLE
出力データが、64 ビットの浮動小数点表記であることを指定し ます。DOUBLE を使用する場合、length パラメーターを指定しないでください。
REAL
出力データが、32 ビットの浮動小数点表記であることを指定し ます。REAL を使用する場合は、length パラメーターは指定しないでください。
DATE EXTERNAL
出力フィールドが、日付を表す文字ストリング用であることを指定します。日付の出力フォーマットは、Db2 インストールによって異なります。
(length)
出力レコードのデータ・フィールドのサイズをバイトで指定し ます。DATE EXTERNAL フィールドは、少なくとも 10 文字のスペースを必要とします。 スペースが使用不可の場合は、エラーが起こります。 指定された length がデータのサイズよりも大きい場合は、右側にブランクが埋め込まれます。
TIME EXTERNAL
出力フィールドが、時刻を表す文字ストリング用であることを指定します。時刻の出力フォーマットは、Db2 インストールによって異なります。
(length)
出力レコードのデータ・フィールドのサイズをバイトで指定し ます。TIME EXTERNAL フィールドは、少なくとも 8 文字のスペースを必要とします。 スペースが使用できない場合は、変換エラーが起こります。 指定された length がデータのサイズよりも大きい場合は、右側にブランクが埋め込まれます。
TIMESTAMP EXTERNAL
出力フィールドが、タイム・スタンプを表す文字ストリング用であることを指定します。
(length)
出力レコードのデータ・フィールドのサイズをバイトで指定し ます。TIMESTAMP EXTERNAL フィールドは、少なくとも 19 文字のスペースを必要とします。 スペースが使用不可の場合は、エラーが起こります。length パラメーターが指定されている 場合は、それによって TIMESTAMP の出力フォーマットが決まります。 指定された length がデータのサイズより大きい場合、 フィールドの右側にデフォルトの埋め込み文字が埋め込まれます。
TIMESTAMP WITH TIMEZONE EXTERNAL
出力フィールドが、タイム・スタンプを表す文字ストリング用であることを指定します。
(length)
出力レコードのデータ・フィールドのサイズをバイトで指定し ます。TIMESTAMP WITH TIME ZONE EXTERNAL フィールドでは、少なくとも 26 文字のスペースが必要です。 スペースが使用不可の場合は、エラーが起こります。length パラメーターが指定されている場合は、それによって TIMESTAMP WITH TIME ZONE の出力フォーマットが決まります。 指定された length がデータのサイズより大きい場合、フィールドの右側にデフォルトの埋め込み文字が埋め込まれます。
CONSTANT
出力レコードに、定数値の入っている追加のフィールドがあることを指定し ます。CONSTANT キーワードに関連したフィールド名は、表の列名と同じであってはなりません (フィールド名 は説明目的だけのものです)。CONSTANT フィールドは、常に、与えられたストリングの長さと同じ固定長 です。
'string'
出力レコードの指定された位置またはデフォルトの位置に挿入する 文字ストリングを指定します。このストリングは CONSTANT オプションでは必要なオペランドです。指定されたストリングが 'string' 形式の 場合は、EBCDIC SBCS ストリングであると想定されます。ただし、CONSTANT フィールドの出力ストリングは、指定されたコード化スキームまたはデフォルトのコード化スキームになります。(すなわち、出力に使用されるコード化スキーム が EBCDIC でない場合は、与えられたストリングが出力レコード に入る前に、そのストリングに対して SBCS CCSID 変換が適用されます。)
X'hex-string'
出力レコードの指定された位置またはデフォルトの位置に挿入する文字ストリング を、16 進形式 X'hex-string' で指定します。 SBCS EBCDIC 以外のコード化スキーム で CONSTANT ストリング値を指定する場合は、16 進形式を使用してくだ さい。16 進形式を使用する場合は、CCSID 変換は行われません。

CONSTANT フィールドの場合、他のフィールド選択リストのオプションは指定できません。

CONSTANT フィールドを挿入する場合、生成される LOAD ステートメントには 入りません (CONSTANT フィールドをスキップするように LOAD ステートメントが生成されます)。

FORMAT DELIMITED と CONSTANT の両方を指定した場合は、 生成される LOAD ステートメントは使用できません。

ROWID
出力データが、タイプ ROWID の出力データであることを指定します。 フィールド・タイプ ROWID は、アンロードされる列が ROWID タイプの場合に限り、 指定できます。キーワードは、整合性の目的で提供されています。

ROWID フィールドは可変長であり、2 バイトのバイナリーの長さフィールドが、 実際のデータ・フィールドの前に付加されます。

ROWID タイプの場合、データ変換も切り捨ても適用されません。 出力フィールド・サイズが小さすぎて ROWID データをアンロードできない場合は、エラーが起こります。

ソースがイメージ・コピーで、ROWID 列が選択された場合、 指定されたデータ・セットにページ・セット・ヘッダー・ページが存在しない場合は、UNLOAD ユーティリティーは、 エラー・メッセージ DSNU1228I を出して終了します。 この状態は、ソースが、複数データ・セットで定義されたパーティション化されていない表スペースのものより 大きい DSNUM のイメージ・コピー・データ・セットの場合に生じる可能性があります。

BLOB
列は、バイナリー・ラージ・オブジェクト (BLOB) としてアンロードされることを示します。 このフィールドには、データ変換は適用されません。

BLOB フィールド・タイプを指定すると、出力レコードには、4 バイトの 2 進数の長さフィールドが、 実際のデータ・フィールドの前に置かれます。ソース表の列が NULL 可能であれば、 長さフィールドの前に、NULL 標識バイトが置かれます。

(length)
実際のデータ・フィールドの最大長をバイトで指定します。NOPAD を指定した場合は、 出力レコードのデータの最大許容スペースを示します。指定しない場合は、 指定された長さのスペースがデータ用に確保されます。

変更の始まり最大許容値は 32767 です。変更の終わり

デフォルトは、ソース表の列に定義された最大長です。

TRUNCATE
BLOB ストリングは、データが、出力レコードのフィールドで使用可能なスペースに収まらない場合は、 右側から切り捨てられることを示します。BLOB データの場合、切り捨てはバイト境界で行われ ます。TRUNCATE の指定がない場合は、出力フィールドのサイズがデータにとって小さすぎると、エラーが発生します。
CLOB
列は、文字ラージ・オブジェクト (CLOB) としてアンロードされることを示します。

CLOB フィールド・タイプを指定すると、出力レコードには、4 バイトの 2 進数の長さフィールドが、 実際のデータ・フィールドの前に置かれます。ソース表の列が NULL 可能であれば、 長さフィールドの前に、NULL 標識バイトが置かれます。

EBCDIC、ASCII、UNICODE、または CCSID オプションを指定した場合、 指定したオプションに対応する出力データは、ソース・データ (SBCS または MIXED) の サブタイプに応じて、CCSID でエンコードされます。 サブタイプが BIT の場合は、変換は適用されません。

(length)
実際のデータ・フィールドの最大長をバイトで指定します。NOPAD を指定した場合は、 出力レコードのデータの最大許容スペースを示します。指定しない場合は、 指定された長さのスペースがデータ用に確保されます。

変更の始まり最大許容値は 32767 です。変更の終わり

デフォルトは、ソース表の列に定義された最大長です。

TRUNCATE
CLOB 文字ストリング (出力用にエンコード) は、データが、出力レコードのフィールドで 使用可能なスペースに収まらない場合は、右側から切り捨てられることを示し ます。CLOB データの場合、切り捨ては文字境界で行われ ます。UNLOAD ユーティリティーで使用する切り捨ての規則については、出力データの TRUNCATE および STRIP オプションの指定を参照してくだ さい。TRUNCATE の指定がない場合は、出力フィールドのサイズがデータにとって小さすぎると、エラーが発生します。
DBCLOB
列は、2 バイト文字ラージ・オブジェクト (DBCLOB) としてアンロードされることを示します。

DBCLOB フィールド・タイプを指定すると、出力レコードには、4 バイトの 2 進数の長さフィールドが、 実際のデータ・フィールドの前に置かれます。ソース表の列が NULL 可能であれば、 長さフィールドの前に、NULL 標識バイトが置かれます。

EBCDIC、ASCII、UNICODE、または CCSID オプションを指定した場合、 出力データは、指定されたオプションに対応する CCSID (DBCS CCSID が使用される) でエンコードされます。

(length)
実際のデータ・フィールドの最大長を DBCS 文字数で指定します。NOPAD を指定した場合は、 出力レコードのデータの最大許容スペースを示します。指定しない場合は、 指定された長さのスペースがデータ用に確保されます。

変更の始まり最大許容値は 32767 です。変更の終わり

デフォルトは、ソース表の列に定義された最大長です。

TRUNCATE
DBCS 文字ストリング (出力用にエンコード) は、データが、出力レコードのフィールドで 使用可能なスペースに収まらない場合は、右側から切り捨てられることを示し ます。DBCLOB データの場合、切り捨ては文字 (DBCS) 境界で行われ ます。UNLOAD ユーティリティーで使用する切り捨ての規則については、出力データの TRUNCATE および STRIP オプションの指定を参照してくだ さい。TRUNCATE の指定がない場合は、出力フィールドのサイズがデータにとって小さすぎると、エラーが発生します。
DECFLOAT (length)
128 ビット 10 進浮動小数点数または 64 ビット 10 進浮動小数点数を 指定します。長さの値は 16 または 34 のいずれかでなければなりません。長さ が 16 の場合、数値の形式は 10 進 64 ビット浮動小数点形式です。 長さが 34 の場合、数値の形式は 128 ビット 10 進浮動小数点形式です。 デフォルトの長さは、表に定義された列属性で決まります。 それ以外の場合、デフォルトの長さは 34 (16 バイト) です。
DECFLOAT EXTERNAL
数値を表す文字のストリングを指定します。 形式は、SQL 数値定数です。
(length)
フィールドの全長をバイト単位で指定します。この長さには、 最初の符号文字、小数点、文字 E、2 番目の符号文字、 および指数 (ストリング中にある場合) が含まれます。 結果の文字数が指定されている長さまたはデフォルトの長さより小さい場合は、 結果の右側にブランクが埋め込まれます。値の文字表現は、指定されているかデフォルトのフィールド・サイズに 収まらなければなりません。

出力フィールドのデフォルトのサイズは、ソースの データ・タイプが DECFLOAT(16) の場合は 23 です。それ以外の場合は、デフォルトは 42 です。

XML
XML 列が出力レコードに直接アンロードされることを 指定します。
BINARYXML。XML 文書がバイナリー XML 形式でアンロードされることを指定します。
WHEN
アンロードされる表スペースのレコードを示します。 表スペースの表について WHEN 文節の指定がない場合は、すべてのレコードがアンロードされます。

WHEN の後ろのオプションは、表からアンロードされるレコードの条件を記述します。

表のデータは、EBCDIC、ASCII、または Unicode で記述されます。ターゲット表が Unicode で記述され、文字定数が EBCDIC でユーティリティー制御ステートメントに指定されている場合、これらの定数は UNLOAD ユーティリティーにより Unicode に変換されます。 ターゲット表が ASCII の場合に定数を使用するには、WHEN 文節の条件に 16 進 形式で (文字ストリング形式ではなく) 定数を指定してください。

selection condition
与えられた行について、真、偽、または不明である条件を指定します。 条件が真の場合、その行は UNLOAD の対象となる資格があります。 条件が偽または不明の場合は、その行は対象となる資格はありません。

selection condition の結果は、指定された論理演算子 (AND、OR) を指定された それぞれの predicate に適用して得られます。 論理演算子を指定しないと、この selection condition の結果は、指定された下記 predicate の結果となります。

括弧の中の selection condition が最初に評価されます。 評価の順序が括弧によって指定されていない場合は、AND は OR よりも先に適用されます。

制御ステートメントが入力データと同じコード化スキームの場合は、 文字定数を制御ステートメントに指定することができます。 そうではなく、制御ステートメントが入力データと同じコード化スキームではない場合は、 条件を 16 進定数で指定する必要があります。 例えば、表スペースが EBCDIC で、制御ステートメントが UTF-8 の場合、条件では、(1:1) = '1' では なく、(1:1) = X'31' を使用してください。

制約事項: UNLOAD は、 暗号化されたデータが入っている行をフィルターに掛けることはできません。
predicate
行について、真、偽、または不明である条件を指定します。

述部には、DECFLOAT 定数や以下のいずれかのタイプの列を指定できません。

変更の始まり
  • DECFLOAT
  • LONG VARCHAR
  • LONG VARGRAPHIC
  • ROWID
  • CLOB
  • BLOB
  • DBCLOB
変更の終わり

XML 列は、IS NULL や IS NOT NULL とのみ指定できます。

変更の始まりVARCHAR 列は、以下の述部と一緒にのみ指定することができます。変更の終わり

変更の始まり
  • IS NULL
  • IS NOT NULL
  • HEX 値または固定長の CHAR 値との比較
変更の終わり

変更の始まりVARGRAPHIC 列は、以下の述部と一緒にのみ指定することができます。変更の終わり

変更の始まり
  • IS NULL
  • IS NOT NULL
  • HEX 値または固定長の GRAPHIC 値との比較
変更の終わり

述部の列名では大文字と小文字が区別されます。例えば、ソース表の列の名前が SALARY である場合、SALARY=20000 は有効な述部ですが、salary=20000 は有効ではありません。

basic predicate
列と定数との比較を指定します。その列の値が NULL である 場合は、predicate の結果は不明となります。それ以外の場合は、predicate の結果は真または偽となります。
column = constant
列が定数またはラベル付き期間の式と等しい場合
column < > constant
列が定数またはラベル付き期間の式と等しくない場合
column > constant
列が定数またはラベル付き期間の式より大の場合
column < constant
列が定数またはラベル付き期間の式より小の場合
column > = constant
列が定数またはラベル付き期間の式より大か等しい場合
column < = constant
列が定数またはラベル付き期間の式より小か等しい場合
注: 次の代替比較演算子も使用できます。
  • != または ¬= (等しくない)。
  • !> または ¬> (以下)。
  • !< または ¬< (以上)。
「否定」を表す記号 ¬ は、互換性のためにサポートされています。できれば、! を使用してください。
BETWEEN predicate
ある値が、昇順に指定された他の 2 つの所定の値の間にあるかどうかを示します。 値としては、定数かラベル付きの期間式が可能です。 次の表に示すように、この述部の 2 つの形式 (BETWEEN と NOT BETWEEN) の 検索条件は同等です。またこの表では、関係のある場合は、同等の述部も示しています。
表 1. BETWEEN 述部および同等の検索条件
述部 同等の述部 同等の検索条件
column BETWEEN value1 AND value2 なし (column >= value1 AND column <= value2)
column NOT BETWEEN value1 AND value2 NOT(column BETWEEN value1 AND value2) (column < value1 OR column > value2)
注: 値としては、定数かラベル付きの期間式が可能です。

例えば、給与 (SALARY) が 10000 以上 20000 以下である行では、 次の predicate は真となります。

SALARY BETWEEN 10000 AND 20000
IN predicate
ある値と 1 セットの値とを比較することを指定し ます。IN predicate の第 2 オペランドは、定数で指定された 1 セットの 1 つ以上の値 です。次の表に示すように、この述部の 2 つの形式 (IN と NOT IN) の 検索条件は同等です。
表 2. IN predicate および同等の検索条件
述部 同等の検索条件
value1 IN (value1, value2,…, valuen) (value1 = value2 OR … OR value1 = valuen)
value1 NOT IN (value1, value2,…, valuen) value1 ¬= value2 AND … AND value1 ¬= valuen)
注: この値には、定数を使用できます。
例えば、従業員の所属部門が D11、B01、C01 のいずれかで ある行は、次の predicate が真となります。
WORKDEPT IN ('D11', 'B01', 'C01')
LIKE predicate
特定のパターンを持つストリングの修飾を指定します。

パターン内では、% 記号または下線は、特別な意味を持っているか、あるいは % 記号または下線のリテラルを表しています。 リテラルとしての意味を持つためには、頭に エスケープ文字 が必要です。 前にエスケープ文字が付いていない場合、これらは特別な意味を持ちます。 下線文字 (_) は、任意の単一文字を表します。 パーセント記号 (%) は、ゼロ個以上の 任意の文字からなるストリングを表します。

ESCAPE 文節では単一文字を指定します。その文字だけが、パターン内でエスケープ文字として複数回使用できる唯一の文字となります。ESCAPE 文節を省略すると、エスケープ文字としての役割を果たす文字は無いため、 パターン中の % 記号と下線は、特別な意味を持つことになります。

以下に、ESCAPE 文節を使用する際に適用される規則を示します。

  • x が混合データの場合 ESCAPE 文節は使用できません。
  • x が文字ストリングの場合は、ストリング定数のデータ・タイプは 文字ストリングでなければなりません。 x がグラフィック・ストリングの場合は、 ストリング定数のデータ・タイプをグラフィック・ストリングにする必要があります。 いずれの場合も、ストリング定数の長さは 1 でなければなりません。
  • パターンは、エスケープ文字の後ろにエスケープ文字「%」ま たは「_」が続いている場合を除き、エスケープ文字が入っていてはならない。 例えば、「+」がエスケープ文字である場合、 「++」、「+_」、「+%」以外の「+」がパターン中に現れるのは誤りです。

以下に、パターンにエスケープ文字が含まれていない場合、その文字が持つ意味を 簡単に示します。

  • 下線 (_) は、任意の単一文字を表します。
  • パーセント記号 (%) は、ゼロ個以上の 任意の文字からなるストリングを表します。
  • 上記以外のすべての文字は、その文字自体が 1 回あることを表す。

x はテストする列を表し、y はストリング定数のパターンを表すものとします。 以下の規則は、形式 "x LIKE y..." の predicate に適用されます。 NOT が指定されていると、結果は逆になります。

  • x と y がともに空でも NULL でもない場合、述部の 結果は、x が y のパターンと一致していれば真、x が y のパターンと一致していなければ偽になる。
  • x または y が NULL の場合は、述部の結果は不明となる。
  • y が空で x が空でない場合は、述部の結果は偽となる。
  • x が空で y が空でない場合は、y が 1 つ以上の % 記号のみから成る場合を除き、述部の結果は偽となる。
  • x と y が両方とも空の場合は、述部の結果は真となる。

パターン・ストリングとテストされるストリングは同じタイプでなければなりません。 つまり、x と y が両方とも文字ストリングであるか、あるい は x と y が両方ともグラフィック・ストリングでなければなりません。 x および y がグラフィック・ストリングである場合は、文字は DBCS 文字です。 x および y が文字ストリングで、x が混合データでない場合は、 文字は SBCS 文字であり、y は、そのサブタイプに関係なく、SBCS データ として解釈されます。

ストリングとパターン

ストリング y は、y の 各文字が 1 つのサブストリング指定子の部分であるような、最小限の数のサブストリング指定子のシーケンスとして解釈されます。 サブストリング指定子は、下線、% 記号、あるいは、下線または % 記号以外の空ではない文字のシーケンスです。

ストリング x がパターン y と一致するのは、以下の ように x がサブストリングに分割化できる場合です。

  • x のサブストリングがゼロ個以上の連続する文字の列であ り、x のそれぞれの文字が 1 つのサブストリングの部分となっている。
  • n 番目のサブストリング指定子が下線の 場合、x の n 番目のサブストリングが任意の単一文字である。
  • n 番目のサブストリング指定子が % 記号の 場合、x の n 番目のサブストリングがゼロ個以上の文字からなる任意の シーケンスである。
  • n 番目のサブストリング指定子が下線でも % 記号でもない場合 に、x の n 番目のサブストリングがこのサブストリング指定子と等しく、 かつその長さがこのサブストリング指定子の長さと同じである。
  • x のサブストリング数がサブストリング指定子の数と同じである。

パターン・ストリングにエスケープ文字が存在する場合は、下線、% 記号、 またはエスケープ文字は、その文字自体が 1 回現れることを示しています。ただし、 これらの文字の前に奇数個の連続するエスケープ文字がある場合に限ります。

変更の始まりLIKE 述部を評価するためにパターン・マッチングを行う方法は、固定長ストリングの最後にあるブランクが有効か、それともそれらのブランクが無視されるかによって異なります。 LIKE_BLANK_INSIGNIFICANT サブシステム・パラメーターを有効にすると、 LIKE 述部によって複数の異なる結果が生成されることがあります。変更の終わり

混合データ・パターン: x が混合データである場合は、 そのパターンは混合データであると想定され、その中の特殊文字は次のように解釈されます。

  • 単一バイトの下線は 1 つの 1 バイト文字を 指し、2 バイトの下線は 1 つの 2 バイト文字を指す。
  • 単一バイトまたは 2 バイトの % 記号は、単一バイトまたは 2 バイトの、 任意のタイプの任意の数の文字を指す。
  • x または y 内の重複シフト・バイトは無視されます。
関連情報:
NULL predicate
NULL 値のテストを指定します。

列の値が NULL である場合は、結果は真となります。値が NULL でない場合は、 結果は偽となります。NOT が指定されていると、結果は逆になります。 (すなわち、列の値が NULL である場合は、結果は偽となります。値が NULL でない場合は、 結果は真となります。)

labeled duration expression
特殊レジスター CURRENT DATE または特殊レジスター CURRENT TIMESTAMP (形式 CURRENT_DATE およ び CURRENT_TIMESTAMP も受け入れ可能) から始まる式を指定します。 CURRENT TIMESTAMP の場合、タイム・スタンプ列との比較では、この特殊レジスターのタイム・スタンプ精度は列のタイム・スタンプ精度と同じになります。それ以外の場合は、デフォルトのタイム・スタンプ精度が使用されます。 特殊レジスターの後ろには、加算または減算の算術計算を続けることができます。 これらの操作は、数字の後に、7 つの期間キーワード の YEARS、 MONTHS、 DAYS、 HOURS、 MINUTES、 SECONDS、または MICROSECONDS のいずれかを続けて使用する ことによって表すことができます。(これらのキーワードでは、その単数形である YEAR、 MONTH、 DAY、 HOUR、 MINUTE、 SECOND、 MICROSECOND も 認められます。)

ユーティリティーは、labeled duration expression を常にタイム・スタンプとして評価し、 日付列との比較の場合は、暗黙的に日付への変換が行われます。

CURRENT DATE (現在日付) の増分および減分: 日付に期間を加算した 結果、または日付から期間を減算した結果は、それ自体が日付です。(この操作の目的上、1 カ月はカレンダーの 1 ページに等しいものと考えます。 したがって、ある日付に月を加算するということは、カレンダーのページを、 その日付のあるページから順番にめくっていくことに似ています。) 結果は、0001 年 1 月 1 日から 9999 年 12 月 31 日までの間に含まれる日付でなければなりません。 年数の加算または減算の場合は、日付の年の部分だけが影響します。 月は未変更のままです。日についても同様です。ただし、結果がうるう年以外の年の 2 月 29 日に なってしまった場合は除きます。 そのときは、結果の日の部分が 28 に設定されます。

同様に、月数の加算または減算の場合は、月だけが影響しますが、 必要な場合は、年も影響を受けます。結果が無効な値 (例えば 9 月 31 日など) にならない限り、日付の日の部分は変わりません。 その場合は、日はその月の最後の日付に設定されます。

日数の加算または減算の場合は、日付の日の部分に影響しますが、 月および年も影響を受ける可能性があります。

日付期間の場合も、その値が正であっても負であっても、日付との加算および減算が 可能です。ラベル付き期間の場合と同様に、その結果は有効な日付となります。

正の日付期間を日付に加算したとき、または負の日付期間を日付から減算したときには、 日付は年、月、および日について指定された数だけ増分されます。

正の日付期間を日付から減算したとき、または負の日付期間を日付に加算したときには、 日付は日、月、および年について指定された数だけ減分されます。

ある日付に 1 カ月を加算すると、結果は 1 カ月後の同じ日となります。ただし、後の月に その日が存在しない場合は除きます。 この場合、結果の日は翌月の末日に設定されます。例えば、1 月 28 日に 1 カ月を加算すると、結果は 2 月の 28 日になります。1 月 の 29 日、30 日、または 31 日に 1 カ月を加算すると、結果は 2 月の 28 日か、あるいは うるう年の 2 月 29 日になります。ある日付に 1 カ月以上の月数を足した後で、その結果から 同じ月数だけ引いた場合は、最終結果の日付が元の日付と同じ にならないこともあります。

ラベル付き日付期間と日付との間の加算および減算の順序によって、結果に影響する可能性があります。ある日付にラベル付き日付期間を加算する場合は、YEARS + MONTHS + DAYS という順序で指定してください。 ある日付からラベル付き日付期間を減算する場合は、DAYS - MONTHS - YEARS という順序で指定してください。 例えば、ある日付に 1 年と 1 日を加算する場合は、次のように指定します。

ラベル付き期間の式が特殊レジスター CURRENT TIMESTAMP で始まる場合は、CURRENT TIMESTAMP は時間帯列と比較されます。この特殊レジスターのタイム・スタンプ精度は、列のタイム・スタンプ精度と同じになります。それ以外の場合は、デフォルトのタイム・スタンプ精度が使用されます。CURRENT TIMESTAMP の時間帯は、特殊レジスター CURRENT TIMEZONE の値です。比較は、UTC 部分を比較することによって行われます。

CURRENT DATE + 1 YEAR + 1 DAY

ある日付から 1 年 1 カ月と 1 日を減算する場合は、次のように指定してください。

CURRENT DATE - 1 DAY - 1 MONTH - 1 YEAR

タイム・スタンプ の増減: あるタイム・スタンプに期間を加算または減算した結果は、 それ自体がタイム・スタンプです。日付/時刻の算術計算は、これまでの定義どおりに実行されます。 ただし、オーバーフローまたはアンダーフローとなった分の時間が結果の日付の部分に 繰り上げられることだけが異なります。この結果は、有効な日付の範囲内でなければなりません。