Использование таблиц inserted и deletedUse the inserted and deleted Tables

ОБЛАСТЬ ПРИМЕНЕНИЯ: даSQL Server даБаза данных SQL Azure нетAzure Synapse Analytics (хранилище данных SQL) нетParallel Data WarehouseAPPLIES TO: yesSQL Server yesAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Инструкции триггеров DML используют две особые таблицы: deleted и inserted.DML trigger statements use two special tables: the deleted table and the inserted tables. SQL ServerSQL Server автоматически создает эти таблицы и управляет ими.automatically creates and manages these tables. Эти временные таблицы, находящиеся в оперативной памяти, используются для проверки результатов изменений данных и для установки условий срабатывания триггеров DML.You can use these temporary, memory-resident tables to test the effects of certain data modifications and to set conditions for DML trigger actions. Нельзя в этих таблицах изменять данные напрямую или выполнять над ними операции языка описания данных DDL, например инструкцию CREATE INDEX.You cannot directly modify the data in the tables or perform data definition language (DDL) operations on the tables, such as CREATE INDEX.

В триггерах DML таблицы inserted и deleted в основном используются для выполнения следующих операций.In DML triggers, the inserted and deleted tables are primarily used to perform the following:

  • Расширение ссылочной целостности между таблицами.Extend referential integrity between tables.

  • Вставка или обновление данных в базовых таблицах соответствующего представления.Insert or update data in base tables underlying a view.

  • Проверка на ошибки и принятие соответствующих мер в связи с появлением ошибок.Test for errors and take action based on the error.

  • Поиск различий между состояниями таблицы до и после изменения данных и принятие соответствующих мер в зависимости от наличия или отсутствия различий.Find the difference between the state of a table before and after a data modification and take actions based on that difference.

В таблице deleted находятся копии строк, с которыми работали инструкции DELETE или UPDATE.The deleted table stores copies of the affected rows during DELETE and UPDATE statements. При выполнении инструкции DELETE или UPDATE происходит удаление строк из таблицы триггера и их перенос в таблицу deleted.During the execution of a DELETE or UPDATE statement, rows are deleted from the trigger table and transferred to the deleted table. У таблицы deleted обычно нет общих строк с таблицей триггера.The deleted table and the trigger table ordinarily have no rows in common.

В таблице inserted находятся копии строк, с которыми работали инструкции INSERT или UPDATE.The inserted table stores copies of the affected rows during INSERT and UPDATE statements. При выполнении транзакции вставки или обновления происходит одновременное добавление строк в таблицу триггера и в таблицу inserted.During an insert or update transaction, new rows are added to both the inserted table and the trigger table. Строки таблицы inserted являются копиями новых строк таблицы триггера.The rows in the inserted table are copies of the new rows in the trigger table.

Транзакция обновления аналогична выполнению операции удаления с последующим выполнением операции вставки; сначала старые строки копируются в таблицу deleted, а затем новые строки копируются в таблицу триггера и в таблицу inserted.An update transaction is similar to a delete operation followed by an insert operation; the old rows are copied to the deleted table first, and then the new rows are copied to the trigger table and to the inserted table.

При задании условий триггера используйте таблицы inserted и deleted соответственно действию, заставившему триггер сработать.When you set trigger conditions, use the inserted and deleted tables appropriately for the action that fired the trigger. Хотя ссылка на таблицу deleted при проверке инструкции INSERT или ссылка на таблицу inserted при проверке инструкции DELETE не приводит к появлению ошибок, но данные тестовые таблицы триггера все равно не содержат в таких случаях никаких строк.Although referencing the deleted table when testing an INSERT or the inserted table when testing a DELETE does not cause any errors, these trigger test tables do not contain any rows in these cases.

Примечание

Если действия триггера зависят от числа строк, данные в которых были изменены, воспользуйтесь проверками (например, проверкой параметра @@ROWCOUNT) при изменении данных в нескольких строках (инструкции INSERT, DELETE или UPDATE с инструкцией SELECT), а затем предпринимайте соответствующие действия.If trigger actions depend on the number of rows a data modification effects, use tests (such as an examination of @@ROWCOUNT) for multirow data modifications (an INSERT, DELETE, or UPDATE based on a SELECT statement), and take appropriate actions.

