• Artikel

sp_change_log_shipping_secondary_database (Transact-SQL)

Ändert die Einstellungen sekundärer Datenbanken.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

sp_change_log_shipping_secondary_database
[ @secondary_database = ] 'secondary_database',
[, [ @restore_delay = ] 'restore_delay']
[, [ @restore_all = ] 'restore_all']
[, [ @restore_mode = ] 'restore_mode']
[, [ @disconnect_users = ] 'disconnect_users']
[, [ @block_size = ] 'block_size']
[, [ @buffer_count = ] 'buffer_count']
[, [ @max_transfer_size = ] 'max_transfer_size']
[, [ @restore_threshold = ] 'restore_threshold'] 
[, [ @threshold_alert = ] 'threshold_alert'] 
[, [ @threshold_alert_enabled = ] 'threshold_alert_enabled'] 
[, [ @history_retention_period = ] 'history_retention_period']

Argumente

  • [ @restore_delay = ] 'restore_delay'
    Der Zeitraum (in Minuten), den der sekundäre Server wartet, bevor eine bestimmte Sicherungsdatei wiederhergestellt wird. restore_delay ist vom Datentyp int und kann nicht NULL sein. Der Standardwert ist 0.

  • [ @restore_all = ] 'restore_all'
    Wenn der Wert auf 1 festgelegt wird, stellt der sekundäre Server alle verfügbaren Transaktionsprotokollsicherungen wieder her, wenn der Wiederherstellungsauftrag ausgeführt wird. Andernfalls wird der Wiederherstellungsvorgang nach einer Datei beendet. restore_all ist vom Datentyp bit und kann nicht NULL sein.

  • [ @restore_mode = ] 'restore_mode'
    Der Wiederherstellungsmodus der sekundären Datenbank.

    0 = Wiederherstellungsprotokoll mit NORECOVERY.

    1 = Wiederherstellungsprotokoll mit STANDBY.

    restore ist vom Datentyp bit und kann nicht NULL sein.

  • [ @disconnect_users = ] 'disconnect_users'
    Wird der Wert auf 1 festgelegt, werden die Verbindungen von Benutzern mit der sekundären Datenbank getrennt, wenn ein Wiederherstellungsvorgang durchgeführt wird. Standardeinstellung = 0. disconnect_users ist vom Datentyp bit und kann nicht NULL sein.

  • [ @block_size = ] 'block_size'
    Die Größe in Bytes, die als Blockgröße für das Sicherungsmedium verwendet wird. block_size ist vom Datentyp int und hat den Standardwert -1.

  • [ @buffer_count = ] 'buffer_count'
    Die Gesamtanzahl der vom Sicherungs- oder Wiederherstellungsvorgang verwendeten Puffer. buffer_count ist vom Datentyp int und hat den Standardwert -1.

  • [ @max_transfer_size = ] 'max_transfer_size'
    Die Größe (in Bytes) der maximalen Eingabe- oder Ausgabeanforderung, die von SQL Server an das Sicherungsmedium ausgegeben wird. max_transfersize ist vom Datentyp int und kann NULL sein.

  • [ @restore_threshold = ] 'restore_threshold'
    Die Anzahl von Minuten, die zwischen Wiederherstellungsvorgängen verstreichen darf, bevor eine Warnung generiert wird. restore_threshold ist vom Datentyp int und kann nicht NULL sein.

  • [ @threshold_alert = ] 'threshold_alert'
    Die Warnung, die beim Überschreiten des Sicherungsschwellenwertes ausgelöst wird. threshold_alert ist vom Datentyp int und hat den Standardwert 14420.

  • [ @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'
    Gibt an, wie lange (in Minuten) der Verlauf beibehalten wird. history_retention_period ist vom Datentyp int. Der Wert 1440 wird verwendet, falls kein anderer Wert angegeben wird.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Keine

Hinweise

sp_change_log_shipping_secondary_database muss aus der master-Datenbank auf dem sekundären Server ausgeführt werden. Diese gespeicherte Prozedur führt Folgendes aus:

  1. Ändert die Einstellungen in den log_shipping_secondary_database-Datensätzen nach Bedarf.

  2. Ändert ggf. den lokalen Überwachungsdatensatz in log_shipping_monitor_secondary auf dem sekundären Server mithilfe bereitgestellter Argumente.

Berechtigungen

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

Beispiele

In diesem Beispiel wird das Verwenden von sp_change_log_shipping_secondary_database zum Update der Parameter sekundärer Datenbanken für die LogShipAdventureWorks-Datenbank veranschaulicht.

EXEC master.dbo.sp_change_log_shipping_secondary_database 
 @secondary_database =  'LogShipAdventureWorks'
,  @restore_delay = 0
,  @restore_all = 1
,  @restore_mode = 0
,  @disconnect_users = 0
,  @threshold_alert = 14420
,  @threshold_alert_enabled = 1
,  @history_retention_period = 14420