방법: 동기화 일정 지정(RMO 프로그래밍)

복제에서는 SQL Server 에이전트를 사용하여 스냅숏 생성이나 구독 동기화와 같이 정기적으로 수행하는 작업의 일정을 지정합니다. RMO(복제 관리 개체)를 사용하여 프로그래밍 방식으로 복제 에이전트 작업의 일정을 지정할 수 있습니다.

[!참고]

구독을 만들고 CreateSyncAgentByDefault에 false 값을 지정하면(끌어오기 구독에 대한 기본 동작) 에이전트 작업은 생성되지 않으며 일정 속성은 무시됩니다. 이 경우에는 응용 프로그램에서 동기화 일정을 결정해야 합니다. 자세한 내용은 방법: 끌어오기 구독 만들기(RMO Programming)방법: 밀어넣기 구독 만들기(RMO Programming)를 참조하십시오.

트랜잭션 게시에 대한 밀어넣기 구독을 만들 때 복제 에이전트 일정을 정의하려면

  1. 만들려는 구독에 대해 TransSubscription 클래스의 인스턴스를 만듭니다. 자세한 내용은 방법: 밀어넣기 구독 만들기(RMO Programming)를 참조하십시오.

  2. Create를 호출하기 전에 AgentSchedule 속성의 다음 필드 중 하나 이상을 설정합니다.

    • FrequencyType - 에이전트를 예약할 때 사용하는 빈도 유형(예: 매일 또는 매주)입니다.

    • FrequencyInterval - 에이전트가 실행하는 요일입니다.

    • FrequencyRelativeInterval - 지정된 월에서 에이전트가 월별로 실행되도록 예약된 주입니다.

    • FrequencyRecurrenceFactor - 동기화 사이에 발생하는 frequency-type 단위 수입니다.

    • FrequencySubDay - 에이전트가 하루에 두 번 이상 실행할 경우 빈도 단위입니다.

    • FrequencySubDayInterval - 에이전트가 하루에 두 번 이상 실행할 경우 실행 간의 빈도 단위 수입니다.

    • ActiveStartTime - 지정된 날짜에서 에이전트가 실행되는 시작 시간입니다.

    • ActiveEndTime - 지정된 날짜에서 에이전트가 실행되는 마지막 시간입니다.

    • ActiveStartDate - 에이전트 예약이 처음 적용되는 날짜입니다.

    • ActiveEndDate - 에이전트 예약이 마지막으로 적용되는 날짜입니다.

    [!참고]

    이러한 속성 중 하나를 지정하지 않으면 기본값이 설정됩니다.

  3. Create 메서드를 호출하여 구독을 만듭니다.

트랜잭션 게시에 대한 끌어오기 구독을 만들 때 복제 에이전트 일정을 정의하려면

  1. 만들려는 구독에 대해 TransPullSubscription 클래스의 인스턴스를 만듭니다. 자세한 내용은 방법: 끌어오기 구독 만들기(RMO Programming)를 참조하십시오.

  2. Create를 호출하기 전에 AgentSchedule 속성의 다음 필드 중 하나 이상을 설정합니다.

    • FrequencyType - 에이전트를 예약할 때 사용하는 빈도 유형(예: 매일 또는 매주)입니다.

    • FrequencyInterval - 에이전트가 실행하는 요일입니다.

    • FrequencyRelativeInterval - 지정된 월에서 에이전트가 월별로 실행되도록 예약된 주입니다.

    • FrequencyRecurrenceFactor - 동기화 사이에 발생하는 frequency-type 단위 수입니다.

    • FrequencySubDay - 에이전트가 하루에 두 번 이상 실행할 경우 빈도 단위입니다.

    • FrequencySubDayInterval - 에이전트가 하루에 두 번 이상 실행할 경우 실행 간의 빈도 단위 수입니다.

    • ActiveStartTime - 지정된 날짜에서 에이전트가 실행되는 시작 시간입니다.

    • ActiveEndTime - 지정된 날짜에서 에이전트가 실행되는 마지막 시간입니다.

    • ActiveStartDate - 에이전트 예약이 처음 적용되는 날짜입니다.

    • ActiveEndDate - 에이전트 예약이 마지막으로 적용되는 날짜입니다.

    [!참고]

    이러한 속성 중 하나를 지정하지 않으면 기본값이 설정됩니다.

  3. Create 메서드를 호출하여 구독을 만듭니다.

