适用对象:yesSQL Server(从 2008 版开始)noAzure SQL 数据库noAzure SQL 数据仓库no并行数据仓库
向发布服务器添加新的订阅服务器,使其能够接收发布。 对于快照和事务发布,此存储过程在发布服务器的发布数据库中执行;对于使用远程分发服务器的合并发布,此存储过程在分发服务器执行。
Important:
已不推荐使用此存储过程。 不再需要显式注册发布服务器上的订阅服务器。
主题链接图标 TRANSACT-SQL 语法约定
语法
sp_addsubscriber [ @subscriber = ] 'subscriber'
[ , [ @type = ] type ]
[ , [ @login = ] 'login' ]
[ , [ @password = ] 'password' ]
[ , [ @commit_batch_size = ] commit_batch_size ]
[ , [ @status_batch_size = ] status_batch_size ]
[ , [ @flush_frequency = ] flush_frequency ]
[ , [ @frequency_type = ] frequency_type ]
[ , [ @frequency_interval = ] frequency_interval ]
[ , [ @frequency_relative_interval = ] frequency_relative_interval ]
[ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]
[ , [ @frequency_subday = ] frequency_subday ]
[ , [ @frequency_subday_interval = ] frequency_subday_interval ]
[ , [ @active_start_time_of_day = ] active_start_time_of_day ]
[ , [ @active_end_time_of_day = ] active_end_time_of_day ]
[ , [ @active_start_date = ] active_start_date ]
[ , [ @active_end_date = ] active_end_date ]
[ , [ @description = ] 'description' ]
[ , [ @security_mode = ] security_mode ]
[ , [ @encrypted_password = ] encrypted_password ]
[ , [ @publisher = ] 'publisher' ]
参数
[ @subscriber=] '订阅服务器
将作为有效订阅服务器添加到该服务器的发布中的订阅服务器的名称。 订阅服务器上是sysname,无默认值。
[ @type=]类型
订阅服务器的类型。 类型是tinyint,可以是下列值之一。
| ReplTest1 | Description |
|---|---|
| 0 (默认值) | Microsoft SQL Server 订阅服务器 |
| 1 | ODBC 数据源服务器 |
| 2 | Microsoft Jet 数据库 |
| 3 | OLE DB 访问接口 |
[ @login=] '登录
SQL Server 身份验证的登录 ID。 login 的数据类型为 sysname,默认值为 NULL。
Note:
不推荐使用此参数,保留它是为了让脚本能够向后兼容。 执行时现在基于每个订阅指定的属性sp_addsubscription。 在指定值后,该值将用作在此订阅服务器上创建订阅时的默认值,同时返回一条警告消息。
[ @password=] '密码
SQL Server 身份验证的密码。 密码是nvarchar(524),默认值为 NULL。
Important:
不要使用空密码。 请使用强密码。
Note:
不推荐使用此参数,保留它是为了让脚本能够向后兼容。 执行时现在基于每个订阅指定的属性sp_addsubscription。 在指定值后,该值将用作在此订阅服务器上创建订阅时的默认值,同时返回一条警告消息。
[ @commit_batch_size=] commit_batch_size
不推荐使用此参数,保留它是为了让脚本能够向后兼容。
Note:
在指定值后,该值将用作在此订阅服务器上创建订阅时的默认值,同时返回一条警告消息。
[ @status_batch_size=] status_batch_size
不推荐使用此参数,保留它是为了让脚本能够向后兼容。
Note:
在指定值后,该值将用作在此订阅服务器上创建订阅时的默认值,同时返回一条警告消息。
[ @flush_frequency=] flush_frequency
不推荐使用此参数,保留它是为了让脚本能够向后兼容。
Note:
在指定值后,该值将用作在此订阅服务器上创建订阅时的默认值,同时返回一条警告消息。
[ @frequency_type=] frequency_type
安排复制代理的频率。 frequency_type是int,可以是下列值之一。
| ReplTest1 | Description |
|---|---|
| 1 | 一次 |
| 2 | 按需 |
| 4 | 每天 |
| 8 | 每周 |
| 16 | 每月 |
| 32 | 与“每月”选项相关 |
| 64 (默认值) | 自动启动 |
| 128 | 重复执行 |
Note:
不推荐使用此参数,保留它是为了让脚本能够向后兼容。 执行时现在基于每个订阅指定的属性sp_addsubscription。 在指定值后,该值将用作在此订阅服务器上创建订阅时的默认值,同时返回一条警告消息。
[@frequency_interval= ] frequency_interval
是应用于设置频率的值frequency_type。 frequency_interval是int,默认值为 1。
Note:
不推荐使用此参数,保留它是为了让脚本能够向后兼容。 执行时现在基于每个订阅指定的属性sp_addsubscription。 在指定值后,该值将用作在此订阅服务器上创建订阅时的默认值,同时返回一条警告消息。
[ @frequency_relative_interval=] frequency_relative_interval
复制代理的日期。 使用此参数时frequency_type设置为32 (每月相对)。 frequency_relative_interval是int,可以是下列值之一。
| ReplTest1 | Description |
|---|---|
| 1 (默认值) | 第一个 |
| 2 | 第二个 |
| 4 | 第三个 |
| 8 | 第四个 |
| 16 | 上一次 |
Note:
不推荐使用此参数,保留它是为了让脚本能够向后兼容。 执行时现在基于每个订阅指定的属性sp_addsubscription。 在指定值后,该值将用作在此订阅服务器上创建订阅时的默认值,同时返回一条警告消息。
[ @frequency_recurrence_factor=] frequency_recurrence_factor
使用的重复因子frequency_type。 frequency_recurrence_factor是int,默认值为0。
Note:
不推荐使用此参数,保留它是为了让脚本能够向后兼容。 执行时现在基于每个订阅指定的属性sp_addsubscription。 在指定值后,该值将用作在此订阅服务器上创建订阅时的默认值,同时返回一条警告消息。
[ @frequency_subday=] frequency_subday
在指定期内重新安排计划的频率。 frequency_subday是int,可以是下列值之一。
| ReplTest1 | Description |
|---|---|
| 1 | 一次 |
| 2 | 第二个 |
| 4 (默认值) | Minute |
| 8 | Hour |
Note:
不推荐使用此参数,保留它是为了让脚本能够向后兼容。 执行时现在基于每个订阅指定的属性sp_addsubscription。 在指定值后,该值将用作在此订阅服务器上创建订阅时的默认值,同时返回一条警告消息。
[ @frequency_subday_interval=] frequency_subday_interval
间隔。 frequency_subday。 frequency_subday_interval是int,默认值为5。
Note:
不推荐使用此参数,保留它是为了让脚本能够向后兼容。 执行时现在基于每个订阅指定的属性sp_addsubscription。 在指定值后,该值将用作在此订阅服务器上创建订阅时的默认值,同时返回一条警告消息。
[ @active_start_time_of_day=] active_start_time_of_day
第一次安排复制代理的时间,格式为 HHMMSS。 active_start_time_of_day是int,默认值为0。
Note:
不推荐使用此参数,保留它是为了让脚本能够向后兼容。 执行时现在基于每个订阅指定的属性sp_addsubscription。 在指定值后,该值将用作在此订阅服务器上创建订阅时的默认值,同时返回一条警告消息。
[ @active_end_time_of_day=] active_end_time_of_day
停止安排复制代理的时间,格式为 HHMMSS。 active_end_time_of_day是int,默认值为 235959,表示 11:59:59 PM 24 小时制。
Note:
不推荐使用此参数,保留它是为了让脚本能够向后兼容。 执行时现在基于每个订阅指定的属性sp_addsubscription。 在指定值后,该值将用作在此订阅服务器上创建订阅时的默认值,同时返回一条警告消息。
[ @active_start_date=] active_start_date
第一次安排复制代理的日期,格式为 YYYYMMDD。 active_start_date是int,默认值为 0。
Note:
不推荐使用此参数,保留它是为了让脚本能够向后兼容。 执行时现在基于每个订阅指定的属性sp_addsubscription。 在指定值后,该值将用作在此订阅服务器上创建订阅时的默认值,同时返回一条警告消息。
[ @active_end_date=] active_end_date
停止安排复制代理的日期,格式为 YYYYMMDD。 active_end_date是int,默认值为 99991231,表示年 12 月 31 日到 9999。
Note:
不推荐使用此参数,保留它是为了让脚本能够向后兼容。 执行时现在基于每个订阅指定的属性sp_addsubscription。 在指定值后,该值将用作在此订阅服务器上创建订阅时的默认值,同时返回一条警告消息。
[ @description=] '说明
订阅服务器的文本说明。 描述是nvarchar(255),默认值为 NULL。
[ @security_mode=] security_mode
所实现的安全模式。 security_mode是int,默认值为 1。 0指定SQL Server身份验证。 1指定 Windows 身份验证。
Note:
不推荐使用此参数,保留它是为了让脚本能够向后兼容。 执行时现在基于每个订阅指定的属性sp_addsubscription。 在指定值后,该值将用作在此订阅服务器上创建订阅时的默认值,同时返回一条警告消息。
[ @encrypted_password=] encrypted_password
此参数已弃用,仅设置用于向后兼容性encrypted_password的任何值,但0将导致错误。
[ @publisher=] '发布服务器
指定非 SQL Server 发布服务器。 发布服务器是sysname,默认值为 NULL。
Note:
发布服务器从发布时不应使用SQL Server发布服务器。
返回代码值
0 (成功) 或1 (失败)
备注
sp_addsubscriber快照复制、 事务复制和合并复制中使用。
sp_addsubscriber时才会匿名订阅合并发布订阅服务器上不需要。
sp_addsubscriber写入MSsubscriber_info表中分发数据库。
Permissions
只有的成员sysadmin固定的服务器角色可以执行sp_addsubscriber。
请参阅
Create a Push Subscription
Create a Pull Subscription
sp_changesubscriber (TRANSACT-SQL)
sp_dropsubscriber (TRANSACT-SQL)
sp_helpsubscriberinfo (Transact-SQL)
历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 stevestein)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
