创建事务发布的可更新订阅

项目
03/15/2024

适用于：SQL Server

注意

此功能从 2012 到 2016 的 SQL Server 版本中仍然受支持。在 SQL Server的未来版本中将删除此功能。请避免在新的开发工作中使用该功能，并着手修改当前还在使用该功能的应用程序。

通过事务复制，可以将在订阅服务器上进行的更改回传到使用立即或排队更新订阅的发布服务器。可以使用复制存储过程以编程方式创建更新订阅。

可以在“新建订阅向导”的“可更新订阅”页上配置可更新订阅。只有为可更新订阅启用了事务发布，此页才可用。有关启用可更新订阅的详细信息，请参阅为事务发布启用更新订阅。

从发布服务器配置可更新订阅

在 Microsoft SQL Server Management Studio 中连接到发布服务器，然后展开服务器节点。
展开 “复制” 文件夹，再展开 “本地发布” 文件夹。
右键单击为更新订阅启用的事务发布，然后单击“新建订阅”。
按照向导中的页，为订阅指定选项，如分发代理应在何处运行。
在“新建订阅向导”的“可更新订阅”页上，确保已选中“复制”。
从“在发布服务器提交”下拉列表中选择一个选项：
- 若要使用立即更新订阅，请选择“同时提交更改”。如果选择此选项，并且发布允许排队更新订阅（使用新建发布向导所创建发布的默认设置），则订阅属性 update_mode 将设置为“故障转移”。此模式使您以后在必要时能够切换到排队更新。
- 若要使用排队更新订阅，请选择“对更改进行排队并在可能时提交”。如果选择此选项且发布允许立即更新订阅（使用新建发布向导所创建发布的默认设置），而且订阅服务器运行的是 SQL Server 2005 或更高版本，则订阅属性 update_mode 将设置为排队故障转移。此模式使您以后在必要时能够切换到立即更新。
有关切换更新模式的详细信息，请参阅切换可更新事务性订阅的更新模式。
对于使用立即更新或将 update_mode 设置为排队故障转移的订阅，显示“用于可更新订阅的登录名”页。在“用于可更新订阅的登录名”页上，指定链接服务器，通过此服务器可与发布服务器建立连接，以便立即更新订阅。连接用于在订阅服务器上激发的触发器，这些触发器用于将更改传播到发布服务器。选择以下任一选项：
- 创建使用 SQL Server 身份验证进行连接的链接服务器。 如果尚未在订阅服务器和发布服务器之间定义远程服务器或链接服务器，则选择此选项。复制会为您创建链接服务器。所指定的帐户在发布服务器上必须已经存在。
- 使用您指定的链接服务器或远程服务器。 如果已使用 sp_addserver (Transact-SQL)、sp_addlinkedserver (Transact-SQL)、SQL Server Management Studio 或其他方法在订阅服务器和发布服务器之间定义了远程服务器或链接服务器，请选择此选项。
有关链接服务器帐户所需权限的信息，请参阅在此处输入链接说明的排队更新订阅部分。
完成该向导。

从订阅服务器配置可更新订阅

在 SQL Server Management Studio 中连接到订阅服务器，然后展开服务器节点。
展开 “复制” 文件夹。
右键单击 “本地订阅” 文件夹，再单击 “新建订阅”。
在“新建订阅向导”的“发布”页上，从“发布服务器”下拉列表中选择“查找 SQL Server 发布服务器”。
在 “连接到服务器” 对话框中连接到发布服务器。
在“发布”页上，选择为更新订阅启用的事务发布。
按照向导中的页，为订阅指定选项，如分发代理应在何处运行。
在“新建订阅向导”的“可更新订阅”页上，确保已选中“复制”。
从“在发布服务器提交”下拉列表中选择一个选项：
- 若要使用立即更新订阅，请选择“同时提交更改”。如果选择此选项，并且发布允许排队更新订阅（使用新建发布向导所创建发布的默认设置），则订阅属性 update_mode 将设置为“故障转移”。此模式使您以后在必要时能够切换到排队更新。
- 若要使用排队更新订阅，请选择“对更改进行排队并在可能时提交”。如果选择此选项且发布允许立即更新订阅（使用新建发布向导所创建发布的默认设置），而且订阅服务器运行的是 SQL Server 2005 或更高版本，则订阅属性 update_mode 将设置为排队故障转移。此模式使您以后在必要时能够切换到立即更新。
有关切换更新模式的详细信息，请参阅切换可更新事务性订阅的更新模式。
对于使用立即更新或将 update_mode 设置为排队故障转移的订阅，显示“用于可更新订阅的登录名”页。在“用于可更新订阅的登录名”页上，指定链接服务器，通过此服务器可与发布服务器建立连接，以便立即更新订阅。连接用于在订阅服务器上激发的触发器，这些触发器用于将更改传播到发布服务器。选择以下任一选项：
- 创建使用 SQL Server 身份验证进行连接的链接服务器。 如果尚未在订阅服务器和发布服务器之间定义远程服务器或链接服务器，则选择此选项。复制会为您创建链接服务器。所指定的帐户在发布服务器上必须已经存在。
- 使用您指定的链接服务器或远程服务器。 如果已使用 sp_addserver (Transact-SQL)、sp_addlinkedserver (Transact-SQL)、SQL Server Management Studio 或其他方法在订阅服务器和发布服务器之间定义了远程服务器或链接服务器，请选择此选项。
有关链接服务器帐户所需权限的信息，请参阅在此处输入链接说明的排队更新订阅部分。
完成该向导。

