sp_dropmergearticle(Transact-SQL)

아티클
05/07/2013

병합 게시에서 아티클을 제거합니다. 이 저장 프로시저는 게시 데이터베이스의 게시자에서 실행됩니다.

구문

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 @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

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