LOAD コマンド

制約事項

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

範囲

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

許可

Db2 サーバー・プロセス (すべてのロード・プロセスを含む) は、インスタンス所有者が所有します。 これらのプロセスは、必要なファイルにアクセスするためにインスタンス所有者の ID を使用するため、インスタンス所有者には入力データ・ファイルに対する読み取り権限が必要です。 これらの入力データ・ファイルは、コマンドを実行するユーザーに関係なく、インスタンス所有者が読み取ることができなければなりません。

必要な接続

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

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

コマンド構文

Ignore and Map parameters

Redirect Input or Output parameters

Notes:

• ¹ These keywords can appear in any order.
• ² Each of these keywords can appear only one time.
• ³ For column-organized tables, the default is the STATISTICS USE PROFILE parameter.

コマンド・パラメーター

CLIENT

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

注:

1. dumpfile および lobsinfile 修飾子および XML FROM オプションは、CLIENT キーワードが指定されている場合でも、サーバー上のファイルを参照します。
2. リモート・ロード操作中にコード・ページ変換は行われません。 データのコード・ページがサーバーのコード・ページと異なる場合は、codepage 修飾子を使用してデータのコード・ページを指定します。
3. CLIENT キーワードは、リモート・ストレージ・オブジェクトとともに指定され、リモート・ホスト上で実行される場合、非推奨になっており、将来のリリースで廃止される予定です。 非推奨機能11.5.7を参照してください。 DB2_ENABLE_COS_SDK レジストリー変数が ON に設定されている場合、リモート・ストレージ別名を使用してリモート・ホスト上で実行される LOAD CLIENT は、既存の libcurl メソッドをサイレントに使用します (既知の制限に従います)。 DB2_ENABLE_COS_SDKを参照してください。

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

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

FROM filename | remotefilename | pipename | device | cursorname

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

remotefilename は、 IBM® Cloud Object Storage や Amazon Simple Storage Service (S3) などのリモート・ストレージ上にあり、ストレージ・アクセス別名を使用してアクセスされるファイルを参照します。 リモート・ストレージ・サーバーから転送されるファイルを一時的に保管するには、ローカル・ステージング・スペースが必要です。 リモート・ストレージ要件を参照してください。 リモート・ファイル名の構文は、次のとおりです。

DB2REMOTE://<alias>/<container>/<object>

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

c

警告メッセージを生成した装置の使用を続けます (例えば、新しいテープがマウントされた場合)。

d

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

t

すべてのデバイスを停止します。

注:

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

OF filetype

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

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

注:

• CURSOR ファイル・タイプを使用して XML データを分散データベース環境の表にロードする場合、PARTITION_ONLY モードと LOAD_ONLY モードはサポートされません。
• CURSOR ファイル・タイプを指定して LOAD コマンドを実行する場合は、以下の相違点に注意してください。
  • DECLARE CURSOR ステートメントの実行中に DATABASE キーワードが指定された場合、LOAD コマンドは、データを取り出すための別個のアプリケーションを内部的に作成します。
  • DECLARE CURSOR ステートメントの実行中に DATABASE キーワードを指定しないと、LOAD コマンドは同じアプリケーション内のデータを取り出します。
  この 2 つのケースの違いにより、 ロッキング動作にも違いが生じます。 特に、以下の条件が満たされると、ロック (データベース構成に応じて、ロック待機やロック・タイムアウトなど) が作成される場合があります。

  • 現在接続されているデータベースと同じデータベースに対して DATABASE キーワードを指定します。
  • 同じユーザー ID とパスワードを使用して、現行接続と同じデータベースに接続します。

  このロック問題の回避策は、DATABASE キーワードを省略することです。

LOBS FROM lob-path

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

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

DB2_LOAD_RESTRICTED_IO_PATH が有効になっている場合、 lob-path は制限されたパス内に存在している必要があります。

MODIFIED BY file-type-mod

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

METHOD

L

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

NULL INDICATORS null-indicator-list

このオプションは、METHOD L パラメーターが指定されている場合にのみ使用できます (入力ファイルが ASC ファイルであることを示します)。 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 load 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 列にロードされる列に含まれています。

DB2_LOAD_RESTRICTED_IO_PATH が有効になっている場合、 xml-path が制限されたパス内に存在している必要があります。

XMLPARSE

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

