sp_settriggerorder (Transact-SQL)
指定第一个激发或最后一个激发的 AFTER 触发器。 在第一个和最后一个触发器之间激发的 AFTER 触发器将按未定义的顺序执行。
适用范围:SQL Server(SQL Server 2008 至当前版本),Windows Azure SQL Database(初始版本至当前版本)。 |
语法
sp_settriggerorder [ @triggername = ] '[ triggerschema. ] triggername'
, [ @order = ] 'value'
, [ @stmttype = ] 'statement_type'
[ , [ @namespace = ] { 'DATABASE' | 'SERVER' | NULL } ]
参数
[ @triggername= ] '[ triggerschema**.]triggername'**
要设置或更改其顺序的触发器的名称及其所属的架构(如果适用)。 [triggerschema**.**]triggername 为 sysname。 如果名称与触发器不对应,或者名称与 INSTEAD OF 触发器对应,则该过程将返回错误。 不能为 DDL 或登录触发器指定 triggerschema。[ @order= ] 'value'
触发器的新顺序的设置。 value 的数据类型为 varchar(10),可以是下列值中的任意一个值。重要提示 First 和 Last 触发器必须是两个不同的触发器。
值
说明
第一个
触发器被第一个触发。
最后一个
触发器被最后一个触发。
无
触发器以未定义的顺序触发。
[ @stmttype= ] 'statement_type'
指定触发触发器的 SQL 语句。 statement_type 的数据类型为 varchar(50),可以是 INSERT、UPDATE、DELETE、LOGON 或 DDL 事件中列出的任何 Transact-SQL 语句事件。 不能指定事件组。只有已将触发器定义为某个语句类型的触发器之后,才能将该触发器指定为该语句类型的 First 或 Last 触发器。 例如,如果 TR1 已定义为 INSERT 触发器,则可将触发器 TR1 指定为表 T1 的 INSERT 语句的 First 触发器。 如果已将 TR1 仅定义为 INSERT 触发器,但却被设置为 UPDATE 语句的 First 或 Last 触发器,则数据库引擎将返回错误。 有关详细信息,请参阅“备注”部分。
@namespace= { 'DATABASE' | 'SERVER' | NULL }
如果 triggername 是 DDL 触发器,则 @namespace 指定所创建的 triggername 是具有数据库作用域还是服务器作用域。 如果 triggername 是登录触发器,则必须指定 SERVER。 有关 DDL 触发器作用域的详细信息,请参阅DDL 触发器。 如果未指定或指定为 NULL,则 triggername 为 DML 触发器。SERVER 适用于:SQL Server 2008 至 SQL Server 2014。
返回代码值
0(成功)或 1(失败)
注释
DML 触发器
用于单个表的每个语句只能有一个 First 触发器和一个 Last 触发器。
如果已为表、数据库或服务器定义了 First 触发器,则不能为相同 statement_type 的同一个表、数据库或服务器指定新的 First 触发器。 此限制也适用于 Last 触发器。
复制将为包含在立即更新订阅或排队更新订阅中的任意表自动生成第一个触发器。 复制要求其触发器为第一个触发器。 在尝试将带有第一个触发器的表包含在立即更新订阅或排队更新订阅中时,复制将引发错误。 如果在表已经包含在订阅中之后,尝试使某个触发器成为第一个触发器,sp_settriggerorder 将返回错误。 如果对复制触发器使用 ALTER TRIGGER,或使用 sp_settriggerorder 将复制触发器改为 Last 触发器或 None 触发器,则订阅将不能正确工作。
DDL 触发器
如果同一事件中同时存在具有数据库作用域的 DDL 触发器和具有服务器作用域的 DDL 触发器,则可以将两个触发器分别指定为 First 触发器或 Last 触发器。 但是,服务器作用域的触发器始终最先触发。 一般情况下,同一事件中 DDL 触发器的执行顺序如下:
标记为 First 的服务器级触发器。
其他服务器级触发器。
标记为 Last 的服务器级触发器。
标记为 First 的数据库级触发器。
其他数据库级触发器。
标记为 Last 的数据库级触发器。
常规触发器注意事项
如果 ALTER TRIGGER 语句更改了第一个或最后一个触发器,则最初为触发器设置的 First 或 Last 属性被删除,并且其值被替换为 None。 必须使用 sp_settriggerorder 重新设置顺序值。
如果必须将同一触发器指定为多个语句类型的第一个或最后一个触发器,则必须为每个语句类型执行 sp_settriggerorder。 另外,必须先将触发器定义为某个语句类型,然后才能将其指定为针对该语句类型触发的 First 或 Last 触发器。
权限
若要设置具有服务器作用域(使用 ON ALL SERVER 创建)的 DDL 触发器或登录触发器的顺序,需要具有 CONTROL SERVER 权限。
若要设置具有数据库作用域(使用 ON DATABASE 创建)的 DDL 触发器的顺序,需要具有 ALTER ANY DATABASE DDL TRIGGER 权限。
若要设置 DML 触发器的顺序,需要对要在其中定义该触发器的表或视图具有 ALTER 权限。
示例
A.设置 DML 触发器的触发顺序
以下示例指定触发器 uSalesOrderHeader 是对 Sales.SalesOrderHeader 表执行 UPDATE 操作后触发的第一个触发器。
USE AdventureWorks2012;
GO
sp_settriggerorder @triggername= 'Sales.uSalesOrderHeader', @order='First', @stmttype = 'UPDATE';
B.设置 DDL 触发器的触发顺序
以下示例指定触发器 ddlDatabaseTriggerLog 是对 AdventureWorks2012 数据库执行 ALTER_TABLE 操作后触发的第一个触发器。
USE AdventureWorks2012;
GO
sp_settriggerorder @triggername= 'ddlDatabaseTriggerLog', @order='First', @stmttype = 'ALTER_TABLE', @namespace = 'DATABASE';