sys.sp_droparticle (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Verwijdert een artikel uit een snapshot of transactionele publicatie. Een artikel kan niet worden verwijderd als er één of meer abonnementen op bestaan. Deze opgeslagen procedure wordt uitgevoerd bij Publisher in de publicatiedatabase.

Transact-SQL syntaxis-conventies

Syntax

sys.sp_droparticle
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @from_drop_publication = ] from_drop_publication ]
[ ; ]

Arguments

[ @publication = ] N'publicatie'

De naam van de publicatie waarin het artikel wordt verwijderd. @publication is sysname, zonder standaard.

[ @article = ] N'artikel'

De naam van het artikel dat wordt weggelaten. @article is sysname, zonder standaard.

[ @ignore_distributor = ] ignore_distributor

Alleen ter informatie geïdentificeerd. Wordt niet ondersteund. Toekomstige compatibiliteit is niet gegarandeerd.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

Erkent dat de actie die door deze opgeslagen procedure wordt uitgevoerd, een bestaande snapshot ongeldig kan maken. @force_invalidate_snapshot is bit, met een standaardwaarde van 0.

  • 0 geeft aan dat wijzigingen in het artikel niet ertoe leiden dat de momentopname ongeldig is. Als de opgeslagen procedure detecteert dat de wijziging een nieuwe snapshot vereist, ontstaat er een fout en worden er geen wijzigingen aangebracht.

  • 1 specificeert dat wijzigingen in het artikel ervoor kunnen zorgen dat de snapshot ongeldig wordt, en als er bestaande abonnementen zijn die een nieuwe snapshot vereisen, geeft het toestemming om de bestaande snapshot als verouderd te markeren en een nieuwe snapshot te genereren.

[ @publisher = ] N'uitgever'

Specificeert een niet-SQL Server Publisher. @publisher is sysname, met als standaard NULL.

Deze parameter mag niet worden gebruikt bij het wijzigen van artikeleigenschappen op een SQL Server Publisher.

[ @from_drop_publication = ] from_drop_publication

Alleen ter informatie geïdentificeerd. Wordt niet ondersteund. Toekomstige compatibiliteit is niet gegarandeerd.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Remarks

sp_droparticle wordt gebruikt in momentopnamen en transactionele replicatie.

Voor horizontaal gefilterde artikelen sp_droparticle controleert men de type kolom van het artikel in de sysarticles-tabel om te bepalen of een weergave of filter ook moet worden verwijderd. Als een weergave of filter automatisch is gegenereerd, wordt het met het artikel verwijderd. Als het handmatig is aangemaakt, wordt het niet verwijderd.

Het uitvoeren sp_droparticle om een artikel uit een publicatie te verwijderen verwijdert het object niet uit de publicatiedatabase of het bijbehorende object uit de abonnementsdatabase. Gebruik DROP <object> deze objecten handmatig te verwijderen indien nodig.

Examples

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

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

Permissions

Alleen leden van de sysadmin-vaste serverrol of db_owner vaste databaserol kunnen uitvoeren sp_droparticle.

Verwante inhoud

  • Last updated on