IMPORT コマンド

許可

• INSERT オプションを指定した IMPORT コマンドには、以下のいずれかの権限が必要です。
  • DATAACCESS 権限
  • 関係するそれぞれの表またはビューのスキーマに対する DATAACCESS 権限
  • 関係するそれぞれの表またはビューのスキーマに対する INSERTIN および SELECTIN 特権
  • 関係するそれぞれの表、ビュー、またはニックネームに対する CONTROL 特権
  • 関係するそれぞれの表またはビューに対する INSERT および SELECT 特権
• INSERT_UPDATE オプションを指定して既存の表に対して IMPORT コマンドを実行するには、以下のいずれかの権限が必要です。
  • DATAACCESS 権限
  • 関係するそれぞれの表またはビューのスキーマに対する DATAACCESS 権限
  • 関係するそれぞれの表またはビューのスキーマに対する INSERTIN、SELECTIN、UPDATEIN、および DELETEIN 特権
  • 関係するそれぞれの表、ビュー、またはニックネームに対する CONTROL 特権
  • 関与するそれぞれの表またはビューに対する INSERT、SELECT、UPDATE、および DELETE 特権
• REPLACE または REPLACE_CREATE オプションを使用する既存の表に対して IMPORT コマンドを実行するには、以下のいずれかの権限が必要です。
  • DATAACCESS 権限
  • 関係するそれぞれの表またはビューのスキーマに対する DATAACCESS 権限
  • 関係するそれぞれの表またはビューのスキーマに対する INSERTIN、SELECTIN、および DELETEIN 特権
  • 表またはビューに対する CONTROL 特権
  • 表またはビューに対する INSERT、SELECT、および DELETE 特権
• CREATE オプションまたは REPLACE_CREATE オプションを使用する新しい表に対する IMPORT コマンドには、以下のいずれかの権限が必要です。
  • DBADM 権限
  • データベースに対する CREATETAB 権限と表スペースに対する USE 特権、および以下のいずれか。
    • データベースに対する IMPLICIT_SCHEMA 権限 (表の暗黙的または 明示的スキーマ名が存在しない場合)
    • 表のスキーマ名が既存のスキーマを指している場合は、スキーマに対する CREATEIN 特権 または SCHEMAADM 権限 。
• CREATEまたは REPLACE_CREATE オプションを使用する、存在しない階層に対する IMPORT コマンドには、以下のいずれかの権限が必要です。
  • DBADM 権限
  • データベースに対する CREATETAB 権限および表スペースに対する USE 特権と、 以下のいずれかが必要です。
    • 表のスキーマ名が存在しない場合は、データベースに対する IMPLICIT_SCHEMA 権限。
    • スキーマに対する CREATEIN 特権 または SCHEMAADM 権限 (表のスキーマが存在する場合)
    • 階層全体に対する REPLACE_CREATE オプションが使用されている場合は、階層内のすべての副表に対する CONTROL 特権。
• REPLACE オプションを使用する既存の階層に対して IMPORT コマンドを実行するには、以下のいずれかの権限が必要です。
  • DATAACCESS 権限
  • 階層内のすべての副表のスキーマに対する DATAACCESS 権限
  • 階層内のすべての副表に対する CONTROL 特権
• 列を保護する表にデータをインポートするには、セッション許可 ID に、表内のすべての保護された列への書き込みアクセスを許可する LBAC 資格情報がなければなりません。 それ以外の場合、インポートは失敗し、エラー (SQLSTATE 42512) が戻されます。
• 行を保護する表にデータをインポートするには、以下の基準を満たす LBAC 資格情報をセッション許可 ID が保持している必要があります。
  • これは、表を保護するセキュリティー・ポリシーの一部です。
  • これは、書き込みアクセスのためにセッション許可 ID に付与されました。
  挿入する行のラベル、ユーザーの LBAC 信用証明情報、セキュリティー・ポリシー定義、および LBAC 規則が行のラベルを決定します。
• 保護されている行を持つ表に対して、REPLACE または REPLACE_CREATE オプションを指定した場合は、表をドロップするための権限がセッション許可 ID になければなりません。
• ニックネームにデータをインポートするには、セッション許可 ID には指定したデータ・ソースにパススルー・モードでアクセスおよび使用する特権がなければなりません。
• 表が行アクセス制御を活動化する場合、その表の IMPORT REPLACE は表をドロップする機能を必要とします。 具体的には、表に対する CONTROL 権限、SCHEMAADM 権限、または DBADM 権限 のいずれかが必要です。

