Replication Agent Executables Concepts

Область применения: SQL Server Управляемый экземпляр SQL Azure

Управление агентами репликации может осуществляться программным путем следующими способами:

• использованием управляемых программных интерфейсов агента в пространстве имен Microsoft.SqlServer.Replication;

• вызовом исполняемых файлов агента из командной строки с предоставленным набором параметров.

Непосредственный вызов агентов репликации из командной строки позволяет использовать агенты для доступа к ним программным путем из пакетных файлов сценариев командной строки. При вызове агента из командной строки он выполняется под учетной записью безопасности Microsoft Windows пользователя, который вызвал агент или запустил пакетный файл.

С применением исполняемых файлов можно запускать экземпляры следующих агентов репликации.

• Replication Distribution Agent

• Replication Log Reader Agent

• Replication Merge Agent

• Replication Queue Reader 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 ;