Conceptos de los ejecutables del Agente de replicación
Se aplica a: SQL Server Azure SQL Managed Instance
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 scripting de la línea de comandos en archivos por lotes. Cuando se invoca un agente 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, consulte Replication Agent Profiles.
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 Replication Management Objects (RMO). Para obtener más información, consulte Synchronize Subscriptions (Replication).
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. (Los scripts siguientes usan la ruta de acceso a los archivos de SQL Server 2016 (13.x) (versión 130). Debe ajustar los scripts para que apunten a los archivos de la versión de 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 ;
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=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 ;
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=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 ;