sp_dropmergearticle(Transact-SQL)
적용 대상: SQL Server
병합 게시에서 아티클을 제거합니다. 이 저장 프로시저는 게시 데이터베이스의 게시자에서 실행됩니다.
구문
sp_dropmergearticle
[ @publication = ] N'publication'
, [ @article = ] N'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 = ] N'publication'
아티클을 삭제할 게시의 이름입니다. @publication 기본값이 없는 sysname입니다.
[ @article = ] N'article'
지정된 발행물에서 삭제할 아티클의 이름입니다. @article 기본값이 없는 sysname입니다. 이 경우 all
지정된 병합 게시의 모든 기존 아티클이 제거됩니다. @article all
경우에도 아티클과 별도로 게시를 삭제해야 합니다.
[ @ignore_distributor = ] ignore_distributor
이 저장 프로시저가 배포자에 연결되지 않고 실행되는지 여부를 표시합니다. @ignore_distributor 비트이며 기본값은 .입니다0
.
[ @reserved = ] 예약됨
향후 사용을 위해 예약되어 있습니다. @reserved 비트이며 기본값은 .입니다0
.
[ @force_invalidate_snapshot = ] force_invalidate_snapshot
스냅샷 무효화 기능을 설정하거나 해제합니다. @force_invalidate_snapshot 비트이며 기본값은 .입니다0
.
0
는 병합 아티클을 변경해도 스냅샷이 잘못되지 않도록 지정합니다.1
는 병합 아티클을 변경하면 스냅샷이 유효하지 않을 수 있으며, 이 경우 값이 새 스냅샷이1
발생할 수 있는 권한을 부여합니다.
[ @force_reinit_subscription = ] force_reinit_subscription
아티클을 삭제하려면 기존 구독을 다시 초기화해야 합니다. @force_reinit_subscription 비트이며 기본값은 .입니다0
.
0
는 아티클을 삭제해도 구독이 다시 초기화되지 않도록 지정합니다.1
는 아티클을 삭제하면 기존 구독이 다시 초기화되고 구독 다시 초기화가 발생할 수 있는 권한을 부여합니다.
[ @ignore_merge_metadata = ] ignore_merge_metadata
정보를 제공하기 위해서만 확인됩니다. 지원 안 됨. 향후 호환성은 보장되지 않습니다.
반환 코드 값
0
(성공) 또는 1
(실패).
설명
sp_dropmergearticle
는 병합 복제에 사용됩니다. 아티클 삭제에 대한 자세한 내용은 기존 게시에 아티클 추가 및 삭제를 참조하세요.
sp_dropmergearticle
게시에서 아티클을 삭제하기 위해 실행하면 구독 데이터베이스에서 게시 데이터베이스 또는 해당 개체에서 개체가 제거되지 않습니다. 필요한 경우 이러한 개체를 수동으로 제거하는 데 사용합니다 DROP <object>
.
사용 권한
sysadmin 고정 서버 역할 또는 db_owner 고정 데이터베이스 역할의 멤버만 실행할 sp_dropmergearticle
수 있습니다.
예제
이 문서의 Transact-SQL 코드 샘플은 AdventureWorks2022
또는 AdventureWorksDW2022
샘플 데이터베이스를 사용하며, 이는 Microsoft SQL Server 예시 및 커뮤니티 프로젝트(Microsoft SQL Server Samples and Community Projects) 홈 페이지에서 다운로드할 수 있습니다.
A. 병합 게시에서 아티클 제거
USE [AdventureWorks2022];
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';
EXEC sp_dropmergearticle @publication = @publication,
@article = @article1,
@force_invalidate_snapshot = 1;
EXEC sp_dropmergearticle @publication = @publication,
@article = @article2,
@force_invalidate_snapshot = 1;
GO
B. 병합 조인 필터 및 관련 문서 삭제
USE [AdventureWorks2022];
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;
-- Drop 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;
-- Drop the article for the SalesOrderDetail table.
EXEC sp_dropmergearticle @publication = @publication,
@article = @table3,
@force_invalidate_snapshot = 1,
@force_reinit_subscription = 1;
-- Drop the article for the SalesOrderHeader table.
EXEC sp_dropmergearticle @publication = @publication,
@article = @table2,
@force_invalidate_snapshot = 1,
@force_reinit_subscription = 1;
-- Drop the article for the Employee table.
EXEC sp_dropmergearticle @publication = @publication,
@article = @table1,
@force_invalidate_snapshot = 1,
@force_reinit_subscription = 1;
GO