STRIP WHITESPACE

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

PRESERVE WHITESPACE

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

XMLVALIDATE

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

USING XDS

XML 文書は、メイン・データ・ファイル内の XML データ指定子 (XDS) によって識別される XML スキーマに照らして妥当性検査されます。 デフォルトでは、XMLVALIDATE オプションが USING XDS 節とともに使用される場合、妥当性検査に使用されるスキーマは XDS の SCH 属性によって決定されます。 XDS に SCH 属性が存在しない場合、DEFAULT 節によってデフォルト・スキーマが指定されていない限り、スキーマの妥当性検査は行われません。

DEFAULT、IGNORE、および MAP 節を使用することにより、スキーマ決定の動作を変更することができます。 これら 3 つの節はオプションであり、相互に適用されるのではなく XDS の指定に直接適用されます。 例えば、DEFAULT 節によって指定されているためにスキーマが選択された場合、IGNORE 節によっても指定されていても無視されません。 同様に、以下の条件が満たされている場合、スキーマは再マップされません。

• スキーマは、MAP 節でペアの最初の部分として指定されているため、選択されます。
• スキーマは、別の MAP 節のペアの 2 番目の部分でも指定されます。

USING SCHEMA schema-sqlid

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

USING SCHEMALOCATION HINTS

XML 文書は、ソース XML 文書内の XML スキーマ・ロケーション・ヒントによって識別されるスキーマに対して妥当性検査されます。 schemaLocation 属性が XML 文書に見つからない場合、妥当性検査は行われません。 USING SCHEMALOCATION HINTS 節が指定されている場合、XDS の SCH 属性はすべての XML 列で無視されます。

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

IGNORE schema-sqlid

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

• ロードされた XML 文書の XML データ指定子 (XDS) に SCH 属性が存在します。
• SCH 属性によって識別されるスキーマは、無視するスキーマのリストに含まれています。

注:

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

IGNORE 節は XDS にのみ適用されます。 MAP 節によってマップされるスキーマは、後で IGNORE 節によって指定されても無視されません。

DEFAULT schema-sqlid

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

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

MAP schema-sqlid

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

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

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

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

SAVECOUNT n

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

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

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

SAVECOUNT パラメーターは、 カラム・オーガナイズ 表ではサポートされません。

ROWCOUNT n

ロードするファイル内の物理レコードの数 n を指定します。 anyorder ファイル・タイプ修飾子が有効になっている場合、ファイルから任意の n 行をロードできます。 それ以外の場合は、最初の n 行がロードされます。

注: anyorder ファイル・タイプ修飾子は、特定の表タイプに対してデフォルトで有効になっています。 詳しくは、 anyorderを参照してください。

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 データがある場合は、この数量が大幅に増加する可能性があります。
• サーバー上で、以下の条件が満たされている場合は、入力データの未加工サイズに相当するストレージ・スペース。
  • カラム・コンプレッション・ディクショナリーが作成されます。
  • パイプやソケットなどのデータ・ソースを再オープンすることはできません。

DB2_LOAD_RESTRICTED_IO_PATH が有効になっている場合、 temp-pathname が制限されたパス内に存在している必要があります。

INSERT

既存の表データを変更することなく、ロードされたデータを表に追加します。

カラム・オーガナイズ 表に対する LOAD INSERT 操作では、表が新規であるか、切り捨てられており、ロード操作の開始時に空であった場合に、デフォルトで表統計が更新されます。

REPLACE

表からデータをすべて削除し、新しいデータを挿入します。 表定義および索引定義は変更されません。 階層間でデータを移動するときにこのパラメーターを指定した場合、個々の副表ではなく、階層全体のデータのみを置き換えることができます。

このパラメーターを使用してシステム期間テンポラル表にデータをロードすることはできません。

カラム・オーガナイズ 表への LOAD REPLACE 操作は、デフォルトで表統計を更新します。

KEEPDICTIONARY

LOAD REPLACE 操作の後も、既存のコンプレッション・ディクショナリーを保持します。

このオプションは、 行オーガナイズ 表のデフォルトです。

表 COMPRESS 属性が YES の場合、新しく置き換えられたデータは、ロードの呼び出し前に存在していたディクショナリーを使用して圧縮されます。 以下の条件が満たされている場合は、表に置換されるデータを使用して新しいディクショナリーが作成されます。

