Настройка DbContext в EF Core 7.0+ с учетом новых требований к триггерам

Вышла вот такая новость: https://learn.microsoft.com/ru-ru/ef/core/what-is-new/ef-core-7.0/breaking-changes?tabs=v7#sqlserver-tables-with-triggers

«Начиная с EF Core 8.0, можно явно настроить использование или не предложение OUTPUT.»
Что это за предложение OUTPUT такое? Как надо изменять DbContext теперь, если в таблице есть триггеры?

Что изменилось в EF Core 8.0 в отношении таблиц с триггерами?

В EF Core 7 и более ранних версиях, если у таблицы был триггер, EF Core автоматически отключал использование OUTPUT-clause при вставке, обновлении или удалении данных.

В EF Core 8.0 появился явный контроль над тем, использовать OUTPUT или нет. Теперь нужно вручную указывать, требуется ли использование OUTPUT или его отключение.

---

Что такое предложение OUTPUT?

OUTPUT — это предложение в INSERT, UPDATE и DELETE-запросах в SQL Server, которое позволяет сразу получить данные о вставленных, обновленных или удаленных строках.

Пример:

INSERT INTO Customers (Name) 
OUTPUT inserted.Id, inserted.Name 
VALUES ('John Doe');

Здесь OUTPUT inserted.Id, inserted.Name возвращает вставленный Id и Name, что позволяет сразу получить новый Id.

---

Почему это важно для таблиц с триггерами?

При наличии триггера в SQL Server использование OUTPUT не поддерживается, если этот триггер изменяет вставляемые, обновляемые или удаляемые данные. Поэтому в EF Core 7 автоматически отключалось OUTPUT, если в таблице был триггер.

В EF Core 8 это теперь настраивается вручную.

---

Как изменить DbContext?

Теперь в OnModelCreating можно настроить это через UseOutputClauseWhen:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<MyEntity>()
        .UseOutputClauseWhen(UpdateBehavior.Never);
}

Где UpdateBehavior может быть:

• Never – не использовать OUTPUT (если есть триггеры, этот вариант безопаснее).
• Always – всегда использовать OUTPUT (даже если в таблице есть триггер).
• WhenNoTriggers – использовать OUTPUT, если в таблице нет триггеров (это старое поведение EF Core 7).

Если у вас таблица с триггерами, то правильнее всего указывать Never, чтобы избежать ошибок при выполнении запросов.

---

Вывод

В EF Core 8, если у таблицы есть триггер, нужно явно отключать OUTPUT через .UseOutputClauseWhen(UpdateBehavior.Never). В EF Core 7 это происходило автоматически, но теперь этот процесс контролируется вручную.

Библиотека EfCore.BulkExtensions использует Output?

Да, EfCore.BulkExtensions использует OUTPUT по умолчанию при выполнении массовых операций (BulkInsert, BulkUpdate, BulkDelete, BulkMerge).

---

Как OUTPUT используется в EfCore.BulkExtensions?

В SQL Server библиотека использует OUTPUT INSERTED.* или OUTPUT DELETED.* для возврата вставленных, обновленных или удаленных данных. Это нужно, например, для:

• Получения Id новых записей после BulkInsert.
• Возвращения обновленных значений при BulkUpdate.
• Оптимизации BulkMerge.

Пример SQL-запроса, который выполняется в BulkInsert:

INSERT INTO MyTable (Column1, Column2)
OUTPUT INSERTED.Id, INSERTED.Column1, INSERTED.Column2
VALUES (@Column1, @Column2);

---

Как избежать проблем с таблицами, содержащими триггеры?

Если у таблицы есть триггер, использование OUTPUT приведет к ошибке в SQL Server. Чтобы отключить OUTPUT, нужно установить опцию SetOutputIdentity = false в BulkConfig:

await context.BulkInsertAsync(myEntities, new BulkConfig
{
    SetOutputIdentity = false // Отключает использование OUTPUT
});

По умолчанию SetOutputIdentity = true, поэтому если у вас есть триггеры, обязательно отключайте его вручную, иначе получите ошибку.

---

Вывод

1. Да, EfCore.BulkExtensions использует OUTPUT по умолчанию.
2. Если в таблице есть триггер, вам нужно явно отключить OUTPUT, установив SetOutputIdentity = false в BulkConfig.
3. Это важно, чтобы избежать ошибок в SQL Server при массовых операциях с таблицами, содержащими триггеры.

А если триггер изменяет данные AFTER UPDATE? это тоже создаст ошибку?

Что будет, если триггер изменяет данные AFTER UPDATE?

