sp_MSchange_distribution_agent_properties (Transact-SQL)
更改在 Microsoft SQL Server 2005 分发服务器上运行的分发代理作业的属性。当发布服务器在 SQL Server 2000 实例上运行时,可使用此存储过程更改 SQL Server 2005 属性。此存储过程在分发服务器上对分发数据库执行。
语法
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。
请参阅
参考
sp_addpushsubscription_agent (Transact-SQL)
sp_addsubscription (Transact-SQL)