Compartir a través de

  • Artículo

sp_add_log_shipping_primary_database (Transact-SQL)

Establece la base de datos principal 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.

Icono de vínculo a temasConvenciones 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]
[, [ @backup_compression = ] backup_compression_option ]

Argumentos

  • [ @database= ] 'database'
    Es el nombre de la base de datos principal 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 principal. 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 principal. 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 principal 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 principal. 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 Windows.

    0 = Autenticación de SQL Server. monitor_server_security_mode es 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, 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 cero (0), el predeterminado, significa que la alerta está deshabilitada y no se generará. threshold_alert_enabled es 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 identificador de trabajo del Agente SQL Server asociado al trabajo de copia de seguridad en el servidor principal. backup_job_id es de tipo uniqueidentifier y no puede ser NULL.

  • [ @primary_id= ] primary_id OUTPUT
    Identificador de la base de datos principal para la configuración de trasvase de registros. primary_id es de tipo uniqueidentifier y no puede ser NULL.

  • [ @backup_compression = ] backup_compression_option
    Especifica si una configuración de trasvase de registros utiliza la compresión de copia de seguridad. Este parámetro sólo se admite en SQL Server 2008 Enterprise (o una versión posterior).

    0 = Deshabilitada. No se comprimen nunca las copias de seguridad de registros.

    1 = Habilitada. Se comprimen siempre las copias de seguridad de registros.

    2 = Utilice el valor de opción de configuración de servidor compresión de copia de seguridad predeterminada. Es el valor predeterminado.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Ninguno

Comentarios

sp_add_log_shipping_primary_database se debe ejecutar desde la base de datos master del servidor principal. Este procedimiento almacenado realiza las siguientes funciones:

  1. Genera un Id. principal y agrega una entrada para la base de datos principal en la tabla log_shipping_primary_databases, utilizando los argumentos suministrados.

  2. Crea un trabajo de copia de seguridad para la base de datos principal que está deshabilitada.

  3. 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.

  4. Agrega un registro de supervisión local a la tabla log_shipping_monitor_primary del servidor principal, utilizando los argumentos suministrados.

  5. Si el servidor de supervisión es diferente del servidor principal, 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.

Ejemplos

En este ejemplo se agrega la base de datos AdventureWorks2008R2 como la base de datos principal 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 
,@backup_compression = 0
GO