Да, это может вызвать ошибку, если EfCore.BulkExtensions использует OUTPUT при BulkUpdate.

Почему возникает ошибка?

В SQL Server, если у таблицы есть триггер AFTER UPDATE, и при этом выполняется UPDATE с OUTPUT inserted.*, то SQL Server не позволяет использовать OUTPUT, потому что триггер может изменить данные после выполнения UPDATE.

Пример ошибки:

The target table 'MyTable' of the DML statement cannot have any enabled triggers if the statement contains an OUTPUT clause without INTO clause.

Как избежать ошибки?

Если у таблицы есть триггер AFTER UPDATE, то в BulkUpdate нужно отключить OUTPUT, иначе операция завершится с ошибкой.

Используйте:

await context.BulkUpdateAsync(myEntities, new BulkConfig
{
    SetOutputIdentity = false // Отключает OUTPUT
});

Когда ошибки не будет?

Ошибка не возникает, если:

1. Триггер не изменяет данные (например, просто логирует изменения).
2. Вы используете BulkUpdateOrInsert (BulkMerge) без OUTPUT.
3. Триггер работает INSTEAD OF UPDATE, а не AFTER UPDATE.

---

Вывод

• Если триггер AFTER UPDATE изменяет данные, EfCore.BulkExtensions с OUTPUT выдаст ошибку.
• Решение: Отключить OUTPUT, добавив SetOutputIdentity = false в BulkConfig.

builder.Entity(options=>options.ToTable(tb => tb.UseSqlOutputClause(false)));
можно ли вот так записать?

Да, в EF Core 8 можно использовать UseSqlOutputClause(false) для отключения OUTPUT на уровне таблицы.

Вот правильный синтаксис:

builder.Entity<DbProduct>(options =>
    options.ToTable(tb => tb.UseSqlOutputClause(false))
);

Как это работает?

• ToTable(tb => tb.UseSqlOutputClause(false)) указывает, что EF Core не должен использовать OUTPUT-clause для данной таблицы.
• Это эквивалентно UseOutputClauseWhen(UpdateBehavior.Never), но применяется на уровне конфигурации таблицы, а не отдельной сущности.

Когда использовать?

• Если у таблицы есть триггеры AFTER INSERT/UPDATE/DELETE, которые модифицируют данные.
• Если EfCore.BulkExtensions используется и вызывает ошибки из-за OUTPUT.
• Если SQL Server выдает ошибку: pgsqlКопироватьРедактироватьThe target table of the DML statement cannot have any enabled triggers if the statement contains an OUTPUT clause.

Вывод

Этот вариант записи корректен и подойдет, если у вас EF Core 8+.

А мы отключаем output для таблицы, в которой создан триггер? или для таблиц, в которых триггер меняет данные? триггер может менять данные в других таблицах

Отключение OUTPUT с помощью UseSqlOutputClause(false) или UseOutputClauseWhen(UpdateBehavior.Never) применяется только к той таблице, в которой выполняется операция INSERT, UPDATE или DELETE.

Когда нужно отключать OUTPUT?

1. Если триггер есть в целевой таблице (той, в которой выполняется INSERT, UPDATE или DELETE).
2. Не важно, изменяет ли триггер другие таблицы — главное, что он есть в самой таблице, над которой выполняется операция.

---

Когда не нужно отключать OUTPUT?

• Если триггер есть в другой таблице, которую он модифицирует, но не в той, в которую вставляются/обновляются данные.
• Если триггер не изменяет данные, а только выполняет логирование или отправку уведомлений.

---

Пример проблемы

Если у нас есть таблица Orders с триггером AFTER UPDATE, который модифицирует Inventory, то:

CREATE TRIGGER trg_UpdateInventory
ON Orders
AFTER UPDATE
AS
BEGIN
    UPDATE Inventory
    SET Stock = Stock - 1
    WHERE ProductId IN (SELECT ProductId FROM inserted);
END;

При выполнении:

await context.BulkUpdateAsync(orderList, new BulkConfig
{
    SetOutputIdentity = true
});

SQL Server выдаст ошибку, так как в Orders есть триггер, даже если он меняет Inventory.

Как исправить?

Включаем UseSqlOutputClause(false) для Orders, но не для Inventory:

builder.Entity<Order>()
    .ToTable(tb => tb.UseSqlOutputClause(false));

или:

builder.Entity<Order>()
    .UseOutputClauseWhen(UpdateBehavior.Never);

---

Вывод

Отключать OUTPUT нужно только для таблицы, где есть триггер, независимо от того, изменяет ли он другие таблицы.