创建并应用初始快照

适用于:SQL ServerAzure SQL 托管实例

本文描述了如何使用SQL Server Management Studio、Transact-SQL或复制管理对象(RMO)在SQL Server中创建并应用初始快照。 使用参数化筛选器的合并发布需要两部分快照。 有关详细信息,请参阅 为包含参数化筛选器的合并发布创建快照。
创建发布后,快照代理会生成快照。 你可以生成快照:

  • 立即。 默认情况下,新发布向导在创建合并出版物后立即生成快照。
  • 在预定时间。 在新建发布向导的快照代理页面上指定计划,或在使用存储过程或复制管理对象 (RMO) 时指定计划。
  • 手动。 从命令提示符或 SQL Server Management Studio 运行快照代理。 有关运行代理的详细信息,请参阅复制代理可执行文件概念及启动和停止复制代理 (SQL Server Management Studio)。

对于合并复制,快照代理 每次运行都会生成一个快照。 对于事务复制,快照生成依赖于发布属性 immediate_sync的设置。 如果属性设置为 TRUE(使用新发布向导时的默认值),快照代理 每次运行都会生成快照,并且可以随时将快照应用给订阅者。 如果该属性设置为 FALSE(使用sp_addpublication时默认),快照代理 只有在自上次 快照代理 运行以来新增订阅时才会生成快照;订阅者必须等待快照代理完成后才能同步。

默认情况下,快照代理 将生成的快照保存在分发器上的默认快照文件夹中。 你还可以将快照文件保存在可移动介质上,如可移动磁盘、CD-ROM,或存储在默认快照文件夹以外的位置。 你还可以压缩文件,使其更易于存储和传输,并在 快照代理 向订阅者应用快照之前或之后执行脚本。 有关这些选项的详细信息,请参阅 Snapshot Options。

如果快照是针对使用参数化过滤器的合并发布,快照代理 通过两部分过程创建快照。 首先,它创建一个包含复制脚本和已发布对象模式的模式快照,但不包含数据。 每个订阅随后都会使用一个快照进行初始化,该快照包含从架构快照复制的脚本和架构,以及属于该订阅分区的数据。 有关详细信息,请参阅带参数化筛选条件的合并发布快照。

快照代理在Publisher创建快照并将其存储在默认或备用快照位置后,你可以将快照传输给订阅者并应用。 分发代理(用于快照或事务复制)或 合并代理(用于合并复制)在初始同步时传输快照并将模式和数据文件应用到订阅者的订阅数据库。 默认情况下,如果你使用新订阅向导,初始同步会在创建订阅后立即发生。 向导的“初始化订阅”页面上的“初始化时”选项控制此行为。 当快照代理在订阅初始化后生成快照时,除非你标记了重新初始化的订阅,否则它不会将其应用到订阅者。 有关详细信息,请参阅 重新初始化订阅。

在分发代理或合并代理应用初始快照后,该代理将传播后续更新和其他数据修改。 在向订阅服务器分发并应用快照时,只有那些正在等待初始快照或新建快照的订阅服务器会受到影响。 该出版物的其他订阅者(那些已经收到插入、更新、删除或其他已发布数据修改的订阅者)不受影响。

若要查看或修改默认快照文件夹位置,请参阅

默认快照位置

可以在配置分发向导的 “快照文件夹” 页上指定默认快照位置。 有关使用此向导的详细信息,请参阅配置发布和分发。 如果在未配置为分发服务器的服务器上创建发布,请在新建发布向导的 “快照文件夹” 页上指定默认快照位置。 有关使用此向导的详细信息,请参阅创建发布。

在 “分发服务器属性 - <分发服务器>” 对话框的 “发布服务器” 页上修改默认快照位置。 有关详细信息,请参阅查看和修改分发服务器和发布服务器属性。 在“发布属性 - <发布>”对话框中设置每个发布的快照文件夹。 有关详细信息,请参阅 View and Modify Publication Properties。

