通过

  • 项目

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。