sp_add_log_shipping_primary_database (Transact-SQL)
Richtet die primäre Datenbank für eine Protokollversandkonfiguration ein. Dies schließt den Sicherungsauftrag, den lokalen Überwachungsdatensatz und den Remoteüberwachungsdatensatz ein.
.gif "Themenlink (Symbol)")
Syntax
sp_add_log_shipping_primary_database [ @database = ] 'database',
[ @backup_directory = ] 'backup_directory',
[ @backup_share = ] 'backup_share',
[ @backup_job_name = ] 'backup_job_name',
[, [ @backup_retention_period = ] backup_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']
[, [ @backup_threshold = ] backup_threshold ]
[, [ @threshold_alert = ] threshold_alert ]
[, [ @threshold_alert_enabled = ] threshold_alert_enabled ]
[, [ @history_retention_period = ] history_retention_period ]
[, [ @backup_job_id = ] backup_job_id OUTPUT ]
[, [ @primary_id = ] primary_id OUTPUT]
[, [ @backup_compression = ] backup_compression_option ]
Argumente
[ @database= ] 'database'
Der Name der primären Datenbank des Protokollversands. database ist vom Datentyp sysname, hat keinen Standardwert und kann nicht NULL sein.[ @backup_directory= ] 'backup_directory'
Der Pfad zum Sicherungsordner auf dem primären Server. backup_directory ist vom Datentyp nvarchar(500), hat keinen Standardwert und kann nicht NULL sein.[ @backup_share= ] 'backup_share'
Der Netzwerkpfad zum Sicherungsverzeichnis auf dem primären Server. backup_share ist vom Datentyp nvarchar(500), hat keinen Standardwert und kann nicht NULL sein.[ @backup_job_name= ] 'backup_job_name'
Der Name für den SQL Server-Agent-Auftrag auf dem primären Server, der die Sicherung in den Sicherungsordner kopiert. backup_job_name ist vom Datentyp sysname und kann nicht NULL sein.[ @backup_retention_period= ] backup_retention_period
Der Zeitraum (in Minuten), für den die Protokollsicherungsdatei im Sicherungsverzeichnis auf dem primären Server beibehalten werden soll. backup_retention_period ist vom Datentyp int, hat keinen Standardwert und kann nicht NULL sein.[ @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 für den Zugriff auf den Überwachungsserver verwendet wird.[ @monitor_server_password= ] 'monitor_server_password'
Das Kennwort des Kontos, das für den Zugriff auf den Überwachungsserver verwendet wird.[ @backup_threshold= ] backup_threshold
Die Zeitdauer (in Minuten) nach der letzten Sicherung, bevor ein threshold_alert-Fehler ausgelöst wird. backup_threshold ist vom Datentyp int und hat den Standardwert 60 Minuten.[ @threshold_alert= ] threshold_alert
Die Warnung, die beim Überschreiten des Sicherungsschwellenwertes ausgelöst wird. threshold_alert ist vom Datentyp int und hat den Standardwert 14.420.[ @threshold_alert_enabled= ] threshold_alert_enabled
Gibt an, ob eine Warnung ausgelöst wird, wenn backup_threshold überschritten wird. Der Standardwert Null (0) bedeutet, dass die Warnung deaktiviert ist und nicht ausgelöst wird. threshold_alert_enabled ist vom Datentyp bit.[ @history_retention_period= ] history_retention_period
Der Zeitraum (in Minuten), für den der Verlauf beibehalten wird. history_retention_period ist vom Datentyp int und hat den Standardwert NULL. Wird kein Wert angegeben, wird der Wert 14420 verwendet.[ @backup_job_id= ] backup_job_id OUTPUT
Die ID des SQL Server-Agent-Auftrags, die dem Sicherungsauftrag auf dem primären Server zugeordnet ist. backup_job_id ist vom Datentyp uniqueidentifier und kann nicht NULL sein.[ @primary_id= ] primary_id OUTPUT
Die ID der primären Datenbank in der Protokollversandkonfiguration. primary_id ist vom Datentyp uniqueidentifier und kann nicht NULL sein.[ @backup_compression = ] backup_compression_option
Gibt an, ob eine Protokollversandkonfiguration die Sicherungskomprimierung verwendet. Dieser Parameter wird nur in SQL Server 2008 Enterprise (oder einer höheren Version) unterstützt.0 = Deaktiviert. Protokollsicherungen nie komprimieren.
1 = Aktiviert. Protokollsicherungen immer komprimieren.
2 = Einstellung der Serverkonfigurationsoption Standardeinstellung für die Sicherungskomprimierung verwenden. Dies ist der Standardwert.
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler)
Resultsets
Keine
Hinweise
sp_add_log_shipping_primary_database muss aus der master-Datenbank auf dem primären Server ausgeführt werden. Diese gespeicherte Prozedur führt die folgenden Aktionen aus:
Generieren einer primären ID und Hinzufügen eines Eintrags für die primäre Datenbank in die log_shipping_primary_databases, wobei die angegebenen Argumente verwendet werden.
Erstellen eines Sicherungsauftrags für die primäre Datenbank, die deaktiviert ist.
Festlegen der Sicherungsauftrags-ID im log_shipping_primary_databases-Eintrag auf die Auftrags-ID des Sicherungsauftrags.
Hinzufügen eines lokalen Überwachungsdatensatzes zur log_shipping_monitor_primary-Tabelle auf dem primären Server, wobei die angegebenen Argumente verwendet werden.
Hinzufügen eines Überwachungsdatensatzes zur log_shipping_monitor_primary-Tabelle auf dem Überwachungsserver, falls der Überwachungsserver nicht mit dem primären Server übereinstimmt, wobei die angegebenen Argumente verwendet werden.
Berechtigungen
Nur Mitglieder der festen Serverrolle sysadmin können diese Prozedur ausführen.
Beispiele
In diesem Beispiel wird die AdventureWorks2008R2-Datenbank als primäre Datenbank in einer Protokollversandkonfiguration hinzugefügt.
DECLARE @LS_BackupJobId AS uniqueidentifier
DECLARE @LS_PrimaryId AS uniqueidentifier
EXEC master.dbo.sp_add_log_shipping_primary_database
@database = N'AdventureWorks'
,@backup_directory = N'c:\lsbackup'
,@backup_share = N'\\tribeca\lsbackup'
,@backup_job_name = N'LSBackup_AdventureWorks'
,@backup_retention_period = 1440
,@monitor_server = N'rockaway'
,@monitor_server_security_mode = 1
,@backup_threshold = 60
,@threshold_alert = 0
,@threshold_alert_enabled = 0
,@history_retention_period = 1440
,@backup_job_id = @LS_BackupJobId OUTPUT
,@primary_id = @LS_PrimaryId OUTPUT
,@overwrite = 1
,@backup_compression = 0
GO
Siehe auch