• Artikel

sp_change_log_shipping_primary_database (Transact-SQL)

Ändert die Einstellungen primärer Datenbanken.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

sp_change_log_shipping_primary_database [ @database = ] 'database'
[, [ @backup_directory = ] 'backup_directory'] 
[, [ @backup_share = ] 'backup_share'] 
[, [ @backup_retention_period = ] 'backup_retention_period']
[, [ @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_compression = ] backup_compression_option ]

Argumente

  • [ @database = ] 'database'
    Der Name der Datenbank auf dem primären Server. primary_database ist vom Datentyp sysname und hat keinen Standardwert.

  • [ @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_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_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 für das Konto, 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.

  • [ @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 Schwellenwertes für die Sicherung ausgelöst wird. threshold_alert ist vom Datentyp int und kann nicht NULL sein.

  • [ @threshold_alert_enabled = ] 'threshold_alert_enabled'
    Gibt an, ob eine Warnung ausgelöst wird, wenn backup_threshold überschritten wird.

    1 = aktiviert.

    0 = deaktiviert.

    threshold_alert_enabled ist vom Datentyp bit und kann nicht NULL sein.

  • [ @history_retention_period = ] 'history_retention_period'
    Der Zeitraum (in Minuten), für den der Verlauf beibehalten wird. history_retention_period ist vom Datentyp int. Falls nichts angegeben wird, wird der Wert 14420 verwendet.

  • [ @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_change_log_shipping_primary_database muss in der master-Datenbank auf dem primären Server ausgeführt werden. Diese gespeicherte Prozedur führt folgende Aktionen aus:

  1. Ändert die Einstellungen im log_shipping_primary_database-Datensatz nach Bedarf.

  2. Ändert den lokalen Datensatz in log_shipping_monitor_primary auf dem primären Server mithilfe bereitgestellter Argumente, falls erforderlich.

  3. Falls der Überwachungsserver nicht mit dem primären Server übereinstimmt, werden Änderungen in log_shipping_monitor_primary auf dem Überwachungsserver erfasst, wobei ggf. die angegebenen Argumente verwendet werden.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin können diese Prozedur ausführen.

Beispiele

In diesem Beispiel wird gezeigt, wie sp_change_log_shipping_primary_database zum Aktualisieren der Einstellungen verwendet wird, die mit der primären Datenbank AdventureWorks2008R2 verknüpft sind.

EXEC master.dbo.sp_change_log_shipping_primary_database 
 @database = N'AdventureWorks2008R2' 
, @backup_directory = N'c:\LogShipping' 
, @backup_share = N'\\tribeca\LogShipping' 
, @backup_retention_period = 1440 
, @backup_threshold = 60 
, @threshold_alert = 0 
, @threshold_alert_enabled = 1 
, @history_retention_period = 1440 
,@monitor_server_security_mode = 1
,@backup_compression = 1