sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Dient zum Ermitteln, ob das aktuelle Replikat das bevorzugte Sicherungsreplikat ist.

Transact-SQL-Syntaxkonventionen

Syntax

sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )

Argumente

'dbname'
Ist der Name der Datenbank, die gesichert werden soll. "dbname" ist vom Typ "sysname ".

Gibt zurück

Gibt datentyp bool: 1 if the database on the current instance is on the preferred replica, otherwise 0.

Hinweise

Verwenden Sie diese Funktion in einem Sicherungsskript, um zu ermitteln, ob sich die aktuelle Datenbank auf dem für Sicherungen bevorzugten Replikat befindet. Sie können ein Skript über jedes Verfügbarkeitsreplikat ausführen. Jeder dieser Aufträge untersucht die gleichen Daten, um zu bestimmen, welcher Auftrag ausgeführt werden soll, sodass nur einer der geplanten Aufträge tatsächlich mit der Sicherungsphase fortfährt. Beispielcode kann sich wie folgt zusammensetzen.

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

Beispiele

.A Verwenden von sys.fn_hadr_backup_is_preferred_replica

Im folgenden Beispiel wird 1 zurückgegeben, wenn die aktuelle Datenbank dem bevorzugten Sicherungsreplikat entspricht.

SELECT sys.fn_hadr_backup_is_preferred_replica ('TestDB');  
GO

Related Tasks

Weitere Informationen

Always On Availability Groups Functions (Transact-SQL)
Always On-Verfügbarkeitsgruppen (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
Aktive Secondaries: Sicherung auf sekundären Replikaten (Always On Availability Groups)Always On Availability Groups Catalog Views (Transact-SQL)