指定同步计划

项目
08/30/2023

此主题介绍如何使用 SQL Server Management Studio、Transact-SQL 或复制管理对象 (RMO) 在 SQL Server 中指定同步计划。在创建订阅时，可以定义同步计划以控制何时运行订阅的复制代理。如果没有指定计划参数，则订阅将使用默认计划。

订阅由分发代理（对于快照复制和事务复制）或合并代理（对于合并复制）进行同步。代理可以连续运行、按需运行或按计划运行。

本主题内容

指定同步计划，使用：

SQL Server Management Studio

Transact-SQL

复制管理对象 (RMO)

使用 SQL Server Management Studio

可在新建订阅向导的 “同步计划” 页上指定同步计划。有关访问此向导的详细信息，请参阅 Create a Push Subscription 和 Create a Pull Subscription。

在“作业日程安排属性”对话框中修改同步计划，该对话框位于 SQL Server Management Studio 的“作业”文件夹和复制监视器的代理详细信息窗口中。有关启动复制监视器的信息，请参阅启动复制监视器。

如果从 “作业” 文件夹指定计划，请使用下表确定代理作业的名称。

Agent	作业名称
请求订阅的合并代理	<发布服务器>-<发布数据库>-<发布>-<订阅服务器>-<订阅数据库>-<整数>
推送订阅的合并代理	<发布服务器>-<发布数据库>-<发布>-<订阅服务器>-<整数>
推送订阅的分发代理	<发布服务器>-<发布数据库>-<发布>-<订阅服务器>-<整数> ¹
请求订阅的分发代理	<发布服务器>-<发布数据库>-<发布>-<订阅服务器>-<订阅数据库>-<GUID> ²
非 SQL Server 订阅服务器的推送订阅的分发代理	<发布服务器>-<发布数据库>-<发布>-<订阅服务器>-<整数>

¹ 对于 Oracle 发布的推送订阅，它是“<发布服务器>-<发布服务器>”而不是“<发布服务器>-<发布数据库>”

² 对于 Oracle 发布的请求订阅，它是“<发布服务器>-<分发数据库>”而不是“<发布服务器>-<发布数据库>”

指定同步计划

在新建订阅向导的“同步计划”页上，从“代理计划”下拉列表中为要创建的每个订阅选择以下值之一：
- 连续运行
- 仅按需运行
- <定义安排...>
如果选择“<定义安排...>”，请在“作业日程安排属性”对话框中指定一个计划，然后单击“确定”。
完成向导。

在复制监视器中修改推送订阅的同步计划

在复制监视器的左窗格中依次展开发布服务器组、发布服务器，然后单击某个发布。
单击 “所有订阅” 选项卡。
右键单击订阅，然后单击 “查看详细信息”。
在“订阅 < 订阅名>”窗口中，单击“操作”，然后单击“<代理名> 作业属性”。
在“作业属性 - <作业名>”对话框的“安排”页上，单击“编辑”。
在 “作业计划属性” 对话框中，从 “计划类型” 下拉列表中选择一个值：
- 若要指定代理应连续运行，请选择 “SQL Server 代理启动时自动启动”。
- 若要指定代理应按计划运行，请选择 “重复执行”。
- 若要指定代理应按需运行，请选择 “执行一次”。
如果选择 “重复执行”，请为代理指定计划。
选择“确定”。

在 Management Studio 中修改推送订阅的同步计划

在 Management Studio 中连接到分发服务器，然后展开服务器节点。
展开 “SQL Server 代理” 文件夹，再展开 “作业” 文件夹。
右键单击与订阅相关联的分发代理或合并代理的作业，再单击 “属性”。
在“作业属性 - <作业名>”对话框的“安排”页上，单击“编辑”。
在 “作业计划属性” 对话框中，从 “计划类型” 下拉列表中选择一个值：
- 若要指定代理应连续运行，请选择 “SQL Server 代理启动时自动启动”。
- 若要指定代理应按计划运行，请选择 “重复执行”。
- 若要指定代理应按需运行，请选择 “执行一次”。
如果选择 “重复执行”，请为代理指定计划。
选择“确定”。

在 Management Studio 中修改请求订阅的同步计划

在 Management Studio 中连接到订阅服务器，然后展开服务器节点。
展开 “SQL Server 代理” 文件夹，再展开 “作业” 文件夹。
右键单击与订阅相关联的分发代理或合并代理的作业，再单击 “属性”。
在“作业属性 - <作业名>”对话框的“安排”页上，单击“编辑”。
在 “作业计划属性” 对话框中，从 “计划类型” 下拉列表中选择一个值：
- 若要指定代理应连续运行，请选择 “SQL Server 代理启动时自动启动”。
- 若要指定代理应按计划运行，请选择 “重复执行”。
- 若要指定代理应按需运行，请选择 “执行一次”。
如果选择 “重复执行”，请为代理指定计划。
选择“确定”。

