Stop-AzureSqlDatabaseCopy

Referência

Módulo:: Azure

Encerra uma relação de cópia contínua.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

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>]

Description

O cmdlet Stop-AzureSqlDatabaseCopy encerra uma relação de cópia contínua. Esse cmdlet interrompe a movimentação de dados entre o banco de dados de origem e o banco de dados secundário ou de destino e, em seguida, altera o estado do banco de dados secundário para ser um banco de dados online autônomo.

Há duas maneiras de encerrar um relacionamento de cópia contínua, rescisão ou término planejado e rescisão forçada com possível perda de dados. No servidor que hospeda o banco de dados de origem, você pode executar esse cmdlet no modo de término ou término forçado. No servidor que hospeda o banco de dados secundário, você deve usar o modo de encerramento forçado.

Um encerramento planejado aguarda até que todas as transações confirmadas no banco de dados de origem, no momento em que você executa o cmdlet, tenham sido replicadas para o banco de dados secundário. O encerramento forçado não aguarda a replicação de nenhuma transação confirmada pendente e pode causar possível perda de dados no banco de dados secundário.

Embora o status da replicação seja PENDING, somente o encerramento forçado pode encerrar com êxito uma relação de cópia contínua. Se o status de replicação for PENDING, não há suporte para o encerramento não forçado.

Exemplos

Exemplo 1: Encerrar uma relação de cópia contínua

PS C:\>Stop-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders" -PartnerServer "bk0b8kf658"

Esse comando encerra a relação de cópia contínua do banco de dados chamado Orders no servidor chamado lpqd0zbr8y. O servidor chamado bk0b8kf658 hospeda o banco de dados secundário.

Exemplo 2: Encerrar à força uma relação de cópia contínua

PS C:\>$DatabaseCopy = Get-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders"
PS C:\> $DatabaseCopy | Stop-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -ForcedTermination

O primeiro comando obtém a relação de cópia do banco de dados para o banco de dados chamado Orders no servidor chamado lpqd0zbr8y.

O segundo comando encerra forçosamente uma relação de cópia contínua do servidor que hospeda o banco de dados secundário.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Database

Especifica um objeto que representa o Banco de Dados SQL do Azure de origem. Esse cmdlet encerra a relação de cópia contínua do banco de dados especificado por esse parâmetro.

Type:	Database
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DatabaseCopy

Especifica um objeto que representa um banco de dados. Esse cmdlet encerra a relação de cópia contínua do banco de dados especificado por esse parâmetro. Esse parâmetro aceita entrada de pipeline.

Type:	DatabaseCopy
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DatabaseName

Especifica o nome de um banco de dados. Esse cmdlet encerra a relação de cópia contínua do banco de dados especificado por esse parâmetro.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForcedTermination

Indica que esse cmdlet causa o encerramento forçado da relação de cópia contínua. O encerramento forçado pode causar perda de dados. Para executar esse cmdlet em um servidor que hospeda o banco de dados de destino, você deve especificar esse parâmetro. Para executar esse cmdlet em um servidor que hospeda o banco de dados de origem, se o banco de dados secundário não estiver disponível, você deverá especificar esse parâmetro.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PartnerDatabase

Especifica o nome do banco de dados secundário. Se você especificar um nome, ele deverá corresponder ao nome do banco de dados de origem.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PartnerServer

Especifica o nome do servidor que hospeda o banco de dados de destino.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerName

Especifica o nome do servidor no qual o banco de dados de origem reside.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

Microsoft.WindowsAzure.Commands.SqlDatabase.Model.DatabaseCopy

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

Saídas

None

Observações

Autenticação: esse cmdlet requer autenticação baseada em certificado. Para obter um exemplo de como usar a autenticação baseada em certificado para definir a assinatura atual, consulte o cmdlet New-AzureSqlDatabaseServerContext .
Restrições: No servidor que hospeda o banco de dados secundário, somente o encerramento forçado é suportado.
Impacto da terminação no banco de dados secundário anterior: após o encerramento, o banco de dados secundário se torna um banco de dados independente. Se a propagação já tiver sido concluída no banco de dados secundário, após o término, esse banco de dados estará aberto para acesso total. Se o banco de dados de origem for um banco de dados de leitura-gravação, o banco de dados secundário anterior também se tornará um banco de dados de leitura-gravação.

Se a propagação estiver em andamento, a propagação será anulada e o banco de dados secundário anterior nunca ficará visível no servidor que hospeda o banco de dados secundário.
Você pode definir o banco de dados de origem para o modo somente leitura. Isso garante que os bancos de dados de origem e secundários sejam sincronizados após o término e garante que nenhuma transação seja confirmada durante o término. Quando a terminação terminar, defina a origem de volta para o modo de leitura-gravação. Opcionalmente, você também pode definir o banco de dados secundário anterior para o modo de leitura-gravação.
Monitoramento: para verificar o status das operações na origem e no destino da relação de cópia contínua, use o cmdlet Get-AzureSqlDatabaseOperation .