LOAD コマンド

サーバー上に保管するデータは、ファイル、テープ、 または名前付きパイプの形式にすることができます。 リモートに接続されたクライアント上に保管するデータは、 完全修飾ファイルまたは名前付きパイプの形式にすることができます。 また、データは、ユーザー定義カーソルから、あるいはユーザー作成のスクリプトまたはアプリケーションを使用してロードできます。表の COMPRESS 属性が YES に設定されている場合、ロードされるデータは、表内にディクショナリーが存在するデータおよびデータベース・パーティションごとに圧縮の対象となります。これには表の XML ストレージ・オブジェクト内のデータが含まれます。

ロード・ユーティリティー用のファイル・タイプ修飾子へのクイック・リンク。

制約事項

ロード・ユーティリティーでは、階層レベルのデータのロードはサポートされていません。 ロード・ユーティリティーには、範囲がクラスター化された表との互換性はありません。 ロード・ユーティリティーでは、NOT LOGGED INITIALLY パラメーターを CREATE TABLE や ALTER TABLE ステートメントでサポートしていません。

有効範囲

このコマンドは、一度の要求で複数のデータベース・パーティションに対して発行できます。

許可

すべてのロード・プロセス (および一般にすべての DB2 サーバー・プロセス) はインスタンス所有者によって所有されており、それらのプロセスすべてにおいて、必要なファイルにアクセスするためにそのインスタンス所有者の ID を使用するため、 インスタンス所有者には入力データ・ファイルに対する読み取りアクセス権が必要です。 このコマンドをだれが呼び出すかには関係なく、 それらの入力データ・ファイルをインスタンス所有者から読むことができなければなりません。

必要な接続

データベース。 暗黙接続が可能な場合には、デフォルト・データベースへの接続が確立されます。

インスタンス。 明示的なアタッチは必要ありません。 データベースへの接続が確立されている場合には、 ローカル・インスタンスへの暗黙的な接続が試みられます。

コマンド構文

                           .-,--------------.                 
                           V                |                 
>>-LOAD--+--------+--FROM----+-filename---+-+--OF--filetype----->
         '-CLIENT-'          +-pipename---+                   
                             +-device-----+                   
                             '-cursorname-'                   

>--+-------------------------+--+------------------------+------>
   |            .-,--------. |  |           .-,--------. |   
   |            V          | |  |           V          | |   
   '-LOBS FROM----lob-path-+-'  '-XML FROM----xml-path-+-'   

>--+--------------------------------+--------------------------->
   |              .---------------. |   
   |              V               | |   
   '-MODIFIED BY----file-type-mod-+-'   

>--+-------------------------------------------------------------------------------------------------+-->
   |                 .-,------------------.                                                          |   
   |                 V                    |                                                          |   
   '-METHOD--+-L--(----col-start--col-end-+--)--+------------------------------------------------+-+-'   
             |                                  |                     .-,-------------------.    | |     
             |                                  |                     V                     |    | |     
             |                                  '-NULL INDICATORS--(----null-indicator-list-+--)-' |     
             |       .-,--------.                                                                  |     
             |       V          |                                                                  |     
             +-N--(----col-name-+--)---------------------------------------------------------------+     
             |       .-,------------.                                                              |     
             |       V              |                                                              |     
             '-P--(----col-position-+--)-----------------------------------------------------------'     

>--+------------------------------------+----------------------->
   '-XMLPARSE--+-STRIP----+--WHITESPACE-'   
               '-PRESERVE-'                 

>--+--------------------------------------------------------------------------------------+-->
   '-XMLVALIDATE USING--+-XDS--+-----------------------+--| Ignore and Map parameters |-+-'   
                        |      '-DEFAULT--schema-sqlid-'                                |     
                        +-SCHEMA--schema-sqlid------------------------------------------+     
                        '-SCHEMALOCATION HINTS------------------------------------------'     

>--+--------------+--+-------------+--+-----------------+------->
   '-SAVECOUNT--n-'  '-ROWCOUNT--n-'  '-WARNINGCOUNT--n-'   

>--+------------------------+----------------------------------->
   '-MESSAGES--message-file-'   

>--+-------------------------------+---------------------------->
   '-TEMPFILES PATH--temp-pathname-'   

>--+-INSERT-----------------------+----------------------------->
   |          .-KEEPDICTIONARY--. |   
   +-REPLACE--+-----------------+-+   
   |          '-RESETDICTIONARY-' |   
   +-RESTART----------------------+   
   '-TERMINATE--------------------'   

>--INTO--table-name--+-------------------------+---------------->
                     |    .-,-------------.    |   
                     |    V               |    |   
                     '-(----insert-column-+--)-'   

>--+----------------------------------------------------------+-->
   |                            .-,-------------------------. |   
   |                            V  (1)   (2)                | |   
   '-FOR EXCEPTION--table-name--------------+-------------+-+-'   
                                            +-NORANGEEXC--+       
                                            '-NOUNIQUEEXC-'       

>--+-----------------------------+------------------------------>
   '-STATISTICS--+-USE PROFILE-+-'   
                 '-NO----------'     

>--+-----------------------------------------------------------------+-->
   |       .-NO----------------------------------------------------. |   
   +-COPY--+-YES--+-USE TSM--+--------------------------+--------+-+-+   
   |              |          '-OPEN--num-sess--SESSIONS-'        |   |   
   |              |     .-,----------------.                     |   |   
   |              |     V                  |                     |   |   
   |              +-TO----device/directory-+---------------------+   |   
   |              '-LOAD--lib-name--+--------------------------+-'   |   
   |                                '-OPEN--num-sess--SESSIONS-'     |   
   '-NONRECOVERABLE--------------------------------------------------'   

>--+-------------------+--+--------------------------+---------->
   '-WITHOUT PROMPTING-'  '-DATA BUFFER--buffer-size-'   

>--+--------------------------+--+--------------------+--------->
   '-SORT BUFFER--buffer-size-'  '-CPU_PARALLELISM--n-'   

>--+---------------------+-------------------------------------->
   '-DISK_PARALLELISM--n-'   

>--+--------------------------------+--------------------------->
   '-INDEXING MODE--+-AUTOSELECT--+-'   
                    +-REBUILD-----+     
                    +-INCREMENTAL-+     
                    '-DEFERRED----'     

   .-ALLOW NO ACCESS-----------------------------.   
>--+---------------------------------------------+-------------->
   '-ALLOW READ ACCESS--+----------------------+-'   
                        '-USE--tablespace-name-'     

>--+----------------------------+------------------------------->
   |                    .-YES-. |   
   '-FETCH_PARALLELISM--+-NO--+-'   

>--+----------------------------------------------+------------->
   '-SET INTEGRITY PENDING CASCADE--+-IMMEDIATE-+-'   
                                    '-DEFERRED--'     

>--+-----------------+------------------------------------------>
   '-LOCK WITH FORCE-'   

>--+-----------------------------------------------------------------------------------+-->
   '-SOURCEUSEREXIT--executable--| Redirect Input/Output parameters |--+-------------+-'   
                                                                       '-PARALLELIZE-'     

>--+------------------------------------------------------+----><
   |                            .-----------------------. |   
   | .-PARTITIONED DB CONFIG-.  V                       | |   
   '-+-----------------------+----partitioned-db-option-+-'   

Ignore and Map parameters

|--+--------------------------------+--------------------------->
   |            .-,------------.    |   
   |            V              |    |   
   '-IGNORE--(----schema-sqlid-+--)-'   

>--+----------------------------------------------------+-------|
   |         .-,-----------------------------------.    |   
   |         V                                     |    |   
   '-MAP--(----(--schema-sqlid--,--schema-sqlid--)-+--)-'   

Redirect Input/Output parameters

|--+-------------------------------------------------------------------------------------+--|
   '-REDIRECT--+-INPUT FROM--+-BUFFER--input-buffer-+--+-----------------------------+-+-'   
               |             '-FILE--input-file-----'  '-OUTPUT TO FILE--output-file-' |     
               '-OUTPUT TO FILE--output-file-------------------------------------------'     

1. これらのキーワードの出現順序は任意です。
2. これらのキーワードは、それぞれ 1 回だけ出現できます。

コマンド・パラメーター

CLIENT

ロードするデータが、リモートに接続するクライアントにあることを指定します。 ロード操作がリモート・クライアントから呼び出されない場合、 このオプションは無視されます。 CURSOR ファイル・タイプと併せて指定された場合、このオプションは無視されます。

注:

1. dumpfile および lobsinfile 修飾子および XML FROM オプションは、CLIENT キーワードが指定されている場合でも、サーバー上のファイルを参照します。
2. コード・ページ変換は、リモートのロード操作時には実行されません。 データのコード・ページがサーバーのコード・ページとは異なる場合、 codepage 修飾子を使用してデータのコード・ページを指定する必要があります。