必要な接続

データベース。 暗黙的な接続が可能である場合には、 デフォルトのデータベースへの接続が確立されます。 Linux、UNIX、または Windows クライアントから Linux®、UNIX、または Windows データベース・サーバーへのユーティリティー・アクセスは、 Db2 Connect ゲートウェイまたはループバック環境経由ではなく、エンジン経由の直接接続でなければなりません。

コマンド構文

Ignore and Map parameters

hierarchy description

sub-table-list

traversal-order-list

tblspace-specs

コマンド・パラメーター

FROM filename

インポートするデータの入ったファイルを指定します。 パスを省略すると、現行作業ディレクトリーが使用されます。

OF ファイル・タイプ

入力ファイル内のデータのフォーマットを指定します。

• ASC (区切りなし ASCII フォーマット)
• DEL (区切り ASCII 形式)。さまざまな データベース・マネージャー およびファイル・マネージャー・プログラムによって使用されます。
• IXF (統合交換フォーマット、PC バージョン) は、 Db2®専用に使用されるバイナリー・フォーマットです。

LOBS FROM lob-path

LOB ファイルを保管する 1 つ以上のパスを指定します。 LOB データ・ファイルの名前は、メイン・データ・ファイル (ASC、DEL、または IXF) の LOB 列にロードされる列に保管されます。 指定できるパスの最大数は 999 です。 このパラメーターは、LOBSINFILE の動作を暗黙的にアクティブ化します。

ニックネームにインポートするときには、このパラメーターは無効です。

XML FROM xml-path

XML ファイルが含まれているパスを 1 つ以上指定します。

MODIFIED BY filetype-mod

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

METHOD

L

データのインポートを開始する列および終了する列の番号を指定します。 列の番号は、データの行の先頭からのバイト単位のオフセットです。 この番号は 1 から始まります。

注: この方法は ASC ファイルでのみ使用でき、そのファイル・タイプに有効な唯一のオプションです。

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 ファイルでのみ使用できます。

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 の場合のみです。また、DEL ファイル・タイプに対しては、これが唯一有効な方式です。

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

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

NULL INDICATORS null-indicator-list

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

NULL 標識列中の Y の値は、その列データが NULL であることを指定します。 NULL 標識列の Y 以外の文字は、列データが NULL ではないこと、および METHOD L オプションで指定された列データがインポートされることを指定します。

NULL 標識文字は、 nullindchar ファイル・タイプ修飾子を指定した MODIFIED BY オプションを使用して変更できます。

XMLPARSE

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

STRIP WHITESPACE

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

PRESERVE WHITESPACE

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

XMLVALIDATE

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

USING XDS

XML 文書は、メイン・データ・ファイル内の XML データ指定子 (XDS) によって識別される 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 データ指定子 (XDS) の SCH 属性は、すべての XML 列で無視されます。

USING SCHEMALOCATION HINTS

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

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

DEFAULT schema-sqlid

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

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

IGNORE schema-sqlid

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

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

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

MAP schema-sqlid

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

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

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

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

ALLOW NO ACCESS

オフライン・モードでインポートを実行します。 行の挿入の前には常に、ターゲット表に排他 (X) ロックがかけられます。 このパラメーターは、同時アプリケーションが表データにアクセスできないようにします。 これがデフォルトのインポート動作です。

ALLOW WRITE ACCESS

オンライン・モードでインポートを実行します。 最初の行の挿入時には、ターゲット表に意図的排他 (IX) ロックがかけられます。 このパラメーターによって、並行読み取りプログラムおよび書き出しプログラムはテーブル・データにアクセスすることができます。 オンライン・モードには、REPLACE、CREATE、または REPLACE_CREATE インポート・オプションとの互換性はありません。 オンライン・モードは、バッファー化挿入ではサポートされません。 インポート操作では、表ロックへのロック・エスカレーションを回避し、アクティブ・ログ・スペースの不足を回避するために、挿入されたデータを定期的にコミットします。 これらのコミットは、COMMITCOUNT オプションが使用されなかった場合でも実行されます。 各コミットごとに、インポートでは IX 表ロックが外されるので、 コミットの完了後に再びロックの設定が試みられます。 ニックネームにインポートするときにはこのパラメーターが必要で、有効な数値を使って COMMITCOUNT を指定する必要があります (AUTOMATIC は有効なオプションとは見なされません)。

