Stop-AzureSqlDatabaseCopy
Encerra uma relação de cópia contínua.
Observação
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 herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.
O módulo Az PowerShell é o módulo do 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 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" -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ç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.
| 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 entrada de 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. 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.
| 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 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.
| 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, 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 .