Stop-AzureSqlDatabaseCopy

  • リファレンス
モジュール:
Azure

連続コピーリレーションシップを終了します。

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、Azure Service Manager の提供終了に関するページを参照してください。

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するために推奨される 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

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Database

ソースの Azure SQL Database を表すオブジェクトを指定します。 このコマンドレットは、このパラメーターが指定するデータベースの連続コピー関係を終了します。

型:Database
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DatabaseCopy

データベースを表すオブジェクトを指定します。 このコマンドレットは、このパラメーターが指定するデータベースの連続コピー関係を終了します。 このパラメーターは、パイプライン入力を受け入れます。

型:DatabaseCopy
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DatabaseName

データベースの名前を指定します。 このコマンドレットは、このパラメーターが指定するデータベースの連続コピー関係を終了します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForcedTermination

このコマンドレットによって、連続コピー関係が強制終了されることを示します。 強制終了は、データ損失の原因となる可能性があります。 ターゲット データベースをホストするサーバーでこのコマンドレットを実行するには、このパラメーターを指定する必要があります。 ソース データベースをホストするサーバーでこのコマンドレットを実行するには、セカンダリ データベースが使用できない場合は、このパラメーターを指定する必要があります。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PartnerDatabase

セカンダリ データベースの名前を指定します。 名前を指定する場合は、ソース データベースの名前と一致する必要があります。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PartnerServer

ターゲット データベースをホストするサーバーの名前を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

型:AzureSMProfile
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServerName

ソース データベースが存在するサーバーの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.WindowsAzure.Commands.SqlDatabase.Model.DatabaseCopy

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database

出力

None

メモ

  • 認証: このコマンドレットには、証明書ベースの認証が必要です。 証明書ベースの認証を使用して現在のサブスクリプションを設定する方法の例については、New-AzureSqlDatabaseServerContext コマンドレットを参照してください。

  • 制限: セカンダリ データベースをホストするサーバーでは、強制終了のみがサポートされます。

  • 以前のセカンダリ データベースに対する終了の影響: 終了後、セカンダリ データベースは独立したデータベースになります。 セカンダリ データベースでシード処理が既に完了している場合、終了後、このデータベースはフル アクセスで開きます。 ソース データベースが読み取り/書き込みデータベースの場合、以前のセカンダリ データベースも読み取り/書き込みデータベースになります。

    シード処理が現在進行中の場合、シード処理は中止され、セカンダリ データベースをホストするサーバーに以前のセカンダリ データベースが表示されることはありません。

  • ソース データベースを読み取り専用モードに設定できます。 これにより、ソース データベースとセカンダリ データベースが終了後に同期され、終了中にトランザクションがコミットされていないことが保証されます。 終了が完了したら、ソースを読み取り/書き込みモードに戻します。 必要に応じて、以前のセカンダリ データベースを読み取り/書き込みモードに設定することもできます。

  • 監視: 継続的コピー関係のソースとターゲットの両方で操作の状態を確認するには、Get-AzureSqlDatabaseOperation コマンドレットを使用します。