sp_add_log_shipping_secondary_primary (Transact-SQL)
Richtet die primären Informationen ein, fügt Verknüpfungen zur lokalen und Remoteüberwachung hinzu und erstellt auf dem zweiten Server Kopier- und Wiederherstellungsaufträge für die angegebene primäre Datenbank.
.gif "Themenlink (Symbol)")
Transact-SQL-Syntaxkonventionen
Syntax
sp_add_log_shipping_secondary_primary
[ @primary_server = ] 'primary_server',
[ @primary_database = ] 'primary_database',
[ @backup_source_directory = ] 'backup_source_directory' ,
[ @backup_destination_directory = ] 'backup_destination_directory'
[ @copy_job_name = ] 'copy_job_name'
[ @restore_job_name = ] 'restore_job_name'
[, [ @file_retention_period = ] 'file_retention_period']
[, [ @monitor_server = ] 'monitor_server']
[, [ @monitor_server_security_mode = ] 'monitor_server_security_mode']
[, [ @monitor_server_login = ] 'monitor_server_login']
[, [ @monitor_server_password = ] 'monitor_server_password']
[, [ @copy_job_id = ] 'copy_job_id' OUTPUT ]
[, [ @restore_job_id = ] 'restore_job_id' OUTPUT ]
[, [ @secondary_id = ] 'secondary_id' OUTPUT]
Argumente
- [ @primary_server = ] 'primary_server'
Der Name der primären Instanz von Microsoft SQL Server-Datenbankmodul in der Protokollversandkonfiguration. primary_server ist ein Wert vom Datentyp sysname und kann nicht NULL sein.
- [ @primary_database = ] 'primary_database'
Der Name der Datenbank auf dem primären Server. primary_database ist vom Datentyp sysname und hat keinen Standardwert.
- [ @backup_source_directory = ] 'backup_source_directory'
Das Verzeichnis, in dem Sicherungsdateien des Transaktionsprotokolls vom primären Server gespeichert werden. backup_source_directory ist vom Datentyp nvarchar(500) und kann nicht NULL sein.
- [ @backup_destination_directory = ] 'backup_destination_directory'
Das Verzeichnis auf dem sekundären Server, in das die Sicherungsdateien kopiert werden. backup_destination_directory ist vom Datentyp nvarchar(500) und kann nicht NULL sein.
- [ @copy_job_name = ] 'copy_job_name'
Der Name für den SQL Server-Agent-Auftrag, der zum Kopieren von Transaktionsprotokollsicherungen auf den sekundären Server erstellt wird. copy_job_name ist vom Datentyp sysname und kann nicht NULL sein.
- [ @restore_job_name = ] 'restore_job_name'
Der Name des SQL Server-Agent-Auftrags auf dem sekundären Server, mit dem die Sicherungen in der sekundären Datenbank wiederhergestellt werden. restore_job_name ist vom Datentyp sysname und kann nicht NULL sein.
- [ @file_retention_period = ] 'file_retention_period'
Gibt an, wie lange (in Minuten) der Verlauf beibehalten wird. history_retention_period ist vom Datentyp int und hat den Standardwert NULL. Der Wert 14420 wird verwendet, falls kein anderer Wert angegeben wird.
- [ @monitor_server = ] 'monitor_server'
Der Name des Überwachungsservers. Monitor_server ist vom Datentyp sysname, hat keinen Standardwert und kann nicht NULL sein.
[ @monitor_server_security_mode = ] 'monitor_server_security_mode'
Der Sicherheitsmodus, der zum Herstellen einer Verbindung mit dem Überwachungsserver verwendet wird.1 = Windows-Authentifizierung.
0 = SQL Server-Authentifizierung.
monitor_server_security_mode ist vom Datentyp bit und kann nicht NULL sein.
- [ @monitor_server_login = ] 'monitor_server_login'
Der Benutzername des Kontos, das zum Zugreifen auf den Überwachungsserver verwendet wird.
- [ @monitor_server_password = ] 'monitor_server_password'
Das Kennwort des Kontos, das zum Zugreifen auf den Überwachungsserver verwendet wird.
- [ @copy_job_id = ] 'copy_job_id' OUTPUT
Die dem Kopierauftrag auf dem sekundären Server zugeordnete ID. copy_job_id ist vom Datentyp uniqueidentifier und kann nicht NULL sein.
- [ @restore_job_id = ] 'restore_job_id' OUTPUT
Die dem Wiederherstellungsauftrag auf dem sekundären Server zugeordnete ID. restore_job_id ist vom Datentyp uniqueidentifier und kann nicht NULL sein.
- [ @secondary_id = ] 'secondary_id' OUTPUT
Die ID des sekundären Servers in der Protokollversandkonfiguration. secondary_id ist vom Datentyp uniqueidentifier und kann nicht NULL sein.
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler)
Resultsets
Keine
Hinweise
sp_add_log_shipping_secondary_primary muss in der master-Datenbank auf dem sekundären Server ausgeführt werden. Diese gespeicherte Prozedur führt Folgendes aus:
- Generiert eine sekundäre ID für den angegebenen primären Server und die primäre Datenbank.
- Führt Folgendes aus:
- Fügt einen Eintrag für die sekundäre ID in log_shipping_secondary hinzu, wobei die angegebenen Argumente verwendet werden.
- Erstellt einen Kopierauftrag für die sekundäre ID, die deaktiviert ist.
- Legt die Kopierauftrags-ID im log_shipping_secondary-Eintrag auf die Auftrags-ID des Kopierauftrags fest.
- Erstellt einen Wiederherstellungsauftrag für die sekundäre ID, die deaktiviert ist.
- Legt die Wiederherstellungsauftrags-ID im log_shipping_secondary-Eintrag auf die Auftrags-ID des Wiederherstellungsauftrags fest.
Berechtigungen
Nur Mitglieder der festen Serverrolle sysadmin können diese Prozedur ausführen.
Beispiele
In diesem Beispiel wird die Verwendung der gespeicherten Prozedur sp_add_log_shipping_secondary_primary zum Einrichten von Informationen für die primäre Datenbank AdventureWorks auf dem sekundären Server dargestellt.
EXEC master.dbo.sp_add_log_shipping_secondary_primary
@primary_server = N'TRIBECA'
,@primary_database = N'AdventureWorks'
,@backup_source_directory = N'\\tribeca\LogShipping'
,@backup_destination_directory = N''
,@copy_job_name = N''
,@restore_job_name = N''
,@file_retention_period = 1440
,@monitor_server = N'ROCKAWAY'
,@monitor_server_security_mode = 1
,@copy_job_id = @LS_Secondary__CopyJobId OUTPUT
,@restore_job_id = @LS_Secondary__RestoreJobId OUTPUT
,@secondary_id = @LS_Secondary__SecondaryId OUTPUT
GO
Siehe auch
Verweis
Gespeicherte Systemprozeduren (Transact-SQL)
Andere Ressourcen
Protokollversand
Protokollversandtabellen und gespeicherte Prozeduren