将现有的订阅数据库附加到任何订阅服务器。此存储过程在新订阅服务器的主数据库上执行。

语法

sp_attachsubscription [ @dbname = ] 'dbname'

    , [ @filename = ] 'filename'

    [ , [ @subscriber_security_mode = ] 'subscriber_security_mode' ]

    [ , [ @subscriber_login = ] 'subscriber_login' ]

    [ , [ @subscriber_password = ] 'subscriber_password' ]

参数

[@dbname =] 'dbname'

是用名称指定现有数据库的字符串。dbname 的数据类型为 sysname，没有默认设置。

[@filename = ] 'filename'

是主 MDF（master 数据文件）的名称和物理位置。filename 的数据类型为 nvarchar(260)，没有默认设置。

[@subscriber_security_mode =] 'subscriber_security_mode'

是在同步时用于连接到订阅服务器的订阅服务器的安全模式。subscriber_security_mode 的数据类型为 int，默认设置为 NULL。如果是 0，则表示安全模式为 SQL Server 身份验证。如果是 1，则表示安全模式为 Windows 身份验证。

[@subscriber_login =] 'subscriber_login'

是在同步时用于连接到订阅服务器的订阅服务器的登录名。subscriber_login 的数据类型为 sysname，默认设置为 NULL。如果 subscriber_security_mode 是 0，则必须指定此参数。

[@subscriber_password =] 'subscriber_password'

是订阅服务器的密码。subscriber_password 的数据类型为 sysname，默认设置为 NULL。如果 SubscriberSecurityMode 是 0，则必须指定此参数。如果使用订阅服务器密码，则将自动加密该密码。

返回代码值

0（成功）或 1（失败）

注释

sp_attachsubscription 用于快照复制、事务复制和合并复制。

如果发布的发布保持期已满，则不能将订阅附加到发布中。如果指定一个保持期已满的订阅，则当附加该订阅或先对其进行同步处理时将发生错误。将忽略发布保持期为 0（永远不过期）的发布。

权限

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