创建立即更新请求订阅

在发布服务器上，通过执行 sp_helppublication验证发布是否支持立即更新订阅。
- 如果结果集中 allow_sync_tran 的值为 1，说明该发布支持立即更新订阅。
- 如果结果集中 allow_sync_tran 的值为 0，说明必须重新创建该发布以使其支持立即更新订阅。
在发布服务器上，通过执行 sp_helppublication验证发布是否支持请求订阅。
- 如果结果集中 allow_pull 的值为 1，说明该发布支持请求订阅。
- 如果 allow_pull 的值是 0，则执行 sp_changepublication（为 allow_pull 指定 @property ，并为 true 指定 @value）。
在订阅服务器上，执行 sp_addpullsubscription。指定 @publisher 和 @publication，并为 @update_mode指定以下值之一：
- sync tran - 使订阅支持立即更新。
- failover - 支持对订阅进行立即更新，并将排队更新作为故障转移选项。
注意

failover 要求发布也支持排队更新订阅。
在订阅服务器上，执行 sp_addpullsubscription_agent。指定以下项目：
- 订阅服务器中的分发代理运行时所使用的 @publisher或复制管理对象 (RMO) 在 @publisher_db和 @publication 参数。
- 订阅服务器中的分发代理运行时所使用的 Microsoft Windows 凭据： @job_login 和 @job_password。
注意

在使用 Windows 集成身份验证时，总是使用 @job_login 和 @job_password指定的 Windows 凭据来建立连接。分发代理始终使用 Windows 集成身份验证与订阅服务器建立本地连接。默认情况下，代理使用 Windows 集成身份验证连接到分发服务器。
- （可选） 0 的值 @distributor_security_mode ，以及 Microsoft SQL Server 登录信息 @distributor_login 和 @distributor_password（如果在连接到分发服务器时需要使用 SQL Server 身份验证）。
- 该订阅的分发代理作业计划。
在订阅服务器上的订阅数据库中，执行 sp_link_publication。指定 @publisher或复制管理对象 (RMO) 在 @publication，为 @publisher_db指定发布数据库的名称，并为 @security_mode指定下列值之一：
- 0 - 表示在发布服务器上执行更新时使用 SQL Server 身份验证。此选项需要为 @login 和 @password。
- 1 - 在连接到发布服务器时，使用在订阅服务器上执行更改的用户的安全上下文。请参阅 sp_link_publication ，了解与此安全模式相关的限制。
- 2 - 使用现有的、用户定义的链接服务器登录名，该登录名是使用 sp_addlinkedserver创建的。
在发布服务器上，执行 sp_addsubscription （指定 @publication、 @subscriber、 @destination_db，为 @subscription_type指定值 pull，并为 @update_mode指定步骤 3 中指定的相同值）。这会在发布服务器上注册请求订阅。

创建立即更新推送订阅

在发布服务器上，通过执行 sp_helppublication验证发布是否支持立即更新订阅。
- 如果结果集中 allow_sync_tran 的值为 1，说明该发布支持立即更新订阅。
- 如果结果集中 allow_sync_tran 的值为 0，说明必须重新创建该发布以使其支持立即更新订阅。
在发布服务器上，通过执行 sp_helppublication以验证发布是否支持推送订阅。
- 如果结果集中 allow_push 的值为 1，说明该发布支持推送订阅。
- 如果 allow_push 的值是 0，则执行 sp_changepublication（为 allow_push 指定 @property ，并为 true 指定 @value）。
在发布服务器上，执行 sp_addsubscription。指定 @publication或复制管理对象 (RMO) 在 @subscriber或复制管理对象 (RMO) 在 @destination_db，并将下列值之一指定给 @update_mode：
- sync tran - 支持立即更新。
- failover - 支持立即更新，并且将排队更新作为故障转移选项。
注意