• ディクショナリーが以前に表に存在しませんでした。
• 表 の COMPRESS 属性が YES です。

この場合のコンプレッション・ディクショナリーを作成するために必要なデータ量は、ADC のポリシーの影響を受けます。 このデータは、圧縮解除されたデータとして表に取り込まれます。 ディクショナリーが表に挿入された後、ロードされる残りのデータは、このディクショナリーを使用して圧縮されます。 要約については、次の表を参照してください。

表 1. LOAD REPLACE KEEPDICTIONARY キーワード。

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

注:

1. コンプレッション・ディクショナリーは、以下のいずれかの条件が満たされている場合にのみ、表の XML ストレージ・オブジェクトに対して作成できます。
   • XML 列は、 Db2 バージョン 9.7 以降の表に追加されます。
   • 表は、オンライン表移動を使用してマイグレーションされます。
2. LOAD REPLACE KEEPDICTIONARY 操作が中断された場合、ロード・ユーティリティーは、 LOAD RESTART または LOAD TERMINATE のいずれかが発行された後でリカバリーすることができます。 中断された LOAD REPLACE KEEPDICTIONARY 操作からリカバリーした後、既存の XML ストレージ・オブジェクト・ディクショナリーを保持することはできません。 LOAD RESTART を使用すると、新しい XML ストレージ・オブジェクト・ディクショナリーが作成されます。

RESETDICTIONARY

このディレクティブは、表 COMPRESS 属性が YES の場合に、表データ・オブジェクトの新しいディクショナリーを作成するように LOAD REPLACE 処理に指示します。

COMPRESS 属性が NO であり、ディクショナリーが既に表に存在していた場合、そのディクショナリーは除去され、新しいディクショナリーは表に挿入されません。

このオプションは、 カラム・オーガナイズ 表のデフォルトです。

カラム・オーガナイズ表の場合は、データベース・パーティションのサブセットに LOAD REPLACE … RESETDICTIONARY を指定することはできません (SQL27906N)。 OUTPUT_DBPARTNUMS オプションを含める場合は、すべてのデータベース・パーティションを指定する必要があります。

コンプレッション・ディクショナリーは 1 つのユーザー・レコードのみを使用して作成できます。 ロードされたデータ・セット・サイズがゼロで、ディクショナリーが存在する場合、既存のディクショナリーは保持されません。 このディレクティブを使用してディクショナリーを作成するために必要なデータ量は、ADC のポリシーの影響を受けません。 要約については、次の表を参照してください。

表 2. LOAD REPLACE RESETDICTIONARY キーワード。

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

注:

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

RESETDICTIONARYONLY

このオプションを指定すると、行をロードすることなく、入力ファイルに基づいてカラム・コンプレッション・ディクショナリーが作成されます。 このオプションを使用すれば、SQL ベースのユーティリティーを使ってデータの取り込み (INGEST) を行う前に、コンプレッション・ディクショナリーを作成できます。

このオプションは、 カラム・オーガナイズ 表にのみ適用されます。

データベース・パーティションのサブセットに LOAD REPLACE … RESETDICTIONARYONLY を指定することはできません (SQL27906N)。 OUTPUT_DBPARTNUMS オプションを含める場合は、すべてのデータベース・パーティションを指定する必要があります。

TERMINATE

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

LOAD TERMINATE オプションは、表スペースからバックアップ・ペンディング状態を削除しません。

RESTART

重要: LOAD コマンドの RESTART オプションは、 Db2 バージョン 11.5.8では非推奨になっており、将来のリリースまたはモディフィケーション・パックで廃止される予定です。 同等の動作を実現するには、 LOAD TERMINATE の後に LOAD を使用します。

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

RESTART パラメーターは、以下の表ではサポートされません。

• カラム・オーガナイズ表。
• 生成別ランダム方式を使用するランダム分散表。

ロード操作が失敗した後にこのタイプの表をリカバリーするには、TERMINATE パラメーターまたは REPLACE パラメーターを使用します。

INTO table-name

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

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

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

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

• 隠し列ファイル・タイプ修飾子の 1 つを使用します。入力ファイルに隠し列のデータが含まれている場合は 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

