sp_MSchange_snapshot_agent_properties (Transact-SQL)

Cambia las propiedades de un trabajo del Agente de instantáneas que se ejecuta en un distribuidor de Microsoft SQL Server 2005 o una versión posterior. Este procedimiento almacenado se utiliza para cambiar las propiedades cuando el publicador se ejecuta en una instancia de Microsoft SQL Server 2000. 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 de tipo sysname y no tiene ningún valor predeterminado.

• [ @publisher_db= ] 'publisher_db'
  Es el nombre de la base de datos de publicación. publisher_db es de tipo sysname y no tiene ningún valor predeterminado.

• [ @publication = ] 'publication'
  Es el nombre de la publicación. publication es de tipo sysname y no tiene ningún valor predeterminado.

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

  Valor	Descripción
  1	Una vez
  2	A petición
  4	Diaria
  8	Semanal
  10	Mensual
  20	Mensual, en función del intervalo de frecuencia
  40	Cuando se inicia el Agente SQL Server.

• [ @frequency_interval = ] frequency_interval
  Es el valor que se va a aplicar a la frecuencia establecida por frequency_type. frequency_interval es de tipo int y no tiene ningún valor predeterminado.

• [ @frequency_subday = ] frequency_subday
  Son las unidades para freq_subday_interval. frequency_subday es de tipo int y puede tener uno de estos valores.

  Valor	Descripción
  1	Una vez
  2	Segundo
  4	Minuto
  8	Hora

• [ @frequency_subday_interval=] frequency_subday_interval
  Es el intervalo de frequency_subday. frequency_subday_interval es de tipo int y no tiene ningún valor predeterminado.

• [ @frequency_relative_interval = ] frequency_relative_interval
  Es la fecha en que se ejecuta el Agente de instantáneas. frequency_relative_interval es de tipo int y no tiene ningún valor predeterminado.

• [ @frequency_recurrence_factor = ] frequency_recurrence_factor
  Es el factor de periodicidad utilizado por frequency_type. frequency_recurrence_factor es de tipo int y no tiene ningún valor predeterminado.

• [ @active_start_date = ] active_start_date
  Es la fecha en que el Agente de instantáneas está programado para ejecutarse por primera vez, con el formato AAAAMMDD. active_start_date es de tipo int y no tiene ningún valor predeterminado.

• [ @active_end_date = ] active_end_date
  Es la fecha en que la programación del Agente de instantáneas deja de estar activa, con el formato AAAAMMDD. active_end_date es de tipo int y no tiene ningún valor predeterminado.

• [ @active_start_time_of_day=] active_start_time_of_day
  Es la hora del día en que el Agente de instantáneas está programado para ejecutarse por primera vez, con el formato HHMMSS. active_start_time_of_day es de tipo int y no tiene ningún valor predeterminado.

• [ @active_end_time_of_day=] active_end_time_of_day
  Es la hora del día en que la programación del Agente de instantáneas deja de estar activa, con el formato HHMMSS. active_end_time_of_day es de tipo int y no tiene ningún valor predeterminado.

• [ @snapshot_job_name = ] 'snapshot_agent_name'
  Es el nombre de un trabajo del Agente de instantáneas existente, si se está utilizando un trabajo existente. snapshot_agent_name es de tipo nvarchar(100) y no tiene ningún valor predeterminado.

• [ @publisher_security_mode= ] publisher_security_mode
  Es el modo de seguridad utilizado por el agente al conectarse al publicador. publisher_security_mode es de tipo int y no tiene ningún valor predeterminado. 0 especifica Autenticación de SQL Server y 1 especifica Autenticación de Windows. Debe especificarse 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 utilizado al conectarse al publicador. publisher_login es de tipo sysname y no tiene ningún valor predeterminado. publisher_login se debe especificar si publisher_security_mode es 0. Si publisher_login es NULL y el publicador*_*security_mode es 1, se utilizará la cuenta de Windows especificada en job_login al conectarse al publicador.

• [ @publisher_password= ] 'publisher_password'
  Es la contraseña que se utiliza al conectarse al publicador. publisher_password es de tipo nvarchar(524) y no tiene ningún valor predeterminado.

  Nota de seguridad
  No almacene información de autenticación en archivos de scripts. 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= ] 'job_login'
  Es el inicio de sesión para la cuenta de Windows con la que se ejecuta el agente. job_login es de tipo nvarchar(257) y no tiene ningún valor predeterminado. Esta cuenta de Windows se utiliza siempre para las conexiones de agente al distribuidor. Es preciso proporcionar este parámetro al crear un nuevo trabajo del Agente de instantáneas. Esto no se puede cambiar para un publicador que no sea de SQL Server*.*

• [ @job_password= ] 'job_password'
  Es la contraseña para la cuenta de Windows con la que se ejecuta el agente. job_password es de tipo sysname y no tiene ningún valor predeterminado. Es preciso proporcionar este parámetro al crear un nuevo trabajo del Agente de instantáneas.

  Nota de seguridad
  No almacene información de autenticación en archivos de scripts. 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= ] 'publisher_type'
  Especifica el tipo de publicador cuando el publicador no se está ejecutando en una instancia de SQL Server. publisher_type es de tipo sysname y puede tener uno de los siguientes valores.

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

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

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

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

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

Cuando el publicador se ejecuta en una instancia de SQL Server 2005 o una versión posterior, debe utilizarse sp_changepublication_snapshot para cambiar las propiedades del trabajo del Agente de instantáneas.

Permisos

Sólo los miembros de la función fija de servidor sysadmin en el distribuidor pueden ejecutar sp_MSchange_snapshot_agent_properties.

Vea también

Referencia

sp_addpublication_snapshot (Transact-SQL)

Conceptos

Usar varias versiones de SQL Server en una topología de replicación