sp_changedynamicsnapshot_job (Transact-SQL)

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

主题链接图标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