Freigeben über

sp_change_log_shipping_primary_database (Transact-SQL)

  • Artikel

Ä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']

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'
    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_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 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 Schwellenwertes für die Sicherung ausgelöst wird. threshold_alertist 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.

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 AdventureWorks verknüpft sind.

EXEC master.dbo.sp_change_log_shipping_primary_database 
 @database = N'AdventureWorks' 
, @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

Siehe auch

Verweis

Gespeicherte Systemprozeduren (Transact-SQL)
log_shipping_primary_databases (Transact-SQL)

Andere Ressourcen

Protokollversand
Protokollversandtabellen und gespeicherte Prozeduren

Hilfe und Informationen

Informationsquellen für SQL Server 2005