• Artículo

sp_add_log_shipping_secondary_primary (Transact-SQL)

Configura la información principal, agrega vínculos de supervisión local y remota, y crea trabajos de copia y restauración en el servidor secundario para la base de datos principal especificada.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

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]

Argumentos

  • [ @primary_server = ] 'primary_server'
    Nombre de la instancia principal del SQL Server Database Engine (Motor de base de datos de SQL Server) de Microsoft en la configuración del trasvase de registros. primary_server es de tipo sysname y no puede ser NULL.

  • [ @primary_database = ] 'primary_database'
    Es el nombre de la base de datos en el servidor principal. primary_database es de tipo sysname y no tiene ningún valor predeterminado.

  • [ @backup_source_directory = ] 'backup_source_directory'
    Directorio donde se almacenan los archivos de copia de seguridad del registro de transacciones del servidor principal. backup_source_directory es de tipo nvarchar(500) y no puede ser NULL.

  • [ @backup_destination_directory = ] 'backup_destination_directory'
    Directorio del servidor secundario donde se copian los archivos de copia de seguridad. backup_destination_directory es de tipo nvarchar(500) y no puede ser NULL.

  • [ @copy_job_name = ] 'copy_job_name'
    Nombre que se usará para el trabajo del Agente SQL Server que se va a crear para copiar las copias de seguridad del registro de transacciones en el servidor secundario. copy_job_name es de tipo sysname y no puede ser NULL.

  • [ @restore_job_name = ] 'restore_job_name'
    Es el nombre del trabajo del Agente SQL Server en el servidor secundario que restaura las copias de seguridad en la base de datos secundaria. restore_job_name es de tipo sysname y no puede ser NULL.

  • [ @file_retention_period = ] 'file_retention_period'
    Es la cantidad de tiempo en minutos durante la que se retiene el historial. history_retention_period es de tipo int y su valor predeterminado es NULL. Si no se especifica ningún valor, se utiliza 14420.

  • [ @monitor_server = ] 'monitor_server'
    Es el nombre del servidor de supervisión. Monitor_server es de tipo sysname, no tiene ningún valor predeterminado y no puede ser NULL.

  • [ @monitor_server_security_mode = ] 'monitor_server_security_mode'
    Modo de seguridad utilizado para conectarse al servidor de supervisión.

    1 = Autenticación de Windows.

    0 = Autenticación de SQL Server.

    monitor_server_security_mode es de tipo bit y no puede ser NULL.

  • [ @monitor_server_login = ] 'monitor_server_login'
    Es el nombre de usuario de la cuenta utilizada para tener acceso al servidor de supervisión.

  • [ @monitor_server_password = ] 'monitor_server_password'
    Es la contraseña de la cuenta utilizada para tener acceso al servidor de supervisión.

  • [ @copy_job_id = ] 'copy_job_id' OUTPUT
    Es el Id. asociado al trabajo de copia en el servidor secundario. copy_job_id es de tipo uniqueidentifier y no puede ser NULL.

  • [ @restore_job_id = ] 'restore_job_id' OUTPUT
    Es el Id. asociado al trabajo de restauración en el servidor secundario. restore_job_id es de tipo uniqueidentifier y no puede ser NULL.

  • [ @secondary_id = ] 'secondary_id' OUTPUT
    Id. del servidor secundario en la configuración del trasvase de registros. secondary_id es de tipo uniqueidentifier y no puede ser NULL.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Ninguno

Comentarios

sp_add_log_shipping_secondary_primary se debe ejecutar desde la base de datos maestra del servidor secundario. Este procedimiento almacenado hace lo siguiente:

  1. Genera un Id. secundario para el servidor principal y la base de datos principal especificados.

  2. Realiza las operaciones siguientes:

    1. Agrega una entrada para el Id. secundario en log_shipping_secondary utilizando los argumentos proporcionados.

    2. Crea un trabajo de copia para el Id. secundario que está deshabilitado.

    3. Establece el Id. del trabajo de copia de la entrada log_shipping_secondary en el Id. del trabajo de copia.

    4. Crea un trabajo de restauración para el Id. secundario que está deshabilitado.

    5. Establece el Id. del trabajo de restauración de la entrada log_shipping_secondary en el Id. del trabajo de restauración.

Permisos

Sólo pueden ejecutar este procedimiento los miembros del rol fijo de servidor sysadmin.

Ejemplos

Este ejemplo muestra el uso del procedimiento almacenado sp_add_log_shipping_secondary_primary para configurar información de la base de datos principal AdventureWorks2008R2 en el servidor secundario.

EXEC master.dbo.sp_add_log_shipping_secondary_primary 
@primary_server = N'TRIBECA' 
,@primary_database = N'AdventureWorks2008R2' 
,@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