sp_change_log_shipping_secondary_database (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server

Ändert Einstellungen sekundärer Datenbanken.

Syntax

sp_change_log_shipping_secondary_database
    [ @secondary_database = ] N'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 ]
    [ , [ @ignoreremotemonitor = ] ignoreremotemonitor ]
[ ; ]

Argumente

[ @secondary_database = ] N'secondary_database'

Der Datenbankname auf dem sekundären Server. @secondary_database ist "sysname" ohne Standard.

[ @restore_delay = ] restore_delay

Die Zeit in Minuten, die der sekundäre Server vor dem Wiederherstellen einer bestimmten Sicherungsdatei wartet. @restore_delay ist int, mit einem Standardwert von 0, und kann nicht seinNULL.

[ @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 der Vorgang nach der Wiederherstellung einer Datei beendet. @restore_all ist bit und kann nicht seinNULL.

[ @restore_mode = ] restore_mode

Der Wiederherstellungsmodus für die sekundäre Datenbank. @restore_mode ist bit und kann nicht seinNULL.

0 = Protokoll wiederherstellen mit NORECOVERY.
1 = Protokoll wiederherstellen mit STANDBY.

[ @disconnect_users = ] disconnect_users

Wenn diese Einstellung 1festgelegt ist, werden Die Benutzer beim Ausführen eines Wiederherstellungsvorgangs von der sekundären Datenbank getrennt. @disconnect_users ist bit, mit einem Standardwert von 0, und kann nicht seinNULL.

[ @block_size = ] block_size

Die Größe in Bytes, die als Blockgröße für das Sicherungsmedium verwendet wird. @block_size ist int, mit einem Standardwert von -1.

[ @buffer_count = ] buffer_count

Die Gesamtanzahl der beim Sicherungs- oder Wiederherstellungsvorgang verwendeten Puffer. @buffer_count ist int, mit einem Standardwert von -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_transfer_size ist int, mit einem Standardwert von NULL.

[ @restore_threshold = ] restore_threshold

Die Anzahl der zulässigen Minuten zwischen Wiederherstellungsvorgängen, bevor eine Warnung generiert wird. @restore_threshold ist int und kann nicht seinNULL.

[ @threshold_alert = ] threshold_alert

Die Warnung, die ausgelöst wird, wenn die Wiederherstellungsschwelle überschritten wird. @threshold_alert ist int mit einem Standardwert von 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 seinNULL.

[ @history_retention_period = ] history_retention_period

Die Zeitdauer in Minuten, in der der Verlauf beibehalten wird. @history_retention_period ist int, mit einem Standardwert von 1440.

[ @ignoreremotemonitor = ] ignoreremotemonitor

Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Keine.

Hinweise

sp_change_log_shipping_secondary_database muss von der master Datenbank auf dem sekundären Server ausgeführt werden. Diese gespeicherte Prozedur führt die folgenden Schritte aus:

Ändert die Einstellungen in den log_shipping_secondary_database Datensätzen nach Bedarf.
Ändert den lokalen Monitordatensatz 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 veranschaulicht, wie sp_change_log_shipping_secondary_database sekundäre Datenbankparameter für die Datenbank aktualisiert werden LogShipAdventureWorks.

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;

Freigeben über