MergeSubscription.SynchronizeWithJob 메서드

정의

구독을 동기화하는 에이전트 작업을 시작합니다.

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

예제

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

// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);

MergeSubscription subscription;

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

    // Define push subscription.
    subscription = new MergeSubscription();
    subscription.ConnectionContext = conn;
    subscription.DatabaseName = publicationDbName;
    subscription.PublicationName = publicationName;
    subscription.SubscriptionDBName = subscriptionDbName;
    subscription.SubscriberName = subscriberName;

    // If the push subscription and the job exists, start the agent job.
    if (subscription.LoadProperties() && subscription.AgentJobId != null)
    {
        // Start the Merge Agent asynchronously.
        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)
{
    // Implement appropriate error handling here.
    throw new ApplicationException("The subscription could not be synchronized.", ex);
}
finally
{
    conn.Disconnect();
}
' Define the server, publication, and database names.
Dim subscriberName As String = subscriberInstance
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim subscriptionDbName As String = "AdventureWorks2012Replica"
Dim publicationDbName As String = "AdventureWorks2012"

' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

Dim subscription As MergeSubscription

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

    ' Define push subscription.
    subscription = New MergeSubscription()
    subscription.ConnectionContext = conn
    subscription.DatabaseName = publicationDbName
    subscription.PublicationName = publicationName
    subscription.SubscriptionDBName = subscriptionDbName
    subscription.SubscriberName = subscriberName

    ' If the push subscription and the job exists, start the agent job.
    If subscription.LoadProperties() And Not subscription.AgentJobId Is Nothing Then
        ' Start the Merge Agent asynchronously.
        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
    ' Implement appropriate error handling here.
    Throw New ApplicationException("The subscription could not be synchronized.", ex)
Finally
    conn.Disconnect()
End Try

설명

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

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

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

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

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

적용 대상

추가 정보