Операции

Операции с данными

Tarantool поддерживает следующие основные операции с данными:

• пять операций по изменению данных (INSERT, UPDATE, UPSERT, DELETE, REPLACE) и
• одну операцию по выборке данных (SELECT).

Все они реализованы в виде функций во вложенном модуле box.space.

Примеры:

• INSERT: добавить новый кортеж к спейсу „tester“.

  Первое поле, field[1], будет 999 (тип MsgPack – integer, целое число).

  Второе поле, field[2], будет „Taranto“ (тип MsgPack – string, строка).

  tarantool> box.space.tester:insert{999, 'Taranto'}
  

• UPDATE: обновить кортеж, изменяя поле field[2].

  Оператор «{999}» со значением, которое используется для поиска поля, соответствующего ключу в первичном индексе, является обязательным, поскольку в запросе update() должен быть оператор, который указывает уникальный ключ, в данном случае – field[1].

  Оператор «{{„=“, 2, „Tarantino“}}» указывает, что назначение нового значения относится к field[2].

  tarantool> box.space.tester:update({999}, {{'=', 2, 'Tarantino'}})
  

• UPSERT: обновить или вставить кортеж, снова изменяя поле field[2].

  Синтаксис upsert() похож на синтаксис update(). Однако логика выполнения двух запросов отличается. UPSERT означает UPDATE или INSERT, в зависимости от состояния базы данных. Кроме того, выполнение UPSERT откладывается до коммита транзакции, поэтому в отличие от update(), upsert() не возвращает данные.

  tarantool> box.space.tester:upsert({999, 'Taranted'}, {{'=', 2, 'Tarantism'}})
  

• REPLACE: заменить кортеж, добавляя новое поле.

  Это действие также можно выполнить с помощью запроса update(), но обычно запрос update() более сложен.

  tarantool> box.space.tester:replace{999, 'Tarantella', 'Tarantula'}
  

• SELECT: провести выборку кортежа.

  Оператор «{999}» все еще обязателен, хотя в нем не должен упоминаться первичный ключ.

  tarantool> box.space.tester:select{999}
  

• DELETE: удалить кортеж.

  В этом примере мы определяем поле, соответствующее ключу в первичном индексе.

  tarantool> box.space.tester:delete{999}
  

Подводя итоги по примерам:

• Функции insert и replace принимают кортеж (где первичный ключ – это часть кортежа).
• Функция upsert принимает кортеж (где первичный ключ – это часть кортежа), а также операции по обновлению.
• Функция delete принимает полный ключ любого уникального индекса (первичный или вторичный).
• Функция update принимает полный ключ любого уникального индекса (первичный или вторичный), а также операции к выполнению.
• Функция select принимает любой ключ: первичный/вторичный, уникальный/неуникальный, полный/часть.

Для получения более подробной информации по использованию операций с данными см. справочник по box.space.

Факторы сложности

Во вложенных модулях box.space и Вложенный модуль box.index содержится информация о том, как факторы сложности могут повлиять на использование каждой функции.