Compartir a través de

  • Artículo

sp_add_log_shipping_secondary_database (Transact-SQL)

Configura una base de datos secundaria para el trasvase de registros.

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

Sintaxis

        sp_add_log_shipping_secondary_database
[ @secondary_database = ] 'secondary_database',
[ @primary_server = ] 'primary_server', 
[ @primary_database = ] 'primary_database',
[, [ @restore_delay = ] 'restore_delay']
[, [ @restore_all = ] 'restore_all']
[, [ @restore_mode = ] 'restore_mode']
[, [ @disconnect_users = ] 'disconnect_users']
[, [ @block_size = ] 'block_size']
[, [ @buffer_count = ] 'buffer_count']
[, [ @max_transfer_size = ] 'max_transfer_size']
[, [ @restore_threshold = ] 'restore_threshold'] 
[, [ @threshold_alert = ] 'threshold_alert'] 
[, [ @threshold_alert_enabled = ] 'threshold_alert_enabled'] 
[, [ @history_retention_period = ] 'history_retention_period']

Argumentos

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

  • [ @primary_server = ] 'primary_server'
    Nombre de la instancia principal de 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.

  • [ @restore_delay = ] 'restore_delay'
    Cantidad de tiempo, en minutos, que el servidor secundario espera antes de restaurar un archivo de copia de seguridad determinado. restore_delay es de tipo int y no puede ser NULL. El valor predeterminado es 0.

  • [ @restore_all = ] 'restore_all'
    Si se establece en 1, el servidor secundario restaura todas las copias de seguridad disponibles del registro de transacciones cuando se ejecuta el trabajo de restauración. Si no es así, se detiene después de la restauración de un archivo. restore_all es de tipo bit y no puede ser NULL.

  • [ @restore_mode = ] 'restore_mode'
    Modo de restauración para la base de datos secundaria.

    0 = Restaurar registro con NORECOVERY.

    1 = Restaurar registro con STANDBY.

    restore es de tipo bit y no puede ser NULL.

  • [ @disconnect_users = ] 'disconnect_users'
    Si se establece en 1, los usuarios se desconectarán de la base de datos secundaria cuando se realice una operación de restauración. Valor predeterminado = 0. disconnect es de tipo bit y no puede ser NULL.

  • [ @block_size = ] 'block_size'
    Tamaño, en bytes, que se usa como tamaño de bloque para el dispositivo de copia de seguridad. block_size es de tipo int y su valor predeterminado es -1.

  • [ @buffer_count = ] 'buffer_count'
    Número total de búferes usados por la operación de copia de seguridad o restauración. buffer_count es de tipo int y su valor predeterminado es -1.

  • [ @max_transfer_size = ] 'max_transfer_size'
    Tamaño, en bytes, de la solicitud máxima de entrada o salida emitida por SQL Server al dispositivo de copia de seguridad. max_transfersize es de tipo int y puede ser NULL.

  • [ @restore_threshold = ] 'restore_threshold'
    Número de minutos permitido entre las operaciones de restauración antes de que se genere una alerta. restore_threshold es de tipo int y no puede ser NULL.

  • [ @threshold_alert = ] 'threshold_alert'
    Es la alerta que se genera si se supera el umbral de copia de seguridad. threshold_alert es de tipo int y su valor predeterminado es 14,420.

  • [ @threshold_alert_enabled = ] 'threshold_alert_enabled'
    Especifica si se generará una alerta cuando se exceda backup_threshold. El valor 1, el predeterminado, significa que se generará la alerta. threshold_alert_enabled es de tipo bit.

  • [ @history_retention_period = ] 'history_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 usa 14420.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Ninguno

Comentarios

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

  1. Antes de que este procedimiento almacenado inicialice la información de base de datos de trasvase de registros principal en el servidor secundario, debe llamarse a sp_add_log_shipping_secondary_primary.

  2. Agrega una entrada para la base de datos secundaria en log_shipping_secondary_databases utilizando los argumentos proporcionados.

  3. Agrega un registro de supervisión local en log_shipping_monitor_secondary en el servidor secundario utilizando los argumentos proporcionados.

  4. Si el servidor de supervisión es distinto al servidor secundario, agrega un registro de supervisión en log_shipping_monitor_secondary en el servidor de supervisión utilizando los argumentos proporcionados.

Permisos

Solo pueden ejecutar este procedimiento los miembros del rol fijo de servidor sysadmin.

Ejemplos

En este ejemplo se muestra la utilización del procedimiento almacenado sp_add_log_shipping_secondary_database para agregar la base de datos LogShipAdventureWorks2008R2 como base de datos secundaria en una configuración de trasvase de registros con la base de datos principal AdventureWorks2008R2, que reside en el servidor principal TRIBECA.

EXEC master.dbo.sp_add_log_shipping_secondary_database 
@secondary_database = N'LogShipAdventureWorks2008R2' 
,@primary_server = N'TRIBECA' 
,@primary_database = N'AdventureWorks2008R2' 
,@restore_delay = 0 
,@restore_mode = 1 
,@disconnect_users = 0 
,@restore_threshold = 45   
,@threshold_alert_enabled = 0 
,@history_retention_period = 1440 
GO