Transact-SQL Reference

sp_addmergealternatepublisher

Adds the ability for a Subscriber to use an alternate synchronization partner. The publication properties must specify that Subscribers can synchronize with other Publishers. This stored procedure is executed at the Subscriber on the subscription database.

Syntax

sp_addmergealternatepublisher [ @publisher = ] 'publisher'
    ,
[ @publisher_db = ] 'publisher_db'
    ,
[ @publication = ] 'publication'
    ,
[ @alternate_publisher = ] 'alternate_synchronization_partner'
    ,
[ @alternate_publisher_db = ] 'alternate_publisher_db'
    ,
[ @alternate_publication = ] 'alternate_synchronization_partner'
    ,
[ @alternate_distributor = ] 'alternate_distributor'
    
[ , [ @friendly_name = ] 'friendly_name' ]
    
[ , [ @reserved= ] 'reserved' ]

Arguments

[@publisher = ] 'publisher'

Is the name of the Publisher. publisher is sysname, with no default.

[@publisher_db = ] 'publisher_db'

Is the name of the publication database. publisher_db is sysname, with no default.

[@publication = ] 'publication'

Is the name of the publication. publication is sysname, with no default.

[@alternate_publisher = ] 'alternate_synchronization_partner'

Is the name of the alternate Publisher. alternate_synchronization_partner is sysname, with no default.

[@alternate_publisher_db = ] 'alternate_publisher_db'

Is the name of the publication database on the alternate publisher. alternate_publisher_db is sysname, with no default.

[@alternate_publication = ] 'alternate_synchronization_partner'

Is the name of the publication on the alternate synchronization partner. alternate_synchronization_partner is sysname, with no default.

[@alternate_distributor = ] 'alternate_distributor'

Is the name of the Distributor for the alternate synchronization partner. alternate_distributor is sysname, with no default.

[@friendly_name = ] 'friendly_name'

Is a display name by which the association of Publisher, publication, and Distributor that makes up an alternate synchronization partner can be identified. friendly_name is nvarchar(255), with a default of NULL.

[@reserved = ] 'reserved'

For internal use only.

Return Code Values

0 (success) or 1 (failure)

Remarks

sp_addmergealternatepublisher is used in merge replication.

Permissions

Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_addmergealternatepublisher.

See Also

Alternate Synchronization Partners