“使用 Transact-SQL”

您可以使用复制存储过程以编程的方式定义同步计划。所使用的存储过程取决于复制类型和订阅类型（请求或推送）。

计划由以下计划参数定义，而计划的行为从 sp_add_schedule (Transact-SQL) 继承：

@frequency_type - 计划代理时所用的频率类型。
@frequency_interval - 星期几运行代理。
@frequency_relative_interval - 计划每月运行代理的给定月份的星期。
@frequency_recurrence_factor - 同步之间发生的频率类型单位数值。
@frequency_subday - 一天内多次运行代理时的频率单位。
@frequency_subday_interval - 一天内多次运行代理时运行之间的频率单位数值。
@active_start_time_of_day - 在给定日将要开始运行代理的最早时间。
@active_end_time_of_day - 在给定日将要开始运行代理的最晚时间。
@active_start_date - 代理计划生效的第一天。
@active_end_date - 代理计划生效的最后一天。

为事务发布的请求订阅定义同步计划

对事务发布创建一个新的请求订阅。有关详细信息，请参阅创建请求订阅。
在订阅服务器上，执行 sp_addpullsubscription_agent (Transact-SQL)。指定 @publisher、@publisher_db 和 @publication，并为 @job_name 和 @password 指定订阅服务器的分发代理运行时使用的 Microsoft Windows 凭据。指定上面详细说明的同步参数，为同步订阅的分发代理作业定义计划。

为事务发布的推送订阅定义同步计划

对事务发布创建一个新的推送订阅。有关详细信息，请参阅创建推送订阅。
在订阅服务器上，执行 sp_addpushsubscription_agent (Transact-SQL)。指定 @subscriber、 @subscriber_db和 @publication，并为 @job_name 和 @password指定分发服务器的分发代理运行时使用的 Windows 凭据。指定上面详细说明的同步参数，为同步订阅的分发代理作业定义计划。

为合并发布的请求订阅定义同步计划

对合并发布创建一个新的请求订阅。有关详细信息，请参阅创建请求订阅。
在订阅服务器上，执行 sp_addmergepullsubscription_agent。指定 @publisher、 @publisher_db和 @publication，并为 @job_name 和 @password指定订阅服务器的合并代理运行时使用的 Windows 凭据。指定上面详细说明的同步参数，为同步订阅的合并代理作业定义计划。

为合并发布的推送订阅定义同步计划

对合并发布创建一个新的推送订阅。有关详细信息，请参阅创建推送订阅。
在订阅服务器上，执行 sp_addmergepushsubscription_agent。指定 @subscriber、 @subscriber_db和 @publication，并为 @job_name 和 @password指定分发服务器的合并代理运行时使用的 Windows 凭据。指定上面详细说明的同步参数，为同步订阅的合并代理作业定义计划。

使用复制管理对象 (RMO)

复制使用 SQL Server 代理为定期发生的活动计划作业（如快照生成和订阅同步）。可以编程的方式使用复制管理对象 (RMO) 为复制代理作业指定计划。

注意

创建一个订阅并将 false （请求订阅的默认行为）的值指定为 CreateSyncAgentByDefault 时，不会创建代理作业，并忽略计划属性。在这种情况下，必须由应用程序确定同步计划。有关详细信息，请参阅 Create a Pull Subscription 和 Create a Push Subscription。

在创建事务发布的推送订阅时定义一个复制代理计划

为要创建的订阅创建一个 TransSubscription 类的实例。有关详细信息，请参阅创建推送订阅。
在调用 Create之前，设置 AgentSchedule 属性的下列一个或多个字段：
- FrequencyType - 计划代理时所使用的频率类型（如每天或每周）。
- FrequencyInterval - 星期几运行代理。
- FrequencyRelativeInterval - 计划每月运行代理的给定月份的星期。
- FrequencyRecurrenceFactor - 同步之间发生的频率类型单位数值。
- FrequencySubDay - 一天内多次运行代理时的频率单位。
- FrequencySubDayInterval - 一天内多次运行代理时运行之间的频率单位数值。
- ActiveStartTime - 在给定日期内代理运行开始的最早时间。
- ActiveEndTime - 在给定日期内代理运行开始的最晚时间。
- ActiveStartDate - 代理计划有效的起始日期。
- ActiveEndDate - 代理计划有效的结束日期。
注意