修改默认快照位置

  1. 在 “分发服务器属性 - >分发服务器”对话框的 < 页面上,对于要更改其默认快照文件夹位置的发布服务器,选择其属性按钮(...)。

  2. 在“分发服务器属性 - <分发服务器>”对话框中,为“默认快照文件夹”属性输入一个值。

    注意

    快照代理需要你指定的目录的写权限,而分发代理或合并代理则需要读取权限。 如果你使用拉取订阅,必须指定共享目录作为通用命名规范(UNC)路径,例如 \\computername\snapshot。 有关详细信息,请参阅保护快照文件夹。

  3. 选择“确定”。

创建快照

默认情况下,如果 SQL Server 代理 正在运行,快照代理 会在你通过新发布向导创建发布后立即生成快照。 默认情况下,分发代理(分发代理,用于快照复制和事务复制)或合并代理(合并代理,用于合并订阅)随后会将该快照应用于所有订阅。 你也可以使用 SQL Server Management Studio 和 Replication Monitor 生成快照。 有关启动复制监视器的信息,请参阅启动复制监视器。

使用 SQL Server Management Studio

  1. 在 Management Studio 中连接到发布服务器,然后展开群集节点。
  2. 展开 “复制” 文件夹,再展开 “本地发布” 文件夹。
  3. 右键点击你想创建快照的出版物,然后选择“查看 快照代理 Status”。
  4. 在“查看 快照代理 状态 - <发布>”对话框中,选择开始。
    当快照代理生成快照后,会显示一条消息,例如“[100%] 已生成17篇文章的快照。”

在复制监视器中

  1. 在“复制监视器”中,展开左侧窗格中的发布者组,然后展开某个发布者。
  2. 右键点击你想生成快照的出版物,然后选择 “生成快照”。
  3. 要查看 快照代理 的状态,请选择 Agents 标签。如需更详细的信息,请在网格中右键点击 快照代理,然后选择查看详情。

“使用 Transact-SQL”

您可以通过创建并运行 快照代理 作业,或从批处理文件运行 快照代理 可执行文件,从而通过程序创建初始快照。 生成初始快照后,首次同步订阅时会将其传输到订阅服务器并在该服务器上应用。 如果你从命令提示符或批处理文件运行 快照代理,当现有快照失效时需要重新运行该代理。

重要

如果可能,请在运行时提示用户输入安全凭据。 如果必须将凭据存储在脚本文件中,请确保该文件的安全以防受到未经授权的访问。

  1. 创建快照发布、事务发布或合并发布。 有关详细信息,请参阅 Create a Publication。

  2. 执行 sp_addpublication_snapshot (Transact-SQL)。 指定 @publication 以及下列参数:

    • @job_login ,用于指定快照代理在分发服务器上运行时所用的 Windows 身份验证凭据。

    • @job_password,即所提供的 Windows 凭据的密码。

    • (可选)如果代理在连接Publisher时使用SQL Server认证,则@publisher_security_mode值为0。 在这种情况下,您还必须为 @publisher_login 和 @publisher_password指定 SQL Server 身份验证的登录信息。

    • (可选)快照代理作业的同步计划。 有关更多信息,请参阅指定同步计划。

    重要

    当你用远程分发器配置Publisher时,你提供的所有参数(包括job_login和job_password)的数值都会以纯文本形式发送给分发器。 在执行此存储过程之前,先加密 Publisher 与其远程分发商之间的连接。 有关详细信息,请参阅启用数据库引擎的加密连接(SQL Server 配置管理器)。

  3. 将文章添加到出版物中。 有关详细信息,请参阅 定义项目。

  4. 在发布服务器上,对发布数据库执行 sp_startpublication_snapshot (Transact-SQL),并指定步骤 1 中 @publication 的值。

应用快照

使用 SQL Server Management Studio

快照生成后,将订阅与 分发代理 或 合并代理 同步以应用:

  • 如果代理连续运行(交易复制的默认情况),生成快照后会自动应用。

  • 如果代理按计划运行,它会在下次运行时应用快照。

  • 如果代理按需运行,它会在你下次运行它时应用该快照。

    有关同步订阅的更多信息,请参阅同步推送订阅和同步请求订阅。

