Запросы для обновления и удаления данных
Запросы для обновления (UPDATE) и удаления (DELETE и TRUNCATE) применяются в Reindexer для выполнения следующих операций:
- изменение содержимого полей записи или группы записей,
- добавление новых полей,
- удаление неиндексных полей,
- удаление записей.
UPDATE-запросы для изменения и добавления полей записей
В Reindexer используется следующий синтаксис запросов на обновление данных:
db.Query("nsName")
.Where("field", reindexer.EQ, 40)
.Set("field1", value1)
.Set("field2", value2)
...
.Set("fieldN", valueN)
.Update()
Кроме того, в одном запросе можно объединить несколько выражений Set... разных типов, например: Set(...).SetExpression(...).SetObject(...)...
(
db.new_query("nsName")
.where("field", CondType.CondEq, 40)
.set("field1", [value1])
.set("field2", [value2])
# ...
.set("fieldN", [valueN])
.update()
)
db.query("items", Item.class)
.where("field", Condition.EQ, 40)
.set("field1", value1)
.set("field2", value2)
// ...
.set("fieldN", valueN)
.update();
UPDATE nsName
SET field1 = value1, field2 = value2, ..
WHERE condition;
curl --location --request PUT 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
2
]
}
],
"update_fields": [
{
"name": "info",
"type": "value",
"is_array": false,
"values": [
"new info"
]
}
]
}'
UPDATE с INNER JOIN и подзапросами
В WHERE запроса UPDATE можно использовать INNER JOIN и подзапросы. В запросах на изменение данных поддерживается только INNER JOIN, причём вне транзакций.
Оба примера устанавливают archived = true в записях items, для которых в item_flags есть запись с соответствующим item_id и expired = true. В первом варианте поля сравниваются в ON, во втором IN проверяет, входит ли id в список item_id, возвращённый подзапросом.
С INNER JOIN:
iter := db.Query("items").Set("archived", true).
InnerJoin(db.Query("item_flags").Where("expired", reindexer.EQ, true), "expired_flags").
On("id", reindexer.EQ, "item_id").
Update()
defer iter.Close()
Конструктор запросов pyreindexer не поддерживает INNER JOIN в UPDATE-запросах. Выполните запрос через exec_sql().
db.exec_sql(
"UPDATE items SET archived = true "
"WHERE INNER JOIN (SELECT * FROM item_flags WHERE expired = true) "
"ON items.id = item_flags.item_id"
)
Java-коннектор поддерживает INNER JOIN в конструкторе UPDATE-запросов начиная с версии 1.35.
db.query("items", Item.class)
.innerJoin(
db.query("item_flags", ItemFlag.class)
.where("expired", Condition.EQ, true)
.on("id", Condition.EQ, "item_id"),
"expired_flags")
.set("archived", true)
.update();
UPDATE items SET archived = true
WHERE INNER JOIN (SELECT * FROM item_flags WHERE expired = true)
ON items.id = item_flags.item_id;
curl --location --request PUT 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "items",
"filters": [
{
"join_query": {
"type": "inner",
"namespace": "item_flags",
"filters": [{"field": "expired", "cond": "eq", "value": [true]}],
"on": [{"left_field": "id", "right_field": "item_id", "cond": "eq"}]
}
}
],
"update_fields": [
{"name": "archived", "type": "value", "is_array": false, "values": [true]}
]
}'
С подзапросом в WHERE:
flags := db.Query("item_flags").Select("item_id").Where("expired", reindexer.EQ, true)
iter := db.Query("items").
Where("id", reindexer.SET, flags).
Set("archived", true).
Update()
defer iter.Close()
Для подзапроса в конструкторе используйте where_subquery().
flags = (
db.new_query("item_flags")
.select_fields("item_id")
.where("expired", CondType.CondEq, True)
)
(
db.new_query("items")
.where_subquery("id", CondType.CondSet, flags)
.set("archived", [True])
.update()
)
Для подзапроса передайте объект Query в where().
Query<ItemFlag> flags = db.query("item_flags", ItemFlag.class)
.select("item_id")
.where("expired", Condition.EQ, true);
db.query("items", Item.class)
.where("id", Condition.SET, flags)
.set("archived", true)
.update();
UPDATE items SET archived = true
WHERE id IN (SELECT item_id FROM item_flags WHERE expired = true);
curl --location --request PUT 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "items",
"filters": [
{
"field": "id",
"cond": "set",
"subquery": {
"namespace": "item_flags",
"select_filter": ["item_id"],
"filters": [{"field": "expired", "cond": "eq", "value": [true]}]
}
}
],
"update_fields": [
{"name": "archived", "type": "value", "is_array": false, "values": [true]}
]
}'
Изменение типа значения поля при обновлении записи
В Reindexer механизмы обновления полей имеют следующие особенности:
-
При изменении неиндексного поля замена текущего значения на значение другого типа полностью заменяет содержимое поля, устанавливается значение другого типа.
Пример:
Записываем в поле значение типа
int:UPDATE nsName SET newField = 3 WHERE id = 5Обновляем поле, записываем в него значение типа
string:UPDATE nsName SET newField = 'String' WHERE id = 5Запрос выполнится успешно.
-
Значения индексных полей можно преобразовать только в смежный типы. Например,
intв числовую строку вида ‘123456’ и обратно, либоboolв строку вида ’true’ и обратно.Пример:
Обновляем индексное поле с типом значения
int, записываем в него числовую строку:UPDATE nsName SET newField = '123' WHERE id = 5Запрос выполнится успешно.
Обновляем индексное поле с типом значения
int, записываем в него строку:UPDATE nsName SET newField = 'Text' WHERE id = 5Получим ошибку “Can`t convert Text to number”.
-
Изменение значения индексного поля-массива на
nullвозвращает его к значению по умолчанию.
Добавление новых полей к записям в неймспейсах
С помощью UPDATE-запросов возможно добавление новых полей к существующим записям в неймспейсе. Можно добавить поле для одной или нескольких записей.
Это относится и к индексным полям: UPDATE добавляет отсутствующее поле в документ по JSON-пути индекса.
Пример:
db.Query("items")
.Where("id", reindexer.GE, 100)
.Set("newField", "Brand new!")
.Update()
(
db.new_query("items")
.where("id", CondType.CondGe, 100)
.set("newField", ["Brand new!"])
.update()
)
db.query("items", Item.class)
.where("id", Condition.GE, 100)
.set("newField", "Brand new!")
.update();
UPDATE items SET newField = 'Brand new!' WHERE id > 100
curl --location --request PUT 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "GE",
"Value": [
100
]
}
],
"update_fields": [
{
"name": "newField",
"type": "value",
"is_array": false,
"values": [
"Brand new!"
]
}
]
}'
Если у индекса один JSON-путь, в SET можно использовать имя индекса или соответствующий JSON-путь. Для индекса с несколькими JSON-путями необходимо явно указать обновляемый путь: например, SET field1 = 10 для индекса с json_paths: ["field1", "field2"]. Обновление по имени такого индекса неоднозначно и завершается ошибкой.
Добавление вложенных полей с несколькими уровнями вложенности
В Reindexer возможно добавление вложенных полей с несколькими уровнями вложенности.
Код из примеров добавляет в неймспейс items поле nested с вложенными объектами nested2, nested3, nested4. В nested4 добавляется поле newField с содержимым new nested field!:
db.Query("items")
.Where("id", reindexer.GE, 100)
.Set("nested.nested2.nested3.nested4.newField", "new nested field!")
.Update()
(
db.new_query("items")
.where("id", CondType.CondGe, 100)
.set("nested.nested2.nested3.nested4.newField", ["new nested field!"])
.update()
)
db.query("items", Item.class)
.where("id", Condition.GE, 100)
.set("nested.nested2.nested3.nested4.newField", "new nested field!")
.update();
UPDATE items SET nested.nested2.nested3.nested4.newField = 'new nested field!' WHERE id > 100
Для добавления вложенных полей при обновлении записей по HTTP значение поля “update_fields” -> “type” в теле запроса должно быть object.
curl --location --request PUT 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "GE",
"Value": [
100
]
}
],
"update_fields": [
{
"name": "nested",
"type": "object",
"is_array": false,
"values": [
{
"nested2": {
"nested3": {
"nested4": {
"newField": "new nested field!"
}
}
}
}
]
}
]
}'
Арифметические выражения в UPDATE-запросах
При выполнении UPDATE-запросов к Reindexer возможно добавление в них арифметических выражений с использованием следующих знаков:
+(сложение),-(вычитание),/(деление),*(умножение),().
Пример запроса на обновление данных в Reindexer с использованием арифметических выражений:
При взаимодействии с Reindexer через Go-коннектор для добавления в запрос арифметических выражений используйте метод
SetExpression().
db.Query("items")
.Where("field5", reindexer.EQ, 1)
.SetExpression("field", "field1+field2")
.Update()
(
db.new_query("items")
.where("field5", CondType.CondEq, 1)
.expression("field", "field1+field2")
.update()
)
UPDATE items SET field1 = field2+field3-(field4+5)/2 WHERE field5 = 1
Для добавления арифметических выражений при обновлении поля по HTTP значение поля “update_fields” -> “type” в теле запроса должно быть expression.
curl --location --request PUT 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
1
]
}
],
"update_fields": [
{
"name": "field",
"type": "expression",
"is_array": false,
"values": [
"field1 + field2"
]
}
]
}'
Также в UPDATE-запросах можно использовать такие функции, как now(), sec(), serial().
Пример:
При взаимодействии с Reindexer через Go-коннектор для добавления в запрос арифметических выражений и функций используйте метод SetExpression().
db.Query("items").Where("id", reindexer.EQ, 3).SetExpression("field", "field2*now()").Update()
(
db.new_query("items")
.where("id", CondType.CondEq, 3)
.expression("field", "field2*now()")
.update()
)
UPDATE items SET field1 = field2*NOW() WHERE id = 3
Для добавления арифметических выражений при обновлении поля по HTTP значение поля “update_fields” -> “type” в теле запроса должно быть expression.
curl --location --request PUT 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
1
]
}
],
"update_fields": [
{
"name": "field",
"type": "expression",
"is_array": false,
"values": [
"field1 * now()"
]
}
]
}'
Обновление полей-массивов
В Reindexer реализован механизм обновления, который позволяет изменять определённый элемент существующего массива или заменять поле-массив целиком. Поддерживаются также вложенные массивы.
Массив справа от SET полностью заменяет значение, выбранное слева. Это может быть всё поле, отдельный элемент массива или каждый элемент, выбранный через [*]. Элемент можно заменить массивом, даже если раньше он содержал скаляр. Элементы к прежнему значению при таком присваивании не добавляются. Например, SET idx = [1] записывает массив из одного элемента, а SET idx[0] = [1, 2] заменяет первый элемент вложенным массивом.
Для исходного значения idx = [[1, 2], [3, 4]] получаются следующие результаты. Каждый запрос выполняется независимо:
| Выражение в UPDATE | Результат в idx |
|---|---|
SET idx = [[5, 6], [7, 8]] |
[[5, 6], [7, 8]] |
SET idx[0] = [5, 6] |
[[5, 6], [3, 4]] |
SET idx[*] = [5, 6] |
[[5, 6], [5, 6]] |
SET idx[0][0] = [5, 6] |
[[[5, 6], 2], [3, 4]] |
SET idx[0][*] = [5, 6] |
[[[5, 6], [5, 6]], [3, 4]] |
SET idx[*][0] = [5, 6] |
[[[5, 6], 2], [[5, 6], 4]] |
SET idx[*][*] = [5, 6] |
[[[5, 6], [5, 6]], [[5, 6], [5, 6]]] |
Нумерация элементов начинается с нуля. [*] применяет присваивание к каждому существующему элементу выбранного уровня и не создаёт новые элементы. Для индексного массива все результирующие скалярные значения должны соответствовать типу индекса или допускать преобразование в него.
Примеры:
Изменение элемента массива:
db.Query("items").Where("id", reindexer.EQ, 11).Set("arrayField[0]", 3).Update()
(
db.new_query("items")
.where("id", CondType.CondEq, 11)
.set("arrayField[0]", [3])
.update()
)
db.query("items", Item.class)
.where("id", Condition.EQ, 11)
.set("arrayField[0]", 3)
.update();
UPDATE items SET arrayField[0] = 3 WHERE id = 1
Для изменения элемента массива по HTTP значение поля “update_fields” -> “type” в теле запроса должно быть value.
curl --location --request PUT 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
11
]
}
],
"update_fields": [
{
"name": "arrayField[0]",
"type": "value",
"is_array": false,
"values": [
3
]
}
]
}'
Обновление всего массива:
db.Query("items").Where("id", reindexer.EQ, 11).Set("arrayField", []int{999, 1999, 2999}).Update()
(
db.new_query("items")
.where("id", CondType.CondEq, 11)
.set("arrayField", [999, 1999, 2999])
.update()
)
db.query("items", Item.class)
.where("id", Condition.EQ, 11)
.set("arrayField", List.of(999, 1999, 2999))
.update();
UPDATE items SET arrayField = [999, 1999, 2999] WHERE id = 1
curl --location --request PUT 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
11
]
}
],
"update_fields": [
{
"name": "arrayField",
"type": "value",
"is_array": true,
"values": [
999,
1999,
2999
]
}
]
}'
Добавление элементов в начало массива:
Для добавления элементов в начало массива через Go используйте метод SetExpression().
db.Query("items").Where("id", reindexer.EQ, 11).SetExpression("arrayField", "[999, 1999, 2999] || arrayField").Update()
(
db.new_query("items")
.where("id", CondType.CondEq, 11)
.expression("arrayField", "[999, 1999, 2999] || arrayField")
.update()
)
UPDATE items SET arrayField = [999, 1999, 2999] || arrayField WHERE id = 1
Для добавления элементов в начало массива по HTTP значение поля “update_fields” -> “type” в теле запроса должно быть expression.
curl --location --request PUT 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
11
]
}
],
"update_fields": [
{
"name": "arrayField",
"type": "expression",
"is_array": false,
"values": [
"[999, 1999, 2999]||arrayField"
]
}
]
}'
Добавление элементов в конец массива:
Для добавления элементов в конец массива через Go используйте метод SetExpression().
db.Query("items").Where("id", reindexer.EQ, 11).SetExpression("arrayField", "arrayField || [999, 1999, 2999]").Update()
(
db.new_query("items")
.where("id", CondType.CondEq, 11)
.expression("arrayField", "arrayField || [999, 1999, 2999]")
.update()
)
UPDATE items SET arrayField = arrayField || [999, 1999, 2999] WHERE id = 1
Для добавления элементов в конец массива по HTTP значение поля “update_fields” -> “type” в теле запроса должно быть expression.
curl --location --request PUT 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
11
]
}
],
"update_fields": [
{
"name": "arrayField",
"type": "expression",
"is_array": false,
"values": [
"arrayField||[999, 1999, 2999]"
]
}
]
}'
Обновление массивов объектов
Reindexer также позволяет обновлять элементы массивов объектов и массивы внутри объектов. Например, для objects = [{"values": [3]}, {"values": [4]}] запрос:
UPDATE ns SET objects[*].values = [1, 2] WHERE id = 0;
(
db.new_query("ns")
.where("id", CondType.CondEq, 0)
.set("objects[*].values", [1, 2])
.update()
)
db.query("ns", Item.class)
.where("id", Condition.EQ, 0)
.set("objects[*].values", List.of(1, 2))
.update();
curl --location --request PUT 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "ns",
"filters": [{"field": "id", "cond": "eq", "value": [0]}],
"update_fields": [
{"name": "objects[*].values", "type": "value", "is_array": true, "values": [1, 2]}
]
}'
полностью заменяет массив values в каждом объекте:
[{"values": [1, 2]}, {"values": [1, 2]}]
Остальные поля этих объектов сохраняются. Чтобы заменить целый объект, укажите путь к нему, например objects[0], и новое значение объекта.
Примеры:
Обновление элемента массива объектов:
Для обновления элемента массива объектов через Go используйте метод SetObject().
db.Query("items").Where("id", reindexer.EQ, 1).SetObject("objectsArray[0]", &Item{id: 0, Description: "Updated!"}).Update()
Для обновления элемента массива объектов через Python используйте метод set_object().
(
db.new_query("items")
.where("id", CondType.CondEq, 1)
.set_object("objectsArray[0]", [{"id": 0, "Description": "Updated!"}])
.update()
)
Для замены объекта передайте в set() экземпляр класса с публичными геттерами.
import ru.rt.restream.reindexer.annotations.Json;
public static class ArrayElement {
@Json("Id")
private final int id;
@Json("Description")
private final String description;
public ArrayElement(int id, String description) {
this.id = id;
this.description = description;
}
public int getId() {
return id;
}
public String getDescription() {
return description;
}
}
db.query("items", Item.class)
.where("id", Condition.EQ, 1)
.set("objectsArray[0]", new ArrayElement(0, "Updated!"))
.update();
UPDATE items SET objectsArray[0] = {"Id":0,"Description":"Updated!"} WHERE id = 1
curl --location --request PUT 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
1
]
}
],
"update_fields": [
{
"name": "objectsArray[0]",
"type": "object",
"is_array": false,
"values": [
{
"Id": 0,
"Description": "Updated"
}
]
}
]
}'
Обновление индексного Array-поля, находящегося внутри массива объектов:
Пример ниже рассмотрен для неймспейса с именем ns, в котором есть индекс с параметрами: name="nested",json_paths=["nested.field1"] и is_array=true.
ВАЖНО. Для фильтрации (выборки массива объектов) при выполнении таких запросов используйте имя индекса (в примере —
nested). А для изменения значений вложенных полей — их jsonpath (в примере —nested[1].field1).
Исходная запись:
{
"id":1,
"nested":[{"field1": 1, "field2": 2},
{"field1": 3, "field2": 4},
{"field1": 5, "field2": 6}]
}
Запись после обновления индексного Array-поля, находящегося внутри массива объектов:
{
"id":1,
"nested":[{"field1": 1, "field2": 2},
{"field1": 123, "field2": 4},
{"field1": 5, "field2": 6}]
}
Для обновления индексного Array-поля, находящееся внутри массива объектов, через Go используйте метод Set().
db.Query("test").Where("nested", reindexer.EQ, 1).Set("nested[1].field1", 123).Update()
(
db.new_query("test")
.where("nested", CondType.CondEq, 1)
.set("nested[1].field1", [123])
.update()
)
db.query("items", Item.class)
.where("nested", Condition.EQ, 1)
.set("nested[1].field1", 123)
.update();
UPDATE ns SET nested[1].field1 = 123 WHERE nested = 1
curl --location --request PUT 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "ns",
"filters": [
{
"Field": "nested",
"Cond": "EQ",
"Value": [
1
]
}
],
"update_fields": [
{
"name": "nested[1].field1",
"values": [
123
]
}
]
}'
Обновление индексного поля, находящегося внутри массива объектов, с заменой типа поля (массив -> скаляр и наоборот):
Reindexer позволяет обновлять индексные поля, находящееся внутри массива объектов, и одновременно с этим менять их тип.
Такое обновление доступно только для смены типа поля со скалярного на массив и наоборот.
Пример ниже рассмотрен для неймспейса с именем ns, в котором есть индекс с параметрами: name="nested_field",json_paths=["nested.field1"] и is_array=true.
В исходной записи поле field1 внутри массива объектов nested имеет тип массива (массив чисел). Исходная запись:
{
"id":1,
"nested":[{"field1": [1,2]},{"field1": 3 }]
}
После обновления тип поля field1 меняется с массива на скалярное значение. Запись после обновления и изменения типа индексного поля, находящегося внутри массива объектов, с массива на скалярный:
{
"id":1,
"nested":[{"field1": 123},{"field1": 3 }]
}
Для обновления индексного Array-поля, находящееся внутри массива объектов, через Go используйте метод Set().
db.Query("test").Where("nested_field", reindexer.EQ, 1).Set("nested[0].field1", 123).Update()
(
db.new_query("test")
.where("nested_field", CondType.CondEq, 1)
.set("nested[0].field1", [123])
.update()
)
db.query("test", Item.class)
.where("nested_field", Condition.EQ, 1)
.set("nested[0].field1", 123)
.update();
UPDATE ns SET nested[0].field1 = 123 WHERE nested_field = 1
curl --location --request PUT 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "ns",
"filters": [
{
"Field": "nested_field",
"Cond": "EQ",
"Value": [
1
]
}
],
"update_fields": [
{
"name": "nested[0].field1",
"values": [
123
]
}
]
}'
Изменение и добавление полей объектов
Reindexer позволяет обновлять и добавлять поля объектов.
Примеры:
Объект может быть задан как struct, map или в виде байтового массива (то есть JSON-версии представления объекта).
type ClientData struct {
Name string `reindex:"name" json:"name"`
Age int `reindex:"age" json:"age"`
Address string `reindex:"address" json:"address"`
Occupation string `reindex:"occupation" json:"occupation"`
TaxYear int `reindex:tax_year json:"tax_year"`
TaxConsultant string `reindex:tax_consultant json:"tax_consultant"`
}
type Client struct {
ID int `reindex:"id" json:"id"`
Data ClientData `reindex:"client_data" json:"client_data"`
}
clientData := []interface{}{
map[string]string{"name": "Jane Doe"},
map[string]int{"age": 25},
map[string]string{"address": "23 Main St, LA"},
map[string]string{"occupation": "Accountant"},
map[string]int{"tax_year": 2025},
map[string]string{"tax_consultant": "Sean O'Something"}
}
db.Query("clients").Where("id", reindexer.EQ, 100).SetObject("client_data", clientData).Update()
При передаче объекта в SetObject в виде map требуется использовать map с ключами типа string (например, map[string]interface{}).
client = [
{
"name": "id",
"json_paths": ["id"],
"field_type": "int",
"is_pk": True
},
{
"name": "client_data.name",
"json_paths": ["client_data.name"],
"field_type": "string"
},
{
"name": "client_data.age",
"json_paths": ["client_data.age"],
"field_type": "int"
},
{
"name": "client_data.address",
"json_paths": ["client_data.address"],
"field_type": "string"
},
{
"name": "client_data.occupation",
"json_paths": ["client_data.occupation"],
"field_type": "string"
},
{
"name": "client_data.tax_year",
"json_paths": ["client_data.tax_year"],
"field_type": "int"
},
{
"name": "client_data.tax_consultant",
"json_paths": ["client_data.tax_consultant"],
"field_type": "string"
}
]
client_data = {
"name": "Jane Doe",
"age": 25,
"address": "23 Main St, LA",
"occupation": "Accountant",
"tax_year": 2025,
"tax_consultant": "Sean O'Something"
}
(
db.new_query("clients")
.where("id", CondType.CondEq, 1)
.set_object("client_data", [client_data])
.update()
)
public static class ClientData {
@Reindex(name = "name")
private String name;
@Reindex(name = "age")
private int age;
@Reindex(name = "year")
private int year;
@Reindex(name = "occupation")
private String occupation;
@Reindex(name = "tax_year")
private int taxYear;
@Reindex(name = "tax_consultant")
private String taxConsultant;
public ClientData() {
}
public ClientData(String name, int age, int year, String occupation, int taxYear, String taxConsultant) {
this.name = name;
this.age = age;
this.year = year;
this.occupation = occupation;
this.taxYear = taxYear;
this.taxConsultant = taxConsultant;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public int getYear() {
return year;
}
public void setYear(int year) {
this.year = year;
}
public String getOccupation() {
return occupation;
}
public void setOccupation(String occupation) {
this.occupation = occupation;
}
public int getTaxYear() {
return taxYear;
}
public void setTaxYear(int taxYear) {
this.taxYear = taxYear;
}
public String getTaxConsultant() {
return taxConsultant;
}
public void setTaxConsultant(String taxConsultant) {
this.taxConsultant = taxConsultant;
}
@Override
public String toString() {
return "ClientData{" +
"name='" + name + '\'' +
", age=" + age +
", year=" + year +
", occupation='" + occupation + '\'' +
", taxYear=" + taxYear +
", taxConsultant='" + taxConsultant + '\'' +
'}';
}
}
public static class Client {
@Reindex(name = "id", isPrimaryKey = true)
private int id;
@Reindex(name = "client_data")
private ClientData data;
// You can add more fields here if necessary as indicated by the "..." in your
// Go struct
public Client() {
}
// All-args constructor
public Client(int id, ClientData data) {
this.id = id;
this.data = data;
}
// Getters and Setters
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public ClientData getData() {
return data;
}
public void setData(ClientData data) {
this.data = data;
}
@Override
public String toString() {
return "Client{" +
"id=" + id +
", data=" + data +
'}';
}
}
// ...
ClientData clientData = new ClientData();
clientData.setField(field);
// ...
clientData.setField1(field1);
db.query("clients", Client.class)
.where("id", Condition.EQ, 100)
.set("client_data", clientData)
.update();
UPDATE-запросы для удаления полей записей
В Reindexer используется следующий синтаксис UPDATE-запросов для удаления полей:
UPDATE nsName
DROP field1, field2, ..
WHERE condition;
С помощью таких запросов можно удалить только неиндексные поля или индексные
sparse-поля.
Примеры:
db.Query("items").Where("id", reindexer.EQ, 1).Drop("fieldToDrop1").Drop("fieldToDrop2").Update()
(
db.new_query("items")
.where("id", CondType.CondEq, 1)
.drop("fieldToDrop1")
.drop("fieldToDrop2")
.update()
)
db.query("items", Item.class)
.where("id", Condition.EQ, 1)
.drop("fieldToDrop1")
.drop("fieldToDrop2")
.update();
UPDATE items DROP fieldToDrop1, fieldToDrop2 WHERE id = 1
curl --location --request PUT 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
1
]
}
],
"drop_fields": [
"fieldToDrop1",
"fieldToDrop2"
]
}'
Удаление элемента массива по индексу
Примеры команд для удаления элемента массива:
db.Query("items").Where("id", reindexer.EQ, 1).Drop("arrayField[2]").Update()
(
db.new_query("items")
.where("id", CondType.CondEq, 1)
.drop("arrayField[2]")
.update()
)
db.query("items", Item.class)
.where("id", Condition.EQ, 1)
.drop("fieldToDrop[2]")
.update();
UPDATE items DROP arrayField[2] WHERE id = 11
curl --location --request PUT 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
1
]
}
],
"drop_fields" : [
"arrayField[2]"
]
}'
Удаление элементов массива по значению
Для удаления элементов массива по значению используются функции:
array_remove(). Удаляет из массива все найденные вхождения элементов, переданных в качестве аргументов;array_remove_once(). Удаляет из массива только первые найденные вхождения элементов, переданных в качестве аргументов. Удаление происходит по числу вхождений: если какое-то значение задано несколько раз, то и из целевого массива будет удалено столько же его копий.
Функции могут принимать в качестве аргумента одно или несколько значений. В обоих случаях значения указываются в квадратных скобках.
Пример удаления всех найденных вхождений элементов, переданных в качестве аргументов, с помощью array_remove:
В Go
array_removeиспользуется через методSetExpression().
db.Query("items").Where("id", reindexer.EQ, 1).SetExpression("arrayField", "array_remove(arrayField, [5,6,7,8])").Update()
(
db.new_query("items")
.where("id", CondType.CondEq, 1)
.expression("arrayField", "array_remove(arrayField, [5,6,7,8])")
.update()
)
UPDATE items SET arrayField = array_remove(arrayField, [5,6,7,8]) WHERE id = 1
curl --location --request PUT 'http://127.0.0.1:9098/api/v1/db/mydb/query' \
--header 'Content-Type: application/json' \
--data '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
1
]
}
],
"update_fields": [
{
"name": "arrayField",
"type": "expression",
"is_array": false,
"values": [
"array_remove(arrayField, [5,6,7,8])"
]
}
]
}'
Пример удаления из массива только первых найденных вхождений элементов, переданных в качестве аргументов, помощью array_remove_once:
В Go
array_remove_onceиспользуется через методSetExpression().
db.Query("items").Where("id", reindexer.EQ, 1).SetExpression("arrayField", "array_remove_once(arrayField, [5,5,5,6])").Update()
(
db.new_query("items")
.where("id", CondType.CondEq, 1)
.expression("arrayField", "array_remove_once(arrayField, [5,5,5,6])")
.update()
)
UPDATE items SET arrayField = array_remove_once(arrayField, [5,5,5,6]) WHERE id = 1
curl --location --request PUT 'http://127.0.0.1:9098/api/v1/db/mydb/query' \
--header 'Content-Type: application/json' \
--data '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
1
]
}
],
"update_fields": [
{
"name": "arrayField",
"type": "expression",
"is_array": false,
"values": [
"array_remove_once(arrayField, [5,5,5,6])"
]
}
]
}'
Использование array_remove и array_remove_once можно комбинировать с добавлением элементов в начало или конец массива:
db.Query("items").Where("id", reindexer.EQ, 1).SetExpression("arrayField", "array_remove(arrayField, [5,6,7,8]) || [1,2,3]").Update()
(
db.new_query("items")
.where("id", CondType.CondEq, 1)
.expression("arrayField", "array_remove(arrayField, [5,6,7,8]) || [1,2,3]")
.update()
)
UPDATE items SET arrayField = array_remove(arrayField, [5,6,7,8]) || [1,2,3] WHERE id = 1
curl --location --request PUT 'http://127.0.0.1:9098/api/v1/db/mydb/query' \
--header 'Content-Type: application/json' \
--data '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
1
]
}
],
"update_fields": [
{
"name": "arrayField",
"type": "expression",
"is_array": false,
"values": [
"array_remove(arrayField, [5,6,7,8]) || [1,2,3]"
]
}
]
}'
В качестве второго параметра в array_remove и array_remove_once может быть использован не только набор значений, но и имя поля, содержащего массив:
db.Query("items").Where("id", reindexer.EQ, 1).SetExpression("arrayField", "array_remove(arrayField, arrayField2)").Update()
(
db.new_query("items")
.where("id", CondType.CondEq, 1)
.expression("arrayField", "array_remove(arrayField, arrayField2)")
.update()
)
UPDATE items SET arrayField = array_remove(arrayField, arrayField2) WHERE id = 1
curl --location --request PUT 'http://127.0.0.1:9098/api/v1/db/mydb/query' \
--header 'Content-Type: application/json' \
--data '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
1
]
}
],
"update_fields": [
{
"name": "arrayField",
"type": "expression",
"is_array": false,
"values": [
"array_remove(arrayField, arrayField2)"
]
}
]
}'
Указание набора значений или имени поля, содержащего массив, в качестве набора значений для удаления из другого можно комбинировать с добавлением элементов в начало или конец массива:
db.Query("items").Where("id", reindexer.EQ, 1).SetExpression("arrayField", "[3] || array_remove(arrayField, arrayField2) || arrayField3 || array_remove(arrayField, [8,1]) || [2,4]").Update()
(
db.new_query("items")
.where("id", CondType.CondEq, 1)
.expression("arrayField", "[3] || array_remove(arrayField, arrayField2) || arrayField3 || array_remove(arrayField, [8,1]) || [2,4]")
.update()
)
UPDATE items SET arrayField = [3] || array_remove(arrayField, arrayField2) || arrayField3 || array_remove(arrayField, [8,1]) || [2,4] WHERE id = 1
curl --location --request PUT 'http://127.0.0.1:9098/api/v1/db/mydb/query' \
--header 'Content-Type: application/json' \
--data '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
1
]
}
],
"update_fields": [
{
"name": "arrayField",
"type": "expression",
"is_array": false,
"values": [
"[3] || array_remove(arrayField, arrayField2) || arrayField3 || array_remove(arrayField, [8,1]) || [2,4]"
]
}
]
}'
array_remove и array_remove_once можно использовать для инициализации массива отфильтрованными значениями из другого поля:
db.Query("items").Where("id", reindexer.EQ, 1).SetExpression("arrayField", "array_remove(arrayField2, arrayField3)").Update()
db.Query("items").Where("id", reindexer.EQ, 1).SetExpression("arrayField", "array_remove([1,2,3], arrayField2)").Update()
(
db.new_query("items")
.where("id", CondType.CondEq, 1)
.expression("arrayField", "array_remove(arrayField2, arrayField3)")
.update()
)
(
db.new_query("items")
.where("id", CondType.CondEq, 1)
.expression("arrayField", "array_remove([1,2,3], arrayField2)")
.update()
)
UPDATE items SET arrayField = array_remove(arrayField2, arrayField3) WHERE id = 1
UPDATE items SET arrayField = array_remove([1,2,3], arrayField2) WHERE id = 1
curl --location --request PUT 'http://127.0.0.1:9098/api/v1/db/mydb/query' \
--header 'Content-Type: application/json' \
--data '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
1
]
}
],
"update_fields": [
{
"name": "arrayField",
"type": "expression",
"is_array": false,
"values": [
"array_remove(arrayField2, arrayField3)"
]
}
]
}'
curl --location --request PUT 'http://127.0.0.1:9098/api/v1/db/mydb/query' \
--header 'Content-Type: application/json' \
--data '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
1
]
}
],
"update_fields": [
{
"name": "arrayField",
"type": "expression",
"is_array": false,
"values": [
"array_remove([1,2,3], arrayField2)"
]
}
]
}'
DELETE-запросы
DELETE-запросы в Reindexer используются для удаления одной или нескольких записей из неймспейса. Пример:
db.Query("items").Where("id", reindexer.EQ, 11).Delete()
(
db.new_query("items")
.where("id", CondType.CondEq, 1)
.delete()
)
db.query("items", Item.class)
.where("id", Condition.EQ, 11)
.delete();
DELETE FROM items WHERE id = 11
curl --location --request DELETE 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "items",
"filters": [
{
"Field": "id",
"Cond": "EQ",
"Value": [
1
]
}
]
}'
DELETE с INNER JOIN и подзапросами
В DELETE действуют те же правила фильтрации, что и в UPDATE с INNER JOIN и подзапросами. В обоих примерах удаляются записи из items, для которых в item_flags есть запись с соответствующим item_id и expired = true.
С INNER JOIN:
deleted, err := db.Query("items").
InnerJoin(db.Query("item_flags").Where("expired", reindexer.EQ, true), "expired_flags").
On("id", reindexer.EQ, "item_id").
Delete()
Конструктор запросов pyreindexer не поддерживает INNER JOIN в DELETE-запросах. Выполните запрос через exec_sql().
db.exec_sql(
"DELETE FROM items "
"WHERE INNER JOIN (SELECT * FROM item_flags WHERE expired = true) "
"ON items.id = item_flags.item_id"
)
Java-коннектор поддерживает INNER JOIN в конструкторе DELETE-запросов начиная с версии 1.35.
db.query("items", Item.class)
.innerJoin(
db.query("item_flags", ItemFlag.class)
.where("expired", Condition.EQ, true)
.on("id", Condition.EQ, "item_id"),
"expired_flags")
.delete();
DELETE FROM items
WHERE INNER JOIN (SELECT * FROM item_flags WHERE expired = true)
ON items.id = item_flags.item_id;
curl --location --request DELETE 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "items",
"filters": [
{
"join_query": {
"type": "inner",
"namespace": "item_flags",
"filters": [{"field": "expired", "cond": "eq", "value": [true]}],
"on": [{"left_field": "id", "right_field": "item_id", "cond": "eq"}]
}
}
]
}'
С подзапросом в WHERE:
flags := db.Query("item_flags").Select("item_id").Where("expired", reindexer.EQ, true)
deleted, err := db.Query("items").
Where("id", reindexer.SET, flags).
Delete()
Для подзапроса в конструкторе используйте where_subquery().
flags = (
db.new_query("item_flags")
.select_fields("item_id")
.where("expired", CondType.CondEq, True)
)
(
db.new_query("items")
.where_subquery("id", CondType.CondSet, flags)
.delete()
)
Для подзапроса передайте объект Query в where().
Query<ItemFlag> flags = db.query("item_flags", ItemFlag.class)
.select("item_id")
.where("expired", Condition.EQ, true);
db.query("items", Item.class)
.where("id", Condition.SET, flags)
.delete();
DELETE FROM items
WHERE id IN (SELECT item_id FROM item_flags WHERE expired = true);
curl --location --request DELETE 'http://127.0.0.1:9088/api/v1/db/testdb/query' \
--header 'Content-Type: application/json' \
--data-raw '{
"namespace": "items",
"filters": [
{
"field": "id",
"cond": "set",
"subquery": {
"namespace": "item_flags",
"select_filter": ["item_id"],
"filters": [{"field": "expired", "cond": "eq", "value": [true]}]
}
}
]
}'
TRUNCATE-запросы
TRUNCATE-запросы в Reindexer могут использовать как более эффективная альтернатива для DELETE-запросов в ситуациях, когда требуется очистить неймспейс целиком. Этот тип запросов не предполагает никакой фильтрации и всегда удаляет все документы из неймспейса.
Синтаксис:
db.TruncateNamespace("items")
db.namespace_truncate("items")
Внимание
На данный момент в Java query builder нет обёртки для truncate, однако его возможно использовать через SQL.
ResultIterator<Item> query = db.execSql(
"TRUNCATE items",
Item.class
);
TRUNCATE items
curl --location --request DELETE 'http://127.0.0.1:9088/api/v1/db/testdb/namespaces/items/truncate'
Основные отличия TRUNCATE ns от DELETE * FROM ns:
- TRUNCATE деаллоцирует динамически выделенную память индексных структур.
- TRUNCATE создаёт только одну запись в WAL. DELETE, в свою очередь, сохраняет сериализованные первичные ключи для всех удалённых записей.
- TRUNCATE не возвращает ни количество удалённых записей, ни сами записи.