Транзакция - это неделимая, с точки зрения воздействия на базу данных, последовательность операций манипулирования данными, выполняющаяся по принципу «все или ничего», и переводящая базу данных из одного целостного состояния в другое целостное состояние.
Если по каким-либо причинам одно из действий транзакции невыполнимо или произошло какое-либо нарушение работы системы, база данных возвращается в то состояние, которое было до начала транзакции (происходит откат транзакции).
Блокировка (в общем случае) - это информация о том, что данный ресурс "захвачен" кем-то для выполнения какого-то действия.
Суть блокировки:
- запрет некоторых действий над общим ресурсом на некоторое ограниченное время.
В силу различных причин блокировки могут быть:
- необходимыми («хорошими») - благодаря им обеспечивается предсказуемость действий пользователей, целостность и непротиворечивость данных;
- избыточными («плохими»).
В системе 1С:Предприятие 8 различают:
- объектные блокировки (позволяют осуществлять конкурентный доступ пользователей к данным 1С:Предприятия в терминах объектов информационной базы, например, при интерактивной работе пользователей в формах: редактировании существующих объектов, удалении, создании новых и др.);
- транзакционные блокировки (обеспечивают конкурентный доступ к данным в целях целостности и непротиворечивости хранимых данных).
Механизм объектных блокировок в 1С
Виды блокировок объектов базы данных 1С:
- объектная пессимистическая;
- объектная оптимистическая;
Объектная пессимистическая блокировка
Пессимистическая блокировка объектов базы данных предназначена для запрета изменения данных определенного объекта другими сеансами или данным сеансом до тех пор, пока блокировка не будет снята этим объектом встроенного языка.
При этом блокировка данных для редактирования не запрещает запись заблокированных данных в других пользовательских сеансах (или в других экземплярах объекта в этом же сеансе), а лишь не позволяет нескольким объектам одновременно установить блокировку одних и тех же данных.
Пессимистическая блокировка объектов базы данных:
- используется системой 1С:Предприятие для блокировки объектов, редактируемых в форме;
- устанавливается:
- автоматически - в момент начала модификации объекта в форме, указанного в качестве основного реквизита формы (при этом если другой пользователь попытается выполнить редактирование того же объекта, ему будет выдано сообщение о том, что не удалось заблокировать объект);
- программно - метод объектов Заблокировать() или метод глобального контекста ЗаблокироватьДанныеДляРедактирования().
- снимается, когда пользователь, редактировавший объект, закроет форму объекта.
Войдем в информационную базу под пользователем Иванов, откроем форму элемента 1С:Предприятие 8.0. Управление торговлей справочника Номенклатура (код 12) и изменим цену продажи с 420,00 на 450,00. Не сохраняя сделанные изменения, войдем в информационную базу еще раз, но теперь под именем пользователя Петров. Откроем форму того же элемента справочника и попробуем изменить значение какого-либо реквизита. Любая попытка изменения приведет к появлению специального окна с сообщением об ошибке:
Таким образом пессимистическая блокировка гарантирует, что пользователь, начав изменять данные объекта, сможет записать эти изменения в информационную базу.
Использование объектной пессимистической блокировки
Прежде чем изменять существующий объект информационной базы из кода на встроенном языке, следует предварительно его заблокировать (установить «блокировку данных для редактирования» или «объектную блокировку»), тем самым:
- убедиться, не заблокирован ли он другими объектами;
- попытаться предотвратить его изменение другими пользовательскими сеансами (или другими экземплярами объекта в этом же сеансе).
В противном случае, если при изменении и записи из встроенного языка не устанавливать блокировку объекта на время редактирования, то может возникнуть, например, ситуация, когда пользователь не сможет сохранить свои изменения, если эти же самые данные были конкурентно изменены в другом сеансе.
Пример № 1.
Требуется заблокировать объект и, если это удалось, модифицировать данные. В противном случае – проинформировать пользователя об отказе в выполнении операции с помощью сообщения вида:
«Не удалось заблокировать запись. Действие (изменение, удаление или блокировка записи) не выполнено. Ошибка блокировки объекта. Объект уже заблокирован: компьютер: <имя компьютера>, пользователь: <имя пользователя>, сеанс: <номер сеанса>, начат: <дата и время>, приложение: <тип клиентского приложения>».
|
1 2 3 4 5 6 7 8 |
ФайлОбъект = ДанныеФайла.Ссылка.ПолучитьОбъект(); // Выполнить блокировку объекта от изменения другими режимами // или пользователями; в случае блокировки - // вывести пользователю сообщение об исключении. ФайлОбъект.Заблокировать(); // Затем изменить и записать объект ФайлОбъект.Редактирует = Справочники.Пользователи.ПустаяСсылка(); ФайлОбъект.Записать(); |
Аналогичным образом, можно воспользоваться методом глобального контекста ЗаблокироватьДанныеДляРедактирования:
|
1 2 3 4 5 6 7 8 |
ФайлОбъект = ДанныеФайла.Ссылка.ПолучитьОбъект(); // Выполнить блокировку объекта от изменения другими режимами // или пользователями; в случае блокировки - // вывести пользователю сообщение об исключении. ЗаблокироватьДанныеДляРедактирования(ДанныеФайла.Ссылка); // Затем изменить и записать объект ФайлОбъект.Редактирует = Справочники.Пользователи.ПустаяСсылка(); ФайлОбъект.Записать(); |
Пример № 2.
Требуется пропустить обработку объекта, если он заблокирован для редактирования. При очередном вызове процедуры (например, из фонового или регламентного задания) будет предпринята повторная попытка изменения объекта.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
Объект = ТекущаяВерсия.ПолучитьОбъект(); // Выполнить блокировку объекта от изменения другими режимами // или пользователями УстановитьПолноеНаименование = Истина; Попытка ФайлОбъект.Заблокировать(); Исключение // в случае блокировки - не выполнять изменение объекта УстановитьПолноеНаименование = Ложь; // записать предупреждение в журнал регистрации ЗаписьЖурналаРегистрации(НСтр("ru = 'Фоновое обновление имен файлов'", Метаданные.ОсновнойЯзык.КодЯзыка), УровеньЖурналаРегистрации.Предупреждение,, ФайлОбъект, ОписаниеОшибки()); КонецПопытки; // Пропустить обработку объекта, если он заблокирован. Если УстановитьПолноеНаименование Тогда Объект.ПолноеНаименование = ПолноеНаименование; Объект.Записать(); КонецЕсли; |
Не следует проверять блокировку объектов для редактирования в следующих случаях:
- при выполнении отдельных операций, имеющих по логике работы больший приоритет по сравнению с интерактивными действиями пользователя (например, загрузка данных при обмене);
- при действиях, которые гарантированно выполняются в монопольном режиме (например, в процедурах обновления и первоначального заполнения данных информационной базы).
Для снятия пессимистической блокировки разработчик может использовать метод объекта Разблокировать(), причем использовать его для того же самого экземпляра объекта, для которого ранее была установлена блокировка.
ВАЖНО! Объектные блокировки не влияют на операции над данными и на процесс течения транзакций (они расположены на другом уровне работы с данными):
- если блокировка объекта вызвала исключение, то оно может быть обработано разработчиком конфигурации и не приведет к обязательному откату транзакции;
- блокировки объектов, установленные в течение транзакции, сохраняются при фиксации транзакции и снимаются при откате транзакции.
Объектная оптимистическая блокировка
Оптимистическая блокировка запрещает запись объекта в базу данных, если после считывания объекта он был изменен в базе данных другими сеансами или другими программными объектами этого же сеанса.
Таким образом оптимистическая блокировка гарантирует, что пользователь изменяет актуальные данные объекта, которые хранятся в информационной базе, а не какой-то их предыдущий вариант.
Фактически, оптимистическая блокировка представляет собой проверку, которая выполняется перед записью объекта в базу данных. Эта проверка построена на анализе номера версии объекта, хранящейся в базе данных и номера версии, помещенной в память компьютера в момент считывания данных из информационной базы. Если при записи объекта номера его версий отличаются, то будет выдано предупреждение о том, что версия объекта изменилась или он был удален, то есть сработает оптимистическая блокировка.
Рассмотрим пример. Откроем два сеанса работы с прилагаемой к работе информационной базой: один под пользователем Иванов, а другой - под пользователем Петров. В обоих сеансах откроем откроем форму элемента Управление торговлей справочника Номенклатура (код 12). Теперь в сеансе, открытом от имени пользователя Иванов, изменим цену продажи с 420,00 на 450,00 и запишем сделанные изменения. После этого, в сеансе, открытом от имени пользователя Петров попробуем изменить значение какого-либо реквизита. Любая попытка изменения приведет к появлению другого окна с сообщением об ошибке:
Механизм транзакционных блокировок
Подробнее...
Работа в многопользовательской среде требует соблюдения определенного компромисса между требованиями предсказуемости, целостности и непротиворечивости данных информационной базы и требованиями параллельности работы.
Как известно, при одновременном чтении и изменении одних и тех же данных конкурирующими транзакциями могут возникнуть следующие проблемы одновременного доступа:
- Проблема потерянного изменения (англ. The Lost Update Problem) - если две транзакции изменяют одни и те же данные, взяв в качестве первоисточника начальное значение этих данных, то в системе останутся изменения внесенные той транзакцией, которая записала свои изменения последней, поскольку эти изменения заменят собой все изменения, внесенные до этого. Вывод:
- нельзя одновременно изменять одни и те же данные.
- Проблема «грязного» чтения (англ. The Uncommitted Dependency Problem) - если одна транзакция начнет считывать некоторые данные не дождавшись окончания внесения изменений, вносимых в эти данные другой транзакцией, то достаточно вероятен случай, когда прочитанные данные будут содержать неверную информацию. Вывод:
- нельзя читать уже измененные, но еще не записанные данные.
- Проблема неповторяемого чтения (англ. The Inconsistent Analysis Problem) - если одна транзакция несколько раз считывает одни и те же данные, а вторая - вносит изменения в эти данные между циклами чтения данных первой транзакции, то при повторном считывании первая транзакция может получить другой набор данных. Вывод:
- нельзя повторно читать измененные и записанные данные, если эти же самые данные уже были прочитаны до внесения в них изменений.
- Проблема чтения фантомов (англ. The Phantom Read Problem) - если первая транзакция считывает данные и потом на их основе осуществляет определенные действия, а вторая транзакция в этот момент добавляет в эти данные новую информацию, то как и в предыдущем случае это может привести к некорректному результату. Вывод:
- нельзя вводить новые данные (удалить имеющиеся), если они могут попасть в уже один раз прочитанные данные при повторном чтении.
Строго говоря, список вышеперечисленных проблем не является окончательным.
Уровни изоляции транзакций
Уровни изоляции транзакций в современных СУБД являются механизмом гибкой настройки ограничений, позволяющих:
- допустить параллельное выполнение транзакций ради увеличения производительности системы;
- обеспечить необходимую степень целостности данных (ограничить параллельность транзакций при работе с одними ресурсами).
Например, MS SQL Server 2000 позволяет использовать следующие уровни изоляции транзакции:
- READ UNCOMMITED - незавершенное чтение. Низший уровень изоляции, обеспечивает максимальную параллельность выполнения транзакций. Данный уровень защищает изменяемые текущей (актуальной) транзакцией данные от изменений, которые могут внести конкурирующие транзакции. Если другой транзакции необходимо изменить те же самые данные, то она должна ожидать завершения изменения данных текущей (актуальной) транзакцией. Однако чтение данных разрешено. Таким образом этот уровень изоляции допускает чтение незавершенных изменений данных.
- READ COMMITED - обеспечивает запрет «грязного» чтения. Если текущая (актуальная) транзакция начала изменять данные, то конкурирующая транзакция не может не только изменить, но даже прочитать их до завершения изменений, вносимых текущей (актуальной) транзакцией. После того, как изменения, вносимые текущей (актуальной) транзакцией закончены, конкурирующие транзакции могут читать данные, не дожидаясь окончания текущей (актуальной) транзакции в целом. Таким образом решается проблема неповторяемого чтения.
- REPEATABLE READ - обеспечивает повторяемость чтения данных. Если текущая (актуальная) транзакция начинает читать данные, то другая транзакция не может их изменить до окончания текущей (актуальной) транзакции.
- SERIALIZABLE - последовательное выполнение. Этот уровень изоляции является максимальным и обеспечивает полную изоляцию транзакций друг от друга. Решаются все рассмотренные проблемы, включая проблему «фантомов».
В зависимости от используемого уровня изоляции, СУБД накладывает различные типы блокировок на различные объекты базы данных на различное время.
Режим автоматических блокировок
В режиме автоматических блокировок 1С:Предприятие целиком «полагается» на возможности, предоставляемые СУБД.
Такой подход позволяет разработчику не задумываться о достаточно сложных вопросах блокирования нужных данных в транзакции. Однако СУБД не имеет информации о логической структуре данных 1С:Предприятия, и платформе приходится использовать достаточно высокие уровни изоляции транзакций СУБД для того, чтобы обеспечить целостность и непротиворечивость данных:
| СУБД | ||||
|---|---|---|---|---|
| Файловая база данных | MS SQL Server | IBM DB2 | PostgreSQL | |
| Вид блокировок | Таблиц | Записей | Записей | Таблиц |
| Уровень изоляции транзакций | Serializable | Repeatable Read или Serializable | Serializable | Read Committed |
Режим автоматических блокировок:
-
может привести к возникновению избыточных блокировок;
-
не позволяет достичь желаемой параллельности работы пользователей.
В клиент-серверном варианте блокировка данных происходит на уровне записей, однако может быть заблокирована и вся таблица целиком (например, в результате выбора СУБД неоптимального плана выполнения запроса).
Тип блокировок, устанавливаемых в том или ином случае, зависит от вида операции, используемого 1С:Предприятием уровня изоляции транзакций и определяется внутренними механизмами самой СУБД (например, MS SQL Server).
Режим управляемых блокировок
В 1С:Предприятии реализован дополнительный режим работы, позволяющий использовать собственный менеджер транзакционных блокировок 1С:Предприятия, независимый от используемой СУБД.
Управляемые блокировки 1С:Предприятия учитывают логическую структуру прикладного решения и поэтому позволяют максимально точно блокировать необходимые области данных (в отличие от использовавшихся ранее блокировок СУБД, которым не известна логическая структура системы). Таким образом менеджер управляемых блокировок позволяет избежать возникновения избыточных блокировок, блокируя только действительно необходимые области данных.
При работе в этом режиме система использует гораздо более низкий уровень изоляции транзакций для MS SQL Server и IBM DB2, и блокировку на уровне записей для PostgreSQL, что позволяет достичь более высокой параллельности работы пользователей:
| СУБД | ||||
|---|---|---|---|---|
| Файловая база данных | MS SQL Server | IBM DB2 | PostgreSQL | |
| Вид блокировок | Таблиц | Записей | Записей | Записей |
| Уровень изоляции транзакций | Serializable | Read Committed | Read Committed | Read Committed |
Однако этот уровень изоляции транзакций СУБД уже не может сам по себе обеспечить целостность и непротиворечивость данных во всех случаях. Поэтому 1С:Предприятие 8 при модификации данных методами встроенного языка (например, метод Записать() у объектных данных) устанавливает собственные управляемые блокировки в транзакции, которые обрабатываются собственным менеджером транзакционных блокировок. Эти блокировки также могут быть установлены и разработчиком самостоятельно в тех местах кода, где требуется:
- обеспечить неизменность считываемых в транзакции данных (разделяемая блокировка);
- запретить чтение данных другими транзакциями (исключительная блокировка).
Порядок действия механизма управляемых блокировок:
- любой запрос к данным прежде всего обрабатывается собственным менеджером транзакционных блокировок 1С:Предприятия; если на уровне 1С:Предприятия конфликт управляемых блокировок не обнаруживается, то запрос передается далее, на исполнение СУБД;
- СУБД использует собственный механизм блокировок для определения конфликтующих транзакций, но уже с более низким уровнем изоляции транзакций, чем в режиме автоматических блокировок.
Установка режима управления блокировками для объектов конфигурации
В структуре объектов конфигурации существует несколько возможностей для задания режима управления блокировками:
- через свойство "Режим управления блокировкой данных" в палитре свойств конфигурации и(или) объекта;
- установка управляемых блокировок средствами встроенного языка.
Установка режима управления блокировками через свойство "Режим управления блокировкой данных" в палитре свойств конфигурации или объекта
- режим Автоматический - используются автоматические блокировки, устанавливаемые СУБД. Собственный менеджер блокировок 1C:Предприятия не задействован.
- режим Управляемый - система всегда самостоятельно устанавливает необходимые управляемые блокировки, обрабатываемые собственным менеджером транзакционных блокировок (независимо от того, какие режимы управления блокировками установлены для конкретных объектов конфигурации). Этот режим предназначен для работы всей конфигурации только с управляемыми блокировками в транзакции.
- режим Автоматический и управляемый - для конкретного объекта конфигурации режим блокировки будет определяться значением свойства Режим управления блокировкой данных самого объекта конфигурации. Этот режим предназначен для постепенного или частичного перевода конфигурации в режим управляемых блокировок. Он позволяет отдельным объектам метаданных работать с управляемыми блокировками (например, наиболее «проблемным» документам и регистрам), в то время как остальные объекты работают в режиме автоматических блокировок.
Сочетания режимов управления блокировками в транзакции в режиме Автоматический и управляемый:
| Режим существующей транзакции | Режим начинаемой транзакции | Результат |
|---|---|---|
| Автоматический | Автоматический | Начинаемая транзакция будет выполнена в автоматическом режиме |
| Управляемый | Управляемый | Начинаемая транзакция будет выполнена в управляемом режиме |
| Автоматический | Управляемый | Начинаемая транзакция будет выполнена в автоматическом режиме |
| Управляемый | Автоматический | Будет вызвана исключительная ситуация |
Транзакция, единая для пользователя может представлять собой несколько транзакций с точки зрения платформы.
Интерактивное проведение документа по регистру делает две транзакции:
- запись самого документа;
- внутри этой записи (транзакции) запись набора строк по регистру.
В зависимости от режима управления блокировками для самого документа и двигаемого им регистра, возможны четыре ситуации:
- Режим документа Автоматический, режим регистра Автоматический -> запись по регистру в автоматическом режиме
- Режим документа Управляемый, режим регистра Управляемый-> запись по регистру в управляемом режиме
- Режим документа Автоматический, режим регистра Управляемый -> запись по регистру в автоматическом режиме
- Режим документа Управляемый, режим регистра Автоматический -> исключительная ситуация (ошибка)
Если, например, стоит задача повысить параллельность работы при проведении отдельного документа, не переводя при этом всю конфигурацию в управляемый режим, то последовательность действий должна быть следующей:
- свойство конфигурации Режим управления блокировкой данных необходимо установить в значение Автоматический и управляемый;
- свойство Режим управления блокировкой данных объекта метаданных документ необходимо установить в значение Управляемый;
- у всех регистров, по которым данный документ выполняет движения, следует установить свойство Режим управления блокировкой данных в значение Управляемый;
- проанализировать процедуру проведения документа на предмет наличия:
- явных вызовов транзакций
- неявных вызовов транзакций, которые выполняются системой при модификации данных каких-либо объектов конфигурации
- для найденных явных и неявных вызовов транзакций обеспечить их выполнение в управляемом режиме
- для явных вызовов - параметр метода НачатьТранзакцию();
- для неявных вызовов - свойство Режим управления блокировкой данных модифицируемого объекта конфигурации;
- в теле процедуры проведения документа установить необходимые управляемые блокировки.
Установка управляемых блокировок средствами встроенного языка
Средствами встроенного языка установка управляемых блокировок внутри явной или скрытой (неявной) транзакции происходит с помощью специального объекта БлокировкаДанных, который предназначен для явной блокировки данных от чтения или изменения другими сессиями.
Описание доступных свойств и методов которого можно посмотреть в синтакс-помощнике в ветви "Общие объекты" - "Управление блокировкой данных".
Новый экземпляр данного объекта может быть создан с помощью одноименного конструктора и представляет собой коллекцию элементов блокировки данных. Изначально эта коллекция пуста и задача разработчика состоит в добавлении в эту коллекцию некоторого количества элементов блокировки.
При добавлении нового элемента блокировки для него необходимо указать пространство блокировок, которое будет блокировать данный элемент. Пространства блокировок определены в платформе 1С:Предприятия 8.1 и соответствуют структуре прикладных объектов конфигурации.
Допустимы следующие имена пространств блокировок и имена полей пространств блокировок:
- для объектных данных (справочник, документ и др.) определено единственное пространство блокировки - сам объект данных;
- для необъектных данных (например, регистры) определено по два пространства блокировок, которые имеют разный логический смысл.
| Имя пространства блокировок | Поля пространства блокировок |
|---|---|
| Справочник.<имя> | Ссылка |
| Документ.<имя> | Ссылка |
| ПланОбмена.<имя> | Ссылка |
| ПланСчетов.<имя> | Ссылка |
| БизнеcПроцесс.<имя> | Ссылка |
| Задача.<имя> | Ссылка |
| ПланВидовРасчета.<имя> | Ссылка |
| ПланВидовХарактеристик.<имя> | Ссылка |
| РегистрСведений.<имя>.НаборЗаписей - только для регистра сведений, подчиненного регистратору | Регистратор |
| РегистрСведений.<имя> | Период - если есть; <имя измерения> |
| РегистрНакопления.<имя>.НаборЗаписей | Регистратор |
| РегистрНакопления.<имя> | Период; <имя измерения> |
| РегистрБухгалтерии.<имя>.НаборЗаписей | Регистратор |
| РегистрБухгалтерии.<имя> | Период; <вид движения> - значение системного перечисления ВидДвиженияБухгалтерии; Счет - обязательное поле; Субконто; <вид субконто>; <имя измерения> |
| РегистрРасчета.<имя>.НаборЗаписей | Регистратор |
| РегистрРасчета.<имя> | ПериодРегистрации; ПериодДействия; <имя измерения> |
| Перерасчет.<имя>.НаборЗаписей | ОбъектПерерасчета |
| Перерасчет.<имя> | ВидРасчета |
| Последовательность.<имя>.НаборЗаписей | Регистратор |
| Последовательность.<имя> | <имя измерения> |
| Константа.<имя> |
Пространство блокировок с суффиксом НаборЗаписей используется в тех случаях, когда необходимо заблокировать сами записи данного объекта (например, при добавлении новых записей).
Пространство блокировок без суффикса используется тогда, анализируются некоторые данные этого объекта (например, остатки регистра), или когда выполняются какие-либо операции, приводящие к изменению существующих данных объекта (например, восстановление границы последовательности).
Порядок действий при установке управляемых блокировок средствами встроенного языка:
- добавить элемент блокировки, соответствующий некоторому пространству блокировок;
- установить для этого элемента режим блокировки (разделяемая или исключительная);
- определить значения полей блокировки (указать, какие же именно записи будут заблокированы - для каждого пространства блокировок в платформе определены имена полей, значения которых могут задаваться при установке тех или иных блокировок).
Следует понимать, что, в данном случае речь не идет о реальных записях базы данных. Несмотря на то, что управляемые блокировки описываются в терминах объектов метаданных и их полей, эти блокировки никак не связаны с реальной структурой хранения данных 1С:Предприятия в СУБД. Это всего лишь записи о том, что заблокировано «нечто».
Иногда можно провести аналогию между управляемыми блокировками и реальными записями СУБД. Например, для объектных данных блокировка объекта с указанной ссылкой будет «соответствовать» блокировке всех записей, содержащих указанную ссылку, во всех таблицах этого объекта метаданных (в основной таблице и в таблицах его табличных частей).
Однако в других случаях провести такую аналогию достаточно затруднительно, да и не нужно. Например, при блокировке регистра бухгалтерии с указанием значения вида субконто, мы запрещаем другим транзакциям каким-либо образом изменять «записи» регистра бухгалтерии, у которых значение вида субконто равно указанному нами. Как при этом данное условие «проецируется» на реальную структуру данных регистра бухгалтерии - для нас совершенно не важно.
При установке новых блокировок менеджер анализирует имеющиеся блокировки. Если оказывается, что «нечто», что мы пытаемся заблокировать, уже заблокировано ранее, сравниваются режимы существующей и новой блокировок. Если режимы совместимы - новая блокировка устанавливается. Если режимы не совместимы - новая блокировка ожидает снятия существующей блокировки.
Условия необходимо ставить именно на те поля, имена которых приведены в списке имен пространств блокировок. Условия могут быть заданы или на равенство значения поля какому-либо значению, или на вхождение значения поля в указанный диапазон.
Для каждого пространства блокировок количество устанавливаемых условий не ограничено.
Способы задания условий на поля пространств блокировки
Существует два способа задания условий на поля пространств блокировки:
- с помощью явного задания имени поля и его значения;
- с помощью указания источника данных, содержащего необходимые значения.
Задание условий на поля пространств блокировки с помощью явного задания имени поля и его значения
При явном задании имени поля и его значения необходимо использовать метод УстановитьЗначение() объекта ЭлементБлокировкиДанных. В этом случае имя и значение указывают в качестве параметров метода, например так, как показано в листинге 1.
Листинг 1. Пример установки условия блокировки записей с помощью явного указания имени поля и его значения
|
1 2 3 4 5 6 7 8 9 10 11 |
// Создать объект блокировка данных БлокировкаДанных = Новый БлокировкаДанных; // Добавить новый элемент блокировки, блокирующий «нечто» в данных регистра накопления Остатки номенклатуры ЭлементБлокировки = БлокировкаДанных.Добавить("РегистрНакопления.ОстаткиНоменклатуры"); // Установить режим блокировки - исключительный. Другие транзакции, устанавливающие управляемые блокировки, не смогут даже начать чтение этих данных ЭлементБлокировки.Режим = РежимБлокировкиДанных.Исключительный; // Указать, что именно мы блокируем в данных регистра Остатки номенклатуры - все «записи», у которых значение измерения Склад равно значению, содержащемуся в переменной Склад ЭлементБлокировки.УстановитьЗначение("Склад", Склад); |
Для значений типа Дата или Число в качестве значения может быть задан некоторый диапазон значений. Диапазон значений передается методу с помощью объекта встроенного языка - Диапазон. Данный объект позволяет задать верхнюю и нижнюю границы диапазона, причем в диапазон включаются и границы диапазона (листинг 2).
Листинг 2. Пример установки условия блокировки записей с помощью задания диапазона
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
// Создать объект блокировка данных БлокировкаДанных = Новый БлокировкаДанных; // Добавить новый элемент блокировки, блокирующий «нечто» в данных регистра накопления Продажи ЭлементБлокировки = БлокировкаДанных.Добавить("РегистрНакопления.Продажи"); // Установить режим блокировки - разделяемый. Эти данные гарантировано не будут изменены другими транзакциями до окончания существующей транзакции ЭлементБлокировки.Режим = РежимБлокировкиДанных. Разделяемый; // Указать, что именно мы блокируем в данных регистра Продажи - все «записи», у которых значение измерения Контрагент равно значению, содержащемуся в переменной Контрагент ЭлементБлокировки.УстановитьЗначение("Контрагент", Контрагент); // Создать объект Диапазон, описывающих интервал от начала месяца, к которому принадлежит указанная дата, до указанной даты Диапазон = Новый Диапазон(НачалоМесяца(Дата), Дата); // Указать, что именно мы блокируем в данных регистра Продажи - все «записи», у которых значение измерения Контрагент равно значению, содержащемуся в переменной Контрагент, и значение поля Период содержится в указанном диапазоне ЭлементБлокировки.УстановитьЗначение("Период", Диапазон); |
Задание условий на поля пространств блокировки с помощью указания источника данных, содержащего необходимые значения
При указании источника данных сначала необходимо задать свойство ИсточникДанных объекта ЭлементБлокировкиДанных, после чего, используя метод ИспользоватьИзИсточникаДанных(), настроить соответствие полей области блокировки данных полям источника данных (листинг 3).
Листинг 3. Пример установки условия блокировки записей с помощью источника данных
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
БлокировкаДанных = Новый БлокировкаДанных; // Добавить новый элемент блокировки, блокирующий «нечто» в данных регистра накопления Остатки номенклатуры ЭлементБлокировки = БлокировкаДанных.Добавить("РегистрНакопления.ОстаткиНоменклатуры"); // Установить режим блокировки - исключительный. Другие транзакции, устанавливающие управляемые блокировки, не смогут даже начать чтение этих данных ЭлементБлокировки.Режим = РежимБлокировкиДанных.Исключительный; // Указать, что именно мы блокируем в данных регистра Остатки номенклатуры - все «записи», у которых значение измерения Склад равно значению, содержащемуся в переменной Склад ЭлементБлокировки.УстановитьЗначение("Склад", Склад); // Указать источник данных, который содержит данные для установки ограничений на другие поля этого элемента блокировки - в данном случае таблица значений СписокНоменклатуры ЭлементБлокировки.ИсточникДанных = СписокНоменклатуры; // Указать, что именно мы блокируем в данных регистра Остатки номенклатуры - все «записи», у которых значение измерения Склад равно значению, содержащемуся в переменной Склад, и у которых значение измерения Номенклатура равно какому-либо значению, содержащемуся в колонке Номенклатура указанного источника данных ЭлементБлокировки.ИспользоватьИзИсточникаДанных("Номенклатура", "Номенклатура"); |
В качестве источника данных можно указывать:
- результат запроса;
- табличную часть;
- набор записей;
- таблицу значений.
При установке соответствия полей, именами полей источника будут являться имена колонок результата запроса, имена реквизитов табличной части, имена измерений или имена колонок таблицы значений соответственно.
Объект Диапазон также может являться значением поля источника данных.
Для установки всех созданных блокировок используется метод объекта БлокировкаДанных - Заблокировать():
- Если метод выполняется внутри транзакции (явной или неявной), то блокировки устанавливаются в момент вызова метода. При окончании транзакции они будут сняты автоматически.
- Если же метод Заблокировать() выполняется вне транзакции, то блокировки установлены не будут.