Zen

Translation

English
Since version :doc:`2.3 </release/2.3.2>`, Tarantool supports JSON path updates. You can update or upsert formatted :doc:`tuple </reference/reference_lua/box_tuple/update>` / :ref:`space <box_space-update>` / :doc:`index </reference/reference_lua/box_index/update>` fields by name (not only by field number). Updates of nested structures are also supported.
Начиная с версии 2.3, Tarantool поддерживает обновление с помощью JSON-пути. Теперь можно делать обновление/обновление со вставкой отформатированных полей :doc:`кортежа </reference/reference_lua/box_tuple/update>` /:ref:`спейса <box_space-update>` /:doc:`индекса </reference/reference_lua/box_index/update>` по имени (а не только по номеру поля). Обновления вложенных структур также поддерживаются.
398/3570 · 357
English Russian Actions
JSON paths
JSON-пути
Overview
Общие сведения
Since version :doc:`2.3 </release/2.3.2>`, Tarantool supports JSON path updates. You can update or upsert formatted :doc:`tuple </reference/reference_lua/box_tuple/update>` / :ref:`space <box_space-update>` / :doc:`index </reference/reference_lua/box_index/update>` fields by name (not only by field number). Updates of nested structures are also supported.
Начиная с версии 2.3, Tarantool поддерживает обновление с помощью JSON-пути. Теперь можно делать обновление/обновление со вставкой отформатированных полей :doc:`кортежа </reference/reference_lua/box_tuple/update>` /:ref:`спейса <box_space-update>` /:doc:`индекса </reference/reference_lua/box_index/update>` по имени (а не только по номеру поля). Обновления вложенных структур также поддерживаются.
**Example:**
**Пример:**
tarantool> box.cfg{};
> format = {};
> format[1] = {'field1', 'unsigned'};
> format[2] = {'field2', 'map'};
> format[3] = {'field3', 'array'};
> format[4] = {'field4', 'string', is_nullable = true}
---
...
tarantool> s = box.schema.create_space('test', {format = format});
> _ = s:create_index('pk')
---
...
tarantool> t = {
> 1,
> {
> key1 = 'value',
> key2 = 10
> },
> {
> 2,
> 3,
> {key3 = 20}
> }
> }
---
...
tarantool> t = s:replace(t)
---
...
tarantool> t:update({{'=', 'field2.key1', 'new_value'}})
---
- [1, {'key1': 'new_value', 'key2': 10}, [2, 3, {'key3': 20}]]
...
tarantool> t:update({{'+', 'field3[2]', 1}})
---
- [1, {'key1': 'value', 'key2': 10}, [2, 4, {'key3': 20}]]
...
tarantool> s:update({1}, {{'!', 'field4', 'inserted value'}})
---
- [1, {'key1': 'value', 'key2': 10}, [2, 3, {'key3': 20}], 'inserted value']
...
tarantool> s:update({1}, {{'#', '[2].key2', 1}, {'=', '[3][3].key4', 'value4'}})
---
- [1, {'key1': 'value'}, [2, 3, {'key3': 20, 'key4': 'value4'}], 'inserted value']
...
tarantool> s:upsert({1, {k = 'v'}, {}}, {{'#', '[2].key1', 1}})
---
...
tarantool> s:select{}
---
- - [1, {}, [2, 3, {'key3': 20, 'key4': 'value4'}], 'inserted value']
...
 
Notice that field names that look like JSON paths are processed similarly to :doc:`accessing tuple fields by JSON </reference/reference_lua/box_tuple/field_path>`: first, the whole path is interpreted as a field name; if such a name does not exist, then it is treated as a path.
Обратите внимание, что имена полей, которые выглядят как JSON-пути, обрабатываются аналогично :doc:`доступу к полям кортежа через JSON </reference/reference_lua/box_tuple/field_path>`: сначала весь путь интерпретируется как имя поля; если такого имени не существует, то оно обрабатывается как путь.
For example, for a field name ``field.name.like.json``, this update
Например, для имя поля ``field.name.like.json``, это обновление
:samp:`{object-name}:update({..., 'field.name.like.json', ...})`
 
