EXPORT コマンド

許可

必要な接続

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

コマンド構文

traversal-order-list

コマンド・パラメーター

TO filename

データのエクスポート先のファイルの名前を指定します。 このファイルへの完全パスが指定されていない場合、 エクスポート・ユーティリティーは現行のディレクトリーおよびデフォルトのドライブを宛先として使用します。

既存のファイルの名前が指定されている場合、エクスポート・ユーティリティーはファイルの内容を上書きします。情報は追加されません。

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

OF filetype

次のような出力ファイルのデータ・フォーマットを指定します。

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

LOBS TO lob-path

LOB ファイルが保管される、ディレクトリーへの 1 つ以上のパスを指定します。 LOB パスごとに少なくとも 1 つのファイルが存在する必要があります。 各ファイルには少なくとも 1 つの LOB が入ります。 指定できるパスの最大数は 999 です。 この設定によって、LOBSINFILE の動作が暗黙的に活動化されます。

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

LOBFILE filename

LOB ファイルに 1 つ以上の基本ファイル名を指定します。 最初の名前の名前空間がいっぱいになると、2 番目の名前が使用され、 以下 3 番目、4 番目と続きます。 この設定によって、LOBSINFILE の動作が暗黙的に活動化されます。

エクスポート操作での LOB ファイルの作成時には、現行パス (lob-path からの) にこのリストから現行ベース名を追加します。 次に、開始する 3 桁のシーケンス番号と、3 文字の ID lob を付加する必要があります。 例えば、現行 LOB パスがディレクトリー /u/foo/lob/path/ で、 現行 LOB ファイル名が bar の場合、LOB ファイルは、/u/foo/lob/path/bar.001.lob、/u/foo/lob/path/bar.002.lob (以下 003、004 と続く) などのように作成されます。 LOB ファイル名の 3 桁のシーケンス番号は、999 が使用されている場合は 4 桁に増え、9999 が使用されている場合は 4 桁から 5 桁に増え、などになります。

XML TO xml-path

XML ファイルが保管されるディレクトリーを指す 1 つ以上のパスを指定します。 XML パスごとに少なくとも 1 つのファイルが存在し、各ファイルには少なくとも 1 つの XQuery データ・モデル (XDM) インスタンスが含まれることになります。 複数のパスが指定された場合、XDM インスタンスはそれらのパスに均等に分散されます。

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

XMLFILE filename

XML ファイルのための 1 つ以上の基本ファイル名を指定します。 最初の名前の名前空間がいっぱいになると、2 番目の名前が使用され、 以下 3 番目、4 番目と続きます。

エクスポート操作での XML ファイルの作成時には、現行パス (xml-path からの) にこのリストから現行ベース名を追加します。 次に、3 桁のシーケンス番号と、3 文字の ID xmlを付加する必要があります。 例えば、現行 XML パスがディレクトリー /u/foo/xml/path/ で、現行 XML ファイル名が bar の場合、XML ファイルは、/u/foo/xml/path/bar.001.xml、/u/foo/xml/path/bar.002.xml などのように作成されます。

MODIFIED BY filetype-mod

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

XMLSAVESCHEMA

すべての XML 列について XML スキーマ情報を保管する必要があることを指定します。 挿入時に XML スキーマに対して妥当性検査されるエクスポート済み XML 文書ごとに、そのスキーマの完全修飾 SQL ID が SCH 属性として格納されます。 この属性は、対応する XML データ指定子 (XDS) 内に格納されます。 エクスポートされた文書が XML スキーマに対して妥当性検査されない場合、またはスキーマ・オブジェクトがデータベースに存在しなくなった場合、SCH 属性は対応する XDS に含まれません。

SQL ID のスキーマと名前の各部分は、XML スキーマに対応する SYSCAT.XSROBJECTS カタログ表の行の "OBJECTSCHEMA" および "OBJECTNAME" の値として格納されます。

XMLSAVESCHEMA オプションは、整形式 XML 文書を生成しない XQuery シーケンスと互換性がありません。

METHOD N column-name

出力ファイルで使用される 1 つ以上の列名を指定します。 このパラメーターが指定されない場合、表の列名が使用されます。 このパラメーターは IXF ファイルでのみ有効ですが、階層データをエクスポートするときは無効です。

MESSAGES message-file

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

select-statement