使用 Transact-SQL

  1. 创建快照发布、事务发布或合并发布。 有关详细信息,请参阅 Create a Publication。

  2. 将文章添加到出版物中。 有关详细信息,请参阅 定义项目。

  3. 在命令提示符处或在批处理文件中,通过运行 snapshot.exe 并指定以下命令行参数来启动 复制快照代理:

    • -发布
    • -Publisher
    • -分销商
    • -PublisherDB
    • -ReplicationType

    如果你使用SQL Server认证,也请指定以下参数:

    • -DistributorLogin
    • -DistributorPassword
    • -DistributorSecurityMode = 0
    • -PublisherLogin
    • -PublisherPassword
    • -PublisherSecurityMode = 0

示例 (Transact-SQL)

此示例演示如何创建事务发布,并为新的发布添加快照代理作业(使用 sqlcmd 脚本变量)。 该示例还会启动作业。

-- To avoid storing the login and password in the script file, the values 
-- are passed into SQLCMD as scripting variables. For information about 
-- how to use scripting variables on the command line and in SQL Server
-- Management Studio, see the "Executing Replication Scripts" section in
-- the topic "Programming Replication Using System Stored Procedures".

DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'AdventureWorks2022'; --publication database
SET @publication = N'AdvWorksCustomerTran'; -- transactional publication name
SET @login = $(Login);
SET @password = $(Password);

USE [AdventureWorks]

-- Enable transactional and snapshot replication on the publication database.
EXEC sp_replicationdboption 
  @dbname = @publicationDB, 
  @optname = N'publish',
  @value = N'true';

-- Execute sp_addlogreader_agent to create the agent job. 
EXEC sp_addlogreader_agent 
  @job_login = @login, 
  @job_password = @password,
  -- Explicitly specify the security mode used when connecting to the Publisher.
  @publisher_security_mode = 1;

-- Create new transactional publication, using the defaults. 
USE [AdventureWorks2022]
EXEC sp_addpublication 
  @publication = @publication, 
  @description = N'transactional publication';

-- Create a new snapshot job for the publication, using the defaults.
EXEC sp_addpublication_snapshot 
  @publication = @publication,
  @job_login = @login,
  @job_password = @password;

-- Start the Snapshot Agent job.
EXEC sp_startpublication_snapshot @publication = @publication;
GO

此示例创建合并发布,并为该发布添加一个快照代理作业(使用 sqlcmd 变量)。 此示例还会启动作业。

-- To avoid storing the login and password in the script file, the value 
-- is passed into SQLCMD as a scripting variable. For information about 
-- how to use scripting variables on the command line and in SQL Server
-- Management Studio, see the "Executing Replication Scripts" section in
-- the topic "Programming Replication Using System Stored Procedures".

DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'AdventureWorks2022'; 
SET @publication = N'AdvWorksSalesOrdersMerge'; 
SET @login = $(Login);
SET @password = $(Password);

-- Enable merge replication on the publication database.
USE master
EXEC sp_replicationdboption 
  @dbname = @publicationDB, 
  @optname=N'merge publish',
  @value = N'true';

-- Create new merge publication, using the defaults. 
USE [AdventureWorks]
EXEC sp_addmergepublication 
  @publication = @publication, 
  @description = N'Merge publication.';

-- Create a new snapshot job for the publication, using the defaults.
EXEC sp_addpublication_snapshot 
  @publication = @publication,
  @job_login = @login,
  @job_password = @password;

-- Start the Snapshot Agent job.
EXEC sp_startpublication_snapshot @publication = @publication;
GO

以下命令行参数用于启动快照代理,为合并发布生成快照。

注意

为便于阅读,添加了换行符。 在批处理文件中,你必须在一行内执行命令。

  
REM -- Declare variables  
SET Publisher=%InstanceName%  
SET PublicationDB=AdventureWorks2022   
SET Publication=AdvWorksSalesOrdersMerge   
  
