IMPORT コマンド

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

許可

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

必要な接続

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

コマンド構文

>>-IMPORT FROM--filename--OF--filetype-------------------------->

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

>--+-------------------------------+---------------------------->
   |              .--------------. |   
   |              V              | |   
   '-MODIFIED BY----filetype-mod-+-'   

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

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

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

   .-ALLOW NO ACCESS----.                                   
>--+--------------------+--+----------------------------+------->
   '-ALLOW WRITE ACCESS-'  '-COMMITCOUNT--+-n---------+-'   
                                          '-AUTOMATIC-'     

>--+---------------------+--+-------------+--------------------->
   '-+-RESTARTCOUNT-+--n-'  '-ROWCOUNT--n-'   
     '-SKIPCOUNT----'                         

>--+-----------------+--+-----------+--------------------------->
   '-WARNINGCOUNT--n-'  '-NOTIMEOUT-'   

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

>--+-+-INSERT---------+--INTO--+-table-name--+-------------------------+-+----------------------+-><
   | +-INSERT_UPDATE--+        |             |    .-,-------------.    | |                      |   
   | +-REPLACE--------+        |             |    V               |    | |                      |   
   | '-REPLACE_CREATE-'        |             '-(----insert-column-+--)-' |                      |   
   |                           '-| hierarchy description |---------------'                      |   
   '-CREATE--INTO--+-table-name--+-------------------------+--------------+--| tblspace-specs |-'   
                   |             |    .-,-------------.    |              |                         
                   |             |    V               |    |              |                         
                   |             '-(----insert-column-+--)-'              |                         
                   '-| hierarchy description |--+-AS ROOT TABLE---------+-'                         
                                                '-UNDER--sub-table-name-'                           

Ignore and Map parameters

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

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

hierarchy description

   .-ALL TABLES---------.           
|--+-| sub-table-list |-+--+----+------------------------------->
                           '-IN-'   

>--HIERARCHY--+-STARTING--sub-table-name-+----------------------|
              '-| traversal-order-list |-'   

sub-table-list

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

traversal-order-list

      .-,--------------.      
      V                |      
|--(----sub-table-name-+--)-------------------------------------|

tblspace-specs

|--+----------------------------------------------------------------------------------+--|
   '-IN--tablespace-name--+---------------------------+--+--------------------------+-'   
                          '-INDEX IN--tablespace-name-'  '-LONG IN--tablespace-name-'     

コマンド・パラメーター

FROM filename

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

OF filetype

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

• 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 標識フィールドのオフセットです。 NULL 標識リストには、METHOD L パラメーターで定義された各データ・フィールドに対する 1 つの項目がなければなりません。 列の番号がゼロであることは、 対応するデータ・フィールド内に必ずデータがあることを示します。

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

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

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 オプションの例を参照してください。

DEFAULT schema-sqlid

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

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

IGNORE schema-sqlid

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

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

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

MAP schema-sqlid

このオプションは、USING XDS パラメーターを指定した場合にのみ使用できます。MAP 節は、インポートする各 XML 文書について XML Data Specifier (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 節は考慮されません。

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

NLI 節が呼び出される CREATE TABLE または ALTER TABLE ステートメントと同じトランザクションの中で、REPLACE オプションの指定されたインポートが実行された場合、インポートにおいてその NLI 節は考慮されません。すべての挿入操作がログ対象となります。

予備手段 1

DELETE ステートメントを使用して表の内容を削除した後、INSERT ステートメントによりインポートを呼び出す

予備手段 2

表をドロップしてからそれを再作成した後、INSERT ステートメントによってインポートを呼び出す

この制限は、DB2 Universal Database™ バージョン 7 および DB2 バージョン 8 に適用されます。

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,...)

• 非表示列のファイル・タイプ修飾子のいずれかを使用します。入力ファイルに非表示列のデータが含まれる場合には 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 は行が長過ぎるために失敗します。制約事項のリストは、『インポート済みの表の再作成』を参照してください。この場合、その表は手動で作成します。そして、IMPORT に INSERT を指定して呼び出すか、または LOAD コマンドを使用してください。

AS ROOT TABLE

1 つ以上の副表を、独立した表階層として作成します。

UNDER sub-table-name

1 つ以上の副表を作成する場合に親表を指定します。

IN tablespace-name

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

INDEX IN tablespace-name

表の索引を作成する表スペースを指定します。 このオプションは、IN 節で指定される PRIMARY 表スペースが 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

DATAFILE1 を TABLE2 に、IDENTITY 関連のファイル・タイプ修飾子を使用せずにインポートした場合、行 1 と 2 は挿入されますが、行 3 と 4 はリジェクトされます。 その理由は、それらが固有の非 NULL 値を提供し、IDENTITY 列が 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 ファイルがディスケットにあるときよりも、 ハード・ディスクにあるときの方がより速く行うことができます。

データベース表または階層が存在していないと、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 ファイルのすべてのデータは、 そのファイルのコード・ページからアプリケーションのコード・ページに変換されます。 それぞれのコード・ページが異なっており、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 OS/390®、DB2 for VM and VSE、および DB2 for OS/400® などの DRDA® サーバーにデータをインポートすることができます。 サポートされているのは、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 などの一部のデータ・ソースでは、ニックネームへのインポートはサポートされていません。

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

   "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>