エクスポートされるデータを戻す SELECT または XQUERY ステートメントを指定します。 このステートメントによってエラーが発生する場合、メッセージ・ファイル (または標準出力) にメッセージが書き込まれます。 エラー・コードが SQL0012W、SQL0347W、SQL0360W、SQL0437W、 または SQL1824W である場合、エクスポート操作は続行します。 これ以外のエラー・コードの場合、操作は停止します。

SELECT ステートメントが SELECT * FROM tablename という形式で、表に暗黙的な非表示列が含まれている場合には、エクスポート操作に非表示列のデータを含めるかどうかを明示的に指定する必要があります。 非表示列のデータを含めるかどうかを示すには、以下のいずれかの方法を使用します。

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

  db2 export to t.del of del modified by implicitlyhiddeninclude
     select * from t

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

  db2set DB2_DMU_DEFAULT=IMPLICITLYHIDDENINCLUDE
  db2 export to t.del of del select * from t 

HIERARCHY STARTING sub-table-name

デフォルトのトラバース順序 (ASC または DEL ファイルの OUTER 順序、または PC/IXF データ・ファイルに格納されている順序) を使用して、sub-table-name から始まるサブ階層をエクスポートします。

HIERARCHY traversal-order-list

指定されたトラバース順序を使用してサブ階層をエクスポートします。 すべての副表は、PRE-ORDER 方式でリストする必要があります。 最初の副表名は、SELECT ステートメントのターゲット表名として使用されます。

例

db2 export to myfile.ixf of ixf messages msgs.txt select * from staff

db2 export to awards.ixf of ixf messages msgs.txt select * from staff
      where dept = 20

   db2 export to myfile.del of del lobs to mylobs/
      lobfile lobs1, lobs2 modified by lobsinfile
      select * from emp_photo

   db2 export to myfile.del of del
      lobs to /db2exp1/, /db2exp2/ modified by lobsinfile
      select * from emp_photo

   db2 export to myfile.del of del
      modified by chardel'' coldel; decpt,
      select * from staff

使用上の注意

