sp_add_log_shipping_secondary_database (Transact-SQL)
Configura una base de datos secundaria para el trasvase de registros.
Se aplica a: SQL Server (SQL Server 2008 a través de la versión actual). |
.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 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 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 haberse 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 sobrepase 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 uno (1), 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.
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:
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
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 LogShipAdventureWorks como base de datos secundaria en una configuración de trasvase de registros con la base de datos principal AdventureWorks2012 que reside en el servidor principal TRIBECA.
EXEC master.dbo.sp_add_log_shipping_secondary_database
@secondary_database = N'LogShipAdventureWorks'
,@primary_server = N'TRIBECA'
,@primary_database = N'AdventureWorks2012'
,@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)