通过

  • 项目

sp_MSchange_distribution_agent_properties (Transact-SQL)

更改在 MicrosoftSQL Server 2005 或更高版本的分发服务器上运行的分发代理作业的属性。 当发布服务器在 SQL Server 2000 实例上运行时，可使用此存储过程更改属性。 此存储过程在分发服务器上对分发数据库执行。

主题链接图标Transact-SQL 语法约定

语法

sp_MSchange_distribution_agent_properties [ @publisher = ] 'publisher'
        , [ @publisher_db = ] 'publisher_db'
        , [ @publication = ] 'publication' 
        , [ @subscriber = ] 'subscriber' 
        , [ @subscriber_db = ] 'subscriber_db' 
        , [ @property = ] 'property' 
        , [ @value = ] 'value' ]

参数

  • [ @publisher= ] 'publisher'
    发布服务器的名称。publisher 的数据类型为 sysname，无默认值。

  • [ @publisher_db= ] 'publisher_db'
    发布数据库的名称。publisher_db 的数据类型为 sysname，无默认值。

  • [ @publication = ] 'publication'
    发布的名称。publication 的数据类型为 sysname，无默认值。

  • [ @subscriber= ] 'subscriber'
    订阅服务器的名称。subscriber 的数据类型为 sysname，无默认值。

  • [ @subscriber_db= ] 'subscriber_db'
    订阅数据库的名称。subscriber_db 的数据类型为 sysname，无默认值。

  • [ @property=] 'property'
    要更改的发布属性。property 的数据类型为 sysname，无默认值。

  • [ @value=] 'value'
    新属性值。value 的数据类型为 nvarchar(524)，默认值为 NULL。

    下表说明了可以更改的分发服务器代理作业的属性，以及对这些属性值的限制。

    属性

    值

    说明

    distrib_job_login

    用来运行代理的 Microsoft Windows 帐户的登录名。

    distrib_job_password

    用来运行代理作业的 Windows 帐户的密码。

    subscriber_catalog

    在与 OLE DB 访问接口建立连接时要使用的目录。 此属性仅对非 SQL Server 订阅服务器有效。

    subscriber_datasource

    OLE DB 访问接口识别的数据源的名称。 此属性仅对非 SQL Server 订阅服务器有效。

    subscriber_location

    OLE DB 访问接口识别的数据库的位置。 此属性仅对非 SQL Server 订阅服务器有效。

    subscriber_login

    在连接到订阅服务器以同步订阅时使用的登录名。

    subscriber_password

    订阅服务器密码。

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

    subscriber_provider

    唯一编程标识符 (PROGID)，用于注册非 SQL Server 数据源的 OLE DB 访问接口。 此属性仅对非 SQL Server 订阅服务器有效。

    subscriber_providerstring

    OLE DB 访问接口特定的连接字符串，用于标识数据源。 此属性仅对非 SQL Server 订阅服务器有效。

    subscriber_security_mode

    1

    Windows 身份验证。

    请尽可能使用 Windows 身份验证。

    0

    SQL Server 身份验证。

    subscriber_type

    0

    SQL Server 订阅服务器

    1

    ODBC 数据源服务器

    3

    OLE DB 访问接口

    subscriptionstreams

    指示每个分发代理允许的连接数，用于将更改批并行应用于订阅服务器。 非 SQL Server 订阅服务器、Oracle 发布服务器或对等订阅不支持此功能。
    注意注意

    更改代理登录名或密码之后，必须先停止并重新启动代理，然后更改才能生效。

返回代码值

0（成功）或 1（失败）

注释

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

当发布服务器在 SQL Server 2005 或更高版本的实例上运行时，应使用 sp_changesubscription 来更改对在分发服务器上运行的推送订阅进行同步的合并代理作业的属性。

权限

只有分发服务器上 sysadmin 固定服务器角色的成员才能执行 sp_MSchange_distribution_agent_properties。