sp_add_log_shipping_primary_database (Transact-SQL)

Sintassi

sp_add_log_shipping_primary_database [ @database = ] 'database', 
[ @backup_directory = ] 'backup_directory', 
[ @backup_share = ] 'backup_share', 
[ @backup_job_name = ] 'backup_job_name', 
[, [ @backup_retention_period = ] backup_retention_period]
[, [ @monitor_server = ] 'monitor_server']
[, [ @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_job_id = ] backup_job_id OUTPUT ]
[, [ @primary_id = ] primary_id OUTPUT]
[, [ @backup_compression = ] backup_compression_option ] 

Argomenti

• [ @database= ] 'database'
  Nome del database primario per il log shipping. database è di tipo sysname, non prevede alcun valore predefinito e non può essere NULL.

• [ @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_job_name= ] 'backup_job_name'
  Nome del processo di SQL Server Agent nel server primario che copia il backup nella cartella di backup. backup_job_name è di tipo sysname 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= ] 'monitor_server'
  Nome del server di monitoraggio. Monitor_server è di tipo sysname, 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 generato quando viene superata la soglia di backup. threshold_alert è di tipo int e il valore predefinito è 14.420.

• [ @threshold_alert_enabled= ] threshold_alert_enabled
  Specifica se allo scadere del tempo immesso in backup_threshold verrà generato un avviso. Il valore predefinito 0 indica che l'avviso è disabilitato e non verrà generato. threshold_alert_enabled è di tipo bit.

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

• [ @backup_job_id= ] backup_job_id OUTPUT
  ID del processo di SQL Server Agent associato al processo di backup nel server primario. backup_job_id è di tipo uniqueidentifier e non può essere NULL.

• [ @primary_id= ] primary_id OUTPUT
  ID del database primario per la configurazione per il log shipping. primary_id è di tipo uniqueidentifier e non può essere NULL.

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

sp_add_log_shipping_primary_database deve essere eseguita dal database master nel server primario. Questa stored procedure esegue le funzioni seguenti:

1. Genera un ID primario e aggiunge una voce relativa al database primario nella tabella log_shipping_primary_databases utilizzando gli argomenti specificati.

2. Crea un processo di backup per il database primario disabilitato.

3. Imposta l'ID del processo di backup nella voce della tabella log_shipping_primary_databases sull'ID del processo di backup.

4. Aggiunge un record di monitoraggio locale nella tabella log_shipping_monitor_primary nel server primario utilizzando gli argomenti specificati.

5. Se il server di monitoraggio è diverso dal server primario, aggiunge un record di monitoraggio nella tabella log_shipping_monitor_primary nel server di monitoraggio utilizzando gli argomenti specificati.

Autorizzazioni

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

Esempi

In questo esempio il database AdventureWorks viene aggiunto come database primario in una configurazione per il log shipping.

DECLARE @LS_BackupJobId AS uniqueidentifier 
DECLARE @LS_PrimaryId AS uniqueidentifier 

EXEC master.dbo.sp_add_log_shipping_primary_database 
@database = N'AdventureWorks' 
,@backup_directory = N'c:\lsbackup' 
,@backup_share = N'\\tribeca\lsbackup' 
,@backup_job_name = N'LSBackup_AdventureWorks' 
,@backup_retention_period = 1440
,@monitor_server = N'rockaway' 
,@monitor_server_security_mode = 1 
,@backup_threshold = 60 
,@threshold_alert = 0 
,@threshold_alert_enabled = 0 
,@history_retention_period = 1440 
,@backup_job_id = @LS_BackupJobId OUTPUT 
,@primary_id = @LS_PrimaryId OUTPUT 
,@overwrite = 1 
,@backup_compression = 0
GO

Vedere anche

Riferimento

Concetti

Altre risorse