sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

  • Artículo

Se aplica a:SQL Server

Se usa para determinar si la réplica actual es la réplica de copia de seguridad preferida.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )

Argumentos

'dbname'
Es el nombre de la base de datos de la que se va a realizar una copia de seguridad. dbname es el tipo sysname.

Devoluciones

Devuelve el tipo de datos bool: 1 si la base de datos de la instancia actual está en la réplica preferida; de lo contrario, es 0.

Comentarios

Utilice esta función en un script de copia de seguridad para determinar si la base de datos actual está en la réplica preferida para las copias de seguridad. Puede ejecutar un script en cada réplica de disponibilidad. Cada uno de estos trabajos examina los mismos datos para determinar qué trabajo debe ejecutarse, por lo que solamente los trabajos programados pasan a la etapa de copia de seguridad. El código de ejemplo podría ser similar al siguiente.

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 */

Ejemplos

A Uso de sys.fn_hadr_backup_is_preferred_replica

En el ejemplo siguiente se devuelve 1 si la base de datos actual es la réplica de copia de seguridad preferida.

SELECT sys.fn_hadr_backup_is_preferred_replica ('TestDB');  
GO

Related Tasks

Consulte también

Funciones de grupos de disponibilidad AlwaysOn (Transact-SQL)
Grupos de disponibilidad Always On (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
Secundarias activas: copia de seguridad en réplicas secundarias (grupos de disponibilidad AlwaysOn)Vistas de catálogo de grupos de disponibilidad AlwaysOn (Transact-SQL)