testing_project/Documentation: reference/reference_lua/box_space/create_index — Russian @ Weblate: box.schema.space.create('space1') box.space.space1:create_index('primary', { parts = { { field = 1, …

Translation

English

Russian

Needs editing

Skip

	English	Russian	Actions
	Specify the path string for a map field.
	See the examples below:
	:ref:`Creating an index using the path option for map fields <box_space-path>`	:ref:`Создание индекса с использованием пути для полей с ассоциативными массивами (индексы по пути JSON) <box_space-path>`
	:ref:`Creating a multikey index using the path option with [*] <box_space-path_multikey>`	:ref:`Создание индекса по массивам (multikey) с использованием опции path с символом [*] <box_space-path_multikey>`
	Examples	Примеры
	Creating an index using field names and numbers	Создание индекса с использованием имен полей вместо номеров полей
	``create_index()`` can use field names or field numbers to define key parts.	Создание индекса с использованием имен полей вместо номеров полей
	Example 1 (field names):	Пример:
	Example 2 (field numbers):
	-- Create a primary index -- box.space.bands:create_index('primary', { parts = { 1 } }) -- Create a unique secondary index -- box.space.bands:create_index('band', { parts = { 2 } }) -- Create a non-unique secondary index -- box.space.bands:create_index('year', { parts = { { 3 } }, unique = false }) -- Create a multi-part index -- box.space.bands:create_index('year_band', { parts = { 3, 2 } })
	Creating an index using the path option for map fields (JSON-path indexes)	Создание индекса с использованием пути для полей с ассоциативными массивами (индексы по пути JSON)
	To create an index for a field that is a map (a path string and a scalar value), specify the path string during index creation, like this:	Чтобы создать индекс для поля, которое представляет собой ассоциативный массив (строка с путем и скалярное значение), укажите строку c путем во время создания индекса:
	:extsamp:`parts = {{{field-number}}, {{'data-type'}}, path = {{'path-name'}}}`	:extsamp:`parts = {{{field-number}}, {{'data-type'}}, path = {{'path-name'}}}`
	The index type must be TREE or HASH and the contents of the field must always be maps with the same path.	Тип индекса должен быть TREE или HASH, а содержимое поля — всегда ассоциативный массив с одним и тем же путем.
	Example 1 -- The simplest use of path:	Пример 1 — Простое использование пути:
	box.schema.space.create('space1') box.space.space1:create_index('primary', { parts = { { field = 1, type = 'scalar', path = 'age' } } }) box.space.space1:insert({ { age = 44 } }) box.space.space1:select(44)	tarantool> box.schema.space.create('T') tarantool> box.space.T:create_index('I',{parts = {{field = 1, type = 'scalar', path = 'age'}}}) tarantool> box.space.T:insert({{age = 44}}) tarantool> box.space.T:select(44) --- - [{'age': 44}]
	Example 2 -- path plus format() plus JSON syntax to add clarity:	Пример 2 — для большей наглядности используем path вместе с format() и JSON-синтаксисом:
	box.schema.space.create('space2') box.space.space2:format({ { 'id', 'unsigned' }, { 'data', 'map' } }) box.space.space2:create_index('info', { parts = { { 'data.full_name["firstname"]', 'str' }, { 'data.full_name["surname"]', 'str' } } }) box.space.space2:insert({ 1, { full_name = { firstname = 'John', surname = 'Doe' } } }) box.space.space2:select { 'John' }
	Creating a multikey index using the path option with [*]	Создание индекса по массивам (multikey) с использованием опции path с символом [*]
	The string in a path option can contain ``[]`` which is called an array index placeholder*. Indexes defined with this are useful for JSON documents that all have the same structure.	Строка в параметре пути может содержать символ ``[]``, который называется заменителем индекса массива*. Описанные так индексы используются для JSON-документов, у которых одинаковая структура.
	For example, when creating an index on field#2 for a string document that will start with ``{'data': [{'name': '...'}, {'name': '...'}]``, the parts section in the ``create_index`` request could look like:	Например, при создании индекса по полю №2 для документа со строками, который будет начинаться с ``{'data': [{'name': '...'}, {'name': '...'}]``, раздел parts в запросе на создание индекса будет выглядеть так:
	parts = {{field = 2, type = 'str', path = 'data[*].name'}}	parts = {{field = 2, type = 'str', path = 'data[*].name'}}
	Then tuples containing names can be retrieved quickly with ``index_object:select({key-value})``.	Тогда кортежи с именами можно быстро получить с помощью ``index_object:select({key-value})``.
	A single field can have multiple keys, as in this example which retrieves the same tuple twice because there are two keys 'A' and 'B' which both match the request:	На самом деле в одном поле может быть несколько ключей, как в примере ниже, который выводит один и тот же кортеж дважды, потому что оба ключа 'A' и 'B' соответствуют запросу:
	my_space = box.schema.space.create('json_documents') my_space:create_index('primary') multikey_index = my_space:create_index('multikey', {parts = {{field = 2, type = 'str', path = 'data[*].name'}}}) my_space:insert({1, {data = {{name = 'A'}, {name = 'B'}}, extra_field = 1}}) multikey_index:select({''}, {iterator = 'GE'})	my_space = box.schema.space.create('json_documents') my_space:create_index('primary') multikey_index = my_space:create_index('multikey', {parts = {{field = 2, type = 'str', path = 'data[*].name'}}}) my_space:insert({1, {data = {{name = 'A'}, {name = 'B'}}, extra_field = 1}}) multikey_index:select({''}, {iterator = 'GE'})
	The result of the select request looks like this:	Результат выборки будет выглядеть так:
	tarantool> multikey_index:select({''},{iterator='GE'}) --- - - [1, {'data': [{'name': 'A'}, {'name': 'B'}], 'extra_field': 1}] - [1, {'data': [{'name': 'A'}, {'name': 'B'}], 'extra_field': 1}] ...	tarantool> multikey_index:select({''},{iterator='GE'}) --- - - [1, {'data': [{'name': 'A'}, {'name': 'B'}], 'extra_field': 1}] - [1, {'data': [{'name': 'A'}, {'name': 'B'}], 'extra_field': 1}] ...
	The following restrictions exist:	Есть некоторые ограничения:
	``[*]`` must be alone or must be at the end of a name in the path.	символ ``[*]`` должен стоять отдельно или в конце имени в пути.
	``[*]`` must not appear twice in the path.	символ ``[*]`` не должен повторяться в пути.
	If an index has a path with ``x[*]``, then no other index can have a path with x.component.	Если в индексе есть путь с ``x[*]``, то в никаком другом индексе не может быть пути с x.компонентом,