MergePullSubscription.SynchronizeWithJob 메서드

정의

네임스페이스:
Microsoft.SqlServer.Replication
어셈블리:
Microsoft.SqlServer.Rmo.dll

에이전트 작업을 비동기적으로 시작하여 풀 구독을 동기화합니다.

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

설명

속성에서 SynchronizationAgent 반환된 객체를 사용 MergeSynchronizationAgent 해 병합 에이전트를 동기적으로 시작하세요.

풀 구독이 값이 falseCreateSyncAgentByDefault로 생성되면 기본값인 구독에 대한 병합 에이전트 작업이 생성되지 않으며, 호출 SynchronizeWithJob 시 예외가 발생합니다.

작업 중지 메서드가 실행 중이라면 호출하세요 StopSynchronizationJob .

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

이 인스턴스MergePullSubscription에 추가 속성을 설정했다면, 를 부르SynchronizeWithJob기 전에 호출 CommitPropertyChanges 하세요.

이 메서드는 SynchronizeWithJob 구독자의 시스템 관리자 고정 서버 역할 구성원 또는 구독 데이터베이스의 db_owner 고정 데이터베이스 역할 구성원만 호출할 수 있습니다.

적용 대상

추가 정보