LOAD 制御ステートメントの構文とオプション
LOAD ユーティリティー制御ステートメントは、複数のオプションを使用して、 ユーティリティー・ジョブが実行する機能を定義します。
制御ステートメントは、ISPF/PDF 編集機能を使って作成することができます。 制御ステートメントを作成した後、それを順次データ・セットまたは区分データ・セットに 保管します。 ジョブを実行するための JCL を作成するときは、SYSIN DD ステートメントを使用して、ユーティリティー 制御ステートメントを格納するデータ・セットの名前を指定してください。
構文図
.-DATA-. .-INDDN--SYSREC---------. >>-LOAD--+------+--+-----------------------+--+-----------+-----> +-INDDN--ddname---------+ '-PREFORMAT-' '-INCURSOR--cursor-name-' .-PRESORTED--NO--. >--+-----------------------------+--+----------------+----------> | .-1-------. | '-PRESORTED--YES-' '-COPYDICTIONARY--+-integer-+-' >--+------------------------------+--+--------------------+-----> '-PARALLEL--+----------------+-' '-ROWFORMAT--+-BRF-+-' '-(num-subtasks)-' '-RRF-' >--+----------------------------------+--| resume-spec |--------> '-RBALRSN_CONVERSION--+-NONE-----+-' +-BASIC----+ '-EXTENDED-' >--| flashcopy-spec |--+----------------+--+-------+------------> '-KEEPDICTIONARY-' '-REUSE-' .-LOG--YES----------------. >--+-------------------------+--| workddn-spec |----------------> '-LOG--NO--+------------+-' '-NOCOPYPEND-' (1) .-SORTKEYS--0--------. .-FLOAT(S390)-. >--+--------------------+--| format-spec |--+-------------+-----> +-SORTKEYS--NO-------+ '-FLOAT(IEEE)-' '-SORTKEYS-- integer-' .-EBCDIC--. >--+---------+--+----------------------+--+--------+------------> +-ASCII---+ | .-,-------. | '-NOSUBS-' '-UNICODE-' | V | | '-CCSID(---integer-+-)-' .-ENFORCE--CONSTRAINTS-. >--+----------------------+--+-------------+--------------------> '-ENFORCE--NO----------' '-NOCHECKPEND-' .-ERRDDN--SYSERR-. .-MAPDDN--SYSMAP-. >--+----------------+--+----------------+-----------------------> '-ERRDDN--ddname-' '-MAPDDN--ddname-' .-DISCARDDN--SYSDISC-. .-DISCARDS--0-------. >--+--------------------+--+-------------------+----------------> '-DISCARDDN--ddname--' '-DISCARDS--integer-' .-BACKOUT--NO------. >--+------------------+--+-----------------------+--------------> | .-YES-. | '-SORTDEVT--device-type-' '-BACKOUT--+-----+-' >--+------------------+-----------------------------------------> '-SORTNUM--integer-' >--+-----------------------------------------------------+------> '-CONTINUEIF(start-+------+-)=-+-X'byte-string'-----+-' '-:end-' '-'character-string'-' >--+-----------------+--+-------------------+-------------------> '-| ignore-spec |-' '-| decfloat-spec |-' >--+-------------------+--+----------------+--------------------> '-| override-spec |-' '-| drain-spec |-' .-INDEXDEFER--NONE-------------------. >--+------------------------------------+-----------------------> '-INDEXDEFER--+-NPI-+--+-----------+-' '-ALL-' '-NONUNIQUE-' >--+--------------------------------+---------------------------> '-IMPLICIT_TZ--'timezone-string'-' .---------------------. V | >----| INTO-TABLE-spec |-+-------------------------------------><
- 入力がテープ、カーソル、PDS メンバー上にあるか、SYSREC DD * 用の場合は、デフォルトは 0 です。 ディスク上の順次データ・セットの場合、LOAD は入力データ・セット・サイズに基づいてデフォルトを計算します。
resume-spec:
(1) .-RESUME--NO-----. .-SHRLEVEL--NONE------. >>-+-+----------------+--+---------------------+--+---------+--+---------------+--+---------------------+-+->< | '-SHRLEVEL--REFERENCE-' '-REPLACE-' '-| copy-spec |-' '-| statistics-spec |-' | | .-SHRLEVEL--NONE---. | '-RESUME--YES--+------------------+--------------------------------------------------------------------' '-SHRLEVEL--CHANGE-'
- INTO TABLE 文節内の RESUME 値または REPLACE 値は、LOAD RESUME のデフォルト値をオーバーライドします。
workddn-spec:
.-WORKDDN(SYSUT1,SORTOUT)--------------. >>-+--------------------------------------+-------------------->< '-WORKDDN--+-(ddname1,ddname2)-------+-' | .-,SORTOUT-. | +-(ddname1-+----------+-)-+ | .-SYSUT1-. | '-(-+--------+-,ddname2)--'
copy-spec:
>>-+-------------------------------------+----------------------> | .-(SYSCOPY)---------------. | '-COPYDDN-+-------------------------+-' +-(ddname1-+----------+-)-+ | '-,ddname2-' | '-(,ddname2)--------------' >--+------------------------------------+---------------------->< '-RECOVERYDDN(ddname3-+----------+-)-' '-,ddname4-'
flashcopy-spec:
.-FLASHCOPY--NO-------------------------------------------------. >>-+---------------------------------------------------------------+->< '-FLASHCOPY--+-YES--------+--+--------------------------------+-' '-CONSISTENT-' '-FCCOPYDDN--(--template-name--)-'
statistics-spec:
>>-STATISTICS--+---------------------+--+---------------------+--> '-| stat-table-spec |-' '-| stat-index-spec |-' .-REPORT--NO--. .-UPDATE--ALL------------. >--+-------------+--+------------------------+------------------> '-REPORT--YES-' '-UPDATE--+-ACCESSPATH-+-' +-SPACE------+ '-NONE-------' >--+-------------------------+--+----------------------+------->< '-HISTORY--+-ALL--------+-' '-FORCEROLLUP--+-YES-+-' +-ACCESSPATH-+ '-NO--' +-SPACE------+ '-NONE-------'
stat-table-spec
.-TABLE--(--ALL--)-. >>-+-+------------------+--+-----------------+-------------+--->< | '-SAMPLE--integer-' | | .---------------------------------------------------. | | V | | '---TABLE--(--table-name--)--+----------------------+-+-' '-| table-stats-spec |-'
table-stats-spec:
.-COLUMN--ALL-------------------. >>-+-----------------+--+-------------------------------+-------> '-SAMPLE--integer-' | .-,-----------. | | V | | '-COLUMN--(----column-name-+--)-' >--+--------------------------------------------------------------+->< | .-,--------------------------------------------------------. | | | .-,-----------. | | | V V | | | '---COLGROUP--(----column-name-+--)--| colgroup-stats-spec |-+-'
colgroup-stats-spec:
>>-+----------------------------------------+-------------------> | .-COUNT--10-- MOST----------. | '-FREQVAL--+---------------------------+-' | .-MOST--. | '-COUNT--integer--+-------+-' +-BOTH--+ '-LEAST-' >--+--------------------------------------+-------------------->< | .-NUMQUANTILES--100-----. | '-HISTOGRAM--+-----------------------+-' '-NUMQUANTILES--integer-'
stat-index-spec
.-INDEX--(--ALL--)-. >>-+-+------------------+--| correlation-stats-spec |--------+->< | .-,--------------------------------------. | | V | | '-INDEX--(----index-name--| correlation-stats-spec |-+--)-'
correlation-stats-spec:
(1) .-KEYCARD-----. >>-+-------------+----------------------------------------------> .-FREQVAL--NUMCOLS--1--COUNT--10--------------------. >--+---------------------------------------------------+--------> | .-----------------------------------------------. | | V .-COUNT--10------. | | '---FREQVAL--NUMCOLS--integer--+----------------+-+-' '-COUNT -integer-' .-NUMCOLS--1--NUMQUANTILES--100---------------. >--HISTOGRAM--+---------------------------------------------+-->< | .-NUMQUANTILES--100-----. | '-NUMCOLS--integer--+-----------------------+-' '-NUMQUANTILES--integer-'
- KEYCARD オプションは推奨されません。KEYCARD の機能は、索引のインライン統計の デフォルト実行に組み込まれたため、無効にすることはできません。
format-spec:
>>-+----------------------------------------------------------------------------------+->< '-FORMAT-+-UNLOAD----------------------------------------------------------------+-' +-SQL/DS----------------------------------------------------------------+ +-INTERNAL--------------------------------------------------------------+ | .-COLDEL--','----. .-CHARDEL--'"'-----. .-DECPT--'.'---. | +-DELIMITED--+----------------+--+------------------+--+--------------+-+ | '-COLDEL -coldel-' '-CHARDEL -chardel-' '-DECPT--decpt-' | '-SPANNED--+-YES-+------------------------------------------------------' '-NO--'
ignore-spec:
>>-+---------------------------+------------------------------->< '-IGNORE--(--+-WHEN----+--)-' +-PART----+ +-CONV----+ +-VALPROC-+ +-IDERROR-+ '-DUPKEY--'
decfloat-spec:
>>-DECFLOAT_ROUNDMODE--+-ROUND_CEILING---+--------------------->< +-ROUND_DOWN------+ +-ROUND_FLOOR-----+ +-ROUND_HALF_DOWN-+ +-ROUND_HALF_EVEN-+ +-ROUND_HALF_UP---+ '-ROUND_UP--------'
override-spec:
.-,--------------------. V | (1) >>-OVERRIDE--(----+-SYSTEMPERIOD-----+-+--)-------------------->< +-IDENTITY---------+ +-TRANSID----------+ '-NONDETERMINISTIC-'
- 代替構文: OVERRIDE(SYSTEMPERIOD) の代わりに PERIODOVERRIDE、OVERRIDE(TRANSID) の代わりに TRANSIDOVERRIDE、OVERRIDE(IDENTITY) の代わりに IDENTITYOVERRIDE を使用する構文も引き続き受け入れられます。 ただし、キーワード PERIODOVERRIDE、TRANSIDOVERRIDE、および IDENTITYOVERRIDE は推奨されていません。
drain-spec:
>>-+-------------------------+--+--------------------+--+---------------------------+--> | (1) | | (2) | | (3) | '-DRAIN_WAIT--integer-----' '-RETRY--integer-----' '-RETRAY_DELAY--integer-----' .-SWITCHTIME--NONE----------------------------. >--+---------------------------------------------+------------->< '-SWITCHTIME--+-timestamp-------------------+-' '-labeled-duration-expression-'
- DRAIN_WAIT のデフォルトは、IRLMRWT サブシステム・パラメーターの値です。
- RETRY のデフォルトは、UTIMOUT サブシステム・パラメーターの値です。
- RETRY_DELAY のデフォルトは以下の2 つの値の小さい方、つまり、min (DRAIN_WAIT 値 x RETRY 値, DRAIN_WAIT 値 x 10) となります。
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-'
INTO-TABLE-spec:
into-table 指定の構文図とオプションの説明については、INTO-TABLE-specを 参照してください。
オプションの説明
- DATA
- データをロードすることを指定します。このキーワードはオプションであり、意味を明確にする ためにのみ使用します。
- INDDN ddname
- パーティション用の入力データ・セットを示すデータ定義 (DD) ステートメントまたはテンプレートを
指定します。入力データ・セットのレコード・フォーマットは、固定長または可変長
でなければなりません。データ・セットは、基本順次アクセス方式 (BSAM) で読み取れるものでなければなりません。
入力ファイルが HFS ファイルか zFS ファイルの場合、PATH オプションを指定してテンプレートを使用します。
ddname は入力データ・セットの名前です。
デフォルト値は SYSREC です。
- INCURSOR cursor-name
- 入力データ・セットに対するカーソルを指定します。LOAD ユーティリティーがカーソルを使用する前に、カーソルを宣言しておく必要があります。EXEC SQL ユーティリティー制御ステートメント
を使用して、カーソルを定義します。
カーソルを定義した表と同じ表にデータをロードすることはできません。カーソルが定義されている従属表と RI 関係にある親表には、
データをロードすることはできません。
指定されたカーソルは、Db2® ファミリー のクロスローダー機能で使用でき、これによって、DRDA 準拠の任意のリモート・サーバーからデータをロードすることが可能になります。クロスローダー機能の使用に関する詳細については、クロスローダー機能を使用したデータのロードを参照してください。
cursor-name はカーソル名です。 LOAD ユーティリティーで指定されるカーソル名の長さは 8 文字を超えてはなりません。
INCURSOR オプションは、以下のオプションとの併用はできません。
- SHRLEVEL CHANGE
- NOSUBS
- FORMAT UNLOAD
- FORMAT SQL/DS
- FORMAT INTERNAL
- CONTINUEIF
- WHEN
SPANNED YES
さらに、 INCURSOR オプションと一緒には、フィールド仕様を指定することも、廃棄処理を使用 することもできません。
- PREFORMAT
- 残りのページを事前フォーマット設定することを指定します。
その範囲は、table-name で指定された表に関連した表スペースおよび
索引スペースの割り振り済み RBA の最高位置までです。
この事前フォーマット設定は、データがロードされ、索引が作成された後に行われます。
PREFORMAT の操作は、1 つの表スペース全体とその索引スペースに対して、または、1 つのパーティション化表スペース の 1 つのパーティションおよび対応するパーティション化索引のパーティション (存在する場合) に対して 行われます。(PART integer PREFORMAT ではなく) LOAD PREFORMAT を 指定すると、LOAD は表スペース・レベルでシリアライズするように指示され、これによって、別のパーティションの 並行処理を禁止することができます。 パーティション・レベルでシリアライズする場合は、PART integer PREFORMAT を指定します。
PREFORMAT キーワードは、基本表または LOAD がシリアライズされたパーティションに関連付けられた LOB 表スペースおよび補助索引にも適用されます。 XML オブジェクトは事前フォーマット設定されません。
- COPYDICTIONARY integer
- LOAD ユーティリティーで、1 つのパーティションからパーティション化表スペース上の他の複数のパーティションに、既存のコンプレッション・ディクショナリーをコピーできます。LOAD は、パーティション番号が integer のパーティションから現行のコンプレッション・ディクショナリーをコピーし、そのコンプレッション・ディクショナリーを使用して、置き換えるパーティションの入力データを圧縮します。integer のデフォルト値は 1 です。
COPYDICTIONARY は、コンプレッション・ディクショナリーを空のパーティションにコピーする方法を提供します。コピー元のパーティションには、有効なコンプレッション・ディクショナリーがある必要があります。
COPYDICTIONARY を使用すると、LOAD は、COMPRESS YES 属性を持つパーティションにのみコンプレッション・ディクショナリーをコピーします。
COPYDICTIONARY キーワードの使用には、次の制限があります。

- LOAD ステートメントのターゲットがパーティション化表スペースまたは範囲パーティション化表スペースの場合に限り、COPYDICTIONARY を使用できる。
- LOAD ステートメントで PART integer REPLACE を同時に指定する必要がある。
- COPYDICTIONARY と RESUME YES は同時に指定できない。
- LOAD ステートメントで KEEPDICTIONARY を同時に指定することはできない。
- PRESORTED
- 入力データ・セットがクラスタリング・キー順に既にソートされているかどうかを指定します。入力データ・セットがクラスタリング・キー順の場合、LOAD ユーティリティーは RELOAD フェーズと BUILD フェーズを並列に実行でき、クラスタリング索引のソートをスキップできます。
- NO
- 入力データ・セットがまだソートされていないことを指定します。LOAD ユーティリティーがクラスタリング索引をソートしなければなりません。
- YES
- 入力データ・セットが既にソートされていることを指定します。LOAD ユーティリティーは、クラスタリング索引をソートせず、RELOAD フェーズと BUILD フェーズを並列に実行します。
PRESORTED YES を指定する際には、以下の要件を満たされなければなりません。
- 並列索引作成に必要なすべてのデータ・セットが使用可能になっている必要があります。
- パーティション化されたクラスタリング索引があるパーティション表スペースの場合、以下の順序でデータ行を事前ソートしなければなりません。
- パーティション番号
- 各パーティション内のクラスタリング索引のキー順
- 非パーティション化クラスタリング索引があるパーティション表スペースの場合や、単一の表がある非パーティション化表スペースの場合は、クラスタリング索引のキー順でデータ行を事前ソートしなければなりません。
- 単純な表スペースかセグメント化された表スペースの場合は、以下の要件を満たされなければなりません。
- 表内のクラスタリング索引のキー順でデータ行を事前ソートしなければなりません。
- LOAD ステートメントには INTO TABLE 文節を 1 つしか含めることができません。
制約事項:- 以下の条件下では、LOAD は警告メッセージを出し、PRESORTED NO を指定した場合と同様の処理を続行します。
- SHRLEVEL CHANGE も指定した場合
- パーティションの並列処理を使用する場合
- ターゲット表に索引がない場合
- SORTKEYS NO を指定した場合
- RELOAD フェーズでは、REPLACE と PRESORTED YES を指定した LOAD のみを再始動できます。RELOAD フェーズ内で RESUME と PRESORTED YES を指定した LOAD を再始動すると、ユーティリティー処理は異常終了し、LOAD はエラー・メッセージを出します。
- PRESORTED YES の指定時に、入力データ・セットがクラスタリング・キー順序でソートされていないと LOAD が判別した場合、LOAD は順序どおりでないキーを容認します。しかし、クラスタリング索引の場合、インライン統計は収集されず、リアルタイム統計は無効化されます。LOAD は警告メッセージを出します。
PARALLEL
単一の入力データ・セットの場合、PARALLEL オプションは、ユーティリティーが単一の入力データ・セットから表スペースをロードして索引を作成する際に並行して使用されるサブタスクの最大数を指定します。
並列サブタスクを使用すると、ユーティリティーは、ロード操作の経過時間を短縮できる可能性があります。複数の入力データ・セットがあって、パーティションごとにデータ・セットが 1 つずつ使用される場合、PARALLEL オプションは、データ・パーティションのロード、索引の作成、および統計収集で使用されるサブタスクの最大数を指定します。この状態は、パーティション化 (非ユニバーサル) 表スペースおよび範囲パーティション化ユニバーサル表スペースに該当します。 PARALLEL キーワードを省略すると、ロード操作では制約が適用されて最適な数のサブタスクが使用されます。
PARALLEL で指定されるサブタスク数は PARAMDEG_UTIL サブシステム・パラメーターの指定を常にオーバーライドするため、PARALLEL を PARAMDEG_UTIL の値より小さくすることも、大きくすることもできます。
推奨事項: PARALLEL キーワードと SHRLEVEL CHANGE を指定する場合は、表スペースの LOCKSIZE 属性を ROW に設定し、並列サブタスクの競合を最小にしてください。制約事項: 次の状態では、PARALLEL キーワードは無効です。- 単一の入力データ・セットの場合に、LOAD ステートメントに以下のいずれかのオプションが含まれている。
- SPANNED YES
- INCURSOR
- PRESORTED
- FORMAT INTERNAL
- COLGROUP
ロードされる表スペースが、増加対応表スペースであり、SHRLEVEL NONE オプションが使用されている。
- ロードされる表に XML 列があり、この表が単純な表スペースかセグメント化された表スペース内にあり、LOAD ステートメントに SHRLEVEL CHANGE オプションが含まれている。
- ロードされる表に LOB 列または XML 列があり、LOAD ステートメントに SHRLEVEL NONE オプションが含まれている。
- (num-subtasks)
- 並列処理するサブタスクの最大数を指定します。値は 0 から 32767 の整数でなければなりません。
SHRLEVEL CHANGE を指定すると、num-subtasks はデータのロード用およびレコードの前処理用のサブタスクの数を表します。 SHRLEVEL NONE を指定すると、num-subtasks はレコードの前処理用のみのサブタスクの数を表します。
推奨事項: PARALLEL(0) または PARALLEL を指定してください。LOAD ユーティリティーは、メモリーの制約、仮想ストレージの制約、および使用可能なプロセッサー数に基づいて、並行処理するサブタスクの最適な数を計算します。num-subtasks に 0 を指定するか値を指定しないと、LOAD ユーティリティーは並列サブタスクの最適数を使用します。num-subtasks に指定された値が計算された最適数より大きい場合、LOAD は並列サブタスクの数を最適数に制限します。num-subtasks に指定された値が計算された最適数より小さい場合、LOAD は指定値を使用します。num-subtasks に指定された値が 32767 より大きい場合、LOAD ステートメントは失敗します。
num-subtasks に 1 を指定すると、LOAD ユーティリティーは、PARALLEL が指定されていない場合のように、データを順次ロードします。単一の入力データ・セットの場合は、PARALLEL(1) を指定しても、引き続き並列索引作成が可能です。しかし、パーティションの並列処理 (複数の入力データ・セット) の場合に PARALLEL(1) を指定すると、データのロードと索引の作成の両方で並列処理が制限されます。
単一の入力データ・セットの場合、デフォルトは PARALLEL(1) です。パーティションの並列処理の場合、デフォルトは PARALLEL(0) です。
値を指定しないで PARALLEL キーワードを指定すると、デフォルト値は PARALLEL(0) になります。

