Compartir vía


sp_MSchange_snapshot_agent_properties (Transact-SQL)

Se aplica a: SQL Server

Cambia las propiedades de un trabajo de Agente de instantáneas que se ejecuta en un distribuidor de SQL Server 2005 (9.x) o posterior. Este procedimiento almacenado se usa para cambiar las propiedades cuando el publicador se ejecuta en una instancia de SQL Server 2000 (8.x). Este procedimiento almacenado se ejecuta en el distribuidor de la base de datos de distribución.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_MSchange_snapshot_agent_properties
    [ @publisher = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'publication'
    , [ @frequency_type = ] frequency_type
    , [ @frequency_interval = ] frequency_interval
    , [ @frequency_subday = ] frequency_subday
    , [ @frequency_subday_interval = ] frequency_subday_interval
    , [ @frequency_relative_interval = ] frequency_relative_interval
    , [ @frequency_recurrence_factor = ] frequency_recurrence_factor
    , [ @active_start_date = ] active_start_date
    , [ @active_end_date = ] active_end_date
    , [ @active_start_time_of_day = ] active_start_time_of_day
    , [ @active_end_time_of_day = ] active_end_time_of_day
    , [ @snapshot_job_name = ] N'snapshot_job_name'
    , [ @publisher_security_mode = ] publisher_security_mode
    , [ @publisher_login = ] N'publisher_login'
    , [ @publisher_password = ] N'publisher_password'
    , [ @job_login = ] N'job_login'
    , [ @job_password = ] N'job_password'
    , [ @publisher_type = ] N'publisher_type'
[ ; ]

Argumentos

[ @publisher = ] N'publisher'

El nombre del publicador. @publisher es sysname, sin ningún valor predeterminado.

[ @publisher_db = ] N'publisher_db'

Nombre de la base de datos de publicación. @publisher_db es sysname, sin ningún valor predeterminado.

[ @publication = ] N'publication'

Nombre de la publicación. @publication es sysname, sin ningún valor predeterminado.

[ @frequency_type = ] frequency_type

Especifica la frecuencia con la que se ejecuta el Agente de instantáneas. @frequency_type es int y puede ser uno de estos valores.

Valor Descripción
1 Una vez
2 A petición
4 Diario
8 Semanal
10 Mensual
20 Mensualmente, dependiendo del intervalo de frecuencia
40 Cuando se inicia Agente SQL Server

[ @frequency_interval = ] frequency_interval

Valor que se va a aplicar a la frecuencia establecida por @frequency_type. @frequency_interval es int, sin ningún valor predeterminado.

[ @frequency_subday = ] frequency_subday

Unidades de @frequency_subday_interval. @frequency_subday es int y puede ser uno de estos valores.

Valor Descripción
1 Una vez
2 Second
4 Minute
8 Hora

[ @frequency_subday_interval = ] frequency_subday_interval

Intervalo de @frequency_subday. @frequency_subday_interval es int, sin valor predeterminado.

[ @frequency_relative_interval = ] frequency_relative_interval

Fecha en que se ejecuta el Agente de instantáneas. @frequency_relative_interval es int, sin valor predeterminado.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

Factor de periodicidad utilizado por @frequency_type. @frequency_recurrence_factor es int, sin valor predeterminado.

[ @active_start_date = ] active_start_date

Fecha en la que el Agente de instantáneas se programa por primera vez, con el formato yyyyMMdd. @active_start_date es int, sin valor predeterminado.

[ @active_end_date = ] active_end_date

Fecha en la que el Agente de instantáneas deja de programarse, con el formato yyyyMMdd. @active_end_date es int, sin valor predeterminado.

[ @active_start_time_of_day = ] active_start_time_of_day

La hora del día en que el Agente de instantáneas se programa por primera vez, con HHmmssel formato . @active_start_time_of_day es int, sin valor predeterminado.

[ @active_end_time_of_day = ] active_end_time_of_day

Hora del día en que el Agente de instantáneas deja de programarse, con el formato HHmmss. @active_end_time_of_day es int, sin valor predeterminado.

[ @snapshot_job_name = ] N'snapshot_job_name'

Nombre de un Agente de instantáneas nombre de trabajo existente si se usa un trabajo existente. @snapshot_job_name es nvarchar(100), sin ningún valor predeterminado.

[ @publisher_security_mode = ] publisher_security_mode

Modo de seguridad utilizado por el agente al conectarse al publicador. @publisher_security_mode es int, sin valor predeterminado. Se debe especificar un valor de 0 para publicadores que no son de SQL Server.

  • 0 especifica la autenticación de SQL Server.
  • 1especifica autenticación de Windows

Siempre que sea posible, utilice la autenticación de Windows.

[ @publisher_login = ] N'publisher_login'

Inicio de sesión utilizado al conectar al publicador. @publisher_login es sysname, sin ningún valor predeterminado. @publisher_login debe especificarse cuando @publisher_security_mode sea 0. Si @publisher_login es NULL y @publisher_security_mode es 1, la cuenta de Windows especificada en @job_login se usa al conectarse al publicador.

[ @publisher_password = ] N'publisher_password'

Contraseña usada al conectarse al publicador. @publisher_password es nvarchar(524), sin valor predeterminado.

Importante

No almacene información de autenticación en archivos de script. Para ayudar a mejorar la seguridad, se recomienda proporcionar nombres de inicio de sesión y contraseñas en tiempo de ejecución.

[ @job_login = ] N'job_login'

Inicio de sesión de la cuenta de Windows con la que se ejecuta el agente. @job_login es nvarchar(257), sin ningún valor predeterminado. Esta cuenta de Windows siempre se utiliza para conexiones del agente con el distribuidor. Es preciso proporcionar este parámetro al crear un nuevo trabajo del Agente de instantáneas. Esta propiedad no se puede cambiar para un publicador que no sea de SQL Server.

[ @job_password = ] N'job_password'

Contraseña de la cuenta de Windows con la que se ejecuta el agente. @job_password es sysname, sin ningún valor predeterminado. Es preciso proporcionar este parámetro al crear un nuevo trabajo del Agente de instantáneas.

Importante

No almacene información de autenticación en archivos de script. Para ayudar a mejorar la seguridad, se recomienda proporcionar nombres de inicio de sesión y contraseñas en tiempo de ejecución.

[ @publisher_type = ] N'publisher_type'

Especifica el tipo de publicador cuando el publicador no se ejecuta en una instancia de SQL Server. @publisher_type es sysname y puede ser uno de los siguientes valores.

Valor Descripción
MSSQLSERVER Especifica un publicador de SQL Server.
ORACLE Especifica un publicador estándar de Oracle.
ORACLE GATEWAY Especifica un publicador de puerta de enlace de Oracle.

Para obtener más información sobre las diferencias entre un publicador de Oracle y un publicador de puerta de enlace de Oracle, consulte Información general sobre la publicación de Oracle.

Valores de código de retorno

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

Comentarios

sp_MSchange_snapshot_agent_properties se usa en la replicación de instantáneas, la replicación transaccional y la replicación de mezcla.

Debe especificar todos los parámetros al ejecutar sp_MSchange_snapshot_agent_properties. Ejecute sp_helppublication_snapshot para devolver las propiedades actuales del trabajo de Agente de instantáneas.

Puede usar sp_changepublication_snapshot en el publicador para cambiar las propiedades de un trabajo de Agente de instantáneas.

Permisos

Solo los miembros del rol fijo de servidor sysadmin en el distribuidor pueden ejecutar sp_MSchange_snapshot_agent_properties.