sp_add_log_shipping_primary_database (Transact-SQL)sp_add_log_shipping_primary_database (Transact-SQL)

QUESTO ARGOMENTO SI APPLICA A:sìSQL Server (a partire dalla versione 2008)noDatabase SQL di AzurenoAzure SQL Data Warehouse noParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Imposta il database primario per una configurazione di log shipping, inclusi il processo di backup, il record di monitoraggio locale e il record di monitoraggio remoto.Sets up the primary database for a log shipping configuration, including the backup job, local monitor record, and remote monitor record.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintassiSyntax


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 ]  

ArgomentiArguments

[ @database= ] 'database'[ @database= ] 'database'
Nome del database primario per il log shipping.Is the name of the log shipping primary database. database viene sysname, non prevede alcun valore predefinito e non può essere NULL.database is sysname, with no default, and cannot be NULL.

[ @backup_directory= ] 'backup_directory'[ @backup_directory= ] 'backup_directory'
Percorso della cartella di backup nel server primario.Is the path to the backup folder on the primary server. backup_directory viene nvarchar(500), non prevede alcun valore predefinito e non può essere NULL.backup_directory is nvarchar(500), with no default, and cannot be NULL.

[ @backup_share= ] 'backup_share'[ @backup_share= ] 'backup_share'
Percorso di rete della directory di backup nel server primario.Is the network path to the backup directory on the primary server. backup_share viene nvarchar(500), non prevede alcun valore predefinito e non può essere NULL.backup_share is nvarchar(500), with no default, and cannot be NULL.

[ @backup_job_name= ] 'backup_job_name'[ @backup_job_name= ] 'backup_job_name'
Nome del processo di SQL Server Agent nel server primario che copia il backup nella cartella di backup.Is the name of the SQL Server Agent job on the primary server that copies the backup into the backup folder. backup_job_name viene sysname e non può essere NULL.backup_job_name is sysname and cannot be NULL.