以下の例では、リモートに接続されたクライアント上に存在するデータ・ファイル (/u/user/data.del) は、 サーバー・データベース上の MYTABLE にロードされます。

db2 load client from /u/user/data.del of del
   modified by codepage=850 insert into mytable

FROM filename | pipename | device | cursorname

ロードされるデータを含んだ SQL ステートメントを参照するファイル、パイプ、装置、またはカーソルを指定します。 入力ソースがファイル、パイプ、または装置の場合、CLIENT オプションが指定されていなければ、 データベースが存在するデータベース・パーティションになければなりません。

複数の名前を指定すると、それらは順番に処理されます。 最後に指定した項目がテープ装置の場合は、 別のテープを使用するようユーザーに対してプロンプトが出ます。 有効な応答オプションは、次のとおりです。

c

続行。 警告メッセージを生成した装置の使用を続けます (例えば、新しいテープをマウントしたときなど)。

d

装置の終了。 警告メッセージを生成した装置の使用を停止します (例えば、 それ以上テープがない場合)。

t

終了。 すべての装置を終了します。

注:

• 完全修飾ファイル名を使用します。リモート・サーバーの場合は、常に完全修飾ファイル名を使用する必要があります。 呼び出し側と同じデータベース・パーティションにデータベースが存在する場合には、 相対パスを使用することもできます。
• ADMIN_CMD プロシージャーを使用した EXPORT コマンドを使用してデータをファイルにエクスポートした場合、そのデータ・ファイルは fenced ユーザー ID によって所有されます。このファイルは通常、インスタンス所有者がアクセスすることはできません。 LOAD を CLP または ADMIN_CMD プロシージャーから実行するには、インスタンス所有者 ID はデータ・ファイルにアクセスできなければならないので、データ・ファイルに対する読み取りアクセス権限をインスタンス所有者に付与する必要があります。
• ファイルが物理的には分割されてはいるが論理的には 1 つのファイルである場合には、 複数の IXF ファイルからのデータのロードがサポートされています。 ファイルが論理的にも物理的にも分割されている場合は、 サポートされていません。 論理的にも物理的にも分割されているファイルを複数指定した場合、 最初のファイルより後のファイルはすべて無視されることに注意してください。 (複数の物理ファイルがすべて一度の EXPORT コマンドの呼び出しで作成された場合、 それらは論理的には 1 つであると見なされます。)
• クライアント・マシン上に存在するデータをロードする場合、 そのデータは、完全修飾ファイルまたは名前付きパイプのいずれかの形式でなければなりません。
• XML データをファイルからパーティション・データベース環境にある表にロードする場合、XML データ・ファイルはロードが実行されるすべてのデータベース・パーティションから読み取りアクセス可能でなければなりません。

OF filetype

データのフォーマットを指定します。

• ASC (区切りなし ASCII フォーマット)
• DEL (区切り付き ASCII フォーマット)
• IXF (統合交換フォーマット、PC バージョン) は、DB2 データベースによってのみ使用されるバイナリー・フォーマットです。
• CURSOR (SELECT または VALUES ステートメントに対して宣言されたカーソル)。

注:

• CURSOR ファイル・タイプを使用して XML データを分散データベース環境にある表にロードする場合、PARTITION_ONLY および LOAD_ONLY モードはサポートされません。
• DECLARE CURSOR ステートメントで DATABASE キーワードを指定した CURSOR ファイル・タイプを使用してロードを実行する場合、 ロードは、データをフェッチするための別のアプリケーションを内部的に生成します。 一方、DATABASE キーワードを指定しなかった場合、ロードは同じアプリケーション内でデータをフェッチします。 この 2 つのケースの違いにより、 ロッキング動作にも違いが生じます。 特に、DATABASE キーワードを指定しており、現在接続しているデータベースと同じデータベースをそこで使用している場合 (また、ユーザー ID およびパスワードを指定している場合はそれらが現行接続と同じである場合)、ロックの問題 (データベース構成によって異なるが、ロック待機やロック・タイムアウトなど) が発生する可能性があります。 これは、DATABASE キーワードを省略することで回避できます。

LOBS FROM lob-path

ロードする LOB 値が収められているデータ・ファイルへのパス。 パスの最後はスラッシュでなければなりません。 CLIENT オプションを指定した場合、パスは完全修飾しなければなりません。 LOB データ・ファイルの名前は、 メイン・データ・ファイル (ASC、DEL、または IXF) の、LOB 列にロードされる列内に保管されます。 指定できるパスの最大数は 999 です。 これによって、LOBSINFILE 動作が暗黙的にアクティブ化されます。

CURSOR ファイル・タイプと併せて指定された場合、このオプションは無視されます。

MODIFIED BY file-type-mod

ファイル・タイプ修飾子オプションを指定します。 ロード・ユーティリティー用のファイル・タイプ修飾子を参照してください。

METHOD

L

データのロードを開始する列および終了する列の番号を指定します。 列の番号は、データの行の先頭からのバイト単位のオフセットです。 この番号は 1 から始まります。この方式は、ASC ファイルの場合にのみ使用することができ、そのファイル・タイプでは唯一の有効な方式です。

NULL INDICATORS null-indicator-list

このオプションは、METHOD L パラメーターを指定した場合だけ使用できます (つまり、入力ファイルが ASC ファイルの場合)。 NULL 標識リストは、コンマで区切られた正の整数のリストで、 各 NULL 標識フィールドの列の番号を指定します。 列の番号は、データの行の先頭からのバイト単位の、各 NULL 標識フィールドのオフセットです。 NULL 標識リストには、METHOD L パラメーターで定義された各データ・フィールドに対する 1 つの項目がなければなりません。 列の番号がゼロであることは、 対応するデータ・フィールド内に必ずデータがあることを示します。

NULL 標識列中の Y の値は、その列データが NULL であることを指定します。 NULL 標識列に Y 以外 の文字を指定した場合は、列データが NULL ではなく、METHOD L オプションで指定された列データがロードされることを指定することになります。

NULL 標識文字は、MODIFIED BY オプションを使用して変更できます。

N

ロードするデータ・ファイルの中の列の名前を指定します。 これらの列名の大文字小文字の区別は、 システム・カタログ内の対応する名前の大文字小文字の区別と一致しなければなりません。 NULL 可能ではない各表の列には、METHOD N リスト内に対応する項目が必要です。 例えば、データ・フィールドが F1、 F2、 F3、 F4、 F5、 および F6 であり、 表の列が C1 INT、C2 INT NOT NULL、C3 INT NOT NULL、および C4 INT の場合、 method N (F2, F1, F4, F3) は有効な要求ですが、 method N (F2, F1) は無効です。 この方式は、ファイル・タイプ IXF または CURSOR の場合にのみ使用することができます。

P

ロードする入力データ・フィールドのフィールド番号 (1 から始まる) を指定します。 NULL 可能ではない各表の列には、METHOD P リスト内に対応する項目が必要です。 例えば、データ・フィールドが F1、 F2、 F3、 F4、 F5、 および F6 であり、 表の列が C1 INT、C2 INT NOT NULL、C3 INT NOT NULL、および C4 INT の場合、 method P (2, 1, 4, 3) は有効な要求ですが、 method P (2, 1) は無効です。 この方式は、ファイル・タイプ IXF、DEL、または CURSOR の場合にのみ使用でき、 DEL ファイル・タイプに対して有効な唯一の方式です。

method P によって指定したフィールドごとに、 対応する列をアクション・ステートメント内に定義する必要があります。ただし、次の例に示すようにすべての列が対象になる場合、および最初の x 列がロードされる場合は必要ありません。

  db2 import from datafile1.del of del method P(1, 3, 4)
      replace into table1 (c1, c3, c4)

XML FROM xml-path

XML ファイルが含まれているパスを 1 つ以上指定します。 XDS は、メイン・データ・ファイル (ASC、DEL、または IXF) の、XML 列にロードされる列内に入れられます。

XMLPARSE

XML 文書の解析方法を指定します。 このオプションが指定されていない場合、XML 文書の解析の動作は、CURRENT IMPLICIT XMLPARSE OPTION 特殊レジスターの値によって決まります。

STRIP WHITESPACE

XML 文書の解析時に空白文字を除去することを指定します。

PRESERVE WHITESPACE

XML 文書の解析時に空白文字を除去しないことを指定します。

XMLVALIDATE

該当する場合に、XML 文書がスキーマに準拠しているかどうかの妥当性検査を実行することを指定します。

USING XDS

