Espelhamento de banco de dados de ALTER DATABASE (Transact-SQL)

Aplica-se: SQL Server

Controla o espelhamento de um banco de dados. Valores especificados com as opções de espelhamento de banco de dados aplicam-se a ambas as cópias do banco de dados e à sessão de espelhamento de banco de dados como um todo. Apenas um <database_mirroring_option> é permitido por instrução ALTER DATABASE.

Para conhecer as opções de ALTER DATABASE, consulte ALTER DATABASE. Para conhecer as opções de ALTER DATABASE SET, consulte Opções de ALTER DATABASE SET.

Convenções de sintaxe de Transact-SQL

Sintaxe

ALTER DATABASE database_name
SET { <partner_option> | <witness_option> }
  <partner_option> ::=
    PARTNER { = 'partner_server'
            | FAILOVER
            | FORCE_SERVICE_ALLOW_DATA_LOSS
            | OFF
            | RESUME
            | SAFETY { FULL | OFF }
            | SUSPEND
            | TIMEOUT integer
            }
  <witness_option> ::=
    WITNESS { = 'witness_server'
            | OFF
            }
  

Argumentos

database_name É o nome do banco de dados a ser modificado.

PARTNER <partner_option> Controla as propriedades de banco de dados que definem os parceiros de failover de uma sessão de espelhamento de banco de dados e seu comportamento. Algumas opções de SET PARTNER podem ser definidas em qualquer parceiro; outros se restringem ao servidor principal ou ao servidor espelho. Para obter mais informações, consulte as opções individuais de PARTNER a seguir. Uma cláusula SET PARTNER afeta ambas as cópias do banco de dados, independentemente do parceiro no qual é especificada.

Para executar uma instrução SET PARTNER, o STATE dos pontos de extremidade de ambos os parceiros deve ser definido como STARTED. Note, também, que o ROLE do ponto de extremidade do espelhamento de banco de dados de cada instância de servidor parceiro deve ser definido como PARTNER ou ALL. Para obter informações sobre como especificar um ponto de extremidade, consulte Criar um ponto de extremidade de espelhamento de banco de dados para a Autenticação do Windows. Para conhecer a função e o estado do ponto de extremidade do espelhamento de banco de dados de uma instância de servidor, naquela instância, use a seguinte instrução Transact-SQL:

SELECT role_desc, state_desc FROM sys.database_mirroring_endpoints

<partner_option> ::=

' partner_server ' Especifica o endereço de rede do servidor de uma instância do SQL Server para atuar como um parceiro de failover em uma nova sessão de espelhamento de banco de dados. Cada sessão requer dois parceiros: um começa como servidor principal e o outro, como servidor espelho. Recomendamos que estes parceiros residam em computadores diferentes.

Esta opção é especificada uma vez por sessão em cada parceiro. A inicialização de uma sessão de espelhamento de banco de dados exige duas instruções ALTER DATABASE database SET PARTNER ='partner_server' . A ordem delas é significativa. Primeiro, conecte ao servidor espelho e especifique a instância de servidor principal como partner_server (SET PARTNER ='principal_server' ). Em segundo lugar, conecte-se ao servidor principal e especifique a instância de servidor espelho como partner_server (SET PARTNER ='mirror_server' ); isto inicia uma sessão de espelhamento de banco de dados entre esses dois parceiros. Para obter mais informações, consulte Configurando o espelhamento de banco de dados.

O valor de partner_server é um endereço de rede do servidor. Tem a seguinte sintaxe:

TCP**://<system-address>:**<port>

onde

• <system-address> é uma cadeia de caracteres, como um nome do sistema, um nome de domínio totalmente qualificado ou um endereço IP, que identifica de forma exclusiva o sistema do computador de destino.
• <port> é um número de porta associado ao ponto de extremidade de espelhamento da instância de servidor parceiro.

Para obter mais informações, consulte Especificar um endereço de rede do servidor – espelhamento de banco de dados.

O seguinte exemplo ilustra a cláusulaSET PARTNER ='partner_server' :

'TCP://MYSERVER.mydomain.Adventure-Works.com:7777'

FAILOVER Efetua failover do servidor principal manualmente para o servidor espelho. É possível especificar FAILOVER apenas no servidor principal. Esta opção só será válida quando a configuração SAFETY for FULL (o padrão).

