dmstartmirror - ミラーリングの開始

CDC Replication ソースからこのコマンドを発行して、指定されたサブスクリプションでミラーリングを開始します。 このコマンドは、レプリケーション方式が「ミラーリング」で、「リフレッシュ」または「アクティブ」状況にある表のミラーリングを開始します。 レプリケーション方式が「ミラーリング」で状況が「リフレッシュ」の表は、ミラーリングを開始する前にリフレッシュされます。

CDC Replication は、ターゲット表にマップされるソース表に対して、連続 (-c パラメーター) とスケジュール・エンド (変更分) (-n パラメーター) の 2 つのタイプのミラーリングを提供します。 選択するミラーリング・タイプは、ビジネス・ニーズによって決まります。

名前が示すとおり、「継続」タイプのミラーリングはターゲットの変更を継続的に複製します。 このタイプのミラーリングは、ビジネス要件によりレプリケーションを継続的に実行する必要があり、現時点でレプリケーションを終了する明確な理由がない場合に使用します。

「スケジュールされた終了 (変更分)」タイプのミラーリングは、変更 (ターゲットに対する) をソース・データベース・ログ内のユーザー指定の時点まで複製した後にレプリケーションを終了します。 このタイプのミラーリングは、ビジネス要件により、データを定期的に複製するだけでよく、レプリケーションの終了時にターゲット・データベースの状態に対する明確なエンドポイントがある場合に使用します。 「スケジュールされた終了 (変更分)」タイプのミラーリングでは、ソース・データベース・ログの以下の時点でレプリケーションを終了できます。
-n パラメーター
–t または –p と同時に指定しない場合は、ソース・データベース・ログの現在時刻でレプリケーションを終了します。
-t パラメーター
–n と同時に指定すると、 ユーザー指定の日時にレプリケーションを終了します。
-p パラメーター
–n と同時に指定すると、 ユーザー指定のログ位置でレプリケーションを終了します。

これらのユーザー指定のエンドポイントにより、 レプリケーション終了時にはターゲット・データベースが既知の状態になっていることが保証されます。

管理コンソールでレプリケーションを開始および終了することもできます。 詳しくは、 レプリケーションの開始と終了を参照してください。

構文

dmstartmirror [-I <name>] [-c|-n [-t <timestamp>|-p 
<log position>] [-w|-nw]]  -A|-s <subscription ...> [-L <locale>]

パラメーター

[-I < 名>]
ミラーリングを開始する CDC Replication インスタンスを指定します。 あるいは、この値の代わりに TSINSTANCE 環境変数を指定することもできます。
[-c]
CDC Replication が、指定されたサブスクリプションで継続ミラーリングを開始することを指定します。
–c または -nを指定しない場合、 CDC Replication は、指定されたサブスクリプションでデフォルトで継続ミラーリングを開始します。
[-n]
CDC Replication が、ソース・データベースのすべてのコミット済みデータベース変更をミラーリングし、その後、「スケジュール・エンド」オプションを使用してデータベース・ログの現在のソース・システム時刻でレプリケーションを正常に終了することを指定します。 レプリケーションが終了するソース・システム時間は、ユーザーがこのコマンドを発行するときに設定されます。
–nで以下のパラメーターを指定すると、レプリケーションは特定の日時またはログ位置で終了します。
[–t]
ソース・データベース・ログの特定の日時にレプリケーションを終了します。
[–p]
ソース・データベース・ログ内の特定のログ位置でレプリケーションを終了します。
注: ソースとターゲットの間の待ち時間が長くなるにつれて、レプリケーションを終了するために必要な時間も長くなります。
[-t < タイム・スタンプ>]
–n を使用する場合に、レプリケーションが終了するソース・データベース・ログ内の日時を指定します。 このパラメーターに値を指定する場合は、 yyyy-MM-dd HH:mm の形式を使用します。
–n を指定している場合、このパラメーターはオプションです。
[-w]
–n を使用する場合、このコマンドでレプリケーションが終了するのを待機します。 –w は、レプリケーションの「スケジュール・エンド」のデフォルト設定です。
このパラメーターを指定してコマンドのスクリプトを記述すると、スクリプトは -n の処理が完了するのを待ってから実行を続ける必要があります。
このパラメーターは、「継続」ミラーリングで –c を指定した場合には適用されません。
[-nw]
–n を指定しても、このコマンドを実行するとレプリケーションの終了を待機しません。 このコマンドのスクリプトを記述する場合、このパラメーターを指定すると、–n の処理が完了しなくても、スクリプトは実行を続けます (非同期)。
このパラメーターは、「継続」ミラーリングで –c を指定した場合には適用されません。
-A
CDC Replication がすべてのサブスクリプションのミラーリングを開始することを示します。
1 つ以上のサブスクリプションでミラーリングを開始する場合は、–s を使用してください。
-s < サブスクリプション ...>
CDC Replication がミラーリングを開始するサブスクリプションを示します。 複数のサブスクリプションを指定するには、サブスクリプションをスペースで区切って指定してください。 例えば、次のとおりです。Subscription1 Subscription2 Subscription3
このパラメーターに値を指定するか、–A を使用してすべてのサブスクリプションを指定する必要があります。
[-L < ロケール>]
CDC Replication インスタンスに使用されるロケールの名前。 デフォルトは、 CDC Replication がインストールされているマシンのロケールです。

結果

このコマンドは、成功した場合に 0 の値を戻し、失敗した場合に 0 以外の値を戻します。

例

dmstartmirror -I MYINSTANCE -c -s FINANCE

CDC Replication は、FINANCE サブスクリプションの継続ミラーリングを開始します。

dmstartmirror -I MYINSTANCE –n –p 000000FB:000001A4:0001 –nw –A

CDC Replication は、指定されたインスタンス内のすべてのサブスクリプションに対して、「スケジュール・エンド」オプションを使用してミラーリングを開始します。 レプリケーションは、ソース・データベース・ログ内の指定された Microsoft SQL Server LSN で終了します。 このコマンドは、「スケジュールされた終了 (変更分)」の処理が完了するまで待ちません。

dmstartmirror -I MYINSTANCE –n –t 2010-02-05-00-00 FINANCE -nw

CDC Replication は、MYINSTANCE インスタンス内の FINANCE サブスクリプションに対して、「スケジュール・エンド」オプションを使用してミラーリングを開始します。 レプリケーションは、ソース・データベース・ログの指定された時刻に終了します。 このコマンドは、「スケジュール・エンド」の処理が完了する前に終了します。