将请求订阅或匿名订阅添加到快照发布或事务发布。此存储过程在订阅服务器上要创建请求订阅的数据库上执行。

语法

sp_addpullsubscription [ @publisher = ] 'publisher'

    , [ @publisher_db = ] 'publisher_db'

    , [ @publication = ] 'publication '

    [ , [ @independent_agent = ] 'independent_agent' ]

    [ , [ @subscription_type = ] 'subscription_type']

    [ , [ @description = ] 'description' ]

    [ , [ @update_mode = ] 'update_mode' ]

    [ , [ @immediate_sync = ] immediate_sync ]

参数

[@publisher = ] 'publisher'

是发布服务器名。publisher 的数据类型为 sysname，没有默认设置。

[@publisher_db = ] 'publisher_db'

是发布服务器数据库名。publisher_db 的数据类型为 sysname，没有默认设置。

[@publication =] 'publication'

是发布名。publication 的数据类型为 sysname，没有默认设置。

[@independent_agent = ] 'independent_agent'

指定是否有用于该发布的单独的分发代理程序。independent_agent 的数据类型为 nvarchar(5)，默认设置为 TRUE。如果是 true，则表示有用于该发布的独立分发代理程序。如果是 false，则表示每对发布服务器数据库/订阅服务器数据库都有一个分发代理程序。independent_agent 是该发布的属性，而且它在此处的值必须与在发布服务器上的值相同。

[@subscription_type = ] 'subscription_type'

是该发布的订阅类型。subscription_type 的数据类型为 nvarchar(9)，可以是下列值之一。

[@description = ] 'description'

是对发布的描述。publication 的数据类型为 nvarchar(100)，默认设置为 NULL。

[@update_mode = ] 'update_mode'

是更新的类型。update_mode 的数据类型为 nvarchar(15)，可以是下列值之一。

[@immediate_sync = ] immediate_sync

表示每次快照代理程序运行时是否创建或重新创建同步文件。immediate_sync 的数据类型为 bit，默认设置为 1，而且该设置必须与 sp_addpublication 中 immediate_sync 的值相同。immediate_sync 是该发布的属性，而且它在此处的值必须与在发布服务器上的值相同。

返回代码值

0（成功）或 1（失败）

注释

sp_addpullsubscription 用于快照复制和事务复制。

如果在订阅服务器上没有 MSreplication_subscriptions 表，则 sp_addpullsubscription 创建它。它还在 MSreplication_subscriptions 表中添加行。对于请求订阅，应首先在发布服务器上调用 sp_addsubscription。

权限

只有 sysadmin 固定服务器角色成员或 db_owner 固定数据库角色成员才能执行 sp_addpullsubscription。