COMMITCOUNT n | AUTOMATIC

n 個のレコードがインポートされるたびに COMMIT を実行します。 数 n を指定すると、 インポートでは n 個のレコードのインポートの後にそのつど COMMIT が実行されます。 コンパウンド挿入を使用した場合、ユーザー指定のコミット頻度 n は、 そのコンパウンド・カウント値に最も近い整数の倍数に切り上げられます。 AUTOMATIC を指定すると、コミットの必要時期はインポート操作で内部的に判別されます。 ユーティリティーは、以下の 2 つの理由のいずれかのためにコミットします。

• 活動ログ・スペースが使い尽くされないようにするため。
• 行レベルから表レベルへのロック・エスカレーションを回避するため。

ALLOW WRITE ACCESS オプションが指定されていて、COMMITCOUNT オプションが指定されていない場合、インポート・ユーティリティーは、COMMITCOUNT AUTOMATIC が指定されているかのようにコミットします。

アクティブ・ログ・スペースを使い尽くさないようにするインポート操作の機能は、 Db2 レジストリー変数 DB2_FORCE_APP_ON_MAX_LOGの影響を受けます。

• DB2_FORCE_APP_ON_MAX_LOG が FALSE に設定され、COMMITCOUNT AUTOMATIC コマンド・オプションが指定されている場合、インポート・ユーティリティーは、アクティブ・ログ・スペースの不足を自動的に回避できます。
• DB2_FORCE_APP_ON_MAX_LOG が FALSE に設定され、COMMITCOUNT n コマンド・オプションが指定されている場合、インポート・ユーティリティーは、レコードの挿入または更新中に SQL0964C (トランザクション・ログ・フル) を検出すると、ログ・フル状態の解決を試みます。 無条件コミットを実行してから、レコードの挿入または更新を再試行します。 このアクションが問題の解決に役立たない場合 (ログ・フルがデータベース上の他のアクティビティーに起因する場合)、IMPORT コマンドは予期したとおりに失敗しますが、コミットされる行数を COMMITCOUNT n 値の倍数にすることはできません。 インポート操作を再試行する際に既にコミットされた行を処理しないようにするには、 RESTARTCOUNT または SKIPCOUNT コマンド・パラメーターを使用します。
• DB2_FORCE_APP_ON_MAX_LOG が TRUE (デフォルト) に設定されている場合、レコードの挿入または更新中に SQL0964C が検出されると、インポート操作は失敗します。 これは、COMMITCOUNT AUTOMATIC と COMMITCOUNT n のどちらを指定したかに関係なく発生します。

  アプリケーションは強制的にデータベースから切断され、現在の作業単位はロールバックされます。 インポート操作を再試行する際に既にコミットされた行を処理しないようにするには、 RESTARTCOUNT または SKIPCOUNT コマンド・パラメーターを使用します。

RESTARTCOUNT n

n + 1 の位置のレコードからインポート操作を開始するよう指定します。 最初の n 個のレコードはスキップされます。 このオプションは、SKIPCOUNT と機能上同等です。 RESTARTCOUNT および SKIPCOUNT は相互排他的です。

SKIPCOUNT n

n + 1 の位置のレコードからインポート操作を開始するよう指定します。 最初の n 個のレコードはスキップされます。 このオプションは、RESTARTCOUNT と機能上同等です。 SKIPCOUNT および RESTARTCOUNT は相互排他的です。

ROWCOUNT n

インポート (挿入または更新) するファイル内の物理レコードの数 n を指定します。 SKIPCOUNT オプションまたは RESTARTCOUNT オプションによって決定されたレコードから開始して、ファイルから n 行のみをインポートすることができます。 SKIPCOUNT オプションまたは RESTARTCOUNT オプションを指定すると、最初の n 行がインポートされます。 SKIPCOUNT m または RESTARTCOUNT m を指定すると、 行 m+ 1 から m+n がインポートされます。 コンパウンド挿入を使用した場合、ユーザー指定の ROWCOUNT n は、そのコンパウンド・カウント値に最も近い整数の倍数に切り上げられます。