• エクスポート操作を開始する前に、すべての表操作が完了し、すべてのロックが解除されていることを確認してください。 このステップは、WITH HOLD でオープンされたすべてのカーソルをクローズした後で COMMIT を発行するか、ROLLBACK を発行することによって行うことができます。
• SELECT ステートメントでは表の別名を使用できます。
• EXPORT 表がパーティション化されていない場合など、SQL27981W メッセージが該当しないように思えるのに、このメッセージが示される場合があります。 その場合、この警告は無視しても安全です。 この警告メッセージは、EXPORT コマンドの SELECT ステートメント内の SQL キーワード FROM の前に「from」という語が含まれている場合に返されることがあります。
• メッセージ・ファイルに置かれたメッセージには、メッセージ検索サービスから戻される情報が含まれています。 各メッセージは新しい行から始まります。
• PC/IXF インポートは、データベース間でデータを移動する場合に使用する必要があります。 行区切り文字を含む文字データが区切り文字付き ASCII (DEL) ファイルにエクスポートされ、テキスト転送プログラムによって処理される場合、行区切り文字を含むフィールドは縮小または展開されます。
• ソースとターゲットのデータベースが両方とも同じクライアントからアクセス可能である場合、 ファイルのコピーというステップは必要ありません。
• Db2 Connect を使用して、 Db2® for z/OS®、 Db2 for VM and VSE、および Db2 for OS/400®などの DRDA サーバーから表をエクスポートできます。 PC/IXF エクスポートのみがサポートされます。
• IXF フォーマットにエクスポートする際に、ID が IXF フォーマットでサポートされる最大サイズを超えている場合、エクスポートは成功します。 ただし、結果のデータ・ファイルは、CREATE モード (SQL27984W) を使用する後続のインポート操作では使用できません。
• IXF 形式にエクスポートする場合、エクスポート・ユーティリティーは、CREATE モードを使用した後続のインポート操作中に カラム・オーガナイズ 表を再作成するために必要な カラム・オーガナイズ 表メタデータを保持しません。
• Windows 上のディスケットにエクスポートする場合、および単一ディスケットの容量よりも多くのデータを持つテーブルにエクスポートする場合、システムは別のディスケットの入力を求めるプロンプトを出します。 複数パーツ PC/IXF ファイル (マルチボリューム PC/IXF ファイル、または論理的に分割された PC/IXF ファイルとして知られる) が生成されて別々のディスケットに保管されます。 各ファイルには、最後のファイルを除き、 Db2 継続レコード (略して「AC」レコード) が書き込まれます。 このレコードは、ファイルが論理的に分割されていること、および次のファイルを検索する場所を示しています。 その後、ファイルを AIX® システムに転送して、インポート・ユーティリティーおよびロード・ユーティリティーで読み取ることができます。 エクスポート・ユーティリティーは、 AIX システムから起動された場合、複数部構成の PC/IXF ファイルを作成しません。 詳しい使用法については、IMPORT コマンドまたは LOAD コマンドを参照してください。
• エクスポート・ユーティリティーは、提供される SELECT ステートメントが、 SELECT * FROM tablename という形式である場合、 IXF ファイルの表の NOT NULL WITH DEFAULT 属性を保管します。
• 型付き表をエクスポートする場合、副選択ステートメントは、ターゲット表名と WHERE 節を指定することによってのみ表現することができます。 階層をエクスポートする場合、全選択と select-statement は指定できません。
• IXF 以外のファイル・フォーマットの場合は、トラバーサル順序リストを指定します。 このリストは、 Db2 に階層のトラバース方法、およびエクスポートする副表を指示します。 このリストを指定しない場合、階層内のすべての表がエクスポートされ、 デフォルトの順序は OUTER 順序になります。 OUTER 関数によって指定されるデフォルトの順序を使うこともできます。
• インポート操作の間も同じ走査順序を使用します。 ロード・ユーティリティーは、階層または副階層のロードをサポートしません。
• 保護された行を含む表からデータをエクスポートする場合、セッション許可 ID が保持する LBAC 信用証明情報によって、エクスポートされる行が制限される可能性があります。 セッション許可 ID に行に対する読み取り専用アクセス権限がない場合、行はエクスポートされません。 エラーも警告も出ません。
• セッション許可 ID によって保持される LBAC 資格情報は、エクスポートに含まれる 1 つ以上の保護された列からの読み取りを許可する必要があります。 これらの資格情報が保護された列からの読み取りを許可しない場合、エクスポートは失敗し、SQLSTATE 42512 エラーが戻されます。
• export や db2move などのデータ移動ユーティリティーを実行する際に、照会コンパイラーが、基礎照会を基本表よりも MQT に対して実行する方が効率が良いと判別することがあります。 この場合、照会はリフレッシュ据え置き MQT に対して実行され、ユーティリティーの結果は基礎表のデータを正確に表さない可能性があります。
• エクスポート・パッケージは、DATETIME ISO 形式を使用してバインドされます。 そのため、ストリング表記へのキャスト時にすべての日付/時間/タイム・スタンプの値は ISO 形式に変換されます。 CLP パッケージは DATETIME LOC 形式 (ロケール固有形式) を使用してバインドされるため、CLP DATETIME 形式が ISO と異なる場合に CLP とエクスポート間で矛盾した振る舞いが見られる場合があります。 例えば、以下の SELECT ステートメントは、以下の期待される結果を戻します。

     db2 select col2 from tab1 where char(col2)='05/10/2005';
        COL2
        ----------
        05/10/2005
        05/10/2005
        05/10/2005
        3 record(s) selected.

  しかし、同じ select 節を使用した export コマンドでは、期待される結果が戻されません。

     db2 export to test.del of del select col2 from test 
     where char(col2)='05/10/2005';
        Number of rows exported: 0

  ここで、LOCALE 日付形式を ISO 形式に置き換えると、以下のように、期待される結果になります。

     db2 export to test.del of del select col2 from test
     where char(col2)='2005-05-10';
        Number of rows exported: 3

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

   modified by chardel""

   modified by chardel''

   db2 "export to temp of del modified by coldel;
      select * from staff where dept = 20"

   db2 create table decimalTable ( c1 decimal( 31, 2 ) )
   db2 insert into decimalTable values ( 1.1 )
   
   db2 export to data of del select * from decimalTable
    
   db2 export to data of del modified by STRIPLZEROS 
      select * from decimalTable

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

   db2 export to delfile2 of del
      modified by timestampformat="yyyy.mm.dd hh:mm tt"
      select * from schedule