sp_dropmergearticle (Transact-SQL)

删除合并发布中的项目。 此存储过程在发布服务器的发布数据库中执行。

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

语法

sp_dropmergearticle [ @publication= ] 'publication'
        , [ @article= ] 'article' 
    [ , [ @ignore_distributor= ] ignore_distributor 
    [ , [ @reserved= ] reserved 
    [ , [ @force_invalidate_snapshot= ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @ignore_merge_metadata = ] ignore_merge_metadata ]

参数

  • [ @publication = ] 'publication'
    是要从中删除项目的发布的名称。publication 的数据类型为 sysname,无默认值。

  • [ @article = ] 'article'
    要从给定发布中删除的项目名称。article的数据类型为 sysname,没有默认值。 如果为 all,则删除指定合并发布中的所有现有项目。 即使 article 为 all,发布仍必须与项目分开删除。

  • [ @ignore_distributor=] ignore_distributor
    指示是否在未连接到分发服务器的情况下执行此存储过程。ignore_distributor 的数据类型为 bit,默认值为 0

  • [ @reserved=] reserved
    保留以备将来使用。reserved 的数据类型为 nvarchar(20),默认值为 NULL。

  • [ @force_invalidate_snapshot = ] force_invalidate_snapshot
    启用或禁用使快照失效的功能。force_invalidate_snapshot 的数据类型为 bit,默认值为 0

    0 指定对合并项目所做的更改不会导致快照失效。

    值为 1 表示更改合并项目可能会导致快照无效;如果是这样,值为 1 将提供使新快照发生的权限。

  • [ @force_reinit_subscription = ] force_reinit_subscription
    确认删除项目是否要求重新初始化现有订阅。force_reinit_subscription 的数据类型为 bit,默认值为 0

    值为 0 指定删除项目不会导致重新初始化订阅。

    值为 1 表示删除项目将会导致重新初始化现有订阅,并提供使订阅重新初始化发生的权限。

  • [ @ignore_merge_metadata= ] ignore_merge_metadata
    仅供内部使用。

返回代码值

0(成功)或 1(失败)

注释

sp_dropmergearticle 用于合并复制。 有关删除项目的详细信息,请参阅向现有发布添加项目和从中删除项目

执行 sp_dropmergearticle 以从发布中删除项目将不会从发布数据库中删除该对象或从订阅数据库中删除相应对象。 如果需要,可以使用 DROP <object> 手动删除这些对象。

示例

DECLARE @publication AS sysname;
DECLARE @table1 AS sysname;
DECLARE @table2 AS sysname;
DECLARE @table3 AS sysname;
DECLARE @salesschema AS sysname;
DECLARE @hrschema AS sysname;
DECLARE @filterclause AS nvarchar(1000);
SET @publication = N'AdvWorksSalesOrdersMerge'; 
SET @table1 = N'Employee'; 
SET @table2 = N'SalesOrderHeader'; 
SET @table3 = N'SalesOrderDetail'; 
SET @salesschema = N'Sales';
SET @hrschema = N'HumanResources';
SET @filterclause = N'Employee.LoginID = HOST_NAME()';

-- Drop the merge join filter between SalesOrderHeader and SalesOrderDetail.
EXEC sp_dropmergefilter 
  @publication = @publication, 
  @article = @table3, 
  @filtername = N'SalesOrderDetail_SalesOrderHeader', 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Drops the merge join filter between Employee and SalesOrderHeader.
EXEC sp_dropmergefilter 
  @publication = @publication, 
  @article = @table2, 
  @filtername = N'SalesOrderHeader_Employee', 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Drops the article for the SalesOrderDetail table.
EXEC sp_dropmergearticle 
  @publication = @publication, 
  @article = @table3,
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Drops the article for the SalesOrderHeader table.
EXEC sp_dropmergearticle 
  @publication = @publication, 
  @article = @table2, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Drops the article for the Employee table.
EXEC sp_dropmergearticle 
  @publication = @publication, 
  @article = @table1,
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;
GO

DECLARE @publication AS sysname;
DECLARE @article1 AS sysname;
DECLARE @article2 AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @article1 = N'SalesOrderDetail'; 
SET @article2 = N'SalesOrderHeader'; 

-- Remove articles from a merge publication.
USE [AdventureWorks]
EXEC sp_dropmergearticle 
  @publication = @publication, 
  @article = @article1,
  @force_invalidate_snapshot = 1;
EXEC sp_dropmergearticle 
  @publication = @publication, 
  @article = @article2,
  @force_invalidate_snapshot = 1;
GO

权限

只有 sysadmin 固定服务器角色成员或 db_owner 固定数据库角色成员才能执行 sp_dropmergearticle