sp_add_log_shipping_primary_database (Transact-SQL)
Establece la base de datos primaria para una configuración de trasvase de registros, incluidos el trabajo de copia de seguridad, el registro de supervisión local y el registro de supervisión remoto.
Convenciones de sintaxis de Transact-SQL
Sintaxis
sp_add_log_shipping_primary_database [ @database = ] 'database',
[ @backup_directory = ] 'backup_directory',
[ @backup_share = ] 'backup_share',
[ @backup_job_name = ] 'backup_job_name'
[, [ @backup_retention_period = ] backup_retention_period]
[, [ @monitor_server = ] 'monitor_server']
[, [ @monitor_server_security_mode = ] monitor_server_security_mode]
[, [ @monitor_server_login = ] 'monitor_server_login']
[, [ @monitor_server_password = ] 'monitor_server_password']
[, [ @backup_threshold = ] backup_threshold ]
[, [ @threshold_alert = ] threshold_alert ]
[, [ @threshold_alert_enabled = ] threshold_alert_enabled ]
[, [ @history_retention_period = ] history_retention_period ]
[, [ @backup_job_id = ] backup_job_id OUTPUT ]
[, [ @primary_id = ] primary_id OUTPUT]
Argumentos
- [ @database = ] 'database'
Es el nombre de la base de datos primaria de trasvase de registros. database es de tipo sysname, no tiene ningún valor predeterminado y no puede ser NULL.
- [ @backup_directory = ] 'backup_directory'
Es la ruta de acceso a la carpeta de copia de seguridad del servidor primario. backup_directory es de tipo nvarchar(500), no tiene ningún valor predeterminado y no puede ser NULL.
- [ @backup_share = ] 'backup_share'
Es la ruta de acceso de red al directorio de copia de seguridad del servidor primario. backup_share es de tipo nvarchar(500), no tiene ningún valor predeterminado y no puede ser NULL.
- [ @backup_job_name = ] 'backup_job_name'
Es el nombre del trabajo del Agente SQL Server en el servidor primario que guarda la copia de seguridad en la carpeta de copia de seguridad. backup_job_name es de tipo sysname y no puede ser NULL.
- [ @backup_retention_period = ] backup_retention_period
Es el tiempo, en minutos, durante el que se retiene el archivo de copia de seguridad de registros en el directorio de copia de seguridad del servidor primario. backup_retention_period es de tipo int, no tiene ningún valor predeterminado y no puede ser NULL.
- [ @monitor_server = ] 'monitor_server'
Es el nombre del servidor de supervisión. Monitor_server es de tipo sysname, no tiene ningún valor predeterminado y no puede ser NULL.
[ @monitor_server_security_mode = ] monitor_server_security_mode
Modo de seguridad utilizado para conectarse al servidor de supervisión.1 = Autenticación de Microsoft Windows.
0 = Microsoft Autenticación de SQL Server. monitor_server_security_mode es de tipo bit y no puede ser NULL.
- [ @monitor_server_login = ] 'monitor_server_login'
Es el nombre de usuario de la cuenta utilizada para tener acceso al servidor de supervisión.
- [ @monitor_server_password = ] 'monitor_server_password'
Es la contraseña de la cuenta utilizada para tener acceso al servidor de supervisión.
- [ @backup_threshold = ] backup_threshold
Es el período de tiempo, expresado en minutos, que ha de transcurrir tras la realización de la última copia de seguridad antes de que se genere un error threshold_alert. backup_threshold es de tipo int y su valor predeterminado es de 60 minutos.
- [ @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 retendrá 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.
- [ @backup_job_id = ] backup_job_id OUTPUT
Es el Id. del trabajo del Agente SQL Server asociado al trabajo de copia de seguridad en el servidor primario. backup_job_id es de tipo uniqueidentifier y no puede ser NULL.
- [ @primary_id = ] primary_id OUTPUT
Id. de la base de datos primaria para la configuración del trasvase de registros. primary_id es de tipo uniqueidentifier y no puede ser NULL.
Conjuntos de resultados
Ninguno
Notas
sp_add_log_shipping_primary_database se debe ejecutar desde la base de datos master del servidor primario. Este procedimiento almacenado realiza las siguientes funciones:
- Genera un Id. principal y agrega una entrada para la base de datos primaria en la tabla log_shipping_primary_databases, utilizando los argumentos suministrados.
- Crea un trabajo de copia de seguridad para la base de datos primaria que está deshabilitada.
- Establece el Id. de trabajo de copia de seguridad de la entrada log_shipping_primary_databases en el Id. del trabajo de copia de seguridad.
- Agrega un registro de supervisión local a la tabla log_shipping_monitor_primary del servidor primario, utilizando los argumentos suministrados.
- Si el servidor de supervisión es diferente del servidor primario, agrega un registro de supervisión a la tabla log_shipping_monitor_primary del 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 agrega la base de datos AdventureWorks como la base de datos primaria en una configuración de trasvase de registros.
DECLARE @LS_BackupJobId AS uniqueidentifier
DECLARE @LS_PrimaryId AS uniqueidentifier
EXEC master.dbo.sp_add_log_shipping_primary_database
@database = N'AdventureWorks'
,@backup_directory = N'c:\lsbackup'
,@backup_share = N'\\tribeca\lsbackup'
,@backup_job_name = N'LSBackup_AdventureWorks'
,@backup_retention_period = 1440
,@monitor_server = N'rockaway'
,@monitor_server_security_mode = 1
,@backup_threshold = 60
,@threshold_alert = 0
,@threshold_alert_enabled = 0
,@history_retention_period = 1440
,@backup_job_id = @LS_BackupJobId OUTPUT
,@primary_id = @LS_PrimaryId OUTPUT
,@overwrite = 1
GO
Vea también
Referencia
Procedimientos almacenados del sistema (Transact-SQL)
Otros recursos
Trasvase de registros
Tablas y procedimientos almacenados de trasvase de registros