EXPORT コマンド

許可

必要な接続

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

コマンド構文

traversal-order-list

コマンド・パラメーター

TO filename

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

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

OF filetype

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

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

LOBS TO lob-path

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

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 インスタンスはそれらのパスに均等に分散されます。

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 が、対応する XML Data Specifier (XDS) 内に SCH 属性として格納されます。 エクスポートされた文書に対して XML スキーマに関する妥当性検査が実行されていない場合、またはそのスキーマ・オブジェクトがデータベースにもやは存在しない場合は、対応する XDS に SCH 属性は含められません。

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 OPS RECORD (または略して「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