sp_change_log_shipping_secondary_database (Transact-SQL)

Artikel
12/22/2023

Ändert Einstellungen sekundärer Datenbanken.

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' Die Zeitspanne in Minuten, die der sekundäre Server wartet, bevor eine bestimmte Sicherungsdatei wiederhergestellt wird. restore_delay ist int und darf nicht NULL sein. Der Standardwert ist 0.

[ @restore_all = ] 'restore_all' Bei Festlegung auf 1 stellt der sekundäre Server alle verfügbaren Transaktionsprotokollsicherungen wieder her, wenn der Wiederherstellungsauftrag ausgeführt wird. Andernfalls wird sie beendet, nachdem eine Datei wiederhergestellt wurde. restore_all ist bit und darf nicht NULL sein.

[ @restore_mode = ] 'restore_mode' Der Wiederherstellungsmodus für die sekundäre Datenbank.

0 = Wiederherstellungsprotokoll mit NORECOVERY.

1 = Wiederherstellen des Protokolls mit STANDBY.

Die Wiederherstellung ist Bit und kann nicht NULL sein.

[ @disconnect_users = ] 'disconnect_users' Bei Festlegung auf 1 wird die Verbindung der Benutzer von der sekundären Datenbank getrennt, wenn ein Wiederherstellungsvorgang ausgeführt wird. Standard = 0. disconnect_users ist Bit und darf nicht NULL sein.

[ @block_size = ] 'block_size' Die Größe in Bytes, die als Blockgröße für das Sicherungsgerät verwendet wird. block_size ist int mit dem Standardwert -1.

[ @buffer_count = ] 'buffer_count' Die Gesamtanzahl der Puffer, die vom Sicherungs- oder Wiederherstellungsvorgang verwendet werden. buffer_count ist int mit dem Standardwert -1.

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

[ @restore_threshold = ] 'restore_threshold' Die Anzahl der Minuten, die zwischen Wiederherstellungsvorgängen verstrichen werden dürfen, bevor eine Warnung generiert wird. restore_threshold ist int und darf nicht NULL sein.

[ @threshold_alert = ] 'threshold_alert' Wird die Warnung ausgelöst, wenn der Wiederherstellungsschwellenwert überschritten wird. threshold_alert ist "int" mit dem Standardwert 14421.

[ @threshold_alert_enabled = ] 'threshold_alert_enabled' Gibt an, ob eine Warnung ausgelöst wird, wenn restore_thresholdüberschritten wird. 1 = aktiviert; 0 = deaktiviert. threshold_alert_enabled ist Bit und kann nicht NULL sein.

[ @history_retention_period = ] 'history_retention_period' Ist die Zeitdauer in Minuten, in der der Verlauf beibehalten wird. history_retention_period ist int. Wenn kein Wert angegeben ist, wird ein Wert von 1440 verwendet.

Rückgabecodewerte

„0“ (erfolgreich) oder „1“ (fehlerhaft)

Resultsets

Keine

Hinweise

sp_change_log_shipping_secondary_database muss aus der Masterdatenbank auf dem sekundären Server ausgeführt werden. Diese gespeicherte Prozedur führt folgende Aktionen aus:

Ändert die Einstellungen in den log_shipping_secondary_database Datensätzen nach Bedarf.
Ändert den lokalen Monitordatensatz in log_shipping_monitor_secondary auf dem sekundären Server bei Bedarf mithilfe der angegebenen Argumente.

Berechtigungen

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

Beispiele

In diesem Beispiel wird die Verwendung von sp_change_log_shipping_secondary_database zum Aktualisieren sekundärer Datenbankparameter für die Datenbank LogShipAdventureWorks 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;

Weitere Informationen

Informationen zum Protokollversand (SQL Server)
Gespeicherte Systemprozeduren (Transact-SQL)