Concetti relativi ai file eseguibili dell'agente di replica

Gli agenti di replica possono essere controllati a livello di codice nei modi seguenti:

• Uso delle interfacce di programmazione dell'agente gestito nello spazio dei Microsoft.SqlServer.Replication nomi.

• Richiamo dei file eseguibili dell'agente dal prompt dei comandi con un set di parametri fornito.

Richiamando direttamente gli agenti di replica dal prompt dei comandi, gli agenti possono accedere a livello di codice dallo scripting da riga di comando nei file batch. Quando un agente viene richiamato dal prompt dei comandi, viene eseguito con l'account di sicurezza di Microsoft Windows dell'utente che ha richiamato l'agente o ha avviato il file batch.

Le istanze degli agenti di replica seguenti possono essere eseguite usando file eseguibili.

• Agente di distribuzione della replica

• Agente di lettura log replica

• Agente di merge della replica

• Agente di Lettura della Coda di Replica

• Agente snapshot di replica

Quando si richiamano agenti di replica, è possibile usare i profili di prestazioni per passare automaticamente un set definito di parametri all'eseguibile dell'agente. Per altre informazioni, vedere Replication Agent Profiles.

Esempi

Negli esempi seguenti viene illustrato come richiamare gli agenti di replica dal prompt dei comandi. Gli agenti di replica possono essere richiamati anche tramite RMO (Replication Management Objects). Per altre informazioni, vedere Synchronize Subscriptions (Replication).

Annotazioni

Sono state aggiunte interruzioni di riga in questi esempi per migliorare la leggibilità. In un file batch i comandi devono essere eseguiti in una singola riga.

Esecuzione dell'agente snapshot

Questo file batch di esempio richiama l'agente snapshot dal prompt dei comandi per generare uno snapshot per la pubblicazione AdvWorksSalesOrdersMerge .

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

Esecuzione dell'agente di distribuzione

Questo file batch di esempio richiama l'agente di distribuzione dal prompt dei comandi per replicare continuamente le modifiche dalla pubblicazione AdvWorksProductTran a un sottoscrittore push.

REM -- Declare the variables.  
SET Publisher=%instancename%;  
SET Subscriber=%instancename%;  
SET PublicationDB=AdventureWorks2012;  
SET SubscriptionDB=AdventureWorks2012Replica;   
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\120\COM\DISTRIB.EXE" -Subscriber %Subscriber%   
-SubscriberDB %SubscriptionDB% -SubscriberSecurityMode 1 -Publication %Publication%   
-Publisher %Publisher% -PublisherDB %PublicationDB% -Distributor %Publisher%   
-DistributorSecurityMode 1 -Continuous -SubscriptionType 0 -SubscriptionStreams 4 ;  
  

Esecuzione dell'agente di merge

Questo file batch di esempio richiama l'agente di merge dal prompt dei comandi per sincronizzare una sottoscrizione pull alla pubblicazione AdvWorksSalesOrdersMerge .

REM -- Declare the variables.  
SET Publisher=%instancename%;  
SET Subscriber=%instancename%;  
SET PublicationDB=AdventureWorks2012;  
SET SubscriptionDB=AdventureWorks2012Replica;   
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\120\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 ;