エラーが発生した行のコピー先となる例外表を指定します。 ユニーク索引または主キー索引に違反した行がコピーされます。 非修飾の表名を指定すると、その表名は現行のスキーマで修飾されます。 表を カラム・オーガナイズ 表にすることはできません。

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

以下の場合、XML データをロードするときに FOR EXCEPTION 節を使用してロード例外表を指定することはできません。

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

NORANGEEXC

範囲違反のために行がリジェクトされた場合、その行が例外表に挿入されないことを示します。

NOUNIQUEEXC

ユニーク制約に違反したために行がリジェクトされた場合、例外表に挿入されないことを示します。

STATISTICS USE PROFILE

この表で定義されているプロファイルに従ってロード中に統計を収集するようロード操作に指示します。 統計の収集は、 カラム・オーガナイズ 表のデフォルトの動作です。 LOAD コマンドを実行する前に、プロファイルを作成する必要があります。 そのプロファイルは、RUNSTATS コマンドで作成します。 行オーガナイズ 表では、プロファイルが存在せず、このパラメーターが指定されている場合、警告が返され、統計は収集されません。 カラム・オーガナイズ 表では、プロファイルが存在せず、このパラメーターが指定されている場合、ロード・ユーティリティーは、自動 RUNSTATS 操作中に使用されるものと同じデフォルトの RUNSTATS コマンド・オプションを使用します。

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

STATISTICS NO

統計データを収集せず、したがってカタログ内の統計データも変更しないことを指定します。 このパラメーターは、 行オーガナイズ 表のデフォルトです。

COPY NO

順方向リカバリーが使用可能な場合に、表が存在する表スペースをバックアップ・ペンディング状態にすることを指定します。 順方向リカバリーは、logarchmeth1 または logarchmeth2 構成パラメーターが OFF 以外の値に設定されています。 また、COPY NO オプションは、表スペースの状態を「ロード進行中」表スペースの状態にします。 この状態は一時的なものであり、ロードが完了するか失敗すると消えます。 表スペースのバックアップまたはデータベースのフルバックアップを実行しない限り、 表スペースのどの表のデータも更新または削除できません。 ただし、SELECT ステートメントを使用すれば、 どの表のデータにもアクセス可能です。

リカバリー可能データベースで COPY NO を指定すると、表スペースはバックアップ・ペンディング状態のままになります。 例えば、 COPY NO および INDEXING MODE DEFERREDを指定して LOAD を実行する場合は、索引をリフレッシュする必要があります。 表に対する特定の照会では索引スキャンが必要な場合がありますが、索引がリフレッシュされるまでは失敗します。 索引は、バックアップ・ペンディング状態の表スペースに存在する場合はリフレッシュできません。 その場合、バックアップが取られるまで表へのアクセスは許可されません。 索引リフレッシュは、索引が照会によってアクセスされたときに、 データベースによって自動的に行われます。

COPY NO は、以下の条件が満たされる場合のデフォルト・オプションです。

• COPY NO、COPY YES、または NONRECOVERABLE が指定されていません。
• データベースがリカバリー可能です。これは、logarchmeth1 または logarchmeth2 構成パラメーターが OFF 以外の値に設定されています。

COPY YES

ロードするデータのコピーを保存します。 このパラメーターは、順方向リカバリーがオフになっている場合は無効です。

USE TSM

IBM Tivoli® Storage Managerを使用してコピーを保管することを指定します。

OPEN num-sess SESSIONS

IBM Tivoli Storage Manager またはベンダー製品で使用される入出力セッションの数。 デフォルト値は 1です。

TO device/directory

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

このディレクトリーは、IBM® Cloud Object Storage や Amazon Simple Storage Service (S3) などのリモート・ストレージ上にあり、ストレージ・アクセス別名を使用してアクセスできます。 DB2_ENABLE_COS_SDK が OFF に設定されている場合、リモート・ストレージ・サーバーに転送されるコピー・イメージを一時的に保管するためにローカル・ステージング・スペースが必要です。 リモート・ストレージの最大コピー・イメージ・サイズは 5 GB です。 詳しくは、 リモート・ストレージ要件を参照してください。 DB2_ENABLE_COS_SDK が ON に設定されている場合、ローカル・ステージング・スペースは必要ありません。 最大コピー・イメージ・サイズは、MULTIPARTSIZEMB サイズに、Cloud Object Storage プロバイダーによって許可されるパートの最大数を乗算して決定されます。