WARNINGCOUNT n

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

NOTIMEOUT

ロックを待機しているときにインポート・ユーティリティーがタイムアウトにならないことを指定します。 このオプションは、locktimeout データベース構成パラメーターよりも優先されます。 他のアプリケーションは影響を受けません。

MESSAGES message-file

インポート操作中に生じ得る警告およびエラー・メッセージの宛先を指定します。 ファイルが存在する場合、インポート・ユーティリティーは情報を追加します。 このファイルへの完全パスが指定されていない場合、 このユーティリティーは現行のディレクトリーおよびデフォルトのドライブを宛先として使用します。 message-file を省略すると、メッセージは標準出力に書き込まれます。

INSERT

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

INSERT_UPDATE

インポートしたデータ行をターゲット表に追加するか、または主キーが一致するものがあればターゲット表の既存行を更新します。

REPLACE

データ・オブジェクトを切り捨てることによって表内の既存のデータすべてを削除してから、 インポートしたデータを挿入します。 表定義および索引定義は変更されません。 表がない場合は、このオプションを使用できません。 階層間でデータを移動する際にこのオプションを使用する場合は、 階層全体に関係したデータだけが置き換えられます。副表は置き換えられません。

ニックネームにインポートするときには、このパラメーターは無効です。

このオプションは、CREATE TABLE ステートメントの NOT LOGGED INITIALLY (NLI) 節、または ALTER TABLE ステートメントの ACTIVE NOT LOGGED INITIALLY 節を受け入れません。

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

REPLACE オプションを指定したインポートが、NLI 節が呼び出される CREATE TABLE または ALTER TABLE ステートメントと同じトランザクション内で実行される場合、インポートは NLI 節を受け入れません。 すべての挿入がログに記録されます。

Workaround 1

DELETE ステートメントを使用して表の内容を削除してから、INSERT ステートメントを使用してインポートを呼び出します。

Workaround 2

表をドロップして再作成してから、INSERT ステートメントを使用してインポートを呼び出してください。

REPLACE_CREATE

注: REPLACE_CREATE パラメーターは非推奨になっており、将来のリリースで削除される可能性があります。 詳しくは、「IMPORT コマンド・オプション CREATE および REPLACE_CREATE は非推奨です」を参照してください。

表が既にある場合には、 データ・オブジェクトを切り捨てることによって表内の既存のデータすべてを削除し、 表定義や索引定義は変えることなく、インポートしたデータを挿入します。

表が存在しない場合は、データベースのコード・ページに表と索引の定義、および行の内容を作成します。 制約事項のリストについては、「インポートされた表の再作成」セクションを参照してください。

このオプションは、IXF ファイルの場合にのみ使用することができます。 階層間でデータを移動する際にこのオプションを使用する場合は、 階層全体に関係したデータだけが置き換えられます。副表は置き換えられません。

ニックネームにインポートするときには、このパラメーターは無効です。

INTO table-name

データのインポート先となるデータベース表を指定します。 この表として、システム表、作成済み一時表、宣言済み一時表、またはサマリー表は指定できません。

INSERT、INSERT_UPDATE、または REPLACE の別名を使用できます。ただし、以前のサーバーの場合、完全修飾または非修飾の表名を使用できる場合を除きます。 修飾された表名は、schema.tablename の形式になります。 schema は、テーブルの作成に使用したユーザー名です。

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

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

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

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

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

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

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

insert-column

データの挿入先となる表またはビュー内の列名を指定します。

ALL TABLES

階層専用の暗黙キーワード。 階層をインポートする場合、走査順序で指定されるすべての表をインポートすることがデフォルトです。

sub-table-list

INSERT オプションまたは INSERT_UPDATE オプションが指定された型付き表の場合、データのインポート先の副表を示すために副表名のリストが使用されます。

HIERARCHY

階層データをインポートするよう指定します。

STARTING sub-table-name

階層専用キーワード。 sub-table-name から始まるデフォルト順を要求します。 PC/IXF ファイルの場合、デフォルトの順序は、入力ファイルに保管されている順序です。 PC/IXF ファイル・フォーマットの場合、デフォルト順は有効な唯一の順序です。

traversal-order-list

INSERT、 INSERT_UPDATE、または REPLACE オプションが指定された型付き表の場合、階層内のインポートする副表のトラバーサル順序を示すために、副表名のリストが使用されます。