SQL Server 2019 (15.x)SQL Server 2019 (15.x) не позволяет ссылаться на столбцы типов text, ntextили image в таблицах inserted и deleted триггеров AFTER.does not allow for text, ntext, or image column references in the inserted and deleted tables for AFTER triggers. Однако эти типы данных включены в целях обратной совместимости.However, these data types are included for backward compatibility purposes only. Для хранения больших данных рекомендуется использовать типы данных varchar(max) , nvarchar(max) и varbinary(max) .The preferred storage for large data is to use the varchar(max), nvarchar(max), and varbinary(max) data types. Как триггеры AFTER, так и триггеры INSTEAD OF поддерживают данные типов varchar(max) , nvarchar(max) и varbinary(max) в таблицах inserted и deleted.Both AFTER and INSTEAD OF triggers support varchar(max), nvarchar(max), and varbinary(max) data in the inserted and deleted tables. Дополнительные сведения см. в разделе CREATE TRIGGER (Transact-SQL).For more information, see CREATE TRIGGER (Transact-SQL).

Примеры использования таблицы inserted в триггере для выполнения бизнес-правилAn Example of Using the inserted Table in a Trigger to Enforce Business Rules

Поскольку ограничение CHECK может содержать ссылки только на столбцы, для которых определены ограничения на уровне столбцов или таблицы, любые межтабличные ограничения (в данном случае бизнес-правила) должны быть заданы в виде триггеров.Because CHECK constraints can reference only the columns on which the column-level or table-level constraint is defined, any cross-table constraints (in this case, business rules) must be defined as triggers.

В следующем примере создается триггер DML.The following example creates a DML trigger. Этот триггер проверяет уровень кредитоспособности поставщика при попытке добавить новый заказ на покупку в таблицу PurchaseOrderHeader .This trigger checks to make sure the credit rating for the vendor is good when an attempt is made to insert a new purchase order into the PurchaseOrderHeader table. Чтобы получить оценку кредитоспособности поставщика, связанного с только что добавленным заказом на покупку, таблица inserted должна ссылаться на таблицу Vendor и быть связана с ней.To obtain the credit rating of the vendor corresponding to the purchase order that was just inserted, the Vendor table must be referenced and joined with the inserted table. В случае слишком низкой кредитоспособности выводится соответствующее сообщение и вставка не выполняется.If the credit rating is too low, a message is displayed and the insertion does not execute. Обратите внимание, что в этом примере не допускается изменение многострочных данных.Note that this example does not allow for multirow data modifications. Дополнительные сведения см. в статье Создание триггеров DML для обработки нескольких строк данных.For more information, see Create DML Triggers to Handle Multiple Rows of Data.

USE AdventureWorks2012;
GO
IF OBJECT_ID ('Purchasing.LowCredit','TR') IS NOT NULL
   DROP TRIGGER Purchasing.LowCredit;
GO
-- This trigger prevents a row from being inserted in the Purchasing.PurchaseOrderHeader table
-- when the credit rating of the specified vendor is set to 5 (below average).

CREATE TRIGGER Purchasing.LowCredit ON Purchasing.PurchaseOrderHeader
AFTER INSERT
AS
IF EXISTS (SELECT *
           FROM Purchasing.PurchaseOrderHeader p 
           JOIN inserted AS i 
           ON p.PurchaseOrderID = i.PurchaseOrderID 
           JOIN Purchasing.Vendor AS v 
           ON v.BusinessEntityID = p.VendorID
           WHERE v.CreditRating = 5
          )
