リリース情報

|12.7 db2move

|db2move ツールに、--aw および --sn の |2 つのオプションが追加されました。以下に、このツールの完全な |文書を記します。

|データベース移動ツール

|このツールを使用すると、たくさんの表を複数のワークステーション上の |DB2 データベース間で容易に移動できます。このツールは、システム・カタログ表から |特定のデータベースを照会したり、すべてのユーザー表からなるリストをコンパイルしたりします。 |その後、これらの表を PC/IXF 形式でエクスポートします。PC/IXF ファイルは、同じシステム上の別のローカル DB2 データベースにインポートまたはロードできます。または、別のワークステーション・プラットフォームに転送してから、そのプラットフォームの DB2 データベースにインポートまたはロードできます。

|注:

このツールを使用しても、構造型列を持つ表は移動されません。 |

|権限

|ユーザーの要求するアクションに応じて、このツールは DB2 のエクスポート、インポート、 |およびロード API を呼び出します。したがって、要求を出しているユーザー ID には、 |それら API に必要な適切な許可が必要です。許可がない場合は、要求は失敗します。

|コマンド構文

|                            .-------------------------.
|                            V                         |
|>>-db2move--dbname--action----+---------------------+-+--------><
|                              +--tc--table-creators-+
|                              +--tn--table-names----+
|                              +--sn--schema names---+
|                              +--io--import-option--+
|                              +--lo--load-option----+
|                              +--l--lobpaths--------+
|                              +--u--userid----------+
|                              +--p--password--------+
|                              '--aw-----------------'
| 
| 

|コマンド・パラメーター |

|dbname

|データベースの名前。

|action

|EXPORT、IMPORT、または LOAD のうちいずれか 1 つ。

|-tc

|table-creators。デフォルトはすべての作成者です。

|これは EXPORT アクションのみです。このオプションを指定すると、 |このオプションで示す作成者の作成した表だけがエクスポートされます。 |指定しない場合は、デフォルトとしてすべての作成者を使用します。複数の作成者を指定する場合は、それぞれの作成者をコンマで区切る必要があります。 |作成者 ID 同士の間にブランクを入れないようにしてください。 |指定できる作成者の最大数は 10 です。このオプションを 『-tn』 および |『-sn』 と一緒に使用すると、エクスポートする表を選択できます。

|文字ストリング内の任意の場所で、ワイルドカード文字としてアスタリスク (*) を使用できます。

|-tn

|table-names。デフォルトはすべてのユーザー表です。

|これは EXPORT アクションのみです。このオプションを指定すると、 |指定されたストリングの中の名前と正確に一致する表だけがエクスポートされます。 |指定しない場合は、デフォルトとしてすべてのユーザー表を使用します。 |複数の表名を指定する場合は、それぞれの表名をコンマで区切る必要があります。 |表名同士の間にブランクを入れないようにしてください。指定できる表名の最大数は 10 です。 |このオプションを 『-tc』 および |『-sn』 と一緒に使用すると、エクスポートする表を選択できます。 |db2move は、指定された表名と名前が一致し、 |かつ指定された表作成者と作成者が同じ表だけをエクスポートします。

|文字ストリング内の任意の場所で、ワイルドカード文字としてアスタリスク (*) を使用できます。

|-sn

|スキーマ名。デフォルトはすべてのスキーマです。

|これは EXPORT アクションのみです。このオプションを指定すると、 |指定されたストリングの中のスキーマと正確に一致する表だけがエクスポートされます。 |指定しない場合は、デフォルトとしてすべてのスキーマを使用します。 |複数のスキーマ名を指定する場合は、それぞれのスキーマ名をコンマで区切る必要があります。 |スキーマ名同士の間にブランクを入れないようにしてください。 |指定できるスキーマ名の最大数は 10 です。 |このオプションを 『-tc』 および |『-tc』 と一緒に使用すると、エクスポートする表を選択できます。 |db2move は、指定された表名と名前が一致し、特定の表スキーマと |スキーマが同じで、かつ指定された表作成者と作成者が同じ表だけをエクスポートします。

