sys.sp_droparticle (Transact-SQL)

gäller för:SQL ServerAzure SQL Managed Instance

Tar bort en artikel från en snapshot eller transaktionspublikation. En artikel kan inte tas bort om en eller flera prenumerationer på den finns. Den här lagrade proceduren körs i Publisher i publikationsdatabasen.

Transact-SQL syntaxkonventioner

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'publicering'

Namnet på publikationen som innehåller artikeln som ska tas bort. @publication är sysname, utan standard.

[ @article = ] Inte en artikel'

Namnet på artikeln som ska tas bort. @article är sysname, utan standard.

[ @ignore_distributor = ] ignore_distributor

Identifieras endast i informationssyfte. Stöds ej. Framtida kompatibilitet garanteras inte.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

Erkänner att åtgärden som utförs av denna lagrade procedur kan ogiltigförklara en befintlig snapshot. @force_invalidate_snapshot är bit, med standardvärdet 0.

  • 0 anger att ändringar i artikeln inte gör att ögonblicksbilden blir ogiltig. Om den lagrade proceduren upptäcker att ändringen kräver en ny snapshot, uppstår ett fel och inga ändringar görs.

  • 1 specificerar att ändringar i artikeln kan göra att snapshoten blir ogiltig, och om det finns befintliga prenumerationer som kräver en ny snapshot, ger den tillåtelse att den befintliga snapshoten markeras som föråldrad och generera en ny snapshot.

[ @publisher = ] N'publisher'

Specificerar en icke-SQL Server Publisher. @publisher är sysname, med standardvärdet .NULL

Denna parameter bör inte användas när man ändrar artikelegenskaper på en SQL Server Publisher.

[ @from_drop_publication = ] from_drop_publication

Identifieras endast i informationssyfte. Stöds ej. Framtida kompatibilitet garanteras inte.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Remarks

sp_droparticle används i ögonblicksbilder och transaktionsreplikering.

För horisontellt filtrerade artiklar sp_droparticle kontrolleras kolumnen type i sysartikeltabellen för att avgöra om en vy eller ett filter också ska tas bort. Om en visning eller ett filter genererades automatiskt tas det bort med artikeln. Om den skapades manuellt tas den inte bort.

Att köra sp_droparticle för att ta bort en artikel från en publikation tar inte bort objektet från publikationsdatabasen eller motsvarande objekt från prenumerationsdatabasen. Använd DROP <object> det för att manuellt ta bort dessa objekt om det behövs.

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

Endast medlemmar av sysadmin-fasta serverrollen eller db_owner fasta databasrollen kan köra sp_droparticle.

Relaterat innehåll

  • Last updated on