Partilhar via

Stop-AzureSqlDatabaseCopy

  • Referência
Módulo:
Azure

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

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Consulte o módulo Az PowerShell para cmdlets para 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 término forçado com possível perda de dados. No servidor que hospeda o banco de dados de origem, você pode executar esse cmdlet no modo de terminação ou terminação forçada. No servidor que hospeda o banco de dados secundário, você deve usar o modo de terminação forçada.

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. A rescisão forçada não aguarda a replicação de quaisquer transações confirmadas pendentes e pode causar possível perda de dados no banco de dados secundário.

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

Exemplos

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

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

Este 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 a 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. Este 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. Este cmdlet encerra a relação de cópia contínua do banco de dados especificado por esse parâmetro. Este parâmetro aceita a entrada do 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. Este 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 pedir 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. A rescisão forçada 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, especifique 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 é lido. 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

Apresenta o que aconteceria mediante a execução do cmdlet. 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

Notas

  • Autenticação: este 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, apenas o encerramento forçado é suportado.

  • Impacto da rescisã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 atualmente em andamento, a propagação será abortada 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 a rescisão e garante que nenhuma transação seja confirmada durante a rescisão. Quando a terminação terminar, defina a fonte 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 .