box.begin()

Begin the transaction. Disable implicit yields until the transaction ends. Signal that writes to the write-ahead log will be deferred until the transaction ends. In effect the fiber which executes box.begin() is starting an "active multi-request transaction", blocking all other fibers.

Parameters:

• opts (table) — (optional) transaction options:

• txn_isolation – the transaction isolation level

• timeout – a timeout (in seconds), after which the transaction is rolled back

Possible errors:

• error if this operation is not permitted because there is already an active transaction.
• error if for some reason memory cannot be allocated.
• error and abort the transaction if the timeout is exceeded.

Example

 
-- Insert test data --box.space.bands:insert { 1, 'Roxette', 1986 }box.space.bands:insert { 2, 'Scorpions', 1965 }box.space.bands:insert { 3, 'Ace of Base', 1987 }-- Begin and commit the transaction explicitly --box.begin()box.space.bands:insert { 4, 'The Beatles', 1960 }box.space.bands:replace { 1, 'Pink Floyd', 1965 }box.commit()-- Begin the transaction with the specified isolation level --box.begin({ txn_isolation = 'read-committed' })box.space.bands:insert { 5, 'The Rolling Stones', 1962 }box.space.bands:replace { 1, 'The Doors', 1965 }box.commit()