A opção FAILOVER exige master como o contexto de banco de dados.

FORCE_SERVICE_ALLOW_DATA_LOSS Força o serviço de banco de dados no banco de dados espelho depois que o servidor principal falha com o banco de dados em estado não sincronizado ou em estado sincronizado quando não ocorre failover automático.

É extremamente recomendável que você só force o serviço se o servidor principal não estiver mais em execução. Caso contrário, alguns clientes poderão continuar acessando o banco de dados principal original, em vez do novo banco de dados principal. FORCE_SERVICE_ALLOW_DATA_LOSS só está disponível no servidor espelho e apenas sob as seguintes condições:

• O servidor principal está fora de operação.
• WITNESS está definido como OFF ou a testemunha está conectada ao servidor espelho.

Force o serviço apenas se você estiver disposto a arriscar perder alguns dados para restaurar imediatamente o serviço no banco de dados.

Forçar serviço suspende a sessão, preservando todos os dados temporariamente no banco de dados principal original. Uma vez que o banco de dados principal original estiver em serviço e conseguir se comunicar com o novo servidor principal, o administrador do banco de dados poderá retomar o serviço. Quando a sessão retomar, todos os registros de log não enviado e suas atualizações correspondentes serão perdidos.

OFF Remove uma sessão de espelhamento de banco de dados e o espelhamento de banco de dados. Você pode especificar OFF em qualquer parceiro. Para obter informações sobre o impacto da remoção do espelhamento, consulte Removendo o espelhamento de banco de dados.

RESUME Retoma uma sessão de espelhamento de banco de dados suspensa. É possível especificar RESUME apenas no servidor principal.

SAFETY { FULL | OFF } Define o nível de segurança da transação. É possível especificar SAFETY apenas no servidor principal.

O padrão é FULL. Com segurança total, a sessão de espelhamento de banco de dados é executada de maneira síncrona (em modo de segurança alta). Se SAFETY for definido como OFF, a sessão de espelhamento de banco de dados será executada de forma assíncrona (em modo de alto desempenho).

O comportamento do modo de alta segurança depende, em parte, da testemunha, como segue:

• Quando a segurança é definida como FULL e uma testemunha é definida para a sessão, esta é executada em modo de alta segurança com failover automático. Quando o servidor principal for perdido, a sessão terá failover automaticamente se o banco de dados for sincronizado e a instância de servidor espelho e a testemunha ainda estiverem conectadas entre si (ou seja, tiverem quorum). Para obter mais informações, confira Quorum: como uma testemunha afeta a disponibilidade do banco de dados – Espelhamento de banco de dados.

  Se uma testemunha for definida para a sessão, mas estiver atualmente desconectada, a perda do servidor espelho fará com que o servidor principal caia.

• Quando a segurança está definida como FULL e a testemunha está definida como OFF, a sessão é executada em modo de alta segurança sem failover automático. Se a instância de servidor espelho cair, a instância de servidor principal não será afetada. Se a instância de servidor principal cair, você poderá forçar o serviço (com possível perda de dados) na instância de servidor espelho.

• Se SAFETY estiver definido como OFF, a sessão será executada em modo de alto desempenho e não haverá suporte para failover automático ou manual. Porém, problemas no espelho não afetam o principal e, se a instância de servidor principal cair, você poderá, se necessário, forçar o serviço (com possível perda de dados) na instância de servidor espelho – se WITNESS estiver definido como OFF ou a testemunha estiver conectada atualmente ao espelho. Para obter mais informações sobre como forçar o serviço, consulte "FORCE_SERVICE_ALLOW_DATA_LOSS" anteriormente, nesta seção.

SUSPEND Pausa uma sessão de espelhamento de banco de dados.

Você pode especificar SUSPEND em qualquer parceiro.

TIMEOUT integer Especifica o tempo limite, em segundos. O tempo limite é o tempo máximo que uma instância de servidor espera para receber uma mensagem PING de outra instância na sessão de espelhamento antes de considerá-la desconectada.

Você só pode especificar a opção TIMEOUT no servidor principal. Se você não especificar essa opção, por padrão, o período de tempo será de 10 segundos. Se você especificar 5 ou mais, o tempo limite será definido como o número de segundos especificado. Se você especificar um valor de tempo limite de 0 a 4 segundos, o período será definido automaticamente como 5 segundos.

