sys.fn_hadr_is_primary_replica (Transact-SQL)

  • Artículo

Se aplica a: SQL Server

Se usa para determinar si la réplica actual es la réplica principal.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sys.fn_hadr_is_primary_replica ( 'dbname' )

Argumentos

'dbname'
Es el nombre de la base de datos. dbname es el tipo sysname.

Devoluciones

Devuelve el bit de tipo de datos: 1 si la base de datos de la instancia actual es la réplica principal; de lo contrario, es 0.

Comentarios

Utilice esta función para determinar fácilmente si la instancia local hospeda la réplica principal de la base de datos de disponibilidad especificada. El código de ejemplo podría ser similar al siguiente.

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

Ejemplos

A Usar sys.fn_hadr_is_primary_replica

El ejemplo siguiente devuelve 1 si la base de datos especificada en la instancia local es la réplica principal.

SELECT sys.fn_hadr_is_primary_replica ('TestDB');  
GO

Seguridad

Permisos

es necesario contar con el permiso VIEW SERVER STATE en el servidor.

Consulte también

Funciones de grupos de disponibilidad AlwaysOn (Transact-SQL)
sys.dm_hadr_database_replica_states (Transact-SQL)Grupos de disponibilidad AlwaysOn (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
Vistas de catálogo de grupos de disponibilidad Always On (Transact-SQL)