sp_changedynamicsnapshot_job (Transact-SQL)
修改为带有参数化行筛选器的发布的订阅生成快照的代理作业。 此存储过程在发布服务器的发布数据库中执行。
.gif "主题链接图标")
语法
sp_changedynamicsnapshot_job [ @publication = ] 'publication'
[ , [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname' ]
[ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' ]
[ , [ @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 ]
[ , [ @job_login = ] 'job_login' ]
[ , [ @job_password = ] 'job_password' ]
参数
[ @publication = ] 'publication'
发布的名称。 publication 的数据类型为 sysname，无默认值。[ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'
要更改的快照作业的名称。 dynamic_snapshot_jobname 的数据类型为 sysname，默认值为 N'%'。 如果指定 dynamic_snapshot_jobid，则必须使用 dynamic_snapshot_jobname 的默认值。[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'
要更改的快照作业的 ID。 dynamic_snapshot_jobid 的数据类型为 uniqueidentifier，默认值为 NULL。 如果指定 dynamic_snapshot_jobname，则必须使用 dynamic_snapshot_jobid 的默认值。[ @frequency_type = ] frequency_type
安排代理的频率。 frequency_type 的数据类型为 int，可以为以下值之一。值
说明
1
一次
2
按需
4
每天
8
每周
16
每月
32
与“每月”选项相关
64
自动启动
128
重复执行
NULL（默认值）
[ @frequency_interval = ] frequency_interval
代理运行的天数。 frequency_interval 的数据类型为 int，可以为以下值之一。值
说明
1
星期日
2
星期一
3
星期二
4
星期三
5
星期四
6
星期五
7
星期六
8
日历日
9
工作日
10
周末
NULL（默认值）
[ @frequency_subday = ] frequency_subday
在指定期内重新安排计划的频率。 frequency_subday 的数据类型为 int，可以为以下值之一。值
说明
1
一次
2
秒
4
分钟
8
小时
NULL（默认值）
[ @frequency_subday_interval = ] frequency_subday_interval
是 frequency_subday 的时间间隔。 frequency_subday_interval 的数据类型为 int，默认值为 NULL。[ @frequency_relative_interval = ] frequency_relative_interval
合并代理运行的日期。 在将 frequency_type 设置为 32（“每月”选项相关）时使用此参数。 frequency_relative_interval 的数据类型为 int，可以为以下值之一。值
说明
1
第一次
2
第二次
4
第三次
8
第四次
16
最后一次
NULL（默认值）
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
是 frequency_type 使用的重复因子。 frequency_recurrence_factor 的数据类型为 int，默认值为 NULL。[ @active_start_date = ] active_start_date
第一次安排合并代理的日期，格式为 YYYYMMDD。 active_start_date 的数据类型为 int，默认值为 NULL。[ @active_end_date = ] active_end_date
停止安排合并代理的日期，格式为 YYYYMMDD。 active_end_date 的数据类型为 int，默认值为 NULL。[ @active_start_time_of_day = ] active_start_time_of_day
第一次安排合并代理的时间，格式为 HHMMSS。 active_start_time_of_day 的数据类型为 int，默认值为 NULL。[ @active_end_time_of_day = ] active_end_time_of_day
停止安排合并代理的时间，格式为 HHMMSS。 active_end_time_of_day 的数据类型为 int，默认值为 NULL。[ @job_login= ] 'job_login'
为使用参数化行筛选器的订阅生成快照时，运行快照代理所用的 Microsoft Windows 帐户。 job_login 的数据类型为 nvarchar(257)，默认值为 NULL。[ @job_password= ] 'job_password'
为使用参数化行筛选器的订阅生成快照时，运行快照代理所用的 Windows 帐户的密码。 job_password 的数据类型为 nvarchar(257)，默认值为 NULL。.gif "安全说明")
安全说明如果可能，请在运行时提示用户输入安全凭据。 如果必须在脚本文件中存储凭据，则必须保护文件以防止未经授权的访问。
返回代码值
0（成功）或 1（失败）
注释
sp_changedynamicsnapshot_job 用于在合并复制中使用参数化行筛选器的发布。
更改代理登录名或密码之后，必须先停止并重新启动代理，然后更改才能生效。
权限
只有 sysadmin 固定服务器角色成员或 db_owner 固定数据库角色成员才能执行 sp_changedynamicsnapshot_job。