Короткие транзакции и каноничный шаблон

Директивный

v8std#std783 диагностикаBeginTransactionBeforeTryCatch диагностикаCommitTransactionOutsideTryCatch диагностикаPairingBrokenTransaction диагностикаWrongUseOfRollbackTransactionMethod

#транзакции #надёжность #проведение

Правило

Транзакции держите короткими: внутри — только работа с данными ИБ. Запрещены внутри транзакции:

обращения к внешним системам (HTTP-вызовы, отправка почты, файловые операции по сети);
интерактивные действия и ожидания (диалоги, Приостановить);
долгие вычисления, которые можно выполнить до начала транзакции.

Оформление — только каноничным шаблоном: НачатьТранзакцию() перед Попытка, ЗафиксироватьТранзакцию() — последним оператором блока Попытка, ОтменитьТранзакцию() — первым в Исключение, затем ВызватьИсключение;.

Зачем

Пока транзакция открыта, удерживаются блокировки: все параллельные сеансы, которым нужны те же данные, ждут. Долгая транзакция с HTTP-вызовом внутри означает, что таймаут внешней системы (30–300 секунд) становится временем блокировки ваших документов — очередь проведения, ошибки «конфликт блокировок», зависшие сеансы. Нарушенный шаблон (фиксация вне Попытка, отсутствие отката) оставляет транзакцию открытой или прячет ошибку.

НачатьТранзакцию();
Документ.Записать();
// Внешний вызов под открытой транзакцией: её длительность
// теперь равна таймауту внешней системы.
Ответ = HTTPСоединение.ОтправитьЗапрос(Запрос);
ЗафиксироватьТранзакцию(); // и фиксация вне Попытки: при ошибке — незакрытая транзакция

// Всё внешнее — до или после транзакции.
ДанныеДляЗаписи = ПодготовитьДанные(); // долгие вычисления заранее

НачатьТранзакцию();
Попытка
    Блокировка = Новый БлокировкаДанных;
    // ... установить блокировки, записать данные
    Документ.Записать();
    ЗафиксироватьТранзакцию();
Исключение
    ОтменитьТранзакцию();
    ЗаписьЖурналаРегистрации(НСтр("ru='Проведение'"),
        УровеньЖурналаРегистрации.Ошибка, , ,
        ПодробноеПредставлениеОшибки(ИнформацияОбОшибке()));
    ВызватьИсключение;
КонецПопытки;

ОтправитьУведомление(); // внешний вызов — после фиксации

Вложенные транзакции — это счётчик

В 1С нет настоящих вложенных транзакций: НачатьТранзакцию() внутри уже открытой транзакции лишь увеличивает счётчик, а реальная фиксация происходит на самом внешнем ЗафиксироватьТранзакцию(). Отсюда два следствия:

ОтменитьТранзакцию() на любом уровне вложенности помечает на откат всю транзакцию, а не «свой» кусок;
исключение, проглоченное внутри вложенного блока, не спасает внешнюю транзакцию — она уже помечена, и внешняя фиксация упадёт с «В данной транзакции уже происходили ошибки».

НачатьТранзакцию();
Попытка
    ЗаписатьОсновное();
    Попытка
        ЗаписатьСвязанное(); // внутри — свой каноничный шаблон, при ошибке откат
    Исключение
        // «Связанное не критично, продолжаем» — но транзакция уже помечена
    КонецПопытки;
    ЗафиксироватьТранзакцию(); // «В данной транзакции уже происходили ошибки»
Исключение
    ОтменитьТранзакцию();
    ВызватьИсключение;
КонецПопытки;

// Необязательная часть — отдельной транзакцией ПОСЛЕ фиксации основной,
// а не «вложенно с проглатыванием».
НачатьТранзакцию();
Попытка
    ЗаписатьОсновное();
    ЗафиксироватьТранзакцию();
Исключение
    ОтменитьТранзакцию();
    ВызватьИсключение;
КонецПопытки;

ЗаписатьСвязанноеСОбработкойОшибки(); // своя транзакция, свой шаблон, ошибка в ЖР

Каждая процедура, работающая с транзакцией, использует каноничный шаблон и пробрасывает исключение наружу — тогда вложенные вызовы безопасны: любой сбой докатывается до внешнего уровня и откатывает всё целиком. Решение «часть данных необязательна» принимается структурой вызовов (две транзакции), а не проглатыванием ошибки внутри одной.

Когда не применять

Исключений из шаблона оформления нет. Для длительности: если бизнес-операция требует записи во внешнюю систему «атомарно» с записью в ИБ — не растягивайте транзакцию, а стройте идемпотентный сценарий с повтором: записать локально → отправить вовне → отметить факт отправки.

Короткие транзакции и каноничный шаблон

Правило

Зачем

Вложенные транзакции — это счётчик

Когда не применять

См. также