sp_changedistpublisher (Transact-SQL)

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

语法

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

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

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

给定属性的值。 @value为 nvarchar（255），可以是下表中的值之一。

注意

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

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

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

¹ 对于非 SQL Server 发布者，无法更改此项。

0（成功）或 1（失败）。

sp_changedistpublisher 用于所有类型的复制。

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

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