CREATE

注: CREATE パラメーターは非推奨になっており、将来のリリースで削除される可能性があります。 詳しくは、「IMPORT コマンド・オプション CREATE および REPLACE_CREATE は非推奨です」を参照してください。

データベースのコード・ページで表の定義と行の内容を作成します。 データが Db2 表、副表、または階層からエクスポートされた場合は、索引が作成されます。 このオプションが階層に作用し、データが Db2からエクスポートされた場合は、タイプ階層も作成されます。 このオプションは、IXF ファイルの場合にのみ使用することができます。

ニックネームにインポートするときには、このパラメーターは無効です。

注: データが MVS™ ホスト・データベースからエクスポートされ、ページ・サイズで計算される長さが 254 を超える LONGVAR フィールドが含まれている場合、行が長すぎるために CREATE が失敗する可能性があります。 制約事項のリストは、『インポート済みの表の再作成』 を参照してください。 この場合は、表を手動で作成し、 INSERT を指定して IMPORT を呼び出すことも、 LOAD コマンドを使用することもできます。

AS ROOT TABLE

1 つ以上の副表をスタンドアロン表階層として作成します。

UNDER sub-table-name

1 つ以上の副表を作成するための親表を指定します。

IN tablespace-name

表が作成される表スペースを識別します。 表スペースは存在している必要があり、REGULAR 表スペースまたは LARGE 表スペースでなければなりません。 他の表スペースを指定しない場合、すべての表パーツはこの表スペースに保管されます。 この節を指定しない場合、許可 ID によって作成される表スペースに表が作成されます。 何も検出されない場合、その表はデフォルト表スペースの USERSPACE1 に入れられます。 USERSPACE1 がドロップされると、表の作成は失敗します。

INDEX IN tablespace-name

表の索引が作成される表スペースを指定します。 このオプションは、IN 節で指定された 1 次表スペースが DMS 表スペースである場合にのみ許可されます。 指定した表スペースは存在している必要があり、 かつ REGULAR または LARGE DMS 表スペースでなければなりません。

注: 索引を含む表スペースの指定は、表の作成時にのみ行うことができます。

LONG IN tablespace-name

任意の長列 (LONG VARCHAR、LONG VARGRAPHIC、LOB データ・タイプ、またはこれらのいずれかをソース・タイプとして持つ特殊タイプ) の値が保管される表スペースを指定します。 このオプションは、IN 節で指定した PRIMARY 表スペースが DMS 表スペースである場合のみ使用できます。 指定した表スペースは存在している必要があり、LARGE DMS 表スペースでなければなりません。

例

例 1

   db2 import from myfile.ixf of ixf messages msg.txt insert into staff

SQL3150N  The H record in the PC/IXF file has product "DB2    01.00", date
"19970220", and time "140848".
 
SQL3153N  The T record in the PC/IXF file has name "myfile", 
qualifier "        ", and source "            ".
 
SQL3109N  The utility is beginning to load data from file "myfile".
 
SQL3110N  The utility has completed processing.  "58" rows were read 
from the input file.
 
SQL3221W  ...Begin COMMIT WORK. Input Record Count = "58".
 
SQL3222W  ...COMMIT of any database changes was successful.
 
SQL3149N  "58" rows were processed from the input file.  "58" rows were
successfully inserted into the table.  "0" rows were rejected.

例 2 (ID 列がある表へのインポート)

TABLE2 は TABLE1 と同じですが、C2 が GENERATED ALWAYS ID 列である点が異なります。

   "Liszt"
   "Hummel",,187.43, H
   "Grieg",100, 66.34, G
   "Satie",101, 818.23, I

   "Liszt", 74.49, A
   "Hummel", 0.01, H
   "Grieg", 66.34, G
   "Satie", 818.23, I

   db2 import from datafile1.del of del replace into table1

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

   db2 import from datafile2.del of del replace into table1 (c1, c3, c4)
   db2 import from datafile2.del of del modified by identitymissing
      replace into table1

ID 関連のファイル・タイプ修飾子を使用せずにDATAFILE1を TABLE2 にインポートすると、行 1 と 2 が挿入されますが、行 3 と 4 はリジェクトされます。これは、これらが独自の非 NULL 値を提供し、ID 列が GENERATED ALWAYS であるためです。

