sys.sp_dropsubscription (Transact-SQL)

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

Försvinner prenumerationer på en viss artikel, publikation eller uppsättning prenumerationer på Publisher. Den här lagrade proceduren körs i Publisher i publikationsdatabasen.

Transact-SQL syntaxkonventioner

Syntax

sys.sp_dropsubscription
    [ [ @publication = ] N'publication' ]
    [ , [ @article = ] N'article' ]
    , [ @subscriber = ] N'subscriber'
    [ , [ @destination_db = ] N'destination_db' ]
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @reserved = ] N'reserved' ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Arguments

[ @publication = ] N'publicering'

Namnet på den associerade publikationen. @publication är sysname, med standardvärdet .NULL Om all, avslutas alla prenumerationer för alla publikationer för den angivna prenumeranten. @publication är en obligatorisk parameter.

[ @article = ] Inte en artikel'

Namnet på artikeln. @article är sysname, med standardvärdet .NULL Om all, avslutas prenumerationer på alla artiklar för varje angiven publikation och Prenumerant. Använd all böcker som tillåter omedelbar uppdatering.

[ @subscriber = ] N'prenumerant'

Namnet på prenumeranten som kommer att få sina prenumerationer avbrutna. @subscriber är sysname, utan standard. Om all, alla prenumerationer för alla prenumeranter avslutas.

[ @destination_db = ] N'destination_db'

Namnet på destinationsdatabasen. @destination_db är sysname, med standardvärdet .NULL Om NULL, avslutas alla prenumerationer från den prenumeranten.

[ @ignore_distributor = ] ignore_distributor

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

[ @reserved = ] N'reserved'

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

[ @publisher = ] N'publisher'

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

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Remarks

sp_dropsubscription används i ögonblicksbilder och transaktionsreplikering.

Om du avslutar prenumerationen på en artikel i en immediate-sync-publikation kan du inte lägga till den igen om du inte tar bort prenumerationerna på alla artiklar i publikationen och lägger till dem alla på en gång.

Exempel

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables  
-- on the command line and in SQL Server Management Studio, see the 
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".

-- This batch is executed at the Publisher to remove 
-- a pull or push subscription to a transactional publication.
DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @subscriber = $(SubServer);

USE [AdventureWorks2022]
EXEC sp_dropsubscription 
  @publication = @publication, 
  @article = N'all',
  @subscriber = @subscriber;
GO

Permissions

Endast medlemmar av sysadmin-fixserverrollen , den db_owner fasta databasrollen eller användaren som skapade prenumerationen kan köra sp_dropsubscription.

Relaterat innehåll

  • Last updated on