sp_vupgrade_replication (Transact-SQL)

Applies to: SQL Server Azure SQL Managed Instance

Activated by setup when upgrading a replication server. Upgrades schema and system data as needed to support replication at the current product level. Creates new replication system objects in system and user databases. This stored procedure is executed at the machine where the replication upgrade is to occur.

Transact-SQL syntax conventions

Syntax

sp_vupgrade_replication
    [ [ @login = ] N'login' ]
    [ , [ @password = ] N'password' ]
    [ , [ @ver_old = ] ver_old ]
    [ , [ @force_remove = ] force_remove ]
    [ , [ @security_mode = ] security_mode ]
    [ , [ @db_id = ] db_id ]
[ ; ]

Arguments

[ @login = ] N'login'

The system administrator login to use when creating new system objects in the Distribution database. @login is sysname, with a default of NULL. This parameter isn't required if @security_mode is set to 1, which is Windows Authentication.

Note

This parameter is ignored when you're upgrading to SQL Server 2005 (9.x) and later versions.

[ @password = ] N'password'

The system administrator password to use when creating new system objects in the Distribution database. @password is sysname, with a default of an empty string. This parameter isn't required if @security_mode is set to 1, which is Windows Authentication.

Note

This parameter is ignored when you're upgrading to SQL Server 2005 (9.x) and later versions.

[ @ver_old = ] ver_old

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

This stored procedure is deprecated and will be removed in a future release of SQL Server.

[ @force_remove = ] force_remove

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

[ @security_mode = ] security_mode

The login security mode to use when creating new system objects in the Distribution database. @security_mode is bit, with a default of 1. If 0, SQL Server Authentication is used. If 1, Windows Authentication is used.

Note

This parameter is ignored when you're upgrading to SQL Server 2005 (9.x) and later versions.

[ @db_id = ] db_id

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

Return code values

0 (success) or 1 (failure).

Remarks

sp_vupgrade_replication is used when upgrading all types of replication.

Permissions

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