Conceptos de los ejecutables del Agente de replicación

Los agentes de replicación se pueden controlar mediante programación de las maneras siguientes:

  • Mediante las interfaces de programación del agente administrado en el espacio de nombres Microsoft.SqlServer.Replication.

  • Invocando a los archivos ejecutables de agente desde el símbolo del sistema con un conjunto proporcionado de parámetros.

Invocar directamente a los agentes de replicación desde el símbolo del sistema permite obtener acceso a los agentes mediante programación desde scripts de la línea de comandos en archivos por lotes. Cuando un agente se invoca desde el símbolo del sistema, se ejecuta en la cuenta de seguridad de Microsoft Windows del usuario que invocó al agente o inició el archivo por lotes.

Las instancias de los agentes de replicación siguientes se pueden ejecutar con archivos ejecutables.

Al invocar los agentes de replicación, puede utilizar los perfiles de rendimiento para pasar automáticamente un conjunto definido de parámetros a la aplicación ejecutable del agente. Para obtener más información, vea Perfiles del Agente de replicación.

Ejemplos

En los ejemplos siguientes se muestra cómo invocar los agentes de replicación desde el símbolo del sistema. Los agentes de replicación también se pueden invocar utilizando Objetos de administración de replicación (RMO). Para obtener más información, vea Sincronizar las suscripciones (replicación).

Nota

Los saltos de línea de estos ejemplos se agregaron para mejorar la legibilidad. En un archivo por lotes, los comandos se deben realizar en una única línea.

Ejecutar el Agente de instantáneas

Este archivo por lotes de ejemplo invoca al Agente de instantáneas desde el símbolo del sistema para generar una instantánea para la publicación 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 

Ejecutar el Agente de distribución

Este archivo por lotes de ejemplo invoca al Agente de distribución desde el símbolo del sistema para replicar continuamente los cambios desde la publicación AdvWorksProductTran a un suscriptor de inserción.

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 

Ejecutar el Agente de mezcla

Este archivo por lotes de ejemplo invoca al Agente de mezcla desde el símbolo del sistema para sincronizar una suscripción de extracción a la publicación 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