sp_add_log_shipping_secondary_database (Transact-SQL)

Gäller för:SQL Server

Sätter upp en sekundär databas för loggfrakt.

Transact-SQL syntaxkonventioner

Syntax

sp_add_log_shipping_secondary_database
    [ @secondary_database = ] 'secondary_database'
    , [ @primary_server = ] 'primary_server'
    , [ @primary_database = ] 'primary_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' ]
[ ; ]

Arguments

[ @secondary_database = ] 'secondary_database'

Namnet på den sekundära databasen. @secondary_database är sysname, utan standard.

[ @primary_server = ] "primary_server"

Namnet på den primära instansen av SQL Server Database Engine i loggleveranskonfigurationen. @primary_server är sysname och kan inte vara NULL.

[ @primary_database = ] "primary_database"

Namnet på databasen på den primära servern. @primary_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 och kan inte vara NULLdet. Standardvärdet är 0.

[ @restore_all = ] 'restore_all'

Om värdet är 1 återställer den sekundära servern alla tillgängliga säkerhetskopieringar av transaktionsloggar när återställningsjobbet körs. Annars stoppas den när en fil har återställts. @restore_all är bitt och kan inte vara NULLdet.

[ @restore_mode = ] 'restore_mode'

Återställningsläget för den sekundära databasen.

  • 0: Återställ loggen med NORECOVERY
  • 1: återställ logg med STANDBY

@restore_mode är bitt och kan inte vara NULLdet.

[ @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. Standardvärdet är 0. @disconnect_users är bitt och kan inte vara NULLdet.

[ @block_size = ] 'block_size'

Storleken, i bytes, används som blockstorlek för backupenheten. @block_size är int med ett standardvärde på -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 ett standardvärde på -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_transfersize är int och kan vara 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 tröskelvärdet för säkerhetskopiering överskrids. @threshold_alert är int, med standardvärdet 14 420.

[ @threshold_alert_enabled = ] "threshold_alert_enabled"

Specificerar om en varning utlöses när @restore_threshold överskrids. Ett värde på 1 (standardvärdet) betyder att varningen höjs. @threshold_alert_enabled är lite.

[ @history_retention_period = ] '@history_retention_period'

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

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

Ingen.

Anmärkningar

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

  1. sp_add_log_shipping_secondary_primary bör anropas före denna lagrade procedur för att initiera den primära loggleveransdatabasen på den sekundära servern.

  2. Lägger till en post för den sekundära databasen med log_shipping_secondary_databases hjälp av de medföljande argumenten.

  3. Lägger till en lokal monitorpost på log_shipping_monitor_secondary den sekundära servern med hjälp av tillhandahållna argument.

  4. Om monitorservern skiljer sig från den sekundära servern, sp_add_log_shipping_secondary_database läggs en monitorpost till log_shipping_monitor_secondary på monitorservern med hjälp av medföljande argument.

Permissions

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

Examples

Detta exempel illustrerar användningen av sp_add_log_shipping_secondary_database den lagrade proceduren för att lägga till databasen LogShipAdventureWorks som en sekundär databas i en logghanteringskonfiguration där primärdatabasen AdventureWorks2025 finns på primärservern TRIBECA.

EXECUTE master.dbo.sp_add_log_shipping_secondary_database
    @secondary_database = N'LogShipAdventureWorks',
    @primary_server = N'TRIBECA',
    @primary_database = N'AdventureWorks2022',
    @restore_delay = 0,
    @restore_mode = 1,
    @disconnect_users = 0,
    @restore_threshold = 45,
    @threshold_alert_enabled = 0,
    @history_retention_period = 1440;
GO