sp_changedynamicsnapshot_job (Transact-SQL)
修改为带有参数化行筛选器的发布的订阅生成快照的代理作业。此存储过程在发布服务器的发布数据库中执行。
语法
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,可以是下列值之一。Value 说明 1
执行一次
2
按需
4
每天
8
每周
16
每月
32
与“每月”选项相关
64
自动启动
128
重复执行
NULL(默认值)
[ @frequency_interval = ] frequency_interval
代理运行的天数。frequency_interval 的数据类型为 int,可以是下列值之一。Value 说明 1
星期日
2
星期一
3
星期二
4
星期三
5
星期四
6
星期五
7
星期六
8
天
9
工作日
10
周末
NULL(默认值)
[ @frequency_subday = ] frequency_subday
在定义的周期内重新计划的频率。frequency_subday 的数据类型为 int,可以是下列值之一。Value 说明 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,可以是下列值之一。Value 说明 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。安全说明: 如果可能,请在运行时提示用户输入安全凭据。如果必须在脚本文件中存储凭据,则必须保护文件以防止未经授权的访问。
返回代码值
0(成功)或 1(失败)
备注
sp_changedynamicsnapshot_job 用于在合并复制中使用参数化行筛选器的发布。
更改代理登录名或密码之后,必须先停止并重新启动代理,然后更改才能生效。
权限
只有 sysadmin 固定服务器角色成员或 db_owner 固定数据库角色成员才能执行 sp_changedynamicsnapshot_job。
请参阅
其他资源
How to: View and Modify Replication Security Settings (Replication Transact-SQL Programming)
带有参数化筛选器的合并发布的快照