sp_change_log_shipping_primary_database (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Ändert die Einstellungen primärer Datenbanken.

Transact-SQL-Syntaxkonventionen

Syntax

sp_change_log_shipping_primary_database
    [ @database = ] 'database'
    [ , [ @backup_directory = ] N'backup_directory' ]
    [ , [ @backup_share = ] N'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 = ] 'Datenbank'

Der Name der Datenbank auf dem primären Server. @primary_database ist "sysname" ohne Standard.

[ @backup_directory = ] N'backup_directory'

Der Pfad zum Sicherungsordner auf dem primären Server. @backup_directory ist nvarchar(500), ohne Standard und darf nicht NULL sein.

[ @backup_share = ] N'backup_share'

Der Netzwerkpfad zum Sicherungsverzeichnis auf dem primären Server. @backup_share ist nvarchar(500), ohne Standard und darf nicht NULL sein.

[ @backup_retention_period = ] 'backup_retention_period'

Die Dauer der Aufbewahrung der Protokolldatei im Sicherungsverzeichnis auf dem primären Server in Minuten. @backup_retention_period ist int, ohne Standard 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 Bit und standardmäßig NULL.

[ @monitor_server_login = ] 'monitor_server_login'

Der Benutzername des Kontos, das für den Zugriff auf den Monitorserver verwendet wird.

[ @monitor_server_password = ] 'monitor_server_password'

Das Kennwort des Kontos, das für den Zugriff auf den Monitorserver 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 "int" mit einer Standardeinstellung von 60 Minuten.

[ @threshold_alert = ] 'threshold_alert'

Die Warnung, die bei Überschreiten des Sicherungsschwellenwertes ausgelöst wird. @threshold_alert ist int und darf 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 bit und kann nicht NULL sein.

[ @history_retention_period = ] 'history_retention_period'

Die Zeitdauer in Minuten, in der der Verlauf beibehalten wird. @history_retention_period ist int. Wenn keine angegeben wird, wird ein Wert von 14420 verwendet.

[ @backup_compression = ] backup_compression_option

Gibt an, ob eine Protokollversandkonfiguration Sicherungskomprimierung verwendet. Dieser Parameter wird in enterprise edition für SQL Server 2008 (10.0.x) (und höher) und alle Editionen in SQL Server 2016 (13.x) mit Service Pack 1 (und höheren Versionen) unterstützt.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Resultset

Keine.

Hinweise

sp_change_log_shipping_primary_database muss aus der master Datenbank auf dem primären Server ausgeführt werden. Diese gespeicherte Prozedur führt folgende Aktionen aus:

  1. Ändert ggf. die Einstellungen im log_shipping_primary_database Datensatz.

  2. Ändert den lokalen Datensatz log_shipping_monitor_primary auf dem primären Server bei Bedarf mithilfe der angegebenen Argumente.

  3. Wenn sich der Monitorserver vom primären Server unterscheidet, ändert sich der Datensatz log_shipping_monitor_primary auf dem Monitorserver 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 der sp_change_log_shipping_primary_database Aktualisierung der Einstellungen veranschaulicht, die der primären Datenbank AdventureWorks2022zugeordnet 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,
    @backup_compression = 1;

Zugehöriger Inhalt