Freigeben über

sp_add_log_shipping_primary_database (Transact-SQL)

  • Artikel

Richtet die primäre Datenbank für eine Protokollversandkonfiguration ein. Dies schließt den Sicherungsauftrag, den lokalen Überwachungsdatensatz und den Remoteüberwachungsdatensatz ein.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

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]

Argumente

  • [ @database = ] 'database'
    Der Name der primären Datenbank des Protokollversands. database ist ein Wert vom Datentyp sysname und hat keinen Standardwert. Ein NULL-Wert ist nicht zulässig.
  • [ @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 ein Wert vom Datentyp sysname und kann nicht NULL sein.
  • [ @backup_retention_period = ] backup_retention_period
    Gibt die Zeitdauer in Minuten an, für die die Protokollsicherungsdatei im Sicherungsverzeichnis auf dem primären Server beibehalten werden soll. backup_retention_period ist vom Datentyp int, hat keinen Standardwert und darf 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 = Microsoft Windows-Authentifizierung.

    0 = Microsoft Die 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 Zeit (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 Eins (1) bedeutet, dass die Warnung ausgelöst wird. threshold_alert_enabled ist vom Datentyp bit.
  • [ @history_retention_period = ] history_retention_period
    Gibt an, wie lange (in Minuten) 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.

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:

  1. 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.
  2. Erstellen eines Sicherungsauftrags für die primäre Datenbank, die deaktiviert ist.
  3. Festlegen der Sicherungsauftrags-ID im log_shipping_primary_databases-Eintrag auf die Auftrags-ID des Sicherungsauftrags.
  4. Hinzufügen eines lokalen Überwachungsdatensatzes zur log_shipping_monitor_primary-Tabelle auf dem primären Server, wobei die angegebenen Argumente verwendet werden.
  5. 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 AdventureWorks-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 
GO

Siehe auch

Verweis

Gespeicherte Systemprozeduren (Transact-SQL)

Andere Ressourcen

Protokollversand
Protokollversandtabellen und gespeicherte Prozeduren

Hilfe und Informationen

Informationsquellen für SQL Server 2005