sp_change_log_shipping_primary_database (Transact-SQL)

  • Artículo

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 ]
[ ; ]

Argumentos

[ @database = ] 'database'

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 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 y el valor predeterminado es NULL.

[ @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).

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

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;

Contenido relacionado