sp_change_log_shipping_secondary_database (Transact-SQL)

Articolo
12/22/2023

Si applica a:SQL Server

Modifica le impostazioni del database secondario.

Sintassi

  
sp_change_log_shipping_secondary_database  
[ @secondary_database = ] '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']

Argomenti

[ @restore_delay = ] 'restore_delay' Intervallo di tempo, espresso in minuti, che il server secondario attende prima di ripristinare un determinato file di backup. restore_delay è int e non può essere NULL. Il valore predefinito è 0.

[ @restore_all = ] 'restore_all' Se impostato su 1, il server secondario ripristina tutti i backup del log delle transazioni disponibili quando viene eseguito il processo di ripristino. In caso contrario, l'operazione viene arrestata dopo il ripristino di un file. restore_all è bit e non può essere NULL.

[ @restore_mode = ] 'restore_mode' Modalità di ripristino per il database secondario.

0 = ripristino log con NORECOVERY.

1 = Ripristina log con STANDBY.

restore è bit e non può essere NULL.

[ @disconnect_users = ] 'disconnect_users' Se impostato su 1, gli utenti vengono disconnessi dal database secondario quando viene eseguita un'operazione di ripristino. Valore predefinito = 0. disconnect_users è bit e non può essere NULL.

[ @block_size = ] 'block_size' Dimensioni, in byte, usate come dimensioni del blocco per il dispositivo di backup. block_size è int con il valore predefinito -1.

[ @buffer_count = ] 'buffer_count' Numero totale di buffer utilizzati dall'operazione di backup o ripristino. buffer_count è int con il valore predefinito -1.

[ @max_transfer_size = ] 'max_transfer_size' Dimensioni, in byte, della richiesta di input o output massima rilasciata da SQL Server al dispositivo di backup. max_transfersize è int e può essere NULL.

[ @restore_threshold = ] 'restore_threshold' Numero di minuti consentiti tra le operazioni di ripristino prima che venga generato un avviso. restore_threshold è int e non può essere NULL.

[ @threshold_alert = ] 'threshold_alert' Avviso da generare quando viene superata la soglia di ripristino. threshold_alert è int, con un valore predefinito 14421.

[ @threshold_alert_enabled = ] 'threshold_alert_enabled' Specifica se verrà generato un avviso quando viene superato restore_threshold. 1 = abilitato; 0 = disabilitato. threshold_alert_enabled è bit e non può essere NULL.

[ @history_retention_period = ] 'history_retention_period' Periodo di tempo in minuti in cui verrà mantenuta la cronologia. history_retention_period è int. Se non viene specificato alcun valore, verrà utilizzato il valore 1440.

Valori del codice restituito

0 (operazione completata) o 1 (operazione non riuscita)

Set di risultati

None

Osservazioni:

sp_change_log_shipping_secondary_database deve essere eseguito dal database master nel server secondario. Questa stored procedure esegue le operazioni seguenti:

Modifica le impostazioni nei record log_shipping_secondary_database in base alle esigenze.
Modifica il record di monitoraggio locale in log_shipping_monitor_secondary nel server secondario utilizzando argomenti forniti, se necessario.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin possono eseguire questa procedura.

Esempi

Questo esempio illustra l'uso di sp_change_log_shipping_secondary_database per aggiornare i parametri di database secondari per il database LogShipAdventureWorks.

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

Vedi anche

Informazioni sul log shipping (SQL Server)
Stored procedure di sistema (Transact-SQL)