sp_changemergesubscription
Changes a merge push or pull subscription. This stored procedure is executed at the Publisher on the publication database.
Syntax
sp_changemergesubscription [ [ @publication = ] 'publication' ]
[ , [ @subscriber = ] 'subscriber'
[ , [ @subscriber_db = ] 'subscriber_db' ]
[ , [ @property = ] 'property' ]
[ , [ @value = ] 'value' ]
Arguments
[@publication =] 'publication'
Is the name of the publication to change. publication is sysname, with a default of NULL. The publication must already exist and must conform to the rules for identifiers.
[@subscriber =] 'subscriber'
Is the name of the Subscriber. subscriber is sysname, with a default of NULL.
[@subscriber_db =] 'subscriber_db'
Is the name of the subscription database. subscriber_db is sysname, with a default of NULL.
[@property =] 'property'
Is the property to change for the given publication. property is sysname, and can be one of the values in the table.
[@value =] 'value'
Is the new value for the specified property. value is nvarchar(255), and can be one of the values in the table.
| Property | Value | Description |
|---|---|---|
| sync_type | automatic or none | Is the subscription synchronization type. sync_type is nvarchar(15), with a default of automatic. Can be automatic or none. If automatic, the schema and initial data for published tables are transferred to the Subscriber first. If none, it is assumed the Subscriber already has the schema and initial data for published tables. System tables and data are always transferred. |
| priority | Is the subscription priority. The priority is used by the default resolver to pick a winner when conflicts are detected. | |
| description | Description of this merge subscription. | |
| NULL (default) | NULL (default) |
Return Code Values
0 (success) or 1 (failure)
Remarks
sp_changemergesubscription is used in merge replication.
Permissions
Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_changemergesubscription.