XMLVALIDATE 節の使用例

例 1 (XMLVALIDATE USING XDS)

XMLVALIDATE USING XDS
  IGNORE (S1.SCHEMA_A)
  MAP ((S1.SCHEMA_A, S2.SCHEMA_B))

例 2 (XMLVALIDATE USING XDS)

XMLVALIDATE USING XDS
  DEFAULT S8.SCHEMA_H
  IGNORE (S9.SCHEMA_I, S10.SCHEMA_J)
  MAP ((S1.SCHEMA_A, S2.SCHEMA_B), (S3.SCHEMA_C, S5.SCHEMA_E),
    (S6.SCHEMA_F, S3.SCHEMA_C), (S4.SCHEMA_D, S7.SCHEMA_G))

<XDS FIL='xmlfile.001.xml' />

<XDS FIL='xmlfile.002.xml' OFF='10' LEN='500' SCH='S10.SCHEMA_J' />

<XDS FIL='xmlfile.003.xml' SCH='S6.SCHEMA_F' />

<XDS FIL='xmlfile.004.xml' SCH='S11.SCHEMA_K' />

例 3 (XMLVALIDATE USING XDS)

XMLVALIDATE USING XDS
  DEFAULT S1.SCHEMA_A
  IGNORE (S1.SCHEMA_A)

<XDS FIL='xmlfile.001.xml' />

<XDS FIL='xmlfile.002.xml' SCH='S1.SCHEMA_A' />

例 4 (XMLVALIDATE USING XDS)

XMLVALIDATE USING XDS
  DEFAULT S1.SCHEMA_A
  MAP ((S1.SCHEMA_A, S2.SCHEMA_B), (S2.SCHEMA_B, S1.SCHEMA_A))

<XDS FIL='xmlfile.001.xml' />

<XDS FIL='xmlfile.002.xml' SCH='S1.SCHEMA_A' />

<XDS FIL='xmlfile.003.xml' SCH='S2.SCHEMA_B' />

例 5 (XMLVALIDATE USING SCHEMA)

XMLVALIDATE USING SCHEMA S2.SCHEMA_B

<XDS FIL='xmlfile.001.xml' />

<XDS FIL='xmlfile.002.xml' SCH='S1.SCHEMA_A' />

例 6 (XMLVALIDATE USING SCHEMALOCATION HINTS)

<XDS FIL='xmlfile.001.xml' />

<XDS FIL='xmlfile.002.xml' SCH='S1.SCHEMA_A' />

使用上の注意

インポート操作を開始する前に、すべての表操作が完了し、すべてのロックがペンディング解除になっていることを確認してください。 これは、WITH HOLD でオープンされたすべてのカーソルをクローズした後に COMMIT を発行するか、または ROLLBACK を発行することによって行うことができます。

このユーティリティーは、REPLACE または REPLACE_CREATE 操作時に以前の行が削除された後、自動 COMMIT を実行します。 したがって、システムに障害が発生したり、表オブジェクトが切り捨てられた後にアプリケーションが データベース・マネージャー に割り込んだりすると、古いデータはすべて失われます。 これらのオプションを使用する前に、 元のデータがもはや必要ないことを確認してください。

CREATE、REPLACE、または REPLACE_CREATE 操作時にログが満杯になると、 このユーティリティーは挿入されたレコードに対して自動 COMMIT を実行します。 システムに障害が起こるか、アプリケーションが自動 COMMIT の後に データベース・マネージャー に割り込むと、部分的なデータを持つ表がデータベースに残ります。 REPLACE または REPLACE_CREATE オプションを使用してインポート操作全体をやり直すか、または正常にインポートされる行の数に設定した RESTARTCOUNT パラメーターを指定して INSERT を使用してください。

インポート・ユーティリティーが COMMIT を実行するたびに、 2 つのメッセージがメッセージ・ファイルに書き込まれます。 一方は、コミットされるレコードの数を示し、もう一方は、 COMMIT の成功後に書き込まれます。 障害の後にインポート操作を再開するときには、 スキップするレコードの数 (最後の正常なコミットから判別される) を指定してください。

インポート・ユーティリティーは、互換性に問題のない入力データを受け入れます (例えば、文字データは埋め込みまたは切り捨てを使用してインポートでき、数値データは別の数値データ・タイプを使用してインポートできます) が、主要な非互換性の問題があるデータは受け入れられません。