BEGIN
RAISERROR ('A vendor''s credit rating is too low to accept new
purchase orders.', 16, 1);
ROLLBACK TRANSACTION;
RETURN 
END;
GO

-- This statement attempts to insert a row into the PurchaseOrderHeader table
-- for a vendor that has a below average credit rating.
-- The AFTER INSERT trigger is fired and the INSERT transaction is rolled back.

INSERT INTO Purchasing.PurchaseOrderHeader (RevisionNumber, Status, EmployeeID,
VendorID, ShipMethodID, OrderDate, ShipDate, SubTotal, TaxAmt, Freight)
VALUES (
2
,3
,261	
,1652	
,4	
,GETDATE()
,GETDATE()
,44594.55	
,3567.564	
,1114.8638 );
GO

Использование таблиц inserted и deleted в триггерах INSTEAD OFUsing the inserted and deleted Tables in INSTEAD OF Triggers

Таблицы inserted и deleted в триггерах INSTEAD OF подчиняются тем же правилам, что и таблицы inserted и deleted в триггерах AFTER.The inserted and deleted tables passed to INSTEAD OF triggers defined on tables follow the same rules as the inserted and deleted tables passed to AFTER triggers. Формат таблиц inserted и deleted совпадает с форматом таблицы, для которой задан триггер INSTEAD OF.The format of the inserted and deleted tables is the same as the format of the table on which the INSTEAD OF trigger is defined. Каждый столбец таблиц inserted и deleted прямо сопоставляется с определенным столбцом базовой таблицы.Each column in the inserted and deleted tables maps directly to a column in the base table.

Следующие правила относятся к инструкциям INSERT или UPDATE, ссылающимся на таблицу с триггером INSTEAD OF, которые должны предоставлять такие значения для столбцов, как если бы в таблице не было триггера INSTEAD OF.The following rules regarding when an INSERT or UPDATE statement referencing a table with an INSTEAD OF trigger must supply values for columns are the same as if the table did not have an INSTEAD OF trigger:

  • Не могут быть заданы значения для вычисляемых столбцов и для столбцов с типом данных timestamp .Values cannot be specified for computed columns or columns with a timestamp data type.

  • Если параметр IDENTITY_INSERT для этой таблицы не равен ON, то значения для столбцов со свойством IDENTITY не могут быть заданы.Values cannot be specified for columns with an IDENTITY property, unless IDENTITY_INSERT is ON for that table. Когда значение параметра IDENTITY_INSERT равно ON, инструкции INSERT должны сами задавать это значение.When IDENTITY_INSERT is ON, INSERT statements must supply a value.

  • Инструкции INSERT должны определять значения для всех столбцов со свойством NOT NULL, не имеющих ограничений DEFAULT.INSERT statements must supply values for all NOT NULL columns that do not have DEFAULT constraints.

  • Для любого столбца, кроме вычисляемых столбцов, столбцов определителя и столбцов типа timestamp , определение значений является необязательным, если разрешены NULL значения или если какой-либо столбец со свойством NOT NULL обладает определением DEFAULT.For any columns except computed, identity, or timestamp columns, values are optional for any column that allows nulls, or any NOT NULL column that has a DEFAULT definition.

Если инструкция INSERT, UPDATE или DELETE ссылается на представление, для которого определен триггер INSTEAD OF, компонент Компонент Database EngineDatabase Engine вызывает триггер вместо того, чтобы предпринять какое-либо прямое действие по отношению к таблице.When an INSERT, UPDATE, or DELETE statement references a view that has an INSTEAD OF trigger, the Компонент Database EngineDatabase Engine calls the trigger instead of taking any direct action against any table. Триггер использует сведения, представленные в таблицах inserted и deleted, для создания инструкций, необходимых для выполнения требуемых действий в базовых таблицах, даже в том случае, если формат данных в таблицах inserted и deleted, созданных для представления, отличается от формата данных базовой таблицы.The trigger must use the information presented in the inserted and deleted tables to build any statements required to implement the requested action in the base tables, even when the format of the information in the inserted and deleted tables built for the view is different from the format of the data in the base tables.

Формат таблиц inserted и deleted триггера INSTEAD OF, заданного для представления, совпадает со списком выборки инструкции SELECT, заданной для представления.The format of the inserted and deleted tables passed to an INSTEAD OF trigger defined on a view matches the select list of the SELECT statement defined for the view. Пример:For example:

USE AdventureWorks2012;  
GO  
CREATE VIEW dbo.EmployeeNames (BusinessEntityID, LName, FName)  
AS  
SELECT e.BusinessEntityID, p.LastName, p.FirstName  
FROM HumanResources.Employee AS e   
JOIN Person.Person AS p  
ON e.BusinessEntityID = p.BusinessEntityID;  

Результирующий набор для этого представления содержит три столбца: один int и два nvarchar .The result set for this view has three columns: an int column and two nvarchar columns. Таблицы inserted и deleted триггера INSTEAD OF, заданного для представления, также содержат столбец типа int с именем BusinessEntityID, столбец типа nvarchar с именем LNameи столбец типа nvarchar с именем FName.The inserted and deleted tables passed to an INSTEAD OF trigger defined on the view also have an int column named BusinessEntityID, an nvarchar column named LName, and an nvarchar column named FName.

Список выборки представления также может содержать выражения, которые не сопоставлены напрямую с каким-либо одним столбцом базовой таблицы.The select list of a view can also contain expressions that do not directly map to a single base-table column. Некоторые выражения представления, такие как вызов функции или константы, могут не ссылаться на столбцы и просто пропускаться.Some view expressions, such as a constant or function invocation, may not reference any columns and can be ignored. Сложные выражения могут ссылаться на несколько столбцов, однако таблицы inserted и deleted содержат только по одному значению для каждой вставляемой строки.Complex expressions can reference multiple columns, yet the inserted and deleted tables have only one value for each inserted row. Такие же проблемы появляются и в простых выражениях представления, если они ссылаются на вычисляемый столбец со сложным выражением.The same issues apply to simple expressions in a view if they reference a computed column that has a complex expression. Триггер INSTEAD OF в представлении должен обрабатывать такие типы выражений.An INSTEAD OF trigger on the view must handle these types of expressions.