如何：指定同步排程 (RMO 程式設計)
複寫會使用 SQL Server Agent 來排程定期發生之活動的作業，例如快照集的產生和訂閱同步處理。您可以使用複寫管理物件 (RMO)，以程式設計方式指定複寫代理程式作業的排程。
[!附註]
當您建立訂閱，並針對 CreateSyncAgentByDefault (提取訂閱的預設行為) 指定 false 的值時，不會建立代理程式作業，而且會忽略排程屬性。在此情況下，同步排程必須由應用程式來決定。如需詳細資訊，請參閱＜如何：建立提取訂閱 (RMO 程式設計)＞和＜如何：建立發送訂閱 (RMO 程式設計)＞。
當您建立交易式發行集的發送訂閱時，定義複寫代理程式排程
為您所建立的訂閱建立 TransSubscription 類別的執行個體。如需詳細資訊，請參閱＜如何：建立發送訂閱 (RMO 程式設計)＞。
在您呼叫 Create 之前，請設定 AgentSchedule 屬性的下列一或多個欄位：
FrequencyType - 當您排程代理程式時，所用的頻率類型 (如每天或每週)。
FrequencyInterval - 代理程式執行之一週中的日子。
FrequencyRelativeInterval - 當代理程式排定為要每月執行時，給定月份的週。
FrequencyRecurrenceFactor - 在同步處理之間發生的頻率類型單位數目。
FrequencySubDay - 代理程式執行頻率超過一天一次以上時的頻率單位。
FrequencySubDayInterval - 代理程式執行頻率超過一天一次以上時，執行之間的頻率單位數目。
ActiveStartTime - 代理程式在給定日子開始執行的最早時間。
ActiveEndTime - 代理程式在給定日子開始執行的最晚時間。
ActiveStartDate - 代理程式排程生效的第一天。
ActiveEndDate - 代理程式排程有效的最後一天。
[!附註]
若未指定這些屬性的其中一個，則會設定預設值。
呼叫 Create 方法來建立訂閱。
當您建立交易式發行集的提取訂閱時，定義複寫代理程式排程
為您所建立的訂閱建立 TransPullSubscription 類別的執行個體。如需詳細資訊，請參閱＜如何：建立提取訂閱 (RMO 程式設計)＞。
在您呼叫 Create 之前，請設定 AgentSchedule 屬性的下列一或多個欄位：
FrequencyType - 當您排程代理程式時，所用的頻率類型 (如每天或每週)。
FrequencyInterval - 代理程式執行之一週中的日子。
FrequencyRelativeInterval - 當代理程式排定為要每月執行時，給定月份的週。
FrequencyRecurrenceFactor - 在同步處理之間發生的頻率類型單位數目。
FrequencySubDay - 代理程式執行頻率超過一天一次以上時的頻率單位。
FrequencySubDayInterval - 代理程式執行頻率超過一天一次以上時，執行之間的頻率單位數目。
ActiveStartTime - 代理程式在給定日子開始執行的最早時間。
ActiveEndTime - 代理程式在給定日子開始執行的最晚時間。
ActiveStartDate - 代理程式排程生效的第一天。
ActiveEndDate - 代理程式排程有效的最後一天。
[!附註]
若未指定這些屬性的其中一個，則會設定預設值。
呼叫 Create 方法來建立訂閱。
當您建立合併式發行集的提取訂閱時，定義複寫代理程式排程
為您所建立的訂閱建立 MergePullSubscription 類別的執行個體。如需詳細資訊，請參閱＜如何：建立提取訂閱 (RMO 程式設計)＞。
在您呼叫 Create 之前，請設定 AgentSchedule 屬性的下列一或多個欄位：
FrequencyType - 當您排程代理程式時，所用的頻率類型 (如每天或每週)。
FrequencyInterval - 代理程式執行之一週中的日子。
FrequencyRelativeInterval - 當代理程式排定為要每月執行時，給定月份的週。
FrequencyRecurrenceFactor - 在同步處理之間發生的頻率類型單位數目。
FrequencySubDay - 代理程式執行頻率超過一天一次以上時的頻率單位。
FrequencySubDayInterval - 代理程式執行頻率超過一天一次以上時，執行之間的頻率單位數目。
ActiveStartTime - 代理程式在給定日子開始執行的最早時間。
ActiveEndTime - 代理程式在給定日子開始執行的最晚時間。
ActiveStartDate - 代理程式排程生效的第一天。
ActiveEndDate - 代理程式排程有效的最後一天。
[!附註]
若未指定這些屬性的其中一個，則會設定預設值。
呼叫 Create 方法來建立訂閱。
當您建立合併式發行集的發送訂閱時，定義複寫代理程式排程
為您所建立的訂閱建立 MergeSubscription 類別的執行個體。如需詳細資訊，請參閱＜如何：建立發送訂閱 (RMO 程式設計)＞。
在您呼叫 Create 之前，請設定 AgentSchedule 屬性的下列一或多個欄位：
FrequencyType - 當您排程代理程式時，所用的頻率類型 (如每天或每週)。
FrequencyInterval - 代理程式執行之一週中的日子。
FrequencyRelativeInterval - 當代理程式排定為要每月執行時，給定月份的週。
FrequencyRecurrenceFactor - 在同步處理之間發生的頻率類型單位數目。
FrequencySubDay - 代理程式執行頻率超過一天一次以上時的頻率單位。
FrequencySubDayInterval - 代理程式執行頻率超過一天一次以上時，執行之間的頻率單位數目。
ActiveStartTime - 代理程式在給定日子開始執行的最早時間。
ActiveEndTime - 代理程式在給定日子開始執行的最晚時間。
ActiveStartDate - 代理程式排程生效的第一天。
ActiveEndDate - 代理程式排程有效的最後一天。
[!附註]
若未指定這些屬性的其中一個，則會設定預設值。
呼叫 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