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_快照_jobname为 sysname,默认值为 N'%'。 如果指定了dynamic_快照_jobid,则必须使用dynamic_快照_jobname的默认值。
[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'
正在更改快照作业的 ID。 dynamic_快照_jobid为 uniqueidentifier,默认值为 NULL。 如果指定了dynamic_快照_jobname,则必须使用dynamic_快照_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 | Second |
4 | Minute |
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 | Second |
4 | 第三个 |
8 | 第四 |
16 | Last |
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'
使用参数化行筛选器为订阅生成快照时,快照代理在其下运行的密码。 job_password为 nvarchar(257),默认值为 NULL。
重要
如果可能,请在运行时提示用户输入安全凭据。 如果必须在脚本文件中存储凭据,则必须保护文件以防止未经授权的访问。
返回代码值
0 (成功) 或 1 (失败)
注解
sp_changedynamic快照_job用于具有参数化行筛选器的发布的合并副本 (replica)。
更改代理登录名或密码之后,必须先停止并重新启动代理,然后更改才能生效。
权限
只有 sysadmin 固定服务器角色的成员或db_owner固定数据库角色的成员才能执行sp_changedynamic快照_job。
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