[アーティクル]
04/01/2012

同期スケジュールを指定する方法 (RMO プログラミング)

レプリケーションは、SQL Server エージェントを使用して、スナップショットの生成やサブスクリプションの同期など、定期的に発生する動作のジョブをスケジュール設定します。レプリケーション管理オブジェクト (RMO) をプログラムで使用して、レプリケーションエージェントジョブのスケジュールを指定できます。

注
サブスクリプションを作成し、CreateSyncAgentByDefault に false を指定すると (プルサブスクリプションの既定の動作)、エージェントジョブは作成されず、スケジュール設定のプロパティは無視されます。この場合は、アプリケーションによって同期スケジュールを決定する必要があります。詳細については、「プルサブスクリプションを作成する方法 (RMO プログラミング)」および「プッシュサブスクリプションを作成する方法 (RMO プログラミング)」を参照してください。

サブスクリプションを作成し、CreateSyncAgentByDefault に false を指定すると (プルサブスクリプションの既定の動作)、エージェントジョブは作成されず、スケジュール設定のプロパティは無視されます。この場合は、アプリケーションによって同期スケジュールを決定する必要があります。詳細については、「プルサブスクリプションを作成する方法 (RMO プログラミング)」および「プッシュサブスクリプションを作成する方法 (RMO プログラミング)」を参照してください。

トランザクションパブリケーションに対するプッシュサブスクリプションを作成するレプリケーションエージェントスケジュールを定義するには

作成するサブスクリプションに対して TransSubscription クラスのインスタンスを作成します。詳細については、「プッシュサブスクリプションを作成する方法 (RMO プログラミング)」を参照してください。
Create を呼び出す前に、AgentSchedule プロパティの次のフィールドを 1 つ以上設定します。
- FrequencyType - エージェントのスケジュール設定時に使用する頻度の種類 (毎日、毎週など)。
- FrequencyInterval - エージェントを実行する曜日。
- FrequencyRelativeInterval - エージェントを月単位でスケジュール設定する場合の指定された月の週。
- FrequencyRecurrenceFactor - 同期から同期の間に発生する頻度の種類の単位の数。
- FrequencySubDay - エージェントを 1 日に複数回実行する場合の頻度の単位。
- FrequencySubDayInterval - エージェントを 1 日に複数回実行する場合の頻度の単位。
- ActiveStartTime - エージェントの実行を開始する特定の日の最も早い時刻。
- ActiveEndTime - エージェントの実行を開始する特定の日の最も遅い時刻。
- ActiveStartDate - エージェントスケジュールが有効になっている最初の日。
- ActiveEndDate - エージェントスケジュールが有効になっている最後の日。
注

これらのプロパティを指定しなかった場合、既定値が設定されます。
Create メソッドを呼び出してサブスクリプションを作成します。

注
これらのプロパティを指定しなかった場合、既定値が設定されます。

トランザクションパブリケーションに対するプルサブスクリプションを作成するレプリケーションエージェントスケジュールを定義するには

作成するサブスクリプションに対して TransPullSubscription クラスのインスタンスを作成します。詳細については、「プルサブスクリプションを作成する方法 (RMO プログラミング)」を参照してください。
Create を呼び出す前に、AgentSchedule プロパティの次のフィールドを 1 つ以上設定します。
- FrequencyType - エージェントのスケジュール設定時に使用する頻度の種類 (毎日、毎週など)。
- FrequencyInterval - エージェントを実行する曜日。
- FrequencyRelativeInterval - エージェントを月単位でスケジュール設定する場合の指定された月の週。
- FrequencyRecurrenceFactor - 同期から同期の間に発生する頻度の種類の単位の数。
- FrequencySubDay - エージェントを 1 日に複数回実行する場合の頻度の単位。
- FrequencySubDayInterval - エージェントを 1 日に複数回実行する場合の頻度の単位。
- ActiveStartTime - エージェントの実行を開始する特定の日の最も早い時刻。
- ActiveEndTime - エージェントの実行を開始する特定の日の最も遅い時刻。
- ActiveStartDate - エージェントスケジュールが有効になっている最初の日。
- ActiveEndDate - エージェントスケジュールが有効になっている最後の日。
注

これらのプロパティを指定しなかった場合、既定値が設定されます。
Create メソッドを呼び出してサブスクリプションを作成します。

