sp_change_log_shipping_primary_database (Transact-SQL)
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-Authentifizierung0
= 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
:Aktiviert0
: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.
0
:Deaktiviert. Protokollsicherungen nie komprimieren1
:Aktiviert. Protokollsicherungen immer komprimieren2
(Standard): Verwenden Der Einstellung der Ansicht oder Konfigurieren der Standardkonfigurationsoption für die Sicherungskomprimierungsserver
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:
Ändert ggf. die Einstellungen im
log_shipping_primary_database
Datensatz.Ändert den lokalen Datensatz
log_shipping_monitor_primary
auf dem primären Server bei Bedarf mithilfe der angegebenen Argumente.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 AdventureWorks2022
zugeordnet 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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für