sp_dropmergearticle (Transact-SQL)sp_dropmergearticle (Transact-SQL)

S’APPLIQUE À : ouiSQL Server nonAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Supprime un article d'une publication de fusion.Removes an article from a merge publication. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.This stored procedure is executed at the Publisher on the publication database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

  
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 ]  

ArgumentsArguments

[ @publication = ] 'publication' Est le nom de la publication à partir de laquelle supprimer un article.[ @publication = ] 'publication' Is the name of the publication from which to drop an article. publicationest sysname, sans valeur par défaut.publicationis sysname, with no default.

[ @article = ] 'article' Est le nom de l’article à supprimer de la publication donnée.[ @article = ] 'article' Is the name of the article to drop from the given publication. articleest sysname, sans valeur par défaut.articleis sysname, with no default. Si tous les, tous les articles existants dans la publication de fusion spécifiée sont supprimés.If all, all existing articles in the specified merge publication are removed. Même si article est tous les, la publication doit toujours être supprimée séparément à partir de l’article.Even if article is all, the publication still must be dropped separately from the article.

[ @ignore_distributor = ] ignore_distributor Indique si cette procédure stockée est exécutée sans se connecter au serveur de distribution.[ @ignore_distributor = ] ignore_distributor Indicates whether this stored procedure is executed without connecting to the Distributor. ignore_distributor est bits, avec une valeur par défaut 0.ignore_distributor is bit, with a default of 0.

[ @reserved = ] reserved est réservé pour une utilisation ultérieure.[ @reserved = ] reserved Is reserved for future use. réservé est nvarchar (20) , avec NULL comme valeur par défaut.reserved is nvarchar(20), with a default of NULL.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot Active ou désactive la possibilité d’invalider un instantané.[ @force_invalidate_snapshot = ] force_invalidate_snapshot Enables or disables the ability to have a snapshot invalidated. àce_invalidate_snapshot est un bits, avec une valeur par défaut 0.force_invalidate_snapshot is a bit, with a default 0.

0 Spécifie que les modifications apportées à l’article de fusion n’invalident pas l’instantané n’est pas valide.0 specifies that changes to the merge article do not cause the snapshot to be invalid.

1 signifie que les modifications apportées à l’article de fusion peuvent invalider l’instantané n’est pas valide, et si c’est le cas, la valeur 1 autorise le nouvel instantané de se produire.1 means that changes to the merge article may cause the snapshot to be invalid, and if that is the case, a value of 1 gives permission for the new snapshot to occur.

[ @force_reinit_subscription = ] force_reinit_subscription Confirme que la suppression de l’article nécessite la réinitialisation des abonnements existants.[ @force_reinit_subscription = ] force_reinit_subscription Acknowledges that dropping the article requires existing subscriptions to be reinitialized. àce_reinit_subscription est un bits, avec une valeur par défaut 0.force_reinit_subscription is a bit, with a default of 0.

0 indique que la suppression de l’article n’entraîne pas la réinitialisation de l’abonnement.0 specifies that dropping the article does not cause the subscription to be reinitialized.

1 signifie que la suppression de l’article entraîne la réinitialisation des abonnements existants et autorise la réinitialisation des abonnements se produise.1 means that dropping the article causes existing subscriptions to be reinitialized, and gives permission for the subscription reinitialization to occur.

[ @ignore_merge_metadata = ] ignore_merge_metadata Usage interne uniquement.[ @ignore_merge_metadata = ] ignore_merge_metadata Internal use only.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_dropmergearticle est utilisé dans la réplication de fusion.sp_dropmergearticle is used in merge replication. Pour plus d’informations sur la suppression des articles, consultez ajouter et supprimer des Articles de Publications existantes.For more information about dropping articles, see Add Articles to and Drop Articles from Existing Publications.

L’exécution de sp_dropmergearticle pour supprimer un article d’une publication ne supprime pas l’objet de la base de données de publication ou de l’objet correspondant de la base de données d’abonnement.Executing sp_dropmergearticle to drop an article from a publication does not remove the object from the publication database or the corresponding object from the subscription database. Utilisez DROP <object> pour supprimer manuellement ces objets le cas échéant.Use DROP <object> to remove these objects manually if necessary.

AutorisationsPermissions

Seuls les membres de la sysadmin rôle serveur fixe ou le db_owner rôle de base de données fixe peuvent exécuter sp_dropmergearticle.Only members of the sysadmin fixed server role or the db_owner fixed database role can execute sp_dropmergearticle.

ExempleExample

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  

Voir aussiSee Also

Supprimer un Article Delete an Article
Ajouter et supprimer des articles de publications existantes Add Articles to and Drop Articles from Existing Publications
sp_addmergearticle (Transact-SQL) sp_addmergearticle (Transact-SQL)
sp_changemergearticle (Transact-SQL) sp_changemergearticle (Transact-SQL)
sp_helpmergearticle (Transact-SQL) sp_helpmergearticle (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)Replication Stored Procedures (Transact-SQL)