サンプル コンソール スクリプト ファイルの操作 SSMA コンソールを実行する (AccessToSQL)
ユーザーが参照したり使用したりできるように、製品とともにいくつかのサンプル ファイルが提供されています。 このセクションでは、エンド ユーザーのニーズに合わせてこれらのスクリプトを簡単にカスタマイズする方法について説明します。
コンソール スクリプト ファイルのサンプル
ユーザーの参照用に、さまざまなシナリオをカバーする次のサンプル コンソール スクリプト ファイルが提供されています。
ServersConnectionFileSample.xml
VariableValueFileSample.xml
AssessmentReportGenerationSample.xml
ConversionAndDataMigrationSample.xml
ServersConnectionFileSample.xml:
このサンプルでは、ソース データベースとターゲット データベースで使用できるさまざまな接続モードが提供され、ユーザーは要件に従って任意のモードを選択できます。 このサンプルには、サーバー定義が含まれています。
ユーザーは、必要なソースおよびターゲット サーバー定義に値を変更するだけで、必要なデータベースに接続できます。 この例では、すべての値が VariableValueFileSample.xml で使用できる変数値として提供されています。 他のすべての接続パラメーターは、ユーザーの作業サーバーの接続ファイルから削除できます。
ソース サーバーとターゲット サーバーへの接続の詳細については、「サーバー接続ファイルの作成 (AccessToSQL)」を参照してください。
VariableValueFileSample.xml: サンプルのコンソール スクリプト ファイルで使用され、
ServersConnectionFileSample.xml
このファイルで照合されたすべての変数。 サンプルのコンソール スクリプトを実行するには、サンプル変数の値をユーザー定義の値に置き換え、スクリプト ファイルと共に追加のコマンド ライン引数としてこのファイルを渡す必要があります。変数値ファイルの詳細については、「変数値ファイルの作成 (AccessToSQL)」を参照してください。
AssessmentReportGenerationSample.xml: このサンプルでは、データの変換と移行を開始する前に、ユーザー解析に使用できる XML 評価レポートを生成できます。
generate-assessment-report
コマンドでは、ユーザーはobject-name
属性の変数値 (VariableValueFileSample.xml を参照) を、ユーザーが使用中のデータベース名に強制的に変更する必要があります。 指定されたオブジェクトの種類に応じて、object-type
値も変更する必要があります。ユーザーが複数のオブジェクト/データベースを評価する必要がある場合は、サンプルのコンソール スクリプト ファイルの
generate-assessment-report
コマンドの例 4 に示すように、複数のmetabase-object
ノードを指定できます。レポートの生成の詳細については、「レポートの生成 (AccessToSQL)」を参照してください。
注意
- 変数値ファイルのコマンド ライン引数がコンソール アプリケーションに渡され、VariableValueFileSample.xml がユーザー指定の値で更新されていることを確認します。
- サーバー接続ファイルのコマンド ライン引数がコンソール アプリケーションに渡され、ServersConnectionFileSample.xml が正しいサーバー パラメーター値で更新されていることを確認します。
ConversionAndDataMigrationSample.xml: このサンプルを使用すると、変換からデータ移行まで、エンドツーエンドの移行を実行できます。 変更する必要がある必須の属性値の一覧を次に示します。
コマンド名 説明 属性 map-schema
ソース データベースからターゲット スキーマへのスキーマ マッピング。 source-schema:
変換が必要なソース データベースを指定します。sql-server-schema
: 移行先のターゲット データベースを指定しますconvert-schema
ソースからターゲット スキーマへのスキーマ変換を実行します。
ユーザーが複数のオブジェクト/データベースを評価する必要がある場合は、サンプルのコンソール スクリプト ファイルのconvert-schema
コマンドの例 4 に示すように、複数のmetabase-object
ノードを指定できます。object-name
: 変換する必要があるソース データベース/オブジェクト名を指定します。object-name
で指定されているオブジェクトの型に基づいて対応するobject-type
が 変更されていることを確認します。synchronize-target
ターゲット オブジェクトをターゲット データベースと同期します。
ユーザーが複数のオブジェクト/データベースを評価する必要がある場合は、サンプルのコンソール スクリプト ファイルのsynchronize-target
コマンドの例 3 に示すように、複数のmetabase-object
ノードを指定できます。object-name:
作成する必要がある SQL Server データベース/オブジェクト名を指定します。object-name
で指定されているオブジェクトの型に基づいて対応するobject-type
が 変更されていることを確認します。migrate-data
ソースからターゲットにデータを移行します。
ユーザーが複数のオブジェクト/データベースを評価する必要がある場合は、サンプルのコンソール スクリプト ファイルのmigrate-data
コマンドの例 2 に示すように、複数のmetabase-object
ノードを指定できます。object-name:
移行する必要があるソース データベース/テーブル名を指定します。object-name
で指定されているオブジェクトの型に基づいて対応するobject-type
が 変更されていることを確認します。
参照
変数値ファイルの作成 (AccessToSQL)
サーバー接続ファイルの作成 (AccessToSQL)
レポートの生成 (AccessToSQL)