• 项目

复制快照代理

复制快照代理是一个可执行文件，它用于准备快照文件（其中包含已发布表和数据库对象的架构及数据），然后将这些文件存储在快照文件夹中，并在分发数据库中记录同步作业。

注意注意

可以按任意顺序指定参数。

语法

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]]
[-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]
[-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]

参数

  • -?
    输出所有可用的参数。

  • -Publisher server_name[**\instance_name]
    发布服务器名。为该服务器上的 Microsoft SQL Server 默认实例指定 server_name。为该服务器上的 SQL Server 命名实例指定 server_name    \**instance_name。

  • -Publicationpublication
    发布的名称。只有将发布设置为总是使快照可用于新订阅或重新初始化的订阅时，此参数才有效。

  • -70Subscribers
    如果有任何订阅服务器在运行 SQL Server 7.0 版，则必须使用此参数。

  • -BcpBatchSizebcp_ batch_ size
    在一次大容量复制操作中发送的行数。执行 bcp in 操作时，批的大小为要作为一个事务发送到服务器的行数，并且也是分发代理记录 bcp 进度消息之前必须发送的行数。当执行 bcp out 操作时，将使用固定批大小 1000。值为 0 表示不记录任何消息。

  • -DefinitionFiledef_path_and_file_name
    代理定义文件的路径。代理定义文件中包含该代理的命令行参数。文件的内容被当作可执行文件进行分析。使用双引号 (") 指定包含任意字符的参数值。

  • -Distributorserver_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 ]
    建立连接时快照代理使用的安全套接字层 (SSL) 加密的等级。

    EncryptionLevel 值

    说明

    0

    指定不使用 SSL。

    1

    指定使用 SSL，但是代理不验证 SSL 服务器证书是否已由可信的颁发者进行签名。

    2

    指定使用 SSL，并验证证书。

    有关详细信息，请参阅安全性概述（复制）。

  • -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 秒。

  • -LoginTimeOutlogin_time_out_seconds
    登录超时前等待的秒数。默认值为 15 秒。

  • -MaxBcpThreadsnumber_of_threads
    指定可以并行执行的大容量复制操作的数量。同时存在的线程和 ODBC 连接的最大数量为 MaxBcpThreads 或显示在分发数据库中同步事务中的大容量复制请求数中较小的那一个。MaxBcpThreads 的值必须大于 0，并且不存在任何硬编码的上限。默认值为 1。

  • - MaxNetworkOptimization [ 0| 1]
    是否将无关删除操作发送到订阅服务器。无关删除操作是针对不属于订阅服务器分区的行发送到订阅服务器的 DELETE 命令。无关删除操作不会影响数据的完整性或收敛，但它们会导致不必要的网络通信。MaxNetworkOptimization 的默认值是 0。将 MaxNetworkOptimization 设置为 1 可将不相关的删除操作发生的机会减至最小，从而减少网络通信，并最大程度地优化网络。如果存在多个级别的联接筛选器和复杂子集筛选器，则将此参数设置为 1 还会增加元数据的存储并导致发布服务器性能下降。您应仔细评估您的复制拓扑，仅当无关删除操作导致的网络通信高到无法接受时才应将 MaxNetworkOptimization 设置为 1。

    注意注意

    仅当合并发布的同步优化选项（sp_addmergepublication (Transact-SQL) 的 @keep_partition_changes 参数）设置为 true 时，将此参数设置为 1 才是有用的。

  • -Outputoutput_path_and_file_name
    代理输出文件的路径。如果未提供文件名，则向控制台发送该输出。如果指定的文件名已存在，会将输出追加到该文件。

  • -OutputVerboseLevel [ 0| 1| 2]
    指定输出是否应提供详细内容。

    OutputVerboseLevel 值

    说明

    0

    仅输出错误消息。

    1（默认值）

    输出所有进度报告消息（默认值）。

    2

    输出所有错误消息和进度报告消息，这对于调试很有用。

  • -PacketSizepacket_size
    快照代理连接到 SQL Server 时使用的数据包大小（以字节为单位）。默认值为 8192 字节。

<div class="alert">

<table>
<colgroup>
<col style="width: 100%" />
</colgroup>
<thead>
<tr class="header">
<th><img src="images/ms166018.alert_note(zh-cn,SQL.105).gif" title="注意" alt="注意" class="note" /><strong>注意</strong></th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td><p>除非您确信能够提高性能，否则不要更改数据包的大小。对于大多数应用程序而言，默认数据包大小为最佳数值。</p></td>
</tr>
</tbody>
</table>

</div>

  • -ProfileNameprofile_name
    指定用于代理参数的代理配置文件。如果 ProfileName 为 NULL，则将禁用代理配置文件。如果未指定 ProfileName，则使用该代理类型的默认配置文件。有关信息，请参阅复制代理配置文件。

  • -PublisherDBpublisher_database
    发布数据库的名称。Oracle 发布服务器不支持该参数。

  • -PublisherDeadlockPriority [-1|0|1]
    死锁发生时快照代理连接到发布服务器的优先级。指定此参数是为了解决快照生成期间在快照代理和用户应用程序之间发生的死锁问题。

    PublisherDeadlockPriority 值

    说明

    -1

    在发布服务器上发生死锁时，应用程序而非快照代理优先。

    0（默认值）

    未分配优先级。

    1

    在发布服务器上发生死锁时，快照代理优先。

  • -PublisherFailoverPartnerserver_name[**\**instance_name]
    指定参加与发布数据库进行的数据库镜像会话的 SQL Server 故障转移伙伴实例。有关详细信息，请参阅复制和数据库镜像。

  • -PublisherLoginpublisher_login
    使用 SQL Server 身份验证连接到发布服务器时所用的登录名。

  • -PublisherPassword publisher_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
    当运行的并发动态快照进程数达到由 sp_addmergepublication (Transact-SQL) 的 @max_concurrent_dynamic_snapshots 属性设置的限制值时，快照代理等待的最大秒数。如果在经过最大秒数之后快照代理仍在等待，快照代理将退出。值 0 表示代理将无限期地等待，尽管可以将其取消。

  • - - UsePerArticleContentsView use_per_article_contents_view
    已不推荐使用此参数，支持它是为了能够向后兼容。

注释

重要说明重要提示

如果您安装的 SQL Server 代理是通过本地系统帐户而非域用户帐户（默认值）运行，则该服务仅可访问本地计算机。如果将在 SQL Server 代理下运行的快照代理配置为登录 SQL Server 时使用 Windows 身份验证模式，则快照代理将失败。默认设置为 SQL Server 身份验证。

若要启动快照代理，请从命令提示符处执行 snapshot.exe。有关信息，请参阅复制代理可执行文件。

请参阅

概念

管理复制代理