メイン・データ・ファイルの中で XML Data Specifier (XDS) によって指定されている XML スキーマに準拠しているかどうかについて、XML 文書の妥当性検査が実行されます。 デフォルトでは、USING XDS 節によって XMLVALIDATE オプションが呼び出された場合、妥当性検査実行のために使用されるスキーマは、その XDS の SCH 属性によって決まります。 XDS の中で SCH 属性が指定されていない場合、DEFAULT 節によってデフォルト・スキーマが指定されているのでない限り、スキーマ妥当性検査は実行されません。

DEFAULT、IGNORE、および MAP 節を使用することにより、スキーマ決定の動作を変更することができます。 これら 3 つの節はオプションであり、相互に適用されるのではなく XDS の指定に直接適用されます。 例えば、DEFAULT 節で指定されているためにあるスキーマが選択された場合、それが IGNORE 節で指定されていたとしても無視されることはありません。 同じように、MAP 節のペアの最初の部分で指定されているためにあるスキーマが選択された場合、それが別の MAP 節のペアの 2 番目の部分で指定されていたとしても再びマップされることはありません。

USING SCHEMA schema-sqlid

指定されている SQL ID の XML スキーマに準拠しているかどうかについて、XML 文書の妥当性検査が実行されます。 この場合、すべての XML 列について XML Data Specifier (XDS) の SCH 属性は無視されます。

USING SCHEMALOCATION HINTS

ソース XML 文書の中で XML スキーマ・ロケーション・ヒントによって指定されているスキーマに準拠しているかどうかについて、XML 文書の妥当性検査が実行されます。 その XML 文書の中に schemaLocation 属性が指定されていない場合、妥当性検査は実行されません。USING SCHEMALOCATION HINTS 節が指定されているなら、すべての XML 列について XML Data Specifier (XDS) の SCH 属性は無視されます。

以下のセクションに示す XMLVALIDATE オプションの例を参照してください。

IGNORE schema-sqlid

このオプションは、USING XDS パラメーターを指定した場合にのみ使用できます。IGNORE 節は、SCH 属性によって指定されていても無視するスキーマとして、1 つ以上のスキーマのリストを指定します。ロードする XML 文書の XML Data Specifier の中に SCH 属性が存在し、その SCH 属性によって指定されるスキーマが無視するスキーマ・リストに含まれている場合には、ロードするその XML 文書についてスキーマ妥当性検査は実行されません。

注:

あるスキーマが IGNORE 節の中で指定されている場合、MAP 節のスキーマ・ペアの左辺にそれを含めることはできません。

IGNORE 節は XDS にのみ適用されます。 あるスキーマが IGNORE 節によって指定されていても、それが MAP 節によってマップされているなら、それ以降そのスキーマが無視されることはありません。

DEFAULT schema-sqlid

このオプションは、USING XDS パラメーターを指定した場合にのみ使用できます。DEFAULT 節で指定されたスキーマは、ロード対象 XML 文書の XML Data Specifier (XDS) に XML スキーマを指定する SCH 属性が含まれていない場合に、妥当性検査のために使用するスキーマとなります。

DEFAULT 節は、IGNORE 節および MAP 節よりも優先されます。 XDS が DEFAULT 節を満たすなら、IGNORE と MAP の指定は無視されます。

MAP schema-sqlid

このオプションは、USING XDS パラメーターを指定した場合にのみ使用できます。MAP 節は、ロードする各 XML 文書について XML Data Specifier (XDS) の SCH 属性によって指定されるスキーマの代わりに使用する代替スキーマを指定するのに使用します。 MAP 節には、それぞれがあるスキーマから別のスキーマへのマッピングを表すスキーマ・ペアを 1 つ以上列挙したリストを指定します。 ペア中の最初のスキーマは、XDS 内の SCH 属性によって参照されるスキーマを表します。 ペア中の 2 番目のスキーマは、スキーマ妥当性検査の実行で使用する必要のあるスキーマを表します。

あるスキーマが MAP 節のスキーマ・ペアの左辺で指定されている場合、IGNORE 節でさらにそれを指定することはできません。

スキーマ・ペアのマッピングが適用されたなら、その結果は最終的なものです。 マッピング操作は推移的ではないため、選択されたスキーマが、それ以降に別のスキーマ・ペアのマッピングに適用されることはありません。

スキーマを複数回マップすることはできません。 つまり、複数のペアの左辺に指定することはできません。

SAVECOUNT n

ロード・ユーティリティーが n 行ごとに整合点を取ることを指定します。 この値はページ・カウントに変換され、エクステント・サイズのインターバルに切り上げられます。 整合点ごとにメッセージが発行されるので、LOAD QUERY を使用してロード操作をモニターする場合には、このオプションを選択する必要があります。 n の値が十分な大きさでない場合、各整合点で実行される活動の同期化によってパフォーマンスが低下する可能性があります。

デフォルト値はゼロですが、それは、必要がなければ整合点は確立されないことを意味します。

CURSOR ファイル・タイプと併せて指定された場合、または XML 列を含む表をロードする場合、このオプションは使用できません。

ROWCOUNT n

ロードするファイル内の物理レコードの数 n を指定します。 ユーザーはファイル内の最初の n 個の行だけをロードできます。

WARNINGCOUNT n

n 個の警告後に、ロード操作を停止します。 このパラメーターは、警告は予期されないが、 正しいファイルと表が使用されていることを確認するのが望ましい場合に設定してください。 ロード・ファイルまたはターゲット表の指定が正しくない場合、ロード対象の行ごとにロード・ユーティリティーによって警告が生成され、これがロード失敗の原因となります。 n がゼロの場合、またはこのオプションが指定されていない場合、何度警告が出されてもロード操作は続行します。

警告のしきい値に達したためにロード操作が停止された場合でも、あらためて RESTART モードでロード操作を開始できます。 ロード操作は、最後の整合点から自動的に続行します。 または、入力ファイルの先頭から REPLACE モードであらためてロード操作を開始できます。

パーティション・データベース環境において、LOAD 操作は、複数のロード・エージェントおよびパーティション・エージェントを持つことができます。 各エージェントには WARNINGCOUNT 値があります。 1 つのエージェントで n の値に到達すると、LOAD 操作は失敗します。 n 値は累積ではありません。 例えば、n が 3 であり、2 つのエージェントの WARNINGCOUNT がそれぞれ 2 である場合、LOAD 操作は成功します。

MESSAGES message-file

ロード操作中に生じ得る警告およびエラー・メッセージの宛先を指定します。 メッセージ・ファイルを指定しなかった場合、インスタンスがパーティション・データベース環境として構成されていない限り、メッセージは標準出力に書き込まれます。 このファイルへの完全パスが指定されていない場合、 ロード・ユーティリティーは現行のディレクトリーおよびデフォルトのドライブを宛先として使用します。 既に存在するファイル名を指定すると、ロード時に情報が追加されます。

通常、メッセージ・ファイルには、ロード操作の終了時にメッセージが入れられますが、 それ自体は操作の進行状況のモニターには適していません。

TEMPFILES PATH temp-pathname

ロード操作時に一時ファイルを作成する場合に使用するパスの名前を指定します。 これはサーバー・データベース・パーティションに従って完全に修飾しなければなりません。

一時ファイルは、ファイル・システムのスペースを使用します。 場合によっては、このスペースが相当必要になります。 以下のリストに示すのは、 すべての一時ファイルにどの程度のファイル・システム・スペースを割り振るべきかの見積もりです。

• ロード・ユーティリティーが生成するメッセージごとに 136 バイト
• データ・ファイルに長フィールド・データまたは LOB が入っている場合は、15 KB のオーバーヘッド。 INSERT オプションを指定した場合で、 表の中に多量の長フィールドまたは LOB データが既にある場合には、 この数値はこれよりもかなり大きくなる場合があります。

INSERT

ロード・ユーティリティーを実行できる 4 つのモードのうちの 1 つ。 既存の表データを変更することなく、ロードされたデータを表に追加します。

REPLACE

ロード・ユーティリティーを実行できる 4 つのモードのうちの 1 つ。 表から既存データをすべて削除し、ロードされたデータを挿入します。 表定義および索引定義は変更されません。 階層間でデータを移動する際にこのオプションを使用する場合は、 階層全体に関係したデータだけが置き換えられます。副表は置き換えられません。

このオプションは、システム期間テンポラル表へのデータのロードには使用できません。

KEEPDICTIONARY

LOAD REPLACE 操作の後も、既存のコンプレッション・ディクショナリーを保持します。表の COMPRESS 属性が YES の場合、新規に置換されるデータは、ロードの呼び出し前に存在していたディクショナリーを使用して圧縮されるという影響を受けます。 ディクショナリーが表の中に以前に存在していない場合、表の COMPRESS 属性が YES である限り、置換されて表に入れられるデータを使用して新規ディクショナリーが作成されます。 この場合のコンプレッション・ディクショナリーを作成するために必要なデータ量は、ADC のポリシーの影響を受けます。 このデータは圧縮解除された状態で表に取り込まれます。 ディクショナリーが表にいったん挿入されると、ロード対象の残りのデータは、このディクショナリーを使用して圧縮されるという影響を受けます。 これはデフォルト・パラメーターです。 要約を表 1 に示します。

