sp_add_log_shipping_secondary_primary (Transact-SQL)

  • Articolo

Imposta le informazioni del server primario, aggiunge collegamenti di monitoraggio locale e remoto e crea processi di copia e ripristino nel server secondario per il database primario specificato.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

sp_add_log_shipping_secondary_primary
 [ @primary_server = ] 'primary_server', 
[ @primary_database = ] 'primary_database',
[ @backup_source_directory = ] 'backup_source_directory' , 
[ @backup_destination_directory = ] 'backup_destination_directory'
[ @copy_job_name = ] 'copy_job_name'
[ @restore_job_name = ] 'restore_job_name'
[, [ @file_retention_period = ] 'file_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']
[, [ @copy_job_id = ] 'copy_job_id' OUTPUT ]
[, [ @restore_job_id = ] 'restore_job_id' OUTPUT ]
[, [ @secondary_id = ] 'secondary_id' OUTPUT]

Argomenti

  • [ @primary_server = ] 'primary_server'
    Nome dell'istanza primaria di Microsoft Motore di database di SQL Server nella configurazione di log shipping. primary_server è di tipo sysname e non può essere NULL.

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

  • [ @backup_source_directory = ] 'backup_source_directory'
    Directory in cui vengono archiviati i file di backup del log delle transazioni dal server primario. backup_source_directory è di tipo nvarchar(500) e non può essere NULL.

  • [ @backup_destination_directory = ] 'backup_destination_directory'
    Directory nel server secondario in cui vengono copiati i file di backup. backup_destination_directory è di tipo nvarchar(500) e non può essere NULL.

  • @copy_job_name = ] 'copy_job_name'
    Nome da utilizzare per il processo di SQL Server Agent creato per copiare i backup del log delle transazioni nel server secondario. copy_job_name è di tipo sysname e non può essere NULL.

  • [ @restore_job_name = ] 'restore_job_name'
    Nome del processo di SQL Server Agent nel server secondario che ripristina i backup nel database secondario. restore_job_name è di tipo sysname e non può essere NULL.

  • [ @file_retention_period = ] 'file_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.

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

  • [ @copy_job_id = ] 'copy_job_id' OUTPUT
    ID associato al processo di copia nel server secondario. copy_job_id è di tipo uniqueidentifier e non può essere NULL.

  • [ @restore_job_id = ] 'restore_job_id' OUTPUT
    ID associato al processo di ripristino nel server secondario. restore_job_id è di tipo uniqueidentifier e non può essere NULL.

  • [ @secondary_id = ] 'secondary_id' OUTPUT
    ID del server secondario nella configurazione per il log shipping. secondary_id è di tipo uniqueidentifier e non può essere NULL.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Nessuno

Osservazioni

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

  1. Genera un ID secondario per il server e il database primari specificati.

  2. Esegue le operazioni seguenti:

    1. Aggiunge una voce per l'ID secondario in log_shipping_secondary utilizzando gli argomenti specificati.

    2. Crea un processo di copia per l'ID secondario disabilitato.

    3. Imposta l'ID del processo di copia nella voce log_shipping_secondary come ID del processo di copia.

    4. Crea un processo di ripristino per l'ID secondario disabilitato.

    5. Imposta l'ID del processo di copia nella voce log_shipping_secondary come ID del processo di copia.

Autorizzazioni

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

Esempi

Nell'esempio seguente viene illustrato l'utilizzo della stored procedure sp_add_log_shipping_secondary_primary per impostare le informazioni per il database primario AdventureWorks2012 nel server secondario.

EXEC master.dbo.sp_add_log_shipping_secondary_primary 
@primary_server = N'TRIBECA' 
,@primary_database = N'AdventureWorks' 
,@backup_source_directory = N'\\tribeca\LogShipping' 
,@backup_destination_directory = N'' 
,@copy_job_name = N'' 
,@restore_job_name = N'' 
,@file_retention_period = 1440 
,@monitor_server = N'ROCKAWAY' 
,@monitor_server_security_mode = 1 
,@copy_job_id = @LS_Secondary__CopyJobId OUTPUT 
,@restore_job_id = @LS_Secondary__RestoreJobId OUTPUT 
,@secondary_id = @LS_Secondary__SecondaryId OUTPUT 
GO

Vedere anche

Riferimento

Stored procedure di sistema (Transact-SQL)

Concetti

Informazioni sul log shipping (SQL Server)