sp_changepublication_snapshot (Transact-SQL)

Actualizado: 12 de diciembre de 2006

Cambia las propiedades del Agente de instantáneas para la publicación especificada. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicaciones.

Nota de seguridad:
Al configurar un publicador con un distribuidor remoto, los valores suministrados para todos los parámetros, incluidos job_login y job_password, se envían al distribuidor como texto sin formato. Antes de ejecutar este procedimiento almacenado, se recomienda cifrar la conexión entre el publicador y su distribuidor remoto. Para obtener más información, vea Cifrar conexiones a SQL Server.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_changepublication_snapshot [ @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 = ] 'publisher' ]

Argumentos

• [ @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 programa el agente. frequency_type es de tipo int y puede tener uno de estos valores.

  Valor	Descripción
  1	Una vez
  2	A petición
  4	Diariamente
  8	Semanalmente
  16	Mensualmente
  32	Relativo mensual
  64	Iniciar automáticamente
  128	Periódica
  NULL (predeterminado)

• [ @frequency_interval=] frequency_interval
  Los días en los que se ejecuta el agente. frequency_interval es de tipo int y puede tener uno de los valores siguientes.

  Valor	Descripción
  1	Domingo
  2	Lunes
  3	Martes
  4	Miércoles
  5	Jueves
  6	Viernes
  7	Sábado
  8	Día
  9	Días laborables
  10	Días del fin de semana
  NULL (predeterminado)

• [ @frequency_subday=] frequency_subday
  Es la unidad de 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
  NULL (predeterminado)

• [ @frequency_subday_interval=] frequency_subday_interval
  Es el intervalo para frequency_subday. frequency_subday_interval es de tipo int y su valor predeterminado es NULL.

• [ @frequency_relative_interval=] frequency_relative_interval
  Es la fecha en la que se ejecuta el Agente de instantáneas. frequency_relative_interval es de tipo int y su valor predeterminado es NULL.

• [ @frequency_recurrence_factor=] frequency_recurrence_factor
  Es el factor de periodicidad utilizado por frequency_type. frequency_recurrence_factor es de tipo int y su valor predeterminado es NULL.

• [ @active_start_date=] active_start_date
  Es la fecha en la que comienza la programación del Agente de instantáneas, en formato AAAAMMDD. active_start_date es de tipo int y su valor predeterminado es NULL.

• [ @active_end_date=] active_end_date
  Es la fecha en la que finaliza la programación del Agente de instantáneas, en formato AAAAMMDD. active_end_date es de tipo int y su valor predeterminado es NULL.

• [ @active_start_time_of_day=] active_start_time_of_day
  Es la hora del día a la que comienza la programación del Agente de instantáneas, en formato HHMMSS. active_start_time_of_day es de tipo int y su valor predeterminado es NULL.

• [ @active_end_time_of_day=] active_end_time_of_day
  Es la hora del día a la que finaliza la programación del Agente de instantáneas, en formato HHMMSS. active_end_time_of_day es de tipo int y su valor predeterminado es NULL.

• [ @snapshot_job_name = ] 'snapshot_agent_name'
  Es el nombre de un trabajo del Agente de instantáneas existente, si se utiliza un trabajo existente. snapshot_agent_name es de tipo nvarchar(100) y su valor predeterminado es NULL.

• [ @publisher_security_mode= ] publisher_security_mode
  Es el modo de seguridad utilizado por el agente para conectarse al publicador. publisher_security_mode es de tipo smallint y su valor predeterminado es NULL. 0 especifica la autenticación de SQL Server y 1 la autenticación de Windows. Debe especificarse el valor 0 para los publicadores que no son de SQL Server.

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

• [ @publisher_login= ] 'publisher_login'
  Es el inicio de sesión utilizado para la conexión con el publicador. publisher_login es de tipo sysname y su valor predeterminado es NULL. publisher_login debe especificarse si publisher_security_mode es 0. Si publisher_login es NULL y publisher_security_mode es 1, para la conexión con el publicador se utiliza la cuenta de Windows especificada en job_login.

• [ @publisher_password= ] 'publisher_password'
  Es la contraseña utilizada para la conexión con el publicador. publisher_password es de tipo sysname y su valor predeterminado es NULL.

  Nota de seguridad:
  No utilice una contraseña en blanco. Utilice una contraseña segura. Cuando sea posible, pida a los usuarios que especifiquen credenciales de seguridad en tiempo de ejecución. Si debe almacenar las credenciales en un archivo de secuencia de comandos, proteja el archivo para evitar el acceso no autorizado.

• [ @job_login= ] 'job_login'
  Es el inicio de sesión de la cuenta de Windows con la que se ejecuta el agente. job_login es de tipo nvarchar(257) y su valor predeterminado es NULL. Esta cuenta de Windows se utiliza siempre para las conexiones del agente con el distribuidor. Debe proporcionar este parámetro cuando cree 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 con la que se ejecuta el agente. job_password es de tipo sysname y su valor predeterminado es NULL. Debe proporcionar este parámetro cuando cree un nuevo trabajo del Agente de instantáneas.

  Nota de seguridad:
  Cuando sea posible, pida a los usuarios que proporcionen credenciales de seguridad en tiempo de ejecución. Si debe almacenar las credenciales en un archivo de secuencia de comandos, proteja el archivo para evitar el acceso no autorizado.

• [ @publisher= ] 'publisher'
  Especifica un publicador que no es de SQL Server. publisher es de tipo sysname y su valor predeterminado es NULL.

  [!NOTA] No se debe utilizar publisher al crear un Agente de instantáneas en un publicador de SQL Server.

Notas

sp_changepublication_snapshot se utiliza en la réplica de instantáneas, transaccional y de mezcla.

Permisos

Sólo los miembros de la función fija de servidor sysadmin o de la función fija de base de datos db_owner pueden ejecutar sp_changepublication_snapshot.

Valores de código de retorno

0 (correcto) o 1 (error)

Vea también

Referencia

sp_addpublication_snapshot (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)

Otros recursos

How to: View and Modify Publication Properties (Replication Transact-SQL Programming)
Cambiar las propiedades de la publicación y de los artículos

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios