[PATCH v3 0/6] box: rework functions machinery

Kirill Shcherbatov kshcherbatov at tarantool.org
Thu Jun 13 17:08:20 MSK 2019


This patchset reworks Tarantool's functions machinery to support
persistent Lua functions and provide an universal way to call any
registered function.

This patchset consists of following conceptual changes:
1. Func updates on alter were simplified: now replace _func tuple is
   forbidden and func_new constructor may fail. This makes possible to
   define a failable function object constructors.
2. box_lua_call and box_lua_eval were refactored to do nottake call_request
   argument and to use input and output port instead. A new msgpack_port allows
   to use this abstraction also for a regular memory msgpack.
3. Introduced an abstract function class and func_c and func_lua
   implementations that allow to call C and Lua functions correspondingly
   with uniform API defined on base func class.
4. Introduced an infrastructure to call functions from Lua. A new box.func
   folder exports functions objects that have :call and :drop methods and their
   definition.
4. Introduced persistent Lua functions. Such functions are a part of Tarantool
   snapshoot so they are available even after restart. The new is_sandboxed
   option initializes a new persistent Lua function is a separate 'sandbox':
   an isolated environment with strong restrictions: only limited number of
   on-board functions are available, no global state is available at all.

Persistent Lua functions is an important step to implement functional indexes
in Tarantool. Only a deterministic, sandboxed, persistent Lua function may
be used as a functional index extractor.

Changes in version 3:
   Source code is re-organised to be bit clear and to provide a better function
   object abstraction.

http://github.com/tarantool/tarantool/tree/kshch/gh-4182-persistent-lua-functions
https://github.com/tarantool/tarantool/issues/4182

Kirill Shcherbatov (6):
  box: rework func cache update machinery
  box: rework box_lua_{call, eval} to use input port
  box: rework func object as a function frontend
  box: export registered functions in box.func folder
  box: refactor box_lua_find helper
  box: introduce Lua persistent functions

 src/box/alter.cc             | 111 ++++---
 src/box/bootstrap.snap       | Bin 4475 -> 4532 bytes
 src/box/call.c               | 151 ++-------
 src/box/call.h               |   4 -
 src/box/execute.c            |   1 +
 src/box/func.c               | 199 +++++++++--
 src/box/func.h               |  40 +--
 src/box/func_def.c           |  25 ++
 src/box/func_def.h           |  34 +-
 src/box/lua/call.c           | 621 +++++++++++++++++++++++++++++++----
 src/box/lua/call.h           |  13 +-
 src/box/lua/execute.c        |   7 +-
 src/box/lua/execute.h        |   4 +-
 src/box/lua/init.c           |   1 +
 src/box/lua/misc.cc          |  10 +-
 src/box/lua/schema.lua       |  41 ++-
 src/box/lua/upgrade.lua      |  25 +-
 src/box/port.c               |   3 +-
 src/box/port.h               |  19 +-
 src/box/schema.cc            |  38 +--
 src/box/schema.h             |  15 +-
 src/box/schema_def.h         |   4 +
 src/box/session.cc           |  11 +-
 src/box/session.h            |   8 +
 src/lib/core/port.h          |  15 +-
 test/box-py/bootstrap.result |   6 +-
 test/box/access_misc.result  |   6 +-
 test/box/function1.c         |  33 ++
 test/box/function1.result    | 332 +++++++++++++++++++
 test/box/function1.test.lua  | 115 +++++++
 test/box/misc.result         |   1 +
 31 files changed, 1544 insertions(+), 349 deletions(-)

-- 
2.21.0




More information about the Tarantool-patches mailing list