[ @backup_retention_period= ] backup_retention_period[ @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.Is the length of time, in minutes, to retain the log backup file in the backup directory on the primary server. backup_retention_period viene int, non prevede alcun valore predefinito e non può essere NULL.backup_retention_period is int, with no default, and cannot be NULL.

[ @monitor_server= ] 'monitor_server'[ @monitor_server= ] 'monitor_server'
Nome del server di monitoraggio.Is the name of the monitor server. Monitor_server viene sysname, non prevede alcun valore predefinito e non può essere NULL.Monitor_server is sysname, with no default, and cannot be NULL.

[ @monitor_server_security_mode= ] monitor_server_security_mode[ @monitor_server_security_mode= ] monitor_server_security_mode
Modalità di sicurezza utilizzata per connettersi al server di monitoraggio.The security mode used to connect to the monitor server.

1 = Autenticazione di Windows.1 = Windows Authentication.

0 = SQL ServerSQL Server l'autenticazione.0 = SQL ServerSQL Server Authentication. monitor_server_security_mode viene bit e non può essere NULL.monitor_server_security_mode is bit and cannot be NULL.

[ @monitor_server_login= ] 'monitor_server_login'[ @monitor_server_login= ] 'monitor_server_login'
Nome utente dell'account utilizzato per accedere al server di monitoraggio.Is the username of the account used to access the monitor server.

[ @monitor_server_password= ] 'monitor_server_password'[ @monitor_server_password= ] 'monitor_server_password'
Password dell'account utilizzato per accedere al server di monitoraggio.Is the password of the account used to access the monitor server.

[ @backup_threshold= ] backup_threshold[ @backup_threshold= ] backup_threshold
Periodo di tempo, espresso in minuti, dopo l'ultimo backup prima di un threshold_alert viene generato l'errore.Is the length of time, in minutes, after the last backup before a threshold_alert error is raised. backup_threshold viene int, con un valore predefinito è 60 minuti.backup_threshold is int, with a default of 60 minutes.

[ @threshold_alert= ] threshold_alert[ @threshold_alert= ] threshold_alert
Avviso da generare quando viene superata la soglia per il backup.Is the alert to be raised when the backup threshold is exceeded. threshold_alert viene int, con un valore predefinito è 14,420.threshold_alert is int, with a default of 14,420.

[ @threshold_alert_enabled= ] threshold_alert_enabled[ @threshold_alert_enabled= ] threshold_alert_enabled
Specifica se un avviso verrà generato quando backup_threshold viene superato.Specifies whether an alert will be raised when backup_threshold is exceeded. Il valore predefinito 0 indica che l'avviso è disabilitato e non verrà generato.The value of zero (0), the default, means that the alert is disabled and will not be raised. threshold_alert_enabled viene bit.threshold_alert_enabled is bit.

[ @history_retention_period= ] history_retention_period[ @history_retention_period= ] history_retention_period
Periodo di memorizzazione della cronologia espresso in minuti.Is the length of time in minutes in which the history will be retained. history_retention_period viene int, con un valore predefinito è NULL.history_retention_period is int, with a default of NULL. Se non si specifica un valore, verrà utilizzato il valore 14420.A value of 14420 will be used if none is specified.

[ @backup_job_id= ] backup_job_id OUTPUT[ @backup_job_id= ] backup_job_id OUTPUT
ID del processo di SQL ServerSQL Server Agent associato al processo di backup nel server primario.The SQL ServerSQL Server Agent job ID associated with the backup job on the primary server. backup_job_id viene uniqueidentifier e non può essere NULL.backup_job_id is uniqueidentifier and cannot be NULL.

[ @primary_id= ] primary_id OUTPUT[ @primary_id= ] primary_id OUTPUT
ID del database primario nella configurazione per il log shipping.The ID of the primary database for the log shipping configuration. primary_id viene uniqueidentifier e non può essere NULL.primary_id is uniqueidentifier and cannot be NULL.

[ @backup_compression=] backup_compression_option[ @backup_compression= ] backup_compression_option
Specifica se una configurazione di log shipping utilizza compressione dei backup.Specifies whether a log shipping configuration uses backup compression. Questo parametro è supportato solo in SQL Server 2008 Enterprise EditionSQL Server 2008 Enterprise o versione successiva.This parameter is supported only in SQL Server 2008 Enterprise EditionSQL Server 2008 Enterprise (or a later version).

0 = disabilitati.0 = Disabled. I backup del log non vengono mai compressi.Never compress log backups.

1 = abilitati.1 = Enabled. I backup del log vengono sempre compressi.Always compress log backups.

2 = utilizzare l'impostazione di consente di visualizzare o configurare l'opzione di configurazione del Server di backup compression default.2 = Use the setting of the View or Configure the backup compression default Server Configuration Option. Si tratta del valore predefinito.This is the default value.

Valori restituitiReturn Code Values

0 (esito positivo) o 1 (esito negativo)0 (success) or 1 (failure)

Set di risultatiResult Sets

NessunoNone

OsservazioniRemarks

sp_add_log_shipping_primary_database deve essere eseguita la master database nel server primario.sp_add_log_shipping_primary_database must be run from the master database on the primary server. Questa stored procedure esegue le funzioni seguenti:This stored procedure performs the following functions:

  1. Genera un ID primario e aggiunge una voce per il database primario nella tabella log_shipping_primary_databases utilizzando gli argomenti specificati.Generates a primary ID and adds an entry for the primary database in the table log_shipping_primary_databases using the supplied arguments.

  2. Crea un processo di backup per il database primario disabilitato.Creates a backup job for the primary database that is disabled.

  3. Imposta l'ID di processo di backup di log_shipping_primary_databases voce per l'ID di processo del processo di backup.Sets the backup job ID in the log_shipping_primary_databases entry to the job ID of the backup job.

  4. Aggiunge un record di monitoraggio locale nella tabella log_shipping_monitor_primary nel server primario utilizzando gli argomenti specificati.Adds a local monitor record in the table log_shipping_monitor_primary on the primary server using supplied arguments.

  5. Se il server di monitoraggio è diverso dal server primario, aggiunge un record di monitoraggio in log_shipping_monitor_primary sul monitor di server utilizzando gli argomenti specificati.If the monitor server is different from the primary server, adds a monitor record in log_shipping_monitor_primary on the monitor server using supplied arguments.

AutorizzazioniPermissions

Solo i membri del sysadmin ruolo predefinito del server possono eseguire questa procedura.Only members of the sysadmin fixed server role can run this procedure.

EsempiExamples

In questo esempio il database AdventureWorks2012AdventureWorks2012 viene aggiunto come database primario in una configurazione per il log shipping.This example adds the database AdventureWorks2012AdventureWorks2012 as the primary database in a log shipping configuration.

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 ancheSee Also

Informazioni sul Log Shipping & #40; SQL Server & #41; About Log Shipping (SQL Server)
Stored procedure di sistema (Transact-SQL)System Stored Procedures (Transact-SQL)