Replication Agent Executables Concepts

适用于：SQL Server Azure 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 ;