failover 要求发布也支持排队更新订阅。
在发布服务器上，执行 sp_addpushsubscription_agent。指定下列参数：
- @subscriber、 @subscriber_db和 @publication。
- 分发服务器中的分发代理运行时所使用的 Windows 凭据： @job_login 和 @job_password。
注意

在使用 Windows 集成身份验证时，总是使用 @job_login 和 @job_password指定的 Windows 凭据来建立连接。分发代理始终使用 Windows 集成身份验证与分发服务器建立本地连接。默认情况下，该代理将使用 Windows 集成身份验证连接到订阅服务器。
- （可选） 0 的值 @subscriber_security_mode ，以及 SQL Server 登录信息 @subscriber_login 和 @subscriber_password（如果在连接到订阅服务器时需要使用 SQL Server 身份验证）。
- 该订阅的分发代理作业计划。
在订阅服务器上的订阅数据库中，执行 sp_link_publication。指定 @publisher或复制管理对象 (RMO) 在 @publication，为 @publisher_db指定发布数据库的名称，并为 @security_mode指定下列值之一：
- 0 - 表示在发布服务器上执行更新时使用 SQL Server 身份验证。此选项需要为 @login 和 @password。
- 1 - 在连接到发布服务器时，使用在订阅服务器上执行更改的用户的安全上下文。请参阅 sp_link_publication ，了解与此安全模式相关的限制。
- 2 - 使用现有的、用户定义的链接服务器登录名，该登录名是使用 sp_addlinkedserver创建的。

创建排队更新请求订阅

在发布服务器上，通过执行 sp_helppublication验证发布是否支持排队更新订阅。
- 如果结果集中 allow_queued_tran 的值为 1，说明该发布支持立即更新订阅。
- 如果结果集中 allow_queued_tran 的值为 0，说明必须重新创建该发布以使其支持排队更新订阅。
在发布服务器上，通过执行 sp_helppublication验证发布是否支持请求订阅。
- 如果结果集中 allow_pull 的值为 1，说明该发布支持请求订阅。
- 如果 allow_pull 的值是 0，则执行 sp_changepublication（为 allow_pull 指定 @property ，并为 true 指定 @value）。
在订阅服务器上，执行 sp_addpullsubscription。指定 @publisher 和 @publication，并为 @update_mode指定以下值之一：
- queued tran - 支持订阅进行排队更新。
- queued failover - 支持排队更新，并将立即更新作为故障转移选项。
注意

queued failover 要求发布也支持立即更新订阅。若要故障转移到立即更新，必须使用 sp_link_publication 定义将订阅服务器上的更改复制到发布服务器所用的凭据。
在订阅服务器上，执行 sp_addpullsubscription_agent。指定下列参数：
- @publisher、 @publisher_db和 @publication。
- 订阅服务器中的分发代理运行时所使用的 Windows 凭据： @job_login 和 @job_password。
注意

在使用 Windows 集成身份验证时，总是使用 @job_login 和 @job_password指定的 Windows 凭据来建立连接。分发代理始终使用 Windows 集成身份验证与订阅服务器建立本地连接。默认情况下，代理使用 Windows 集成身份验证连接到分发服务器。
- （可选） 0 的值 @distributor_security_mode ，以及 SQL Server 登录信息 @distributor_login 和 @distributor_password（如果在连接到分发服务器时需要使用 SQL Server 身份验证）。
- 该订阅的分发代理作业计划。
在发布服务器上，执行 sp_addsubscriber 以在发布服务器上注册订阅服务器（指定 @publication、 @subscriber、 @destination_db，为 @subscription_type指定值 pull，并为 @update_mode指定步骤 3 中指定的相同值）。这会在发布服务器上注册请求订阅。

创建排队更新推送订阅

