Stop-AzureSqlDatabaseCopy
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 do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.
O módulo Az PowerShell é o módulo PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.
Sintaxe
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.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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.
Tipo: | Database |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | 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.
Tipo: | DatabaseCopy |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | 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.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Force
Força o comando a ser executado sem pedir a confirmação do usuário.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-PartnerServer
Especifica o nome do servidor que hospeda o banco de dados de destino.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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.
Tipo: | AzureSMProfile |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ServerName
Especifica o nome do servidor no qual o banco de dados de origem reside.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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 .