Stop-AzureSqlDatabaseCopy
連続コピーリレーションシップを終了します。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。
構文
Stop-AzureSqlDatabaseCopy
-ServerName <String>
-DatabaseCopy <DatabaseCopy>
[-ForcedTermination]
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-AzureSqlDatabaseCopy
-ServerName <String>
-Database <Database>
[-PartnerServer <String>]
[-PartnerDatabase <String>]
[-ForcedTermination]
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-AzureSqlDatabaseCopy
-ServerName <String>
-DatabaseName <String>
[-PartnerServer <String>]
[-PartnerDatabase <String>]
[-ForcedTermination]
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Stop-AzureSqlDatabaseCopy コマンドレットは、連続コピー関係を終了します。 このコマンドレットは、ソース データベースとセカンダリ データベースまたはターゲット データベースの間のデータ移動を停止し、セカンダリ データベースの状態をスタンドアロン オンライン データベースに変更します。
連続コピーリレーションシップを終了するには、終了または計画終了と強制終了の 2 つの方法があり、データ損失が発生する可能性があります。 ソース データベースをホストするサーバーで、このコマンドレットを終了モードまたは強制終了モードで実行できます。 セカンダリ データベースをホストするサーバーでは、強制終了モードを使用する必要があります。
計画終了は、コマンドレットを実行した時点で、ソース データベースでコミットされたすべてのトランザクションがセカンダリ データベースにレプリケートされるまで待機します。 強制終了は、未完了のコミット済みトランザクションのレプリケーションを待機せず、セカンダリ データベースでデータ損失の可能性があります。
レプリケーションの状態が保留中の間は、強制終了のみが正常に連続コピー関係を終了できます。 レプリケーションの状態が PENDING の場合、強制されていない終了はサポートされません。
例
例 1: 連続コピーリレーションシップを終了する
PS C:\>Stop-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders" -PartnerServer "bk0b8kf658"
このコマンドは、lpqd0zbr8y という名前のサーバー上の Orders という名前のデータベースの連続コピー関係を終了します。 bk0b8kf658 という名前のサーバーは、セカンダリ データベースをホストします。
例 2: 連続コピー関係を強制的に終了する
PS C:\>$DatabaseCopy = Get-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders"
PS C:\> $DatabaseCopy | Stop-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -ForcedTermination
最初のコマンドは、lpqd0zbr8y という名前のサーバー上の Orders という名前のデータベースのデータベース コピー関係を取得します。
2 番目のコマンドは、セカンダリ データベースをホストするサーバーから連続コピー関係を強制的に終了します。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Database
ソースの Azure SQL Database を表すオブジェクトを指定します。 このコマンドレットは、このパラメーターが指定するデータベースの連続コピー関係を終了します。
Type: | Database |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DatabaseCopy
データベースを表すオブジェクトを指定します。 このコマンドレットは、このパラメーターが指定するデータベースの連続コピー関係を終了します。 このパラメーターは、パイプライン入力を受け入れます。
Type: | DatabaseCopy |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DatabaseName
データベースの名前を指定します。 このコマンドレットは、このパラメーターが指定するデータベースの連続コピー関係を終了します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForcedTermination
このコマンドレットによって、連続コピー関係が強制終了されることを示します。 強制終了は、データ損失の原因となる可能性があります。 ターゲット データベースをホストするサーバーでこのコマンドレットを実行するには、このパラメーターを指定する必要があります。 ソース データベースをホストするサーバーでこのコマンドレットを実行するには、セカンダリ データベースが使用できない場合は、このパラメーターを指定する必要があります。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PartnerDatabase
セカンダリ データベースの名前を指定します。 名前を指定する場合は、ソース データベースの名前と一致する必要があります。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PartnerServer
ターゲット データベースをホストするサーバーの名前を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServerName
ソース データベースが存在するサーバーの名前を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
Microsoft.WindowsAzure.Commands.SqlDatabase.Model.DatabaseCopy
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database
出力
None
メモ
認証: このコマンドレットには、証明書ベースの認証が必要です。 証明書ベースの認証を使用して現在のサブスクリプションを設定する方法の例については、New-AzureSqlDatabaseServerContext コマンドレットを参照してください。
制限: セカンダリ データベースをホストするサーバーでは、強制終了のみがサポートされます。
以前のセカンダリ データベースに対する終了の影響: 終了後、セカンダリ データベースは独立したデータベースになります。 セカンダリ データベースでシード処理が既に完了している場合、終了後、このデータベースはフル アクセスで開きます。 ソース データベースが読み取り/書き込みデータベースの場合、以前のセカンダリ データベースも読み取り/書き込みデータベースになります。
シード処理が現在進行中の場合、シード処理は中止され、セカンダリ データベースをホストするサーバーに以前のセカンダリ データベースが表示されることはありません。
ソース データベースを読み取り専用モードに設定できます。 これにより、ソース データベースとセカンダリ データベースが終了後に同期され、終了中にトランザクションがコミットされていないことが保証されます。 終了が完了したら、ソースを読み取り/書き込みモードに戻します。 必要に応じて、以前のセカンダリ データベースを読み取り/書き込みモードに設定することもできます。
監視: 継続的コピー関係のソースとターゲットの両方で操作の状態を確認するには、Get-AzureSqlDatabaseOperation コマンドレットを使用します。