Compartir vía

sp_change_log_shipping_primary_database (Transact-SQL)

Se aplica a:SQL Server

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

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_change_log_shipping_primary_database
    [ @database = ] 'database'
    [ , [ @backup_directory = ] N'backup_directory' ]
    [ , [ @backup_share = ] N'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 ]
    [ , [ @monitor_connection_options = ] '<key_value_pairs>;[...]' ]
[ ; ]

Argumentos

[ @database = ] 'base de datos'

Nombre de la base de datos en el servidor principal. @primary_database es sysname, sin ningún valor predeterminado.

[ @backup_directory = ] N'backup_directory'

Ruta de acceso a la carpeta de copia de seguridad en el servidor principal. @backup_directory es nvarchar(500), sin ningún valor predeterminado y no puede ser NULL.

[ @backup_share = ] N'backup_share'

Ruta de acceso de red al directorio de copia de seguridad en el servidor principal. @backup_share es nvarchar(500), sin ningún valor predeterminado y no puede ser NULL.

[ @backup_retention_period = ] 'backup_retention_period'

El período de tiempo, en minutos, para conservar el archivo de copia de seguridad de registros en el directorio de copia de seguridad en el servidor principal. @backup_retention_period es int, sin 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.

[ @monitor_server_login = ] 'monitor_server_login'

Nombre de usuario de la cuenta usada para acceder al servidor de supervisión.

[ @monitor_server_password = ] 'monitor_server_password'

Contraseña de la cuenta usada para acceder al servidor de supervisión.

[ @backup_threshold = ] 'backup_threshold'

El período de tiempo, en minutos, después de la última copia de seguridad antes de que se produzca un error de @threshold_alert . @backup_threshold es int, con un valor predeterminado de 60 minutos.

[ @threshold_alert = ] 'threshold_alert'

Alerta que se generará cuando se sobrepase el umbral de copia de seguridad. @threshold_alert es int y no puede ser NULL.

[ @threshold_alert_enabled = ] 'threshold_alert_enabled'

Especifica si se genera una alerta cuando se supera @backup_threshold .

  • 1:Habilitado
  • 0:Deshabilitado

threshold_alert_enabled es bit y no puede ser NULL.

[ @history_retention_period = ] 'history_retention_period'

El período de tiempo en minutos en el que se conserva el historial. @history_retention_period es int. Se usa un valor de 14420 si no se especifica ninguno.

[ @backup_compression = ] backup_compression_option

Especifica si una configuración de trasvase de registros usa la compresión de copia de seguridad. Este parámetro es compatible con Enterprise Edition para SQL Server 2008 (10.0.x) (y versiones posteriores) y todas las ediciones de SQL Server 2016 (13.x) con Service Pack 1 (y versiones posteriores).

  • 0:Deshabilitado. Nunca comprima las copias de seguridad de registros

  • 1:Habilitado. Comprimir siempre las copias de seguridad de registros

  • 2 (valor predeterminado): use la opción de configuración predeterminada del servidor de compresión de copia de seguridad .

[ @monitor_connection_options = ] '<key_value_pairs>;[ ...]'

Aplica a: SQL Server 2025 (17.x) y versiones posteriores

Especifica opciones de conectividad adicionales para la conexión del servidor vinculado al usar un monitor remoto, en forma de pares clave-valor. @monitor_connection_options es nvarchar(4000) y tiene el valor predeterminado de NULL.

En la tabla siguiente se enumeran las opciones de conectividad disponibles:

Key Value
Encrypt strict, mandatory, optional, , true, false
TrustServerCertificate true, false, , yes, no
ServerCertificate Ruta de acceso del sistema de archivos al certificado de servidor. Tiene una longitud máxima de 260 caracteres.
HostNameInCertificate Invalidación de nombre de host para el certificado. Tiene una longitud máxima de 255 caracteres.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto de resultados

Ninguno.

Comentarios

sp_change_log_shipping_primary_database debe ejecutarse desde la master base de datos en el servidor principal. Este procedimiento almacenado hace lo siguiente:

  1. Cambia la configuración del log_shipping_primary_database registro, si es necesario.

  2. Cambia el registro local en log_shipping_monitor_primary en el servidor principal mediante argumentos proporcionados, si es necesario.

  3. Si el servidor de supervisión es diferente del servidor principal, cambia el registro en log_shipping_monitor_primary en el servidor de supervisión mediante argumentos proporcionados, si es necesario.

Permisos

Solo los miembros del rol fijo de servidor sysadmin pueden ejecutar este procedimiento.

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

EXECUTE 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;

Contenido relacionado

  • Last updated on