DB2_LOAD_RESTRICTED_IO_PATH が有効になっている場合、コピー・イメージ・パスは制限されたパス内に存在している必要があります。

MULTIPARTSIZEMB

DB2_ENABLE_COS_SDK レジストリー変数が ON に設定されている場合、 Db2 リモート・ストレージ と Cloud Object Storage との通信は、組み込みベンダーの Cloud Object Storage SDK を介して促進されます。 リモート・ストレージ通信により、 Db2 はオブジェクトまたはファイルを複数パーツで Cloud Object Storage にストリーミングできます。 このタイプのストリーミングは、マルチパート・アップロードと呼ばれます。 このキーワードは、コピー・イメージのパート・サイズをメガバイト (MB) 単位で指定し、MULTIPARTSIZEMB データベース・マネージャー構成パラメーターで指定された値をオーバーライドします。 このオプションは、 バージョン 11.5.7以降、 Linux® (x86) 環境でのみ使用できます。

LOAD lib-name

使用するベンダー・バックアップおよびリストア入出力関数が入っている共有ライブラリー (Windows オペレーティング・システム上の DLL) の名前。 絶対パスで指定することができます。 絶対パスが指定されていない場合、デフォルト・パスはユーザー出口プログラムの場所です。

NONRECOVERABLE

ロード・トランザクションにリカバリー不能のマークを付け、後続のロールフォワード・アクションによってリカバリーできないことを指定します。 ロールフォワード・ユーティリティーはトランザクションをスキップし、データがロードされていた表に無効のマークを付けます。 また、このユーティリティーは、その表に対する後続のトランザクションもすべて無視します。 ロールフォワード操作が完了した後、そのような表に対してサポートされる操作は、以下の操作のみです。

• 表をドロップします。
• リカバリー不能ロード操作の完了後にコミット・ポイントの後に取られたバックアップ (フルまたは表スペース) から表をリストアしました。

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

WITHOUT PROMPTING

ロードされるすべてのファイルがデータ・ファイルのリストに含まれていること、およびリストされているデバイスまたはディレクトリーがロード操作全体に対して十分であることを指定します。 継続入力ファイルが見つからない場合、またはロード操作が終了する前にコピー・ターゲットが満杯になった場合、ロード操作は失敗し、表は ロード保留 状態のままになります。

このオプションを指定しないと、以下のシナリオで新規テープの入力を求めるプロンプトが出されます。

• テープ装置がコピー・イメージのテープの終わりを検出した。
• リストされる最後の項目は磁気テープ装置です。

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

