sp_droparticle (Transact-SQL)sp_droparticle (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

Supprime un article d'une publication transactionnelle ou d'instantané.Drops an article from a snapshot or transactional publication. Un article ne peut être supprimé s'il fait l'objet d'un ou plusieurs abonnements.An article cannot be removed if one or more subscriptions to it exist. 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_droparticle [ @publication= ] 'publication'  
        , [ @article= ] 'article'  
    [ , [ @ignore_distributor = ] ignore_distributor ]  
    [ , [ @force_invalidate_snapshot= ] force_invalidate_snapshot ]  
    [ , [ @publisher = ] 'publisher' ]  
    [ , [ @from_drop_publication = ] from_drop_publication ]  

ArgumentsArguments

[ @publication = ] 'publication'Nom de la publication contenant l’article à supprimer.[ @publication = ] 'publication' Is the name of the publication that contains the article to be dropped. publication est de type sysname, sans valeur par défaut.publication is sysname, with no default.

[ @article = ] 'article'Nom de l’article à supprimer.[ @article = ] 'article' Is the name of the article to be dropped. article est de type sysnameet n’a pas de valeur par défaut.article is sysname, with no default.

[ @ignore_distributor = ] ignore_distributor Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.[ @ignore_distributor = ] ignore_distributor Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.

[ @force_invalidate_snapshot = ] force_invalidate_snapshotConfirme que l’action entreprise par cette procédure stockée peut invalider un instantané existant.[ @force_invalidate_snapshot = ] force_invalidate_snapshot Acknowledges that the action taken by this stored procedure may invalidate an existing snapshot. force_invalidate_snapshot est un bit, avec 0comme valeur par défaut.force_invalidate_snapshot is a bit, with a default of 0.

0 indique que les modifications apportées à l’article n’entraînent pas la non-validité de l’instantané.0 specifies that changes to the article do not cause the snapshot to be invalid. Si la procédure stockée détecte que la modification requiert un nouvel instantané, une erreur se produit et aucune modification n'est effectuée.If the stored procedure detects that the change does require a new snapshot, an error occurs and no changes are made.

1 indique que les modifications apportées à l’article peuvent entraîner la non-validité de l’instantané, et s’il existe des abonnements qui nécessitent un nouvel instantané, donne l’autorisation de marquer l’instantané existant comme obsolète et de générer un nouvel instantané.1 specifies that changes to the article may cause the snapshot to be invalid, and if there are existing subscriptions that would require a new snapshot, gives permission for the existing snapshot to be marked as obsolete and a new snapshot generated.

[ @publisher = ] 'publisher'Spécifie un serveur MicrosoftMicrosoft de publication non- SQL ServerSQL Server .[ @publisher = ] 'publisher' Specifies a non- MicrosoftMicrosoft SQL ServerSQL Server Publisher. Publisher est de type sysname, avec NULL comme valeur par défaut.publisher is sysname, with a default of NULL.

Notes

l' éditeur ne doit pas être utilisé lors de la modification SQL ServerSQL Server des propriétés d’un article sur un serveur de publication.publisher should not be used when changing article properties on a SQL ServerSQL Server Publisher.

[ @from_drop_publication = ] from_drop_publication Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.[ @from_drop_publication = ] from_drop_publication Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_droparticle est utilisé dans la réplication transactionnelle et d’instantané.sp_droparticle is used in snapshot and transactional replication.

Pour les articles filtrés horizontalement, sp_droparticle vérifie la colonne type de l’article dans la table Transact-) SQL (sysarticles pour déterminer si une vue ou un filtre doit également être supprimé.For horizontally filtered articles, sp_droparticle checks the type column of the article in the sysarticles (Transact-SQL) table to determine whether a view or filter should also be dropped. Si une vue ou un filtre ont été générés automatiquement, ils sont supprimés avec l'article.If a view or filter was autogenerated, it is dropped with the article. S'ils ont été créés manuellement, ils ne sont pas supprimés.If it was manually created, it is not dropped.

L’exécution de sp_droparticle pour supprimer un article d’une publication ne supprime pas l’objet de la base de données de publication ou l’objet correspondant de la base de données d’abonnement.Executing sp_droparticle 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 ces objets manuellement si nécessaire.Use DROP <object> to manually remove these objects if necessary.

ExempleExample

DECLARE @publication AS sysname;
DECLARE @article AS sysname;
SET @publication = N'AdvWorksProductTran'; 
SET @article = N'Product'; 

-- Drop the transactional article.
USE [AdventureWorks2012]
EXEC sp_droparticle 
  @publication = @publication, 
  @article = @article,
  @force_invalidate_snapshot = 1;
GO

AutorisationsPermissions

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

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_addarticle (Transact-SQL) sp_addarticle (Transact-SQL)
sp_changearticle (Transact-SQL) sp_changearticle (Transact-SQL)
sp_helparticle (Transact-SQL) sp_helparticle (Transact-SQL)
sp_helparticlecolumns (Transact-SQL) sp_helparticlecolumns (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)Replication Stored Procedures (Transact-SQL)