注
これらのプロパティを指定しなかった場合、既定値が設定されます。

マージパブリケーションに対するプルサブスクリプションを作成するレプリケーションエージェントスケジュールを定義するには

作成するサブスクリプションに対して MergePullSubscription クラスのインスタンスを作成します。詳細については、「プルサブスクリプションを作成する方法 (RMO プログラミング)」を参照してください。
Create を呼び出す前に、AgentSchedule プロパティの次のフィールドを 1 つ以上設定します。
- FrequencyType - エージェントのスケジュール設定時に使用する頻度の種類 (毎日、毎週など)。
- FrequencyInterval - エージェントを実行する曜日。
- FrequencyRelativeInterval - エージェントを月単位でスケジュール設定する場合の指定された月の週。
- FrequencyRecurrenceFactor - 同期から同期の間に発生する頻度の種類の単位の数。
- FrequencySubDay - エージェントを 1 日に複数回実行する場合の頻度の単位。
- FrequencySubDayInterval - エージェントを 1 日に複数回実行する場合の頻度の単位。
- ActiveStartTime - エージェントの実行を開始する特定の日の最も早い時刻。
- ActiveEndTime - エージェントの実行を開始する特定の日の最も遅い時刻。
- ActiveStartDate - エージェントスケジュールが有効になっている最初の日。
- ActiveEndDate - エージェントスケジュールが有効になっている最後の日。
注

これらのプロパティを指定しなかった場合、既定値が設定されます。
Create メソッドを呼び出してサブスクリプションを作成します。

注
これらのプロパティを指定しなかった場合、既定値が設定されます。

マージパブリケーションに対するプッシュサブスクリプションを作成するレプリケーションエージェントスケジュールを定義するには

作成するサブスクリプションに対して MergeSubscription クラスのインスタンスを作成します。詳細については、「プッシュサブスクリプションを作成する方法 (RMO プログラミング)」を参照してください。
Create を呼び出す前に、AgentSchedule プロパティの次のフィールドを 1 つ以上設定します。
- FrequencyType - エージェントのスケジュール設定時に使用する頻度の種類 (毎日、毎週など)。
- FrequencyInterval - エージェントを実行する曜日。
- FrequencyRelativeInterval - エージェントを月単位でスケジュール設定する場合の指定された月の週。
- FrequencyRecurrenceFactor - 同期から同期の間に発生する頻度の種類の単位の数。
- FrequencySubDay - エージェントを 1 日に複数回実行する場合の頻度の単位。
- FrequencySubDayInterval - エージェントを 1 日に複数回実行する場合の頻度の単位。
- 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

次の方法で共有

同期スケジュールを指定する方法 (RMO プログラミング)

トランザクションパブリケーションに対するプッシュサブスクリプションを作成するレプリケーションエージェントスケジュールを定義するには

トランザクションパブリケーションに対するプルサブスクリプションを作成するレプリケーションエージェントスケジュールを定義するには

マージパブリケーションに対するプルサブスクリプションを作成するレプリケーションエージェントスケジュールを定義するには

マージパブリケーションに対するプッシュサブスクリプションを作成するレプリケーションエージェントスケジュールを定義するには

使用例

関連項目

タスク

概念

その他のリソース

次の方法で共有

同期スケジュールを指定する方法 (RMO プログラミング)

トランザクション パブリケーションに対するプッシュ サブスクリプションを作成するレプリケーション エージェント スケジュールを定義するには

トランザクション パブリケーションに対するプル サブスクリプションを作成するレプリケーション エージェント スケジュールを定義するには

マージ パブリケーションに対するプル サブスクリプションを作成するレプリケーション エージェント スケジュールを定義するには

マージ パブリケーションに対するプッシュ サブスクリプションを作成するレプリケーション エージェント スケジュールを定義するには

使用例

関連項目

タスク

概念

その他のリソース

トランザクションパブリケーションに対するプッシュサブスクリプションを作成するレプリケーションエージェントスケジュールを定義するには

トランザクションパブリケーションに対するプルサブスクリプションを作成するレプリケーションエージェントスケジュールを定義するには

マージパブリケーションに対するプルサブスクリプションを作成するレプリケーションエージェントスケジュールを定義するには

マージパブリケーションに対するプッシュサブスクリプションを作成するレプリケーションエージェントスケジュールを定義するには