sp_change_log_shipping_secondary_database (Transact-SQL)

Cambia la configuración de la base de datos secundaria.

Se aplica a: SQL Server (SQL Server 2008 a través de la versión actual).

Convenciones de sintaxis de 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 espera el servidor secundario antes de restaurar un archivo de copia de seguridad dado. 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. De lo contrario, se detiene tras haber restaurado 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 de entrada o salida máxima 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 generará cuando se supere el umbral de restauración. 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 restore_threshold. 1 = habilitadas; 0 = deshabilitadas. 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 se especifica ningún valor, se utiliza 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 el uso de sp_change_log_shipping_secondary_database para actualizar los parámetros de la base de datos secundaria para la base de datos LogShipAdventureWorks.

EXEC master.dbo.sp_change_log_shipping_secondary_database 
 @secondary_database =  'LogShipAdventureWorks'
,  @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

Procedimientos almacenados del sistema (Transact-SQL)

Conceptos

Acerca del trasvase de registros (SQL Server)