- 単一の入力データ・セットの場合に、LOAD ステートメントに以下のいずれかのオプションが含まれている。
- ROWFORMAT
- 影響を受ける表スペースまたはパーティションでの出力行フォーマットを指定します。このキーワードは、既存の RRF サブシステム・パラメーター設定をオーバーライドします。 このキーワードは、CLONE 関係に関与している LOB、カタログ、ディレクトリー、XML、またはユニバーサル表スペースには影響しません。
- BRF
- 再編成または置換の対象である表スペースまたはパーティションについて、基本行フォーマットに変換するか、基本行フォーマットのままにすることを指定します。
- RRF
- 再編成または置換の対象である表スペースまたはパーティションについて、再配列行フォーマットに変換するか、再配列行フォーマットのままにすることを指定します。
RBALRSN_CONVERSION
LOAD ユーティリティーの完了後のターゲット・オブジェクトの RBA または LRSN フォーマットを指定します。このキーワードを指定しないと、UTILITY_OBJECT_CONVERSION サブシステム・パラメーターで指定された変換が受け入れられます。RBALRSN_CONVERSION を指定する場合は、REPLACE キーワードも指定する必要があります。- NONE
- 変換が実行されないことを指定します。
基本の 6 バイト形式の表スペースに対して RBALRSN_CONVERSION NONE が指定されており、UTILITY_OBJECT_CONVERSION サブシステム・パラメーターが NOBASIC に設定されている場合、ユーティリティーは失敗します。
- BASIC
- 拡張 10 バイト形式のオブジェクトが検出された場合、6 バイトの基本形式に変換されることを指定します。
RBALRSN_CONVERSION BASIC が指定されており、UTILITY_OBJECT_CONVERSION サブシステム・パラメーターが NOBASIC に設定されている場合、ユーティリティーは失敗します。
- EXTENDED
- 基本の 6 バイト形式のオブジェクトが検出された場合、10 バイトの拡張形式に変換されることを指定します。
RBALRSN_CONVERSION を指定しない場合にサブシステム・パラメーター UTILITY_OBJECT_CONVERSION を BASIC または EXTENDED に設定すると、RBALRSN_CONVERSION のデフォルトは UTILITY_OBJECT_CONVERSION 値になります。
RBALRSN_CONVERSION を指定しない場合にサブシステム・パラメーター UTILITY_OBJECT_CONVERSION を NOBASIC に設定すると、RBALRSN_CONVERSION のデフォルトは EXTENDED になります。
ページ形式を拡張に変換する際に、基本表スペースの LOAD REPLACE は、その基本表スペースに関連付けられたバージョン管理されている XML 表スペースを変換しません。

- RESUME
- レコードが空の表スペースにロードされるのか、空でない表スペースにロードされるのかを指示します。
非セグメント化表スペースの場合、削除済みのマークが付いている行またはドロップされた表の行
については、スペースは再使用されません。重要: LOAD RESUME の (PART integer RESUME ではなく) 指定 は、表スペース全体でシリアライズするよう LOAD に指示し、これによって、別々の複数パーティションの並行処理 を禁止することができます。他のパーティションが並行処理されるようにするには、 PART integer RESUME を指定します。
- NO
- 空の表スペースにレコードをロードします。表スペースが空でなく、かつ REPLACE が使用されなかった場合、
メッセージが出され、ユーティリティー・ジョブ・ステップはジョブ・ステップ条件コード 8 で終了します。
削除された行またはドロップされた表の行を含む非セグメント化表スペースの場合、REPLACE キーワード を使用すると効率が上がります。
デフォルト値は、PART integer RESUME YES で オーバーライドしない限り、NO です。
- YES
- 非空の表スペースにレコードをロードします。表スペースが空の場合は、警告メッセージが出されますが、
表スペースはロードされます。ロードは、表スペースの現在のデータの終わりから開始されます。
削除済みのマークが付いている行またはドロップされた表の行については、スペースは再使用されません。
RESUME YES は SHRLEVEL REFERENCE では無効です。
LOAD RESUME YES SHRLEVEL CHANGE は、ロードされるそれぞれの行ごとに、BEFORE トリガー と AFTER トリガーをアクティブにします。
BACKOUT

- YES
いずれかの入力レコードによってオブジェクトが使用不可のままになる場合は、現行の LOAD によってロードされたすべての行を削除する必要があることを指定します。
表スペースは、LOAD の完了時に使用可能になります。
BACKOUT が単独で指定された場合、値は YES です。
BACKOUT または BACKOUT YES を指定する場合は、RESUME YES の指定が必須です。RESUME YES は、表スペース・レベルで指定することも、INTO TABLE PART 指定の resume-spec 内に指定することもできます。
INTO TABLE PART 指定内に RESUME YES を指定する場合は、それぞれの INTO TABLE PART 指定に指定する必要があります。
BACKOUT または BACKOUT YES は、SHRLEVEL NONE を指定する場合にのみ指定できます。BACKOUT や BACKOUT YES を INCURSOR と一緒に指定することはできません。

- NO
- エラー・レコードが見つかった場合に、LOAD によって行った更新をロールバックしないことを指定します。これは、BACKOUT キーワードが指定されなかった場合のデフォルトの動作です。

- SHRLEVEL
- LOAD ユーティリティー・ジョブの際に、アプリケーションが表スペースまたはパーティション
に並行アクセスできる程度を指定します。
以下のパラメーター値は、並行アクセスできる程度が大きくなる順に示されています。
- NONE
- アプリケーションが表スペースまたはパーティションに並行アクセスできないことを指定します。
REFERENCE
SWITCH フェーズの期間中を除き、アプリケーションが LOAD によるデータのロード先の表スペースまたはパーティションから並行して読み取りを実行できることを指定します。
LOAD REPLACE SHRLEVEL REFERENCE は、データがターゲット・オブジェクトのシャドー・コピーに再ロードされることを指定します。これにより、今後の LOAD によるアプリケーションのアクセス先は、SWITCH フェーズではオリジナル・コピーからシャドー・コピーに切り替えられます。 このオプションは、クローン関係が設定された表スペース、および LOB 列または XML 列を含めて定義されたターゲット表ではサポートされません。

- CHANGE
- LOAD 期間中のほとんどの間、アプリケーションが LOAD によるデータのロード先の表スペースまたはパーティションに対して並行して読み取りと書き込みを実行できることを指定します。
LOAD SHRLEVEL CHANGE ジョブの機能は、大量 INSERT に似ています。 通常の LOAD ジョブは表スペース全体をドレーンするのに対して、LOAD SHRLEVEL CHANGE は INSERT ステートメントのように機能し、オブジェクトにアクセスする際にクレームを使用します。
SHRLEVEL CHANGE を指定する場合、次のパラメーターはいずれも指定できません。- INCURSOR
- RESUME NO
- REPLACE
- KEEPDICTIONARY
- LOG NO
- ENFORCE NO
- STATISTICS
- COPYDDN
- RECOVERYDDN
- MAPDDN
- PREFORMAT
- REUSE
- PART integer REPLACE
個々のパーティションをロードするときに SHRLEVEL CHANGE を指定する場合、RESUME YES も指定する必要があります。 RESUME YES は、個々の PART 節に指定するか、またはメイン LOAD ステートメントから継承することができます。
LOAD RESUME YES SHRLEVEL CHANGE は、SORT、BUILD、SORTBLD、INDEXVAL、または ENFORCE のフェーズを実行しません。さらに互換性と並行性に関する考慮事項もそれぞれ異なります。
通常、LOAD RESUME YES ジョブは、既に存在するレコードの末尾に新しいレコードをロードします。 しかしながら、SHRLEVEL CHANGE オプションを用いた LOAD RESUME YES ジョブでは、ユーティリティーは、 クラスタリング順にできるだけ近い順番で、使用可能なフリー・スペースに新しいレコード を挿入しようとします。 この LOAD ジョブでは、フリー・ページの追加作成は行われません。 多数のレコードを挿入すると、それらのレコードはクラスタリング順とは異なる順番に格納される傾向があります。 この場合は、LOAD ユーティリティーでレコードをロードした後、REORG TABLESPACE ユーティリティーを実行してください。
推奨事項: LOAD ユーティリティーで多数のレコードをロードした場合は、RUNSTATS SHRLEVEL CHANGE UPDATE SPACE を実行してから、条件付き REORG を実行してください。ロードされる表に ID 列が存在する場合は、ID 列に CACHE 属性を指定することによって、パフォーマンスを向上させることができます。
LOAD RESUME YES SHRLEVEL CHANGE の場合、XML 表スペースに対するロック・エスカレーションは使用不可になります。
ロードされる表が DATA CAPTURE CHANGES で定義されている場合、Db2 DataPropagator は、LOAD RESUME YES SHRLEVEL CHANGE の間に Db2 が作成するログ・レコードを使用できます。
SHRLEVEL CHANGE オプションを指定した LOAD ジョブでは、レコードは SYSIBM.SYSCOPY 内に挿入されません。
BEFORE および AFTER の行トリガーは、SHRLEVEL CHANGE の場合にのみアクティブになります。また、それぞれの行ごとのステートメント・トリガーも、LOAD RESUME YES SHRLEVEL CHANGE の場合はアクティブになります。
- REPLACE
- レコードがロードされる前に表スペースおよびそのすべての索引が
空にリセットされている必要があるかどうかを示します。このオプションが指定されると、
表スペース内の (ロードしようとしている表だけでなく) すべての表のすべての既存の行が、
新しくロードされる行で置き換えられます。Db2 STOGROUP 定義のデータ・セットの
場合は、REUSE オプションも指定していない限り、
このオプションによってデータ・セットは削除され、再定義されます。
ユーザーは、LOAD REPLACE を実行する表スペース内のすべての表の LOAD 権限を
持っている必要があります。この権限なしで LOAD REPLACE を行おうとすると、エラー・メッセージを受け取ることになります。
REPLACE を INTO TABLE の PART integer REPLACE オプションと 一緒に使用することはできません。REPLACE オプションを使用して表スペース全体を置き換えるか、 あるいは、INTO TABLE の PART integer REPLACE オプションを使用して単一のパーティション を置き換えるようにする必要があります。
(PART integer REPLACE ではなく) LOAD REPLACE を指定すると、LOAD は表スペース・レベルでシリアライズするように指示されます。 パーティション・レベルでシリアライズする場合は、PART integer REPLACE を指定します。 パーティション・レベルでの REPLACE の指定については、INTO TABLE のキーワードの説明を参照してください。
制約事項:
LOAD REPLACE は、データのバージョン管理を使用して定義される表に対しては許可されません。
ペンディングの定義変更がマテリアライズされるより前のポイント・イン・タイムへの RECOVER が表スペースに対して実行された後、その表スペースに対して LOAD REPLACE は許可されません。LOAD REPLACE を実行する前に、表スペース全体に対して REORG を実行し、ポイント・イン・タイム・リカバリー・プロセスを完了する必要があります。
アーカイブ使用可能表に対しては LOAD REPLACE は許可されません。(アーカイブ表を含む表スペースに対する LOAD REPLACE は許可されます。)
- COPYDDN (ddname1,ddname2)
- イメージ・コピーの 1 次 (ddname1) および
バックアップ (ddname2) のコピー・データ・セットの DD ステートメントを指定します。
ddname は DD 名です。
デフォルト値は 1 次コピー用の SYSCOPY です。 バックアップ・コピーにデフォルトはありません。
COPYDDN キーワードと一緒に指定できるのは、REPLACE のみ です。LOAD の実行時に指定された表またはパーティションに対して、 フル・イメージ・コピー・データ・セット (SHRLEVEL REFERENCE) が作成されます。 イメージ・コピーが作成される表スペースまたはパーティションが COPY ペンディング状況にされることはありません。
LOAD REPLACE 中に作成されるイメージ・コピー を RECOVER TOCOPY で使用することはお勧めできません。 これらのイメージ・コピーには、ユニーク索引違反、参照制約違反、 または索引評価違反が含まれている可能性があるためです。
表に XML データをロードするときに COPYDDN を指定すると、インライン・コピーは基本表スペースについてのみ取られ、XML 表スペースについては取られません。
表に LOB 列をロードする際に COPYDDN を指定すると、Db2 は、どの索引、LOB 表スペース、XML 表スペースについてもコピーを作成しません。 これらの作業は別に行う必要があります。
COPYDDN キーワードには、DD 名または前の TEMPLATE 制御ステートメントにある TEMPLATE 名のいずれかを指定します。 ユーティリティー処理で、指定された名前が現行ジョブ・ステップの DD 名と TEMPLATE 名の両方であることが検出された場合、ユーティリティーは DD 名を使用し ます。
- RECOVERYDDN ddname3,ddname4
- リカバリー・サイトのイメージ・コピーの 1 次 (ddname3) および
バックアップ (ddname4) コピー・データ・セットの DD ステートメントを指定します。
ddname は DD 名です。
重複したイメージ・コピー・データ・セットを作成することはできません。 RECOVERYDDN と COPYDDN には同じ規則が適用されます。
RECOVERYDDN キーワードには、DD 名または前の TEMPLATE 制御ステートメントにある TEMPLATE 名のいずれかを指定します。 ユーティリティー処理で、指定された名前が現行ジョブ・ステップの DD 名と TEMPLATE 名の両方であることが検出された場合、ユーティリティーは DD 名を使用し ます。
- FLASHCOPY
- オブジェクトのコピーを作成するために FlashCopy® テクノロジーを使用するかどうかを指定します。有効値は YES、NO、または CONSISTENT です。FlashCopy を使用すると、パーティションごとまたはオブジェクトの部分ごとに、別のデータ・セットが作成されます。
Db2 データ・セットが FlashCopy バージョン 2 ディスク・ボリュームにある場合にのみ、YES または CONSISTENT を指定します。
ユーティリティー制御ステートメントでの FlashCopy の指定により、Db2 サブシステム・パラメーターを使用して定義されている、FlashCopy に対するすべての指定がオーバーライドされます。このユーティリティーのデフォルトの動作として FlashCopy を使用することが FlashCopy サブシステム・パラメーターで指定されている場合は、ユーティリティー制御ステートメントで FLASHCOPY オプションを省略できます。
重要: 入力データ・セットが 1 シリンダー未満の場合は、FLASHCOPY 設定に関わらず、オブジェクトのコピーに FlashCopy テクノロジーが使用されないことがあります。FlashCopy が使用されない場合は、IDCAMS によってコピーが実行されます。- NO
- FlashCopy を作成しないことを指定します。FLASHCOPY では NO がデフォルト値です。
- YES
- オブジェクトをコピーするために FlashCopy テクノロジーを使用することを指定します。
- 重要: YES を指定しても、次の状況では、COPY ユーティリティーは FlashCopy を使用しない場合があります。
- FlashCopy バージョン 2 ディスク・ボリュームを使用できない
- ソース・トラックが既に FlashCopy 操作のターゲットになっている
- ターゲット・トラックが FlashCopy 操作のソースである
- コピーに関連する関係の最大数を超過した
- CONSISTENT
- 同時に SHRLEVEL CHANGE も指定した場合に、FlashCopy テクノロジーを使用してオブジェクトをコピーすること、およびコピーの整合性を保つために、コピーに含まれている非コミット処理をコピーからバックアウトすることを指定します。SHRLEVEL NONE を指定した場合、イメージ・コピーは既に整合性のある状態であり、CONSISTENT を指定する必要はありません。
整合性のある FlashCopy イメージ・コピーは、順次フォーマット・イメージ・コピーを必要としないリカバリーのために使用できます。
FLASHCOPY CONSISTENT を指定すると、ユーティリティーの処理中に追加の時間および追加のシステム・リソースが必要になります。これは、ユーティリティーがログを読み取り、変更をイメージ・コピーに適用する必要があるためです。同様に、整合性のある FlashCopy イメージ・コピーからリカバリーするのにも、ログを読み取り、以前にバックアウトされた処理を再適用するために、追加の時間および追加のシステム・リソースが必要になります。
制約事項: NOT LOGGED 属性を使用して定義されているオブジェクトをコピーする場合、CONSISTENT は指定できません。NOT LOGGED 属性を使用して定義されているオブジェクトに対し CONSISTENT を指定すると、ユーティリティーは、オブジェクトのコピーを作成せず、戻りコード 8 のメッセージ DSNU076I を発行します。
- FCCOPYDDN
- FlashCopy イメージ・コピーのデータ・セット名の作成に使用するテンプレートを指定します。FlashCopy 使用時に、LOAD 制御ステートメントで FCCOPYDDN に対して値を指定しない場合、FCCOPYDDN サブシステム・パラメーターで指定された値により、使用されるテンプレートが決まります。
- (template-name)
- FlashCopy イメージ・コピーのデータ・セット名は、テンプレート指定に従って割り振られます。表スペース・レベルまたは索引スペース・レベルの FlashCopy イメージ・コピーの場合、パーティションまたは部分ごとにデータ・セットが割り振られるため、テンプレート指定でのデータ・セット命名規則が十分な程度に固有であることを確認してください。 &DSNUM 変数を使用してください。この変数は実行時にパーティション番号または部分番号に解決されます。
- STATISTICS
- 表スペース、索引、あるいはその両方についての統計を収集することを指定します。
統計は Db2 カタログに保管されます。
他の statistics-spec オプションや correlation-stats-spec オプション をいずれも指定せずに STATISTICS キーワードを指定する場合、このユーティリティーは表スペース統計のみを収集します。統計は、基本表スペースについては収集されますが、LOB 表スペース と XML 表スペースについてはいずれも収集されません。
制約事項:- 暗号化されたデータに対して STATISTICS が指定された場合、Db2 は、 このデータに関する有用な統計を提供しない可能性 があります。
- 指定される表が表クローンの場合、STATISTICS を指定することは できません。
STATISTICS TABLE キーワードによって識別されるすべての表は、LOAD ユーティリティー制御ステートメントの INTO TABLE オプションに指定された 1 つ以上の表の表スペースに属している必要があります。
- TABLE
- 列情報の収集が行われる表を指定します。
LIST キーワードでは STATISTICS TABLE table-name を指定しないでください。代わりに、STATISTICS TABLE (ALL) を指定します。
- (ALL)
- 表スペース内のすべての表のすべての列について、情報が収集されることを指定します。
- (table-name)
- 列情報の収集が行われる表を指定します。
修飾子を省略すると、ユーティリティー・ジョブのユーザー ID が使用されます。
名前にブランクが含まれている場合は、表名を引用符で囲みます。
指定する表が複数の場合は、TABLE オプションを繰り返す必要があります。 複数の TABLE オプションは、指定可能な INDEX キーワードの完全に前または後に指定する必要があります。例えば、2 つの TABLE キーワードの間に INDEX キーワードが指定されてはなりません。
- SAMPLE integer
- 索引の非先行索引列または非索引列の統計の収集の際、サンプリングする行のパーセントを示します。
1 から 100 までの任意の値を指定することができます。
デフォルト値は 25 です。SAMPLE オプション を LOB 表スペースに対して指定することはできません。
- COLUMN
- 列情報の収集が行われる列を指定します。
このオプションを指定できるのは、統計の収集が行われる特定の表 を指定する場合 (TABLE(table-name)) に限られます。特定の表を指定し、 COLUMN オプションを指定しない場合は、デフォルト COLUMN(ALL) が使用されます。 TABLE オプションを使用するときに特定の表を指定しない場合、COLUMN オプションは指定できません。ただし、COLUMN(ALL) が指定されたと想定されます。
- (ALL)
- 表内のすべての列について、統計が収集されることを指定します。
- (column-name, …)
- 統計の収集が行われる列を指定します。
列名は、最大 10 まで指定することができます。 指定する列が複数の場合は、それぞれの名前をコンマで区切ります。
- INDEX
- 情報の収集が行われる索引を指定します。列情報の収集は、索引の最初の列について行われます。
すべての索引は同じ表スペースに関連付けられている必要があり、その表スペースは TABLESPACE オプション
で指定されたものでなければなりません。
LIST キーワードでは STATISTICS INDEX index-name を指定しないでください。代わりに、STATISTICS INDEX (ALL) を指定します。
- (ALL)
- 表スペースに含まれる表で定義されたすべての索引について、列情報を収集することを指定します。
- (index-name)
- 情報の収集が行われる索引を指定します。名前にブランクが含まれている場合は、索引名を引用符で囲みます。
COLGROUP (column-name, ...)
指定された列セットを 1 つのグループとして扱うことを示します。
このオプションによって、インライン統計は、指定された列グループでカーディナリティー値を
収集することができます。
インライン統計は、XML 表スペースおよび索引を処理しているときには COLGROUP を
無視します。COLGROUP キーワードを指定した場合は、インライン統計は指定された列グループの相関統計を収集し ます。インライン統計に分散統計も収集させる場合は、COLGROUP とともに FREQVAL オプションを指定します。
(column-name, ...) は、列グループの部分である列名を指定します。
単一列で COLGROUP を定義する場合、STATCLGSRT サブシステム・パラメーターの値を変更することによってインライン統計のパフォーマンスを向上できる可能性があります。STATCLGSRT サブシステム・パラメーターを使用すると、単一列の COLGROUP でのデータのソートを回避できます。
詳しくは、STATISTICS COLGROUP DATA SORT STG LIMIT フィールド (STATCLGSRT サブシステム・パラメーター)を参照してください。
複数の列グループを指定する場合は、COLGROUP オプションを繰り返します。
制約事項: COLGROUP 値の長さ は、SYSIBM.SYSCOLDIST カタログ表内の COLVALUE 列の最大長 を超えてはなりません。
FREQVAL
COLGROUP オプションと一緒に指定した場合、頻度統計も指定した列のグループで
収集されることを示します。(COLGROUP は、カーディナリティー統計が収集されることを示し
ます。) 1 つの統計のグループが、それぞれの列ごとに収集され
ます。COLGROUP FREQVAL では COUNT 整数を指定する必要があります。
このユーティリティーは、XML 表スペースおよび索引の処理時に FREQVAL MOST/LEAST/BOTH を無視します。
COUNT integer
指定した列グループから収集する頻度の個数を指示します。
例えば、COUNT 20 は、Db2 が列グループから、頻繁に発生する 20 個の値を収集することを意味します。
COUNT キーワードが指定されない場合、デフォルトは COUNT 10 です。
1000 以上の値を指定すると、一部の SQL ステートメントでは準備時間が長くなる可能性があります。
MOST
COLGROUP が指定された場合に、指定された列セットについて、最も頻繁に発生する値
をユーティリティーが収集することを指示します。
BOTH
COLGROUP が指定された場合に、指定された列セットで最も頻度の高い値と低い値
をユーティリティーが収集することを示しています。
LEAST
COLGROUP が指定された場合に、指定された列セットで最も頻度の低い値
をユーティリティーが収集することを示しています。


