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'

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

Devoluciones

Devuelve bit de tipo de datos: 1 si la base de datos de la instancia actual está en la réplica preferida; de lo contrario0, .

En el caso de las bases de datos que no forman parte de un grupo de disponibilidad, esta función siempre devuelve 1.

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

Contenido relacionado