병합 게시에 대한 끌어오기 구독을 만들 때 복제 에이전트 일정을 정의하려면

  1. 만들려는 구독에 대해 MergePullSubscription 클래스의 인스턴스를 만듭니다. 자세한 내용은 방법: 끌어오기 구독 만들기(RMO Programming)를 참조하십시오.

  2. Create를 호출하기 전에 AgentSchedule 속성의 다음 필드 중 하나 이상을 설정합니다.

    • FrequencyType - 에이전트를 예약할 때 사용하는 빈도 유형(예: 매일 또는 매주)입니다.

    • FrequencyInterval - 에이전트가 실행하는 요일입니다.

    • FrequencyRelativeInterval - 지정된 월에서 에이전트가 월별로 실행되도록 예약된 주입니다.

    • FrequencyRecurrenceFactor - 동기화 사이에 발생하는 frequency-type 단위 수입니다.

    • FrequencySubDay - 에이전트가 하루에 두 번 이상 실행할 경우 빈도 단위입니다.

    • FrequencySubDayInterval - 에이전트가 하루에 두 번 이상 실행할 경우 실행 간의 빈도 단위 수입니다.

    • ActiveStartTime - 지정된 날짜에서 에이전트가 실행되는 시작 시간입니다.

    • ActiveEndTime - 지정된 날짜에서 에이전트가 실행되는 마지막 시간입니다.

    • ActiveStartDate - 에이전트 예약이 처음 적용되는 날짜입니다.

    • ActiveEndDate - 에이전트 예약이 마지막으로 적용되는 날짜입니다.

    [!참고]

    이러한 속성 중 하나를 지정하지 않으면 기본값이 설정됩니다.

  3. Create 메서드를 호출하여 구독을 만듭니다.

병합 게시에 대한 밀어넣기 구독을 만들 때 복제 에이전트 일정을 정의하려면

  1. 만들려는 구독에 대해 MergeSubscription 클래스의 인스턴스를 만듭니다. 자세한 내용은 방법: 밀어넣기 구독 만들기(RMO Programming)를 참조하십시오.

  2. Create를 호출하기 전에 AgentSchedule 속성의 다음 필드 중 하나 이상을 설정합니다.

    • FrequencyType - 에이전트를 예약할 때 사용하는 빈도 유형(예: 매일 또는 매주)입니다.

    • FrequencyInterval - 에이전트가 실행하는 요일입니다.

    • FrequencyRelativeInterval - 지정된 월에서 에이전트가 월별로 실행되도록 예약된 주입니다.

    • FrequencyRecurrenceFactor - 동기화 사이에 발생하는 frequency-type 단위 수입니다.

    • FrequencySubDay - 에이전트가 하루에 두 번 이상 실행할 경우 빈도 단위입니다.

    • FrequencySubDayInterval - 에이전트가 하루에 두 번 이상 실행할 경우 실행 간의 빈도 단위 수입니다.

    • ActiveStartTime - 지정된 날짜에서 에이전트가 실행되는 시작 시간입니다.

    • ActiveEndTime - 지정된 날짜에서 에이전트가 실행되는 마지막 시간입니다.

    • ActiveStartDate - 에이전트 예약이 처음 적용되는 날짜입니다.

    • ActiveEndDate - 에이전트 예약이 마지막으로 적용되는 날짜입니다.

    [!참고]

    이러한 속성 중 하나를 지정하지 않으면 기본값이 설정됩니다.

  3. Create 메서드를 호출하여 구독을 만듭니다.

