sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

Aplica-se a: SQL Server (todas as versões com suporte)

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

Topic link iconConvenções de sintaxe do Transact-SQL

Sintaxe

sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )  

Argumentos

'dbname'
É o nome do banco de dados a ser feito em backup. dbname é tipo sysname.

Retornos

Retorna o tipo de dados bool: 1 se o banco de dados na instância atual estiver na réplica preferencial, caso contrário, 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).
      Select 'This is not the preferred replica, exiting with success';  
END  
-- If this is the preferred replica, continue to do the backup.  
  /* actual backup command goes here */

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  

Related Tasks

Consulte Também

Funções de grupos de disponibilidade Always On (Transact-SQL)
Grupos de Disponibilidade AlwaysOn (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
Secundários ativos: backup em réplicas secundárias (Always On grupos de disponibilidade)Always On exibições de catálogo de grupos de disponibilidade (Transact-SQL)