sp_add_log_shipping_secondary_database (Transact-SQL)
Configura una base de datos secundaria para el trasvase de registros.
.gif "Icono de vínculo a temas")
Convenciones 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 primario. 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 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 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 utiliza 14420.
Conjuntos de resultados
Ninguno
Notas
sp_add_log_shipping_secondary_database se debe ejecutar desde la base de datos master del servidor secundario. Este procedimiento almacenado hace lo siguiente:
- 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.
- Agrega una entrada para la base de datos secundaria en log_shipping_secondary_databases utilizando los argumentos proporcionados.
- Agrega un registro de supervisión local en log_shipping_monitor_secondary en el servidor secundario utilizando los argumentos proporcionados.
- 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
Sólo pueden ejecutar este procedimiento los miembros de la función fija de servidor sysadmin.
Valores de código de retorno
0 (correcto) o 1 (error)
Ejemplos
En este ejemplo se muestra la utilización del procedimiento almacenado sp_add_log_shipping_secondary_database para agregar la base de datos LogShipAdventureWorks como base de datos secundaria en una configuración de trasvase de registros con la base de datos primaria AdventureWorks que reside en el servidor primario TRIBECA.
EXEC master.dbo.sp_add_log_shipping_secondary_database
@secondary_database = N'LogShipAdventureWorks'
,@primary_server = N'TRIBECA'
,@primary_database = N'AdventureWorks'
,@restore_delay = 0
,@restore_mode = 1
,@disconnect_users = 0
,@restore_threshold = 45
,@threshold_alert_enabled = 0
,@history_retention_period = 1440
GO
Vea también
Referencia
Procedimientos almacenados del sistema (Transact-SQL)
Otros recursos
Trasvase de registros
Tablas y procedimientos almacenados de trasvase de registros