이 예에서는 병합 계시에 대한 밀어넣기 구독을 만들고 구독의 동기화 일정을 지정합니다.

            // Define the Publisher, publication, and databases.
            string publicationName = "AdvWorksSalesOrdersMerge";
            string publisherName = publisherInstance;
            string subscriberName = subscriberInstance;
            string subscriptionDbName = "AdventureWorks2008R2Replica";
            string publicationDbName = "AdventureWorks2008R2";
            string hostname = @"adventure-works\garrett1";

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

            // Create the objects that we need.
            MergePublication publication;
            MergeSubscription subscription;

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

                // Ensure that the publication exists and that 
                // it supports push subscriptions.
                publication = new MergePublication();
                publication.Name = publicationName;
                publication.DatabaseName = publicationDbName;
                publication.ConnectionContext = conn;

                if (publication.IsExistingObject)
                {
                    if ((publication.Attributes & PublicationAttributes.AllowPush) == 0)
                    {
                        publication.Attributes |= PublicationAttributes.AllowPush;
                    }

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

                    // Set a schedule to synchronize the subscription every 2 hours
                    // during weekdays from 6am to 10pm.
                    subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.Weekly;
                    subscription.AgentSchedule.FrequencyInterval = Convert.ToInt32(0x003E);
                    subscription.AgentSchedule.FrequencyRecurrenceFactor = 1;
                    subscription.AgentSchedule.FrequencySubDay = ScheduleFrequencySubDay.Hour;
                    subscription.AgentSchedule.FrequencySubDayInterval = 2;
                    subscription.AgentSchedule.ActiveStartDate = 20051108;
                    subscription.AgentSchedule.ActiveEndDate = 20071231;
                    subscription.AgentSchedule.ActiveStartTime = 060000;
                    subscription.AgentSchedule.ActiveEndTime = 100000;

                    // Specify the Windows login credentials for the Merge Agent job.
                    subscription.SynchronizationAgentProcessSecurity.Login = winLogin;
                    subscription.SynchronizationAgentProcessSecurity.Password = winPassword;

                    // Create the push subscription.
                    subscription.Create();
                }
                else
                {
                    // Do something here if the publication does not exist.
                    throw new ApplicationException(String.Format(
                        "The publication '{0}' does not exist on {1}.",
                        publicationName, publisherName));
                }
            }
            catch (Exception ex)
            {
                // Implement the appropriate error handling here.
                throw new ApplicationException(String.Format(
                    "The subscription to {0} could not be created.", publicationName), ex);
            }
            finally
            {
                conn.Disconnect();
            }
' Define the Publisher, publication, and databases.
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2008R2Replica"
Dim publicationDbName As String = "AdventureWorks2008R2"
Dim hostname As String = "adventure-works\garrett1"

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

' Create the objects that we need.
Dim publication As MergePublication
Dim subscription As MergeSubscription

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

    ' Ensure that the publication exists and that 
    ' it supports push subscriptions.
    publication = New MergePublication()
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName
    publication.ConnectionContext = conn

    If publication.IsExistingObject Then
        If (publication.Attributes And PublicationAttributes.AllowPush) = 0 Then
            publication.Attributes = publication.Attributes _
            Or PublicationAttributes.AllowPush
        End If

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

        ' Set a schedule to synchronize the subscription every 2 hours
        ' during weekdays from 6am to 10pm.
        subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.Weekly
        subscription.AgentSchedule.FrequencyInterval = Convert.ToInt32("0x003E", 16)
        subscription.AgentSchedule.FrequencyRecurrenceFactor = 1
        subscription.AgentSchedule.FrequencySubDay = ScheduleFrequencySubDay.Hour
        subscription.AgentSchedule.FrequencySubDayInterval = 2
        subscription.AgentSchedule.ActiveStartDate = 20051108
        subscription.AgentSchedule.ActiveEndDate = 20071231
        subscription.AgentSchedule.ActiveStartTime = 60000
        subscription.AgentSchedule.ActiveEndTime = 100000

        ' Specify the Windows login credentials for the Merge Agent job.
        subscription.SynchronizationAgentProcessSecurity.Login = winLogin
        subscription.SynchronizationAgentProcessSecurity.Password = winPassword

        ' Create the push subscription.
        subscription.Create()
    Else

        ' Do something here if the publication does not exist.
        Throw New ApplicationException(String.Format( _
         "The publication '{0}' does not exist on {1}.", _
         publicationName, publisherName))
    End If
Catch ex As Exception
    ' Implement the appropriate error handling here.
    Throw New ApplicationException(String.Format( _
    "The subscription to {0} could not be created.", publicationName), ex)
Finally
    conn.Disconnect()
End Try