外部キーの再作成中にエラーが発生する場合、 参照整合性を保守するためにデータを変更してください。

参照制約および外部キー定義は、PC/IXF ファイルから表を再作成する場合は保存されません。 (データが前にSELECT *でエクスポートされた場合、プライマリキー定義は、が保持されます。)

リモート・データベースへのインポートでは、サーバーに、 入力データ・ファイルのコピー、出力メッセージ・ファイル、 およびデータベースのサイズ拡大を見込んだ十分なディスク・スペースが必要とされます。

インポート操作がリモート・データベースに対して実行され、 出力メッセージ・ファイルが非常に長くなった (60 KB を超過) 場合、 クライアントのユーザーに戻されるメッセージ・ファイルで、インポート操作中にメッセージが欠落する可能性があります。 メッセージ情報の最初の 30 KB と最後の 30 KB は、常に保持されます。

PC/IXF ファイルのリモート・データベースへのインポートは、 PC/IXF ファイルがディスケットにあるときよりも、 ハード・ディスクにあるときの方がより速く行うことができます。

式ベースのキーで定義された索引を持つ表については、PC/IXF ファイル・フォーマットを指定した IMPORT CREATE オプションを使用することはできません。

データベース表または階層が存在していないと、ASC または DEL ファイル形式のデータをインポートできません。 ただし、表が存在していない場合でも、IMPORT CREATE または IMPORT REPLACE_CREATE は、 PC/IXF ファイルからデータをインポートする際に表を作成します。 型付き表の場合、IMPORT CREATE はタイプ階層と表階層も作成することができます。

PC/IXF インポートを使用すると、データベース間でデータ (階層データを含む) を移動することができます。 行区切り文字を含む文字データが区切り文字付き ASCII (DEL) ファイルにエクスポートされ、 テキスト転送プログラムによって処理される場合、 行区切り文字を含むフィールドは長さが変わることがあります。 ソースとターゲットのデータベースが両方とも同じクライアントからアクセス可能である場合、 ファイルのコピーというステップは必要ありません。

ASC および DEL ファイルのデータは、 インポートを実行するクライアント・アプリケーションのコード・ページであると仮定されます。 異なるコード・ページのデータをインポートする場合は、 異なるコード・ページを使用することのできる PC/IXF ファイルをお勧めします。 PC/IXF ファイルとインポート・ユーティリティーが同じコード・ページである場合は、 通常のアプリケーションの場合のように処理が行われます。 それぞれのコード・ページが異なっており、FORCEIN オプションが指定されている場合、 インポート・ユーティリティーは、PC/IXF ファイルのデータのコード・ページと、 インポートを実行中のアプリケーションのコード・ページが同じであると見なします。 この処理は、 それら 2 つのコード・ページ用の変換テーブルが存在する場合であっても行われます。 それぞれのコード・ページが異なっており、FORCEIN オプションが指定されておらず、 変換テーブルが存在する場合、PC/IXF ファイルのすべてのデータは、 そのファイルのコード・ページからアプリケーションのコード・ページに変換されます。 この 2 つが異なる場合、FORCEIN オプションは指定されず、変換テーブルが存在しないと、インポート操作は失敗します。 このオプションは、 AIX® オペレーティング・システム上の Db2 クライアント上の PC/IXF ファイルにのみ適用されます。

8 KB ページ上の表オブジェクトの量が 1012 列の制限に近い場合、PC/IXF データ・ファイルをインポートすると、SQL ステートメントの最大サイズを超過するため、Db2 はエラーを戻します。 この状態が発生する可能性があるのは、列が CHAR、 VARCHAR、 または CLOB タイプの場合だけです。 DEL または ASC ファイルのインポートには、この制限事項は適用されません。 PC/IXF ファイルを使って新しい表を作成している場合、別の方法として、db2look を使って表を作成した DDL ステートメントをダンプしてから、そのステートメント CLP から発行する、という方法があります。

Db2 Connect を使用して、 Db2 for z/OS®などの DRDA サーバーにデータをインポートできます。 Db2 for VM and VSE、および Db2 for OS/400®。 PC/IXF インポート (INSERT オプション) のみがサポートされます。 RESTARTCOUNT パラメーターもサポートされていますが、COMMITCOUNT パラメーターはサポートされていません。