HISTOGRAM
COLGROUP オプションと共に指定された場合に、指定された列のグループに関するヒストグラム統計を収集することを示します。インライン統計では、XML 表スペースおよび索引の処理時に HISTOGRAM が
無視されます。
インライン統計を使用して収集するヒストグラム統計は、RUNSTATS を使用して収集するヒストグラム統計と同じではありません。
インライン統計によって収集するヒストグラム統計は、単なる概算統計です。
より正確な統計を得るには、RUNSTATS を使用してください。

NUMQUANTILES integer
ユーティリティーが収集する変位値の数を指定します。
整数値は 1 以上である必要があります。
指定する変位値の数は、列または列グループの値として異なる値がいくつあるのかを示す数の合計
を決して超えないような値にするべきです。変位値の数の最大数は 100 です。NUMQUANTILES キーワードが省略された場合、 NUMQUANTILES の値はデフォルトの 100 になります。表内のレコード数に 基づいて、変位値の数は最適な数に減らされます。

- KEYCARD
- KEYCARD オプションは、ユーティリティー制御ステートメントで非推奨となり、索引のキー列内の値に関するカーディナリティー統計を収集する場合に指定する必要がなくなりました。
STATISTICS オプションと INDEX オプションが指定されると、このユーティリティーは常に、索引内の 1 から n までのキー列のすべての組み合わせにある、異なるそれぞれの値をすべて収集します。n は索引内の列の数です。KEYCARD が非推奨になったことに伴い、 この機能を使用不可にすることはできなくなりました。
このユーティリティーでは、KEYCARD オプションを指定しても許容されます。STATISTICS と INDEX が指定されると、このユーティリティーでは、制御ステートメントに KEYCARD オプションが含まれている場合も除外されている場合も、メッセージは発行されません。
- FREQVAL
- 頻度値統計の収集を制御します。
FREQVAL を指定する場合は、必ずその後に NUMCOLS キーワードを指定します。
- NUMCOLS
- 指定された索引から頻度を収集する際に、一緒に連結するキー列数を示し ます。「3」の指定は、最初の 3 つのキー列の連結について 頻度を収集することを意味します。デフォルト値は 1 です。これは、Db2 が索引の先頭のキー列の頻度値を 収集することを意味します。
- COUNT
- 収集する頻度の個数を指示します。 「15」を指定すると、Db2 は指定されたキー列から 15 個の 頻度値を収集します。デフォルト値は 10 です。
HISTOGRAM
指定された索引に関するヒストグラム統計が要求されることを示します。- NUMCOLS
- 指定された索引からヒストグラム統計を収集する際に連結するキー列の数。
- NUMQUANTILES
- NUMQUANTILES に続く整数値は、要求される変位値の数を示します。 この整数値は 1 以上でなければなりません。
ヒストグラム統計は、順序が同じキーについてのみ収集できます。 ヒストグラム統計で、指定されたキー列の順序が混合している場合、DSNU633I 警告メッセージが出されます。

