为事务项目的数据更改设置传播方法

项目
10/05/2023

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

本主题介绍如何使用 SQL Server Management Studio 或 Transact-SQL 在 SQL Server 中将数据更改的传播方法更改为事务项目。

默认情况下，事务复制使用一组存储过程将每个项目的更改传播到订阅服务器。可以使用自定义过程替换这些存储过程。有关详细信息，请参阅指定如何传播事务项目的更改。

开始之前

限制和局限

在编辑复制生成的任何快照文件时，都必须谨慎。测试和支持自定义存储过程中的自定义逻辑。 Microsoft 不支持自定义逻辑。

使用 SQL Server Management Studio

在“项目属性 - <项目>”对话框的“属性”选项卡上指定传播方法，该对话框可在新建发布向导和“发布属性 - <发布>”对话框中获取。有关如何使用该向导和如何访问该对话框的详细信息，请参阅创建发布和查看和修改发布属性。

指定传播方法

在新建发布向导的“项目”页或“发布属性 - <发布>”对话框中，选择一个表，然后选择“项目属性”。
选择“设置突出显示的表项目的属性”。
在“项目属性 - <项目>”对话框的“属性”选项卡上，在“语句传递”部分中，使用“INSERT 传递格式”、“UPDATE 传递格式”和“DELETE 传递格式”菜单为每个操作指定传播方法。
选择“确定”。
如果处于“发布属性 - <发布>”对话框中，请选择“确定”以保存并关闭该对话框。

生成和使用自定义存储过程

在新建发布向导的“项目”页或“发布属性 - <发布>”对话框中，选择一个表，然后选择“项目属性”。
选择“设置突出显示的表项目的属性”。

在“项目属性 - <项目>”对话框的“属性”选项卡上，在“语句传递”部分中，从适当的传递格式菜单（“INSERT 传递格式”、“UPDATE 传递格式”或“DELETE 传递格式”）中选择 CALL 语法，然后键入要在“INSERT 存储过程”、“DELETE 存储过程”或“UPDATE 存储过程”中使用的过程名称。若要详细了解如何使用存储过程，请参阅指定如何传播事务项目的更改中的“存储过程的调用语法”。
选择“确定”。
如果处于“发布属性 - <发布>”对话框中，请选择“确定”以保存并关闭该对话框。
发布的快照生成后，将包含上一步骤中指定的过程。这些过程将使用指定的 CALL 语法，但将包含复制使用的默认逻辑。

快照生成后，定位到此项目所属的发布的快照文件夹，并找到与此项目同名的 .sch 文件。使用记事本或其他文本编辑器打开此文件，找到用于插入、更新或删除存储过程的 CREATE PROCEDURE 命令，并编辑过程定义，以为传播数据更改提供自定义逻辑。重新生成快照后，必须重新创建自定义过程。

“使用 Transact-SQL”

通过事务复制，您可以控制如何将更改从发布服务器传播到订阅服务器，而这种传播方法可以在创建和之后更改项目时使用复制存储过程以编程的方式进行设置。

注意

可以为作用于发布数据行的每一种 DML（数据操作语言）操作（插入、更新或删除）指定一种不同的传播方法。

有关详细信息，请参阅指定如何传播事务项目的更改。

创建使用 Transact-SQL 命令传播数据更改的项目

在发布服务器上，对发布数据库执行 sp_addarticle。为 @publication指定项目所属的发布的名称，为 @article指定项目的名称，为 @source_object指定要发布的数据库对象，并为下列至少一个参数指定 SQL 值：
- @ins_cmd - 控制 INSERT 命令的复制。
- @upd_cmd - 控制 UPDATE 命令的复制。
- @del_cmd - 控制 DELETE 命令的复制。
注意

为以上任意参数指定 SQL 值后，该类型的命令将作为相应的 Transact-SQL 命令复制到订阅服务器。

有关详细信息，请参阅定义项目。

创建不传播数据更改的项目

