title | description | author | ms.author | ms.reviewer | ms.date | ms.service | ms.subservice | ms.topic | f1_keywords | helpviewer_keywords | dev_langs | ||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
sp_addmergepullsubscription (Transact-SQL) |
Adds a pull subscription to a merge publication. |
markingmyname |
maghan |
randolphwest |
11/23/2023 |
sql |
replication |
reference |
|
|
|
[!INCLUDE SQL Server SQL MI]
Adds a pull subscription to a merge publication. This stored procedure is executed at the Subscriber on the subscription database.
:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions
sp_addmergepullsubscription
[ @publication = ] N'publication'
[ , [ @publisher = ] N'publisher' ]
[ , [ @publisher_db = ] N'publisher_db' ]
[ , [ @subscriber_type = ] N'subscriber_type' ]
[ , [ @subscription_priority = ] subscription_priority ]
[ , [ @sync_type = ] N'sync_type' ]
[ , [ @description = ] N'description' ]
[ ; ]
The name of the publication. @publication is sysname, with no default.
The name of the Publisher. @publisher is sysname, with a default of the local server name. The Publisher must be a valid server.
The name of the Publisher database. @publisher_db is sysname, with a default of NULL
.
The type of Subscriber. @subscriber_type is nvarchar(15), with a default of local
, and can be one of global
, local
, or anonymous
. In [!INCLUDE ssVersion2005] and later versions, local subscriptions are referred to as client subscriptions, and global subscriptions are referred to as server subscriptions.
The subscription priority. @subscription_priority is real, with a default of NULL
. For local and anonymous subscriptions, the priority is 0.0
. The priority is used by the default resolver to pick a winner when conflicts are detected. For global subscribers, the subscription priority must be less than 100
, which is the priority of the publisher.
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
, the Subscriber is assumed to already have the schema and initial data for published tables. System tables and data are always transferred.
We recommend specifying a value of automatic
.
A brief description of this pull subscription. @description is nvarchar(255), with a default of NULL
. This value is displayed by the Replication Monitor in the Friendly Name
column, which can be used to sort the subscriptions for a monitored publication.
0
(success) or 1
(failure).
sp_addmergepullsubscription
is used for merge replication.
If using [!INCLUDE ssNoVersion] Agent to synchronize the subscription, the sp_addmergepullsubscription_agent stored procedure must be run at the Subscriber to create an agent and job to synchronize with the Publication.
:::code language="sql" source="../replication/codesnippet/tsql/sp-addmergepullsubscript_0_1.sql":::
:::code language="sql" source="../replication/codesnippet/tsql/sp-addmergepullsubscript_0_2.sql":::
Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_addmergepullsubscription
.