sp_adddistpublisher (Transact-SQL)
配置发布服务器以使用指定的分发数据库。 此存储过程在分发服务器的任何数据库中执行。 请注意，在使用此存储过程之前，必须已经运行存储过程 sp_adddistributor (Transact-SQL) 和 sp_adddistributiondb (Transact-SQL)。
.gif "主题链接图标")
语法
sp_adddistpublisher [ @publisher= ] 'publisher'
, [ @distribution_db= ] 'distribution_db'
[ , [ @security_mode= ] security_mode ]
[ , [ @login= ] 'login' ]
[ , [ @password= ] 'password' ]
[ , [ @working_directory= ] 'working_directory' ]
[ , [ @trusted= ] 'trusted' ]
[ , [ @encrypted_password= ] encrypted_password ]
[ , [ @thirdparty_flag = ] thirdparty_flag ]
[ , [ @publisher_type = ] 'publisher_type' ]
参数
[ @publisher = ] 'publisher'
发布服务器的名称。publisher 的数据类型为 sysname，无默认值。[ @distribution_db=] 'distribution_db'
分发数据库的名称。distributor_db 的数据类型为 sysname，无默认值。 复制代理使用该参数连接到发布服务器。[ @security_mode=] security_mode
所实现的安全模式。 该参数仅供复制代理用于连接到排队更新订阅的发布服务器或非 SQL Server 发布服务器。security_mode 的数据类型为 int，可以是下列值之一。值
说明
0
分发服务器中的复制代理使用 SQL Server 身份验证连接到发布服务器。
1（默认值）
分发服务器中的复制代理使用 Windows 身份验证连接到发布服务器。
[ @login=] 'login'
登录。 如果 security_mode 为 0，则必须提供该参数。login 的数据类型为 sysname，默认值为 NULL。 复制代理使用该参数连接到发布服务器。[ @password=] 'password']
密码。password 的数据类型为 sysname，默认值为 NULL。 复制代理使用该参数连接到发布服务器。.gif "安全说明")
安全说明不要使用空密码。 请使用强密码。
[ @working_directory=] 'working_directory'
用来存储发布的数据和架构文件的工作目录的名称。working_directory 的数据类型为 nvarchar(255)，默认值为该 SQL Server 实例的 ReplData 文件夹，例如 'C:\Program Files\Microsoft SQL Server\MSSQL\MSSQ.1\ReplData'。 该名称应按 UNC 格式指定。[ @trusted=] 'trusted'
该参数已不推荐使用，提供它只是为了向后兼容。trusted 的数据类型为 nvarchar(5)，如果将它设置为除 false 以外的任何值将导致错误。[ @encrypted_password=] encrypted_password
不再支持设置 encrypted_password。 尝试将该 bit 参数设置为 1 会导致错误。[ @thirdparty_flag =] thirdparty_flag
发布服务器是否是 SQL Server。thirdparty_flag 的数据类型为 bit，可以是下列值之一。值
说明
0（默认值）
SQL Server 数据库。
1
非 SQL Server 数据库。
[ @publisher_type= ] 'publisher_type'
指定当发布服务器不是 SQL Server 时的发布服务器类型。publisher_type 的数据类型为 sysname，可以是下列值之一。值
说明
MSSQLSERVER
（默认值）
指定 SQL Server 发布服务器。
ORACLE
指定标准的 Oracle 发布服务器。
ORACLE GATEWAY
指定 Oracle 网关发布服务器。
有关 Oracle 发布服务器与 Oracle 网关发布服务器之间区别的详细信息，请参阅配置 Oracle 发布服务器。
返回代码值
0（成功）或 1（失败）
注释
sp_adddistpublisher 用于快照复制、事务复制和合并复制。
示例
-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables
-- on the command line and in SQL Server Management Studio, see the
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".
-- Install the Distributor and the distribution database.
DECLARE @distributor AS sysname;
DECLARE @distributionDB AS sysname;
DECLARE @publisher AS sysname;
DECLARE @directory AS nvarchar(500);
DECLARE @publicationDB AS sysname;
-- Specify the Distributor name.
SET @distributor = $(DistPubServer);
-- Specify the distribution database.
SET @distributionDB = N'distribution';
-- Specify the Publisher name.
SET @publisher = $(DistPubServer);
-- Specify the replication working directory.
SET @directory = N'\\' + $(DistPubServer) + '\repldata';
-- Specify the publication database.
SET @publicationDB = N'AdventureWorks2008R2';
-- Install the server MYDISTPUB as a Distributor using the defaults,
-- including autogenerating the distributor password.
USE master
EXEC sp_adddistributor @distributor = @distributor;
-- Create a new distribution database using the defaults, including
-- using Windows Authentication.
USE master
EXEC sp_adddistributiondb @database = @distributionDB,
@security_mode = 1;
GO
-- Create a Publisher and enable AdventureWorks2008R2 for replication.
-- Add MYDISTPUB as a publisher with MYDISTPUB as a local distributor
-- and use Windows Authentication.
DECLARE @distributionDB AS sysname;
DECLARE @publisher AS sysname;
-- Specify the distribution database.
SET @distributionDB = N'distribution';
-- Specify the Publisher name.
SET @publisher = $(DistPubServer);
USE [distribution]
EXEC sp_adddistpublisher @publisher=@publisher,
@distribution_db=@distributionDB,
@security_mode = 1;
GO
权限
只有 sysadmin 固定服务器角色的成员才能执行 sp_adddistpublisher。