sp_helpdynamicsnapshot_job (Transact-SQL)
返回有关生成筛选数据快照的代理作业的信息。 此存储过程在发布服务器上对发布数据库执行。
语法
sp_helpdynamicsnapshot_job
[ [ @publication = ] N'publication' ]
[ , [ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname' ]
[ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' ]
[ ; ]
参数
[ @publication = ] N'publication'
发布的名称。 @publication为 sysname，默认值%为 ，返回所有发布与指定@dynamic_snapshot_jobid和@dynamic_snapshot_jobname匹配的所有筛选数据快照作业的信息。
[ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname'
筛选的数据快照作业的名称。 @dynamic_snapshot_jobname为 sysname，默认值%为 ，返回具有指定@dynamic_snapshot_jobname的发布的所有动态作业。 如果在创建作业时未显式指定作业名称，则作业名称的格式 '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 | 标识分发服务器上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 = First2 = Second4 = 第三8 = Fourth16 = Last |
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。