如何创建发布（复制 Transact-SQL 编程）
可以使用复制存储过程以编程的方式创建发布。 使用的存储过程将取决于要创建的发布的类型。
.gif "安全说明") 安全说明 |
|---|
请尽可能使用 Windows 身份验证。 如果可能，请在运行时提示用户输入安全凭据。 如果必须在脚本文件中存储凭据，则必须保护文件以防止未经授权的访问。 |
创建快照发布或事务发布
在发布服务器上，对发布数据库执行 sp_replicationdboption (Transact-SQL) 以启用使用快照复制或事务复制的当前数据库的发布。
对于事务发布，确定发布数据库中是否存在日志读取器代理作业。 （对于快照发布，不需要此步骤）。
如果发布数据库中存在日志读取器代理作业，则继续执行步骤 3。
如果您不确定发布的数据库中是否存在日志读取器代理作业，请在发布服务器上，对发布数据库执行 sp_helplogreader_agent (Transact-SQL)。
如果结果集为空，则创建日志读取器代理作业。 在发布服务器上，执行 sp_addlogreader_agent (Transact-SQL)。 为 @job_name 和 @password 指定代理运行时所用的 Microsoft Windows 凭据。 如果代理连接到发布服务器时使用 SQL Server 身份验证，则还必须将 @publisher_security_mode 的值指定为 0，并为 @publisher_login 和 @publisher_password 指定 MicrosoftSQL Server 登录信息。 继续执行步骤 3。
在发布服务器上，执行 sp_addpublication (Transact-SQL)。 为 @publication 指定发布名称，并且对于 @repl_freq 参数，为快照发布指定 snapshot 值或为事务发布指定 continuous 值。 指定任何其他发布选项。 这便定义了发布。
.gif "注意")
注意发布名称不能包括下列字符：
% * [ ] | : " ? \ / < >
在发布服务器上，执行 sp_addpublication_snapshot (Transact-SQL)。 为 @publication 指定步骤 3 中使用的发布名称，并为 @snapshot_job_name 和 @password 指定快照代理运行时所用的 Windows 凭据。 如果代理连接到发布服务器时使用 SQL Server 身份验证，则还必须将 @publisher_security_mode 的值指定为 0，并为 @publisher_login 和 @publisher_password 指定 SQL Server 登录信息。 此操作将为发布创建一个快照代理作业。
安全说明使用远程分发服务器配置发布服务器时，为所有参数提供的值（包括 job_login 和 job_password）都会以纯文本方式发送到该分发服务器。 在执行此存储过程之前，应该对发布服务器及其远程分发服务器之间的连接进行加密。 有关详细信息，请参阅加密与 SQL Server 的连接。
向发布添加项目。 有关详细信息，请参阅如何定义项目（复制 Transact-SQL 编程）。
启动快照代理作业以为此发布生成初始快照。 有关详细信息，请参阅如何创建初始快照（复制 Transact-SQL 编程）。
创建合并发布
在发布服务器上，执行 sp_replicationdboption (Transact-SQL) 以启用使用合并复制的当前数据库的发布。
在发布服务器上，对发布数据库执行 sp_addmergepublication (Transact-SQL)。 为 @publication 指定发布的名称，并指定任何其他发布选项。 这便定义了发布。
注意发布名称不能包括下列字符：
% * [ ] | : " ? \ / < >
在发布服务器上，执行 sp_addpublication_snapshot (Transact-SQL)。 为 @publication 指定步骤 2 中使用的发布名称，并为 @snapshot_job_name 和 @password 指定快照代理运行时所用的 Windows 凭据。 如果代理连接到发布服务器时使用 SQL Server 身份验证，则还必须将 @publisher_security_mode 的值指定为 0，并为 @publisher_login 和 @publisher_password 指定 SQL Server 登录信息。 此操作将为发布创建一个快照代理作业。
安全说明使用远程分发服务器配置发布服务器时，为所有参数提供的值（包括 job_login 和 job_password）都会以纯文本方式发送到该分发服务器。 在执行此存储过程之前，应该对发布服务器及其远程分发服务器之间的连接进行加密。 有关详细信息，请参阅加密与 SQL Server 的连接。
向发布添加项目。 有关详细信息，请参阅如何定义项目（复制 Transact-SQL 编程）。
启动快照代理作业以为此发布生成初始快照。 有关详细信息，请参阅如何创建初始快照（复制 Transact-SQL 编程）。
示例
此示例创建事务发布。 脚本变量用于传递创建快照代理和日志读取器代理作业时所需的 Windows 凭据。
-- To avoid storing the login and password in the script file, the values
-- are passed into SQLCMD as scripting variables. 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".
DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'AdventureWorks';
SET @publication = N'AdvWorksProductTran';
-- Windows account used to run the Log Reader and Snapshot Agents.
SET @login = $(Login);
-- This should be passed at runtime.
SET @password = $(Password);
-- Enable transactional or snapshot replication on the publication database.
EXEC sp_replicationdboption
@dbname=@publicationDB,
@optname=N'publish',
@value = N'true';
-- Execute sp_addlogreader_agent to create the agent job.
EXEC sp_addlogreader_agent
@job_login = @login,
@job_password = @password,
-- Explicitly specify the use of Windows Integrated Authentication (default)
-- when connecting to the Publisher.
@publisher_security_mode = 1;
-- Create a new transactional publication with the required properties.
EXEC sp_addpublication
@publication = @publication,
@status = N'active',
@allow_push = N'true',
@allow_pull = N'true',
@independent_agent = N'true';
-- Create a new snapshot job for the publication, using a default schedule.
EXEC sp_addpublication_snapshot
@publication = @publication,
@job_login = @login,
@job_password = @password,
-- Explicitly specify the use of Windows Integrated Authentication (default)
-- when connecting to the Publisher.
@publisher_security_mode = 1;
GO
此示例创建合并发布。 脚本变量用于传递创建快照代理作业时所需的 Windows 凭据。
-- To avoid storing the login and password in the script file, the value
-- is passed into SQLCMD as a scripting variable. 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".
--Declarations for adding a merge publication
DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'AdventureWorks';
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @login = $(Login);
SET @password = $(Password);
-- Enable merge replication on the publication database, using defaults.
USE master
EXEC sp_replicationdboption
@dbname=@publicationDB,
@optname=N'merge publish',
@value = N'true'
-- Create a new merge publication, explicitly setting the defaults.
USE [AdventureWorks]
EXEC sp_addmergepublication
-- These parameters are optional.
@publication = @publication,
-- optional parameters
@description = N'Merge publication of AdventureWorks.',
@publication_compatibility_level = N'90RTM';
-- Create a new snapshot job for the publication.
EXEC sp_addpublication_snapshot
@publication = @publication,
@job_login = @login,
@job_password = @password;
GO