Не так давно на Хабре была опубликована статья о 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 --- - 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 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.

ссылка на оригинал статьи http://habrahabr.ru/post/254533/