表 1. LOAD REPLACE KEEPDICTIONARY

圧縮	表の行データ・ディクショナリーが存在する	XML ストレージ・オブジェクト・ディクショナリーが存在する1	コンプレッション・ディクショナリー	データ圧縮
YES	YES	YES	表の行データ・ディクショナリーおよび XML ディクショナリーを保存します。	ロードされるデータは圧縮の対象になります。
YES	YES	NO	表の行データ・ディクショナリーを保存し、新規 XML ディクショナリーを作成します。	ロードされる表の行データは圧縮の対象になります。 XML ディクショナリーが作成された後に、ロードされる残りの XML データは圧縮の対象になります。
YES	NO	YES	表の行データ・ディクショナリーを作成し、XML ディクショナリーを保存します。	表の行データ・ディクショナリーが作成された後に、ロードされる残りの表の行データは圧縮の対象になります。 ロードされる XML データは圧縮の対象になります。
YES	NO	NO	新規の表の行データおよび XML ディクショナリーを作成します。	ディクショナリーが作成された後に、ロードされる残りのデータは圧縮の対象になります。
NO	YES	YES	表の行データ・ディクショナリーおよび XML ディクショナリーを保存します。	ロードされるデータは、圧縮されません。
NO	YES	NO	表の行データ・ディクショナリーを保存します。	ロードされるデータは、圧縮されません。
NO	NO	YES	表の行ディクショナリーには影響はありません。 XML ディクショナリーを保存します。	ロードされるデータは、圧縮されません。
NO	NO	NO	影響なし。	ロードされるデータは、圧縮されません。

注:

1. コンプレッション・ディクショナリーは、XML 列が DB2 バージョン 9.7 以降の表に追加された場合または表が Online Table Move を使用してマイグレーションされた場合にのみ、表の XML ストレージ・オブジェクトに対して作成できます。
2. LOAD REPLACE KEEPDICTIONARY 操作が中断された場合、LOAD RESTART または LOAD TERMINATE のどちらかを実行すると、ロード・ユーティリティーをリカバリーすることができます。既存の XML ストレージ・オブジェクト・ディクショナリーは、中断された LOAD REPLACE KEEPDICTIONARY 操作をリカバリーした後は、保持されていない可能性があります。LOAD RESTART を使用する場合、新しい XML ストレージ・オブジェクト・ディクショナリーが作成されます。

RESETDICTIONARY

このディレクティブは、LOAD REPLACE 処理に、表の COMPRESS 属性が YES の場合には表データ・オブジェクトの新規ディクショナリーを作成するように指示します。 COMPRESS 属性が NO で、ディクショナリーがすでに表にある場合、それは除去され、新規ディクショナリーは表に挿入されません。 コンプレッション・ディクショナリーは 1 つのユーザー・レコードのみを使用して作成できます。 ロードするデータ・セットのサイズがゼロの場合は、既存のディクショナリーが存在していても、そのディクショナリーは保持されません。このディレクティブを使用してディクショナリーを作成するために必要なデータ量は、ADC のポリシーの影響を受けません。 要約については、表 2 を参照してください。

表 2. LOAD REPLACE RESETDICTIONARY

圧縮	表の行データ・ディクショナリーが存在する	XML ストレージ・オブジェクト・ディクショナリーが存在する1	コンプレッション・ディクショナリー	データ圧縮
YES	YES	YES	新規ディクショナリーの作成2。 DATA CAPTURE CHANGES オプションが CREATE TABLE または ALTER TABLE ステートメントで有効になっていると、現在の表の行データ・ディクショナリーが保持されます (これは履歴コンプレッション・ディクショナリー と呼ばれます)。	ディクショナリーが作成された後に、ロードされる残りのデータは圧縮の対象になります。
YES	YES	NO	新規ディクショナリーの作成2。 DATA CAPTURE CHANGES オプションが CREATE TABLE または ALTER TABLE ステートメントで有効になっていると、現在の表の行データ・ディクショナリーが保持されます (これは履歴コンプレッション・ディクショナリー と呼ばれます)。	ディクショナリーが作成された後に、ロードされる残りのデータは圧縮の対象になります。
YES	NO	YES	新規ディクショナリーの作成。	ディクショナリーが作成された後に、ロードされる残りのデータは圧縮の対象になります。
YES	NO	NO	新規ディクショナリーの作成。	ディクショナリーが作成された後に、ロードされる残りのデータは圧縮の対象になります。
NO	YES	YES	ディクショナリーを除去します。	ロードされるデータは、圧縮されません。
NO	YES	NO	表の行データ・ディクショナリーを除去します。	ロードされるデータは、圧縮されません。
NO	NO	YES	XML ストレージ・オブジェクト・ディクショナリーを除去します。	ロードされるデータは、圧縮されません。
NO	NO	NO	影響なし。	すべての表データが圧縮されるわけではありません。

注:

1. コンプレッション・ディクショナリーは、XML 列が DB2 バージョン 9.7 以降の表に追加された場合または表が Online Table Move を使用してマイグレーションされた場合にのみ、表の XML ストレージ・オブジェクトに対して作成できます。
2. ディクショナリーが存在していて圧縮属性が有効であるものの、表パーティションにロードするレコードがない場合、新規ディクショナリーを作成することはできず、RESETDICTIONARY 操作では既存のディクショナリーは保持されません。

TERMINATE

ロード・ユーティリティーを実行できる 4 つのモードのうちの 1 つ。 以前に割り込みを受けたロード操作を終了し、 ロード操作が開始された時点まで操作をロールバックします。 途中に整合点があっても通過します。 その操作に関係する表スペースの状態は通常に戻され、 すべての表オブジェクトの整合性が保たれます (索引オブジェクトが無効とマークされる場合がありますが、 そのような場合には、次回のアクセス時に索引の再作成が自動的に行われます)。 終了するロード操作が LOAD REPLACE の場合、その表は LOAD TERMINATE 操作完了後に空の表まで切り捨てられます。 終了するロード操作が LOAD INSERT の場合、 その表は LOAD TERMINATE 操作完了後も元のレコードをすべて保持します。 ディクショナリー管理の要約を表 3 に示します。

LOAD TERMINATE オプションでは、表スペースの BACKUP PENDING 状態は解除されません。

RESTART

ロード・ユーティリティーを実行できる 4 つのモードのうちの 1 つ。 以前に割り込みを受けたロード操作を再開します。 ロード操作は、ロード、作成、または削除フェーズの最後の整合点から自動的に続行されます。 ディクショナリー管理の要約を表 4 に示します。

INTO table-name

データのロード先となるデータベース表を指定します。 この表として、システム表、宣言済み一時表、または作成済み一時表は指定できません。 別名、完全修飾、または非修飾の表名を指定できます。 修飾された表名は、schema.tablename の形式になります。 非修飾の表名を指定すると、その表は CURRENT SCHEMA で修飾されます。

暗黙的な非表示列がデータベース表に含まれる場合には、ロード操作に非表示列のデータを含めるかどうかを指定する必要があります。 非表示列のデータを含めるかどうかを示すには、以下のいずれかの方法を使用します。

• データの挿入先の列を明示的に指定する場合、insert-column を使用します。

  db2 load from delfile1 of del
     insert into table1 (c1, c2, c3,...)

• 非表示列のファイル・タイプ修飾子のいずれかを使用します。入力ファイルに非表示列のデータが含まれる場合には implicitlyhiddeninclude を指定し、入力ファイルに含まれない場合には implicitlyhiddenmissing を指定します。

  db2 load from delfile1 of del modified by implicitlyhiddeninclude
     insert into table1 

• 暗黙的な非表示列が含まれる表をデータ移動ユーティリティーが検出した場合のデフォルト動作を設定するには、DB2_DMU_DEFAULT レジストリー変数をサーバー・サイドで使用します。 暗黙的な非表示列が含まれるとユーティリティーが想定するようにするには IMPLICITLYHIDDENINCLUDE を、暗黙的な非表示列は含まれないとユーティリティーが想定するようにするには IMPLICITLYHIDDENMISSING を指定します。

  db2set DB2_DMU_DEFAULT=IMPLICITLYHIDDENINCLUDE
  db2 load from delfile1 of del insert into table1 

insert-column

データの挿入先となる表の列を指定します。

ロード・ユーティリティーは、1 つ以上のスペースを使った名前の列を解析できません。 例えば、次のようになります。

db2 load from delfile1 of del noheader 
   method P (1, 2, 3, 4, 5, 6, 7, 8, 9)
   insert into table1 (BLOB1, S2, I3, Int 4, I5, I6, DT7, I8, TM9)