- REPORT
- 収集される統計を報告するためのメッセージのセットを生成するかどうかを
指定します。
- NO
- メッセージのセットが出力として SYSPRINT に送られないことを示します。
- YES
- メッセージのセットが出力として SYSPRINT に送られることを示します。 生成されるメッセージは、RUNSTATS ユーティリティーで指定する キーワード (TABLESPACE、INDEX、TABLE、COLUMN など) の組み合わせによって異なります。 ただし、これらのメッセージは UPDATE オプションの指定に応じて変わる ことはありません。REPORT YES にすると、常に SPACE および ACCESSPATH 統計のレポートが生成されます。
- UPDATE
- 収集された統計をカタログ表に挿入するかどうかを示します。
また、UPDATE によって、アクセス・パスの選択に使用される統計、またはデータベース管理者が使用する統計を選択することもできます。
- ALL
- すべての収集された統計をカタログ内で更新することを示します。
- ACCESSPATH
- アクセス・パスの選択に使用される統計を提供するカタログ表の列のみを更新することを示します。
- SPACE
- データベース管理者が、特定の表スペースまたは索引の状況を評価するときに役立つ統計を 提供するカタログ表の列のみを更新することを示します。
- NONE
- 収集された統計でカタログ表を更新しないことを示します。 このオプションは、REPORT YES が指定されている場合にのみ有効です。
- HISTORY
- カタログ表の挿入または更新をすべてカタログ履歴表に記録することを
指定します。
デフォルト値は、パネル DSNTIP6 の STATISTICS HISTORY フィールドで指定された値です。
- ALL
- すべての収集された統計をカタログ履歴表内で更新することを示します。
- ACCESSPATH
- アクセス・パスの選択に使用される統計を提供するカタログ履歴表の列のみを更新することを示します。
- SPACE
- スペース関連のカタログ統計のみをカタログ履歴表内で更新することを示します。
- NONE
- カタログ履歴表は、収集された統計を用いて更新しないことを示します。
- FORCEROLLUP
- RUNSTATS が実行された場合に、一部のパーティションで統計が収集されていない場合 (例えば、パーティションに何もデータがロードされていなかった場合) でも、統計の集約またはロールアップを行うかどうかを示します。
オプティマイザーは集約された統計を使用して、最適なアクセス・パスを選択します。
- YES
- 一部のパーティションにデータが存在しない場合でも、 集約またはロールアップ処理を強制的に行うことを示します。
- NO
- すべてのパーティションでデータが使用可能な場合に限り、 集約またはロールアップを行うことを示します。
- KEEPDICTIONARY
- LOAD ユーティリティーに新しいコンプレッション・ディクショナリーを作成させないようにし
ます。LOAD は、現行のコンプレッション・ディクショナリーを保存しており、それを入力データの圧縮に使用します。
このオプションによって、新しいディクショナリーの作成に関連したコストが削減されます。
XML 表スペースに関しては KEEPDICTIONARY キーワードは無視されます。REPLACE が 指定されている場合、XML 表スペースまたはパーティションの既存のディクショナリーはすべて 削除されます。REPLACE が指定されていない場合、XML 表スペースまたはパーティションの既存のディクショナリーはすべて 保管されます。
表スペースを基本行フォーマットから再配列行フォーマットに変更する REORG または LOAD REPLACE の実行中に、Db2 は KEEPDICTIONARY オプションを無視します。
このキーワードが有効なのは、ロードされる表スペースに COMPRESS YES 属性がある場合に限られます。
表スペースまたはパーティションが空 の場合、Db2 は以下のいずれかのアクションを実行します。
- コンプレッション・ディクショナリーが存在しない場合は、表スペースが SIMPLE 表スペースでない場合に限り、Db2 は ディクショナリーを作成します。
- コンプレッション・ディクショナリーが存在する場合、Db2 はその ディクショナリーを保持します。
表スペースまたはパーティションが空でないときに RESUME NO および REPLACE が指定された場合、 Db2 は、 表スペースまたはパーティションが空のときと同じアクションを実行します。
表スペースまたはパーティションが空でなく、かつ RESUME YES が指定 されている場合、Db2 は以下のいずれかのアクションを 実行します。
- コンプレッション・ディクショナリーが存在しない場合、Db2 はディクショナリーを作成しません。
- コンプレッション・ディクショナリーが存在する場合、Db2 はその ディクショナリーを保持します。
注: コンプレッション・ディクショナリーが保持されるようにするには、KEEPDICTIONARY を使用する必要があります。関連情報: - REUSE
- (REPLACE と共に使用された場合) LOAD は Db2 管理対象データ・セットを削除して再定義せずに、論理的にリセットし、
再使用することを指定します。REUSE が指定されていない場合、Db2 は、Db2 管理
対象データ・セットを削除してから再定義することで、それらをリセットします。
すべてのデータ・セットの論理リセットを行うためには、REUSE は REPLACE と共に指定する必要があります。 ただし、表スペースについて REUSE を指定し、パーティション・レベルでのみ REPLACE を指定した場合は、 置き換えられたパーティションのみが論理的にリセットされます。
データ・セットに複数のエクステントがある場合、REUSE パラメーターを指定すると、 そのエクステントは解放されません。
- LOG
- LOAD SHRLEVEL NONE および LOAD RESUME YES SHRLEVEL CHANGE の実行で、ロード・プロセスの RELOAD フェーズ中にロギングが行われるかどうかを示します。LOAD RESUME YES SHRLEVEL REFERENCE および LOAD REPLACE SHRLEVEL REFERENCE の場合は、常に LOG NOが適用されます。
- YES
- ロード・プロセス中の通常のロギングを指定します。 ロードされるレコードはすべてログに記録されます。 表スペースが NOT LOGGED 属性を持っている場合、 Db2 は、ロギングなしの LOAD を実行します。
- NO
- ロード・プロセス中にデータをロギングしないことを指定し
ます。表スペースが LOGGED 属性を持っている場合、NO オプションは、
ロードされる表がある表スペースまたはパーティションに対して COPY ペンディング制限を
設定します。この制限が取り除かれるまでは、
表スペース内の表またはパーティションはどれも SQL によって更新できません。この制限を取り除く方法については、COPY ペンディング状況のリセットを参照してください。
ロードされるのがパーティション化表スペースの単一のパーティションであり、その表スペースが副次索引を 持っている場合は、Db2 が索引構造に対する何らかの変更をログに記録すると、ビルドのフェーズ でロギングが発生することがあります。このロギングによって、異常終了が発生した場合の副次索引のリカバリーが可能となり、 さらに、並行性も可能になります。
Db2 は、 NOT LOGGED として作成された表スペースを、LOG NO が指定されているかのように扱います。 COPYDDN の指定なしで LOG NO が指定されている場合、基本表スペースは COPY ペンディング状況に なります。XML 列がヌル可能で、ロードされない場合、 基本表スペースは COPY ペンディング状況になります。
LOB 表スペースは、LOG YES で定義されているか LOG NO で定義されているかに関係なく、 Db2 が LOB 列をロードする間の ロギングに影響を及ぼします。
- NOCOPYPEND
- LOG NO が指定されていても LOAD は表スペースを COPY ペンディング
状況に設定しないことを指定します。NOCOPYPEND の指定によって、索引の通知コピー・ペンディング (ICOPY) 状況
がオンになったり、変更されることはありません。NOCOPYPEND を指定しても、LOAD 以前に設定されて
いたコピー・ペンディング状況はオフにはなりません。
他にエラーまたは警告が存在しない場合は、LOAD LOG NO NOCOPYPEND ジョブが正常に完了すると、
コード 0 が戻されます。
LOAD の際にローカル側のインライン・イメージ・コピーを作成するために COPYDDN も 指定した場合、Db2 は NOCOPYPEND の指定を無視します。 表スペースが NOT LOGGED 属性を持っている場合、NOCOPYPEND は無視されます。
重要: 表スペース 内のデータが失われてもデータを別の LOAD ジョブで容易に再作成できる場合にのみ、NOCOPYPEND オプションを 指定してください。LOAD の後に続けてイメージ・コピーを作成しない 場合、RECOVER ユーティリティーを使用して表スペースをリカバリーすることはできず、 データを失うことになります。
- WORKDDN (ddname1,ddname2)
- ソート入力およびソート出力用の一時作業ファイルの
ための DD ステートメントを指定します。LOAD が索引付きの表に関係している場合は、
ソート入出力用の一時作業ファイルが必要です。
ddname1 は、ソート入力用の一時作業ファイルの DD 名です。 デフォルト値は SYSUT1 です。
ddname2 は、ソート出力用の一時作業ファイルの DD 名です。 デフォルト値は SORTOUT です。
WORKDDN キーワードには、DD 名または前の TEMPLATE 制御ステートメントにある TEMPLATE 名指定のいずれかを指定します。 ユーティリティー処理で、指定された名前が現行ジョブ・ステップの DD 名と TEMPLATE 名の両方であることが検出された場合、ユーティリティーは DD 名を使用し ます。TEMPLATE 指定に関する詳細については、TEMPLATEを参照してください。
- SORTKEYS
- SORTBLD フェーズでは、パフォーマンスを向上させるために、索引キーのソートを
並列に行うように指定します。
- integer
- integer は、ソートされる索引キーの個数の
見積もりを指定します。
integer は、0 から 562 949 953 421 311 の間の正整数である必要があります。
以下のいずれかの条件が満たされる
場合は、デフォルト値は 0 です。
- ターゲット表には索引がなく、SHRLEVEL が NONE。
- ターゲット表に 1 つの索引がある。
- その入力がテープ上、カーソル上、PDS メンバー上、または SYSREC DD * として存在する。
- NO
- SORTKEYS デフォルトをオフにすることを指示します。
ディスク上の順次データ・セットの場合、LOAD は、入力データ・セット・サイズに基づいて SORTKEYS のデフォルト値を計算します。
同じ LOAD ステートメントで、表レベルで NUMRECS キーワードを指定する場合、SORTKEYS キーワードで整数値を指定することはできません。並列ソートをオフにするには、NUMRECS キーワード指定時に SORTKEYS NO を指定します。表間で均一に行が分散していない複数表の表スペース内にデータをロードするとき、表レベルで NUMRECS キーワードを指定すると、作業ファイル・データ・セットのサイズの見積もりが改善されます。
関連情報: - FORMAT
- 入力レコードの形式を示します。FORMAT UNLOAD、FORMAT INTERNAL、または
FORMAT SQL/DS が指定されている場合は、
これによって入力形式が一意的に決まり、INTO TABLE オプションでのフィールド仕様は
許可されません。FORMAT が省略されている場合、入力データの 形式はフィールド仕様の規則によって決められます。FORMAT DELIMITED が 指定されている場合、入力データの形式は 区切り文字で区切られたファイル形式に説明されている規則によって決められます。
- UNLOAD
- 入力レコード形式が Db2 アンロード形式と互換であることを
指定します (Db2 アンロード形式
は、UNLOAD ONLY オプションを指定した REORG の結果です)。
INTO TABLE オプションでそれぞれの表を指定している場合、REORG ユーティリティーによって アンロードされた入力レコードは、そのレコードがアンロードされた元の表にロードされ ます。REORG UNLOAD ONLY の実行時点と LOAD FORMAT UNLOAD の実行時点の間で、表の 列を追加したり、列の定義を変更しないでください。
LOAD FORMAT UNLOAD ステートメントにある WHEN 文節はすべて無視 されます。Db2 は、 レコードを、それらがアンロードされた元の同じ表に再ロードします。FORMAT UNLOAD 文節では WHEN 文節が認められないため、入力レコードは必ず該当する 表にロードされます。 ロードできない入力レコードは廃棄されます。
入力データ・セットの DD ステートメントで DCB RECFM パラメーターが指定され、 しかもそのデータ・セットの形式が REORG UNLOAD (ONLY) 操作以後に変更されていない場合、 レコード形式は可変 (RECFM=V) でなければなりません。
- SQL/DS
- 入力レコード形式が SQL/DS アンロード形式
と互換であることを指定します。ロードされる表内の列のデータ・タイプは、
SQL/DS 表内の
対応する列のデータ・タイプと同じでなければなりません。
SQL/DS 入力に 複数の表の行が含まれている場合、INTO TABLE オプションの WHEN 文節によって、 どの入力レコードがどの Db2 表にロードされるのかが 指示されます。
LOAD は、Db2 の限度よりも 長い SQL/DS ストリングをロードすることは できません。
DB2® Server for VSE & VM の下でディスクにアンロードされた SQL/DS データは、VBS レコード形式でシミュレートされた z/OS® タイプのデータ・セット内にあります。データを別のシステムに転送して、Db2 表 (例えば、DB2 Server for VSE & VM。FILEDEF は z/OS タイプのデータ・セットとしてこれを定義する必要があります) にロードする場合、この形式を検討してください。標準 CMS ファイルとしてデータ・セットを 処理すると、SQL/DS レコード・タイプの フィールドは、レコード群の中で正しくないオフセットに置かれます。 LOAD は、それらを有効な SQL/DS 入力として認識することができません。
- INTERNAL
- 入力レコード形式が、Db2 内部形式であることを指定し
ます。Db2 内部形式は、FORMAT INTERNAL オプションを指定して UNLOAD を実行することで作成される形式です。LOAD がデータを妥当性検査して Db2 内部形式であることを確認することはありません。
FORMAT INTERNAL が指定されている場合
- LOAD は、LOAD 制御ステートメント内のフィールド仕様を無視します。
- LOAD はデータ変換を行いません。
制約事項:- 入力データは、解凍された形式でなければなりません。
- FORMAT INTERNAL の指定時に LOAD が一度にロードできる表は 1 つだけです。
- FORMAT INTERNAL の指定時に LOAD は LOB 列や XML 列にデータを追加しません。LOAD は通知 CHECK ペンディング状況の基本表スペースを挿入します。
- FORMAT INTERNAL は、以下のいずれかのオプションと一緒に指定できません。
- ASCII
- CCSID
- CONTINUEIF
- DECFLOAT_ROUNDMODE
- EBCDIC
- FLOAT
OVERRIDE(IDENTITY)
- IGNOREFIELDS
- INCURSOR
- NOSUBS
- SHRLEVEL CHANGE
- UNICODE
- WHEN
- DELIMITED
- 入力データ・ファイルが区切り文字で区切られた形式であることを指定します。
データが区切り文字で区切られた形式の場合は、入力データ・セットのすべてのフィールドは、
文字ストリングまたは外部数値です。
さらに、区切り文字で区切られたファイルのそれぞれの列は、列区切り文字によって
次の列と分離されています。
指定できるそれぞれの区切り文字タイプについて、区切り文字がソース・データのコード・ページで 指定されていることを確認する必要があります。区切り文字は、文字定数または 16 進定数のいずれかで指定できます。 例えば、「#」を区切り文字として指定するには、COLDEL '#' または COLDEL X'23' のいずれかを指定できます。ユーティリティー・ステートメントが、入力ファイルとは異なる文字タイプでコーディングされている 場合 (例えば、ユーティリティー・ステートメントが EBCDIC でコーディングされていて、入力データはユニコードであるなど)、 ユーティリティー・ステートメント中の区切り文字を 16 進定数として指定する 必要があります。そのようにしないと、予測できない結果になる恐れがあります。
複数の区切り文字のタイプ (COLDEL、CHARDEL、および DECPT) に対して、同じ文字を指定することはできません。
入力データに外部形式の日付、時刻、およびタイム・スタンプが含まれている場合、区切り記号には、区切り文字と同じ文字を使用できません。
区切り文字の制約事項の詳細については、区切り文字で区切られたファイルのロードを参照してください。FORMAT DELIMITED に対するユニコード入力データは、UTF-8、CCSID 1208 でなければなりません。
FORMAT DELIMITED オプションを指定する場合は、以下のオプションはいずれも使用できません。
- CONTINUEIF
- INCURSOR
- 複数の INTO TABLE ステートメント
- WHEN
また、LOAD は、LOAD ユーティリティー制御ステートメント内で POSITION ステートメントが指定 されている場合は、いずれも無視します。
区切り文字で区切られた出力の使用および区切り文字の制約事項の詳細について は、区切り文字で区切られたファイルのロードを参照してください。 区切り文字で区切られたファイルの詳細については、区切り文字で区切られたファイル形式を 参照してください。
- COLDEL coldel
- 入力ファイルで使用する列の区切り文字を指定します。デフォルト値 はコンマ (,) です。ほとんどの ASCII と UTF-8 データの場合、この値は X'2C' であり、ほとんどの EBCDIC データの場合、この値は X'6B' です。
- CHARDEL chardel
- 入力ファイル内で使用される文字ストリング区切り文字を指定します。
デフォルト値は二重引用符 (“) です。ほとんどの ASCII と UTF-8 データの場合、この値は X'22' であり、ほとんどの EBCDIC データの場合、この値は X'7F' です。
文字ストリング区切り文字を含む文字ストリングを区切るには、文字ストリング中でそれが 使用されているところで、文字ストリング区切り文字を繰り返します。LOAD は、区切り文字で 囲まれている間で検出された区切り文字のペアは、単一の文字と解釈します。 例えば、“what a ""nice warm"" day" という句は、 what a "nice warm" day と解釈されます。 LOAD ユーティリティー は、CHAR、VARCHAR、CLOB のフィールドでのみ、これらの区切り文字の ペアを認識します。
文字ストリング区切り文字は、ストリングに CHARDEL 文字が含まれている場合のみ、必要となります。 ただし、他の文字ストリングを囲む文字ストリング区切り文字が入っていても構いま せん。UNLOAD ユーティリティーによって区切り文字で区切られた形式でアンロードされた データには、すべての文字ストリングを囲む文字ストリング区切り文字が組み込まれます。
- DECPTdecpt
- 入力ファイルで使用する小数点文字を指定します。デフォルト値はピリオド (.) です。ほとんどの ASCII と UTF-8 データの場合、この値は X'2E' であり、 ほとんどの EBCDIC データの場合、この値は X'4B' です。
注: アプリケーション・デフォルト・ロード・モジュール (デフォルトの DSNHDECP、またはユーザー指定のアプリケーション・デフォルト・ロード・モジュール) を使用する場合、指定する 10 進数値は、入力データで使用される 10 進数値と同じにする必要があります。入力データで使用される 10 進数値と一致するように 10 進数値を指定する必要があります。 - SPANNED
- レコードを VBS データ・セットからスパン・レコード・フォーマットでロードするかどうかを指定します。
- YES
- LOAD ユーティリティーでスパン・レコードからデータをロードすることを指定します。
入力データ・セットはスパン・レコード・フォーマットである必要があり、すべての LOB データおよび XML データが、レコードの最後にある必要があります。
レコードの最後にすべての LOB フィールドおよび XML フィールドがあるフィールド仕様リストを提供する必要があります。LOB 列および XML 列では、POSITION(*) を指定してください。
FORMAT SPANNED YES を指定する場合、WHEN 節の field-selection-criterion 内の LOB データや XML データを参照しないでください。
INCURSOR オプションを SPANNED YES と一緒に指定することはできません。
FORMAT SPANNED YES を指定すると、LOAD ユーティリティーは並列処理を使用しません。
- NO
- LOAD ユーティリティーで、スパン・レコード・フォーマットのデータをロードしないことを指定します。
- FLOAT
- 指定された形式の浮動小数点を LOAD が想定することを指定します。
- (S390)
- LOAD が想定する浮動小数点の形式が System/390® 16 進 浮動小数点 (HFP) 形式であることを指定します。(S390) は Db2 が浮動小数点数を保管する形式です。これは、 FLOAT キーワードが明示的に指定されていない場合のデフォルト値でもあります。
- (IEEE)
- LOAD が想定する浮動小数点数の形式が IEEE 2 進浮動小数点 (BFP) 形式で
あることを指定します。
FLOAT(IEEE) を指定すると、Db2 は、データが Db2 表にロードされるときに、BFP データを HFP 形式に変換します。Db2 が BFP から HFP への 変換を実行中に変換エラーが発生した場合、Db2 はそのレコードを 廃棄ファイルに入れます。
FLOAT(IEEE) は、FORMAT キーワードのいずれの指定とも、同時に使用することはできません。 FLOAT(IEEE) と FORMAT の両方を指定すると、Db2 はメッセージ DSNU070I を出します。
BFP 形式は、IEEE 浮動小数点と呼ばれることもあります。
- EBCDIC
- 入力データ・ファイルが EBCDIC であることを指定します。デフォルトは、EBCDIC です。
- ASCII
- 入力データ・ファイルが ASCII であることを指定します。数値、日付、時刻、 およびタイム・スタンプの内部形式が ASCII オプションによって影響を受け ることはありません。
- UNICODE
- 入力データ・ファイルがユニコードであることを指定します。UNICODE オプションが、数値の内部フォーマットに影響を及ぼすことはありません。
- CCSID
- 入力ファイルに対する最大 3 つのコード化文字セット ID (CCSID) を指定し
ます。1 番目の値は入力ファイルで検出された SBCS データに対する CCSID の指定、2 番目の値は
混合 DBCS データに対する CCSID の指定、3 番目の値は DBCS に対する CCSID の指定です。
これらの値のいずれかが省略されるか、あるいは 0 と指定された場合は、入力ファイルでの
対応するデータ・タイプの CCSID は、インストール・システムのデフォルトの CCSID と
同じであると見なされます。
つまり、入力データが EBCDIC の場合は、省略された CCSID はインストール・システムで
指定された EBCDIC CCSID と見なされ、入力データが ASCII の場合は、省略された CCSID は
インストール・システムで指定された ASCII CCSID と見なされます。
入力データ・ファイルの CCSID が、ロードされる表の CCSID と一致しない場合は、
入力データは、ロードされる前に、表 CCSID に変換されます。
integer は、有効な CCSID 指定です。
入力データがユニコードの場合、CCSID はデフォルトでシステムのインストール時に 指定されたユニコード CCSID となります。
- NOSUBS
- LOAD がストリング中の置換文字を受け入れないことを指定します。
ストリングが ASCII から EBCDIC に変換される場合、または ある CCSID が別の CCSID に変換される場合に、置換文字をストリングに入れます。 例えば、ソース CCSID (コード・ページ) に存在する文字 (コード・ポイントと 呼ばれることもある) がターゲット CCSID (コード・ページ) に存在しない 場合に、この置換が起こります。
NOSUBS オプションを指定した場合、LOAD ユーティリティーは、変換の結果 置換文字がストリングに入れられたと判断すると、次のいずれかのアクションを実行します。
- 廃棄処理がアクティブの場合: Db2 は メッセージ DSNU310I を出し、レコードを廃棄ファイルに入れます。
- 廃棄処理がアクティブでない場合: Db2 は メッセージ DSNU334I を出し、ユーティリティーは異常終了します。
- ENFORCE
- LOAD がチェック制約および参照制約を実施するかどうかを指定します。
ただし、通知参照制約は実施されないため、これは除きます。
- CONSTRAINTS
- 制約を実施することを指示します。LOAD は違反を検出すると、エラーの行を削除し、 それを示すメッセージを出します。このオプションを指定し、しかも参照制約 が存在する場合は、ソート入力およびソート出力のデータ・セットを定義しておく必要があります。
- NO
- 制約を実施しないことを指示します。このオプションは、その表に対して少なくとも 1 つ の参照制約またはチェック制約が定義されている場合に、ターゲット表スペースを CHECK ペンディング状況にします。
NOCHECKPEND
ターゲット表に対して少なくとも 1 つの参照制約またはチェック制約が定義されている場合、LOAD ではそのターゲット表スペースは CHECK ペンディング状況に設定されないことを指定します。
このオプションが適用されるのは、LOAD ユーティリティーによって ENFORCE NO が指定または強制されている場合のみです。NOCHECKPEND を指定しても、LOAD の実行前に設定されていた CHECK ペンディング状況は解除されません。
- ERRDDN ddname
- エラー処理で使用される作業データ・セットの DD ステートメントを指定します。
処理中に検出されたエラーの情報は、このデータ・セットに保管されます。
廃棄処理を要求した場合は、SYSERR データ・セットが必要です。
ddname は DD 名です。
デフォルト値は、SYSERR です。
ERRDDN キーワードには、DD 名または前の TEMPLATE 制御ステートメントにある TEMPLATE 名のいずれかを指定します。 ユーティリティー処理で、指定された名前が現行ジョブ・ステップの DD 名と TEMPLATE 名の両方であることが検出された場合、ユーティリティーは DD 名を使用し ます。TEMPLATE 指定に関する詳細については、TEMPLATEを参照してください。
- MAPDDN ddname
- エラー処理で使用される作業データ・セットの DD ステートメントを指定します。
この作業データ・セットは、表の行の ID をエラーの原因となった入力レコードに関連付けるために使用され
ます。ENFORCE CONSTRAINTS が指定されていて、表が参照関係を持っている場合、または、
ユニーク索引または拡張された索引を含む 1 つ以上の表のロード中の廃棄処理を
要求する場合、SYSMAP データ・セットが必要です。
ddname は DD 名です。
デフォルト値は SYSMAP です。
MAPDDN キーワードには、DD 名または前の TEMPLATE 制御ステートメントにある TEMPLATE 名のいずれかを指定します。 ユーティリティー処理で、指定された名前が現行ジョブ・ステップの DD 名と TEMPLATE 名の両方であることが検出された場合、ユーティリティーは DD 名を使用し ます。TEMPLATE 指定に関する詳細については、TEMPLATEを参照してください。
- DISCARDDN ddname
- 廃棄データ・セットの DD ステートメントを指定します。廃棄データ・セットは、ロードされない
レコード (例えば、変換エラーを含むレコード) のコピーを保有します。
廃棄データ・セットは、ロードされた後で、(ユニーク索引エラー、参照制約違反、チェック制約違反、索引評価エラーが原因で) 除去されたレコードも保持します。RELOAD、INDEXVAL、および ENFORCE フェーズの際に、入力レコードに廃棄のフラグを立てます。
ただし、廃棄データ・セットへの書き込みは、フラグが立てられたレコードが入力データ・セットから
廃棄データ・セットへコピーされる DISCARD フェーズまで行われません。
廃棄データ・セットは、レコード形式、レコード長、およびブロック・サイズが
入力データ・セットと同じで、BSAM が書き込める順次データ・セットでなければなりません。
ddname は DD 名です。
デフォルト値は SYSDISC です。
DISCARDDN オプションを省略すると、ユーティリティー・アプリケーション・プログラムが 廃棄レコードを保管するのは JCL 入力の中に SYSDISC DD ステートメントが入っている場合 のみとなります。
TEMPLATE SUBSYS の INDDN 名を使用して、BatchPipes® ファイル を LOAD への入力として使用する場合、DISCARDDN キーワードはサポートされません。
DISCARDDN キーワードには、DD 名または前の TEMPLATE 制御ステートメントにある TEMPLATE 名のいずれかを指定します。 ユーティリティー処理で、指定された名前が現行ジョブ・ステップの DD 名と TEMPLATE 名の両方であることが検出された場合、ユーティリティーは DD 名を使用し ます。
- DISCARDS integer
- DISCARD データ・セットに書き込まれるソース・レコードの最大数を指定します。
integer の範囲は、0 から 2147483647 までです。
廃棄の最大数に達すると、LOAD は異常終了し、
廃棄データ・セットは空となり、どのレコードが廃棄されたのかは判別できなくなります。
限界値を大きくしてジョブを再始動するか、もしくはユーティリティーを終了させ
てください。
DISCARDS 0 は、最大値を設定しないことを指定します。 これによって、入力データ・セット全体を廃棄することができます。
デフォルト値は 0 です。
- SORTDEVT device-type
- 外部ソート・プログラムによって動的に割り振られる一時データ・セットの装置タイプを指定します。ソート・プログラムの SORT または OPTION オプションの DYNALLOC パラメーターで受け入れ可能なディスク装置タイプであれば、任意のタイプを指定できます。
磁気テープ装置は、ソート・プログラムではサポートされません。
SORTDEVT を省略した場合で、ソートが必要な場合は、 ソート・アプリケーション・プログラムが一時データ・セット用に必要とする DD ステートメントを指定しなければなりません。
TEMPLATE 指定では、ソート作業データ・セットの動的割り振りは行われま せん。SORTDEVT キーワードが、これらのデータ・セットの動的割り振りを制御します。
- SORTNUM integer
- ソート・アプリケーション・プログラムによって動的に割り振られる一時データ・セットの
数を指定します。
integer は一時データ・セット数で、可能な 範囲は 2 から 255 です。
SORTDEVT を省略した場合、SORTNUM は無視され ます。SORTDEVT を使用し、SORTNUM を省略した場合、ソート・プログラムへ値は渡されません。 この場合は、ソート・プログラムはそれ自体のデフォルトを使用します。
各ソートごとに最低 2 つのソート用作業データ・セットが必要です。SORTNUM 値は、このユーティリティー内の各ソート呼び出しに適用されます。例えば、3 つの 索引があり、SORTKEYS が指定されていて、並列処理を制限する制約が何も なく、SORTNUM が 8 と指定されている場合、合計で 24 個のソート作業データ・セット がジョブに割り振られます。
各ソート作業データ・セットは 16 MB 境界より上と 下の両方の仮想ストレージを使用するので、SORTNUM に指定する値が大きすぎると、 このユーティリティーは仮想ストレージ制約のために並列処理の度合いを減らすことがあり、 場合によっては、並列処理なしを意味する 1 にまで減らすこともあります。
重要: SORTNUM キーワードは、UTSORTAL サブシステム・パラメーターが YES に設定されており、かつ IGNSORTN サブシステム・パラメーターが YES に設定されている場合は無視されます。 - CONTINUEIF
- それぞれの入力レコードをより大きなレコードの一部として扱えるようにすることを示し
ます。CONTINUEIF の後に、次のいずれかの形式で条件を指定します。
(start:end) = X'byte-string' (start:end) = 'character-string'この条件が当てはまるレコードがあると、 ロードが行われる前に、次のレコードがそのレコードに連結されます。 任意の数のレコードを連結して、最大 32767 バイトまでの、より大きなレコードを作成することができます。
文字ストリング定数は、入力 データ・レコードに一致する文字セットで、LOAD ユーティリティー制御ステートメントに指定される必要があります。 データが EBCDIC の場合は LOAD 制御ステートメントに EBCDIC 定数を 指定し、データが UNICODE の場合は UNICODE 定数を指定してください。16 進形式を 使用して CONTINUEIF 条件をコーディングすることもできます。例えば、(1:1)='1' ではなく、(1:1)=X'31' を使用します。- (start:end)
- 入力レコードの桁番号を指定します。レコードの最初の桁は 1 です。
この 2 つの番号によって、入力レコードにおける継続フィールドの開始桁と終了桁が示されます。
他のフィールド位置指定 (WHEN、POSITION、または NULLIF の場合の位置指定など) では、 入力レコード内ではなく、最後にアセンブルされたロード・レコード内のフィールド位置を指しています。
継続フィールドは入力レコードから除去され、最後のロード・レコードの一部ではなくなります。
:end が省略されている場合、Db2 は、 継続フィールドの長さはバイト・ストリングまたは文字ストリングの長さであると見なします。:end が使用されていて、 その結果の継続フィールドの長さがバイト・ストリングまたは 文字ストリングの長さと等しくない場合は、短い方のストリングが埋め込まれます。 文字ストリングにはブランクが埋め込まれます。16 進数ストリングにはゼロが埋め込まれます。
- X'byte-string'
- 16 進文字のストリングを指定します。継続フィールド内のこのバイト・ストリング
は、次の入力レコードが現行のロード・レコードの続きであることを示します。
継続フィールド内の値が変わるまでは、このバイト・ストリングの値を持つレコードが連結されます。例えば、
次の CONTINUEIF 指定では、72 桁目に値 X'FF' が入っている入力レコードがあれば、LOAD はそのレコードを次の入力レコード
と連結します。
CONTINUEIF (72) = X'FF' - 'character-string'
- X'byte-string' と同じ効果を持つ文字ストリングを指定します。
例えば、次の CONTINUEIF 指定では、99 桁目と 100 桁目にストリング CC を持つ入力レコード
があれば、LOAD はそのレコードを次の入力レコードと連結します。
CONTINUEIF (99:100) = 'CC'
- IGNORE
LOAD ユーティリティーでは、示されている理由でそのユーティリティーが拒否したレコードは無視されることを指定します。廃棄が指定されている場合、無視された行は DISCARD データ・セットにロードも書き込みもされません。廃棄が指定されていない場合、無視されたレコードが原因で LOAD ユーティリティーが終了することはありません。
ユーティリティー出力内のレコード・カウント・メッセージを使用して、無視されたレコードの数を判別します。
- WHEN
- WHEN 文節に合致しないレコードを無視することを指定します。
PART
ロードされているパーティションに合致しないレコードを無視することを指定します。
CONV
変換エラーの原因となるレコードを無視することを指定します。
VALPROC
検証プロシージャーに失敗したレコードを無視することを指定します。
IDERROR
範囲外の ID 列値を持つレコードを無視することを指定します。
DUPKEY
重複キー・エラーの原因となるレコードを無視することを指定します。
ユーティリティー出力内のレコード・カウント・メッセージを使用して、無視されたレコードの数を判別します。
- 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 を指定しない場合、LOAD ステートメントでは、アプリケーション・デフォルト・ロード・モジュールの DFPDEFDM 値がデフォルト値として使用されます。アプリケーション・デフォルト・ロード・モジュールは、デフォルトの DSNHDECP、またはユーザー指定のアプリケーション・デフォルト・ロード・モジュールです。
OVERRIDE
指定したタイプの GENERATED ALWAYS 列に、アンロードしたデータを再ロードすることを許可します。
- SYSTEMPERIOD
- アンロードしたデータを GENERATED ALWAYS の行開始列または行終了列に再ロードすることを許可します。
行開始列および行終了列はシステム期間の定義に使用するためのものですが、SYSTEMPERIOD キーワードを指定する場合、その期間が存在している必要がありません。
LOAD ステートメントに OVERRIDE(SYSTEMPERIOD) を指定し、入力フィールド仕様を含める場合は、システム期間の定義に使用できるように行開始列と行終了列の両方を指定する必要があります。 これらの列の指定に NULLIF オプションと DEFAULTIF オプションを指定することはできません。
- IDENTITY
- アンロードしたデータを GENERATED ALWAYS の ID 列に再ロードすることを許可します。
LOAD ステートメントに OVERRIDE(IDENTITY) を指定し、入力フィールド仕様を含める場合は、ID 列を指定する必要があります。 この列の指定に NULLIF オプションと DEFAULTIF オプションを指定することはできません。
OVERRIDE(IDENTITY) は、INTO TABLE PART 節を付けて LOAD を実行し、生成される ID 列がパーティション索引の一部になる場合に指定してください。 (生成される ID 列は、GENERATED ALWAYS または GENERATED BY DEFAULT として定義できます。)
- TRANSID
- アンロードしたデータを、トランザクション開始 ID 列として定義した GENERATED ALWAYS 列に再ロードすることを許可します。
- NONDETERMINISTIC
- アンロードしたデータを、非 deterministic 式によって定義された GENERATED ALWAYS 列に再ロードすることを許可します。

