sp_addsubscriber (Transact-SQL)

  • 项目

适用于：SQL ServerAzure SQL 数据库

向发布服务器添加新的订阅服务器，使其能够接收发布。 对于快照和事务发布，此存储过程在发布服务器的发布数据库中执行；对于使用远程分发服务器的合并发布，此存储过程在分发服务器执行。

重要

已不推荐使用此存储过程。 不再需要在发布服务器上显式注册订阅服务器。

Transact-SQL 语法约定

语法

sp_addsubscriber
    [ @subscriber = ] N'subscriber'
    [ , [ @type = ] type ]
    [ , [ @login = ] N'login' ]
    [ , [ @password = ] N'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 = ] N'description' ]
    [ , [ @security_mode = ] security_mode ]
    [ , [ @encrypted_password = ] encrypted_password ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

参数

[ @subscriber = ] N'subscriber'

要作为有效订阅服务器添加到此服务器上的发布的服务器的名称。 @subscriber 为 sysname，无默认值。

[ @type = ] type

订阅服务器的类型。 @type 是 tinyint，可以是这些值之一。

值 说明
0（默认值） SQL Server 订阅服务器
1 ODBC 数据源服务器
2 Microsoft Jet 数据库
3 OLE DB 访问接口

[ @login = ] N'login'

SQL Server 身份验证的登录 ID。 @login为 sysname，默认值为 NULL.

注意

此参数已弃用，并维护脚本的向后兼容性。 执行sp_addsubscription时，该属性现在按订阅指定。 指定值后，此订阅服务器上创建订阅时会将其用作默认值，并返回警告消息。

[ @password = ] N'password'

SQL Server 身份验证的密码。 @password为 nvarchar（524），默认值为 NULL.

不要使用空白密码。 请使用强密码。

注意

此参数已弃用，并维护脚本的向后兼容性。 执行sp_addsubscription时，该属性现在按订阅指定。 指定值后，此订阅服务器上创建订阅时会将其用作默认值，并返回警告消息。

[ @commit_batch_size = ] commit_batch_size

此参数已弃用，并维护脚本的向后兼容性。

指定值后，此订阅服务器上创建订阅时会将其用作默认值，并返回警告消息。

[ @status_batch_size = ] status_batch_size

此参数已弃用，并维护脚本的向后兼容性。

指定值后，此订阅服务器上创建订阅时会将其用作默认值，并返回警告消息。

[ @flush_frequency = ] flush_frequency

此参数已弃用，并维护脚本的向后兼容性。

指定值后，此订阅服务器上创建订阅时会将其用作默认值，并返回警告消息。

[ @frequency_type = ] frequency_type

指定计划副本 (replica)代理的频率。 @frequency_type为 int，可以是这些值之一。

值 说明
1 一次
2 按需
4 每日
8 每周
16 每月
32 与“每月”选项相关
64（默认值） 自动启动
128 定期

注意

此参数已弃用，并维护脚本的向后兼容性。 执行sp_addsubscription时，该属性现在按订阅指定。 指定值后，此订阅服务器上创建订阅时会将其用作默认值，并返回警告消息。

[ @frequency_interval = ] frequency_interval

应用于由 @frequency_type设置的频率的值。 @frequency_interval为 int，默认值为 1.

注意

此参数已弃用，并维护脚本的向后兼容性。 执行sp_addsubscription时，该属性现在按订阅指定。 指定值后，此订阅服务器上创建订阅时会将其用作默认值，并返回警告消息。

[ @frequency_relative_interval = ] frequency_relative_interval

副本 (replica)代理的日期。 当@frequency_type设置为32（每月相对）时，将使用此参数。 @frequency_relative_interval为 int，可以是其中一个值。

值 说明
1（默认值） 第一个
2 第二个
4 第三个
8 第四
16 Last

注意

此参数已弃用，并维护脚本的向后兼容性。 执行sp_addsubscription时，该属性现在按订阅指定。 指定值后，此订阅服务器上创建订阅时会将其用作默认值，并返回警告消息。

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

@frequency_type使用的重复因子。 @frequency_recurrence_factor为 int，默认值为 0.

注意

此参数已弃用，并维护脚本的向后兼容性。 执行sp_addsubscription时，该属性现在按订阅指定。 指定值后，此订阅服务器上创建订阅时会将其用作默认值，并返回警告消息。

[ @frequency_subday = ] frequency_subday

在定义的时间段内重新安排的频率。 @frequency_subday 为 int，可以是以下值之一。

值 说明
1 一次
2 Second
4（默认值） Minute
8 小时

注意

此参数已弃用，并维护脚本的向后兼容性。 执行sp_addsubscription时，该属性现在按订阅指定。 指定值后，此订阅服务器上创建订阅时会将其用作默认值，并返回警告消息。

[ @frequency_subday_interval = ] frequency_subday_interval

frequency_subday的间隔。 @frequency_subday_interval为 int，默认值为 5.

注意

此参数已弃用，并维护脚本的向后兼容性。 执行sp_addsubscription时，该属性现在按订阅指定。 指定值后，此订阅服务器上创建订阅时会将其用作默认值，并返回警告消息。

[ @active_start_time_of_day = ] active_start_time_of_day

第一次计划副本 (replica)代理的时间，格式为 HHmmss。 @active_start_time_of_day为 int，默认值为 0.

注意

此参数已弃用，并维护脚本的向后兼容性。 执行sp_addsubscription时，该属性现在按订阅指定。 指定值后，此订阅服务器上创建订阅时会将其用作默认值，并返回警告消息。

[ @active_end_time_of_day = ] active_end_time_of_day

副本 (replica)代理停止计划的时间，格式为 HHmmss。 @active_end_time_of_day为 int，默认值235959为 11：59：59：59（以 24 小时制为单位）。

注意

此参数已弃用，并维护脚本的向后兼容性。 执行sp_addsubscription时，该属性现在按订阅指定。 指定值后，此订阅服务器上创建订阅时会将其用作默认值，并返回警告消息。

[ @active_start_date = ] active_start_date

首次计划副本 (replica)代理的日期，格式为 yyyyMMdd。 @active_start_date为 int，默认值为 0.

注意

此参数已弃用，并维护脚本的向后兼容性。 执行sp_addsubscription时，该属性现在按订阅指定。 指定值后，此订阅服务器上创建订阅时会将其用作默认值，并返回警告消息。

[ @active_end_date = ] active_end_date

副本 (replica)代理停止计划的日期，格式为 yyyyMMdd。 @active_end_date 为 int，默认值 99991231为 9999 年 12 月 31 日。

注意

此参数已弃用，并维护脚本的向后兼容性。 执行sp_addsubscription时，该属性现在按订阅指定。 指定值后，此订阅服务器上创建订阅时会将其用作默认值，并返回警告消息。

[ @description = ] N'description'

订阅服务器的文本说明。 @description 为 nvarchar（255），默认值为 NULL.

[ @security_mode = ] security_mode

实现的安全模式。 @security_mode为 int，默认值为 1.

  • 0 指定 SQL Server 身份验证。
  • 1指定Windows 身份验证。

注意

此参数已弃用，并维护脚本的向后兼容性。 执行sp_addsubscription时，该属性现在按订阅指定。 指定值后，此订阅服务器上创建订阅时会将其用作默认值，并返回警告消息。

[ @encrypted_password = ] encrypted_password

此参数已弃用，仅用于向后兼容性。 将 @encrypted_password 设置为任何值，但 0 会导致错误。

[ @publisher = ] N'publisher'

指定非 SQL Server 发布服务器。 @publisher为 sysname，默认值为 NULL.

从 SQL Server 发布服务器发布时，不应使用@publisher。

返回代码值

0（成功）或 1（失败）。

注解

sp_addsubscriber用于快照 副本 (replica)、事务副本 (replica)和合并副本 (replica)。

sp_addsubscriber 如果订阅服务器仅具有合并发布的匿名订阅，则不需要该订阅。

sp_addsubscriber写入分发数据库中MSsubscriber_info表。

权限

只有 sysadmin 固定服务器角色的成员才能执行sp_addsubscriber。

相关内容