sp_changepublication_snapshot (Transact-SQL)

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 seguridadNota 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 simple. Debe cifrar la conexión entre el publicador y su distribuidor remoto antes de ejecutar este procedimiento almacenado. Para obtener más información, vea Habilitar conexiones cifradas en el motor de base de datos (Administrador de configuración de SQL Server).

Icono de vínculo a temas 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 int, y puede ser uno de los siguientes valores.

    Valor

    Descripción

    1

    Una vez

    2

    A petición

    4

    Diariamente

    8

    Semanalmente

    16

    Mensualmente

    32

    Mensualmente relativa

    64

    Iniciar automáticamente

    128

    Periódica

    NULL (valor predeterminado)

     

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

    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 de la semana

    10

    Días del fin de semana

    NULL (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

    Minute

    8

    Hour

    NULL (valor predeterminado)

     

  • [ @frequency_subday_interval =] frequency_subday_interval
    Es el intervalo de 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 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 repetición que se utiliza en 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 que el agente de instantáneas se programa por primera vez, con el 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 el agente de instantáneas deja de estar programado, con el 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 en que el agente de instantáneas se programa por primera vez, con el 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 en que el agente de instantáneas deja de estar programado, con el 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 está utilizando 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 que el agente utiliza al 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 un valor de 0 para publicadores que no sean de SQL Server.

    Nota de seguridadNota de seguridad

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

  • [ @publisher_login = ] 'publisher_login'
    Es el inicio de sesión utilizado al conectar al publicador. publisher_login es de tipo sysname y su valor predeterminado es NULL. publisher_login se debe especificar si publisher_security_mode es 0. Si publisher_login es NULL y publisher_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 utilizada para conectarse al publicador. publisher_password es de tipo sysname y su valor predeterminado es NULL.

    Nota de seguridadNota 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 script, proteja el archivo para evitar el acceso no autorizado.

  • [ @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 de tipo nvarchar(257) y su valor predeterminado es NULL. Esta cuenta de Windows se utiliza siempre para las conexiones del agente al distribuidor. Debe proporcionar este parámetro cuando cree un nuevo trabajo del Agente de instantáneas. No es posible cambiar por 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 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 seguridadNota 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 script, 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.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

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

Permisos

Solo los miembros del rol fijo de servidor sysadmin o del rol fijo de base de datos db_owner pueden ejecutar sp_changepublication_snapshot.

Vea también

Referencia

sp_addpublication_snapshot (Transact-SQL)

Procedimientos almacenados del sistema (Transact-SQL)

Conceptos

Ver y modificar propiedades de publicación

Cambiar las propiedades de la publicación y de los artículos