sp_helpdynamicsnapshot_job (Transact-SQL)

返回有关生成筛选数据快照的代理作业的信息。 此存储过程在发布服务器的发布数据库中执行。

主题链接图标Transact-SQL 语法约定

语法

sp_helpdynamicsnapshot_job [ [ @publication = ] 'publication' ] 
    [ , [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname' ]
    [ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' ]

参数

  • [ @publication =] 'publication'
    发布的名称。publication 的数据类型为 sysname,默认值为 %,该值表示为所有发布返回与指定 dynamic_snapshot_jobid和 dynamic_snapshot_jobname匹配的所有已筛选数据快照作业的有关信息。

  • [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'
    已筛选的数据快照作业的名称。dynamic_snapshot_jobname 的数据类型为 sysname,默认值为 %,该值表示为发布返回具有指定 dynamic_snapshot_jobid 的所有动态作业。 如果创建作业时未显式指定作业名称,则作业名称具有以下格式:

    'dyn_' + <name of the standard snapshot job> + <GUID>
    
  • [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'
    已筛选的数据快照作业的标识符。dynamic_snapshot_jobid 的数据类型为 uniqueidentifier,默认值为 NULL,该值表示返回与指定 dynamic_snapshot_jobname 匹配的所有快照作业。

结果集

列名

数据类型

说明

id

int

标识已筛选的数据快照作业。

job_name

sysname

已筛选数据快照作业的名称。

job_id

uniqueidentifier

标识分发服务器上的 Microsoft SQL Server 代理作业。

dynamic_filter_login

sysname

用于对发布定义的参数化行筛选器中的 SUSER_SNAME 函数求值的值。

dynamic_filter_hostname

sysname

用于对发布定义的参数化行筛选器中的 HOST_NAME 函数的值。

dynamic_snapshot_location

nvarchar(255)

在使用参数化行筛选器时,从中读取快照文件的文件夹的路径。

frequency_type

int

代理计划运行的频率,可以为下列值之一:

1 = 执行一次

2 = 按需

4 = 每天

8 = 每周

16 = 每月

32 = 与“每月”选项相关

64 = 自动启动

128 = 重复执行

frequency_interval

int

代理运行的日期,可以为下列值之一:

1 = 星期日

2 = 星期一

3 = 星期二

4 = 星期三

5 = 星期四

6 = 星期五

7 = 星期六

8 = 天

9 = 工作日

10 = 休息日

frequency_subday_type

int

定义当 frequency_type 为 4(每天)时代理运行频率的类型,可以为下列值之一:

1 = 在指定时间

2 = 秒

4 = 分钟

8 = 小时

frequency_subday_interval

int

在计划的代理执行之间出现的 frequency_subday_type 间隔数。

frequency_relative_interval

int

当 frequency_type 为 32(与“每月”选项相关)时,代理在给定月份的这一周运行,可以为下列值之一:

1 = 第一周

2 = 第二周

4 = 第三周

8 = 第四周

16 = 最后一周

frequency_recurrence_factor

int

在计划的代理执行之间间隔的周数或月数。

active_start_date

int

计划第一次运行代理的日期,格式为 YYYYMMDD。

active_end_date

int

计划最后一次运行代理的日期,格式为 YYYYMMDD。

active_start_time

int

计划第一次运行代理的时间,格式为 HHMMSS。

active_end_time

int

计划最后一次运行代理的时间,格式为 HHMMSS。

返回代码值

0(成功)或 1(失败)

注释

sp_helpdynamicsnapshot_job 用于合并复制。

如果使用所有默认参数值,则将返回用于整个发布数据库的所有已分区数据快照作业的信息。

权限

只有 sysadmin 固定服务器角色的成员、db_owner 固定数据库角色的成员以及发布的发布访问列表中的成员才能执行 sp_helpdynamicsnapshot_job