型付き表で CREATE オプションを使用するときは、PC/IXF ファイルで定義されているすべての副表を作成してください。副表の定義は変更できません。 型付き表で CREATE 以外のオプションを使用するときは、全探索順序リストによって全探索順序を指定できます。このため、全探索順序リストはエクスポート操作時に使用したものと一致する必要があります。 PC/IXF ファイル・フォーマットの場合、ターゲット・サブテーブル名を指定するだけで、ファイルに保管されているトラバース順序を使用することができます。

インポート・ユーティリティーは、 以前 PC/IXF ファイルにエクスポートされた表をリカバリーする場合に使用できます。 その表は、エクスポート時の状態に戻ります。

システム表、作成済み一時表、宣言済み一時表、またはサマリー表にデータをインポートすることはできません。

インポート・ユーティリティーを介してビューを作成することはできません。

個々のパーツが Windows システムから AIX システムにコピーされる、複数パーツの PC/IXF ファイルのインポートはサポートされています。 最初のファイルの名前だけ、IMPORT コマンドで指定する必要があります。 例えば、IMPORT FROM data.ixf OF IXF INSERT INTO TABLE1などです。 ファイル data.002などは、 data.ixfと同じディレクトリーで使用できます。

内部形式のセキュリティー・ラベルには、改行文字が含まれている可能性があります。 DEL ファイル・フォーマットを使用してファイルをインポートすると、これらの改行文字は区切り文字と誤解される可能性があります。 この問題が発生した場合は、 IMPORT コマンドで delprioritychar ファイル・タイプ修飾子を指定して、区切り文字に古いデフォルトの優先順位を使用してください。

暗黙的な非表示列がデータベース表に含まれている場合には、インポート操作に非表示列のデータを含めるかどうかを指定する必要があります。

IMPORT ユーティリティーは、表内の列数とデータ・ファイル内のフィールド数の突き合わせを行いません。 ユーティリティーは、データ・ファイル内に十分な量のデータがあるかどうかを検査し、データ・ファイル内の行に十分なデータ列が含まれていない場合、データのない対応する表の列が NOT NULL として定義されている場合は警告メッセージを出して行をリジェクトするか、対応する表の列が NULL として定義されている場合は警告メッセージを出さずに正常に挿入することができます。 一方、行に必要な数より多くの列が含まれている場合、必要な数の列が処理され、残りのデータ列は省略されます。警告メッセージは表示されません。

フェデレーテッドに関する考慮事項

IMPORT コマンドで INSERT、UPDATE、または INSERT_UPDATE コマンド・パラメーターを使用するときには、関係するニックネームに対する CONTROL 特権があることを確認してください。 インポート操作の実行時に使用するニックネームが存在することを確認する必要があります。 IMPORT コマンド・パラメーターのセクションに示されているように、注意すべき制約事項もいくつかあります。

ODBC などの一部のデータ・ソースでは、ニックネームへのインポートはサポートされていません。

カラム・オーガナイズ表

• IMPORT コマンドは、 カラム・オーガナイズ 表に関連するすべての INSERT、UPDATE、または DELETE ステートメントの制約事項を継承します。
• IMPORT コマンドの CREATE INTO パラメーターは、 カラム・オーガナイズ 表を作成できません。
• カラム・オーガナイズ 表に対するインポート操作では、インポート・パッケージがデータベースにバインドされるときに設定されるデフォルトの RS 分離レベルではなく、CS 分離レベル (挿入操作に必要) が使用されます。
• CREATE パラメーターまたは IMPORT コマンドの REPLACE_CREATE パラメーターを使用して カラム・オーガナイズ 表からデータをエクスポートすることによって作成した IXF ファイルを使用することはできません。

インポート・ユーティリティー用のファイル・タイプ修飾子

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

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

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

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

   db2 import from myfile.asc of asc
      modified by striptblanks
      method l (1 10, 12 15) messages msgs.txt
      insert into staff

    modified by chardel""

   db2 "import from myfile.del of del
      modified by chardel''
      method p (1, 4) insert into staff (id, years)"

   db2 import from myfile.del of del
      modified by coldel;
      messages msgs.txt insert into staff

   db2 "import from myfile.del of del
      modified by chardel''
      decpt; messages msgs.txt insert into staff"

   db2 import ... modified by delprioritychar ...

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