sp_settriggerorder (Transact-SQL)

适用于:SQL ServerAzure 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) ,可以是 INSERT、UPDATE、DELETE、LOGON 或 DDL Events 中列出的任何 Transact-SQL 语句事件。 不能指定事件组。

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

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

  • SERVER 适用于:SQL Server 2008 (10.0.x) 及更高版本。

返回代码值

0 (成功) 和 1 (失败)

注解

DML 触发器

单个表上的每个语句只能有一个 FirstLast 触发器。

如果已在表、数据库或服务器上定义了 First 触发器,则不能为同一个表、数据库或服务器指定同一个statement_type的新触发器为 First。 此限制也适用于 上次 触发器。

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

DDL 触发器

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

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

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

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

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

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

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

常规触发器注意事项

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

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

权限

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

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

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

示例

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

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

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

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

以下示例指定触发器 ddlDatabaseTriggerLog 是对 AdventureWorks2022 数据库执行 ALTER_TABLE 操作后触发的第一个触发器。

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

另请参阅

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