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

Il est possible de contrôler par programme les agents de réplication de différentes manières :

  • en utilisant les interfaces de programmation d'agent managé dans l'espace de noms Microsoft.SqlServer.Replication ;

  • en appelant les fichiers exécutables de l'agent à partir de l'invite de commandes avec des paramètres définis.

Lorsque les agents de réplication sont directement appelés à partir de l'invite de commandes, il est possible d'accéder par programme aux agents à partir de scripts dans des fichiers de commandes. 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 qui a lancé le fichier de commandes.

Il est possible d'exécuter des instances des agents de réplication suivants à l'aide de fichiers exécutables.

Lorsque vous appelez des agents de réplication, vous pouvez utiliser des profils de performances pour transmettre automatiquement un jeu défini de paramètres au fichier exécutable de l'agent. Pour plus d'informations, consultez Profils de l'Agent de réplication.

Exemples

Les exemples suivants décrivent comment appeler les agents de réplication à partir de l'invite de commandes. Il est également possible d'appeler les agents de réplication au moyen d'objets RMO (Replication Management Objects). Pour plus d'informations, consultez Synchronisation d'abonnements (réplication).

Note

Les sauts de ligne figurant dans ces exemples ont été ajoutés afin d'améliorer la lisibilité. Dans un fichier de commandes, les commandes doivent figurer sur une seule ligne.

Exécution de l'Agent de capture instantanée

Cet exemple de fichier de commandes appelle l'Agent de capture instantanée à partir de l'invite de commandes afin de générer une capture instantanée pour la publication AdvWorksSalesOrdersMerge.

REM -- Declare variables
SET Publisher=%InstanceName%
SET PublicationDB=AdventureWorks2008R2 
SET Publication=AdvWorksSalesOrdersMerge 

REM --Start the Snapshot Agent to generate the snapshot for AdvWorksSalesOrdersMerge.
"C:\Program Files\Microsoft SQL Server\100\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 de commandes appelle l'Agent de distribution à partir de l'invite de commandes afin de répliquer en continu les modifications de la publication AdvWorksProductTran sur un abonné pour un abonnement par émission de données.

REM -- Declare the variables.
SET Publisher=%instancename%
SET Subscriber=%instancename%
SET PublicationDB=AdventureWorks2008R2
SET SubscriptionDB=AdventureWorks2008R2Replica 
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\100\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 de commandes appelle l'Agent de fusion à partir de l'invite de commandes afin de synchroniser un abonnement par extraction de données avec la publication AdvWorksSalesOrdersMerge.

REM -- Declare the variables.
SET Publisher=%instancename%
SET Subscriber=%instancename%
SET PublicationDB=AdventureWorks2008R2
SET SubscriptionDB=AdventureWorks2008R2Replica 
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\100\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