sp_change_log_shipping_secondary_database (Transact-SQL)

Sintaxis

sp_change_log_shipping_secondary_database
[ @secondary_database = ] 'secondary_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

• [ @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_users es de tipo bit y no puede ser NULL.

• [ @block_size = ] 'block_size'
  Tamaño, en bytes, que se utiliza 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 utilizados 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 14420.

• [ @threshold_alert_enabled = ] 'threshold_alert_enabled'
  Especifica si se generará una alerta cuando se exceda backup_threshold. 1 = habilitada; 0 = deshabilitada. threshold_alert_enabled es de tipo bit y no puede ser NULL.

• [ @history_retention_period = ] 'history_retention_period'
  Es la cantidad de tiempo en minutos durante la que se retendrá el historial. history_retention_period es de tipo int. Si no es especifica un valor, se utilizará 1440.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Ninguno

Comentarios

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

1. Cambia la configuración de los registros de log_shipping_secondary_database según sea necesario.

2. Cambia el registro de supervisión local en log_shipping_monitor_secondary en el servidor secundario utilizando los argumentos proporcionados en caso de ser necesario.

Permisos

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

Ejemplos

En este ejemplo se muestra cómo utilizar sp_change_log_shipping_secondary_database para actualizar los parámetros de la base de datos secundaria para LogShipAdventureWorks2008R2. de la base de datos.

EXEC master.dbo.sp_change_log_shipping_secondary_database 
 @secondary_database =  'LogShipAdventureWorks2008R2'
,  @restore_delay = 0
,  @restore_all = 1
,  @restore_mode = 0
,  @disconnect_users = 0
,  @threshold_alert = 14420
,  @threshold_alert_enabled = 1
,  @history_retention_period = 14420

Vea también

Referencia

Conceptos

Otros recursos