sp_MSchange_distribution_agent_properties (Transact-SQL)

  • 项目

适用于：SQL Server

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

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' 订阅服务器的名称。 订阅服务器 为 sysname，无默认值。

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

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

[ @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 非 SQL Server 数据源的 OLE DB 访问接口用于注册的唯一编程标识符 (PROGID)。 此属性仅适用于非 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用于快照 副本 (replica)和事务副本 (replica)。

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

权限

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

另请参阅

sp_addpushsubscription_agent （Transact-SQL）
sp_addsubscription （Transact-SQL）