DRAIN_WAIT integer
表スペースまたは索引をドレーンする際のユーティリティーの待ち時間を秒数で指定します。
指定される時間は、再編成されるオブジェクトについて集約した時間です。
この値は、IRLMRWT および UTIMOUT サブシステム・パラメーターによって指定された値をオーバーライドします。integer の有効な値は、0 から 1800 までです。このキーワードを省略するか、または値 0 を指定すると、このユーティリティーは IRLMRWT サブシステム・パラメーターの値を使用します。
RETRY integer
LOAD によって行われるドレーンの最大再試行回数を指定します。
integer は値 0 から 255 です。デフォルト値は、UTIMOUT サブシステム・パラメーターの値です。

RETRY_DELAY integer
再試行と再試行の間の最小所要時間を秒数で指定し
ます。integer は値 1 から 1800 です。RETRY_DELAY が指定されていない場合、LOAD は以下の 2 つの値の小さい方を使用します。- DRAIN_WAIT 値 × RETRY 値
- DRAIN_WAIT 値 × 10

SWITCHTIME
SWITCH フェーズでの DRAIN ALL の開始時刻を指定します。SWITCHTIME の最終結果とすべてのタイム・スタンプ計算が TIMESTAMP(6) に含められます。
このキーワードでは、SHRLEVEL REFERENCE の指定が必須です。これを指定すると、LOAD は SWITCH フェーズの始めにとどまり、指定された SWITCHTIME に達するまでアプリケーション・アクセスの静止を試みません。- NONE
- SWITCH フェーズでドレーンを開始する時刻を指定しません。このオプションがデフォルトの動作です。
- timestamp
- SWITCH フェーズでドレーンを開始する時刻を指定します。この時刻は、LOAD の実行時にはまだ到達していない時刻でなければなりません。
- labeled-duration-expression
- SWITCH フェーズでドレーンを開始する時刻を計算します。計算は、CURRENT TIMESTAMP もしくは CURRENT DATE に基づいて行われます。
1 つ以上の定数の値を加えるか、引いて、切り替え時刻を指定することができます。
この切り替え時刻は、LOAD の実行時にはまだ到達していない時刻でなければなりません。CURRENT TIMESTAMP および CURRENT DATE は、LOAD ステートメントが最初に処理されるときに、一度だけ評価されます。オブジェクトのリストが指定された場合は、リスト内のすべてのオブジェクトに同じ値が適用されます。
- CURRENT_DATE
- CURRENT DATE を基にして期限を計算することを指定します。
- CURRENT_TIMESTAMP
- CURRENT TIMESTAMP を基にして期限を計算することを指定します。
- WITH_TIMEZONE
- CURRENT TIMESTAMP を時間帯列と比較することを指定します。特殊レジスター CURRENT TIMESTAMP のタイム・スタンプ精度は、列のタイム・スタンプ精度と同じである必要があります。同じでない場合は、デフォルトのタイム・スタンプ精度が使用されます。CURRENT TIMESTAMP の時間帯は、特殊レジスター CURRENT TIMEZONE の値です。比較は、タイム・スタンプの協定世界時の部分を比較することによって行われます。
- 定数 (constant)
- 時間の単位を示し、その後に、7 つの期間キーワードの YEARS、 MONTHS、DAYS、HOURS、MINUTES、SECONDS、または MICROSECONDS のいずれかが続きます。これらのワードの単数形 (YEAR、MONTH、DAY、HOUR、MINUTE、SECOND、 MICROSECOND) も許容されます。

- IMPLICIT_TZ
- ロード対象のタイム・スタンプ値にタイム・ゾーンが含まれず、ターゲット列のデータ型が TIMESTAMP WITH TIME ZONE である場合に使用する暗黙的なタイム・ゾーンを指定します。
- 'timezone-string'
- 暗黙的な時間帯値を指定します。時間帯は、現地時間と UTC 間の差 (時分単位) です。時間の範囲は -12 から 14 で構成され、分は 00 から 59 で構成されます。
時間帯は、-12:59 から +14:00 の範囲の値を使用して、±th:tm の形式で指定されます。
IMPLICIT_TZ オプションを指定しないと、LOAD は IMPLICIT_TIMEZONE DECP 値から値を使用します。この DECP 値の詳細については、 IMPLICIT TIME ZONE フィールド (IMPLICIT_TIMEZONE DECP 値) を参照してください。
INTO-TABLE-spec
INTO-TABLE-spec 制御ステートメント は、複数のオプションと共に、ユーティリティー・ジョブが実行する機能を定義します。LOAD ユーティリティーを 1 回呼び出すだけで、それぞれの 表スペースごとに複数の表またはパーティションをロードすることができます。ロードされる各表ごとに、少なくとも 1 つの INTO TABLE ステートメントが必要です。 それぞれの INTO TABLE ステートメントでは、以下のことを行います。
- ロードされる表を示す。
- 入力レコード内のフィールドを記述する。
- 入力データ・セットの形式を定義する。
INTO TABLE ステートメントによって指定される表はすべて、同じ表スペースに 属している必要があります。
データが既に UNLOAD または SQL/DS 形式 であり、LOAD ステートメントで FORMAT UNLOAD または FORMAT SQL/DS が 使用されている場合、フィールド仕様は許可されません。
VBS データ・セットから XML 列または LOB 列をロードする場合、LOB 値および XML 値は、フィールド仕様リストで指定されているように、レコードの最後にある必要があります。
.-IGNOREFIELDS--NO--. >>-INTO--TABLE--table-name--+-------------------+---------------> '-IGNOREFIELDS--YES-' >--+-----------------------------------------------------------------------------------------+--> | .-INDDN -SYSREC------------------------. | '-PART--integer--+-----------+--| resume-spec |--+--------------------------------------+-' '-PREFORMAT-' +-INDDN -ddname--+-------------------+-+ | '-DISCARDDN--ddname-' | '-INCURSOR--cursor-name----------------' >--+------------------+-----------------------------------------> '-NUMRECS--integer-' >--+----------------------------------------+-------------------> '-WHEN-+-SQL/DS='table-name'-----------+-' '-| field selection criterion |-' >--+---------------------------------+------------------------->< | .-,-----------------------. | | V | | '-(---| field specification |-+-)-'
resume-spec:
(1) .-RESUME--NO-----. >>-+-+----------------+-+---------------------------------------+-+--> | '-REPLACE--+-------+--+---------------+-' | | '-REUSE-' '-| copy-spec |-' | '-RESUME--YES--------------------------------------------------' >--+----------------+------------------------------------------>< '-KEEPDICTIONARY-'
- RESUME または REPLACE の INTO TABLE で指定された値は、LOAD RESUME のデフォルト値をオーバーライドします。
field selection criterion:
>>-+-field-name--------+--=--+-X'byte-string'-----+------------>< '-(start-+------+-)-' +-'character-string'-+ '-:end-' +-G'graphic-string'--+ '-N'graphic-string'--'
field specification:
>>-| field-name-spec |------------------------------------------> >--+--------------------------------------------------------------------------+--> +-CHAR--+---------------------------------------------+--------------------+ | +-BIT-(length)-| strip-spec |-----------------+ | | +-MIXED-| strip-spec |------------------------+ | | +-BLOBF-+---------------------+-+-----------+-+ | | | '-PRESERVE WHITESPACE-' '-BINARYXML-' | | | +-CLOBF-+-------+-+---------------------+-----+ | | | '-MIXED-' '-PRESERVE WHITESPACE-' | | | '-DBCLOBF-+---------------------+-------------' | | '-PRESERVE WHITESPACE-' | +-VARCHAR--+---------------------------------------------+--| strip-spec |-+ | +-BIT-----------------------------------------+ | | +-MIXED---------------------------------------+ | | +-BLOBF-+---------------------+-+-----------+-+ | | | '-PRESERVE WHITESPACE-' '-BINARYXML-' | | | +-CLOBF-+-------+-+---------------------+-----+ | | | '-MIXED-' '-PRESERVE WHITESPACE-' | | | '-DBCLOBF-+---------------------+-------------' | | '-PRESERVE WHITESPACE-' | +-GRAPHIC-+----------+-+----------+-| strip-spec |-------------------------+ | '-EXTERNAL-' '-(length)-' | +-VARGRAPHIC--| strip-spec |-----------------------------------------------+ +-SMALLINT-----------------------------------------------------------------+ +-INTEGER-+-----------------------+----------------------------------------+ | '-EXTERNAL-+----------+-' | | '-(length)-' | +-BIGINT-------------------------------------------------------------------+ +-BINARY-+----------+-| strip-spec |---------------------------------------+ | '-(length)-' | +-+-VARBINARY------+--| strip-spec |---------------------------------------+ | '-BINARY VARYING-' | +-| decimal-spec |---------------------------------------------------------+ +-FLOAT-+----------+-+----------+------------------------------------------+ | '-EXTERNAL-' '-(length)-' | +-DATE--EXTERNAL--+---------------------+----------------------------------+ | '-(-+-length------+-)-' | | '-date-format-' | +-TIME--EXTERNAL--+---------------------+----------------------------------+ | '-(-+-length------+-)-' | | '-time-format-' | +-TIMESTAMP--EXTERNAL--+--------------------------+------------------------+ | '-(-+-length-----------+-)-' | | '-timestamp-format-' | +-TIMESTAMP-WITH-TIME-ZONE--EXTERNAL--+----------+-------------------------+ | '-(length)-' | +-ROWID--------------------------------------------------------------------+ +-BLOB---------------------------------------------------------------------+ +-CLOB-+-------+-----------------------------------------------------------+ | '-MIXED-' | +-DBCLOB-------------------------------------------------------------------+ | .-(34)-------------------. | +-DECFLOAT--+------------------------+-------------------------------------+ | +-(16)-------------------+ | | '-EXTERNAL--+----------+-' | | '-(length)-' | '-XML--+---------------------+--+-----------+------------------------------' '-PRESERVE WHITESPACE-' '-BINARYXML-' >--+------------------------------------------+---------------->< +-NULLIF--| field selection criterion |----+ '-DEFAULTIF--| field selection criterion |-'
field name spec:
>>-field-name--+-----------------------------------+----------->< +-POSITION(start-+------+-)---------+ | '-:end-' | '-CONSTANT(-+-'string'----------+-)-' +-X'hex-string'-----+ +-integer-----------+ +-CURRENT DATE------+ +-CURRENT TIME------+ +-CURRENT TIMESTAMP-+ '-NULL--------------'
strip spec:
>>-+-------------------------------------------+----------------> | .-BOTH ----. | '-STRIP--+----------+--+------------------+-' +-TRAILING-+ | (1) | '-LEADING--' +-'strip-char'-----+ '-X'strip-char'----' >--+----------+------------------------------------------------>< '-TRUNCATE-'
- GRAPHIC、BINARY、VARBINARY、または VARGRAPHIC を 指定する場合は、'strip-char' を指定できません。 X'strip-char' のみを指定できます。
decimal spec:
.-PACKED----------------------------. >>-DECIMAL-+-----------------------------------+--------------->< +-ZONED-----------------------------+ '-EXTERNAL-+----------------------+-' | .-,0-----. | '-(length-+--------+-)-' '-,scale-'
INTO TABLE のオプションの説明
- table-name
- ロードされる表の名前を指定します。
この表は、カタログに記述されていなければなりません。
この表は、カタログ表であってはならず、システム管理のマテリアライズ照会表であってもなりません。
表名がスキーマ名で修飾されていない 場合、ユーティリティー・ジョブ・ステップの呼び出し側の許可 ID が、 表名のスキーマ修飾子として使用されます。名前にブランクが含まれている場合は、表名を引用符で囲みます。
データ・セットにあるすべての LOAD レコードからのデータは、以下の場合を除き、指定された表にロードされます。
- WHEN 文節を使用しているが、データがフィールド選択基準に一致していない。
- LOAD ステートメントで FORMAT UNLOAD オプションを使用しているが、 データは INTO TABLE ステートメントで指定されていない表から来ている。
- パーティションが指定されているが、データはそのパーティションに属していない。
- データ変換エラーが発生した。
- データ変換に起因しないエラーが発生した。
- IGNOREFIELDS
- ターゲット表内の列に対応していない、入力データ・セット内のフィールドを、LOAD がスキップするかどうかを指示します。
表列に対応しないフィールドの例としては、REORG ユーティリティーで生成される、DSN_NULL_IND_nnnnn、DSN_ROWID、DSN_IDENTITY、および DSN_RCTIMESTAMP フィールドが
あります。
- NO
- LOAD の処理では、いずれのフィールドもスキップしないことを指定します。
- YES
- 入力データ・セットのフィールドのうちターゲット表の列に対応していないフィールドを LOAD が
スキップすることを指定します。
各入力レコードに可変長フィールドがあり、その後にロードしたくない可変長データが続き、 さらにその後にロードしたいデータが続くような場合、この YES の指定が役に立ちます。 このような場合、可変長フィールドであるため、POSITION キーワードを使用して、 ロードしたくない可変長データをスキップすることはできま せん。IGNOREFIELDS を指定することによって、ロードしたくない可変長データのフィールドを指定 することができます。さらに、表のいずれの列名とも異なる名前をそのフィールドに付けること によって、LOAD はそれをロードせずにスキップすることができます。
このオプションでは、列をロードしようとしても名前のつづりを誤ると、 フィールドはスキップされてしまうため、このオプションは注意の上使用してください。
- NUMRECS
指定した表または表パーティションの入力レコードの数を指定します。- integer
- 指定した表にロードする完全入力レコードの見積もり数として使用する正整数。指定された数は、CONTINUEIF 使用時に完全にアセンブルされる入力レコードを示します。
各表または各表パーティションにロードする入力レコードの数を示すには、複数表の表スペースに対し NUMRECS キーワードを使用します。
レコードの数を指定すると、索引の並列作成時にユーティリティーが必要とするソート作業データ・セットのサイジングが改善されます。LOAD ユーティリティーがソート作業データ・セットのサイズを小さく見積もると、LOAD ユーティリティーの実行が失敗する場合があります。
入力データ・セットがテープに配置されている場合、または入力レコードの一部のみロードする場合、NUMRECS キーワードも使用できます。
SORTKEYS キーワードで、表スペース・レベルで整数値を指定する場合、同じ LOAD ステートメントで NUMRECS キーワードを指定することはできません。
複数の表またはパーティションを同じ LOAD ステートメントでロードする場合、すべての表またはパーティションに対して NUMRECS キーワードを指定するか、すべての表またはパーティションに対して NUMRECS キーワードを指定しないようにする必要があります。

