box.savepoint()

box.savepoint()

Return a descriptor of a savepoint (type = table), which can be used later by box.rollback_to_savepoint(savepoint). Savepoints can only be created while a transaction is active, and they are destroyed when a transaction ends.

Return:	savepoint table
Rtype:	Lua object
Return:	error if the savepoint cannot be set in absence of active transaction.

Possible errors: error if for some reason memory cannot be allocated.