Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Se aplica a:SQL Server
Azure 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 proporcionados 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 más información, consulte Configuración del Motor de base de datos de SQL Server para el cifrado de las conexiones.
Transact-SQL Convenciones sintácticas
Sintaxis
sys.sp_changepublication_snapshot
[ @publication = ] N'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 = ] N'snapshot_job_name' ]
[ , [ @publisher_security_mode = ] publisher_security_mode ]
[ , [ @publisher_login = ] N'publisher_login' ]
[ , [ @publisher_password = ] N'publisher_password' ]
[ , [ @job_login = ] N'job_login' ]
[ , [ @job_password = ] N'job_password' ]
[ , [ @publisher = ] N'publisher' ]
[ , [ @job_security_mode = ] job_security_mode ]
[ ; ]
Argumentos
[ @publication = ] N'publication'
Nombre de la publicación. @publication es sysname, sin valor predeterminado.
[ @frequency_type = ] frequency_type
Especifica la frecuencia con la que programar 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 |
Diario |
8 |
Semanal |
16 |
Mensual |
32 |
Mensualmente relativa |
64 |
Iniciar automáticamente |
128 |
Periódico |
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
Unidades de @freq_subday_interval. @frequency_subday es int, y puede ser uno de estos valores.
| Valor | Descripción |
|---|---|
1 |
Una vez |
2 |
Second |
4 |
Minute |
8 |
Hora |
NULL (valor predeterminado) |
[ @frequency_subday_interval = ] frequency_subday_interval
Intervalo de @frequency_subday.
@frequency_subday_interval es int, con un valor por defecto de NULL.
[ @frequency_relative_interval = ] frequency_relative_interval
Fecha en que se ejecuta el Agente de instantáneas.
@frequency_relative_interval es int, con un valor por defecto de NULL.
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Factor de periodicidad utilizado por @frequency_type.
@frequency_recurrence_factor es int, con un valor por defecto de NULL.
@active_start_date [ = ] active_start_date
Fecha en la que el Agente de instantáneas se programa por primera vez, con el formato yyyyMMdd.
@active_start_date es int, con un valor por defecto de NULL.
@active_end_date [ = ] active_end_date
Fecha en la que el Agente de instantáneas deja de programarse, con el formato yyyyMMdd.
@active_end_date es int, con un valor por defecto de NULL.
[ @active_start_time_of_day = ] active_start_time_of_day
La hora del día en que el Agente de instantáneas se programa por primera vez, con HHmmssel formato .
@active_start_time_of_day es int, con un valor por defecto de NULL.
[ @active_end_time_of_day = ] active_end_time_of_day
Hora del día en que el Agente de instantáneas deja de programarse, con el formato HHmmss.
@active_end_time_of_day es int, con un valor por defecto de NULL.
[ @snapshot_job_name = ] N'snapshot_job_name'
Nombre de un Agente de instantáneas nombre de trabajo existente si se usa un trabajo existente.
@snapshot_job_name es nvarchar(100), con un valor por defecto de NULL.
[ @publisher_security_mode = ] publisher_security_mode
Modo de seguridad utilizado por el agente al conectarse al publicador.
@publisher_security_mode es int, con un valor por defecto de NULL. Se debe especificar un valor de 0 para publicadores que no son de SQL Server.
-
0especifica la autenticación de SQL Server -
1especifica autenticación de Windows -
5especifica la autenticación de identidad administrada de Microsoft Entra usando la identidad administrada predeterminada del distribuidor. Aplicable solo cuando tanto Distributor como Publisher son recursos de Azure SQL Managed Instance.
Importante
Siempre que sea posible, utilice la autenticación de Windows.
[ @publisher_login = ] N'publisher_login'
Inicio de sesión utilizado al conectar al publicador.
@publisher_login es sysname, con un valor por defecto de NULL.
@publisher_login debe especificarse cuando @publisher_security_mode es 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. No se utiliza si @publisher_security_mode es 5.
[ @publisher_password = ] N'publisher_password'
Contraseña usada al conectarse al publicador.
@publisher_password es sysname, con un valor por defecto de NULL. No se utiliza si @publisher_security_mode es 5.
Importante
No use 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 = ] N'job_login'
Inicio de sesión de la cuenta de Windows con la que se ejecuta el agente.
@job_login es nvarchar(257), con un valor por defecto 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. Esto no se puede cambiar para un publicador que no sea de SQL Server. No se usa si @job_security_mode es 5.
[ @job_password = ] N'job_password'
Contraseña de la cuenta de Windows con la que se ejecuta el agente.
@job_password es sysname, con un valor por defecto de NULL. Es preciso proporcionar este parámetro al crear un nuevo trabajo del Agente de instantáneas. No se usa si @job_security_mode es 5.
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 = ] N'publisher'
Especifica un publicador que no es de SQL Server.
@publisher es sysname, con un valor por defecto de NULL.
Nota:
@publisher no debe usarse al crear un Agente de instantáneas en un SQL Server Publisher.
[ @job_security_mode = ] job_security_mode
-
0especifica la autenticación SQL Server del agente al Distribuidor. -
1especifica la autenticación de Windows del agente al Distribuidor. -
5especifica la autenticación de identidad administrada Microsoft Entra del agente al Distribuidor utilizando la identidad administrada predeterminada del Distribuidor. Este valor es aplicable solo en replicación transaccional cuando tanto el Distribuidor como el Publisher son recursos de Azure SQL Managed Instance.
Valores de código de retorno
0 (éxito) o 1 (fracaso).
Comentarios
sp_changepublication_snapshot se utiliza en replicación de instantáneas, replicación transaccional y replicación por combinación.
Permisos
Solo los miembros del rol fijo de servidor sysadmin o db_owner rol fijo de base de datos pueden ejecutar sp_changepublication_snapshot.