REM --Start the Snapshot Agent to generate the snapshot for AdvWorksSalesOrdersMerge.  
"C:\Program Files\Microsoft SQL Server\120\COM\SNAPSHOT.EXE" -Publication %Publication%   
-Publisher %Publisher% -Distributor %Publisher% -PublisherDB %PublicationDB%   
-ReplicationType 2 -OutputVerboseLevel 1 -DistributorSecurityMode 1  
  

使用复制管理对象 (RMO)

在创建发布后,快照代理 会生成快照。 您可以通过复制管理对象(RMO)并直接访问复制代理功能的托管代码,程序生成这些快照。 所使用的对象取决于复制的类型。 你可以通过使用SnapshotGenerationAgent对象同步启动 快照代理,也可以通过使用代理作业进行异步启动。 初始快照生成后,快照代理 将其传输给订阅者,并在订阅首次同步时应用。 当现有快照不再包含有效的最新数据时,你需要重新运行该代理程序。 有关更多信息,请参阅 维护出版物。

重要

如果可能,请在运行时提示用户输入安全凭据。 如果必须存储凭据,请使用 Microsoft Windows .NET Framework 提供的加密服务。

通过启动快照代理作业,为快照发布或事务发布生成初始快照(异步)

  1. 使用 ServerConnection 类创建与发布服务器的连接。

  2. 创建 TransPublication 类的一个实例。 设置发布的 Name 和 DatabaseName 属性,并将 ConnectionContext 属性设置为步骤 1 中创建的连接。

  3. 调用 LoadProperties 方法以加载该对象的其余属性。 如果该方法返回 为假,说明步骤2的发布属性定义错误,或者发布不存在。

  4. 如果 SnapshotAgentExists 的值为 false,请调用 CreateSnapshotAgent 为此发布创建快照代理作业。

  5. 调用 StartSnapshotGenerationAgentJob 方法以启动为此发布生成快照的代理作业。

  6. (可选)当 SnapshotAvailable 的值为 true 时,该快照可供订阅者使用。

通过运行快照代理,为快照发布或事务发布生成初始快照(同步)

  1. 创建 SnapshotGenerationAgent 类的实例,并设置下列所需属性:

  2. 将 Transactional 的值设置为 Snapshot 或 ReplicationType。

  3. 调用 GenerateSnapshot 方法。

通过启动快照代理作业(异步)来为合并发布生成初始快照

  1. 使用 ServerConnection 类创建与发布服务器的连接。

  2. 创建 MergePublication 类的一个实例。 设置发布的 Name 和 DatabaseName 属性,并将 ConnectionContext 属性设置为步骤 1 中创建的连接。

  3. 调用 LoadProperties 方法以加载该对象的其余属性。 如果该方法返回 为假,说明步骤2的发布属性定义错误,或者发布不存在。

  4. 如果 SnapshotAgentExists 的值为 false,请调用 CreateSnapshotAgent 为此发布创建快照代理作业。

  5. 调用 StartSnapshotGenerationAgentJob 方法以启动为此发布生成快照的代理作业。

  6. (可选)当 SnapshotAvailable 的值为 true 时,该快照可供订阅者使用。

通过运行快照代理(同步)为合并发布生成初始快照

  1. 创建 SnapshotGenerationAgent 类的实例,并设置下列所需属性:

  2. 将 Merge 的值设置为 ReplicationType。

  3. 调用 GenerateSnapshot 方法。

示例 (RMO)

此示例同步运行快照代理,为事务发布生成初始快照。

// Set the Publisher, publication database, and publication names.
string publicationName = "AdvWorksProductTran";
string publicationDbName = "AdventureWorks2022";
string publisherName = publisherInstance;
string distributorName = publisherInstance;

SnapshotGenerationAgent agent;

