Edit

Share via

sp_dropsubscriber (Transact-SQL)

  • Article
  • 11/29/2023

Applies to: SQL Server Azure SQL Managed Instance

Removes the Subscriber designation from a registered server. This stored procedure is executed at the Publisher on the publication database.

Important

This stored procedure has been deprecated. You're no longer required to explicitly register a Subscriber at the Publisher.

Transact-SQL syntax conventions

Syntax

sp_dropsubscriber
    [ @subscriber = ] N'subscriber'
    [ , [ @reserved = ] N'reserved' ]
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Arguments

[ @subscriber = ] N'subscriber'

The name of the Subscriber to be dropped. @subscriber is sysname, with no default.

[ @reserved = ] N'reserved'

Identified for informational purposes only. Not supported. Future compatibility is not guaranteed.

[ @ignore_distributor = ] ignore_distributor

Identified for informational purposes only. Not supported. Future compatibility is not guaranteed.

[ @publisher = ] N'publisher'

Identified for informational purposes only. Not supported. Future compatibility is not guaranteed.

Return code values

0 (success) or 1 (failure).

Remarks

sp_dropsubscriber is used in all types of replication.

This stored procedure removes the server sub option, and removes the remote login mapping of system administrator to repl_subscriber.

Permissions

Only members of the sysadmin fixed server role can execute sp_dropsubscriber.

Related content