sys.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

sys.sp_add_log_shipping_secondary_database
    [ @secondary_database = ] N'secondary_database'
    , [ @primary_server = ] N'primary_server'
    , [ @primary_database = ] N'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 ]
    [ , [ @overwrite = ] overwrite ]
    [ , [ @ignoreremotemonitor = ] ignoreremotemonitor ]
[ ; ]

Arguments

[ @secondary_database = ] N'secondary_database'

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

[ @primary_server = ] N'primary_server'

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

[ @primary_database = ] N'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.

[ @overwrite = ] skriv över

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

[ @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

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