Share via

  • Artikel

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.

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 MicrosoftSQL Server Database Engine (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:

  1. Generiert eine sekundäre ID für den angegebenen primären Server und die primäre Datenbank.

  2. Führt Folgendes aus:

    1. Fügt einen Eintrag für die sekundäre ID in log_shipping_secondary hinzu, wobei die angegebenen Argumente verwendet werden.

    2. Erstellt einen Kopierauftrag für die sekundäre ID, die deaktiviert ist.

    3. Legt die Kopierauftrags-ID im log_shipping_secondary-Eintrag auf die Auftrags-ID des Kopierauftrags fest.

    4. Erstellt einen Wiederherstellungsauftrag für die sekundäre ID, die deaktiviert ist.

    5. 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