[Из песочницы] Tarantool 1.6 — давай начнем
Не так давно на Хабре была опубликована статья о NoSQL базе — «Tarantool 1.6 от первого лица». Уверен, в своих кругах эта база данных отлично известна и уже завоёвывает популярность. Уверен так же и в том, что есть те начинающие, руки не дошли, кто хотел бы попробовать Tarantool в действии. Именно для таких желающих я приведу несколько простых примеров, помогающих начать знакомиться с этим интересным продуктом. Как понятно из названия статьи — речь идет о версии Tarantool 1.6.Install На сайте проекта подробно описаны варианты установки для разных систем. Для Ubuntu выглядит так: wget http://tarantool.org/dist/public.key sudo apt-key add ./public.key release=`lsb_release -c -s`
cat > /etc/apt/sources.list.d/tarantool.list <<- EOF deb http://tarantool.org/dist/master/ubuntu/ $release main deb-src http://tarantool.org/dist/master/ubuntu/ $release main EOF
sudo apt-get update sudo apt-get install tarantool Hello world! Tarantool использует Lua в качестве встроенного языка (Lua 5.1 на базе on LuaJIT 2.0). Язык lua не сложный, быстро познакомиться с его основами можно здесь или на Хабре в публикации «Lua за 15 минут». Вы можете использовать Tarantool как Lua интерпретатор. $ /usr/bin/tarantool /usr/bin/tarantool: version 1.6.4–509-ga4af00e type 'help' for interactive help tarantool> 2 + 3 --- — 5 … tarantool> print ('Ola lua!') Ola lua! --- … Так же вы можете писать свою логику, используя скрипты на Lua. Напишем стартовый init.lua для запуска Tarantool и вывода 'Hello world'.Одна из основных библиотек tarantool — box. С помощью box.cfg (в lua {…} — это таблица) создадим конфигурацию запуска:
box.cfg { listen = 3311, logger = 'tarantool.log', } Tarantool будет запущен на порт 3311 и будет хранить логи в tarantool.log: Создадим функцию hello ()
local function hello () print ('Hello world!) end
hello () Запускаем и видим: $ tarantool init.lua Hello world! Data Base В tarantool кортежи хранятся в пространствах (space) — некий аналог таблицы.Создадим тестовый space и первичный (primary) индекс в нем (можно также строить и вторичный по всем полям записи), используя дерево для хранения индексов:
s = box.schema.space.create ('test') p = s: create_index ('primary', {type = 'tree', parts = {1, 'NUM'}}) Заполним test записями вида {key, number}: for i = 1, 10 do s: insert ({i, i}) end В данном случае объект s ссылка на объект box.space.test. Соответственно, можно было записать: box.space.test: insert ({i, i}) Кстати, вы можете столкнуться с такой ошибкой при повторном запуске tarantool: $ tarantool init.lua Hello world! main/101/init.lua F> Space 'test' already exists Tarantool хранит все свои данные в оперативной памяти. Для их сохранности Tarantool делает снимки состояний (snapshot) и бинарные логи (xlog). Ошибка возникает из-за того, что при старте Tarantool загружает данные с последнего использования с помощью файлов .snap (снимки состояния) и .xlog (по умолчанию в рабочей директории). Соответственно, ваш test space уже присутствует в базе. Вы можете удалять .snap и .xlog при каждом запуске, или же добавить проверку существования пространства. s = box.space.test if not s then s = box.schema.space.create ('test') p = s: create_index ('primary', {type = 'tree', parts = {1, 'NUM'}}) for i = 1, 10 do s: insert ({i, i}) end end Было бы очень неплохо проверить, сохранились ли наши данные, наша конфигурация в запущенном Tarantool. Для этого предусмотрена консоль для администратора. Вообще, в lua реализация подключения различных модулей, встроенных пакетов, других файлов с кодом происходит через механизм require. local console = require ('console') console.listen (127.0.0.1:3312) После запуска Tarantool вы сможете подключится к админской консоли на порту 3312 с использование утилит nc/telnet и rlwrap (для удобства работы). Подключившись, вы можете напрямую работать с Tarantool. Посмотрим, к примеру, данные нашего пространства test: $ rlwrap nc 0 3312 Tarantool 1.6.4–509-ga4af00e (Lua console) type 'help' for interactive help box.space.test: select () --- - — [1, 1] — [2, 2] — [3, 3] — [4, 4] — [5, 5] — [6, 6] — [7, 7] — [8, 8] — [9, 9] — [10, 10] … box.space.test: get (6) --- — [6, 6] … Посмотрим параметры конфигурации нашего Tarantool: box.cfg box.cfg --- — snapshot_count: 6 too_long_threshold: 0.5 slab_alloc_factor: 2 slab_alloc_maximal: 1048576 background: false logger: tarantool.log slab_alloc_arena: 1 sophia: page_size: 131072 threads: 5 node_size: 134217728 memory_limit: 0 listen: '3311' logger_nonblock: true snap_dir: . coredump: false sophia_dir: . wal_mode: write slab_alloc_minimal: 64 panic_on_snap_error: true panic_on_wal_error: true rows_per_wal: 500000 wal_dir: . log_level: 5 readahead: 16320 snapshot_period: 0 wal_dir_rescan_delay: 0.1 … Итак, создав space выполним следующую задачу: в записях с ключом > 5 увеличим значение хранимого чиcла на 10.Для нужной выборки воспользуемся библиотекой box.index. for k, v in box.space.test.index.primary: pairs (5, {iterator = box.index.GT}) do s: update (v[1], {{'=', 2, v[2] + 10}}) end box.space.index.primary — означает работу с пространством test и его primary индексом.pairs () — функция итерирования, возвращающая итератор (переменная k в цикле) и таблицу значений (состоит из набора записей v), принимает на вход значение ключа (5) — старта итерирования и тип итератора.iterator = box.index.GT — итератор GT (greater) возвращает записи с ключами, больше заданного.update () — обновление записи в базе, принимает значение ключа записи (v[1]),{' = ', 2, v[2] + 10} — обозначает обновление ('=') второго значения на v[2] + 10.Посмотрим, используя админскую консоль, значения нашего space:
box.space.test: select () --- - — [1, 1] — [2, 2] — [3, 3] — [4, 4] — [5, 5] — [6, 16] — [7, 17] — [8, 18] — [9, 19] — [10, 20] … Общий код нашего init.lua скрипта: — Пример init cкрипта для tarantool
-- Подключение всех необходимых в скрипте модулей — удобно описывать в начале local console = require ('console')
-- Стартуем админскую консоль console.listen ('127.0.0.1:3312')
-- Конфигурация tarantool box.cfg { listen = 3311, logger = 'tarantool.log', }
local function hello () print ('Hello world!') end
-- Запуск функции hello hello ()
-- Создаем и заполняем тестовый space, если он отсутствует s = box.space.test if not s then s = box.schema.space.create ('test') — Первичный индекс p = s: create_index ('primary', {type = 'tree', parts = {1, 'NUM'}}) for i = 1, 10 do s: insert ({i, i}) end end
-- Увеличим хранящиеся значения во всех записях, где первичный ключ больше 5 for k, v in box.space.test.index.primary: pairs (5, {iterator = box.index.GT}) do s: update (v[1], {{'=', 2, v[2] + 10}}) end
Конечно, чтобы полноценно освоить Tarantool, знать его тонкости, нужно читать документацию на сайте проекта. Ведь помимо всего Tarantool — это не только база данных, но еще и lua application server. К примеру, есть http сервер и очереди. Но первый шаг сделан — свой маленький скрипт для Tarantool вы написали.Еще вы можете почитать про Tarantool (в примерах там более старые версии проекта) в других статьях на Хабре: «Изучаем Tarantool + Lua», «Уникальные возможности Tarantool».
Так же без всякой установки вы можете попробовать Tarantool на try.tarantool.org.