- PART integer
- パーティション化表スペースのパーティションにデータをロードすることを指定します。
このオプションは、パーティション化表スペース (増加対応パーティション表スペースは含まない) の場合のみ
有効です。
integer は、レコードのロード先にするパーティションの物理パーティション番号です。
パーティション並列処理が要求されている場合、同じパーティション番号を複数回指定することは
できません。指定されたパーティションの範囲外のデータは
ロードされません。最大は 4096 です。
以下の場合は、LOAD INTO PART integer は許可されません。
ID 列がパーティション索引の一部である (ただし、GENERATED ALWAYS の ID 列に OVERRIDE(IDENTITY) が指定されている場合を除く)。
- 行 ID がパーティション索引の一部である。
- 表スペースが増加対応パーティションである。
非パーティション化副次索引の場合は、LOAD PART は以下のことを行います。
- ページ・セットを REBUILD ペンディング (PSRBD) 状況に設定しない。
- キーの挿入時に、PCTFREE または FREEPAGE 属性を考慮しない。
- PREFORMAT
- 残りのページについて、パーティションとそれに対応するパーティション索引スペースの 割り振り済み RBA の最高位置まで、事前フォーマット設定することを指定します。 この事前フォーマット設定は、データがロードされ、索引が作成された後に行われます。
- INDEXDEFER
- 索引作成を LOAD の BUILD フェーズ中に行うか、それとも REBUILD INDEX を手動で実行するまで据え置くかを指定します。特に PART を指定した LOAD の場合、索引作成を据え置くと、LOAD のパフォーマンスが向上します。LOAD 中に索引が作成されない場合、LOAD は影響を受ける索引を REBUILD ペンディング状態にします。
- NONE
- LOAD の BUILD フェーズ中に索引を作成することを指定します。
- ALL
- LOAD ユーティリティーの BUILD フェーズの一部として索引を作成しないことを指定します。索引作成は、REBUILD INDEX を手動で実行するまで据え置かれます。ALL は、SHRLEVEL NONE も指定されている場合のみ有効です。
- NPI
- LOAD ユーティリティーの BUILD フェーズの一部として非パーティション化索引を作成しないことを指定します。非パーティション化索引の作成は、REBUILD INDEX を手動で実行するまで据え置かれます。NPI は、SHRLEVEL NONE も指定されている場合にのみ有効です。
- NONUNIQUE
- 非ユニーク索引の作成のみを据え置くことを指定します。NONUNIQUE は、ALL または NPI も指定されている場合にのみ有効です。NONUNIQUE を指定しないと、ユニーク索引と非ユニーク索引の作成が据え置かれます。ロードしようとしている表に対してユニーク索引が定義されている場合は、データが実際にユニークでなければ、NONUNIQUE を指定してください。REBUILD INDEX は、ユニーク索引の重複キーを解決しません。
INDEXDEFER ALL あるいは INDEXDEFER NPI が指定されている場合
- ENFORCE CONSTRAINTS も指定されている場合は、索引外部キーの作成は据え置かれません。
- RESUME も指定されている場合は、DEFINE NO を指定して作成され、現時点でも未定義の索引の作成は据え置かれません。未定義の索引の作成が据え置かれるのは、REPLACE が指定されている場合に限られます。
いずれかの LOAD REPLACE SHRLEVEL REFERENCE PART を実行するとデフォルトの INDEXDEFER NPI が使用され、その影響を受けるパーツ・レベルの非パーティション索引は、LOAD が正常に完了すると RBDP 状況になります。NONUNIQUE は指定されても無視されます。
- RESUME
- 空のパーティションにレコードがロードされるのか、空でないパーティションにロードされるのかを指定します。
非セグメント化表スペースの場合、削除済みのマークが付いている行のためのスペースは再使用されません。
あるいはドロップ済みの表の行が占有していたスペースは再使用されません。RESUME オプションが表スペース・レベルで指定されている
場合は、PART 文節で RESUME オプションを指定することはできません。
RESUME オプションを表スペース全体に適用する場合は、LOAD RESUME オプションを使用します。RESUME オプションを特定のパーティションに適用する 場合は、PART integer RESUME を使用することによって指定します。
- NO
- レコードを空のパーティションにロードします。
パーティションが空ではなく、しかも REPLACE を使用していない場合は、メッセージが出され、ユーティリティー・ジョブ・ステップは
ジョブ・ステップ条件コード 8 で終了します。
削除された行またはドロップされた表の行を含む非セグメント化表スペースの場合、REPLACE キーワードを使用すると効率が上がります。
- YES
- レコードを非空のパーティションにロードします。パーティションが空の場合は、 警告メッセージが出されますが、パーティションはロードされます。
- REPLACE
- 表スペース全体ではなく、PART オプションで引用したパーティションの内容のみを
置き換えることを示します。
LOAD REPLACE は、INTO TABLE の PART integer REPLACE オプションと併用することは できません。REPLACE オプションを指定した場合は、LOAD REPLACE を使用して表スペース全体を 置き換えるか、もしくは INTO TABLE の PART integer REPLACE オプションを使用して 単一のパーティションを置き換える必要があります。 ただし、PART integer REPLACE は LOAD RESUME YES と併用することができます。
- REUSE
- REPLACE オプションと共に使用された場合、LOAD が Db2 管理対象データ・セットを、削除してから再定義せずに、論理的にリセットし、
再使用することを指定します。
REUSE が指定されていない場合、Db2 は、Db2 管理
対象データ・セットを削除してから再定義することで、それらをリセットします。
PART の指定で REPLACE と共に REUSE を指定した場合 (表スペース・レベルの LOAD に対してではなく)、 指定されたパーティションのみが論理的にリセットされます。 表スペースに対しては REUSE、かつパーティションに対しては REPLACE を指定した場合は、置き換えられ た部分のデータ・セットは論理的にリセットされます。
- KEEPDICTIONARY
- LOAD ユーティリティーが新しいディクショナリーを作成しないように指定し
ます。LOAD は、現行ディクショナリーを保持し、それを入力データの圧縮に使用します。
このオプションによって、新しいディクショナリーの作成に関連したコストが削減されます。
このキーワードが有効であるのは、ディクショナリーが存在し、かつ、ロードされるパーティション が COMPRESS YES 属性を持っている場合に限られます。
パーティションが COMPRESS YES 属性を持っていていても、ディクショナリーが存在しない場合は、 新しいディクショナリーが作成され、エラー・メッセージが出されます。
- INDDN ddname
- パーティション用の入力データ・セットを示すデータ定義 (DD) ステートメント
またはテンプレートを指定します。
入力データ・セットのレコード形式は、固定あるいは可変でなければなりません。
データ・セットは、基本順次アクセス方式 (BSAM) で読み取れるものでなければなりません。
ddname は入力データ・セットの名前です。
デフォルト値は SYSREC です。INDDN は、テンプレート名が可能です。
ファイル参照変数を 使用して LOB データをロードする場合は、この入力データ・セットには、LOB 列値が入ったファイルの 名前が含まれている必要があります。各ファイルは、順次ファイル、PDS メンバー、 PDSE メンバー、または独立した HFS ファイル のいずれかが可能です。
1 つの INTO TABLE PART 指定で INDDN を指定し (DISCARDDN の有無に関係なく)、 複数の INTO TABLE PART 文節を指定する場合、すべての INTO TABLE PART 指定 で INDDN を指定する必要があります。
INDDN をパーティション・レベルで指定し、複数の PART 文節を 指定する (それぞれに独自の INDDN を用いて) ことによって、ロード・パーティションの 並列処理が可能となり、パフォーマンスを著しく高めることができます。 表スペースに 1 つ以上の非パーティション化副次索引がある場合には、 別々のジョブを同時に行うのではなく、ロード・パーティションの並列処理を用いて、 単一ジョブですべてのパーティションをロードすることをお勧めします。
フィールド仕様は、各入力ファイルに別々に適用されます。 したがって、複数の INTO TABLE PART INDDN 文節が使用される場合には、 それぞれの文節にフィールド仕様が必要です。
- DISCARDDN ddname
- パーティションの DISCARD データ・セットに対して、使用する DD ステートメントを指定します。
DISCARD データ・セットには、ロードされないレコード (例えば、変換エラーを含んでいる) のコピー
が入っています。
また、廃棄データ・セットには、ロードされてから (ユニーク索引エラー、あるいは参照制約違反または
チェック制約違反のために) 除去されたレコードのコピーも保持されます。
LOAD ステートメントに DISCARDS n が指定されていて、LOAD パーティションの並列処理が有効な場合は、INTO TABLE PART 文節に DISCARDDN を指定することが推奨されます。パーティションのロードを参照してください。
RELOAD、INDEXVAL、および ENFORCE フェーズの際に、入力レコードに廃棄のフラグを立てます。 ただし、フラグが立てられたレコードをユーティリティーが入力データ・セットから DISCARD データ・セットにコピーする DISCARD フェーズまで、ユーティリティーは DISCARD データ・セットを書き込みません。
DISCARD データ・セットは、順次データ・セットでなければならず、また、レコード形式、 レコード長、およびブロック・サイズが入力データ・セットと同じで、BSAM による書き込み アクセスが可能でなければなりません。
ddname は、廃棄データ・セットの名前です。DISCARDDN は、テンプレート名が可能です。
DISCARDDN オプションを省略すると、LOAD は廃棄レコードを保管しません。
- INCURSOR cursor-name
- 入力データ・セットに対するカーソルを指定します。LOAD ユーティリティーがカーソルを使用する前に、カーソルを宣言しておく必要があります。EXEC SQL ユーティリティー制御ステートメント
を使用して、カーソルを定義します。
カーソルを定義した表と同じ表にデータをロードすることはできません。
指定されたカーソルは、Db2 ファミリーのクロスローダー機能の一部として使用できます。クロスローダー機能によってユーザーは、DRDA 準拠のいずれのリモート・サーバーからでも、データをロードすることができます。クロスローダー機能の使用上の詳細については、クロスローダー機能を使用したデータのロードを参照してください。
cursor-name はカーソル名です。 LOAD ユーティリティーで指定されるカーソル名の長さは 8 文字を超えてはなりません。
INCURSOR オプションは、以下のオプションとの併用はできません。
- SHRLEVEL CHANGE
- NOSUBS
- FORMAT UNLOAD
- FORMAT SQL/DS
- CONTINUEIF
- WHEN
SPANNED YES
さらに、INCURSOR オプションと一緒にフィールド仕様を指定することはできません。
- WHEN
- 入力データ・セットのどのレコードがロードされるかを示し
ます。WHEN 文節を指定しない場合 (かつ、FORMAT UNLOAD を LOAD ステートメントで使用しない場合) は、
入力データ・セットのすべてのレコードが、指定した表または
パーティションにロードされます。(指定したパーティションの範囲を超えるデータはロードされません。)
WHEN に続くオプションによって条件を記述します。これにより、条件を満たす入力レコード がロードされます。どの INTO TABLE ステートメントのどの WHEN 文節も満たさない入力レコードは、破棄データ・セットが使用されていて IGNORE(WHEN) オプションが指定されていなければ、廃棄データ・セットに書き込まれます。
文字ストリング定数は、入力 データ・レコードに一致する文字セットで、LOAD ユーティリティー制御ステートメントに指定される必要があります。 データが EBCDIC の場合は LOAD 制御ステートメントに EBCDIC 定数を 指定し、データが UNICODE の場合は UNICODE 定数を指定してください。16 進形式を 使用して WHEN 条件をコーディングすることもできます。例えば、(1:1)='1' ではなく、(1:1)=X'31' を使用します。- SQL/DS='table-name'
- FORMAT SQL/DS オプションが LOAD ステートメントで使用されている場合に限り有効です。
table-name は、アンロード・データ・セットにアンロードされている表の名前 です。INTO TABLE の後の表名は、どの Db2 表 に SQL/DS 表が ロードされるのかを示します。名前にブランクが含まれている場合は、表名を引用符で囲みます。
WHEN 文節が指定されていない場合、 すべての SQL/DS 表からの 入力レコードが、INTO TABLE の後に指定された表にロードされます。
- field-selection-criterion
- フィールドおよび文字定数を記述します。そのフィールドに指定の定数が入っている
レコードのみが、INTO TABLE の後に指定された表にロードされます。
選択基準のフィールドは、以下のことが必要です。
- 文字またはグラフィック・ストリングが入っていること。 入力レコードのフィールド内容がストリング定数と比較される際、データ・タイプの変換は行われません。
- アセンブルされた各入力レコードで、同じオフセットのバイトから始まっていること。 選択フィールドより前に、可変長ストリング (長さフィールドが一緒に 格納されている) があるレコードは、選択フィールドが常に同じオフセットから始まるように、 埋め込みをしておく必要があります。
このフィールドと定数は、同じ長さである必要はありません。 同じ長さではない場合、比較する前にいずれか短い方に埋め込みが行われます。 文字とグラフィック・ストリングにはブランクが埋め込まれ ます。16 進数ストリングにはゼロが埋め込まれます。- field-name
- field-specification によって定義されたフィールドの名前を指定します。 field-name が使用される場合、 フィールドの開始位置と終了位置は、フィールド仕様の POSITION オプションで与えられます。
- (start:end)
- 組み立てられたロード・レコードの桁番号を示します。レコードの最初の桁が 1 です。
この 2 つの番号がロード・レコードにおける選択フィールドの開始桁と終了桁を示しています。
:end を使用しない場合は、フィールドの長さは定数と同じと見なされます。
- X'byte-string'
- 16 進文字のストリングとしての定数を示します。例えば、
次の WHEN 文節は、33 桁目と 34 桁目に値 X'FFFF' が入っているレコードがロードされる
ことを指定しています。
WHEN (33:34) = X'FFFF' - 'character-string'
- 文字のストリングとしての定数を示します。
例えば、次の WHEN 文節では、レコードは、フィールド DEPTNO の値が D11 の場合
にロードされるように指定しています。
WHEN DEPTNO = 'D11'
フィールドで特定の外部形式の日付、時刻、またはタイム・スタンプが使用されている場合、その指定された形式と一致する文字ストリングをフィールド指定に使用する必要があります。
- G'graphic-string'
- 2 バイト文字のストリングとしての定数を示します。
例えば、次の WHEN 文節では、レコードは、33 桁目から 36 桁目に指定された値を持っている
場合にロードされるように指定しています。
この例では、 < はシフトアウト文字、* は 2 バイト文字、 > はシフトイン文字です。WHEN (33:36) = G'<**>'入力データの最初あるいは最後のバイトがシフトアウト文字の場合は、 比較の際に無視されます。G は大文字で指定します。
- N'graphic-string'
- 2 バイト文字のストリングとしての定数を示します。N と G は、グラフィック・ストリング定数を指定する上では同じ意味 です。N は大文字で指定してください。
- (field-specification, …)
- ロードされるデータの場所、形式、および NULL 値 ID を記述します。
フィールド仕様がまったく使用されていない場合、以下のようになります。
- 入力レコード内のフィールドは、Db2 表 内の順序と同じであると想定されます。
- LOAD ステートメントで FORMAT オプションを使用している場合は、 それによってフォーマット設定が行われます。
- 入力の固定ストリングは、最大固定長のストリングと見なされ ます。VARCHAR フィールドと VARGRAPHIC フィールドには、データの前に有効な 2 バイトの 2 進数の 長さフィールドが含まれていなければなりません。VARCHAR フィールドまたは VARGRAPHIC フィールド とそれに続くフィールドとの間のギャップは許可されません。
- BINARY フィールドは、最大固定長であると想定されます。
- VARBINARY フィールドには、データの前に有効な 2 バイトの 2 進数の長さフィールド が含まれていなければなりません。
- ROWID フィールドは可変長であり、データの前に有効な 2 バイトの 2 進数の長さフィールド を持っている必要があります。ROWID フィールドと後続のフィールドの間にギャップがあってはなりません。
- LOB フィールドは、可変長であり、データの前に 4 バイトの有効な 2 進数の長さフィールド が含まれていなければなりません。フィールドとそれに続くフィールドとの間のギャップは許可されません。
- 数値データは、適切な内部 Db2 数表現であると想定されます。
- NULLIF または DEFAULTIF オプションは使用できません。
入力表に対してフィールド仕様が使用されている場合、 表のフィールドのうちデフォルト値のないフィールドには、フィールド仕様が存在している必要があります。 表のフィールドに対応するフィールド指定がないものがあれば、そのデフォルト値がロードされます。
出力表の列が、フィールド指定もなく、NOT NULL として定義されており、デフォルト もない場合は、ユーティリティー・ジョブ・ステップは終了します。
ID 列または 行変更タイム・スタンプ列をフィールド仕様で指定できるのは、 それらの列が GENERATED BY DEFAULT 属性で定義されている場合のみです。
アプリケーションまたはシステムのテンポラル・データをロードしようとしており、フィールド仕様を組み込む場合は、開始時刻と終了時刻の両方の列のフィールドを指定しなければなりません。
- field-name
- フィールドの名前を指定します。どのような名前でも構いません。
このフィールドがロードされる場合、その名前は、IGNOREFIELDS が指定されていない限り、INTO TABLE の後に
指定されている表内の列名でなければなりません。
フィールド名を、入力となるデータの範囲を指定する手段として使用することができます。
選択したレコードを空の表スペースにロードする例については、例 4: 異なる
データ・タイプのデータをロードするを参照してください。
フィールドの開始位置は、POSITION オプションで指定されます。POSITION を使用しない場合、 開始位置は、直前のフィールドの終わりから 1 桁後になります。
LOAD は、下にリストされている順序で、以下のいずれかの方法でフィールドの長さを決定します。
- フィールドのデータ・タイプが VARCHAR、VARGRAPHIC、VARBINARY、ROWID、または XML の場合、
データの前の 2 バイトの 2 進数フィールドに長さが入っていると想定されます。VARCHAR、VARBINARY、および XML フィールド
の場合、長さはバイト数で表されています。VARGRAPHIC フィールドの場合、長さフィールドは、2 バイト文字の数を
示します。
フィールドのデータ・タイプが CLOB、BLOB、または DBCLOB の場合、長さは、 データの前の 4 バイトの 2 進数フィールドに含まれているものと見なされ ます。BLOB および CLOB フィールドの場合は長さはバイトであり、DBCLOB フィールドの場合 は長さのフィールドは 2 バイト文字数を示しています。
- POSITION オプションで :end が使用されている場合、 長さは、start と end から計算されます。 この場合、CHAR、GRAPHIC、INTEGER、DECIMAL、 FLOAT、または DECFLOAT 指定の後の長さ属性は無視されます。
- CHAR、GRAPHIC、INTEGER、DECIMAL、FLOAT、 または DECFLOAT 仕様の長さ属性が長さとして使用されます。
- 長さは、表定義の Db2 フィールド記述から取得されるか、
データ・タイプに従ってデフォルト値が割り当てられます。DATE および TIME フィールドの場合、
長さは、インストール時に定義されています。可変長フィールド
の場合、長さは Db2 表定義内の列から定義されます。
ただし、ヌル標識バイトがあればそれは除きます。次の表に、各データ・タイプのデフォルト長 (バイト) を
示します。
表 1. 各データ・タイプのデフォルトの長さ (バイト) データ・タイプ デフォルトの長さ (バイト) BIGINT 8 BINARY 列定義で使用される長さ BLOB 可変長 CHARACTER 列定義で使用される長さ CLOB 可変長 DATE 10 (またはインストール・システムのデフォルト) DBCLOB 可変長 DECFLOAT(16) 8 DECFLOAT(34) 16 DECIMAL EXTERNAL 10 進数の出力列の場合は 10 進数の精度。 それ以外の場合は列定義で使用される長さ。 DECIMAL PACKED 列定義で使用される長さ DECIMAL ZONED 10 進数の出力列の場合は 10 進数の精度。 それ以外の場合は列定義で使用される長さ。 FLOAT (単精度) 4 FLOAT (倍精度) 8 GRAPHIC 列定義で使用される長さの 2 倍 INTEGER 4 MIXED 混合 DBCS データ ROWID 可変長 SMALLINT 2 TIME 8 (またはインストール・システムのデフォルト) TIMESTAMP 26 VARBINARY 可変長 VARCHAR 可変長 VARGRAPHIC 可変長 XML 可変長 TIMESTAMP WITH TIME ZONE 33
フィールドのデータ・タイプが指定されていない 場合、そのフィールドのデータ・タイプは、そのフィールドがロードされる先の列 について Db2 表定義に指定されているデータ・タイプ と同じであると想定されます。
- フィールドのデータ・タイプが VARCHAR、VARGRAPHIC、VARBINARY、ROWID、または XML の場合、
データの前の 2 バイトの 2 進数フィールドに長さが入っていると想定されます。VARCHAR、VARBINARY、および XML フィールド
の場合、長さはバイト数で表されています。VARGRAPHIC フィールドの場合、長さフィールドは、2 バイト文字の数を
示します。
- POSITION(start:end)
- 組み立てられたロード・レコードのどこにフィールドがあるのかを示します。
start および end は、フィールドの最初と最後の桁の位置です。 レコードの最初の桁は 1 です。このオプションは省略することができます。
桁の位置は、次のように指定することができます。
- 整数の n。これは実際の桁番号を意味します。
- *。これは前のフィールドの終わりから 1 桁後を意味します。
- *+n (ここで、n は整数)。 これは * によって指示された位置の n 桁後を意味します。
POSITION オプション指定の全体を括弧で囲まないでくだ さい。start:end 記述のみを括弧で囲んでください。次の表に、有効な指定と無効な指定を示します。
表 2. POSITION の有効な指定と無効な指定の例 有効 無効 POSITION (10:20) (POSITION (10:20))
CONSTANT(...)
フィールド名に一致する列を定数値と一緒にロードするよう指定します。
CONSTANT キーワードに関連付けられているフィールド名は、指定された表の列名に一致する必要があります。CONSTANT フィールドの長さとタイプは指定された値から生成され、ターゲット列に有効であることが必要です。CONSTANT フィールドの場合、他のフィールド指定オプションは指定できません。LOB 列や XML 列に CONSTANT フィールドを指定することはできません。
CONSTANT キーワードで無効な値が指定されたためにレコードが廃棄された場合、廃棄データ・セット内のレコードは、その定数値 (複数の場合もある) を使用してロードされたレコードではなく、SYSREC からの当初のレコードを反映しています。
- 'string'
- ターゲット列に挿入する文字ストリングを指定します。指定されたストリングが 'string' という形式の場合、それは、たとえ SYSREC のコード化スキームが同じでなくても、SYSIN のコード化スキームに含まれるものと想定されます。このストリングをターゲット列に挿入する前に、変換を適用することもできます。
- X'hex-string'
- ターゲット列に挿入する 16 進値を指定します。16 進値は、X'hex-string' の形式で指定する必要があります。
- integer
- ターゲット列に挿入する整数を指定します。有効な値は、-2147483648 から 2147483647 までです。
- CURRENT DATE
- ターゲット列に現在日付を挿入することを指定します。
- CURRENT TIME
- ターゲット列に現在時刻を挿入することを指定します。
- CURRENT TIMESTAMP
- ターゲット列に現在のタイム・スタンプを挿入することを指定します。
- NULL
- ターゲット列に NULL を設定するよう指定します。ターゲット列は NULL 可能であることが必要です。