try
{
    // Set the required properties for Snapshot Agent.
    agent = new SnapshotGenerationAgent();
    agent.Distributor = distributorName;
    agent.DistributorSecurityMode = SecurityMode.Integrated;
    agent.Publisher = publisherName;
    agent.PublisherSecurityMode = SecurityMode.Integrated;
    agent.Publication = publicationName;
    agent.PublisherDatabase = publicationDbName;
    agent.ReplicationType = ReplicationType.Transactional;

    // Start the agent synchronously.
    agent.GenerateSnapshot();

}
catch (Exception ex)
{
    // Implement custom application error handling here.
    throw new ApplicationException(String.Format(
        "A snapshot could not be generated for the {0} publication."
        , publicationName), ex);
}
' Set the Publisher, publication database, and publication names.
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2022"
Dim publisherName As String = publisherInstance
Dim distributorName As String = publisherInstance

Dim agent As SnapshotGenerationAgent

Try
    ' Set the required properties for Snapshot Agent.
    agent = New SnapshotGenerationAgent()
    agent.Distributor = distributorName
    agent.DistributorSecurityMode = SecurityMode.Integrated
    agent.Publisher = publisherName
    agent.PublisherSecurityMode = SecurityMode.Integrated
    agent.Publication = publicationName
    agent.PublisherDatabase = publicationDbName
    agent.ReplicationType = ReplicationType.Transactional

    ' Start the agent synchronously.
    agent.GenerateSnapshot()

Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
     "A snapshot could not be generated for the {0} publication." _
     , publicationName), ex)
End Try

此示例异步启动代理作业,为事务发布生成初始快照。

// Set the Publisher, publication database, and publication names.
string publicationName = "AdvWorksProductTran";
string publicationDbName = "AdventureWorks2022";
string publisherName = publisherInstance;

TransPublication publication;

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

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

    // Set the required properties for an existing publication.
    publication = new TransPublication();
    publication.ConnectionContext = conn;
    publication.Name = publicationName;
    publication.DatabaseName = publicationDbName;

    if (publication.LoadProperties())
    {
        // Start the Snapshot Agent job for the publication.
        publication.StartSnapshotGenerationAgentJob();
    }
    else
    {
        throw new ApplicationException(String.Format(
            "The {0} publication does not exist.", publicationName));
    }
}
catch (Exception ex)
{
    // Implement custom application error handling here.
    throw new ApplicationException(String.Format(
        "A snapshot could not be generated for the {0} publication."
        , publicationName), ex);
}
finally
{
    conn.Disconnect();
}
' Set the Publisher, publication database, and publication names.
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2022"
Dim publisherName As String = publisherInstance

Dim publication As TransPublication

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

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

    ' Set the required properties for an existing publication.
    publication = New TransPublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    If publication.LoadProperties() Then
        ' Start the Snapshot Agent job for the publication.
        publication.StartSnapshotGenerationAgentJob()
    Else
        Throw New ApplicationException(String.Format( _
         "The {0} publication does not exist.", publicationName))
    End If
Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
     "A snapshot could not be generated for the {0} publication." _
     , publicationName), ex)
Finally
    conn.Disconnect()
End Try

应用初始快照时发生阻塞

如果你有多家出版物在订阅者那里将数据发布到同一个数据库,你会注意到在应用初始快照时,只有一个出版物能同时应用其快照。

在查看 SQL 活动时,你可能会看到如下所示的等待资源:

APP: 18:16384:[snapshot_delivery_in_progress_Tr]:(9bcdaf92)
应用:5:16384:[snapshot_delivery_in_progress_Er]:(3c3b7db9
)

查询锁定行为时,可能会显示如下所示的类似资源:

APP 16384:[appname]:(fbe42d68) XAPP 16384:[snapshot_del]:(9bcdaf92) X

此行为是特意这样设计的。 之所以发生这种情况,是因为应用程序锁用于防止多个复制代理同时将不同发布的快照应用于同一订阅服务器数据库。 由于应用锁包含订阅者数据库的名称,任何发布到同一订阅者数据库的出版物都会受到影响。 结果是,在给定时间只能将一个快照插入到订阅服务器数据库中。

在这种情况下,使用排他锁来帮助避免复制代理彼此之间出现死锁现象的可能性。

若要解决此问题,可为每个发布指定不同的订阅数据库。