sp_MSchange_distribution_agent_properties (Transact-SQL)
适用于:SQL Server
更改在 Microsoft SQL Server 2005 (9.x) 或更高版本分发服务器上运行的分发代理作业的属性。 当发布服务器在 SQL Server 2000 实例(8.x)上运行时,此存储过程用于更改属性。 此存储过程在分发服务器上对分发数据库执行。
语法
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用于快照复制和事务复制。
当发布服务器在 SQL Server 2005(9.x) 或更高版本的实例上运行时,应使用sp_changesubscription更改同步分发服务器上运行的推送订阅的合并代理作业的属性。
权限
只有分发服务器上的 sysadmin 固定服务器角色的成员才能执行sp_MSchange_distribution_agent_properties。
另请参阅
sp_addpushsubscription_agent (Transact-SQL)
sp_addsubscription (Transact-SQL)
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