will update this field instead of keys ``field`` -> ``name`` -> ``like`` -> ``json``. If you need such a name as part of a bigger path, then you should wrap it in quotes ``""`` and brackets ``[]``:
обновит именно это поле целиком, а не ключи ``field`` -> ``name`` -> ``like`` -> ``json``. Если это имя нужно вам как часть большего пути, то его нужно обернутьв кавычки ``""`` или квадратные скобки ``[]``:
:samp:`{object-name}:update({..., '["field.name.like.json"].next.fields', ...})`
 
**There are some rules for JSON updates:**
**Есть несколько правил для обновления через JSON:**
Operation ``'!'`` can't be used to create all intermediate nodes of a path. For example, ``{'!', 'field1[1].field3', ...}`` can't create fields ``'field1'`` and ``'[1]'``, they should exist.
Операция ``'!'`` не может быть использована для создания всех промежуточных узлов пути.Например, ``{'!', 'field1[1].field3', ...}`` не может создать поля ``'field1'`` и ``'[1]'``, они должны существовать.
Operation ``'#'``, when applied to maps, can't delete more than one key at once. That is, its argument should be always 1 for maps.
Операция ``'#'``, при применении к ассоциативным массивам, не может удалить сразу несколько ключей. Поэтому для ассоциативных массивов ее аргумент всегда должен быть 1.
``{'#', 'field1.field2', 1}`` is allowed;
``{'#', 'field1.field2', 1}`` -- разрешено;
``{'#', 'field1.field2', 10}`` is not.
``{'#', 'field1.field2', 10}`` -- не разрешено.
This limitation originates from the problem that keys in a map are not ordered anyhow, and ``'#'`` with more than 1 key would lead to undefined behavior.
Это ограничение возникает из-за проблемы, что ключи на ассоциативном массиве все равно не упорядочены, а ``'#'`` с более чем 1 ключом приведет к неопределенному поведению.
Operation ``'!'`` on maps can't create a key, if it exists already.
Операция ``'!'`` на ассоциативных массивах не может создать ключ, если он уже существует.
If a map contains non-string keys (booleans, numbers, maps, arrays - anything), then these keys can't be updated via JSON paths. But it is still allowed to update string keys in such a map.
Если ассоциативный массив содержит нестроковые ключи (булеаны, цифры, ассоциативные массивы, массивы - все что угодно), то эти ключи не могут быть обновлены с помощью JSON-путей. Но в таком ассоциативном массиве все равно разрешено обновлять строковые ключи.

Loading…

User avatar None

String updated in the repository

testing_project / Documentation: reference/reference_lua/json_paths — Russian

Since version :doc:`2.3 </release/2.3.2>`, Tarantool supports JSON path updates. You can update or upsert formatted :doc:`tuple </reference/reference_lua/box_tuple/update>` / :ref:`space <box_space-update>` / :doc:`index </reference/reference_lua/box_index/update>` fields by name (not only by field number). Updates of nested structures are also supported.
Начиная с версии 2.3, Tarantool поддерживает обновление с помощью JSON-пути. Теперь можно делать обновление/обновление со вставкой отформатированных полей :doc:`кортежа </reference/reference_lua/box_tuple/update>` /:ref:`спейса <box_space-update>` /:doc:`индекса </reference/reference_lua/box_index/update>` по имени (а не только по номеру поля). Обновления вложенных структур также поддерживаются.
a year ago
Browse all string changes

Things to check

Consecutive duplicated words 1

Text contains the same word twice in a row: обновление

Reset

Glossary

English Russian
No related strings found in the glossary.

String information

String age
a year ago
Last updated
a year ago
Source string age
a year ago
Translation file
locale/ru/LC_MESSAGES/reference/reference_lua/json_paths.po, string 3