は、Int 4 列があるためエラーになります。 これは、次のようにして二重引用符で列名を囲むことによって解決できます。

db2 load from delfile1 of del noheader 
   method P (1, 2, 3, 4, 5, 6, 7, 8, 9)
   insert into table1 (BLOB1, S2, I3, "Int 4", I5, I6, DT7, I8, TM9)

FOR EXCEPTION table-name

エラーが発生した行のコピー先となる例外表を指定します。 ユニーク索引または主キー索引に違反した行がすべてコピーされます。 非修飾の表名を指定すると、その表は CURRENT SCHEMA で修飾されます。

例外表に書き込まれる情報は、 ダンプ・ファイルには書き込まれません 。 パーティション・データベース環境では、 ロードする表を定義されたデータベース・パーティションの例外表を定義する必要があります。 一方、ダンプ・ファイルには、無効であるか構文エラーであるためにロードできない行が入ります。

XML データのロード時に、FOR EXCEPTION 節を使用したロード例外表の指定は、以下の状況ではサポートされません。

• ラベル・ベースのアクセス制御 (LBAC) を使用する場合。
• パーティション表にデータをロードする場合。

NORANGEEXC

範囲違反のためにリジェクトされた行は、例外表に挿入しないことを指定します。

NOUNIQUEEXC

ユニーク制約に違反しているためにリジェクトされた行は、例外表に挿入しないことを指定します。

STATISTICS USE PROFILE

この表で定義されているプロファイルに従ってロード中に統計を収集するようロード操作に指示します。 そのプロファイルは、ロードの実行前に作成されていなければなりません。 そのプロファイルは、RUNSTATS コマンドで作成します。 プロファイルが存在しない場合に、プロファイルに従って統計を収集するようロード操作に指示すると、 警告メッセージが戻されて統計は収集されません。

ロードの際に、分散統計はタイプ XML の列については収集されません。

STATISTICS NO

統計データを収集せず、したがってカタログ内の統計データも変更しないことを指定します。 これはデフォルトです。

COPY NO

順方向リカバリーが有効である場合 (つまり、logarchmeth1 または logarchmeth2 に OFF 以外の値が設定されている場合)、表が存在している表スペースをバックアップ・ペンディング状態にするよう指定します。 COPY NO オプションを使用する場合も、表スペース状態は LOAD IN PROGRESS になります。 これは、一時的な状態であり、 ロードが完了するか打ち切られると解除されます。 表スペースのバックアップまたはデータベースのフルバックアップを実行しない限り、 表スペースのどの表のデータも更新または削除できません。 ただし、SELECT ステートメントを使用すれば、 どの表のデータにもアクセス可能です。

リカバリー可能データベースでの COPY NO を指定した LOAD は、表スペースを BACKUP PENDING 状態のままにします。 例えば、COPY NO を指定した LOAD および INDEXING MODE DEFERRED を実行すると、 索引はリフレッシュが必要な状態になります。 表での照会には、索引スキャンが必要なものがあり、 索引がリフレッシュされるまで、成功しません。索引が、バックアップ・ペンディング状態にある表スペース内にある場合、その索引のリフレッシュはできません。 この場合、表へのアクセスは、バックアップが行われるまで許可されません。 索引リフレッシュは、索引が照会によってアクセスされたときに、 データベースによって自動的に行われます。COPY NO、COPY YES、NONRECOVERABLE のいずれも指定されておらず、データベースがリカバリー可能である場合 (logarchmeth1 または logarchmeth2 に OFF 以外の値が設定されている場合)、COPY NO がデフォルトです。

COPY YES

ロードするデータのコピーを保存することを指定します。 フォワード・リカバリーが使用不可になっている場合、このオプションは無効です。

USE TSM

Tivoli® Storage Manager (TSM) を使ってコピーを保管することを指定します。

OPEN num-sess SESSIONS

TSM またはベンダー製品とともに使用する入出力セッションの数です。 デフォルト値は 1 です。

TO device/directory

コピー・イメージを作成する先の装置またはディレクトリーを指定します。

LOAD lib-name

使用するバックアップおよびリストア I/O ベンダー関数を含む共有ライブラリー (Windows オペレーティング・システムでは DLL) の名前。 絶対パスで指定することができます。 絶対パスを指定しない場合、 デフォルトでユーザー出口プログラムの存在するパスになります。

NONRECOVERABLE

ロード・トランザクションがリカバリー不能としてマークされており、 それ以降のロールフォワード・アクションによってそれをリカバリーさせることは不可能であることを指定します。 ロールフォワード・ユーティリティーは、そのトランザクションをスキップし、データのロード先の表に「無効」としてマークします。 さらに、ユーティリティーは、その表に対する後続のすべてのトランザクションを無視します。 ロールフォワード操作が完了すると、そのような表は、ドロップするか、 またはリカバリー不能なロード操作完了後のコミット・ポイントの後に取られたバックアップ (フルバックアップまたは表スペースのバックアップ) からリストアすることのみ可能です。

このオプションを使用すると、 表スペースはロード操作後に BACKUP PENDING 状態になりません。 また、ロード操作中にロードされたデータのコピーが作成される必要もなくなります。 COPY NO、COPY YES、NONRECOVERABLE のいずれも指定されておらず、データベースがリカバリー可能ではない場合 (logarchmeth1 および logarchmeth2 の両方に OFF が設定されている場合)、NONRECOVERABLE がデフォルトです。

WITHOUT PROMPTING

データ・ファイルのリストにロードするすべてのファイルを含め、 しかもリストに入っている装置またはディレクトリーがロード操作全体で十分であるということを指定します。 続きの入力ファイルが見つからなかったり、 ロード操作が終了する前にコピー先がいっぱいになったりするとロード操作は失敗し、 表は LOAD PENDING 状態のままになります。

このオプションを指定しない場合に、 テープ装置がコピー・イメージ用のテープの終わりに達した場合、 またはリスト中の最後の項目がテープ装置であった場合は、 ユーザーに対してその装置に新しいテープを装着するよう求めるプロンプトが出されます。

DATA BUFFER buffer-size

ユーティリティー内でデータを転送するためのバッファー・スペースとして使用する 4 KB ページの数を指定します (並列処理の度合いには依存しません)。 指定する値がアルゴリズム上の最小値より小さい場合、 最小限必要なリソースが使用され、警告は戻されません。

このメモリーは、ユーティリティー・ヒープから直接に割り当てられ、 そのサイズは util_heap_sz データベース構成パラメーターで修正可能です。 バージョン 9.5 以降では、システムにさらに使用可能なメモリーがある場合、LOAD コマンドの DATA BUFFER オプションの値は、一時的に util_heap_sz を超えることができます。この場合、ユーティリティー・ヒープは、必要に応じて database_memory 限度に達するまで動的に増加します。このメモリーは、ロード操作が完了すると解放されます。

値が指定されていない場合、実行時にユーティリティーによって適切なデフォルトが計算されます。デフォルトは、ローダーのインスタンス生成時にユーティリティー・ヒープで使用できるフリー・スペースの割合と、表の一部の特性に基づいて決まります。

SORT BUFFER buffer-size

このオプションは、ロード操作時に sortheap データベース構成パラメーターをオーバーライドする値を指定します。 これは、索引とともに表をロードする場合、 また INDEXING MODE パラメーターが DEFERRED として指定されていない場合にのみ関係があります。 指定された値は sortheap の値を超えることはできません。 このパラメーターは、sortheap の値を変更せずに多くの索引を持つ表をロードする際に使用される、ソート・メモリーのスロットルで役に立ちます。 これは、一般的な照会処理にも影響を与えます。

CPU_PARALLELISM n

表オブジェクトの作成時に、レコードの解析、変換、およびフォーマット設定のためにロード・ユーティリティーによって作成されるプロセスまたはスレッドの数を指定します。 このパラメーターは、データベース・パーティションごとに実行するプロセスの数を活用するために設計されています。 これは、事前にソートされたデータをロードする際に役立ちます (ソース・データのレコード順序が保持されるため)。 このパラメーターの値が 0 の場合や、このパラメーターを指定しなかった場合、ロード・ユーティリティーは、実行時に自動的に計算された適切なデフォルト値 (通常は使用できる CPU の数に基づく) を使用します。

注:

1. LOB または LONG VARCHAR フィールドのどちらかの入った表でこのパラメーターを使用する場合、 システムの CPU の数またはユーザーが指定した値には関係なく、値は 1 になります。
2. SAVECOUNT パラメーターに指定する値が小さいと、 データと表のメタデータの両方をフラッシュするために、 ローダーがさらに多くの入出力操作を実行することになります。 CPU_PARALLELISM が 1 より大きいなら、 フラッシュ操作は非同期になり、ローダーは CPU を活用できます。 CPU_PARALLELISM が 1 に設定されている場合、 ローダーは整合点において入出力を待ちます。 CPU_PARALLELISM を 2 に設定し、SAVECOUNT を 10 000 に設定したロード操作は、 CPU が 1 つしかなくても、同じ操作で CPU_PARALLELISM を 1 に設定した場合より速く完了します。

