Compartir a través de

  • Artículo

sp_change_log_shipping_primary_database (Transact-SQL)

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

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

sp_change_log_shipping_primary_database [ @database = ] 'database'
[, [ @backup_directory = ] 'backup_directory'] 
[, [ @backup_share = ] 'backup_share'] 
[, [ @backup_retention_period = ] 'backup_retention_period']
[, [ @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_compression = ] backup_compression_option ]

Argumentos

  • [ @database = ] '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.

  • [ @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_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_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 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, 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 no puede ser NULL.

  • [ @threshold_alert_enabled = ] 'threshold_alert_enabled'
    Especifica si se generará una alerta cuando se exceda backup_threshold.

    1 = habilitada

    0 = deshabilitada

    threshold_alert_enabled es de tipo bit y no puede ser NULL.

  • [ @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. Si no se especifica ningún valor, se utiliza 14420.

  • [ @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

Notas

sp_change_log_shipping_primary_database se debe ejecutar desde la base de datos maestra del servidor principal. Este procedimiento almacenado hace lo siguiente:

  1. Cambia la configuración del registro log_shipping_primary_database en caso de ser necesario.

  2. Cambia el registro local de log_shipping_monitor_primary en el servidor principal con los argumentos proporcionados en caso de ser necesario.

  3. Si el servidor de supervisión es distinto del servidor principal, cambia el registro de log_shipping_monitor_primary en el servidor de supervisión con los argumentos proporcionados en caso de ser necesario.

Permisos

Sólo pueden ejecutar este procedimiento los miembros de la función fija de servidor sysadmin.

Ejemplos

En este ejemplo se muestra el uso de sp_change_log_shipping_primary_database para actualizar la configuración asociada a la base de datos principal AdventureWorks.

EXEC master.dbo.sp_change_log_shipping_primary_database 
 @database = N'AdventureWorks' 
, @backup_directory = N'c:\LogShipping' 
, @backup_share = N'\\tribeca\LogShipping' 
, @backup_retention_period = 1440 
, @backup_threshold = 60 
, @threshold_alert = 0 
, @threshold_alert_enabled = 1 
, @history_retention_period = 1440 
,@monitor_server_security_mode = 1
,@backup_compression = 1