如果未指定上述某个属性，将设置为默认值。
调用 Create 方法创建订阅。

在创建事务发布的请求订阅时定义一个复制代理计划

为要创建的订阅创建一个 TransPullSubscription 类的实例。有关详细信息，请参阅创建请求订阅。
在调用 Create之前，设置 AgentSchedule 属性的下列一个或多个字段：
- FrequencyType - 计划代理时所使用的频率类型（如每天或每周）。
- FrequencyInterval - 星期几运行代理。
- FrequencyRelativeInterval - 计划每月运行代理的给定月份的星期。
- FrequencyRecurrenceFactor - 同步之间发生的频率类型单位数值。
- FrequencySubDay - 一天内多次运行代理时的频率单位。
- FrequencySubDayInterval - 一天内多次运行代理时运行之间的频率单位数值。
- ActiveStartTime - 在给定日期内代理运行开始的最早时间。
- ActiveEndTime - 在给定日期内代理运行开始的最晚时间。
- ActiveStartDate - 代理计划有效的起始日期。
- ActiveEndDate - 代理计划有效的结束日期。
注意

如果未指定上述某个属性，将设置为默认值。
调用 Create 方法创建订阅。

在创建合并发布的请求订阅时定义一个复制代理计划

为要创建的订阅创建一个 MergePullSubscription 类的实例。有关详细信息，请参阅创建请求订阅。
在调用 Create之前，设置 AgentSchedule 属性的下列一个或多个字段：
- FrequencyType - 计划代理时所使用的频率类型（如每天或每周）。
- FrequencyInterval - 星期几运行代理。
- FrequencyRelativeInterval - 计划每月运行代理的给定月份的星期。
- FrequencyRecurrenceFactor - 同步之间发生的频率类型单位数值。
- FrequencySubDay - 一天内多次运行代理时的频率单位。
- FrequencySubDayInterval - 一天内多次运行代理时运行之间的频率单位数值。
- ActiveStartTime - 在给定日期内代理运行开始的最早时间。
- ActiveEndTime - 在给定日期内代理运行开始的最晚时间。
- ActiveStartDate - 代理计划有效的起始日期。
- ActiveEndDate - 代理计划有效的结束日期。
注意

如果未指定上述某个属性，将设置为默认值。
调用 Create 方法创建订阅。

在创建合并发布的推送订阅时定义一个复制代理计划

为要创建的订阅创建一个 MergeSubscription 类的实例。有关详细信息，请参阅创建推送订阅。
在调用 Create之前，设置 AgentSchedule 属性的下列一个或多个字段：
- FrequencyType - 计划代理时所使用的频率类型（如每天或每周）。
- FrequencyInterval - 星期几运行代理。
- FrequencyRelativeInterval - 计划每月运行代理的给定月份的星期。
- FrequencyRecurrenceFactor - 同步之间发生的频率类型单位数值。
- FrequencySubDay - 一天内多次运行代理时的频率单位。
- FrequencySubDayInterval - 一天内多次运行代理时运行之间的频率单位数值。
- ActiveStartTime - 在给定日期内代理运行开始的最早时间。
- ActiveEndTime - 在给定日期内代理运行开始的最晚时间。
- ActiveStartDate - 代理计划有效的起始日期。
- ActiveEndDate - 代理计划有效的结束日期。
注意

如果未指定上述某个属性，将设置为默认值。
调用 Create 方法创建订阅。

示例 (RMO)

此示例创建一个合并发布的推送订阅并指定同步订阅计划。

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

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

// 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 = "AdventureWorks2022Replica"
Dim publicationDbName As String = "AdventureWorks2022"
Dim hostname As String = "adventure-works\garrett1"

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

' 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

另请参阅

复制安全最佳做法
 Subscribe to Publications
同步推送订阅
 同步请求订阅
 同步数据

通过

指定同步计划

使用 SQL Server Management Studio

指定同步计划

在复制监视器中修改推送订阅的同步计划

在 Management Studio 中修改推送订阅的同步计划

在 Management Studio 中修改请求订阅的同步计划

“使用 Transact-SQL”

为事务发布的请求订阅定义同步计划

为事务发布的推送订阅定义同步计划

为合并发布的请求订阅定义同步计划

为合并发布的推送订阅定义同步计划

使用复制管理对象 (RMO)

在创建事务发布的推送订阅时定义一个复制代理计划

在创建事务发布的请求订阅时定义一个复制代理计划

在创建合并发布的请求订阅时定义一个复制代理计划

在创建合并发布的推送订阅时定义一个复制代理计划

示例 (RMO)

另请参阅

反馈

其他资源