DISK_PARALLELISM n

表スペース・コンテナーにデータを書き込むためにロード・ユーティリティーが作成するプロセスまたはスレッドの数を指定します。 値を指定しない場合、ユーティリティーは表スペース・コンテナーの数と表の特性に基づいて、 自動的に計算された適切なデフォルトを選択します。

INDEXING MODE

ロード・ユーティリティーが索引を再作成するのか、 それとも索引を増分で拡張するのかを指定します。 有効な値は以下のとおりです。

AUTOSELECT

REBUILD モードと INCREMENTAL モードのいずれにするかを、 ロード・ユーティリティーが自動的に決定します。決定は、ロードされるデータ量と索引ツリーの深さに基づいて行われます。索引ツリーの深さに関連する情報は索引オブジェクトに保管されています。この情報を設定するために、RUNSTATS は不要です。 AUTOSELECT がデフォルトの索引付けモードです。

REBUILD

すべての索引が再作成されます。 古い表データの索引キー部分も、 追加される新しい表データの索引キー部分もすべてソートできるようにするため、 ロード・ユーティリティーには十分なリソースが必要となります。

LogIndexBuild データベース構成パラメーターがオンになっている場合、トランザクション・ログには、各索引ページの作成後にそのページのイメージが含まれます。 LogIndexBuild データベース構成パラメーターがオフになっている場合、索引マネージャーがログに記録するのは、各ページの割り振りと初期化のみです (各ページの空ではない部分とは異なり、ページ当たり約 250 バイト)。

INCREMENTAL

索引に新しいデータが取り込まれて拡張します。 このアプローチでは、索引のフリー・スペースが消費されます。 このアプローチでは、 新たに挿入されるレコードの索引キーを追加するためのソート・スペースだけがあれば十分です。 この方式がサポートされるのは、索引オブジェクトが有効で、 かつロード操作の開始時にアクセス可能な場合だけです (例えば、 DEFERRED モードが指定されたロード操作の直後では、この方式は無効です)。 このモードを指定したものの、索引の状態などの理由でサポートされない場合は、 警告が戻され、REBUILD モードでロード操作が続行されます。 同様に、ロード作成フェーズでロード再開操作を開始した場合も、 INCREMENTAL モードはサポートされません。

LogIndexBuild データベース構成パラメーターがオンになっている場合、DB2 ソフトウェアは、実行されたページ分割のほか、索引への各キーの挿入に関してもログ・レコードを生成します。 このパラメーターがオフになっている場合 (HADR を使用していない場合に一般的)、索引マネージャーによって実行される索引ロギングの量は、ALLOW READ ACCESS オプションが指定されたかどうかに応じて異なります。 ALLOW READ ACCESS オプションが指定されている場合、ページ分割に関するログを含んだログ・レコードが生成されます。 ALLOW READ ACCESS オプションが指定されていない場合、索引マネージャーからのログ・レコードは生成されません。

DEFERRED

このモードが指定されている場合、ロード・ユーティリティーは索引の作成を試みません。 リフレッシュが必要であることを示すマークが索引に付けられます。 ロード操作とは関係のないこのような索引に最初にアクセスするときは、 再作成が強制的に実行されたり、 データベースの再始動時に索引が再作成されたりする場合があります。 このアプローチでは、 最も大きい索引のキー部分をすべて処理できるだけのソート・スペースが必要です。 索引を作成するためにその後かかる合計時間は、REBUILD モードの場合よりも長くなります。 したがって、この索引作成据え置きモードで複数のロード操作を実行する場合、 最初の非ロード・アクセス時に索引を再作成できるようにしておくよりも、 順序列内の最後のロード操作で索引の再作成を実行できるようにした方が (パフォーマンスの観点から) 賢明であるといえます。

据え置き索引作成がサポートされるのは、非ユニーク索引がある表だけです。そのため、 ロード・フェーズで挿入される重複キーがロード操作後は永続的ではなくなります。

ALLOW NO ACCESS

ロードを使用すると、ロード中に、 排他的アクセスのためにターゲット表がロックされます。 ロード中、表の状態は LOAD IN PROGRESS に設定されます。 ALLOW NO ACCESS はデフォルトの動作です。 これは、LOAD REPLACE で唯一有効なオプションです。

表に制約があると、表の状態は、 ロード中の他に、SET INTEGRITY ペンディングに設定されます。 表の SET INTEGRITY ペンディング状態を解除するには、SET INTEGRITY ステートメントを使用する必要があります。

ALLOW READ ACCESS

ロードを使用すると、ターゲット表は共有モードでロックされます。 表の状態は、LOAD IN PROGRESS および READ ACCESS の両方に設定されます。 表のロード中、データの非デルタ部分にアクセスすることができます。 つまり、表を読み取る側はロードの開始前に存在していたデータにはアクセスができ、 ロード中のデータはロードが完了するまで利用できない、ということです。

重要: バージョン 10.1 フィックスパック 1 以降、ALLOW READ ACCESS パラメーターは非推奨となっており、将来のリリースで除去される可能性があります。 詳しくは、LOAD コマンドの ALLOW READ ACCESS パラメーターが非推奨になったを参照してください。

ALLOW READ ACCESS ロードの LOAD TERMINATE および LOAD RESTART はこのパラメーターを使用できますが、ALLOW NO ACCESS ロードの LOAD TERMINATE および LOAD RESTART はこのパラメーターを使用できません。 また、ターゲット表上の索引が要再作成のマークが付けられると、 このオプションは無効になります。

表に制約があると、表の状態は、LOAD IN PROGRESS、および READ ACCESS の他に、SET INTEGRITY PENDING に設定されます。 ロードの終了時に、表の状態 LOAD IN PROGRESS は解除されますが、SET INTEGRITY PENDING および READ ACCESS はそのまま残ります。 表の SET INTEGRITY PENDING を解除するには、SET INTEGRITY ステートメントを使用する必要があります。 表が SET INTEGRITY PENDING および READ ACCESS の状態にある間、 データの非デルタ部分には引き続き読み取りアクセスできますが、データの新しい (デルタ) 部分には、 SET INTEGRITY ステートメントが完了するまでアクセス不能のままになります。 ユーザーは、SET INTEGRITY ステートメントを発行しないで、同じ表上で複数のロードを実行できます。 ただし、元の (チェック済み) データは、 SET INTEGRITY ステートメントが発行されるまで可視のままです。

ALLOW READ ACCESS は、以下の修飾子もサポートします。

USE tablespace-name

索引が再作成される場合、 表スペース tablespace-name に索引のシャドー・コピーが作成され、 ロード終了時の INDEX COPY PHASE で、元の表スペース上にコピーされます。 SYSTEM TEMPORARY 表スペースのみ、このオプションを使用できます。 指定されない場合、シャドー索引が、索引オブジェクトと同じ表スペース内に作成されます。 シャドー・コピーが索引オブジェクトと同じ表スペース内に作成される場合、 古い索引オブジェクトを介したシャドー索引オブジェクトのコピーは瞬時に終了します。 シャドー・コピーが索引オブジェクトとは異なる表スペースにある場合、物理コピーが実行されます。 これにはかなりの入出力および時間を要します。 コピーは、表がオフラインの間、 ロード終了時の INDEX COPY PHASE で行われます。

このオプションを使用しないと、シャドー索引は元の索引と同じ表スペースに作成されます。 デフォルトでは、元の索引とシャドー索引の両方が同時に同じ表スペースに常駐するため、 1 つの表スペース内に両方の索引を保持するためのスペースが不足する場合があります。 このオプションを使用すれば、索引用の十分な表スペースを保持できます。

ユーザーが INDEXING MODE REBUILD または INDEXING MODE AUTOSELECT を指定しない場合、 このオプションは無視されます。 このオプションは INDEXING MODE AUTOSELECT が選択され、 ロードが索引を徐々に更新することを選択した場合にも無視されます。

FETCH_PARALLELISM YES | NO

DATABASE キーワードを使用してカーソルが宣言されていてカーソルからのロードを実行するとき、または API の sqlu_remotefetch_entry メディア項目を使用するとき、このオプションが YES に設定されていると、ロード・ユーティリティーは、リモート・データ・ソースからのフェッチの並列化を試みます (可能な場合)。 現時点では、データ・フェッチを並列化できるのは、カーソルの select ステートメントが単純形式 "SELECT * FROM <tablename>" である場合のみです。 NO に設定されている場合、並列フェッチは行われません。 デフォルト値は YES です。詳しくは、『CURSOR ファイル・タイプを使用したデータの移動』を参照してください。