Para obter mais informações, veja Possíveis falhas durante o espelhamento de banco de dados.

WITNESS <witness_option> Controla as propriedades de banco de dados que definem uma testemunha de espelhamento de banco de dados. Uma cláusula SET WITNESS afeta ambas as cópias do banco de dados, mas você só pode especificar SET WITNESS no servidor principal. Se uma testemunha for definida para uma sessão, será exigido quorum para atender ao banco de dados, independentemente da configuração de SAFETY. Para obter mais informações, confira Quorum: como uma testemunha afeta a disponibilidade do banco de dados – Espelhamento de banco de dados.

Recomendamos que a testemunha e os parceiros de failover residam em computadores separados. Para obter informações sobre a testemunha, consulte Testemunha de espelhamento de banco de dados.

Para executar uma instrução SET WITNESS, o STATE dos pontos de extremidade das instâncias do servidor testemunha e principal deve ser definido como STARTED. Observe, também, que o ROLE do ponto de extremidade do espelhamento de banco de dados de uma instância de servidor testemunha deve ser definido como WITNESS ou ALL. Para obter informações sobre como especificar um ponto de extremidade, consulte O ponto de extremidade de espelhamento de banco de dados.

Para conhecer a função e o estado do ponto de extremidade do espelhamento de banco de dados de uma instância de servidor, naquela instância, use a seguinte instrução Transact-SQL:

SELECT role_desc, state_desc FROM sys.database_mirroring_endpoints

<witness_option> ::=

' witness_server ' Especifica uma instância do Mecanismo de Banco de Dados para atuar como servidor testemunha para uma sessão de espelhamento de banco de dados. Você só pode especificar instruções SET WITNESS no servidor principal.

Em uma instrução SET WITNESS ='witness_server' , a sintaxe de witness_server é igual à sintaxe de partner_server.

OFF Remove a testemunha de uma sessão de espelhamento de banco de dados. Definir a testemunha como OFF desabilita o failover automático. Se o banco de dados estiver definido como FULL SAFETY e a testemunha como OFF, uma falha no servidor espelho fará com que o servidor principal torne o banco de dados indisponível.

Comentários

Exemplos

a. Criando uma sessão de espelhamento de banco de dados com uma testemunha

A definição do espelhamento de banco de dados com testemunha requer a configuração da segurança e a preparação do banco de dados espelho, além do uso de ALTER DATABASE para definir os parceiros. Para obter um exemplo do processo completo de instalação, consulte Configurando o espelhamento de banco de dados.

B. Efetuando manualmente o failover de uma sessão de espelhamento de banco de dados

O failover manual pode ser iniciado a partir de qualquer parceiro de espelhamento de banco de dados. Antes de efetuar o failover, você deve verificar se o servidor que se acredita ser o servidor principal atual o é de fato. Por exemplo, para o banco de dados AdventureWorks2022, na instância de servidor que se acredita ser o servidor principal atual, execute a seguinte consulta:

SELECT db.name, m.mirroring_role_desc
FROM sys.database_mirroring m
JOIN sys.databases db
ON db.database_id = m.database_id
WHERE db.name = N'AdventureWorks2022';
GO

Se a instância do servidor for realmente a principal, o valor de mirroring_role_desc será Principal. Se essa instância de servidor fosse o servidor espelho, a instrução SELECT retornaria Mirror.

O exemplo a seguir presume que o servidor seja o principal atual.

1. Efetue manualmente o failover no parceiro de espelhamento de banco de dados:

   ALTER DATABASE AdventureWorks2022 SET PARTNER FAILOVER;
   GO
   

2. Para verificar os resultados do failover no espelho novo, execute a seguinte consulta:

   SELECT db.name, m.mirroring_role_desc
   FROM sys.database_mirroring m
   JOIN sys.databases db
   ON db.database_id = m.database_id
   WHERE db.name = N'AdventureWorks2022';
   GO
   

O valor atual de mirroring_role_desc agora é Mirror.

Consulte Também

• CREATE DATABASE
• DATABASEPROPERTYEX
• sys.database_mirroring_witnesses