|文字ストリング内の任意の場所で、ワイルドカード文字としてアスタリスク (*) を使用できます。

|注:

長さが 8 文字より小さいスキーマ名は 8 文字長になるように埋め込まれます。 |例えば、スキーマ 『AUSER』 および 『BUSER』 を組み込み、 |ワイルドカード文字を使用したい場合、-sn *USER* と指定します。 |

|-io

|インポート・オプション。デフォルトは REPLACE_CREATE です。

|有効なオプションは、INSERT、 |INSERT_UPDATE、REPLACE、CREATE、および REPLACE_CREATE です。

|-lo

|load-option。デフォルトは INSERT です。

|有効なオプションは、INSERT および |REPLACE です。

|-l

|lobpaths。デフォルトは現行ディレクトリーです。

|このオプションは、EXPORT の一部として LOB ファイルを作成したり、 |IMPORT や LOAD の一部として LOB ファイルを検索したりする場所の |絶対パス名を指定します。複数の LOB パスを指定する場合は、 |それぞれの LOB パスをコンマで区切る必要があります。 |LOB パス同士の間にブランクを入れないようにしてください。EXPORT 中に最初のパスのスペースが不足した場合、 |または IMPORT や LOAD 中にパス内にファイルが見つからない場合は、 |2 番目以降のパスを順次使用します。

|EXPORT アクションの場合で、LOB パスが指定されている場合は、 |LOB パス・ディレクトリー内のファイルはすべて削除され、 |ディレクトリーは除去され、新しいディレクトリーが作成されます。 |これを指定しない場合、現行ディレクトリーが LOB パスとして使用されます。

|-u

|ユーザー ID。デフォルトはログオンしているユーザー ID です。

|ユーザー ID とパスワードはどちらもオプションです。 |ただし、どちらか一方を指定すると、もう一方も指定しなければなりません。 |リモート・サーバーに接続しているクライアント上でコマンドを実行している場合は、 |ユーザー ID とパスワードを指定する必要があります。

|-p

|パスワード。デフォルトはログオンしているパスワードです。

|ユーザー ID とパスワードはどちらもオプションです。 |ただし、どちらか一方を指定すると、もう一方も指定しなければなりません。 |リモート・サーバーに接続しているクライアント上でコマンドを実行している場合は、 |ユーザー ID とパスワードを指定する必要があります。

|-aw

|警告を受け入れます。

|EXPORT アクションのみに使用されます。このオプションを指定すると、 |エクスポート中に警告を受けた表が db2move.lst ファイルに組み込まれます。 |このオプションを省略すると、エクスポート中に警告を受けた表が |db2move.lst ファイルに組み込まれません。このオプションを使用するか否かにかかわらず、 |表の .ixf ファイルおよび .msg ファイルが生成されます。 |

|例 |

• |db2move sample export

  |これは、すべての表を SAMPLE データベースにエクスポートします。 |すべてのオプションにデフォルト値が使われます。

• |db2move sample export -tc userid1,us*rid2 -tn tbname1,*tbname2

  |これは、"userid1" または "us%rid2" と |いうようなユーザー ID によって作成されており、表名が "tbname1" または "%tbname2" である |表を、すべてエクスポートします。

• |db2move sample import -l D:¥LOBPATH1,C:¥LOBPATH2

  |この例は、OS/2 または Windows オペレーティング・システムのみに当てはまります。 |このコマンドは、SAMPLE データベース内のすべての表をインポートします。 |LOB パス "D:¥LOBPATH1" および "C:¥LOBPATH2" から LOB ファイルを検索します。

• |db2move sample load -l /home/userid/lobpath,/tmp

  |この例は UNIX ベースのシステムのみに当てはまります。 |このコマンドは、SAMPLE データベース内のすべての表をロードします。 |サブディレクトリー /home/userid/lobpath および |tmp の両方から LOB ファイルを検索します。

• |db2move sample import -io replace -u userid -p password

  |これは、SAMPLE データベース内のすべての表を REPLACE モードでインポートします。 |指定されたユーザー ID とパスワードが使われます。 |

|使用上の注意