表オブジェクトの作成時に、ロード・ユーティリティーがレコードの構文解析、変換、およびフォーマット設定のために作成するプロセスまたはスレッドの数を指定します。 このパラメーターは、データベース・パーティションごとに実行されるプロセスの数を使用するように設計されています。 このパラメーターは、ソース・データのレコード順序が保持されるため、事前ソートされたデータをロードする場合に役立ちます。 このパラメーターの値がゼロであるか、または指定されなかった場合、ロード・ユーティリティーは実行時にインテリジェント・デフォルト値 (通常は使用可能な 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 データベース構成パラメーターをオフにすると、各ページの割り振りと初期化のみがインデックス・マネージャーによってログに記録されます。 ロギングの量は、各ページの空でない部分ではなく、1 ページ当たり約 250 バイトです。

INCREMENTAL

索引を新しいデータで拡張します。 この方法では、索引のフリー・スペースを使用します。 挿入されたレコードの索引キーを追加するために必要なのは、十分なソート・スペースだけです。 このメソッドは、索引オブジェクトが有効で、ロード操作の開始時にアクセス可能な場合にのみサポートされます。 逆に、DEFERRED モードが指定されたロード操作の直後は無効です。 このモードを指定したものの、索引の状態などの理由でサポートされない場合は、 警告が戻され、REBUILD モードでロード操作が続行されます。 同様に、ロード作成フェーズでロード再開操作を開始した場合も、 INCREMENTAL モードはサポートされません。

LogIndexBuild データベース構成パラメーターがオンになっている場合、 Db2 は、索引へのすべてのキーの挿入、および分割されたすべてのページのログ・レコードを生成します。 LogIndexBuild データベース構成パラメーターは、通常、HADR が使用されていない場合はオフになります。 このデータベース構成パラメーターがオフになっている場合、索引マネージャーによってログに記録される索引付けの量は、ALLOW READ ACCESS オプションが指定されているかどうかによって異なります。 ALLOW READ ACCESS オプションが指定されている場合、ページ分割に関するログを含んだログ・レコードが生成されます。 ALLOW READ ACCESS オプションが指定されていない場合、索引マネージャーからのログ・レコードは生成されません。

DEFERRED

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

据え置き索引付けは、非ユニーク索引を持つ表に対してのみサポートされるため、ロード・フェーズ中に挿入される重複キーは、ロード操作後は永続的ではありません。

ALLOW NO ACCESS

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

表に制約がある場合、表の状態はセット整合性保留中およびロード進行中に設定されます。 表の SET INTEGRITY ペンディング状態を解除するには、SET INTEGRITY ステートメントを使用する必要があります。

ALLOW READ ACCESS

ロード操作は、ターゲット表を共有モードでロックします。 表の状態は、ロード進行中と読み取りアクセスの両方に設定されます。 表のロード中、データの非デルタ部分にアクセスすることができます。 つまり、ロードの開始前に存在していたデータは、読み取りプログラムによって表にアクセスできます。 ロード中のデータは、ロードが完了するまで使用できません。

重要: LOAD コマンドの ALLOW READ ACCESS パラメーターは推奨されておらず、将来のリリースで除去される可能性があります。 LOAD コマンドの ALLOW READ ACCESS パラメーターが廃止される前に、 INGEST ユーティリティー の使用を開始します。 さらに、INGEST ユーティリティーをコマンド・スクリプトで使用することができます。

ALLOW READ ACCESS パラメーターは、 カラム・オーガナイズ 表ではサポートされません。

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

表に制約がある場合、表の状態はセット整合性保留中、ロード進行中、および読み取りアクセスに設定されます。 ロードの終了時に、表の状態ロード進行中は除去されますが、表にはセット整合性保留中および読み取りアクセスの状態が残ります。 表の SET INTEGRITY PENDING を解除するには、SET INTEGRITY ステートメントを使用する必要があります。 表がセット整合性保留中および読み取りアクセスの状態にある間、データの非デルタ部分は引き続きリーダーにアクセス可能です。 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

このオプションが YES に設定されている場合、ロード・ユーティリティーは、以下のいずれかのシナリオでリモート・データ・ソースからのフェッチを並列化しようとします。

• DATABASE キーワードを使用してカーソルが宣言されているカーソルからロードを実行する場合。
• API sqlu_remotefetch_entry メディア・エントリーを使用する場合。

データのフェッチを並列化できるのは、カーソルの select-statement が単純形式 "SELECT * FROM <tablename>"の場合のみです。 NOに設定すると、並列フェッチは行われません。 デフォルト値は YES です。 詳しくは、CURSOR ファイル・タイプを使用したデータの移動を参照してください。

SET INTEGRITY PENDING CASCADE

LOAD が表を SET INTEGRITY ペンディング状態にする場合は、 SET INTEGRITY PENDING CASCADE を使用して、ロードされた表の SET INTEGRITY ペンディング状態を即時にすべての下位表にカスケードするかどうかを指定します。 下層表には、下層外部キー表、下層即時マテリアライズ照会表、および下層即時ステージング表が含まれます。

IMMEDIATE

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

ロードされた表の制約違反が後で検査されると、セット整合性保留中読み取りアクセスの状態になった下層外部キー表は、セット整合性保留中アクセスなし状態になります。 ロードされた表は、SET INTEGRITY ステートメントの IMMEDIATE CHECKED オプションを使用して制約違反がないか検査されます。

DEFERRED

ロードされた表のみがセット整合性保留中の状態になることを示します。 下層外部キー表、下層即時マテリアライズ照会表、および下層即時ステージング表の状態は変更されません。

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

SET INTEGRITY PENDING CASCADE オプションが指定されていない場合、ロードされた表のみがセット整合性保留中の状態になります。 下層外部キー表、下層即時マテリアライズ照会表、および下層即時ステージング表の状態は変更されません。 これらの表は、ロードされた表に制約違反があるかどうかを検査するときに、後で暗黙的にセット整合性保留中の状態にすることができます。

LOAD がターゲット表を SET INTEGRITY ペンディング状態にしない場合、 SET INTEGRITY PENDING CASCADE オプションは無視されます。

LOCK WITH FORCE

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

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

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

SOURCEUSEREXIT executable

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

SOURCEUSEREXIT パラメーターは、 カラム・オーガナイズ 表ではサポートされません。

DB2_LOAD_RESTRICTED_IO_ALLOW_SOURCEUSEREXIT が YES に設定され、 DB2_LOAD_RESTRICTED_IO_PATH が有効になっている場合は、SOURCEUSERXIT を使用できません。

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-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 Pending) 状態を解除するには、SET INTEGRITY ステートメントを発行してください。 ロード操作は、複製されたマテリアライズ照会表では実行できません。
• クラスタリング索引が表に存在する場合は、ロードの前にクラスタリング索引のデータをソートします。 ただし、マルチディメンション・クラスタリング (MDC) 表にロードする前にデータをソートする必要はありません。
• 保護された表にデータをロードするときに例外表を指定すると、無効なセキュリティー・ラベルによって保護されているすべての行がその表に送信されます。 この操作により、例外表にアクセスできるユーザーが、それ以外の方法ではアクセスが許可されていないデータにアクセスできるようになる可能性があります。 セキュリティーを向上させるには、以下のガイドラインに従ってください。
  • 例外表へのアクセス権限を誰に付与するかに注意してください。
  • 各行は、修復され、ロードする表にコピーされたらすぐに削除してください。
  • 例外表の処理が完了したら、すぐにその表をドロップします。
