sp_change_log_shipping_primary_database (Transact-SQL)

gäller för:SQL Server

Ändrar inställningarna för den primära databasen.

Transact-SQL syntaxkonventioner

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 ]
    [ , [ @monitor_connection_options = ] '<key_value_pairs>;[...]' ]
[ ; ]

Argumentpunkter

[ @database = ] "databas"

Namnet på databasen på den primära servern. @primary_database är sysname, utan standard.

[ @backup_directory = ] N'backup_directory'

Sökvägen till mappen backup på den primära servern. @backup_directory är nvarchar(500), utan standard och kan inte vara NULL.

[ @backup_share = ] N'backup_share'

Nätverkssökvägen till säkerhetskopieringskatalogen på den primära servern. @backup_share är nvarchar(500), utan standard och kan inte vara NULL.

[ @backup_retention_period = ] "backup_retention_period"

Hur lång tid, i minuter, för att behålla loggsäkerhetskopieringsfilen i säkerhetskopieringskatalogen på den primära servern. @backup_retention_period är int, utan standard och kan inte vara NULL.

[ @monitor_server_security_mode = ] "monitor_server_security_mode"

Säkerhetsläget som används för att ansluta till övervakningsservern.

• 1 = Windows-autentisering
• 0 = SQL Server-autentisering

@monitor_server_security_mode är bit och standardvärdet är NULL.

[ @monitor_server_login = ] "monitor_server_login"

Användarnamnet för det konto som används för att komma åt övervakningsservern.

[ @monitor_server_password = ] "monitor_server_password"

Lösenordet för det konto som används för att komma åt övervakningsservern.

[ @backup_threshold = ] "backup_threshold"

Hur lång tid, i minuter, efter den senaste säkerhetskopieringen innan ett @threshold_alert fel utlöses. @backup_threshold är int, med standardvärdet 60 minuter.

[ @threshold_alert = ] "threshold_alert"

Aviseringen som ska aktiveras när tröskelvärdet för säkerhetskopiering överskrids. @threshold_alert är int och kan inte vara NULL.

[ @threshold_alert_enabled = ] "threshold_alert_enabled"

Anger om en avisering utlöses när @backup_threshold överskrids.

• 1:Aktiverat
• 0:handikappad

threshold_alert_enabled är bit och kan inte vara NULL.

[ @history_retention_period = ] "history_retention_period"

Hur lång tid i minuter som historiken behålls. @history_retention_period är int. Värdet 14420 används om inget anges.

[ @backup_compression = ] backup_compression_option

Anger om en loggleveranskonfiguration använder säkerhetskopieringskomprimering. Den här parametern stöds i Enterprise Edition för SQL Server 2008 (10.0.x) (och senare versioner) och alla utgåvor på SQL Server 2016 (13.x) med Service Pack 1 (och senare versioner).

• 0:Handikappad. Komprimera aldrig loggsäkerhetskopior

• 1:Aktiverat. Komprimera alltid loggsäkerhetskopior

• 2 (standard): Använd standardserverkonfigurationsalternativet för säkerhetskopieringskomprimering .

[ @monitor_connection_options = ] '<key_value_pairs>;[ ...]'

Gäller för: FÖRHANDSVERSION AV SQL Server 2025 (17.x) och senare versioner

Anger ytterligare anslutningsalternativ för den länkade serveranslutningen när du använder en fjärrövervakare, i form av nyckelvärdepar. @monitor_connection_options är nvarchar(4000) och har standardvärdet NULL.

I följande tabell visas tillgängliga anslutningsalternativ:

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

Ingen.

Anmärkningar

sp_change_log_shipping_primary_database måste köras från master databasen på den primära servern. Den här lagrade proceduren gör följande:

1. Ändrar inställningarna i posten log_shipping_primary_database om det behövs.

2. Ändrar den lokala posten i log_shipping_monitor_primary på den primära servern med hjälp av angivna argument, om det behövs.

3. Om övervakningsservern skiljer sig från den primära servern ändras posten på log_shipping_monitor_primary övervakningsservern med hjälp av angivna argument, om det behövs.

Behörigheter

Endast medlemmar i den fasta serverrollen sysadmin kan köra den här proceduren.

Exempel

Det här exemplet illustrerar användningen av sp_change_log_shipping_primary_database för att uppdatera inställningarna som är associerade med den primära databasen AdventureWorks2022.

EXECUTE 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;

Relaterat innehåll

• Om loggöverföring (SQL Server)
• System sparade procedurer (Transact-SQL)
• log_shipping_primary_databases (Transact-SQL)