配置快照属性(复制 Transact-SQL 编程)

适用于:SQL Server Azure SQL 托管实例

可以使用复制存储过程以编程方式定义和修改快照属性,使用的存储过程取决于发布的类型。

在创建快照发布或事务发布时配置快照属性

  1. 在发布服务器上,执行 sp_addpublication。 为 @publication 指定发布名称,为 @repl_freq 指定指定 snapshot 值或 continuous 值,并指定一个或多个以下与快照相关的参数

    • @alt_snapshot_folder - 如果此发布的快照可从某位置访问,而不是或者也能从快照的默认文件夹访问,则指定相应路径。
    • @compress_snapshot - 如果备用快照文件夹内的快照文件压缩于 Microsoft CAB 文件格式中,则指定“true”值。
    • @pre_snapshot_script - 指定在初始快照应用之前的初始化过程中将在订阅服务器上执行的 .sql 文件的文件名和完整路径
    • @post_snapshot_script - 指定在初始快照应用之后的初始化过程中将在订阅服务器上执行的 .sql 文件的文件名和完整路径
    • @snapshot_in_defaultfolder - 如果快照仅在非默认位置可用,则指定 false 值

    有关创建发布的详细信息,请参阅 Create a Publication

创建合并发布时配置快照属性

  1. 在发布服务器上,执行 sp_addmergepublication。 为 @publication 指定发布名称,为 @repl_freq 指定指定 snapshot 值或 continuous 值,并指定一个或多个以下与快照相关的参数

    • @alt_snapshot_folder - 如果此发布的快照可从某位置访问,而不是或者也能从快照的默认文件夹访问,则指定相应路径。
    • @compress_snapshot - 如果备用快照文件夹内的快照文件压缩于 CAB 文件格式中,则指定 true 值
    • @pre_snapshot_script - 指定在初始快照应用之前的初始化过程中将在订阅服务器上执行的 .sql 文件的文件名和完整路径
    • @post_snapshot_script - 指定在初始快照应用之后的初始化过程中将在订阅服务器上执行的 .sql 文件的文件名和完整路径
    • @snapshot_in_defaultfolder - 如果快照仅在非默认位置可用,则指定 false 值
  2. 有关创建发布的详细信息,请参阅 Create a Publication

修改现有快照发布或事务发布的快照属性

  1. 在发布服务器上,对发布数据库执行 sp_changepublication。 为 @force_invalidate_snapshot 指定 1 值,并为 @property 指定以下值之一

    • alt_snapshot_folder - 同样为 @value 指定备用快照文件夹的新路径。
    • compress_snapshot - 同样为 @value 指定 true 值或 false 值,以表明备用快照文件夹内的快照文件是否为 CAB 文件格式的压缩文件
    • pre_snapshot_script - 同样为 @value 指定在初始快照应用之前的初始化过程中将在订阅服务器上执行的 .sql 文件的文件名和完整路径
    • post_snapshot_script - 同样为 @value 指定在初始快照应用之后的初始化过程中将在订阅服务器上执行的 .sql 文件的文件名和完整路径
    • snapshot_in_defaultfolder - 也将值指定为 truefalse ,以指示快照是否仅在非默认位置可用。
  2. (可选)在发布服务器上,对发布数据库执行 sp_changepublication_snapshot。 指定 @publication 以及将要更改的一个或多个计划或安全凭据参数。

    重要

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

  3. 在命令提示符处运行 Replication Snapshot Agent 或启动快照代理作业以生成新的快照。 有关详细信息,请参阅 创建并应用初始快照

修改现有合并发布的快照属性

  1. 在发布服务器上,对发布数据库执行 sp_changemergepublication。 为 @force_invalidate_snapshot 指定 1 值,并为 @property** 指定以下值之一

    • alt_snapshot_folder - 同样为 @value 指定备用快照文件夹的新路径。
    • compress_snapshot - 同样为 @value 指定 true 值或 false 值,以表明备用快照文件夹内的快照文件是否为 CAB 文件格式的压缩文件
    • pre_snapshot_script - 同样为 @value 指定在初始快照应用之前的初始化过程中将在订阅服务器上执行的 .sql 文件的文件名和完整路径
    • post_snapshot_script - 同样为 @value 指定在初始快照应用之后的初始化过程中将在订阅服务器上执行的 .sql 文件的文件名和完整路径
    • snapshot_in_defaultfolder - 也将值指定为 truefalse ,以指示快照是否仅在非默认位置可用。
  2. 在命令提示符处运行 Replication Snapshot Agent 或启动快照代理作业以生成新的快照。 有关详细信息,请参阅 创建并应用初始快照

示例

此示例创建一个使用备用快照文件夹和压缩快照的发布。

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). 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".

--Declarations for adding a merge publication
DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @article AS sysname;
DECLARE @owner AS sysname;
DECLARE @snapshot_share AS sysname;
SET @publicationDB = N'AdventureWorks2022'; 
SET @publication = N'AdvWorksSalesOrdersMergeAltSnapshot'; 
SET @article = N'SpecialOffer';
SET @owner = N'Sales';
SET @snapshot_share = '\\' + $(InstanceName) + '\AltSnapshotFolder';

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

-- Create new merge publication with an alternate snapshot location. 
USE [AdventureWorks]
EXEC sp_addmergepublication 
-- required parameters
    @publication = @publication, 
    @snapshot_in_defaultfolder = N'false',
    @alt_snapshot_folder = @snapshot_share,
    @compress_snapshot = N'true';

-- Create the snapshot job for the publication.
EXEC sp_addpublication_snapshot 
    @publication = @publication,
    @job_login = $(Login),
    @job_password = $(Password);

-- Add an article.
EXEC sp_addmergearticle 
    @publication = @publication, 
    @article = @article, 
    @source_object = @article, 
    @type = N'table', 
    @source_owner = @owner, 
    @destination_owner = @owner;

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

另请参阅

修改快照选项
在应用快照之前和之后执行脚本
Replication System Stored Procedures Concepts
通过 FTP 传输快照
更改发布和项目属性