Как выполнить UPDATE в Tarantool: полное руководство

База данных Tarantool - это in-memory решение, которое поддерживает как реляционные, так и документные модели данных. Для изменения уже существующих записей используется команда update. В этой статье мы подробно разберём, как правильно написать update в БД Tarantool, какие операторы доступны и как избежать типичных ошибок.

Основной синтаксис UPDATE

В Tarantool обновление данных выполняется через метод space:update(primary_key, operators). Первый аргумент - первичный ключ кортежа, второй - список операций. Пример:

box.space.users:update({1}, {{'+', 2, 5}})

Этот код увеличивает значение второго поля (индексация с 1) на 5 для записи с ключом 1.

Доступные операторы изменения

В Tarantool поддерживается несколько операторов для гибкого обновления данных:

• + - прибавить число к числовому полю
• - - вычесть число из числового поля
• & - побитовое И
• | - побитовое ИЛИ
• ^ - побитовое исключающее ИЛИ
• ! - вставить новое значение (замена)
• # - удалить элемент из массива

Каждый оператор применяется к конкретному полю кортежа, что позволяет точечно менять атрибуты объекта.

Пример: изменение атрибута объекта

Допустим, у нас есть спейс objects с кортежами вида {id, name, status}. Чтобы изменить статус объекта с id=5 на "active", используем оператор !:

box.space.objects:update({5}, {{'!', 3, 'active'}})

Обратите внимание: индекс поля считается с 1, поэтому третье поле - это status.

Обновление с помощью eval и Lua

Если требуется сложная логика, можно выполнить обновление через box.space:eval() или напрямую на Lua. Например:

box.space.objects:update({5}, function(tuple) tuple[3] = 'active' return tuple end)

Такой подход даёт полный контроль над преобразованием данных, но требует осторожности - ошибка в Lua-коде может привести к блокировке.

Частые ошибки при UPDATE

• Неверный индекс поля: в Tarantool нумерация полей начинается с 1, а не с 0. Путаница с индексами - самая распространённая проблема.
• Использование неверного оператора: например, попытка применить '+' к строковому полю вызовет ошибку.
• Отсутствие первичного ключа: update требует точного ключа. Для массового обновления используйте итераторы.

Массовое обновление записей

Для обновления нескольких записей по условию применяйте pairs с фильтром:

for _, tuple in box.space.objects:pairs() do
  if tuple[2] == 'old_name' then
    box.space.objects:update({tuple[1]}, {{'!', 2, 'new_name'}})
  end
end

Этот код перебирает все кортежи и меняет второе поле у тех, где оно равно 'old_name'.

Заключение

Команда UPDATE в Tarantool - мощный инструмент для точечного изменения данных. Главное - правильно указывать индекс поля и выбирать подходящий оператор. Для сложных преобразований используйте Lua-функции, а для массовых операций - итераторы. Следуя этим рекомендациям, вы сможете эффективно обновлять атрибуты объектов в БД Tarantool без ошибок.