sp_change_log_shipping_secondary_database (Transact-SQL)

  • Artículo

Se aplica a: SQL Server

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

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_change_log_shipping_secondary_database
    [ @secondary_database = ] N'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 ]
    [ , [ @ignoreremotemonitor = ] ignoreremotemonitor ]
[ ; ]

Argumentos

[ @secondary_database = ] N'secondary_database'

Nombre de la base de datos en el servidor secundario. @secondary_database es sysname, sin ningún valor predeterminado.

[ @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 int, con un valor predeterminado de 0y no puede ser NULL.

[ @restore_all = ] restore_all

Si se establece en 1, el servidor secundario restaura todas las copias de seguridad del registro de transacciones disponibles cuando se ejecuta el trabajo de restauración. De lo contrario, se detiene tras haberse restaurado un archivo. @restore_all es bit y no puede ser NULL.

[ @restore_mode = ] restore_mode

Modo de restauración para la base de datos secundaria. @restore_mode es bit y no puede ser NULL.

  • 0 = restaurar el registro con NORECOVERY.
  • 1 = restaurar el registro con STANDBY.

[ @disconnect_users = ] disconnect_users

Si se establece en 1, los usuarios se desconectan de la base de datos secundaria cuando se realiza una operación de restauración. @disconnect_users es bit, con un valor predeterminado de 0y 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 int, con un valor predeterminado de -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 int, con un valor predeterminado de -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_transfer_size es int, con un valor predeterminado de 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 int y no puede ser NULL.

[ @threshold_alert = ] threshold_alert

Alerta que se generará cuando se sobrepase el umbral de restauración. @threshold_alert es int, con un valor predeterminado de 14421.

[ @threshold_alert_enabled = ] threshold_alert_enabled

Especifica si se genera una alerta cuando se supera @restore_threshold .

  • 1 = habilitado
  • 0 = deshabilitado.

@threshold_alert_enabled es bit y no puede ser NULL.

[ @history_retention_period = ] history_retention_period

El período de tiempo en minutos en el que se conserva el historial. @history_retention_period es int, con un valor predeterminado de 1440.

[ @ignoreremotemonitor = ] ignoreremotemonitor

Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto de resultados

Ninguno.

Comentarios

sp_change_log_shipping_secondary_database debe ejecutarse desde la master base de datos en el servidor secundario. Este procedimiento almacenado realiza los pasos siguientes:

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

  2. Cambia el registro del monitor local en log_shipping_monitor_secondary en el servidor secundario mediante argumentos proporcionados, si es necesario.

Permisos

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

Ejemplos

En este ejemplo se muestra el uso sp_change_log_shipping_secondary_database de para actualizar los parámetros de base de datos secundarios de 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;

Contenido relacionado