• 内部形式のセキュリティー・ラベルには、改行文字が含まれている可能性があります。 DEL ファイル・フォーマットを使用してファイルをロードすると、これらの改行文字が区切り文字と間違われる可能性があります。 この問題が発生した場合は、 LOAD コマンドで delprioritychar ファイル・タイプ修飾子を指定して、古いデフォルトの区切り文字の優先順位を使用してください。
• DECLARE CURSOR ステートメントで DATABASE キーワードを指定した CURSOR ファイル・タイプを使用して LOAD を実行する場合は、以下の認証に同じ資格情報が使用されます。
  • ロード操作のために現在接続されているデータベースに対する認証に使用されたユーザー ID とパスワード。
  • DECLARE CURSOR ステートメントの DATABASE オプションで指定された、ソース・データベースに対する認証に使用されたユーザー ID とパスワード。

  ユーザー 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 コマンド・オプションに対しては機能しません。
• COPY YES オプションを指定して LOAD ユーティリティーを使用し、表に LOB 列が含まれている場合、LOB 列が NOT COMPACT で定義されていても、LOAD は常に COMPACT 動作を強制します。

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.

modified by maxanalyzesize=1G
modified by maxanalyzesize=100M

"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 - Year (four digits ranging from 0000 - 9999)
M    - Month (one or two digits ranging from 1 - 12)
MM   - Month (two digits ranging from 01 - 12;
         mutually exclusive with M)
D    - Day (one or two digits ranging from 1 - 31)
DD   - Day (two digits ranging from 01 - 31;
         mutually exclusive with D)
DDD  - Day of the year (three digits ranging
         from 001 - 366; mutually exclusive
         with other day or month elements)

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

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

H     - Hour (one or two digits ranging from 0 - 12
           for a 12 hour system, and 0 - 24
           for a 24 hour system)
HH    - Hour (two digits ranging from 00 - 12
           for a 12 hour system, and 00 - 24
           for a 24 hour system; mutually exclusive
             with H)
M     - Minute (one or two digits ranging
           from 0 - 59)
MM    - Minute (two digits ranging from 00 - 59;
           mutually exclusive with M)
S     - Second (one or two digits ranging
           from 0 - 59)
SS    - Second (two digits ranging from 00 - 59;
           mutually exclusive with S)
SSSSS - Second of the day after midnight (5 digits
           ranging from 00000 - 86400; mutually
           exclusive with other time elements)
TT    - Meridian indicator (AM or PM)

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

YYYY   - Year (four digits ranging from 0000 - 9999)
M      - Month (one or two digits ranging from 1 - 12)
MM     - Month (two digits ranging from 01 - 12;
            mutually exclusive with M and MMM)
MMM    - Month (three-letter case-insensitive abbreviation for 
            the month name; mutually exclusive with M and MM)              
