复制快照代理是一个可执行文件，它可用于准备包含已发布表和数据库对象的架构与数据的快照文件，将这些文件存储在快照文件夹中，并在分发数据库中记录同步作业。
注意
- 可以按任意顺序指定参数。
注意
对于快照复制和事务复制，Azure SQL 托管实例可以是发布服务器、分发服务器和订阅服务器。 对于快照复制和事务复制，Azure SQL 数据库中的数据库只能是推送订阅服务器。 有关详细信息，请参阅使用 Azure SQL 数据库和 Azure SQL 托管实例进行事务复制。
语法
snapshot [ -?]
-Publisher server_name[\instance_name]
-Publication publication_name
[-70Subscribers]
[-BcpBatchSize bcp_batch_size]
[-DefinitionFile def_path_and_file_name]
[-Distributor server_name[\instance_name]]
[-DistributorDeadlockPriority [-1|0|1] ]
[-DistributorLogin distributor_login]
[-DistributorPassword distributor_password]
[-DistributorSecurityMode [0|1] ]
[-DynamicFilterHostName dynamic_filter_host_name]
[-DynamicFilterLogin dynamic_filter_login]
[-DynamicSnapshotLocation dynamic_snapshot_location]
[-EncryptionLevel [0|1|2|3|4]]
[-FieldDelimiter field_delimiter]
[-HistoryVerboseLevel [0|1|2|3] ]
[-HRBcpBlocks number_of_blocks ]
[-HRBcpBlockSize block_size ]
[-HRBcpDynamicBlocks ]
[-KeepAliveMessageInterval keep_alive_interval]
[-LoginTimeOut login_time_out_seconds]
[-MaxBcpThreads number_of_threads ]
[-MaxNetworkOptimization [0|1]]
[-Output output_path_and_file_name]
[-OutputVerboseLevel [0|1|2] ]
[-PacketSize packet_size]
[-PrefetchTables [0|1] ]
[-ProfileName profile_name]
[-PublisherDB publisher_database]
[-PublisherDeadlockPriority [-1|0|1] ]
[-PublisherFailoverPartner server_name[\instance_name] ]
[-PublisherLogin publisher_login]
[-PublisherPassword publisher_password]
[-PublisherSecurityMode [0|1] ]
[-QueryTimeOut query_time_out_seconds]
[-ReplicationType [1|2] ]
[-RowDelimiter row_delimiter]
[-StartQueueTimeout start_queue_timeout_seconds]
[-UsePerArticleContentsView use_per_article_contents_view]
参数
-?
输出所有可用的参数。
-Publisherserver_name[\instance_name]
发布服务器的名称。 指定该服务器上 Microsoft SQL Server 默认实例的 server_name。 指定该服务器上 SQL Server 命名实例的 server_name\instance_name。
-出版出版
发布的名称。 只有将发布设置为总是使快照可用于新订阅或重新初始化的订阅时，此参数才有效。
-70名订阅者
如果有任何订阅服务器在运行 SQL Server 7.0 版，则必须使用此参数。
-BcpBatchSize bcp_ batch_ size
在一次大容量复制操作中发送的行数。
执行 bcp in 操作时，批的大小为要作为一个事务发送到服务器的行数，并且也是分发代理记录 bcp 进度消息之前必须发送的行数。 当执行 bcp out 操作时，将使用固定批大小 1000。 值为 0 表示不记录任何消息。
-DefinitionFiledef_path_and_file_name
代理定义文件的路径。 代理定义文件中包含该代理的命令行参数。 文件的内容被当作可执行文件进行分析。 使用双引号 (") 指定包含任意字符的参数值。
-分发器server_name[\instance_name]
分发服务器名称。 指定该服务器上 SQL Server 默认实例的 server_name。 指定该服务器上 SQL Server 命名实例的 server_name\instance_name。
-DistributorDeadlockPriority [-1|0|1]
死锁发生时快照代理连接到分发服务器的优先级。 指定此参数是为了解决快照生成期间在快照代理和用户应用程序之间发生的死锁问题。
| DistributorDeadlockPriority 值 | 说明 |
|---|---|
| -1 | 在分发服务器上发生死锁时，应用程序而非快照代理优先。 |
| 0 （默认值） | 未分配优先级。 |
| 1 | 在分发服务器上发生死锁时，快照代理优先。 |
-DistributorLogindistributor_login
使用 SQL Server 身份验证连接到分发服务器时所用的登录名。
-DistributorPassworddistributor_password
使用 SQL Server 身份验证连接到分发服务器时使用的密码。
-DistributorSecurityMode [ 0| 1]
指定分发服务器的安全模式。 值为 0 表示 SQL Server 身份验证模式（默认值），值为 1 表示 Windows 身份验证模式。
-DynamicFilterHostNamedynamic_filter_host_name
在创建动态快照时，用来为筛选中的 HOST_NAME (Transact-SQL) 设置值。 例如，如果为项目指定了子集筛选器子句 rep_id = HOST_NAME() ，并且在调用合并代理之前将 DynamicFilterHostName 属性设置为“FBJones”，则只会复制 rep_id 列中具有“FBJones”的行。
-DynamicFilterLogindynamic_filter_login
用于在创建动态快照时为 筛选SUSER_SNAME（Transact-SQL） 设置值。 例如，如果为项目指定了子集筛选器子句 user_id = SUSER_SNAME() ，并且在调用 SQLSnapshot 对象的 Run 方法之前将 DynamicFilterLogin 属性设置为“rsmith”，则只将 user_id 列中具有“rsmith”的行包括在快照中。
-DynamicSnapshotLocationdynamic_snapshot_location
应生成动态快照的位置。
-EncryptionLevel [ 0 | 1 | 2 | 3 | 4]
是快照代理在建立连接时使用的传输层安全性 (TLS)（旧称为“安全套接字层 (SSL)”）加密的级别。
| EncryptionLevel 值 | 说明 |
|---|---|
0 |
指定不使用 TLS。 |
1 |
指定使用 TLS 1.2，但代理不验证 TLS/SSL 服务器证书是否由受信任的颁发者签名。 |
2 |
指定使用 TLS 1.2，并验证证书。 |
3 |
指定对于从 Azure SQL 托管实例或 SQL Server 2025 及更高版本到 Azure SQL 托管实例的连接，使用 TLS 1.3，并验证证书。 对于与 SQL Server（任何受支持的版本）的连接，TLS 1.3 不强制使用选项 3。 |
4 |
指定对于从 Azure SQL 托管实例或 SQL Server 2025 及更高版本到 Azure SQL 托管实例的连接，使用 TLS 1.3，并验证证书。 对于从 Azure SQL 托管实例或 SQL Server 2025 及更高版本到 SQL Server（任何受支持的版本）的连接，将使用 TLS 1.3，并验证证书。 要求在接收已 EncryptionLevel 设置为的 4连接的 SQL Server 主机上安装证书。 |
有效的 TLS/SSL 证书是使用 SQL Server 的完全限定的域名进行定义。 为了在将 -EncryptionLevel 设置为 2 时成功连接代理，请在本地 SQL Server 上创建别名。 “Alias Name”参数应为服务器名称，”Server”参数应设置为 SQL Server 的完全限定名称。
有关详细信息，请参阅查看和修改复制安全设置。
-FieldDelimiterfield_delimiter
在 SQL Server 大容量复制数据文件中用于标记字段末尾的字符或字符序列。 默认值为 \n<x$3>\n。
-HistoryVerboseLevel [ 1| 2| 3]
指定在快照操作过程中记录的历史记录大小。 选择 1可将历史日志记录对性能的影响减至最小。
| HistoryVerboseLevel 值 | 说明 |
|---|---|
| 0 | 进度消息将写入控制台或输出文件。 不在分发数据库中记录历史记录。 |
| 1 | 总是更新具有相同状态（启动、进行中、成功等）的上一历史记录消息。 如果不存在状态相同的上一记录，将插入新记录。 |
| 2 （默认值） | 除非记录为空闲消息或长时间运行的作业消息等信息（此时将更新上一记录），否则插入新的历史记录。 |
| 3 | 始终插入新记录，除非它与空闲消息有关。 |
-HRBcpBlocksnumber_of_blocks
在编写器线程和读取器线程之间排队的 bcp 数据块的数量。 默认值为 50。
HRBcpBlocks 仅用于 Oracle 发布。
注意
此参数用于通过 Oracle 发布服务器优化 bcp 的性能。
-
HRBcpBlockSizeblock_size
每个 bcp 数据块的大小（以 KB 为单位）。 默认值为 64 KB。
HRBcpBlocks 仅用于 Oracle 发布。
注意
此参数用于通过 Oracle 发布服务器优化 bcp 的性能。
-HRBcpDynamicBlocks
每个 bcp 数据块的大小是否可以动态增长。
HRBcpBlocks 仅用于 Oracle 发布。
注意
此参数用于通过 Oracle 发布服务器优化 bcp 的性能。
-KeepAliveMessageIntervalkeep_alive_interval
快照代理在向 MSsnapshot_history 表中记录“waiting for backend message”之前等待的时间（以秒为单位）。 默认值为 300 秒。
-登录超时登录超时秒数
登录超时前等待的秒数。默认为 15 秒。
-MaxBcpThreads线程数量
指定可以并行执行的大容量复制操作的数量。 同时存在的线程和 ODBC 连接的最大数量为 MaxBcpThreads 或显示在分发数据库中同步事务中的大容量复制请求数中较小的那一个。
MaxBcpThreads 的值必须大于 0 ，并且不存在任何硬编码的上限。 默认值是处理器数量的两倍。
注意
如果复制的对象具有筛选器，则快照代理将为该项目仅生成一个 BCP 文件，而不是生成多个 BCP 文件。
-
MaxNetworkOptimization [ 0| 1]
是否将无关删除操作发送到订阅服务器。 无关删除操作是针对不属于订阅服务器分区的行发送到订阅服务器的 DELETE 命令。 无关删除操作不会影响数据的完整性或收敛，但它们会导致不必要的网络通信。
MaxNetworkOptimization 的默认值是 0。 将 MaxNetworkOptimization 设置为 1 可将不相关的删除操作发生的机会减至最小，从而减少网络通信，并最大程度地优化网络。 如果存在多个级别的联接筛选器和复杂子集筛选器，则将此参数设置为 1 还会增加元数据的存储并导致发布服务器性能下降。 您应仔细评估您的复制拓扑，仅当无关删除操作导致的网络通信高到无法接受时才应将 MaxNetworkOptimization 设置为 1 。
注意
仅当合并发布的同步优化选项（sp_addmergepublication (Transact-SQL) 的 参数）设置为 @keep_partition_changes** 时，将此参数设置为 1 才是有用的。
-Outputoutput_path_and_file_name
代理输出文件的路径。 如果未提供文件名，则向控制台发送该输出。 如果指定的文件名已存在，会将输出追加到该文件。
-OutputVerboseLevel [ 0| 1| 2]
指定输出是否应提供详细内容。
| OutputVerboseLevel 值 | 说明 |
|---|---|
| 0 | 仅输出错误消息。 |
| 1 （默认值） | 输出所有进度报告消息（默认值）。 |
| 2 | 输出所有错误消息和进度报告消息，这对于调试很有用。 |
-PacketSizepacket_size
快照代理连接到 SQL Server 时使用的数据包大小（以字节为单位）。 默认值为 8192 字节。
注意
除非您确信能够提高性能，否则不要更改数据包的大小。 对于大多数应用程序而言，默认数据包大小为最佳数值。
-PrefetchTables [ 0| 1]
可选参数，指定是否预提取并缓存表对象。 默认行为是，根据内部计算结果，使用 SMO 组件来预提取特定表属性。 如果 SMO 预提取操作的耗时相当长，你会发现此参数非常有用。 如果你不使用此参数，此决定是在运行时做出，依据为以项目形式添加到发布中的表所占的百分比。
| OutputVerboseLevel 值 | 说明 |
|---|---|
| 0 | 禁止调用 SMO 组件的预提取方法。 |
| 1 | 快照代理会调用预提取方法，以使用 SMO 缓存一些表属性 |
-ProfileNameprofile_name
指定用于代理参数的代理配置文件。 如果 ProfileName 为 NULL，则将禁用代理配置文件。 如果未指定 ProfileName ，则使用该代理类型的默认配置文件。 有关信息，请参阅复制代理配置文件。
-PublisherDBpublisher_database
发布数据库的名称。 Oracle 发布服务器不支持该参数。
-PublisherDeadlockPriority [-1|0|1]
死锁发生时快照代理连接到发布服务器的优先级。 指定此参数是为了解决快照生成期间在快照代理和用户应用程序之间发生的死锁问题。
| PublisherDeadlockPriority 值 | 说明 |
|---|---|
| -1 | 在发布服务器上发生死锁时，应用程序而非快照代理优先。 |
| 0 （默认值） | 未分配优先级。 |
| 1 | 在发布服务器上发生死锁时，快照代理优先。 |
-PublisherFailoverPartnerserver_name[\instance_name]
指定参加与发布数据库进行的数据库镜像会话的 SQL Server 故障转移伙伴实例。 有关详细信息，请参阅数据库镜像和复制 (SQL Server)。
-PublisherLoginpublisher_login
使用 SQL Server 身份验证连接到发布服务器时所用的登录名。
-PublisherPasswordpublisher_password
使用 SQL Server 身份验证连接到发布服务器时使用的密码。
-PublisherSecurityMode [ 0| 1]
指定发布服务器的安全模式。 值为 0 表示 SQL Server 身份验证（默认值），值为 1 表示 Windows 身份验证模式。
-QueryTimeOutquery_time_out_seconds
查询超时之前等待的秒数。默认为 1800 秒。
-ReplicationType [ 1| 2]
指定复制的类型。 值 1 指示事务复制，值 2 指示合并复制。
-RowDelimiterrow_delimiter
在 SQL Server 大容量复制数据文件中用于标记行尾的字符或字符序列。 默认值为 \n<,@g>\n。
-StartQueueTimeoutstart_queue_timeout_seconds
当运行的并发动态快照进程数达到由 @max_concurrent_dynamic_snapshots 的 属性设置的限制值时，快照代理等待的最大秒数。 如果在经过最大秒数之后快照代理仍在等待，快照代理将退出。 值 0 表示代理将无限期地等待，尽管可以将其取消。
-
UsePerArticleContentsViewuse_per_article_contents_view
已不推荐使用此参数，支持它是为了能够向后兼容。
注解
重要
如果安装的 SQL Server 代理是通过本地系统帐户而非域用户帐户（默认值）运行，则该服务仅可访问本地计算机。 如果将在 SQL Server 代理下运行的快照代理配置为登录 SQL Server 时使用 Windows 身份验证模式，则快照代理将失败。 默认设置为 SQL Server 身份验证。
若要启动快照代理，请从命令提示符处执行 snapshot.exe 。 有关信息，请参阅 复制代理可执行文件。