SET INTEGRITY PENDING CASCADE

LOAD によって表が SET INTEGRITY ペンディング状態になる場合、 SET INTEGRITY PENDING CASCADE オプションを使用することによって、ユーザーはロードされる表の SET INTEGRITY ペンディング状態を即時にすべての下層 (下層外部キー表、下層即時マテリアライズ照会表、および下層即時ステージング表を含む) にカスケードするかどうか指定することができます。

IMMEDIATE

外部キー制約の SET INTEGRITY PENDING 状態が即時にすべての下層外部キー表、下層即時マテリアライズ照会表、および下層ステージング表に拡張されることを示します。 LOAD INSERT 操作の場合、IMMEDIATE オプションが指定されている場合でも、 SET INTEGRITY PENDING 状態は下層外部キー表に拡張されません。

後で (SET INTEGRITY ステートメントの IMMEDIATE CHECKED オプションを使用して) ロードされる表の制約違反をチェックする際、SET INTEGRITY PENDING READ ACCESS 状態だった下層外部キー表は、SET INTEGRITY PENDING NO ACCESS 状態になります。

DEFERRED

ロードされる表だけが、SET INTEGRITY PENDING 状態になることを示します。 下層外部キー表、下層即時マテリアライズ照会表、および下層即時ステージング表は、 未変更のままになります。

下層外部キー表は、(SET INTEGRITY ステートメントの IMMEDIATE CHECKED オプションを使用して) その親表の制約違反がチェックされるとき、後で暗黙的に SET INTEGRITY PENDING 状態になる場合があります。 下層即時マテリアライズ照会表および下層即時ステージング表は、 その基礎表のいずれかの保全性違反がチェックされる際、 暗黙的に SET INTEGRITY PENDING 状態になります。 照会のアクセス先が、指定された表ではなく、SET INTEGRITY PENDING 状態にない適格なマテリアライズ照会表である場合は、SET INTEGRITY PENDING 状態の表の照会が成功することがあります。 下層表が SET INTEGRITY ペンディング状態になったことを示す警告 (SQLSTATE 01586) が出されます。この下層表がいつ SET INTEGRITY PENDING 状態になるかについては、 SQL リファレンスにある SET INTEGRITY ステートメントの「注」の項を参照してください。

SET INTEGRITY PENDING CASCADE オプションが指定されない場合、次のようになります。

• ロードされる表だけが、SET INTEGRITY PENDING 状態になります。 下層外部キー表、下層即時マテリアライズ照会表、および下層即時ステージング表の状態は未変更のままになり、後にロードされた表の制約違反がチェックされる際に、暗黙的に SET INTEGRITY PENDING 状態になる場合があります。

LOAD によってターゲット表が SET INTEGRITY PENDING 状態にならない場合、SET INTEGRITY PENDING CASCADE オプションは無視されます。

LOCK WITH FORCE

ユーティリティーはロード・プロセス中に、表ロックなどの様々なロックを獲得します。 ロックを獲得する際、このオプションを使用すると、 ロードは待機することなく、またタイムアウトになることなく、 ターゲット表に競合するロックを持つ他のアプリケーションを強制的にオフにします。 システム・カタログ表に対する競合するロックを保持するアプリケーションは、 ロード・ユーティリティーによって強制的にオフにされることはありません。 強制されたアプリケーションは、 ロールバックし、ロード・ユーティリティーが必要とするロックをリリースします。 その後、ロード・ユーティリティーを続行できます。 このオプションは、FORCE APPLICATIONS コマンドと同じ権限 (SYSADM または SYSCTRL) を必要とします。

ALLOW NO ACCESS ロードは、ロード操作の開始時に競合するロックを持つアプリケーションを強制的にロールバックさせる場合があります。 ロードの開始時に、ユーティリティーは、 表の照会または変更を試みているアプリケーションを強制的にロールバックさせる場合があります。

ALLOW READ ACCESS ロードは、ロード操作の開始時および終了時に競合するロックを持つアプリケーションを強制的にロールバックさせる場合があります。 ロードの開始時に、ロード・ユーティリティーは、 表の変更を試みているアプリケーションを強制的にロールバックさせる場合があります。 ロード操作の終了時に、ロード・ユーティリティーは、 表の照会または変更を試みているアプリケーションを強制的にロールバックさせる場合があります。

SOURCEUSEREXIT executable

このユーティリティーにデータを送るために呼び出される実行可能ファイル名を指定します。

REDIRECT

INPUT FROM

BUFFER input-buffer

input-buffer で指定されたバイトのストリームが、所定の実行可能ファイルを実行するプロセスの STDIN ファイル記述子に渡されます。

FILE input-file

このクライアント・サイドのファイルの内容が、所定の実行可能ファイルを実行するプロセスの STDIN ファイル記述子に渡されます。

OUTPUT TO

FILE output-file

STDOUT および STDERR ファイル記述子が、指定した完全修飾されたサーバー・サイドのファイルに取り込まれます。

PARALLELIZE

複数のユーザー出口プロセスを同時に呼び出すことによって、ロード・ユーティリティーへのデータ入力のスループットを高めます。 このオプションは、複数パーティション・データベース環境でのみ適用でき、単一パーティション・データベース環境では無視されます。

詳細については、『カスタマイズしたアプリケーション (ユーザー出口) を使用したデータの移動』を参照してください。

PARTITIONED DB CONFIG partitioned-db-option

複数のデータベース・パーティションに分散した表へのロードの実行を可能にします。 PARTITIONED DB CONFIG パラメーターを使用すると、 パーティション・データベース固有の構成オプションを指定することができます。 partitioned-db-option の値は、以下のオプションのいずれかになります。

PART_FILE_LOCATION x
OUTPUT_DBPARTNUMS x
PARTITIONING_DBPARTNUMS x
MODE x
MAX_NUM_PART_AGENTS x
ISOLATE_PART_ERRS x
STATUS_INTERVAL x
PORT_RANGE x
CHECK_TRUNCATION
MAP_FILE_INPUT x
MAP_FILE_OUTPUT x
TRACE x
NEWLINE
DISTFILE x
OMIT_HEADER
RUN_STAT_DBPARTNUM x

これらのオプションの詳しい説明は、『パーティション・データベース環境のロード構成オプション』で扱われています。

RESTARTCOUNT

非推奨。

USING directory

非推奨。

使用上の注意

