sp_restoredbreplication (Transact-SQL)

  • Article

Applies to: SQL Server Azure SQL Managed Instance

Removes replication settings if restoring a database to the non-originating server, database, or system that is otherwise not capable of running replication processes. When restoring a replicated database to a server or database other than the one where the backup was taken, replication settings can't be preserved. On the restore, the server calls sp_restoredbreplication directly to automatically remove replication metadata from the restored database.

Transact-SQL syntax conventions

Syntax

sp_restoredbreplication
    [ @srv_orig = ] N'srv_orig'
    , [ @db_orig = ] N'db_orig'
    [ , [ @keep_replication = ] keep_replication ]
    [ , [ @perform_upgrade = ] perform_upgrade ]
    [ , [ @recoveryforklsn = ] recoveryforklsn ]
[ ; ]

Arguments

[ @srv_orig = ] N'srv_orig'

The name of the server where the backup was created. @srv_orig is sysname, with no default.

[ @db_orig = ] N'db_orig'

The name of the database that was backed up. @db_orig is sysname, with no default.

[ @keep_replication = ] keep_replication

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

[ @perform_upgrade = ] perform_upgrade

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

[ @recoveryforklsn = ] recoveryforklsn

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

Return code values

0 (success) or 1 (failure).

Remarks

sp_restoredbreplication is used in all types of replication.

Permissions

Only members of the sysadmin or dbcreator fixed server role, or the dbo database schema, can execute sp_restoredbreplication.

Related content