ステージ・コピー・ユーティリティー (CPYWCSSTG) (OS/400 for iSeries)

ステージ・コピー・ユーティリティー、あるいは CPYWCSSTG コマンドは、 データを実動データベースからステージング・データベースにコピーします。 サイト関連テーブル、マーチャント関連テーブル、または個々のテーブルのデータをコピーすることができます。 また、CLEANUP パラメーターを使用して、ステージ・コピー・ユーティリティーの前にステージング・データベースをクリーンアップすることもできます。 *YES を指定すると、ステージ・コピー・ユーティリティーは、コピーの前にすべてのステージング・テーブルをクリーンアップします。 ただしその場合、削除カスケードによって他のテーブルが影響を受ける可能性があります。 *NO を指定すると、ステージ・コピー・ユーティリティーは、ステージング・テーブルから何も削除しません。 データのコピーが原因で 1 次キーまたは固有索引に競合や重複が発生した場合は、コピーが失敗することもあります。 ステージ・コピー・ユーティリティーを使用してステージング・データベースをクリーンアップするには、 *ONLY を指定してください。

ステージ・コピー・ユーティリティーとステージ伝搬ユーティリティーは、データベース・データを、サイト関連とマーチャント関連の 2 つの有効範囲レベルに分けます。 サイト有効範囲には、システムのすべてマーチャントに共通のデータが含まれます。 システムが使用する言語や国または地域別コードがその一例です。 マーチャントの有効範囲には、個々のマーチャントと関連しているデータが含まれます。 たとえば、ストア情報は個々のマーチャント用にカスタマイズされ、ストア・テーブルからの行は、マーチャントごとに固有です。 サイトとマーチャントの両方の情報を収めたデータベース・テーブルもあります。 ステージ・コピー・ユーティリティーの実行時に SCOPE パラメーターを _all_ に指定すると、 サイト・データがコピーされ、それに続いてすべてのマーチャント・データがコピーされます。 有効範囲を _site_ に指定すると、サイト・データだけがコピーされます。 有効範囲を _merchant_ に指定すると、マーチャント・データだけがコピーされます。 マーチャントすべてのデータだけで個々のマーチャントのデータはコピーできないことに注意してください。 有効範囲を _all_ に設定していない場合には、サイト・データはすべてのマーチャントが使用するので、マーチャント・データの前にサイト・データをコピーしてください。 そうでない場合には、外部キーと基本キーのミスマッチが原因で、コピーは失敗します。 CLEANUP を使用してサイト・データをクリーンアップする場合には、削除カスケードが原因でマーチャント・データが削除される可能性があることに注意してください。 有効範囲を _all_ に設定していない場合は、マーチャント・データとそれに続けてサイト・データをクリーンアップしてから、サイト・データとそれに続けてマーチャント・データをコピーしてください。

トランザクション有効範囲の理解が重要になります。 ステージング・データベースをクリーンアップするとき、ステージ・コピー・ユーティリティーは、各テーブルをクリーンアップした後でトランザクションをコミットします。 データをコピーすると、ステージ・コピー・ユーティリティーは各テーブルを コピーして KEYS テーブルを同期した後で、トランザクションをコミットします。

クリーンアップまたはコピーするテーブルは、DBTABLE パラメーターを使用して指定できます。 クリーンアップするかコピーするテーブルを指定するときに、テーブルが分離されていない場合があることに注意してください。 いくつかのテーブルは、参照制約によって互いに関連しています。 指定したテーブルをクリーンアップすると、削除のカスケードによって、子テーブルもクリーンアップすることになります。 指定したテーブルをコピーする場合には、最初に親テーブルをコピーする必要があります。 そうでない場合には、クリーンアップまたはコピーは失敗します。

ステージ・コピー・ユーティリティーは構成可能で、拡張可能です。 カスタマイズ済みのテーブルを処理するには、そのテーブルが満たしていなければならない条件が幾つかあり、 ステージング構成テーブルでセットアップしなければなりません。 詳細は、カスタマイズされたテーブルのためのステージング・サーバーの構成を参照してください。 ステージ・コピー・ユーティリティーを使用する場合、 事前にデータベースの構成のステップを行う必要があります。 コマンドの実行が正常に完了すると、ステージ・コピー・ユーティリティーは、 STAGLOG データベース・テーブルからレコードをすべて削除します。

注: システム上に RFQ がある場合、ステージ・コピー・コマンドは使えません。 詳細は、ステージング・サーバーの制限事項を参照してください。

関連概念

関連タスク

関連参照

IBM 著作権