在发布服务器上，通过执行 sp_helppublication验证发布是否支持排队更新订阅。
- 如果结果集中 allow_queued_tran 的值为 1，说明发布支持排队更新订阅。
- 如果结果集中 allow_queued_tran 的值为 0，说明必须重新创建该发布以使其支持排队更新订阅。有关详细信息，请参阅“如何为事务发布启用更新订阅（复制 Transact-SQL 编程）”。
在发布服务器上，通过执行 sp_helppublication以验证发布是否支持推送订阅。
- 如果结果集中 allow_push 的值为 1，说明该发布支持推送订阅。
- 如果 allow_push 的值是 0，则执行 sp_changepublication（为 @property 指定 allow_push，并为 true 指定 @value）。
在发布服务器上，执行 sp_addsubscription。指定 @publication或复制管理对象 (RMO) 在 @subscriber或复制管理对象 (RMO) 在 @destination_db，并将下列值之一指定给 @update_mode：
- queued tran - 支持订阅进行排队更新。
- queued failover - 支持排队更新，并将立即更新作为故障转移选项。
注意

queued failover 选项要求发布也支持立即更新订阅。若要故障转移到立即更新，必须使用 sp_link_publication 定义将订阅服务器上的更改复制到发布服务器所用的凭据。
在发布服务器上，执行 sp_addpushsubscription_agent。指定下列参数：
- @subscriber、 @subscriber_db和 @publication。
- 分发服务器中的分发代理运行时所使用的 Windows 凭据： @job_login 和 @job_password。
注意

在使用 Windows 集成身份验证时，总是使用 @job_login 和 @job_password指定的 Windows 凭据来建立连接。分发代理始终使用 Windows 集成身份验证与分发服务器建立本地连接。默认情况下，代理使用 Windows 集成身份验证连接到订阅服务器。
- （可选） 0 的值 @subscriber_security_mode ，以及 SQL Server 登录信息 @subscriber_login 和 @subscriber_password（如果在连接到订阅服务器时需要使用 SQL Server 身份验证）。
- 该订阅的分发代理作业计划。

设置已排队的更新冲突解决选项

在“发布属性 - <发布>”对话框的“订阅选项”页上，为支持排队更新订阅的发布设置冲突解决选项。有关访问此对话框的详细信息，请参阅 View and Modify Publication Properties。

在“发布属性 - <发布>”对话框的“订阅选项”页上，为“冲突解决策略”选项选择以下值之一：
- 保留发布服务器更改
- 保留订阅服务器更改
- 重新初始化订阅

示例

本示例针对某个支持立即更新订阅的发布创建了一个立即更新请求订阅。在运行时使用 sqlcmd 脚本变量提供登录名和密码值。

注意

此脚本使用 sqlcmd 脚本变量。它们采用 $(MyVariable)的形式。有关如何在命令行上和 SQL Server Management Studio 中使用脚本变量的信息，请参阅 复制系统存储过程概念 主题中的执行复制脚本部分。

-- Execute this batch at the Subscriber.
DECLARE @publication AS sysname;
DECLARE @publicationDB AS sysname;
DECLARE @publisher AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS NVARCHAR(512);
SET @publication = N'AdvWorksProductTran';
SET @publicationDB = N'AdventureWorks2022';
SET @publisher = $(PubServer);
SET @login = $(Login);
SET @password = $(Password);

-- At the subscription database, create a pull subscription to a transactional 
-- publication using immediate updating with queued updating as a failover.
EXEC sp_addpullsubscription
    @publisher = @publisher,
    @publication = @publication,
    @publisher_db = @publicationDB,
    @update_mode = N'failover',
    @subscription_type = N'pull';

-- Add an agent job to synchronize the pull subscription, 
-- which uses Windows Authentication when connecting to the Distributor.
EXEC sp_addpullsubscription_agent
    @publisher = @publisher,
    @publisher_db = @publicationDB,
    @publication = @publication,
    @job_login = @login,
    @job_password = @password;

-- Add a Windows Authentication-based linked server that enables the 
-- Subscriber-side triggers to make updates at the Publisher. 
EXEC sp_link_publication
    @publisher = @publisher,
    @publication = @publication,
    @publisher_db = @publicationDB,
    @security_mode = 0,
    @login = @login,
    @password = @password;
GO

USE AdventureWorks2022;
GO

-- Execute this batch at the Publisher.
DECLARE @publication AS sysname;
DECLARE @subscriptionDB AS sysname;
DECLARE @subscriber AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @subscriptionDB = N'AdventureWorks2022Replica';
SET @subscriber = $(SubServer);

-- At the Publisher, register the subscription, using the defaults.
USE AdventureWorks2022;
EXEC sp_addsubscription
    @publication = @publication,
    @subscriber = @subscriber,
    @destination_db = @subscriptionDB,
    @subscription_type = N'pull',
    @update_mode = N'failover';
GO

另请参阅

Updatable Subscriptions for Transactional Replication
创建发布
 将 sqlcmd 与脚本变量结合使用