サンプルのコンソール スクリプト ファイルの操作 (DB2ToSQL)

いくつかのサンプル ファイルが、ユーザー参照と使用方法の製品と共に提供されています。 このセクションでは、エンド ユーザーのニーズに合わせてこれらのスクリプトを簡単にカスタマイズする方法について説明します。

サンプルのコンソール スクリプト ファイル

さまざまなシナリオをカバーする次のサンプル コンソール スクリプト ファイルが、ユーザー参照用に提供されています :

• ServersConnectionFileSample.xml

• VariableValueFileSample.xml

• AssessmentReportGenerationSample.xml

• SqlStatementConversionSample.xml

• ConversionAndDataMigrationSample.xml

1. ServersConnectionFileSample.xml:

   • このサンプルでは、ソース データベースとターゲット データベースで使用できるさまざまな接続モードが提供され、ユーザーは要件に従って任意のモードを選択できます。 このサンプルには、サーバー定義が含まれています。

   • ユーザーは、必要なソースとターゲット サーバー定義に値を変更するだけで、必要なデータベースに接続できます。 この例では、 VariableValueFileSample.xml で使用できる変数値としてすべての値が提供されています。 他のすべての接続パラメーターは、ユーザーの作業サーバー接続ファイルから削除できます。

   • ソースとターゲット サーバーへの接続の詳細については、サーバー接続ファイルの作成 (DB2ToSQL) を参照してください。

2. VariableValueFileSample.xml： サンプルコンソールスクリプトファイルとServersConnectionFileSample.xmlで使用した全ての変数をまとめたファイル。 サンプル コンソール スクリプトを実行するには、サンプル変数の値をユーザー定義の値に置き換え、スクリプト ファイルと共に追加のコマンド ライン引数としてこのファイルを渡す必要があります。

   変数値ファイルの詳細については、「変数値ファイルの作成 (DB2ToSQL)」を参照してください。

3. AssessmentReportGenerationSample.xml: このサンプルでは、データの変換と移行を開始する前に、ユーザーが分析に使用できる xml 評価レポートを生成できます。

   generate-assessment-reportコマンドの中で、ユーザーはobject-name属性の変数値（VariableValueFileSample.xmlを参照）を、ユーザーが使用しているデータベース名に強制的に変更しなければならない。 指定されたオブジェクトの種類に応じて、 object-type 値も変更する必要があります。

   ユーザーが複数のオブジェクト/データベースを評価する必要がある場合は、サンプル コンソール スクリプト ファイルのgenerate-assessment-reportコマンドの例 4 に示すように、複数のmetabase-objectノードを指定できます。

   レポートの生成の詳細については、レポートの生成 (DB2ToSQL) を参照してください。

   注:

   変数値ファイルのコマンド ライン引数がコンソール アプリに渡され、VariableValueFileSample.xml がユーザー指定の値で更新されていることを確認します。

   サーバー接続ファイルのコマンド ライン引数がコンソール アプリに渡され、ServersConnectionFileSample.xml が正しいサーバー パラメーター値で更新されていることを確認します。

4. SqlStatementConversionSample.xml: このサンプルを使用すると、ユーザーは入力として指定されたソース データベース sql コマンドに対応する t-sql スクリプトを生成できます。

   convert-sql-statement コマンドでは、ユーザーは context 属性の変数値 (VariableValueFileSample.xml を参照) を、ユーザーが使用中のデータベース名に強制的に変更する必要があります。 また、ユーザーは、sql属性値を、変換する必要があるソース データベースsqlコマンドに変更する必要があります。

   ユーザーは、変換する SQL ファイルを指定することもできます。 これは、サンプル コンソール スクリプト ファイルのconvert-sql-statementコマンドの例 4 に示されています。

   注意

   変数値ファイルのコマンド ライン引数がコンソール アプリに渡され、VariableValueFileSample.xml がユーザー指定の値で更新されていることを確認します。

5. ConversionAndDataMigrationSample.xml: このサンプルを使用すると、ユーザーは変換からデータ移行へのエンドツーエンドの移行を実行できます。 変更する必要がある属性値の一覧は次の通りです:

   コマンド名	説明	属性
   map-schema	ソース データベースからターゲット スキーマへのスキーマ マッピング。	source-schema: は変換が必要なソース データベースを指定します。 sql-server-schema: 移行先のターゲット データベースを指定します。
   convert-schema	ソースからターゲット スキーマへのスキーマ変換を実行します。 ユーザーが複数のオブジェクト/データベースを評価する必要がある場合は、サンプル コンソール スクリプト ファイルのconvert-schemaコマンドの例 4 に示されているように、複数のmetabase-objectノードを指定できます。	object-name: 変換する必要があるソース データベース/オブジェクト名を指定します。 object-type で指定されているオブジェクトの種類に基づいて対応する object-name が変更されていることを確認します。
   synchronize-target	ターゲット オブジェクトをターゲット データベースと同期します。 ユーザーが複数のオブジェクト/データベースを評価する必要がある場合は、サンプル コンソール スクリプト ファイルのsynchronize-targetコマンドの例 3 に示されているように、複数のmetabase-objectノードを指定できます。	object-name:は作成する必要がある SQL Server データベース/オブジェクト名を指定します。 object-type で指定されているオブジェクトの種類に基づいて対応する object-name が変更されていることを確認します。
   migrate-data	ソースからターゲットにデータを移行します。 ユーザーが複数のオブジェクト/データベースを評価する必要がある場合は、サンプル コンソール スクリプト ファイルのmigrate-dataコマンドの例 2 に示されているように、複数のmetabase-objectノードを指定できます。	object-name: は移行する必要があるソース データベース/テーブル名を指定します。 object-type で指定されているオブジェクトの種類に基づいて対応する object-name が変更されていることを確認します。

参照

変数値ファイルの作成 (DB2ToSQL)
サーバー接続ファイルの作成 (DB2ToSQL)
レポートの生成 (DB2ToSQL)