sp_changepublication_snapshot (Transact-SQL)

Se aplica a:SQL ServerAzure SQL Managed Instance

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 publicación.

Importante

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 Habilitar conexiones cifradas en el motor de base de datos (Administrador de configuración de 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 sysname, sin ningún valor predeterminado.

[ @frequency_type = ] frequency_type Es la frecuencia con la que programar el agente. frequency_type es int y puede ser uno de los siguientes valores.

Value Description
1 Una vez
2 A petición
4 Diariamente
8 Cada semana
16 Mensualmente
32 Mensualmente relativa
64 Iniciar automáticamente
128 Periódico
NULL (predeterminado)

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

Value Description
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 (predeterminado)

[ @frequency_subday = ] frequency_subday Es las unidades de freq_subday_interval. frequency_subday es int y puede ser uno de estos valores.

Value Description
1 Una vez
2 Second
4 Minute
8 Hora
NULL (predeterminado)

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

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

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

[ @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, con un valor predeterminado de NULL.

[ @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, con un valor predeterminado de NULL.

[ @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, con un valor predeterminado de NULL.

[ @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, con un valor predeterminado de NULL.

[ @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) con un valor predeterminado de NULL.

[ @publisher_security_mode = ] publisher_security_mode Es el modo de seguridad que usa el agente al conectarse al publicador. publisher_security_mode es smallint, con un valor predeterminado de NULL. 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.

Importante

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, con un valor predeterminado de NULL. 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 = ] 'publisher_password' Es la contraseña que se usa al conectarse al publicador. publisher_password es sysname, con un valor predeterminado de NULL.

Importante

No utilice una contraseña en blanco. Utilice una contraseña segura. 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.

[ @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) con un valor predeterminado de NULL. 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, con un valor predeterminado de NULL. Es preciso proporcionar este parámetro al crear un nuevo trabajo del Agente de instantáneas.

Importante

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 sysname, con un valor predeterminado de NULL.

Nota:

Publisher no debe usarse al crear una 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 usa en la replicación de instantáneas, la replicación transaccional y la replicación de mezcla.

Permisos

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

Consulte también

Ver y modificar propiedades de publicación
Cambiar las propiedades de la publicación y de los artículos
sp_addpublication_snapshot (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)