在发布服务器上，对发布数据库执行 sp_addarticle。为 @publication指定项目所属的发布的名称，为 @article指定项目的名称，为 @source_object指定要发布的数据库对象，并为下列至少一个参数指定 NONE 值：
- @ins_cmd - 控制 INSERT 命令的复制。
- @upd_cmd - 控制 UPDATE 命令的复制。
- @del_cmd - 控制 DELETE 命令的复制。
注意

将以上任意参数指定为 NONE 值后，该类型的命令将不会复制到订阅服务器。

有关详细信息，请参阅定义项目。

通过用户修改的自定义存储过程创建项目

在发布服务器上，对发布数据库执行 sp_addarticle。为 @publication指定项目所属的发布的名称，为 @article指定项目的名称，为 @source_object指定要发布的数据库对象，并为包含值 0x02 （可自动生成自定义存储过程）的 @schema_option 位掩码以及下列至少一个参数指定值：
- @ins_cmd - 指定 CALL sp_MSins_article_name 的值，其中 article_name 是为 @article 指定的值。
- @del_cmd - 指定 CALL sp_MSdel_article_name 或 XCALL sp_MSdel_article_name 的值，其中 article_name 是为 @article 指定的值。
- @upd_cmd - 指定 SCALL sp_MSupd_article_name、CALL sp_MSupd_article_name、XCALL sp_MSupd_article_name, 或 MCALL sp_MSupd_article_name 的值，其中 article_name 是为 @article 指定的值。
注意

对于以上每个命令参数，您都可以为复制生成的存储过程指定您自己的名称。

注意

若要了解有关 CALL、SCALL、XCALL 和 MCALL 语法的详细信息，请参阅指定如何传播事务项目的更改。

有关详细信息，请参阅定义项目。
快照生成后，定位到此项目所属的发布的快照文件夹，并找到与此项目同名的 .sch 文件。使用 Notepad.exe 打开此文件，找到用于插入、更新或删除存储过程的 CREATE PROCEDURE 命令，并编辑过程定义以提供用于传播数据更改的任何自定义逻辑。有关详细信息，请参阅指定如何传播事务项目的更改。

用自定义存储过程中的自定义脚本创建项目以传播数据更改

在发布服务器上，对发布数据库执行 sp_addarticle。为 @publication指定项目所属的发布的名称，为 @article指定项目的名称，为 @source_object指定要发布的数据库对象，并为包含值 0x02 （可自动生成自定义存储过程）的 @schema_option 位掩码以及下列至少一个参数指定值：
- @ins_cmd - 指定 CALL sp_MSins_article_name 的值，其中 article_name 是为 @article 指定的值。
- @del_cmd - 指定 CALL sp_MSdel_article_name 或 XCALL sp_MSdel_article_name 的值，其中 article_name 是为 @article 指定的值。
- @upd_cmd - 指定 SCALL sp_MSupd_article_name、CALL sp_MSupd_article_name、XCALL sp_MSupd_article_name、MCALL sp_MSupd_article_name 的值，其中 article_name 是为 @article 指定的值。
注意

对于以上每个命令参数，您都可以为复制生成的存储过程指定您自己的名称。

注意

若要了解有关 CALL、SCALL、XCALL 和 MCALL 语法的详细信息，请参阅指定如何传播事务项目的更改。

有关详细信息，请参阅定义项目。
在发布服务器上，对发布数据库使用 ALTER PROCEDURE 语句来编辑 sp_scriptpublicationcustomprocs ，以使该语句可以返回用于插入、更新和删除自定义存储过程的 CREATE PROCEDURE 脚本。有关详细信息，请参阅指定如何传播事务项目的更改。

更改为现有项目传播更改的方法

在发布服务器上，对发布数据库执行 sp_changearticle。指定 @publication和 @article，为 @property指定 ins_cmd、 upd_cmd 或 del_cmd值，并为 @value指定适当的传播方法。
为每个要更改的传播方法重复步骤 1。