sp-dropmergepullsubscription-transact-sql.md

title	sp_dropmergepullsubscription (Transact-SQL) | Microsoft Docs
ms.custom
ms.date	03/03/2017
ms.prod	sql
ms.prod_service	database-engine
ms.reviewer
ms.technology	replication
ms.topic	language-reference
f1_keywords	sp_dropmergepullsubscription sp_dropmergepullsubscription_TSQL
helpviewer_keywords	sp_dropmergepullsubscription
ms.assetid	9301dd80-72f7-4adb-9b13-87e7f9114248
author	stevestein
ms.author	sstein

sp_dropmergepullsubscription (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-xxx-md]

Drops a merge pull subscription. This stored procedure is executed at the Subscriber on the subscription database.

Transact-SQL Syntax Conventions

Syntax

  
sp_dropmergepullsubscription [ @publication= ] 'publication'   
        , [ @publisher= ] 'publisher'   
        , [ @publisher_db= ] 'publisher_db'   
    [ , [ @reserved= ] 'reserved' ]  

Arguments

[ @publication = ] 'publication' Is the name of the publication. publication is sysname, with a default of NULL. This parameter is required. Specify a value of all to remove subscriptions to all publications

[ @publisher = ] 'publisher' Is the name of the Publisher. publisheris sysname, with a default of NULL. This parameter is required.

[ @publisher_db = ] 'publisher_db' Is the name of the Publisher database. publisher_dbis sysname, with a default of NULL. This parameter is required.

[ @reserved = ] 'reserved' Is reserved for future use. reserved is bit, with a default of 0.

Return Code Values

0 (success) or 1 (failure)

Remarks

sp_dropmergepullsubscription is used in merge replication.

sp_dropmergepullsubscription drops the Merge Agent for this merge pull subscription, although the Merge Agent is not created in sp_addmergepullsubscription.

Example

[!code-sqlHowTo#sp_dropmergepullsubscription]

Permissions

Only members of the sysadmin fixed server role or the user that created the merge pull subscription can execute sp_dropmergepullsubscription. The db_owner fixed database role is only able to execute sp_dropmergepullsubscription if the user that created the merge pull subscription belongs to this role.

See Also

Delete a Pull Subscription
sp_addmergepullsubscription (Transact-SQL)
sp_changemergepullsubscription (Transact-SQL)
sp_dropmergesubscription (Transact-SQL)
sp_helpmergepullsubscription (Transact-SQL)