sys.sp_droppullsubscription (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Sluit een abonnement op de huidige database van de abonnee in. Deze opgeslagen procedure wordt uitgevoerd bij de abonnee in de pull subscription-database.

Transact-SQL syntaxis-conventies

Syntax

sys.sp_droppullsubscription
    [ @publisher = ] N'publisher'
    [ , [ @publisher_db = ] N'publisher_db' ]
    , [ @publication = ] N'publication'
    [ , [ @reserved = ] reserved ]
    [ , [ @from_backup = ] from_backup ]
[ ; ]

Arguments

[ @publisher = ] N'uitgever'

De naam van de externe server. @publisher is sysname, zonder standaardinstelling. Als all, wordt het abonnement bij alle uitgevers beëindigd.

[ @publisher_db = ] N'publisher_db'

De naam van de Publisher-database. @publisher_db is een systeemnaam, met als standaard NULL. allbetekent alle Publisher-databases.

[ @publication = ] N'publicatie'

De naam van de publicatie. @publication is sysname, zonder standaard. Als all, wordt het abonnement op alle publicaties beëindigd.

[ @reserved = ] gereserveerd

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

[ @from_backup = ] from_backup

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

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Remarks

sp_droppullsubscription wordt gebruikt bij snapshotreplicatie en transactionele replicatie.

sp_droppullsubscription verwijdert de overeenkomstige rij in de MSreplication_subscriptions tabel en de bijbehorende Distributeuragent bij de Abonnee. Als er geen rijen meer in MSreplication_subscriptions zijn, valt de tabel weg.

Examples

-- 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 is the batch executed at the Subscriber to drop 
-- a pull subscription to a transactional publication.
DECLARE @publication AS sysname;
DECLARE @publisher AS sysname;
DECLARE @publicationDB     AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @publisher = $(PubServer);
SET @publicationDB = N'AdventureWorks2022';

USE [AdventureWorks2022Replica]
EXEC sp_droppullsubscription 
  @publisher = @publisher, 
  @publisher_db = @publicationDB, 
  @publication = @publication;
GO

Permissions

Alleen leden van de sysadmin-vaste serverrol of de gebruiker die het pull-abonnement heeft aangemaakt, kunnen uitvoeren sp_droppullsubscription. De db_owner vaste databaserol kan alleen worden uitgevoerd sp_droppullsubscription als de gebruiker die het pull-abonnement heeft aangemaakt tot deze rol behoort.