방법: 동기화 일정 지정(RMO 프로그래밍)
복제에서는 SQL Server 에이전트를 사용하여 스냅숏 생성이나 구독 동기화와 같이 정기적으로 수행하는 작업의 일정을 지정합니다. RMO(복제 관리 개체)를 사용하여 프로그래밍 방식으로 복제 에이전트 작업의 일정을 지정할 수 있습니다.
[!참고]
구독을 만들고 CreateSyncAgentByDefault에 false 값을 지정하면(끌어오기 구독에 대한 기본 동작) 에이전트 작업은 생성되지 않으며 일정 속성은 무시됩니다. 이 경우에는 응용 프로그램에서 동기화 일정을 결정해야 합니다. 자세한 내용은 방법: 끌어오기 구독 만들기(RMO Programming) 및 방법: 밀어넣기 구독 만들기(RMO Programming)를 참조하십시오.
트랜잭션 게시에 대한 밀어넣기 구독을 만들 때 복제 에이전트 일정을 정의하려면
만들려는 구독에 대해 TransSubscription 클래스의 인스턴스를 만듭니다. 자세한 내용은 방법: 밀어넣기 구독 만들기(RMO Programming)를 참조하십시오.
Create를 호출하기 전에 AgentSchedule 속성의 다음 필드 중 하나 이상을 설정합니다.
FrequencyType - 에이전트를 예약할 때 사용하는 빈도 유형(예: 매일 또는 매주)입니다.
FrequencyInterval - 에이전트가 실행하는 요일입니다.
FrequencyRelativeInterval - 지정된 월에서 에이전트가 월별로 실행되도록 예약된 주입니다.
FrequencyRecurrenceFactor - 동기화 사이에 발생하는 frequency-type 단위 수입니다.
FrequencySubDay - 에이전트가 하루에 두 번 이상 실행할 경우 빈도 단위입니다.
FrequencySubDayInterval - 에이전트가 하루에 두 번 이상 실행할 경우 실행 간의 빈도 단위 수입니다.
ActiveStartTime - 지정된 날짜에서 에이전트가 실행되는 시작 시간입니다.
ActiveEndTime - 지정된 날짜에서 에이전트가 실행되는 마지막 시간입니다.
ActiveStartDate - 에이전트 예약이 처음 적용되는 날짜입니다.
ActiveEndDate - 에이전트 예약이 마지막으로 적용되는 날짜입니다.
[!참고]
이러한 속성 중 하나를 지정하지 않으면 기본값이 설정됩니다.
Create 메서드를 호출하여 구독을 만듭니다.
트랜잭션 게시에 대한 끌어오기 구독을 만들 때 복제 에이전트 일정을 정의하려면
만들려는 구독에 대해 TransPullSubscription 클래스의 인스턴스를 만듭니다. 자세한 내용은 방법: 끌어오기 구독 만들기(RMO Programming)를 참조하십시오.
Create를 호출하기 전에 AgentSchedule 속성의 다음 필드 중 하나 이상을 설정합니다.
FrequencyType - 에이전트를 예약할 때 사용하는 빈도 유형(예: 매일 또는 매주)입니다.
FrequencyInterval - 에이전트가 실행하는 요일입니다.
FrequencyRelativeInterval - 지정된 월에서 에이전트가 월별로 실행되도록 예약된 주입니다.
FrequencyRecurrenceFactor - 동기화 사이에 발생하는 frequency-type 단위 수입니다.
FrequencySubDay - 에이전트가 하루에 두 번 이상 실행할 경우 빈도 단위입니다.
FrequencySubDayInterval - 에이전트가 하루에 두 번 이상 실행할 경우 실행 간의 빈도 단위 수입니다.
ActiveStartTime - 지정된 날짜에서 에이전트가 실행되는 시작 시간입니다.
ActiveEndTime - 지정된 날짜에서 에이전트가 실행되는 마지막 시간입니다.
ActiveStartDate - 에이전트 예약이 처음 적용되는 날짜입니다.
ActiveEndDate - 에이전트 예약이 마지막으로 적용되는 날짜입니다.
[!참고]
이러한 속성 중 하나를 지정하지 않으면 기본값이 설정됩니다.
Create 메서드를 호출하여 구독을 만듭니다.
병합 게시에 대한 끌어오기 구독을 만들 때 복제 에이전트 일정을 정의하려면
만들려는 구독에 대해 MergePullSubscription 클래스의 인스턴스를 만듭니다. 자세한 내용은 방법: 끌어오기 구독 만들기(RMO Programming)를 참조하십시오.
Create를 호출하기 전에 AgentSchedule 속성의 다음 필드 중 하나 이상을 설정합니다.
FrequencyType - 에이전트를 예약할 때 사용하는 빈도 유형(예: 매일 또는 매주)입니다.
FrequencyInterval - 에이전트가 실행하는 요일입니다.
FrequencyRelativeInterval - 지정된 월에서 에이전트가 월별로 실행되도록 예약된 주입니다.
FrequencyRecurrenceFactor - 동기화 사이에 발생하는 frequency-type 단위 수입니다.
FrequencySubDay - 에이전트가 하루에 두 번 이상 실행할 경우 빈도 단위입니다.
FrequencySubDayInterval - 에이전트가 하루에 두 번 이상 실행할 경우 실행 간의 빈도 단위 수입니다.
ActiveStartTime - 지정된 날짜에서 에이전트가 실행되는 시작 시간입니다.
ActiveEndTime - 지정된 날짜에서 에이전트가 실행되는 마지막 시간입니다.
ActiveStartDate - 에이전트 예약이 처음 적용되는 날짜입니다.
ActiveEndDate - 에이전트 예약이 마지막으로 적용되는 날짜입니다.
[!참고]
이러한 속성 중 하나를 지정하지 않으면 기본값이 설정됩니다.
Create 메서드를 호출하여 구독을 만듭니다.
병합 게시에 대한 밀어넣기 구독을 만들 때 복제 에이전트 일정을 정의하려면
만들려는 구독에 대해 MergeSubscription 클래스의 인스턴스를 만듭니다. 자세한 내용은 방법: 밀어넣기 구독 만들기(RMO Programming)를 참조하십시오.
Create를 호출하기 전에 AgentSchedule 속성의 다음 필드 중 하나 이상을 설정합니다.
FrequencyType - 에이전트를 예약할 때 사용하는 빈도 유형(예: 매일 또는 매주)입니다.
FrequencyInterval - 에이전트가 실행하는 요일입니다.
FrequencyRelativeInterval - 지정된 월에서 에이전트가 월별로 실행되도록 예약된 주입니다.
FrequencyRecurrenceFactor - 동기화 사이에 발생하는 frequency-type 단위 수입니다.
FrequencySubDay - 에이전트가 하루에 두 번 이상 실행할 경우 빈도 단위입니다.
FrequencySubDayInterval - 에이전트가 하루에 두 번 이상 실행할 경우 실행 간의 빈도 단위 수입니다.
ActiveStartTime - 지정된 날짜에서 에이전트가 실행되는 시작 시간입니다.
ActiveEndTime - 지정된 날짜에서 에이전트가 실행되는 마지막 시간입니다.
ActiveStartDate - 에이전트 예약이 처음 적용되는 날짜입니다.
ActiveEndDate - 에이전트 예약이 마지막으로 적용되는 날짜입니다.
[!참고]
이러한 속성 중 하나를 지정하지 않으면 기본값이 설정됩니다.
Create 메서드를 호출하여 구독을 만듭니다.
예
이 예에서는 병합 계시에 대한 밀어넣기 구독을 만들고 구독의 동기화 일정을 지정합니다.
// Define the Publisher, publication, and databases.
string publicationName = "AdvWorksSalesOrdersMerge";
string publisherName = publisherInstance;
string subscriberName = subscriberInstance;
string subscriptionDbName = "AdventureWorksReplica";
string publicationDbName = "AdventureWorks";
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 = "AdventureWorksReplica"
Dim publicationDbName As String = "AdventureWorks"
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