Partager via

Concepts des exécutables de l’agent de réplication

Les agents de réplication peuvent être contrôlés par programmation de la manière suivante :

  • Utilisation des interfaces de programmation de l’agent managé dans l’espace Microsoft.SqlServer.Replication de noms.

  • Appel de fichiers exécutables de l’agent à partir de l’invite de commandes avec un ensemble de paramètres fourni.

L’appel direct des agents de réplication à partir de l’invite de commandes permet aux agents d’être accessibles par programmation à partir d’un script de ligne de commande dans des fichiers batch. Lorsqu’un agent est appelé à partir de l’invite de commandes, il s’exécute sous le compte de sécurité Microsoft Windows de l’utilisateur qui a appelé l’agent ou démarré le fichier batch.

Les instances des agents de réplication suivants peuvent être exécutées à l’aide de fichiers exécutables.

Lors de l’appel d’agents de réplication, vous pouvez utiliser des profils de performances pour passer automatiquement un ensemble défini de paramètres à l’exécutable de l’agent. Pour plus d'informations, voir Replication Agent Profiles.

Exemples

Les exemples suivants montrent comment appeler des agents de réplication à partir de l’invite de commandes. Les agents de réplication peuvent également être appelés à l’aide d’objets RMO (Replication Management Objects). Pour plus d’informations, consultez Synchroniser les abonnements (réplication).

Remarque

Les sauts de ligne de ces exemples ont été ajoutés pour améliorer la lisibilité. Dans un fichier de commandes, les commandes doivent être effectuées sur une seule ligne.

Exécution de l’agent d’instantané

Cet exemple de fichier batch appelle l’Agent d’instantané à partir de l’invite de commandes pour générer un instantané pour la publication 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 ;

Exécution de l’Agent de distribution

Cet exemple de fichier batch appelle l’Agent de distribution à partir de l’invite de commandes pour répliquer en continu les modifications de la publication AdvWorksProductTran vers un abonné 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 ;

Exécution de l’agent de fusion

Cet exemple de fichier batch appelle l’Agent de fusion à partir de l’invite de commandes pour synchroniser un abonnement pull à la publication 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 ;
  • Last updated on