删除项目

项目
10/05/2023

适用于：SQL Server Azure SQL 托管实例

本主题介绍如何使用 Transact-SQL 或复制管理对象 (RMO) 在 SQL Server 中删除项目。有关删除项目时使用的条件以及删除项目是否需要新的快照或重新初始化订阅的信息，请参阅向现有发布添加项目和从中删除项目。

本主题内容

删除项目，使用：

Transact-SQL

复制管理对象 (RMO)

“使用 Transact-SQL”

可以使用复制存储过程以编程方式删除项目。使用的存储过程取决于项目所属的发布的类型。

从快照或事务发布中删除项目

执行 sp_droparticle (Transact-SQL) 以从 @publication 指定的发布中删除 @article 指定的项目。将 @force_invalidate_snapshot 的值指定为 1。
（可选）若要从数据库完全删除已发布的对象，请在发布服务器上对发布数据库执行 DROP <objectname> 命令。

从合并发布删除项目

执行 sp_dropmergearticle (Transact-SQL) 以从 @publication 指定的发布中删除 @article 指定的项目。如有必要，可将 @force_invalidate_snapshot 的值指定为 1 并将 @force_reinit_subscription 的值指定为 1。
（可选）若要从数据库完全删除已发布的对象，请在发布服务器上对发布数据库执行 DROP <objectname> 命令。

示例 (Transact-SQL)

下面的示例将从事务发布中删除项目。因为此更改使现有快照失效，所以 @force_invalidate_snapshot 参数的值将会指定为 1 。

DECLARE @publication AS sysname;  
DECLARE @article AS sysname;  
SET @publication = N'AdvWorksProductTran';   
SET @article = N'Product';   
  
-- Drop the transactional article.  
USE [AdventureWorks]  
EXEC sp_droparticle   
  @publication = @publication,   
  @article = @article,  
  @force_invalidate_snapshot = 1;  
GO

下面的示例将从合并发布中删除两个项目。因为这些更改使现有快照失效，所以 @force_invalidate_snapshot 参数的值将会指定为 1 。

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

使用复制管理对象 (RMO)

可以使用复制管理对象 (RMO) 以编程方式删除项目。用于删除项目的 RMO 类取决于该项目所属的发布的类型。

删除属于快照发布或事务发布的项目

使用 ServerConnection 类创建与发布服务器的连接。
创建 TransArticle 类的一个实例。
设置 Name、 PublicationName和 DatabaseName 属性。
为 ConnectionContext 属性设置步骤 1 中的连接。
检查 IsExistingObject 属性以验证该项目是否存在。如果此属性的值为 false，则步骤 3 中的项目属性定义不正确或此项目不存在。
调用 Remove 方法。
关闭所有连接。

删除属于合并发布的项目

使用 ServerConnection 类创建与发布服务器的连接。
创建 MergeArticle 类的一个实例。
设置 Name、 PublicationName和 DatabaseName 属性。
为 ConnectionContext 属性设置步骤 1 中的连接。
检查 IsExistingObject 属性以验证该项目是否存在。如果此属性的值为 false，则步骤 3 中的项目属性定义不正确或此项目不存在。
调用 Remove 方法。
关闭所有连接。

另请参阅

向现有发布添加项目和从中删除项目
 Replication System Stored Procedures Concepts