EXPORT コマンド

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

許可

必要な接続

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

コマンド構文

>>-EXPORT TO--filename--OF--filetype---------------------------->

>--+-----------------------+--+-----------------------+--------->
   |          .-,--------. |  |          .-,--------. |   
   |          V          | |  |          V          | |   
   '-LOBS TO----lob-path-+-'  '-LOBFILE----filename-+-'   

>--+----------------------+--+-----------------------+---------->
   |         .-,--------. |  |          .-,--------. |   
   |         V          | |  |          V          | |   
   '-XML TO----xml-path-+-'  '-XMLFILE----filename-+-'   

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

>--+---------------------------------+-------------------------->
   |              .-,-----------.    |   
   |              V             |    |   
   '-METHOD N--(----column-name-+--)-'   

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

>--+-select-statement---------------------------------------+--><
   +-XQUERY--xquery-statement-------------------------------+   
   '-HIERARCHY--+-STARTING--sub-table-name-+--+-----------+-'   
                '-| traversal-order-list |-'  | .-------. |     
                                              | V       | |     
                                              '---WHERE-+-'     

traversal-order-list

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

コマンド・パラメーター

HIERARCHY traversal-order-list

指定した走査順序を使用して副階層をエクスポートします。 すべての副表は、PRE-ORDER 方式でリストされていなければなりません。 最初の副表名が、SELECT ステートメントのターゲット表名として使用されます。

HIERARCHY STARTING sub-table-name

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

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 桁に増えます。以下同様にシーケンス番号の桁数が増えていきます。

LOBS TO lob-path

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

MESSAGES message-file

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

METHOD N column-name

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

MODIFIED BY filetype-mod

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

OF filetype

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

• DEL (区切り文字付き ASCII フォーマット)。さまざまなデータベース・マネージャーやファイル・マネージャー・プログラムで使用します。
• WSF (ワークシート・フォーマット)。以下のプログラムで使用します。
  • Lotus® 1-2-3®
  • Lotus Symphony®
  BIGINT または DECIMAL データをエクスポートする場合、 タイプ DOUBLE の範囲内の値のみが正確にエクスポートされます。 この範囲内にない値もエクスポートされますが、オペレーティング・システムによっては、 これらの値を再びインポートまたはロードすると、データに間違いが生じる場合があります。
  注: WSF ファイル・フォーマットのサポートは推奨されておらず、今後のリリースで除去される可能性があります。サポートが除去される前に、WSF ファイルの代わりに、サポートされているファイル・フォーマットの使用を開始することを推奨します。
• IXF (統合交換フォーマット、PC バージョン) は、プロプラエタリー・バイナリー・フォーマットです。

select-statement

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

TO filename

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

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

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 などのように作成されます。

XML TO xml-path

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

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 シーケンスとの互換性がありません。

例

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 OS/390®、DB2 for VM and VSE、および DB2 for OS/400® などの DRDA® サーバーから表をエクスポートすることができます。 PC/IXF エクスポートだけがサポートされています。
• IXF フォーマットにエクスポートする際に、ID が IXF フォーマットでサポートされる最大サイズを超えている場合、エクスポートは成功しますが、生成されるデータ・ファイルは CREATE モードを使用する後続のインポート操作では使用できません。 SQL27984W が戻されます。
• Windows でディスケットにエクスポートしているときに 1 枚のディスケットの容量を超えるデータを持つ表がある場合、別のディスケットを挿入するようプロンプトが出され、複数パーツ PC/IXF ファイル (マルチボリューム PC/IXF ファイル、または論理的に分割された PC/IXF ファイルとして知られる) が生成されて別々のディスケットに保管されます。 最後のファイルを除く各ファイルには、そのファイルが論理的に分割されていること、および次のファイルを検索する場所を示すための DB2 CONTINUATION RECORD (または略して "AC" Record) が書き込まれます。 その後、ファイルがインポート・ユーティリティーおよびロード・ユーティリティーによって読み取られるように、ファイルを 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   - 年 (0000 から 9999 の範囲の 4 桁の数)
  M      - 月 (1 から 12 の範囲の 1 桁または 2 桁の数)
  MM     - 月 (01 から 12 の 2 桁の数。
              M および MMM とは相互に排他的)
  MMM    - 月 (大文字小文字を区別しない月名の 3 文字の省略形。
              M と MM とは相互に排他的)
  D      - 日 (1 から 31 の範囲の 1 桁または 2 桁の数)
  DD     - 日 (01 から 31 の範囲の 2 桁の数。D とは相互に排他的)
  DDD    - 元日から数えた日数 (001 から 366 の範囲の 3 桁の数。
              他の日または月のエレメントとは相互に排他的)
  H      - 時 (12 時間制の場合は 0 から 12、24 時間制では 0 から 24 の
              範囲の 1 桁または 2 桁の数。)
  HH     - 時 (12 時間制の場合は 00 から 12、24 時間制では 00 から 24 の
              範囲の 2 桁の数。
              H と相互に排他的)
  M      - 分 (0 から 59 の範囲の 1 桁または 2 桁の数)
  MM     - 分 (00 から 59 の範囲の 2 桁の数。
              M (分) とは相互に排他的)
  S      - 秒 (0 から 59 の範囲の 1 桁または 2 桁の数)
  SS     - 秒 (00 から 59 の範囲の 2 桁の数。
              S と相互に排他的)
  SSSSS  - 夜中の 12 時から数えた秒数
              (00000 から 86400 の範囲の 5 桁の数。
              他の時刻エレメントとは相互に排他的)
  U (1 から 12 時)
         - 小数秒 (U のオカレンス数は、各桁を 0 から 9 の範囲として、
             桁数を表します)
  TT     - 午前/午後の指定子 (AM または PM)

   "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