|このツールは、ユーザー作成の表をエクスポート、インポート、またはロードします。 |あるデータベースを、1 つのオペレーティング・システムから別のオペレーティング・システムへ複製する際には、 |db2move を使用すると表の移動が容易になります。 |また、表に関連付けられた他のオブジェクト (別名、視点、トリガー、ユーザー定義関数など) |をすべて移動する必要があります。 | db2look (DB2 統計および DDL 抽出ツール:「コマンド解説書」を参照) |を利用すると、データ定義言語 (DDL) ステートメントをデータベースから取り出すことによって、 |いくつかのオブジェクトの移動が容易になります。

|エクスポート、インポート、またはロード API がdb2move によって呼び出されると、FileTypeMod パラメーターは lobsinfile に設定されます。つまり、LOB データは PC/IXF ファイルとは |別個のファイルの中に入れられます。LOB ファイルの名前に使用できるファイル名は |26 000 個あります。

|LOAD アクションは、データベースとデータ・ファイルがあるマシン上で |ローカルに実行しなければなりません。ロード API が db2move によって呼び出されると、CopyTargetList パラメーターは NULL に設定され、コピーは実行されません。 |logretain がオンに設定されていると、後でロード操作をロールフォワードすることはできません。 |ロードされる表が入れられる表スペースはバックアップ保留状態になり、アクセスできなくなります。データベース全体のバックアップ、または個々の表スペースのバックアップを取るには、 |表スペースをバックアップ保留状態から解除する必要があります。

|バージョン 5.2 のクライアントからバージョン 6 のデータベースに対して発行される場合、 |このツールは、長さが 18 文字より長い表名または列名をサポートしません。

|EXPORT 使用時に必要なファイルと生成されるファイル: |

• |入力: なし。
• |出力:

  |

  |EXPORT.out

  |EXPORT アクションの結果の要約。

  |db2move.lst

  |元の表名、および対応する PC/IXF ファイル名 (tabnnn.ixf) と |メッセージ・ファイル名 (tabnnn.msg) のリスト。このリストに加えて、エクスポートされた PC/IXF ファイル、および LOB ファイル (tabnnnc.yyy) が、 |db2move IMPORT または LOAD アクションの入力として使われます。

  |tabnnn.ixf

  |特定の表からエクスポートした PC/IXF ファイル。

  |tabnnn.msg

  |対応する表のエクスポート・メッセージ・ファイル。

  |tabnnnc.yyy

  |特定の表からエクスポートした LOB ファイル。

  |『nnn』 は表番号。『c』 は英字。『yyy』 は 001 から 999 の範囲の数字。

  |これらのファイルが作成されるのは、エクスポートする表に LOB データが含まれている場合だけです。それらの LOB ファイルが作成される場合は、lobpath ディレクトリーに入れられます。LOB ファイルに使用できる名前は全部で 26 000 個あります。

  |system.msg

  |ファイルやディレクトリーの作成または削除コマンドに対するシステム・メッセージを含むメッセージ・ファイル。これが使用されるのは、アクションが EXPORT で、LOB パスが指定されている場合のみです。 |

  |

|IMPORT 使用時に必要なファイルと生成されるファイル: |

• |入力:

  |

  |db2move.lst

  |EXPORT アクションからの出力ファイル。

  |tabnnn.ixf

  |EXPORT アクションからの出力ファイル。

  |tabnnnc.yyy

  |EXPORT アクションからの出力ファイル。 |

• |出力:

  |

  |IMPORT.out

  |IMPORT アクションの結果の要約。

  |tabnnn.msg

  |対応する表のインポート・メッセージ・ファイル。 |

  |

|LOAD 使用時に必要なファイルと生成されるファイル: |

• |入力:

  |

  |db2move.lst

  |EXPORT アクションからの出力ファイル。

  |tabnnn.ixf

  |EXPORT アクションからの出力ファイル。

  |tabnnnc.yyy

  |EXPORT アクションからの出力ファイル。 |

• |出力:

  |

  |LOAD.out

  |LOAD アクションの結果の要約。

  |tabnnn.msg

  |対応する表のロード・メッセージ・ファイル。 |

  |