sp_settriggerorder (Transact-SQL)

适用于:SQL Server (所有受支持的版本) Azure SQL数据库Azure SQL 托管实例

指定第一个激发或最后一个激发的 AFTER 触发器。 在第一个和最后一个触发器之间激发的 AFTER 触发器将按未定义的顺序执行。

主题链接图标Transact-SQL 语法约定

语法

  
sp_settriggerorder [ @triggername = ] '[ triggerschema. ] triggername'   
    , [ @order = ] 'value'   
    , [ @stmttype = ] 'statement_type'   
    [ , [ @namespace = ] { 'DATABASE' | 'SERVER' | NULL } ]  

参数

[ @triggername = ] '[ _triggerschema.] _triggername' 触发器的名称及其所属架构(如果适用),其顺序是要设置或更改的。 [triggerschema.]triggernamesysname。 如果名称与触发器不对应,或者名称与 INSTEAD OF 触发器对应,则该过程将返回错误。 不能为 DDL 或登录触发器指定 triggerschema

[ @order = ] 'value' 触发器的新顺序的设置。 值为varchar (10) ,可以是以下任一值。

重要

第一个和最后一个触发器必须是两个不同的触发器。

描述
第一个 触发器被第一个触发。
上一次 触发器被最后一个触发。
触发器以未定义的顺序触发。

[ @stmttype = ] 'statement_type' 指定触发触发器的 SQL 语句。 statement_typevarchar (50) ,可以是 DDL 事件中列出的 INSERT、UPDATE、DELETE、LOGON 或任何 Transact-SQL 语句事件。 不能指定事件组。

只有在该触发器定义为该语句类型的触发器后,才能将触发器指定为语句类型的 一个或 最后 一个触发器。 例如,如果 TR1 定义为 INSERT 触发器,则可以为表 T1 上的 INSERT 指定触发器 TR1 如果 TR1 仅定义为 INSERT 触发器,则数据库引擎将返回错误,该触发器设置为 UPDATE 语句 的 FirstLast 触发器。 有关详细信息,请参阅“备注”部分。

@namespace= { 'DATABASE' | 'SERVER' |NULL }
triggername 是 DDL 触发器时, @namespace 指定是使用数据库范围还是服务器范围创建 triggername 。 如果 triggername 是登录触发器,则必须指定 SERVER。 有关 DDL 触发器范围的详细信息,请参阅 DDL 触发器。 如果未指定,或者指定 NULL, 则 triggername 为 DML 触发器。

  • SERVER 适用于:SQL Server 2008 及更高版本。

返回代码值

0 (成功) 和 1 (失败)

备注

DML 触发器

单个表上每个语句只能有一个 First 和一个 Last 触发器。

如果第个触发器已在表、数据库或服务器上定义,则不能为同一个表、数据库或服务器的同一 statement_type个表、数据库或服务器指定一个新触发器。 此限制还应用 最后 一个触发器。

复制将为包含在立即更新订阅或排队更新订阅中的任意表自动生成第一个触发器。 复制要求其触发器为第一个触发器。 在尝试将带有第一个触发器的表包含在立即更新订阅或排队更新订阅中时,复制将引发错误。 如果在表已经包含在订阅中之后尝试使某个触发器成为第一个触发器, sp_settriggerorder 将返回错误。 如果在复制触发器上使用 ALTER TRIGGER,或使用 sp_settriggerorder 将复制触发器更改为 “最后 ”或 “无 ”触发器,则订阅无法正常工作。

DDL 触发器

如果具有数据库范围的 DDL 触发器和服务器范围的 DDL 触发器存在于同一事件上,则可以指定这两个触发器都是 First 触发器或 最后 一个触发器。 但是,服务器作用域的触发器始终最先触发。 一般情况下,同一事件中 DDL 触发器的执行顺序如下:

  1. 标记为 First 的服务器级触发器。

  2. 其他服务器级触发器。

  3. 标记为 Last 的服务器级触发器。

  4. 标记为 First 的数据库级触发器。

  5. 其他数据库级触发器。

  6. 标记为 Last 的数据库级触发器。

常规触发器注意事项

如果 ALTER TRIGGER 语句更改了第一个或最后一个触发器,则最初在触发器上设置 的第一 个或 最后 一个属性将被删除,并且该值将被 None 替换。 必须使用 sp_settriggerorder重置订单值。

如果必须将同一触发器指定为多个语句类型的第一个或最后一个顺序,则必须为每个语句类型执行 sp_settriggerorder 。 此外,必须先为语句类型定义触发器,然后才能将其指定为 第一 个或 最后 一个触发器来触发该语句类型。

权限

若要设置具有服务器作用域(使用 ON ALL SERVER 创建)的 DDL 触发器或登录触发器的顺序,需要具有 CONTROL SERVER 权限。

若要设置具有数据库作用域(使用 ON DATABASE 创建)的 DDL 触发器的顺序,需要具有 ALTER ANY DATABASE DDL TRIGGER 权限。

若要设置 DML 触发器的顺序,需要对要在其中定义该触发器的表或视图具有 ALTER 权限。

示例

A. 设置 DML 触发器的触发顺序

以下示例指定触发器 uSalesOrderHeader 是对 UPDATE 表执行 Sales.SalesOrderHeader 操作后触发的第一个触发器。

USE AdventureWorks2012;  
GO  
sp_settriggerorder @triggername= 'Sales.uSalesOrderHeader', @order='First', @stmttype = 'UPDATE';  

B. 设置 DDL 触发器的触发顺序

以下示例指定在 ddlDatabaseTriggerLogAdventureWorks2012 数据库中发生事件后触发的第一个ALTER_TABLE触发器。

USE AdventureWorks2012;  
GO  
sp_settriggerorder @triggername= 'ddlDatabaseTriggerLog', @order='First', @stmttype = 'ALTER_TABLE', @namespace = 'DATABASE';  

另请参阅

系统存储过程 (Transact-SQL)
数据库引擎存储过程 (Transact-SQL)
ALTER TRIGGER (Transact-SQL)