MergePullSubscription.SynchronizeWithJob 메서드

정의

끌어오기 구독을 동기화하는 에이전트 작업을 비동기적으로 시작합니다.

public:
 override void SynchronizeWithJob();
public override void SynchronizeWithJob ();
override this.SynchronizeWithJob : unit -> unit
Public Overrides Sub SynchronizeWithJob ()

예제

// Define server, publication, and database names.
String subscriberName = subscriberInstance;
String publisherName = publisherInstance;
String publicationName = "AdvWorksSalesOrdersMerge";
String publicationDbName = "AdventureWorks2012";
String subscriptionDbName = "AdventureWorks2012Replica";

// Create a connection to the Subscriber.
ServerConnection conn = new ServerConnection(subscriberName);

MergePullSubscription subscription;

try
{
    // Connect to the Subscriber.
    conn.Connect();

    // Define subscription properties.
    subscription = new MergePullSubscription();
    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 = "AdvWorksSalesOrdersMerge"
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 MergePullSubscription

Try
    ' Connect to the Subscriber.
    conn.Connect()

    ' Define subscription properties.
    subscription = New MergePullSubscription()
    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

설명

속성에서 반환된 MergeSynchronizationAgent 개체를 SynchronizationAgent 사용하여 병합 에이전트 동기적으로 시작합니다.

에 대해 CreateSyncAgentByDefaultfalse 값으로 끌어오기 구독을 만든 경우 기본값인 구독에 대한 병합 에이전트 작업이 만들어지지 않고 호출 SynchronizeWithJob 하면 예외가 발생합니다.

StopSynchronizationJob 현재 실행 중인 경우 메서드를 호출하여 작업을 중지합니다.

Microsoft SQL Server 에이전트 서비스가 실행되고 있지 않으면 작업을 시작할 수 없습니다. 또한 스냅샷이 생성되지 않은 경우 에이전트 작업을 실행해도 구독이 동기화되지 않을 수 있습니다.

이 인스턴스 MergePullSubscription에서 추가 속성을 설정한 경우 를 호출하기 전에 를 호출 CommitPropertyChangesSynchronizeWithJob합니다.

메서드는 SynchronizeWithJob 구독자에서 sysadmin 고정 서버 역할의 멤버 또는 구독 데이터베이스에서 db_owner 고정 데이터베이스 역할의 멤버만 호출할 수 있습니다.

적용 대상

추가 정보