D      - Day (one or two digits ranging from 1 - 31)
DD     - Day (two digits ranging from 01 - 31; mutually exclusive with D)
DDD    - Day of the year (three digits ranging from 001 - 366; 
            mutually exclusive with other day or month elements)
H      - Hour (one or two digits ranging from 0 - 12
            for a 12 hour system, and 0 - 24 for a 24 hour system)
HH     - Hour (two digits ranging from 00 - 12 
            for a 12 hour system, and 00 - 24 for a 24 hour system; 
            mutually exclusive with H)
M      - Minute (one or two digits ranging from 0 - 59)
MM     - Minute (two digits ranging from 00 - 59;
            mutually exclusive with M, minute)
S      - Second (one or two digits ranging from 0 - 59)
SS     - Second (two digits ranging from 00 - 59;
            mutually exclusive with S)
SSSSS  - Second of the day after midnight (5 digits
            ranging from 00000 - 86400; mutually
            exclusive with other time elements)
U (1 to 12 times)
         - Fractional seconds(number of occurrences of U represent the 
              number of digits with each digit ranging from 0 to 9

TT     - Meridian indicator (AM or 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

注

1. 日付形式ストリングは必ず二重引用符で囲まなければなりません。 フィールド区切り文字には、 a から z、A から Z、および 0 から 9 の文字を使用することはできません。 フィールド区切り文字は、DEL ファイル・フォーマットの文字区切り文字またはフィールド区切り文字と同じであってはなりません。 エレメントの開始および終了位置が明らかな場合、 フィールド区切り文字は任意指定です。 あいまいさが生じうるのは、 項目の長さが一定でない D、H、M、または S などのエレメントが使用されている場合です (修飾の仕方によって異なります)。
   タイム・スタンプ形式の場合は、月記述子と分記述子の間にあいまいさが生じないように注意する必要があります。どちらも文字 M を使用するためです。 月フィールドは他の日付フィールドの隣になければなりません。 分のフィールドは、他の時刻フィールドの横にある必要があります。 あいまいなタイム・スタンプ形式をいくつか以下に示します。

   "M" (could be a month, or a minute)
   "M:M" (Which is which?)
   "M:YYYY:M" (Both are interpreted as month.)
   "S:M:YYYY" (adjacent to both a time value and a date value)

   あいまいな場合、ユーティリティーはエラー・メッセージを報告し、操作は失敗します。
   明確なタイム・スタンプ形式をいくつか以下に示します。

   "M:YYYY" (Month)
   "S:M" (Minute)
   "M:YYYY:S:M" (Month....Minute)
   "M:H:YYYY:M:D" (Minute....Month)

   二重引用符や円記号などの文字の前には、エスケープ文字 (例えば、¥) を付けなければなりません。

2. chardel、coldel、または decpt ファイル・タイプ修飾子に提供される文字値は、ソース・データのコード・ページで指定する必要があります。
   文字コード・ポイント (文字記号の代わり) は、構文 xJJ または 0xJJ を使用して指定できます。ここで、JJ はコード・ポイントの 16 進表記です。 例えば、# 文字を列区切り文字として指定するには、以下のいずれかのステートメントを使用します。

   ... modified by coldel# ...
   ... modified by coldel0x23 ...
   ... modified by coldelX23 ...

3. データ移動のための区切り文字の制約事項に、区切り文字の指定変更として使用できる文字に適用される制限のリストが示されています。
4. サポートされていないファイル・タイプを MODIFIED BY オプションで使用しようとしても、 ロード・ユーティリティーは警告を出しません。 MODIFIED BY オプションでサポートされないファイル・タイプを使用しようとすると、ロード操作は失敗し、エラー・コードが戻されます。
5. ignore、include、missing、override が接尾部に付された複数の修飾子が指定されると、それらの修飾子はリストされた順に適用されます。 以下のステートメントの場合、入力データに ID 列ではない暗黙的な非表示列のデータが含まれます。 一方、暗黙的に非表示かどうかに関係なく、ID 列のデータは含まれません。

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

   しかし、以下のステートメントにおいてファイル・タイプ修飾子の順序を変更すると、入力データにすべての暗黙的な非表示列のデータ (非表示の ID 列も含む) が含まれることになります。 一方、暗黙的に非表示でない ID 列のデータは含まれません。

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