sp_removedbreplication (Transact-SQL)
Applies to: SQL Server Azure SQL Managed Instance
This stored procedure removes all replication objects on the publication database on the Publisher instance of SQL Server, or on the subscription database on the Subscriber instance of SQL Server. Execute sp_removedbreplication
in the appropriate database, or, if the execution is in the context of another database on the same instance, specify the database where the replication objects should be removed. This procedure doesn't remove objects from other databases, such as the distribution database.
This procedure should be used only if other methods of removing replication objects have failed.
Transact-SQL syntax conventions
Syntax
sp_removedbreplication
[ [ @dbname = ] N'dbname' ]
[ , [ @type = ] N'type' ]
[ ; ]
Arguments
[ @dbname = ] N'dbname'
The name of the database. @dbname is sysname, with a default of NULL
. When NULL
, the current database is used.
[ @type = ] N'type'
The type of replication for which database objects are being removed. @type is nvarchar(5), and can be one of the following values.
Value | Description |
---|---|
tran |
Removes transactional replication publishing objects. |
merge |
Removes merge replication publishing objects. |
both (default) |
Removes all replication publishing objects. |
Return code values
0
(success) or 1
(failure).
Remarks
sp_removedbreplication
is used in all types of replication.
sp_removedbreplication
is useful when restoring a replicated database that's no replication objects needing to be restored.
sp_removedbreplication
can't be used against a database that is marked as read-only.
Permissions
Only members of the sysadmin fixed server role can execute sp_removedbreplication
.
Examples
Remove replication objects in the AdventureWorks2022
replica subscription database.
-- Remove replication objects from the subscription database on MYSUB.
DECLARE @subscriptionDB AS sysname
SET @subscriptionDB = N'AdventureWorks2022Replica'
-- Remove replication objects from a subscription database (if necessary).
USE master
EXEC sp_removedbreplication @subscriptionDB
GO