Conceitos dos executáveis do Replication Agent
Os agentes de replicação podem ser controlados programaticamente das seguintes formas:
Usando as interfaces de programação do agente gerenciado no namespace Microsoft.SqlServer.Replication.
Invocando arquivos executáveis do agente no prompt de comando usando um conjunto de parâmetros fornecido.
Invocar agentes de replicação diretamente do prompt de comando permite que os agentes sejam programaticamente acessados de scripts de linha de comandos existentes em arquivos em lotes. Quando um agente é invocado do prompt de comando, é executado sob a conta de segurança do Windows Microsoft do usuário que invocou o agente ou que iniciou o arquivo em lotes.
As instâncias dos agentes de replicação a seguir podem ser executadas por meio de arquivos executáveis.
Ao invocar agentes de replicação, você pode usar perfis de desempenho para transmitir automaticamente um conjunto definido de parâmetros para o executável do agente. Para obter mais informações, consulte Perfis do Replication Agent.
Exemplos
Os exemplos a seguir mostram como invocar os agentes de replicação no prompt de comando. Os agentes de replicação também podem ser invocados usando RMO (Replication Management Objects). Para obter mais informações, consulte Sincronizando assinaturas (Replicação).
.gif "Observação") Observação |
|---|
As quebras de linha destes exemplos foram adicionadas para melhorar a legibilidade. Em um arquivo em lotes, devem ser feitos comandos em uma única linha. |
Executando o Snapshot Agent
Este arquivo em lotes de exemplo invoca o Snapshot Agent no prompt de comando para gerar um instantâneo da publicação AdvWorksSalesOrdersMerge.
REM -- Declare variables
SET Publisher=%InstanceName%
SET PublicationDB=AdventureWorks
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
Executando o Distribution Agent
Este arquivo em lotes de exemplo invoca o Distribution Agent no prompt de comando para replicar continuamente as alterações da publicação AdvWorksProductTran para um assinante push.
REM -- Declare the variables.
SET Publisher=%instancename%
SET Subscriber=%instancename%
SET PublicationDB=AdventureWorks
SET SubscriptionDB=AdventureWorksReplica
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
Executando o Merge Agent
Este arquivo em lotes de exemplo invoca o Merge Agent no prompt de comando para sincronizar uma assinatura pull da publicação AdvWorksSalesOrdersMerge.
REM -- Declare the variables.
SET Publisher=%instancename%
SET Subscriber=%instancename%
SET PublicationDB=AdventureWorks
SET SubscriptionDB=AdventureWorksReplica
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