通过

sp_changedynamicsnapshot_job (Transact-SQL)

  • 项目

适用于： SQL Server Azure SQL 托管实例

修改为带有参数化行筛选器的发布的订阅生成快照的代理作业。 此存储过程在发布服务器上对发布数据库执行。

Transact-SQL 语法约定

语法

sp_changedynamicsnapshot_job
    [ @publication = ] N'publication'
    [ , [ @dynamic_snapshot_jobname = ] N'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 = ] N'job_login' ]
    [ , [ @job_password = ] N'job_password' ]
[ ; ]

参数

[ @publication = ] N'publication'

发布的名称。 @publication 为 sysname，无默认值。

[ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname'

要更改的快照作业的名称。 @dynamic_snapshot_jobname为 sysname，默认值为 %.

如果指定了@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 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 第二个
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 = ] N'job_login'

使用参数化行筛选器为订阅生成快照时，快照代理在其下运行的 Windows 帐户。 @job_login 为 nvarchar（257），默认值为 NULL.

[ @job_password = ] N'job_password'

使用参数化行筛选器为订阅生成快照时，运行快照代理的 Windows 帐户的密码。 @job_password为 sysname，默认值为 NULL.

重要

如果可能，请在运行时提示用户输入安全凭据。 如果必须在脚本文件中存储凭据，则必须保护文件以防止未经授权的访问。

返回代码值

0（成功）或 1（失败）。

注解

sp_changedynamicsnapshot_job 用于具有参数化行筛选器的发布的合并复制。

更改代理登录名或密码之后，必须先停止并重新启动代理，然后更改才能生效。

权限

只有 sysadmin 固定服务器角色的成员或db_owner固定数据库角色的成员才能执行sp_changedynamicsnapshot_job。

相关内容