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 Microsoft 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 Microsoft 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 = ] 'publisher'  
        , [ @publisher_db = ] 'publisher_db'  
        , [ @publication = ] '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 = ] 'snapshot_agent_name'  
        , [ @publisher_security_mode = ] publisher_security_mode  
        , [ @publisher_login = ] 'publisher_login'  
        , [ @publisher_password = ] 'publisher_password'   
        , [ @job_login = ] 'job_login'  
        , [ @job_password = ] 'job_password'  
        , [ @publisher_type = ] 'publisher_type'  

Argumentos

[ @publisher = ] 'publisher' Es el nombre del publicador. publisher es sysname, sin ningún valor predeterminado.

[ @publisher_db = ] 'publisher_db' Es el nombre de la base de datos de publicación. publisher_db es sysname, sin ningún valor predeterminado.

[ @publication = ] 'publication' Es el nombre de la publicación. publication es sysname, sin ningún valor predeterminado.

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

[ @frequency_interval = ] frequency_interval Es el 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 Es las unidades de freq_subday_interval. frequency_subday es int y puede ser uno de estos valores.

[ @frequency_subday_interval = ] frequency_subday_interval Es el intervalo de frequency_subday. frequency_subday_interval es int, sin valor predeterminado.

[ @frequency_relative_interval = ] frequency_relative_intervalEs la fecha en que se ejecuta el Agente de instantáneas. frequency_relative_interval es int, sin valor predeterminado.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor Es el factor de periodicidad utilizado por frequency_type. frequency_recurrence_factor es int, sin valor predeterminado.

[ @active_start_date = ] active_start_dateEs la fecha en que la Agente de instantáneas está programada por primera vez, con yyyyMMddel formato . active_start_date es int, sin valor predeterminado.

[ @active_end_date = ] active_end_dateEs la fecha en que el Agente de instantáneas deja de programarse, con yyyyMMddel formato . active_end_date es int, sin ningún valor predeterminado.

[ @active_start_time_of_day = ] active_start_time_of_dayEs la hora del día en que la Agente de instantáneas se programa por primera vez, con el formato HHmmss. active_start_time_of_day es int, sin valor predeterminado.

[ @active_end_time_of_day = ] active_end_time_of_dayEs la hora del día en que el Agente de instantáneas deja de programarse, con HHmmssel formato . active_end_time_of_day es int, sin valor predeterminado.

[ @snapshot_job_name = ] 'snapshot_agent_name'Es el nombre de un Agente de instantáneas nombre de trabajo existente si se usa un trabajo existente. snapshot_agent_name es nvarchar(100), sin ningún valor predeterminado.

[ @publisher_security_mode = ] publisher_security_mode Es el modo de seguridad que usa el agente al conectarse al publicador. publisher_security_mode es int, sin valor predeterminado. 0 especifica la autenticación de SQL Server y 1 especifica la autenticación de Windows. Se debe especificar un valor de 0 para publicadores que no sean de SQL Server. Siempre que sea posible, utilice la autenticación de Windows.

[ @publisher_login = ] 'publisher_login' Es el inicio de sesión que se usa al conectarse 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 usará al conectarse al publicador.

[ @publisher_password = ] 'publisher_password' Es la contraseña que se usa al conectarse al publicador. publisher_password es nvarchar(524), sin ningún valor predeterminado.

[ @job_login = ] 'job_login' Es el inicio de sesión de la cuenta de Windows en 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. No se puede cambiar para un publicador que no sea de SQL Server .

[ @job_password = ] 'job_password' Es la contraseña de la cuenta de Windows en 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.

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

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 (error)

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.

Cuando el publicador se ejecuta en una instancia de SQL Server 2005 (9.x) o una versión posterior, debe usar sp_changepublication_snapshot 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.

Consulte también

sp_addpublication_snapshot (Transact-SQL)