TransPullSubscription.SynchronizeWithJob Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicia o trabalho de agente para sincronizar a assinatura.
public:
override void SynchronizeWithJob();
public override void SynchronizeWithJob ();
override this.SynchronizeWithJob : unit -> unit
Public Overrides Sub SynchronizeWithJob ()
Exemplos
// Define server, publication, and database names.
String subscriberName = subscriberInstance;
String publisherName = publisherInstance;
String publicationName = "AdvWorksProductTran";
String publicationDbName = "AdventureWorks2012";
String subscriptionDbName = "AdventureWorks2012Replica";
// Create a connection to the Subscriber.
ServerConnection conn = new ServerConnection(subscriberName);
TransPullSubscription subscription;
try
{
// Connect to the Subscriber.
conn.Connect();
// Define subscription properties.
subscription = new TransPullSubscription();
subscription.ConnectionContext = conn;
subscription.DatabaseName = subscriptionDbName;
subscription.PublisherName = publisherName;
subscription.PublicationDBName = publicationDbName;
subscription.PublicationName = publicationName;
// If the pull subscription and the job exists, start the agent job.
if (subscription.LoadProperties() && subscription.AgentJobId != null)
{
subscription.SynchronizeWithJob();
}
else
{
// Do something here if the subscription does not exist.
throw new ApplicationException(String.Format(
"A subscription to '{0}' does not exists on {1}",
publicationName, subscriberName));
}
}
catch (Exception ex)
{
// Do appropriate error handling here.
throw new ApplicationException("The subscription could not be synchronized.", ex);
}
finally
{
conn.Disconnect();
}
' Define server, publication, and database names.
Dim subscriberName As String = subscriberInstance
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2012"
Dim subscriptionDbName As String = "AdventureWorks2012Replica"
' Create a connection to the Subscriber.
Dim conn As ServerConnection = New ServerConnection(subscriberName)
Dim subscription As TransPullSubscription
Try
' Connect to the Subscriber.
conn.Connect()
' Define subscription properties.
subscription = New TransPullSubscription()
subscription.ConnectionContext = conn
subscription.DatabaseName = subscriptionDbName
subscription.PublisherName = publisherName
subscription.PublicationDBName = publicationDbName
subscription.PublicationName = publicationName
' If the pull subscription and the job exists, start the agent job.
If subscription.LoadProperties() And Not subscription.AgentJobId Is Nothing Then
subscription.SynchronizeWithJob()
Else
' Do something here if the subscription does not exist.
Throw New ApplicationException(String.Format( _
"A subscription to '{0}' does not exists on {1}", _
publicationName, subscriberName))
End If
Catch ex As Exception
' Do appropriate error handling here.
Throw New ApplicationException("The subscription could not be synchronized.", ex)
Finally
conn.Disconnect()
End Try
Comentários
Use o TransSynchronizationAgent objeto retornado pela SynchronizationAgent propriedade para iniciar o Agente de Distribuição de forma síncrona.
Se a assinatura pull for criada com um valor de false
para CreateSyncAgentByDefault, o padrão, um trabalho Agente de Distribuição para a assinatura não será criado e chamar SynchronizeWithJob causará uma exceção.
Chame o StopSynchronizationJob método para interromper o trabalho se ele estiver em execução no momento.
O trabalho não poderá ser iniciado se o Microsoft SQL Server Agent Service não estiver em execução. Além disso, se um instantâneo não for gerado, a execução do trabalho do agente poderá não sincronizar a assinatura.
Se você tiver definido propriedades adicionais nesta instância do , chame CommitPropertyChanges antes de TransPullSubscriptionchamar SynchronizeWithJob.
O SynchronizeWithJob método só pode ser chamado por membros da função de servidor fixa sysadmin no Assinante ou por membros do db_owner função de banco de dados fixa no banco de dados de assinatura.