复制代理可执行文件概念

适用于：SQL ServerAzure SQL 托管实例

可以使用下列方法以编程方式控制复制代理：

• 使用 Microsoft.SqlServer.Replication 命名空间中的托管代理编程接口。

• 在命令提示符下使用提供的一组参数来调用代理可执行文件。

如果直接从命令提示符调用复制代理，则可以从批处理文件中的命令行脚本，以编程方式访问代理。 从命令提示符调用代理时，代理在调用代理或启动批处理文件的用户的 Microsoft Windows 安全帐户下运行。

可使用可执行文件运行下列复制代理的实例。

• Replication Distribution Agent

• 复制日志读取器代理

• Replication Merge Agent

• 复制队列读取器代理

• Replication Snapshot Agent

调用复制代理时，您可以使用性能配置文件，以自动向代理可执行文件传递一组已定义的参数。 有关详细信息，请参阅 Replication Agent Profiles。

示例

下面的示例说明如何从命令提示符调用复制代理。 复制代理也可以使用复制管理对象 (RMO) 来调用。 有关详细信息，请参阅 将订阅同步 (复制) 。

注意

为便于阅读，这些示例中添加了换行符。 但在批处理文件中，命令必须位于一行中。

运行快照代理

此示例批处理文件从命令提示符调用快照代理，以生成 AdvWorksSalesOrdersMerge 发布的快照。 （下面的脚本使用 SQL Server 2016 (13.x) 文件（版本 130）的路径。 你应当调整脚本以指向你的 SQL Server 版本的文件。）

REM -- Declare variables  
SET Publisher=%InstanceName%;  
SET PublicationDB=AdventureWorks2022;   
SET Publication=AdvWorksSalesOrdersMerge;   
  
REM --Start the Snapshot Agent to generate the snapshot for AdvWorksSalesOrdersMerge.  
"C:\Program Files\Microsoft SQL Server\130\COM\SNAPSHOT.EXE" -Publication %Publication%   
-Publisher %Publisher% -Distributor %Publisher% -PublisherDB %PublicationDB%   
-ReplicationType 2 -OutputVerboseLevel 1 -DistributorSecurityMode 1 ;  
  

运行分发代理

此示例批处理文件从命令提示符调用分发代理，从而不断地从 AdvWorksProductTran 发布向推送订阅服务器复制更改。

REM -- Declare the variables.  
SET Publisher=%instancename%;  
SET Subscriber=%instancename%;  
SET PublicationDB=AdventureWorks2022;  
SET SubscriptionDB=AdventureWorks2022Replica;   
SET Publication=AdvWorksProductsTran;  
  
REM -- Start the Distribution Agent with four subscription streams.  
REM -- The following command must be supplied without line breaks.  
"C:\Program Files\Microsoft SQL Server\130\COM\DISTRIB.EXE" -Subscriber %Subscriber%   
-SubscriberDB %SubscriptionDB% -SubscriberSecurityMode 1 -Publication %Publication%   
-Publisher %Publisher% -PublisherDB %PublicationDB% -Distributor %Publisher%   
-DistributorSecurityMode 1 -Continuous -SubscriptionType 0 -SubscriptionStreams 4 ;  
  

运行合并代理

此示例批处理文件从命令提示符调用合并代理，以将请求订阅与 AdvWorksSalesOrdersMerge 发布同步。

REM -- Declare the variables.  
SET Publisher=%instancename%;  
SET Subscriber=%instancename%;  
SET PublicationDB=AdventureWorks2022;  
SET SubscriptionDB=AdventureWorks2022Replica;   
SET Publication=AdvWorksSalesOrdersMerge;  
  
REM --Start the Merge Agent with concurrent upload and download processes.  
REM -- The following command must be supplied without line breaks.  
"C:\Program Files\Microsoft SQL Server\130\COM\REPLMERG.EXE" -Publication %Publication%    
-Publisher %Publisher%  -Subscriber  %Subscriber%  -Distributor %Publisher%    
-PublisherDB %PublicationDB%  -SubscriberDB %SubscriptionDB% -PublisherSecurityMode 1    
-OutputVerboseLevel 2  -SubscriberSecurityMode 1  -SubscriptionType 1 -DistributorSecurityMode 1    
-Validate 3  -ParallelUploadDownload 1 ;