フィールド仕様におけるデータ・タイプ: 下記のいずれかのキーワードで、フィールドのデータ・タイプを指定できます。 グラフィックス・フィールドの場合を除き、length は、バイト数で表した入力フィールドの長さです。
EXTERNAL と指定された数字は、入力レコードではすべて同じ形式です。
- CHAR(length)
- 固定長文字ストリングを指定します。length を指定しない
場合、ストリングの長さは、POSITION 指定から決められます。length また
は POSITION を指定しない場合、LOAD は CHAR のデフォルトの長さ (表の列の長さで決まる) を使用します。また、CHARACTER および CHARACTER(length) を指定することもでき
ます。
CLOBF、BLOBF、 または DBCLOBF のファイル名に対してタイプを CHAR と指定する場合、LOAD ユーティリティーが正しいファイル名を 指定できるように、長さも指定する必要があります。そうしないと、無効な列仕様についての メッセージ DSNU338I が発行されます。
- BIT
- 入力フィールドに BIT データが含まれていることを指定し ます。BIT が指定されている場合、LOAD は、入力データに対する CCSID 変換をバイパスします。 ターゲット列が BIT データ・タイプ属性を持っている場合は、LOAD は、入力データに対する コード・ページ変換はいずれもバイパスします。
- MIXED
- 入力フィールドが、SBCS と DBCS データの混合であることを指定し ます。 MIXED を指定した場合は、CCSID 変換が必要であれば入力データに対して混合 CCSID を使用します。MIXED を指定しない場合は、そのような変換では入力データに対して SBCS CCSID を使用します。
- BLOBF
- 入力フィールドに、指定された BLOB/XML 列にロードされる BLOB ファイルの名前が入っている
ことを示します。
BINARYXML ファイル参照変数を使用してロードされる XML 文書が Extensible Dynamic Binary XML Db2 Client/Server Binary XML Format (バイナリー XML 形式) であることを指定します。
- CLOBF
- 入力フィールドに、指定された CLOB/XML 列にロードされる CLOB ファイルの名前が入っている ことを示します。
- DBCLOBF
- 入力フィールドに、指定された DBCLOB/XML 列にロードされる DBCLOBF ファイルの名前が入っている ことを示します。
- PRESERVE WHITESPACE
- XML 列内の空白文字が保持されることを指定します。デフォルトでは、空白文字は 保持されません。
- STRIP
- データの先頭、末尾、または両端から、LOAD がゼロを除去 (デフォルト) または指定された文字を
除去することを指定します。LOAD は、CHAR フィールドに対する
埋め込みを行って、列の残りの部分を埋めます。
LOAD は、文字コード変換または埋め込みを行う前に、除去操作を適用します。
STRIP オプションの効果は、SQL STRIP スカラー関数の場合と同じです。
- BOTH
- データの先頭および末尾から、LOAD がブランクまたは指定された除去文字を 除去することを指定します。
- TRAILING
- データの末尾から、LOAD がブランクまたは指定された除去文字を除去することを指定します。
- LEADING
- データの先頭から、LOAD がブランクまたは指定された除去文字を除去することを指定します。
- 'strip-char'
- LOAD がデータから除去する 1 バイト文字または 2 バイト文字を指定します。
この文字の値は EBCDIC で指定してください。LOAD は、入力コード化スキームに応じて 、strip-char 値が除去操作で使用される前に、SBCS CCSID 変換を適用します。
ロードされる列のサブタイプが BIT の場合、または、EBCDIC 以外のコード化スキームで strip-char 値を 指定する場合は、16 進形式 (X'strip-char') を使用してください。 LOAD は、16 進形式が使用されている場合は、CCSID 変換は行いません。
- X'strip-char'
- LOAD がデータから除去する 1 バイト文字または 2 バイト文字を 16 進形式で指定
します。1 バイト文字の場合は、この値を X'hh' の形式 (hh は 2 個の 16 進文字) で
指定してください。2 バイト文字の場合は、この値を X'hhhh' の
形式 (hhhh は 4 個の 16 進文字) で指定してください。
EBCDIC 以外のエンコード化スキームで文字を指定するには、16 進形式を使用 します。16 進形式で文字の値を指定すると、LOAD は、CCSID 変換は行いません。
除去文字を 16 進形式で指定した場合は、入力コード化スキームでその文字を 指定する必要があります。
- TRUNCATE
- 入力文字ストリングがターゲット列に収まらない場合に LOAD がそのストリングを右側から
切り捨てることを指示します。LOAD は、CCSID 変換の後で、切り捨て操作を行います。
入力データが BIT データの場合、LOAD はバイト境界でデータを切り捨てます。 入力データが SBCS または MIXED データの場合、LOAD は文字境界でデータを切り捨て ます。(2 バイト文字が分割されることはありません。) MIXED フィールドが列に収まるように切り捨て られた場合は、切り捨てられたストリングは指定された列のサイズよりも短くなる可能性があります。 このような場合は、出力 CCSID でブランクが右側に埋め込まれ ます。MIXED データが EBCDIC の場合は、切り捨ての際に DBCS ストリングの前後の SO (シフトアウト) およ び SI (シフトイン) 文字は保持されます。
- VARCHAR
- 可変長の文字フィールドを指定します。バイトで表した長さを、データの前の 2 バイト
の 2 進数フィールドに指定する必要があります。(この長さには、2 バイト・フィールド自体は含まれません。)
長さフィールドは、POSITION オプションの start で指定された桁から
始まる必要があります。:end は指定しても、無視されます。
- BIT
- 入力フィールドに BIT データが含まれていることを指定し ます。BIT が指定されている場合、LOAD は、入力データに対する CCSID 変換をバイパスします。 ターゲット列が BIT データ・タイプ属性を持っている場合は、LOAD は、入力データに対する コード・ページ変換はいずれもバイパスします。
- MIXED
- 入力フィールドに混合した DBCS データが含まれていることを指定します。 MIXED を指定した場合は、CCSID 変換が必要であれば入力データに対して混合 CCSID を使用します。MIXED を指定しない場合は、そのような変換では入力データに対して SBCS CCSID を使用します。
- BLOBF
- 入力フィールドに、指定された BLOB/XML 列にロードされる BLOB ファイルの名前が入っている
ことを示します。
BINARYXML。ファイル参照変数を使用してロードされる XML 文書がバイナリー XML 形式であることを指定します。
- CLOBF
- 入力フィールドに、指定された CLOB/XML 列にロードされる CLOB ファイルの名前が入っている ことを示します。
- DBCLOBF
- 入力フィールドに、指定された DBCLOB/XML 列にロードされる DBCLOBF ファイルの名前が入っている ことを示します。
- PRESERVE WHITESPACE
- XML 列内の空白文字が保持されることを指定します。デフォルトでは、空白文字は 保持されません。
- STRIP
- データの先頭、末尾、または両端から、LOAD がゼロを除去 (デフォルト) または指定された文字を
除去することを指定します。LOAD は、VARCHAR の長さフィールドを除去されたデータの長さに合わせます。
LOAD は、文字コード変換または埋め込みを行う前に、除去操作を適用します。
STRIP オプションの効果は、SQL STRIP スカラー関数の場合と同じです。
- BOTH
- データの先頭および末尾から、LOAD がブランクまたは指定された除去文字を 除去することを指定します。
- TRAILING
- データの末尾から、LOAD がブランクまたは指定された除去文字を除去することを指定します。
- LEADING
- データの先頭から、LOAD がブランクまたは指定された除去文字を除去することを指定します。
- 'strip-char'
- LOAD がデータから除去する 1 バイト文字または 2 バイト文字を指定します。
この文字の値は EBCDIC で指定してください。LOAD は、入力コード化スキームに応じて 、strip-char 値が除去操作で使用される前に、SBCS CCSID 変換を適用します。
ロードされる列のサブタイプが BIT の場合、または、EBCDIC 以外のコード化スキームで strip-char 値を 指定する場合は、16 進形式 (X'strip-char') を使用してください。 LOAD は、16 進形式が使用されている場合は、CCSID 変換は行いません。
- X'strip-char'
- LOAD がデータから除去する 1 バイト文字または 2 バイト文字を 16 進形式で指定
します。1 バイト文字の場合は、この値を X'hh' の形式 (hh は 2 個の 16 進文字) で
指定してください。2 バイト文字の場合は、この値を X'hhhh' の
形式 (hhhh は 4 個の 16 進文字) で指定してください。
EBCDIC 以外のエンコード化スキームで文字を指定するには、16 進形式を使用 します。16 進形式で文字の値を指定すると、LOAD は、CCSID 変換は行いません。
除去文字を 16 進形式で指定した場合は、入力コード化スキームでその文字を 指定する必要があります。
- TRUNCATE
- 入力文字ストリングがターゲット列に収まらない場合に LOAD がそのストリングを右側から
切り捨てることを指示します。LOAD は、CCSID 変換の後で、切り捨て操作を行います。
入力データが BIT データの場合、LOAD はバイト境界でデータを切り捨てます。 入力データが文字データの場合、LOAD は文字境界でデータを切り捨てます。 大/小文字混合タイプのデータが列に収まるように切り捨て られた場合は、切り捨てられたストリングは指定された列のサイズよりも短くなる可能性があります。 このような場合は、出力 CCSID でブランクが右側に埋め込まれます。
- GRAPHIC(length)
- 固定長のグラフィック・タイプを指定します。フィールド仕様には、start と end の両方を指定することができます。
GRAPHIC を使用する場合、入力データにシフト文字を含んではなりま せん。start と end は、データ自体の開始位置と終了位置を示している必要があります。
length は、2 バイト文字の文字数です。 バイトで表したフィールドの長さは、length の値の 2 倍です。 length を指定しない場合は、2 バイト文字の 長さは、POSITION 指定から決められます。length または POSITION を 指定しない場合、LOAD は GRAPHIC のデフォルトの長さ (表の列の長さで決まる) を使用します。
例えば、*** は 3 文字の 2 バイト文字を表すとします。 この場合、*** を記述するには、POS(1:6) GRAPHIC または POS(1) GRAPHIC(3) の いずれかを指定します。 このように記述された GRAPHIC フィールドは、フィールド選択基準では指定できません。
- STRIP
- データの先頭、末尾、または両端から、LOAD がゼロを除去 (デフォルト) または指定された文字を
除去することを指定します。
LOAD は、文字コード変換または埋め込みを行う前に、除去操作を適用します。
STRIP オプションの効果は、SQL STRIP スカラー関数の場合と同じです。
- BOTH
- データの先頭および末尾から、LOAD がブランクまたは指定された除去文字を 除去することを指定します。
- TRAILING
- データの末尾から、LOAD がブランクまたは指定された除去文字を除去することを指定します。
- LEADING
- データの先頭から、LOAD がブランクまたは指定された除去文字を除去することを指定します。
- X'strip-char'
- LOAD がデータから除去する 2 バイト文字の 16 進形式を指定します。
この値は X'hhhh' の形式 (hhhh は 4 個の 16 進文字) で
指定してください。
入力コード化スキームでその文字を指定する必要があります。
- TRUNCATE
- 入力文字ストリングがターゲット列に収まらない場合に LOAD がそのストリングを右側から
切り捨てることを指示します。LOAD は、CCSID 変換の後で、切り捨て操作を行います。
LOAD は、切り捨てを文字境界で行います。2 バイト文字が分割されることはありません。
- GRAPHIC EXTERNAL(length)
- 外部形式を持つグラフィック・タイプの固定長フィールドを指定します。フィールド仕様には、start と end の両方を指定することができます。
GRAPHIC EXTERNAL を使用する場合、入力データの開始位置にシフトアウト文字、 終了位置にシフトイン文字が必要です。 シフト文字以外は、このフィールドは偶数バイトでなければなりません。 いずれのペアの最初のバイトもシフト文字であってはなりません。
length は、2 バイト文字の文字数です。 GRAPHIC EXTERNAL の length は、 シフト文字によって表されるバイト数は含んでいません。 バイトで表したフィールドの長さは、length の値の 2 倍です。 length を指定しない場合は、2 バイト文字の 長さは、POSITION 指定から決められます。length または POSITION を 指定しない場合、LOAD は GRAPHIC のデフォルトの長さ (表の列の長さで決まる) を使用します。
例えば、*** が 3 文字 の 2 バイト文字を表し、< と > がそれぞれシフトアウト文字とシフトイン文字を 表すとします。この場合、<***> を記述するには、POS(1:8) GRAPHIC EXTERNAL または POS(1) GRAPHIC EXTERNAL(3) のいずれかを指定します。
- STRIP
- データの先頭、末尾、または両端から、LOAD がゼロを除去 (デフォルト) または指定された文字を
除去することを指定します。
LOAD は、文字コード変換または埋め込みを行う前に、除去操作を適用します。
STRIP オプションの効果は、SQL STRIP スカラー関数の場合と同じです。
- BOTH
- データの先頭および末尾から、LOAD がブランクまたは指定された除去文字を 除去することを指定します。
- TRAILING
- データの末尾から、LOAD がブランクまたは指定された除去文字を除去することを指定します。
- LEADING
- データの先頭から、LOAD がブランクまたは指定された除去文字を除去することを指定します。
- X'strip-char'
- LOAD がデータから除去する 2 バイト文字の 16 進形式を指定します。
この値は X'hhhh' の形式 (hhhh は 4 個の 16 進文字) で
指定してください。
入力コード化スキームでその文字を指定する必要があります。
- TRUNCATE
- 入力文字ストリングがターゲット列に収まらない場合に LOAD がそのストリングを右側から
切り捨てることを指示します。LOAD は、CCSID 変換の後で、切り捨て操作を行います。
LOAD は、切り捨てを文字境界で行います。2 バイト文字が分割されることはありません。
- VARGRAPHIC
- 可変長のグラフィックス・フィールドを示します。2 バイト文字で表した長さを、
データの前の 2 バイトの 2 進数フィールドに指定する必要があり
ます。(この長さには、2 バイト・フィールド自体は含まれません。)
長さフィールドは、POSITION オプションの start で指定された桁から
始まる必要があります。:end は使用しても、無視されます。
VARGRAPHIC 入力データにシフト文字が含まれていてはなりません。
- STRIP
- データの先頭、末尾、または両端から、LOAD がゼロを除去 (デフォルト) または指定された文字を
除去することを指定します。LOAD は、VARGRAPHIC の長さフィールドをストリップされたデータの
長さ (DBCS 文字数) に合わせます。
LOAD は、文字コード変換または埋め込みを行う前に、除去操作を適用します。
STRIP オプションの効果は、SQL STRIP スカラー関数の場合と同じです。
- BOTH
- データの先頭および末尾から、LOAD がブランクまたは指定された除去文字を 除去することを指定します。
- TRAILING
- データの末尾から、LOAD がブランクまたは指定された除去文字を除去することを指定します。
- LEADING
- データの先頭から、LOAD がブランクまたは指定された除去文字を除去することを指定します。
- X'strip-char'
- LOAD がデータから除去する 2 バイト文字の 16 進形式を指定します。
この値は X'hhhh' の形式 (hhhh は 4 個の 16 進文字) で
指定してください。
入力コード化スキームでその文字を指定する必要があります。
- TRUNCATE
- 入力文字ストリングがターゲット列に収まらない場合に LOAD がそのストリングを右側から
切り捨てることを指示します。LOAD は、CCSID 変換の後で、切り捨て操作を行います。
LOAD は、切り捨てを文字境界で行います。2 バイト文字が分割されることはありません。
- SMALLINT
- 2 バイトの 2 進数を指定します。負数は、2 の補数表記となります。
- INTEGER
- 4 バイトの 2 進数を指定します。負数は、2 の補数表記となります。 INT を指定することもできます。
- INTEGER EXTERNAL(length)
- 数値を表す文字のストリング。 形式は、SQL 数値定数の形式です。length を指定しない 場合、ストリングの長さは、POSITION 指定から決められます。 length または POSITION を指定しない場合、LOAD は INTEGER のデフォルトの長さ (4 バイト) を使用します。INT EXTERNAL を指定することもできます。
- BIGINT
- 8 バイトの 2 進数を指定します。負数は、2 の補数表記となります。
- BINARY(length)
- 固定長のバイナリー・ストリングを指定します。length を指定しない
場合、ストリングの長さは、POSITION 指定から決められます。length または POSITION が
指定されていない場合、LOAD は BINARY のデフォルト長 (表内の列の長さで決まる) を使用します。
X'strip-char' のデフォルトは 16 進
ゼロ (X'00') です。このフィールドには、データ変換は適用されません。
- STRIP
- データの先頭、末尾、または両端から、LOAD が 2 進ゼロを除去 (デフォルト) または
指定された X'strip-char' を
除去することを指定します。LOAD は、BINARY フィールドに対する
埋め込みを行って、列の残りの部分を埋めます。
STRIP オプションの効果は、SQL STRIP スカラー関数の場合と同じです。
- BOTH
- データの先頭および末尾から、LOAD が 2 進ゼロまたは指定された除去文字を 除去することを指定します。
- TRAILING
- データの末尾から、LOAD がブランクまたは指定された除去文字を除去することを指定します。
- LEADING
- データの先頭から、LOAD がブランクまたは指定された除去文字を除去することを指定します。
- X'strip-char'
- LOAD がデータから除去する 1 バイト文字または 2 バイト文字を 16 進形式で指定 します。1 バイト文字の場合は、この値を X'hh' の形式 (hh は 2 個の 16 進文字) で 指定してください。
- TRUNCATE
- ストリングがターゲット列に収まらない場合は、LOAD は、入力文字ストリングを右側から
切り捨てることを示します。
LOAD は、切り捨てを文字境界で行います。
- VARBINARY
- 可変長のバイナリー・ストリングを指定します。バイト数で表された長さが、データの前にある 2 バイト
の 2 進数フィールドに指定されていなければなりません (この 2 バイトのフィールド自体は
長さには含まれません)。長さフィールドは、POSITION オプションの start で指定された桁から
始まる必要があります。:end は指定しても、無視されます。X'strip-char' のデフォルトは 16 進
ゼロ (X'00') です。このフィールドには、データ変換は適用されません。
- STRIP
- データの先頭、末尾、または両端から、LOAD が 2 進ゼロを除去 (デフォルト) または指定された文字を
除去することを指定します。LOAD は、VARBINARY フィールドに対する
埋め込みを行って、列の残りの部分を埋めます。
STRIP オプションの効果は、SQL STRIP スカラー関数の場合と同じです。
- BOTH
- データの先頭および末尾から、LOAD が 2 進ゼロまたは指定された除去文字を 除去することを指定します。
- TRAILING
- データの末尾から、LOAD が 2 進ゼロまたは指定された除去文字を 除去することを指定します。
- LEADING
- データの先頭から、LOAD が 2 進ゼロまたは指定された除去文字を 除去することを指定します。
- X'strip-char'
- LOAD がデータから除去する 1 バイト文字を 16 進形式で指定 します。1 バイト文字の場合は、この値を X'hh' の形式 (hh は 2 個の 16 進文字) で 指定してください。
- TRUNCATE
- 入力文字ストリングがターゲット列に収まらない場合に LOAD がそのストリングを右側から
切り捨てることを指示します。
LOAD は、切り捨てを文字境界で行います。
- DECIMAL PACKED
- 形式 ddd...ds の数を指定します。 ここで、d は 4 ビットで表される 10 進数、s は 4 ビット の符号の値です。 正符号 (+) は A、C、E、または F で表され、負符号 (-) は B または D で表され ます。d の最大数は SQL 定義で許される最大桁数と同じです。 また、DECIMAL、DEC、または DEC PACKED を指定することもできます。
- DECIMAL ZONED
- 形式 znznzn...z/sn の数を指定します。
ここで、z、n、および s は
以下の値を持っています。
- n
- バイトの右側 4 バイトで表される 10 進数字 (数値ビット と 呼ばれます)
- z
- その数字のゾーン。左側の 4 ビットで表されます。
- s
- 10 進数オペランドの右端のバイト。s は、ゾーンもしくは その数字の符号の値として扱われます。
- DECIMAL EXTERNAL(length,scale)
- 数値を表す文字のストリングを指定します。
形式は、SQL 数値定数の形式です。
- 長さ
- 入力フィールドの全長 (バイト)。length を指定しない 場合は、入力フィールドの長さは、POSITION 指定から決められ ます。length または POSITION を指定しない場合、LOAD は DECIMAL EXTERNAL のデフォルトの長さ (10 進数の精度で決まる) を使用し ます。
- scale
- 小数点の右側の桁数を指定します。 scale は、0 以上の整数でなければならず、length より 大きくても構いません。 デフォルト値は 0 です。
scale が length よりも大きいか、 与えられた位取りが 指定されたスケール よりも小さい場合は、 入力された数値は小数点の位置に達するまで、左側がゼロで埋められます。 scale がターゲットの scale よりも大きい場合は、 ソースのスケールは暗黙の小数点位を見つけます。 ターゲットのスケールより大きい小数桁は、すべて切り捨てられます。 スケールが指定され、ターゲット列が短整数または整数のデータ・タイプである場合、 入力された数の小数部は無視されます。 小数点がある場合、その位置は scale のフィールド仕様をオーバーライドします。
- FLOAT(length)
- 64 ビットの浮動小数点数または 32 ビットの浮動小数点数のいずれかを指定し
ます。length が 1 と 21 の間 (両端を含む) の場合、数値は S390 (HFP) 形式の 32 ビットです。
- ビット 0
- 符号 (正は 0、負は 1) を表す
- ビット 1-7
- 指数を表す
- ビット 8-31
- 小数部を表す
length が 1 と 24 の間 (両端を含む) の場合、数値 は IEEE (BFP) 形式の 32 ビットです。
- ビット 0
- 符号 (正は 0、負は 1) を表す
- ビット 1-8
- 指数を表す
- ビット 9-31
- 小数部を表す
length を指定しないか、または 22 と 53 の間 (両端を含む) の場合は、 数値は S390 (HFP) 形式の 64 ビットです。
- ビット 0
- 符号 (正は 0、負は 1) を表す
- ビット 1-7
- 指数を表す
- ビット 8-63
- 小数部を表す
length を指定しないか、または 25 と 53 の間 (両端を含む) の場合は、 数値は IEEE (BFP) 形式の 64 ビットです。
- ビット 0
- 符号 (正は 0、負は 1) を表す
- ビット 1-11
- 指数を表す
- ビット 12-63
- 小数部を表す
- FLOAT EXTERNAL(length)
- 数値を表す文字のストリングを指定します。
形式は、SQL 浮動小数点定数の形式です。
FLOAT(IEEE) または FLOAT(S390) の指定は、この 形式 (文字ストリング) の浮動小数点数には適用されません。
length を指定しない 場合、ストリングの長さは、POSITION 指定から決められます。 length または POSITION を指定しない場合、LOAD は FLOAT のデフォルトの長さ (単精度は 4 バイト、倍精度は 8 バイト) を使用し ます。
- DATE EXTERNAL
- 日付の文字ストリング表示を指定します。
長さ、または特定の日付形式を指定できます。
- (length)
- 長さが指定されていない場合は、LOCAL DATA LENGTH インストール・オプションで指定された長さに、
あるいはそれもない場合は、デフォルトの 10 バイトになります。長さを指定する場合は、8 から 254 バイトの範囲である必要があります。
日付形式が指定されていない場合、日付は以下のいずれかの形式で指定できます。
月と日の場合、先行ゼロは省略可能です。末尾ブランクはあっても構いませんが、
先行ブランクは認められません。
- dd.mm.yyyy
- mm/dd/yyyy
- yyyy-mm-dd
- Db2 のインストール時に定義された任意のローカル形式
(date-format)
次の表に示す、日付表記の形式。表 3. date-format 値 date-format 値 形式 長さ DATE_A mm-dd-yyyy 1 10 バイト DATE_B mm-dd-yy 1, 2 8 バイト DATE_C yyyy-mm-dd 1 10 バイト DATE_D yy-mm-dd 1, 2 8 バイト DATE_E dd-mm-yyyy 1 10 バイト DATE_F dd-mm-yy 1, 2 8 バイト DATE_G yyyy-ddd 1 8 バイト DATE_H yy-ddd 1, 2 6 バイト DATE_I mmddyyyy 8 バイト DATE_J mmddyy 2 6 バイト DATE_K yyyymmdd 8 バイト DATE_L yymmdd 2 6 バイト DATE_M ddmmyyyy 8 バイト DATE_N ddmmyy 2 6 バイト DATE_O yyyyddd 7 バイト DATE_P yyddd 2 5 バイト フィールドにフィールド指定で使用されている日付形式が指定されている場合、フィールド指定でもその指定の日付形式を使用する必要があります。
注 :- この形式に区切り記号を含める場合、その記号には 1 バイトの EBCDIC 文字に変換可能な任意の 1 バイト文字を使用できます。 ただし、入力ファイルが区切り文字で区切られた形式になっている場合、区切り文字 COLDEL、CHARDEL、DECPT を含め、区切り文字に使用されているものと同じ文字は指定できません。区切り文字の制約事項の詳細については、区切り文字で区切られたファイルのロードを参照してください。
- 2 桁の年が指定されている場合は、4 桁の年に拡張されます。2 桁の年が 2 桁の現行年に 50 を加算した合計より小さい値である場合、4 桁の年で現在の世紀が使用されます。 例えば、現在の年が 2017 年であるとします。2 桁の年が 67 の場合は、1967 が使用されます。 しかし、2 桁の年が 66 であれば、2066 年が使用されます。

