testing_project/Documentation: concepts/data_model/schema_desc — Russian @ Weblate: box.cfg() users = box.schema.create_space('users', { if_not

The translation is temporarily closed for contributions due to maintenance, please come back later.
The translation was automatically locked due to following alerts: Could not merge the repository.

Zen

Translation

English

Russian

Needs editing

Skip

	English	Russian	Actions
	Data schema description	Описание схемы данных
	In Tarantool, the use of a data schema is optional.	В Tarantool использование схемы данных опционально.
	When creating a :term:`space <space>`, you do not have to define a data schema. In this case, the tuples store random data. This rule does not apply to indexed fields. Such fields must contain data of the same type.	При создании :term:`спейса <space>` схему можно не задавать и тогда в кортежах могут лежать произвольные данные. Это правило не распространяется на поля, по которым построены индексы. У таких полей данные должны быть одного типа.
	You can define a data schema when creating a space. Read more in the description of the :doc:`/reference/reference_lua/box_schema/space_create` function. If you have already created a space without specifying a data schema, you can do it later using :doc:`/reference/reference_lua/box_space/format`.	Схему можно задать при создании спейса. Читайте подробнее в описании функции :doc:`/reference/reference_lua/box_schema/space_create`. Если вы создали спейс без схемы, ее можно добавить позже с помощью метода :doc:`/reference/reference_lua/box_space/format`.
	After the data schema is defined, all the data is validated by type. Before any insert or update, you will get an error if the data types do not match.	После указания схемы данные начинают валидироваться по типам. Перед каждой операцией вставки или обновления они проверяются, и в случае несоответствия типов вы получите ошибку.
	We recommend using a data schema because it helps avoid mistakes.	Мы рекомендуем использовать подход со схемой, потому что он помогает избежать ошибок.
	In Tarantool, you can define a data schema in two different ways.	Схему в Tarantool можно задавать двумя разными способами.
	Data schema description in a code file	Описание схемы в файле с кодом
	The code file is usually called ``init.lua`` and contains the following schema description:	Обычно файл с кодом называется ``init.lua`` и имеет следующее описание схемы:
	box.cfg() users = box.schema.create_space('users', { if_not_exists = true }) users:format({{ name = 'user_id', type = 'number'}, { name = 'fullname', type = 'string'}}) users:create_index('pk', { parts = { { field = 'user_id', type = 'number'}}})	box.cfg() users = box.schema.create_space('users', { if_not_exists = true }) users:format({{ name = 'user_id', type = 'number'}, { name = 'fullname', type = 'string'}}) users:create_index('pk', { parts = { { field = 'user_id', type = 'number'}}})
	This is quite simple: when you run tarantool, it executes this code and creates a data schema. To run this file, use:	Этот подход довольно простой. Когда вы запустите tarantool, этот код исполнится и создаст схему. Чтобы запустить файл, используйте следующую команду:
	tarantool init.lua	tarantool init.lua
	However, it may seem complicated if you do not plan to dive deep into the Lua language and its syntax.	Но это может показаться слишком сложным, если вы не собираетесь глубоко разбираться с языком Lua и его синтаксисом.
	Possible difficulty: the snippet above has a function call with a colon: ``users:format``. It is used to pass the ``users`` variable as the first argument of the ``format`` function. This is similar to ``self`` in object-based languages.	Пример возможной сложности: в фрагменте выше есть вызов функций с двоеточием: ``users:format``. Он используется, чтобы передать переменную ``users`` в качестве первого аргумента функции ``format``. Это аналог ``self`` в объектно-ориентированных языках.
	So it might be more convenient for you to describe the data schema with YAML.	Поэтому вам может быть удобно описать схему через YAML.
	Data schema description using the DDL module	Описание через модуль DDL
	The `DDL module <https://github.com/tarantool/ddl>`_ allows you to describe a data schema in the YAML format in a declarative way.	`Модуль DDL <https://github.com/tarantool/ddl>`_ позволяет декларативно описывать схему данных в YAML формате.
	The schema would look something like this:	Схема будет выглядеть примерно вот так:
	spaces: users: engine: memtx is_local: false temporary: false format: - {name: user_id, type: uuid, is_nullable: false} - {name: fullname, type: string, is_nullable: false} - {name: bucket_id, type: unsigned, is_nullable: false} indexes: - name: user_id unique: true parts: [{path: user_id, type: uuid, is_nullable: false}] type: HASH - name: bucket_id unique: false parts: [{path: bucket_id, type: unsigned, is_nullable: false}] type: TREE sharding_key: [user_id] sharding_func: test_module.sharding_func	spaces: users: engine: memtx is_local: false temporary: false format: - {name: user_id, type: uuid, is_nullable: false} - {name: fullname, type: string, is_nullable: false} indexes: - name: user_id unique: true parts: [{path: user_id, type: uuid, is_nullable: false}] type: HASH
	This alternative is simpler to use, and you do not have to dive deep into Lua.	Этот вариант проще для старта: его проще использовать и не нужно вникать в язык Lua.
	``DDL`` is a built-in :doc:`Cartridge </book/cartridge/index>` module. Cartridge is a cluster solution for Tarantool. In its WebUI, there is a separate tab called "Code". On this tab, in the ``schema.yml`` file, you can define the schema, check its correctness, and apply it to the whole cluster.	Модуль ``DDL`` встроен по умолчанию в :doc:`Cartridge </book/cartridge/index>`. Cartridge — это кластерное решение для Tarantool. В его веб-интерфейсе есть отдельная вкладка "Schema". Там можно написать схему, проверить ее корректность и применить на всем кластере.
	If you do not use Cartridge, you can still use the DDL module: put the following Lua code into the file that you use to run Tarantool. This file is usually called ``init.lua``.	Если вы не используете Cartridge, то чтобы использовать модуль DDL, нужно вставить нижеприведенный код на Lua в файл, с которым вы запускаете Tarantool. Обычно это ``init.lua``.
	local yaml = require('yaml') local ddl = require('ddl') box.cfg{} local fh = io.open('ddl.yml', 'r') local schema = yaml.decode(fh:read('*all')) fh:close() local ok, err = ddl.check_schema(schema) if not ok then print(err) end local ok, err = ddl.set_schema(schema) if not ok then print(err) end	local yaml = require('yaml') local ddl = require('ddl') box.cfg{} local fh = io.open('ddl.yml', 'r') local schema = yaml.decode(fh:read('*all')) fh:close() local ok, err = ddl.check_schema(schema) if not ok then print(err) end local ok, err = ddl.set_schema(schema) if not ok then print(err) end
	It is forbidden to modify the data schema in DDL after it has been applied. For migration, there are different scenarios described in the :ref:`Migrations <migrations>` section.	Менять схему в самом DDL после ее применения нельзя. Для миграций есть несколько подходов — они описаны в разделе :ref:`Миграции <migrations>`.