sys.sp_droparticle (Transact-SQL)

Platí na:SQL ServerAzureSQL Managed Instance

Zveřejní článek z momentky nebo transakčního publikace. Článek nelze odstranit, pokud existuje jedno nebo více jeho odběrů. Tato uložená procedura se spustí v Publisheru v databázi publikace.

Transact-SQL konvence syntaxe

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

Název publikace, která článek obsahuje, má být vynechán. @publication je sysname, bez výchozího nastavení.

[ @article = ] N'článek'

Název článku, který bude vynechán. @article je sysname, bez výchozího nastavení.

[ @ignore_distributor = ] ignore_distributor

Určeno pouze pro informační účely. Není podporováno. Budoucí kompatibilita není zaručena.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

Uznává, že akce provedená touto uloženou procedurou může zneplatnit existující snímek. @force_invalidate_snapshot je bit s výchozím nastavením 0.

  • 0 určuje, že změny článku nezpůsobí, že snímek bude neplatný. Pokud uložená procedura zjistí, že změna vyžaduje nový snapshot, dojde k chybě a žádné změny nejsou provedeny.

  • 1 specifikuje, že změny článku mohou způsobit, že snapshot bude neplatný, a pokud existují existující předplatné, která vyžadují nový snapshot, dává povolení označit stávající snapshot jako zastaralý a vytvořit nový snapshot.

[ @publisher = ] N'publisher'

Specifikuje vydavatele mimo SQL Server. @publisher je sysname s výchozím nastavením NULL.

Tento parametr by se neměl používat při změně vlastností článku na SQL Server Publisher.

[ @from_drop_publication = ] from_drop_publication

Určeno pouze pro informační účely. Není podporováno. Budoucí kompatibilita není zaručena.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Remarks

sp_droparticle se používá ve snímku a transakční replikaci.

U článků s horizontálním filtrem se sp_droparticle v tabulce type zkontroluje sloupec článku, aby se zjistilo, zda by měl být také vynechán pohled nebo filtr. Pokud byl pohled nebo filtr automaticky generován, je odstraněn spolu s článkem. Pokud byla vytvořena ručně, nebyla ztracena.

Spuštění sp_droparticle odstranění článku z publikace objekt z publikace neodstraní z databáze publikací ani odpovídající objekt z databáze předplatného. Použijte DROP <object> tyto objekty k ručnímu odstranění, pokud je to nutné.

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

Pouze členové role pevného serveru správce systému nebo role pevné databáze db_owner mohou vykonávat sp_droparticle.