Compartilhar via


sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

Usado para determinar se a réplica atual for a réplica de backup preferencial.

Aplica-se a: SQL Server (SQL Server 2012 até a versão atual).

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )

Argumentos

  • 'dbname'
    É o nome do banco de dados do qual é feito o backup. dbname é do tipo sysname.

Retorna

Retornará 1 se o banco de dados da instância atual estiver na réplica preferencial. Caso contrário, retorna 0.

Comentários

Use esta função em um script de backup para determinar se o banco de dados atual está na réplica preferencial para backups. Você pode executar um script em cada réplica de disponibilidade. Cada um desses trabalhos examina os mesmos dados para determinar qual trabalho deve ser executado, portanto, somente um dos trabalhos agendados realmente passa para o estágio de backup. O código de exemplo pode ser semelhante ao seguinte:

If sys.fn_hadr_backup_is_preferred_replica( @dbname ) <> 1 
BEGIN
-- If this is not the preferred replica, exit (probably without error).
END
-- If this is the preferred replica, continue to do the backup.

Exemplos

A.Usando sys.fn_hadr_backup_is_preferred_replica

O exemplo a seguir retornará 1 se o banco de dados atual for a réplica de backup preferencial.

SELECT sys.fn_hadr_backup_is_preferred_replica ('TestDB');
GO

Tarefas relacionadas

Ícone de seta usado com o link Voltar ao Início[Início]

Consulte também

Referência

CREATE AVAILABILITY GROUP (Transact-SQL)

ALTER AVAILABILITY GROUP (Transact-SQL)

Conceitos

Funções de grupos de disponibilidade AlwaysOn (Transact-SQL)

Grupos de Disponibilidade AlwaysOn (SQL Server)

Secundárias ativas: backup em réplicas secundárias (Grupos de Disponibilidade AlwaysOn)

Outros recursos

Exibições de grupos de disponibilidade AlwaysOn (Transact-SQL)