sp_adddynamicsnapshot_job (Transact-SQL)

更新日期： 2005 年 12 月 5 日

创建一个代理作业，该代理作业可为具有参数化行筛选器的发布生成筛选数据快照。此存储过程在发布服务器的发布数据库中执行。管理员使用此存储过程可手动为订阅服务器创建筛选数据快照作业。

注意：
为了创建筛选数据快照作业，必须存在该发布的标准快照作业。

有关详细信息，请参阅带有参数化筛选器的合并发布的快照。

Transact-SQL 语法约定

语法

sp_adddynamicsnapshot_job [ @publication = ] 'publication' 
    [ , [ @suser_sname = ] 'suser_sname' ] 
    [ , [ @host_name = ] 'host_name' ] 
    [ , [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname' OUTPUT ] 
    [ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' OUTPUT ] 
    [ , [ @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 ]

参数

• [ @publication = ] 'publication'
  为其添加筛选数据快照作业的发布的名称。publication 的数据类型为 sysname，无默认值。

• [ @suser_sname= ] 'suser_sname'
  为订阅创建筛选数据快照时使用的值，该值由订阅服务器中 SUSER_SNAME 函数的值进行筛选。suser_sname 的数据类型为 sysname，无默认值。如果不使用此函数对发布进行动态筛选，则 suser_sname 应为 NULL。

• [ @host_name= ] 'host_name'
  为订阅创建筛选数据快照时使用的值，该值由订阅服务器中 HOST_NAME 函数的值进行筛选。host_name 的数据类型为 sysname，无默认值。如果不使用此函数对发布进行动态筛选，则 host_name 应为 NULL。

• [ @dynamic_snapshot_jobname= ] 'dynamic_snapshot_jobname'
  创建的筛选数据快照作业的名称。dynamic_snapshot_jobname 的数据类型为 sysname，默认值为 NULL，是一个可选的 OUTPUT 参数。如果指定，则 dynamic_snapshot_jobname 必须在分发服务器上解析为一个唯一作业。如果不指定，则将自动生成并在结果集中返回一个作业名，该名称的创建方式如下：

  'dyn_' + <name of the standard snapshot job> + <GUID>
  

  注意：
  生成动态快照作业的名称时，您可以截断标准快照作业的名称。

• [ @dynamic_snapshot_jobid= ] 'dynamic_snapshot_jobid'
  创建的筛选数据快照作业的标识符。dynamic_snapshot_jobid 的数据类型为 uniqueidentifier，默认值为 NULL，是一个可选的 OUTPUT 输出参数。

• [ @frequency_type=] frequency_type
  调度筛选数据快照作业所用的频率。frequency_type 的数据类型为 int，可以是下列值之一。

  值	说明
  1	一次
  2	按需
  4（默认值）	每天
  8	每周
  16	每月
  32	“每月”选项相关
  64	自动启动
  128	重复执行

• [ @frequency_interval=] frequency_interval
  执行筛选数据快照作业的时间段（以天计）。frequency_interval 的数据类型为 int，默认值为 1，具体取决于 frequency_type 的值。

  frequency_type 的值	对 frequency_interval 的影响
  1	frequency_interval 未使用。
  4（默认值）	每隔 frequency_interval 天，默认为每天。
  8	frequency_interval 为下列一个或多个值（与 |（位或）(Transact-SQL) 逻辑运算符结合使用）： 1 = 星期日 | 2 = 星期一 | 4 = 星期二 | 8 = 星期三 | 16 = 星期四 | 32 = 星期五 | 64 = 星期六
  16	在每月的 frequency_interval 日。
  32	frequency_interval 是下列值之一： 1 = 星期日 | 2 = 星期一 | 3 = 星期二 | 4 = 星期三 | 5 = 星期四 | 6 = 星期五 | 7 = 星期六 | 8 = 日 | 9 = 工作日 | 10 = 休息日
  64	frequency_interval 未使用。
  128	frequency_interval 未使用。

• [ @frequency_subday=] frequency_subday
  指定 frequency_subday_interval 的单位。frequency_subday 的数据类型为 int，可以是下列值之一：

  值	说明
  1	一次
  2	秒钟
  4（默认值）	分钟
  8	小时

• [ @frequency_subday_interval=] frequency_subday_interval
  在每两次执行作业之间出现的 frequency_subday 时间段的数量。frequency_subday_interval 的数据类型为 int，默认值为 5。

• [ @frequency_relative_interval=] frequency_relative_interval
  每月中筛选数据快照作业的发生情况。将 frequency_type 设置为 32（与“每月”选项相关），则使用此参数。frequency_relative_interval 的数据类型为 int，可以是下列值之一：

  值	说明
  1（默认值）	第一个
  2	第二个
  4	第三个
  8	第四个
  16	最后一个

• [ @frequency_recurrence_factor=] frequency_recurrence_factor
  frequency_type 使用的重复因子。frequency_recurrence_factor 的数据类型为 int，默认值为 0。

• [ @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。

返回代码值

0（成功）或 1（失败）

结果集

备注

sp_adddynamicsnapshot_job 用于对使用参数化筛选器的发布进行合并复制。

权限

只有 sysadmin 固定服务器角色成员或 db_owner 固定数据库角色成员可以执行 sp_adddynamicsnapshot_job。

示例

-- To avoid storing the login and password in the script file, the value 
-- is passed into SQLCMD as a scripting variable. For information about 
-- how to use scripting variables on the command line and in SQL Server
-- Management Studio, see the "Executing Replication Scripts" section in
-- the topic "Programming Replication Using System Stored Procedures".

--Add a new merge publication.
DECLARE @publicationdb AS sysname;
DECLARE @publication AS sysname;
DECLARE @table1 AS sysname;
DECLARE @table2 AS sysname;
DECLARE @filter AS sysname;
DECLARE @schema_hr AS sysname;
DECLARE @schema_sales AS sysname;

SET @publicationdb = N'AdventureWorks';
SET @publication = N'AdvWorksSalesPersonMerge';
SET @table1 = N'Employee';
SET @table2 = N'SalesPerson';
SET @filter = N'SalesPerson_Employee';
SET @schema_hr = N'HumanResources';
SET @schema_sales = N'Sales';

USE [AdventureWorks];

-- Enable AdventureWorks for merge replication.
EXEC sp_replicationdboption
  @dbname = @publicationdb,
  @optname = N'merge publish',
  @value = N'true';  

-- Create new merge publication.  
EXEC sp_addmergepublication 
  @publication = @publication, 
  @description = N'Merge publication of AdventureWorks.', 
  @allow_subscriber_initiated_snapshot = N'false';

-- Create a new snapshot job for the publication, using the 
-- default schedule. Pass credentials at runtime using 
-- sqlcmd scripting variables.
EXEC sp_addpublication_snapshot 
  @publication = @publication, 
  @job_login = $(Login), 
  @job_password = $(password);

-- Add an article for the Employee table, 
-- which is horizontally partitioned using 
-- a parameterized row filter.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table1, 
  @source_owner = @schema_hr, 
  @source_object = @table1, 
  @type = N'table', 
  @description = 'contains employee information', 
  @subset_filterclause = N'[LoginID] = HOST_NAME()';

-- Add an article for the SalesPerson table, 
-- which is partitioned based on a join filter.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table2, 
  @source_owner = @schema_sales, 
  @source_object = @table2, 
  @type = N'table', 
  @description = 'contains customer information';

-- Add a join filter between the two articles.
EXEC sp_addmergefilter 
  @publication = @publication, 
  @article = @table1, 
  @filtername = @filter, 
  @join_articlename = @table2, 
  @join_filterclause = N'[Employee].[EmployeeID] = [SalesPerson].[SalesPersonID]', 
  @join_unique_key = 1, 
  @filter_type = 1;
GO

-- Start the snapshot agent job.
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesPersonMerge';

EXEC sp_startpublication_snapshot 
  @publication = @publication;
GO

PRINT '*** Waiting for the initial snapshot.';
GO

-- Create a temporary table to store the filtered data snapshot 
-- job information.
CREATE TABLE #temp (id int,
    job_name sysname,
    job_id uniqueidentifier,
    dynamic_filter_login sysname NULL,
    dynamic_filter_hostname sysname NULL,
    dynamic_snapshot_location nvarchar(255),
    frequency_type int, 
    frequency_interval int, 
    frequency_subday_type int,
    frequency_subday_interval int, 
    frequency_relative_interval int, 
    frequency_recurrence_factor int, 
    active_start_date int, 
    active_end_date int, 
    active_start_time int, 
    active_end_time int
)

-- Create each snapshot for a partition 
-- The initial snapshot must already be generated.
DECLARE @publication AS sysname;
DECLARE @jobname AS sysname
DECLARE @hostname AS sysname
SET @publication = N'AdvWorksSalesPersonMerge';
SET @hostname = N'adventure-works\Fernando';

WHILE NOT EXISTS(SELECT * FROM sysmergepublications 
    WHERE [name] = @publication 
    AND snapshot_ready = 1)
BEGIN
    WAITFOR DELAY '00:00:05'
END

-- Create a data partition by overriding HOST_NAME().
EXEC sp_addmergepartition 
  @publication = @publication,
  @host_name = @hostname;

-- Create the filtered data snapshot job, and use the returned 
-- information to start the job.
EXEC sp_adddynamicsnapshot_job 
  @publication = @publication,
  @host_name = @hostname;

INSERT INTO #temp (id, job_name, job_id, dynamic_filter_login,
    dynamic_filter_hostname, dynamic_snapshot_location,
    frequency_type, frequency_interval, frequency_subday_type,
    frequency_subday_interval, frequency_relative_interval, 
    frequency_recurrence_factor, active_start_date, active_end_date, 
    active_start_time,active_end_time)
EXEC sp_helpdynamicsnapshot_job;

SELECT @jobname = (SELECT DISTINCT job_name FROM #temp WHERE dynamic_filter_hostname = @hostname);

EXEC msdb..sp_start_job @job_name = @jobname;
DROP TABLE #temp;
GO

请参阅

参考

sp_dropdynamicsnapshot_job (Transact-SQL)
sp_helpdynamicsnapshot_job (Transact-SQL)

其他资源

How to: Create a Snapshot for a Merge Publication with Parameterized Filters (Replication Transact-SQL Programming)
参数化行筛选器

帮助和信息

获取 SQL Server 2005 帮助

更改历史记录