sys.sp_change_log_shipping_secondary_database (Transact-SQL)

Gäller för:SQL Server

Ändrar sekundära databasinställningar.

Transact-SQL syntaxkonventioner

Syntax

sys.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 ]
[ ; ]

Arguments

[ @secondary_database = ] N'secondary_database'

Databasnamnet på den sekundära servern. @secondary_database är sysname, utan standard.

[ @restore_delay = ] restore_delay

Hur lång tid, i minuter, som den sekundära servern väntar innan en viss säkerhetskopia återställs. @restore_delay är int, med standardvärdet , 0och kan inte vara NULL.

[ @restore_all = ] restore_all

Om den är inställd på 1, återställer den sekundära servern alla tillgängliga transaktionsloggsäkerhetskopior när återställningsjobbet körs. Annars stoppas den när en fil har återställts. @restore_all är biten, och kan inte bli NULLdet.

[ @restore_mode = ] restore_mode

Återställningsläget för den sekundära databasen. @restore_mode är biten, och kan inte vara NULLdet.

  • 0 = återställ logg med NORECOVERY.
  • 1 = återställ logg med STANDBY.

[ @disconnect_users = ] disconnect_users

Om det sätts till 1, kopplas användarna bort från den sekundära databasen när en återställningsoperation utförs. @disconnect_users är bit, med standardvärdet , 0och kan inte vara NULL.

[ @block_size = ] block_size

Storleken, i bytes, som används som blockstorlek för backup-enheten. @block_size är int, med standardvärdet .-1

[ @buffer_count = ] buffer_count

Det totala antalet buffertar som används av säkerhetskopierings- eller återställningsåtgärden. @buffer_count är int, med standardvärdet .-1

[ @max_transfer_size = ] max_transfer_size

Storleken, i bytes, på den maximala in- eller utmatningsförfrågan som SQL Server skickar till backup-enheten. @max_transfer_size är int, med standardvärdet .NULL

[ @restore_threshold = ] restore_threshold

Antalet minuter som tillåts förflutit mellan återställningsåtgärder innan en avisering genereras. @restore_threshold är int, och kan inte vara NULLdet.

[ @threshold_alert = ] threshold_alert

Aviseringen som ska aktiveras när återställningströskelvärdet överskrids. @threshold_alert är int, med standardvärdet 14421.

[ @threshold_alert_enabled = ] threshold_alert_enabled

Specificerar om en varning utlöses när @restore_threshold överskrids.

  • 1 = aktiverad
  • 0 = funktionshindrad.

@threshold_alert_enabled är biten, och kan inte vara NULLdet.

[ @history_retention_period = ] history_retention_period

Hur lång tid i minuter som historiken behålls. @history_retention_period är int, med standardvärdet 1440.

[ @ignoreremotemonitor = ] ignorera fjärrmonitor

Identifieras endast i informationssyfte. Stöds ej. Framtida kompatibilitet garanteras inte.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

None.

Remarks

sp_change_log_shipping_secondary_database måste köras från master databasen på den sekundära servern. Denna lagrade procedur utför följande steg:

  1. Ändrar inställningarna i registren log_shipping_secondary_database vid behov.

  2. Ändrar den lokala monitorposten på log_shipping_monitor_secondary den sekundära servern med hjälp av medföljande argument, om det behövs.

Permissions

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

Examples

Detta exempel illustrerar att använda sp_change_log_shipping_secondary_database för att uppdatera sekundära databasparametrar för databasen LogShipAdventureWorks.

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