• データは、入力ファイル内に並んでいる順序でロードされます。 特定の順序にしたい場合には、ロードが試行される前にデータをソートしてください。 ソース・データの順序を保持する必要がなければ、ANYORDER ファイル・タイプ修飾子を使用することを考慮してください。この修飾子については、以下の『ロード・ユーティリティーのファイル・タイプ修飾子』セクションを参照してください。
• ロード・ユーティリティーは、既存の定義に基づいて索引を作成します。 ユニーク・キーの重複を処理するのに、例外表が使用されます。 ユーティリティーは、参照整合性を強制したり、制約検査を実行したり、ロードする表に従属するマテリアライズ照会表を更新したりすることはありません。 参照制約またはチェック制約を含む表は、SET INTEGRITY ペンディング状態になります。 REFRESH IMMEDIATE として定義されているサマリー表、 およびロードする表に依存するサマリー表もまた、SET INTEGRITY ペンディング状態になります。 これらの表に関して、SET INTEGRITY ペンディング (Set Integrity Pending) 状態を解除するには、SET INTEGRITY ステートメントを発行してください。 ロード操作は、複製されたマテリアライズ照会表では実行できません。
• クラスタリング索引が表に存在する場合、ロード前にクラスタリング索引でデータをソートしてください。 ただし、データはマルチディメンション・クラスタリング (MDC) 表にロードする前にソートする必要はありません。
• 保護された表へのロード時に例外表を指定すると、無効なセキュリティー・ラベルで保護されている行がその表に送られます。 そのため、例外表にアクセスできるユーザーは、通常はアクセス権限のないデータにアクセスできてしまう可能性があります。 セキュリティー・レベルを上げるために、誰に例外表アクセス権限を付与するかに注意し、行が修復されてロードする表にコピーされたら直ちにそれぞれの行を削除するとともに、使い終えた例外表は直ちにドロップしてください。
• 内部形式のセキュリティー・ラベルには、改行文字が含まれている可能性があります。 DEL ファイル形式を使用するファイルをロードする場合、この改行文字が区切り文字と間違われることがあります。 この問題が起きた場合は、LOAD コマンドで delprioritychar ファイル・タイプ修飾子を指定することによって、区切り文字に以前のデフォルト優先順位を使用してください。
• DECLARE CURSOR ステートメントの実行中に指定した DATABASE キーワードが CURSOR ファイル・タイプを使用してロードを実行する場合、現在接続されているデータベース (ロード用) の認証に使用されるユーザー ID およびパスワードが (DECLARE CURSOR ステートメントの DATABASE オプションによって指定された) ソース・データベースの認証に使用されます。ユーザー ID またはパスワードがロード・データベースの接続に指定されない場合、ソース・データベースのユーザー ID とパスワードは DECLARE CURSOR ステートメントの実行中に指定する必要があります。
• 個々のパートが Windows システムから AIX® システムにコピーされる、複数パーツの PC/IXF ファイルのロードがサポートされます。 すべてのファイルの名前は、LOAD コマンドで指定する必要があります。 例えば、LOAD FROM DATA.IXF, DATA.002 OF IXF INSERT INTO TABLE1 となります。 論理分割された PC/IXF ファイルから Windows オペレーティング・システムにロードすることはサポートされていません。
• 失敗した LOAD を再始動する場合、その動作は、BUILD フェーズで索引用に REBUILD モードの使用が強制されるという点で、既存の動作に従います。
• COPY YES オプションが使用されている場合、ロード・ユーティリティーはイメージ・ファイルの非常に大きなコピーを生成することがあります。 この動作が予期されるのは、LOAD コマンドが、ロードされる LOB/LF 列値ごとにデータのバッファー全体をすべてコピー・イメージに書き出すときです。バッファーは内部オブジェクトであり、そのサイズはいくつかの内部要因および外部要因によって決まります。 一般的に、バッファー・サイズは 68 KB から数百 KB の間です。
• データベース間での XML 文書のロードはサポートされておらず、エラー・メッセージ SQL1407N が戻されます。
• LOAD ユーティリティーでは、fenced プロシージャーを参照する列を含む表へのロードはサポートされていません。このような表に対して LOAD コマンドを発行すると、エラー・メッセージ SQL1376N を受け取ります。この制約事項に対処するには、ルーチンを unfenced に再定義するか、インポート・ユーティリティーを使用することができます。
• ユーザー定義関数がコンパイル済みコンパウンド SQL である生成列式が表に含まれている場合、その表にデータを挿入するために使用できるのは generatedoverride ファイル・タイプ修飾子を指定した LOAD ユーティリティーのみです。これらの表には、インポート・ユーティリティーを使用してデータを挿入することもできます。
• 暗黙的な非表示列がデータベース表に含まれる場合には、ロード操作に非表示列のデータを含めるかどうかを指定する必要があります。
• IMPORT ユーティリティーは、表内の列数とデータ・ファイル内のフィールド数の突き合わせを行いません。このユーティリティーは、データ・ファイル内に十分な量のデータがあるかどうかをチェックします。データ・ファイル内の行に十分なデータ列が含まれていない場合、その行は拒否されて警告メッセージが表示される (表の対応するデータのない列が NOT NULL として定義されている場合) か、警告メッセージは表示されずに正常に挿入されます (表の対応する列が NULL として定義されている場合)。一方、行に必要な数より多くの列が含まれている場合、必要な数の列が処理され、残りのデータ列は省略されます。警告メッセージは表示されません。
• STATISTICS オプションは、LOAD REPLACE オプションにおいてのみ作動し、その他の LOAD コマンド・オプションでは作動しません。

LOAD TERMINATE および LOAD RESTART ディクショナリー管理の要約

次の図表は、TERMINATE ディレクティブの下での LOAD 処理に関するコンプレッション・ディクショナリー管理の動作を要約しています。

LOAD RESTART は、到達した最後の整合点まで表を切り捨てます。 LOAD RESTART 処理の一部として、最後の LOAD 整合点が取られたときにコンプレッション・ディクショナリーが表にあった場合、そのディクショナリーが表に存在します。 その場合、LOAD RESTART では新規ディクショナリーは作成されません。 考えられる条件の要約については、表 4 を参照してください。

ロード・ユーティリティー用のファイル・タイプ修飾子

SET INTEGRITY FOR table-name GENERATED COLUMN 
  IMMEDIATE UNCHECKED

SET INTEGRITY FOR table-name IMMEDIATE CHECKED.

"CONFIDENTIAL:ALPHA:G2"
"CONFIDENTIAL;SIGMA:G2"
"TOP SECRET:ALPHA:G2"

LOAD FROM input.del OF DEL MODIFIED BY SECLABELCHAR INSERT INTO t1

"LABEL1"
"LABEL1"
"LABEL2"

   LOAD FROM input.del OF DEL MODIFIED BY SECLABELNAME INSERT INTO t1

YYYY   - 年 (0000 から 9999 の範囲の 4 桁の数)
M      - 月 (1 から 12 の範囲の 1 桁または 2 桁の数)
MM     - 月 (01 から 12 の 2 桁の数。
         M とは相互に排他的)
D      - 日 (1 から 31 の範囲の 1 桁または 2 桁の数)
DD     - 日 (01 から 31 の範囲の 2 桁の数。
         D とは相互に排他的)
DDD    - 元日から数えた日数 (001 から 366 の範囲の 3 桁の数。
         他の日または月エレメントとは
         相互に排他的)

"D-M-YYYY"
"MM.DD.YYYY"
"YYYYDDD"

db2 load from data of del
   modified by dumpfile = /u/user/filename
   insert into table_name

H      - 時 (12 時間制の場合は 0 から 12、
           24 時間制では 0 から 24 の範囲の
           1 桁または 2 桁の数)
HH     - 時 (12 時間制の場合は 00 から 12、
           24 時間制では 00 から 24 の範囲の
           2 桁の数;
             H と相互に排他的)
M     - 分 (0 から 59 の範囲の
           1 桁または 2 桁の数)
MM    - 分 (00 から 59 の範囲の 2 桁の数。
           M とは相互に排他的)
S     - 秒 (0 から 59 の範囲の
           1 桁または 2 桁の数)
SS    - 秒 (00 から 59 の範囲の 2 桁の数。
           S と相互に排他的)
SSSSS - 夜中の 12 時から数えた秒数
           (00000 から 86400 の範囲の 5 桁の数。
           他の時刻エレメントとは相互に排他的)
TT     - 午前/午後の指定子 (AM または PM)

"HH:MM:SS"
"HH.MM TT"
"SSSSS"

YYYY   - 年 (0000 から 9999 の範囲の 4 桁の数)
M      - 月 (1 から 12 の範囲の 1 桁または 2 桁の数)
MM     - 月 (01 から 12 の 2 桁の数。
            M および MMM とは相互に排他的)
MMM    - 月 (大文字小文字を区別しない月名の 3 文字の省略形。
            M と MM とは相互に排他的)
D      - 日 (1 から 31 の範囲の 1 桁または 2 桁の数)
DD     - 日 (01 から 31 の範囲の 2 桁の数。D とは相互に排他的)
DDD    - 元日から数えた日数 (001 から 366 の範囲の 3 桁の数。
            他の日または月のエレメントとは相互に排他的)
H      - 時 (12 時間制の場合は 0 から 12、24 時間制では 0 から 24 の
            範囲の 1 桁または 2 桁の数。)
HH     - 時 (12 時間制の場合は 00 から 12、24 時間制では 00 から 24 の
            範囲の 2 桁の数。
            H と相互に排他的)
M      - 分 (0 から 59 の範囲の 1 桁または 2 桁の数)
MM     - 分 (00 から 59 の範囲の 2 桁の数。
            M (分) とは相互に排他的)
S      - 秒 (0 から 59 の範囲の 1 桁または 2 桁の数)
SS     - 秒 (00 から 59 の範囲の 2 桁の数。
            S と相互に排他的)
SSSSS  - 夜中の 12 時から数えた秒数
            (00000 から 86400 の範囲の 5 桁の数。
            他の時刻エレメントとは相互に排他的)
U (1 から 12 時)
         - 小数秒 (U のオカレンス数は、各桁を 0 から 9 の範囲として、
              桁数を表します)
TT     - 午前/午後の指定子 (AM または PM)

   "YYYY/MM/DD HH:MM:SS.UUUUUU"

YYYY-MM-DD-HH.MM.SS 
YYYY-MM-DD HH:MM:SS

db2 load from delfile2 of del
    modified by timestampformat="yyyy.mm.dd hh:mm tt"
    insert into schedule

+ = 0xC 0xA 0xE 0xF
 - = 0xD 0xB

+ = 0xC 0xA 0xE 0xF 0x3
- = 0xD 0xB 0x7

modified by chardel""

modified by chardel''

db2 load ... modified by delprioritychar ...

"Smith, Joshua",4000,34.98<row delimiter>
"Vincent,<row delimiter>, is a manager", ...
... 4005,44.37<row delimiter>

db2 load from delfile3 of del
   modified by keepblanks
   insert into table1