sp_changedistpublisher (Transact-SQL)

适用于SQL Server Azure SQL 托管实例

更改分发发布服务器的属性。 此存储过程在分发服务器上的任何数据库中执行。

Transact-SQL 语法约定

语法

sp_changedistpublisher
    [ @publisher = ] N'publisher'
    [ , [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
[ ; ]

参数

[ @publisher = ] N'publisher'

发布服务器名称。 @publisher为 sysname,无默认值。

[ @property = ] N'property'

要更改给定发布服务器的属性。 @property为 sysname,可以是@value列出的表中的属性之一。

[ @value = ] N'value'

给定属性的值。 @value为 nvarchar(255),可以是下表中的值之一。

注意

Azure SQL 数据库上的发布服务器和分发服务器数据库需要SQL 托管实例。 有关详细信息,请参阅复制和Azure SQL 数据库

下表说明了发布服务器的属性和这些属性的值。

properties 说明
active true 激活发布服务器。
false 停用发布服务器
distribution_db 分发数据库的名称。
login 登录名。
password 提供的登录名的强密码。
security_mode 1 1 连接发布服务器时,使用 Windows 身份验证。
0 连接到发布服务器时使用 SQL Server 身份验证。
working_directory 用于存储发布的数据和架构文件的工作目录。
NULL(默认值) 打印所有可用的 属性 选项。
storage_connection_string 访问密钥 数据库Azure SQL 托管实例时工作目录的访问密钥。

1 对于非 SQL Server 发布者,无法更改此项。

返回代码值

0(成功)或 1(失败)。

注解

sp_changedistpublisher 用于所有类型的复制。

如果要更改 working_directory 属性和 storage_connection_string 属性必须更新,请通过更新 working_directory 属性(后跟更新 storage_connection_string 属性)单独执行存储过程,反之亦然。

权限

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