EXPORT コマンド (ADMIN_CMD プロシージャーを使用)

許可

必要な接続

データベース。 Linux、UNIX、または Windows クライアントから Linux、UNIX、または Windows データベース・サーバーへのユーティリティー・アクセスは、エンジンを使用した直接接続でなければなりません。Db2 Connect ゲートウェイやループバック環境を介した直接接続によるアクセスであってはなりません。

コマンド構文

traversal-order-list

コマンド・パラメーター

TO filename

サーバーにおいてデータのエクスポート先となるファイルの名前を指定します。 このパラメーターは、完全修飾パスでなければならず、サーバー・コーディネーター・パーティション上に存在していなければなりません。

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

この節を指定するかどうかにかかわらず、fenced ユーザー ID に、 DB2_UTIL_MSGPATH レジストリー変数で指定したディレクトリーおよびデータのエクスポート先ディレクトリーにファイルを作成するための権限が必要です。

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 ファイルでのみ有効ですが、階層データをエクスポートするときは無効です。

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 ステートメントのターゲット表名として使用されます。

MESSAGES ON SERVER

EXPORT コマンドによってサーバー上に作成されるメッセージ・ファイルを保存することを指定します。戻された結果セットには、 MSG_RETRIEVAL および MSG_REMOVAL の 2 つの列が含まれています。 MSG_RETRIEVAL は、この操作中に発生したすべての警告メッセージおよびエラー・メッセージを取得するために必要な SQL ステートメントです。 MSG_REMOVAL は、メッセージをクリーンアップするために必要な SQL ステートメントです。

この節が指定されていない場合は、ADMIN_CMD プロシージャーから呼び出し元に戻る時点でメッセージ・ファイルが削除されます。結果セット中の MSG_RETRIEVAL および MSG_REMOVAL 列の内容は NULL 値になります。

この節を指定するかどうかにかかわらず、fenced ユーザー ID またはインスタンス所有者の 1 次グループに、DB2_UTIL_MSGPATH レジストリー変数で指定したディレクトリーおよびデータのエクスポート先ディレクトリーにファイルを作成するための権限が必要です。

例

CALL SYSPROC.ADMIN_CMD ('EXPORT to /home/user1/data/myfile.ixf 
   OF ixf MESSAGES ON SERVER select * from staff')

使用上の注意

• EXPORT コマンドで使用されるすべてのパスは、サーバー上の有効な完全修飾パスでなければなりません。
• 表に LOB 列が含まれている場合、LOBS TO および LOBFILE 節を使用して、少なくとも 1 つの完全修飾 LOB パスと LOB 名が指定されていなければなりません。
• エクスポート・ユーティリティーは操作の開始時に COMMIT ステートメントを発行します。このため、タイプ 2 接続の場合は、プロシージャーから SQL30090N、理由コード 2 が戻されます。
• UCS-2 データベースから、区切り文字で区切られている ASCII (DEL) ファイルにエクスポートする場合、すべての文字データは、プロシージャーを実行する場所で有効なコード・ページに変換されます。文字ストリングと GRAPHIC ストリング・データのどちらも、サーバーの、同じ SBCS または MBCS コード・ページに変換されます。
• エクスポート操作を開始する前に、すべての表操作が完了し、すべてのロックが解除されていることを確認してください。このステップを行うには、 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 でディスケットにエクスポートしているときに 1 枚のディスケットの容量を超えるデータを持つ表がある場合、別のディスケットを挿入するようプロンプトが出されます。複数パーツ PC/IXF ファイル (マルチボリューム PC/IXF ファイル、または論理的に分割された PC/IXF ファイルとして知られる) が生成されて別々のディスケットに保管されます。最後のファイルを除く各ファイルに、 Db2 CONTINUATION 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

結果セット情報

SELECT SQLCODE, MSG
   FROM TABLE (SYSPROC.ADMIN_GET_MSGS
   ('3203498_txu')) AS MSG

CALL SYSPROC.ADMIN_REMOVE_MSGS
   ('3203498_txu')

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

   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