модуль ActiveRecord::Locking::Pessimistic

Пессимистическое блокирование

Locking::Pessimistic предоставляет поддержку блокирования строк с помощью SELECT … FOR UPDATE и других типов блокировок.

Цепочка ActiveRecord::Base#find к ActiveRecord::QueryMethods#lock для получения эксклюзивной блокировки выбранных строк:

# select * from accounts where id=1 for update
Account.lock.find(1)

Вызов lock('some locking clause') для использования специфичного для базы данных условия блокировки, такого как ‘LOCK IN SHARE MODE’ или ‘FOR UPDATE NOWAIT’. Пример:

Account.transaction do
  # select * from accounts where name = 'shugo' limit 1 for update nowait
  shugo = Account.lock("FOR UPDATE NOWAIT").find_by(name: "shugo")
  yuko = Account.lock("FOR UPDATE NOWAIT").find_by(name: "yuko")
  shugo.balance -= 100
  shugo.save!
  yuko.balance += 100
  yuko.save!
end

Также можно использовать метод ActiveRecord::Base#lock! для блокировки одной записи по ID. Это может быть лучше, если вам не нужно блокировать каждую строку. Пример:

Account.transaction do
  # select * from accounts where ...
  accounts = Account.where(...)
  account1 = accounts.detect { |account| ... }
  account2 = accounts.detect { |account| ... }
  # select * from accounts where id=? for update
  account1.lock!
  account2.lock!
  account1.balance -= 100
  account1.save!
  account2.balance += 100
  account2.save!
end

Можно начать транзакцию и получить блокировку за один раз, вызвав with_lock с блоком. Блок вызывается внутри транзакции, объект уже заблокирован. Пример:

account = Account.first
account.with_lock do
  # This block is called within a transaction,
  # account is already locked.
  account.balance -= 100
  account.save!
end

Информация о блокировании строк, специфичная для базы данных:

MySQL: dev.mysql.com/doc/refman/en/innodb-locking-reads.html
PostgreSQL: www.postgresql.org/docs/current/interactive/sql-select.html#SQL-FOR-UPDATE-SHARE

Публичные методы экземпляров

lock!(lock = true) Показать исходный код

# File activerecord/lib/active_record/locking/pessimistic.rb, line 69
      def lock!(lock = true)
        if persisted?
          if has_changes_to_save?
            raise(<<-MSG.squish)
              Locking a record with unpersisted changes is not supported. Use
              `save` to persist the changes, or `reload` to discard them
              explicitly.
              Changed attributes: #{changed.map(&:inspect).join(', ')}.
            MSG
          end

          reload(lock: lock)
        end
        self
      end

Получить блокировку строки для этой записи. Перезагружает запись, чтобы получить запрошенную блокировку. Передайте SQL условие блокировки, чтобы добавить его в конец оператора SELECT, или передайте true для «FOR UPDATE» (по умолчанию, эксклюзивная блокировка строки). Возвращает заблокированную запись.

with_lock(*args) { || ... } Показать исходный код

# File activerecord/lib/active_record/locking/pessimistic.rb, line 92
def with_lock(*args)
  transaction_opts = args.extract_options!
  lock = args.present? ? args.first : true
  transaction(**transaction_opts) do
    lock!(lock)
    yield
  end
end

Оборачивает переданный блок в транзакцию, перезагружая объект с блокировкой перед передачей. Вы можете передать SQL условие блокировки как необязательный аргумент (см. lock!).

Также можно передать такие опции, как requires_new:, isolation:, и joinable: в обертывающую транзакцию (см. ActiveRecord::ConnectionAdapters::DatabaseStatements#transaction).