sp_change_log_shipping_primary_database (Transact-SQL)

Sintassi

sp_change_log_shipping_primary_database [ @database = ] 'database'
[, [ @backup_directory = ] 'backup_directory'] 
[, [ @backup_share = ] '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 ] 

Argomenti

• [ @database = ] 'database'
  Nome del database nel server primario. primary_database è di tipo sysname e non prevede alcun valore predefinito.

• [ @backup_directory = ] 'backup_directory'
  Percorso della cartella di backup nel server primario. backup_directory è di tipo nvarchar(500), non prevede alcun valore predefinito e non può essere NULL.

• [ @backup_share = ] 'backup_share'
  Percorso di rete della directory di backup nel server primario. backup_share è di tipo nvarchar(500), non prevede alcun valore predefinito e non può essere NULL.

• [ @backup_retention_period = ] 'backup_retention_period'
  Periodo di tempo, in minuti, per cui il file di backup del log deve essere mantenuto nella directory di backup nel server primario. backup_retention_period è di tipo int, non prevede alcun valore predefinito e non può essere NULL.

• [ @monitor_server_security_mode = ] 'monitor_server_security_mode'
  Modalità di protezione utilizzata per connettersi al server di monitoraggio.

  1 = Autenticazione di Windows.

  0 = Autenticazione di SQL Server.

  monitor_server_security_mode è di tipo bit e non può essere NULL.

• [ @monitor_server_login = ] 'monitor_server_login'
  Nome utente dell'account utilizzato per accedere al server di monitoraggio.

• [ @monitor_server_password = ] 'monitor_server_password'
  Password dell'account utilizzato per accedere al server di monitoraggio.

• [ @backup_threshold = ] 'backup_threshold'
  Periodo di tempo, in minuti, trascorso dall'ultimo backup prima che venga generato un errore threshold_alert. backup_threshold è di tipo int e il valore predefinito è 60 minuti.

• [ @threshold_alert = ] 'threshold_alert'
  Avviso da generare quando viene superata la soglia di backup. threshold_alert è di tipo int e non può essere NULL.

• [ @threshold_alert_enabled = ] 'threshold_alert_enabled'
  Specifica se allo scadere del tempo immesso in backup_threshold verrà generato un avviso.

  1 = Abilitato.

  0 = Disabilitato.

  threshold_alert_enabled è di tipo bit e non può essere NULL.

• [ @history_retention_period = ] 'history_retention_period'
  Periodo di memorizzazione della cronologia espresso in minuti. history_retention_period è di tipo int. Se non si specifica un valore, verrà utilizzato il valore 14420.

• [ @backup_compression = ] backup_compression_option
  Specifica se una configurazione per il log shipping utilizza la compressione dei backup. Questo parametro è supportato solo in SQL Server 2008 Enterprise Edition o versione successiva.

  0 = disabilitata. I backup del log non vengono mai compressi.

  1 = abilitata. I backup del log vengono sempre compressi.

  2= viene utilizzata l'opzione di configurazione del server backup compression default. Si tratta del valore predefinito.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Nessuno

Osservazioni

La stored procedure sp_change_log_shipping_primary_database deve essere eseguita nel database master nel server primario. Questa stored procedure esegue le operazioni seguenti:

1. Modifica le impostazioni del record di log_shipping_secondary_database, se necessario.

2. Modifica il record locale in log_shipping_monitor_primary nel server primario utilizzando gli argomenti specificati, se necessario.

3. Se il server di monitoraggio è diverso dal server primario, modifica il record in log_shipping_monitor_primary nel server di monitoraggio utilizzando gli argomenti specificati, se necessario.

Autorizzazioni

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

Esempi

Nell'esempio seguente viene illustrato l'utilizzo di sp_change_log_shipping_primary_database per aggiornare le impostazioni associate al database primario AdventureWorks.

EXEC 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

Vedere anche

Riferimento

Concetti

Altre risorse