sp_add_log_shipping_primary_database (Transact-SQL)
Imposta il database primario per una configurazione per la distribuzione dei log, specificando il processo di backup, il record di monitoraggio locale e il record di monitoraggio remoto.
Convenzioni della sintassi 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]
Argomenti
- [ @database = ] 'database'
Nome del database primario per la distribuzione dei log. 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 Microsoft Windows.
0 = Microsoft 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 1 (valore predefinito) indica che l'avviso 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 la distribuzione dei log. primary_id è di tipo uniqueidentifier e non può essere NULL.
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:
- Genera un ID primario e aggiunge una voce relativa al database primario nella tabella log_shipping_primary_databases utilizzando gli argomenti specificati.
- Crea un processo di backup per il database primario disattivato.
- Imposta l'ID del processo di backup nella voce della tabella log_shipping_primary_databases sull'ID del processo di backup.
- Aggiunge un record di monitoraggio locale nella tabella log_shipping_monitor_primary nel server primario utilizzando gli argomenti specificati.
- 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.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Esempi
In questo esempio il database AdventureWorks viene aggiunto come database primario in una configurazione per la distribuzione dei log.
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
GO
Vedere anche
Riferimento
Stored procedure di sistema (Transact-SQL)
Altre risorse
Distribuzione dei log
Tabelle e stored procedure relative alla distribuzione dei log