Stop-AzureSqlDatabaseCopy
Encerra uma relação de cópia contínua.
Observação
Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.
O módulo do Az PowerShell é o módulo recomendado do PowerShell 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 uma relação de cópia contínua, rescisão ou rescisão planejada 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 encerramento ou encerramento 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 de 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 haverá suporte para o encerramento que não for 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" -ForcedTerminationO 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ça 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.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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.
| Tipo: | Database |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | 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 a entrada do pipeline.
| Tipo: | DatabaseCopy |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | 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.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Force
Força o comando a ser executado sem solicitar a confirmação do usuário.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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, você deverá especificar esse parâmetro.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PartnerServer
Especifica o nome do servidor que hospeda o banco de dados de destino.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Profile
Especifica o perfil do Azure do qual esse cmdlet é lido. Se você não especificar um perfil, esse cmdlet lerá o perfil padrão local.
| Tipo: | AzureSMProfile |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ServerName
Especifica o nome do servidor no qual o banco de dados de origem reside.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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, há suporte apenas para o encerramento forçado.
Impacto do encerramento 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 será 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 no momento, 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 encerramento e garante que nenhuma transação seja confirmada durante o encerramento. Quando o encerramento 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 .