- TIME EXTERNAL
- 時刻の文字ストリング表示を指定します。
長さ、または特定の時刻形式を指定できます。
- (length)
- 長さが指定されていない場合は、LOCAL TIME LENGTH インストール・オプションで指定された長さに、
あるいはそれもない場合は、デフォルトの 8 バイトになります。長さを指定する場合は、4 から 254 バイトの範囲である必要があります。
形式が指定されない場合、時刻は以下のいずれかの形式で指定できます。
- hh.mm.ss
- hh:mm AM
- hh:mm PM
- hh:mm:ss
- Db2 のインストール時に定義された任意のローカル形式
mm が 00 と等しい場合は、hh:mm AM およ び hh:mm PM の形式の mm の部分を省略することが できます。例えば、5 PM は有効な時刻であり、5:00 PM の代わりに使用できます。
(time-format)
次の表に示す、時刻表記の特定の形式。表 4. time-format 値 time-format 値 形式 長さ TIME_A hh.mm.ss 1 8 バイト TIME_B hh.mm 1 5 バイト TIME_C hh.mm AM or hh.mm PM 1 8 バイト TIME_D hhmmss 6 バイト TIME_E hhmm 4 バイト フィールドにフィールド指定で使用されている時刻形式が指定されている場合、フィールド指定でもその指定の時刻形式を使用する必要があります。
注:- この形式に区切り記号を含める場合、その記号には 1 バイトの EBCDIC 文字に変換可能な任意の 1 バイト文字を使用できます。

- TIMESTAMP EXTERNAL
- 時刻の文字ストリング表示を指定します。
長さ、または特定のタイム・スタンプ形式を指定できます。
- (length)
- length のデフォルトは、26 バイトです。長さを指定する場合は、19 から 32 バイトの範囲である必要があります。
タイム・スタンプ形式が指定されていない場合、タイム・スタンプは以下のいずれかの形式で指定できます。
nnnnnn はマイクロ秒の数値を表し、0 から 12 桁までです。タイム・スタンプの月、日、または時間の部分の先行ゼロと、
タイム・スタンプのマイクロ秒の部分の後続ゼロは省略することができます。
- yyyy-mm-dd-hh.mm.ss
- yyyy-mm-dd-hh.mm.ss.nnnnnn
- yyyy-mm-dd hh:mm:ss.nnnnnn
(timestamp-format)
次の表に示す、タイム・スタンプ表記の形式。表 5. timestamp-format 値 timestamp-format 値 形式 長さ TIMESTAMP_A yyyy-mm-dd-hh.mm.ss 1 19 バイト TIMESTAMP_B yyyy-mm-dd-hh.mm.ss.nnnnnn 1 26 バイト TIMESTAMP_C yyyymmddhhmmss 14 バイト TIMESTAMP_D yymmddhhmmss 2 12 バイト TIMESTAMP_E yyyymmddhhmmssnnnnnn 20 バイト TIMESTAMP_F yymmddhhmmssnnnnnn 2 18 バイト フィールドにフィールド指定で使用されているタイム・スタンプ形式が指定されている場合、フィールド指定でもその指定のタイム・スタンプ形式を使用する必要があります。

注 :- この形式に区切り記号を含める場合、その記号には 1 バイトの EBCDIC 文字に変換可能な任意の 1 バイト文字を使用できます。
- 2 桁の年が指定されている場合は、4 桁の年に拡張されます。2 桁の年が 2 桁の現行年に 50 を加算した合計より小さい値である場合、4 桁の年で現在の世紀が使用されます。 例えば、現在の年が 2017 年であるとします。2 桁の年が 67 の場合は、1967 が使用されます。 しかし、2 桁の年が 66 であれば、2066 年が使用されます。
- TIMESTAMP WITH TIME ZONE EXTERNAL(length)
- 時間帯を使用するタイム・スタンプの文字ストリング表記を指定します。length のデフォルトは、33 バイトです。長さを指定する場合は、26 から 39 バイトの範囲である必要があります。
時間帯を使用するタイム・スタンプは、次のいずれの形式でも構いません。 nnnnnn は秒の小数部分の数値を表し、0 から 12 桁までです。 タイム・スタンプの月、日、または時間の部分の先行ゼロと、タイム・スタンプの秒の小数部分の後続ゼロは省略できます。
- yyyy-mm-dd-hh.mm.ss.nnnnnn±th:tm
- yyyy-mm-dd-hh.mm.ss.nnnnnn±th:tm
- yyyy-mm-dd hh:mm:ss.nnnnnn±th:tm
- yyyy-mm-dd hh:mm:ss.nnnnnn±th:tm
- ROWID
- 行 ID を指定します。
入力データは、行 ID に対して有効な値でなければなりません。Db2 は変換を行いません。
GENERATED ALWAYS オプションで作成された行 ID 列に対しては、 フィールド仕様は許可されません。
行 ID 列がパーティション・キーの一部である場合、LOAD INTO TABLE PART は認められません。 その代わりに LOAD INTO TABLE を指定してください。
- BLOB
- BLOB フィールドを指定します。バイトで表した長さを、データの前の 4 バイト の 2 進数フィールドに指定する必要があり ます。(この長さには、4 バイト・フィールド自体は含まれていません。) 長さフィールドは、POSITION オプションの start で指定された桁から 始まる必要があります。:end は指定しても、無視されます。
- CLOB
- CLOB フィールドを指定します。バイトで表した長さを、データの前の 4 バイト
の 2 進数フィールドに指定する必要があり
ます。(この長さには、4 バイト・フィールド自体は含まれていません。)
長さフィールドは、POSITION オプションの start で指定された桁から
始まる必要があります。:end は指定しても、無視されます。
- MIXED
- 入力フィールドが、SBCS と DBCS データの混合であることを指定し ます。MIXED を指定した場合は、CCSID 変換が必要であれば入力データに対して混合 CCSID を使用します。MIXED を指定しない場合は、そのような変換では入力データに対して SBCS CCSID を使用します。
- DBCLOB
- DBCLOB フィールドを指定します。2 バイト文字で表した長さを、データの前 の 4 バイトの 2 進数フィールドに指定する必要があり ます。(この長さには、4 バイト・フィールド自体は含まれていません。) 長さフィールドは、POSITION オプションの start で指定された桁から 始まる必要があります。:end は指定しても、無視されます。
- DECFLOAT (length)
- 128 ビット 10 進浮動小数点数または 64 ビット 10 進浮動小数点数を 指定します。長さの値は 16 または 34 のいずれかでなければなりません。長さ が 16 の場合、数値の形式は 10 進 64 ビット浮動小数点形式です。 長さが 34 の場合、数値の形式は 128 ビット 10 進浮動小数点形式です。 長さが指定されていない場合、数値の形式は 128 ビット 10 進浮動小数点形式です。
- DECFLOAT EXTERNAL (length)
- 数値を表す文字のストリングを指定します。 形式は、SQL 数値定数です。長さが指定されていない場合、 ストリングの長さは POSITION 指定から決められます。長さまたは POSITION が指定されていない 場合、LOAD は DECFLOAT のデフォルト長さを使用します。
- XML
- 入力フィールド・タイプが XML であることを指定します。フィールド・タイプ XML は、XML 列にのみ
ロードできます。入力レコードから直接 XML 値をロードする場合、XML を
指定してください。入力レコードの形式が、区切りなしの場合、実際のデータ値の前に 2 バイト長のフィールドを
指定する必要があります。
BINARYXML ファイル参照変数を使用してロードされる XML 文書がバイナリー XML 形式であることを指定します。
- PRESERVE WHITESPACE
- XML 列内の空白文字が保持されることを指定します。デフォルトでは、空白文字は 保持されません。
- DEFAULTIF field-selection-criterion
- Db2 列にそのデフォルト値が
ロードされる条件を記述します。field-selection-criterion に
説明されているのと同じオプションを用いて、field-selection-criterion を指定できます。
DEFAULTIF フィールドの内容が、与えられた文字定数と一致した場合は
、field-specification で指定されたフィールドにそのデフォルト値がロードされます。
DEFAULTIF フィールドが VARCHAR または VARGRAPHIC フィールドの名前に よって定義されている場合、Db2 は、 その VARCHAR または VARGRAPHIC フィールドのデータ部の前にある 2 バイトの 2 進数フィールドから フィールドの長さを取ります。
文字ストリング定数は、入力 データ・レコードに一致する文字セットで、LOAD ユーティリティー制御ステートメントに指定される必要があります。 データが EBCDIC の場合は LOAD 制御ステートメントに EBCDIC 定数を 指定し、データが UNICODE の場合は UNICODE 定数を指定してください。16 進形式を 使用して DEFAULTIF 条件をコーディングすることもできます。例えば、入力データが EBCDIC で、制御ステートメントが UTF-8 の場合、 制御ステートメントでは (1:1)='1' ではなく、(1:1)=X'31' を使用します。
DEFAULTIF 属性は、ROWID キーワードと共に使用することができます。 条件を満たしている場合、列には Db2 が 生成する値がロードされます。
DEFAULTIF オプションを XML 列に対して指定することはできません。
- NULLIF field-selection-criterion
- Db2 列に NULL がロードされる
条件を記述します。field-selection-criterion に
説明されているのと同じオプションを用いて、field-selection-criterion を指定できます。
NULLIF フィールドの内容が、与えられた文字定数と一致した場合
は、field-specification で指定されたフィールドに NULL がロードされます。
NULLIF フィールドが VARCHAR または VARGRAPHIC フィールドの名前に よって定義されている場合、Db2 は、 その VARCHAR または VARGRAPHIC フィールドのデータ部の前にある 2 バイトの 2 進数フィールドから フィールドの長さを取ります。
BLOBF、CLOBF、または DBCLOBF フィールドに NULL 値をロードするには、NULL の入力ファイル名を使用します。
文字ストリング定数は、入力 データ・レコードに一致する文字セットで、LOAD ユーティリティー制御ステートメントに指定される必要があります。 データが EBCDIC の場合は LOAD 制御ステートメントに EBCDIC 定数を 指定し、データが UNICODE の場合は UNICODE 定数を指定してください。16 進形式を 使用して NULLIF 条件をコーディングすることもできます。例えば、入力データが EBCDIC で、制御ステートメントが UTF-8 の場合、 制御ステートメントでは (1:1)='1' ではなく、(1:1)=X'31' を使用します。
出力表のフィールドに NULL がロードされても、入力レコードの対応するフィールドの 形式や機能には変更はありません。 入力フィールドは、それ以降もフィールド選択基準で使用できます。 例えば、以下のフィールド仕様を持つ LOAD ステートメントを想定します。
(FIELD1 POSITION(*) CHAR(4) FIELD2 POSITION(*) CHAR(3) NULLIF(FIELD1='SKIP') FIELD3 POSITION(*) CHAR(5))また、LOAD が次のソース・レコードの処理を行うものとします。
SKIP FLD03この例では、レコードは以下のようにロードされます。
- FIELD1
- 値 'SKIP' が入ります。
- FIELD2
- NULL です (ソース・レコードのように ' ' ではありません)。
- FIELD3
- 値 'FLD03' が入ります。
行 ID 列は NULL であってはならないため、NULLIF パラメーターを ROWID キーワード と共に使用することはできません。
- Field selection criterion
Db2 列にそのデフォルト値または NULL が ロードされる条件を記述します。
