DOCAPI-7443: Virtual columns docs update. EN review. RU translation. (#6640)

* Update index.md (#35)

* DOCAPI-7443: RU translation.

* Link fix.

* DOCAPI-7443: Fixes.

* DOCAPI-7443: Fixes.

docs/en/operations/table_engines/index.md

@@ -2,7 +2,7 @@
 
 The table engine (type of table) determines:
 
-- How and where data is stored, where to write it to, and from where to read it.
+- How and where data is stored, where to write it to, and where to read it from.
 - Which queries are supported, and how.
 - Concurrent data access.
 - Use of indexes, if present.
@@ -11,13 +11,13 @@ The table engine (type of table) determines:
 
 ## Engine Families
 
-### *MergeTree
+### MergeTree
 
-The most universal and functional table engines for high-load tasks. The common property of these engines is quick data insertion with subsequent data processing in the background. The `*MergeTree` engines support data replication (with [Replicated*](replication.md) versions of engines), partitioning and other features not supported in other engines.
+The most universal and functional table engines for high-load tasks. The property shared by these engines is quick data insertion with subsequent background data processing. `MergeTree` family engines support data replication (with [Replicated*](replication.md) versions of engines), partitioning, and other features not supported in other engines.
 
-Engines of the family:
+Engines in the family:
 
-- [MergTree](mergetree.md)
+- [MergeTree](mergetree.md)
 - [ReplacingMergeTree](replacingmergetree.md)
 - [SummingMergeTree](summingmergetree.md)
 - [AggregatingMergeTree](aggregatingmergetree.md)
@@ -25,11 +25,11 @@ Engines of the family:
 - [VersionedCollapsingMergeTree](versionedcollapsingmergetree.md)
 - [GraphiteMergeTree](graphitemergetree.md)
 
-### *Log
+### Log
 
-Lightweight [engines](log_family.md) with minimum functionality. They are the most effective in scenarios when you need to quickly write many small tables (up to about 1 million rows) and read them later as a whole.
+Lightweight [engines](log_family.md) with minimum functionality. They're the most effective when you need to quickly write many small tables (up to approximately 1 million rows) and read them later as a whole.
 
-Engines of the family:
+Engines in the family:
 
 - [TinyLog](tinylog.md)
 - [StripeLog](stripelog.md)
@@ -39,7 +39,7 @@ Engines of the family:
 
 Engines for communicating with other data storage and processing systems.
 
-Engines of the family:
+Engines in the family:
 
 - [Kafka](kafka.md)
 - [MySQL](mysql.md)
@@ -48,9 +48,7 @@ Engines of the family:
 
 ### Special engines
 
-Engines solving special tasks.
-
-Engines of the family:
+Engines in the family:
 
 - [Distributed](distributed.md)
 - [MaterializedView](materializedview.md)
@@ -67,12 +65,12 @@ Engines of the family:
 
 ## Virtual columns {#table_engines-virtual_columns}
 
-Virtual column is an integral attribute of a table engine that is defined in the source code of the engine.
+Virtual column is an integral table engine attribute that is defined in the engine source code.
 
-You should not specify virtual columns in the `CREATE TABLE` query, and you cannot see them in the results of `SHOW CREATE TABLE` and `DESCRIBE TABLE` queries. Also, virtual columns are read-only, so you can't insert data into virtual columns.
+You shouldn't specify virtual columns in the `CREATE TABLE` query and you can't see them in `SHOW CREATE TABLE` and `DESCRIBE TABLE` query results. Virtual columns are also read-only, so you can't insert data into virtual columns.
 
-To select data from a virtual column, you must specify its name in the `SELECT` query. The `SELECT *` doesn't return values from virtual columns.
+To select data from a virtual column, you must specify its name in the `SELECT` query. `SELECT *` doesn't return values from virtual columns.
 
-If you create a table with a column that has the same name as one of the table virtual columns, the virtual column becomes inaccessible. Doing so is not recommended. To help avoiding conflicts virtual column names are usually prefixed with an underscore.
+If you create a table with a column that has the same name as one of the table virtual columns, the virtual column becomes inaccessible. We don't recommend doing this. To help avoid conflicts, virtual column names are usually prefixed with an underscore.
 
 [Original article](https://clickhouse.yandex/docs/en/operations/table_engines/) <!--hide-->

docs/en/query_language/misc.md

@@ -201,7 +201,7 @@ All tables are renamed under global locking. Renaming tables is a light operatio
 SET param = value
 ```
 
-Assigns `value` to the `param` configurations settings for the current session. You cannot change [server settings](../operations/server_settings/index.md) this way.
+Assigns `value` to the `param` [setting](../operations/settings/index.md) for the current session. You cannot change [server settings](../operations/server_settings/index.md) this way.
 
 You can also set all the values from the specified settings profile in a single query.
 

docs/ru/operations/table_engines/index.md

@@ -9,8 +9,69 @@
 - Возможно ли многопоточное выполнение запроса.
 - Параметры репликации данных.
 
-При чтении, движок обязан лишь выдать запрошенные столбцы, но в некоторых случаях движок может частично обрабатывать данные при ответе на запрос.
+## Семейства движков
 
-Для большинства серьёзных задач, следует использовать движки семейства `MergeTree`.
+### MergeTree
+
+Наиболее универсальные и функциональные движки таблиц для задач с высокой загрузкой. Общим свойством этих движков является быстрая вставка данных с последующей фоновой обработкой данных. Движки `*MergeTree` поддерживают репликацию данных (в [Replicated*](replication.md) версиях движков), партиционирование, и другие возможности не поддержанные для других движков.
+
+Движки семейства:
+
+- [MergeTree](mergetree.md)
+- [ReplacingMergeTree](replacingmergetree.md)
+- [SummingMergeTree](summingmergetree.md)
+- [AggregatingMergeTree](aggregatingmergetree.md)
+- [CollapsingMergeTree](collapsingmergetree.md)
+- [VersionedCollapsingMergeTree](versionedcollapsingmergetree.md)
+- [GraphiteMergeTree](graphitemergetree.md)
+
+### Log
+
+Простые [движки](log_family.md) с минимальной функциональностью. Они наиболее эффективны, когда вам нужно быстро записать много небольших таблиц (до примерно 1 миллиона строк) и прочитать их позже целиком.
+
+Движки семейства:
+
+- [TinyLog](tinylog.md)
+- [StripeLog](stripelog.md)
+- [Log](log.md)
+
+### Движки для интергации
+
+Движки для связи с другими системами хранения и обработки данных.
+
+Движки семейства:
+
+- [Kafka](kafka.md)
+- [MySQL](mysql.md)
+- [ODBC](odbc.md)
+- [JDBC](jdbc.md)
+
+### Специальные движки
+
+Движки семейства:
+
+- [Distributed](distributed.md)
+- [MaterializedView](materializedview.md)
+- [Dictionary](dictionary.md)
+- [Merge](merge.md)
+- [File](file.md)
+- [Null](null.md)
+- [Set](set.md)
+- [Join](join.md)
+- [URL](url.md)
+- [View](view.md)
+- [Memory](memory.md)
+- [Buffer](buffer.md)
+
+## Виртуальные столбцы {#table_engines-virtual_columns}
+
+Виртуальный столбец — это неотъемлемый атрибут движка таблиц, определенный в исходном коде движка.
+
+Виртуальные столбцы не надо указывать в запросе `CREATE TABLE` и их не отображаются в результатах запросов `SHOW CREATE TABLE` и `DESCRIBE TABLE`. Также виртуальные столбцы доступны только для чтения, поэтому вы не можете вставлять в них данные.
+
+Чтобы получить данные из виртуального столбца, необходимо указать его название в запросе `SELECT`. `SELECT *` не отображает данные из виртуальных столбцов.
+
+При создании таблицы со столбцом, имя которого совпадает с именем одного из виртуальных столбцов таблицы, виртуальный столбец становится недоступным. Не делайте так. Чтобы помочь избежать конфликтов, имена виртуальных столбцов обычно предваряются подчеркиванием.
 
 [Оригинальная статья](https://clickhouse.yandex/docs/ru/operations/table_engines/) <!--hide-->
+

docs/ru/operations/table_engines/kafka.md

@@ -152,4 +152,17 @@ Kafka(kafka_broker_list, kafka_topic_list, kafka_group_name, kafka_format
 
 В документе [librdkafka configuration reference](https://github.com/edenhill/librdkafka/blob/master/CONFIGURATION.md) можно увидеть список возможных опций конфигурации. Используйте подчеркивание (`_`) вместо точки в конфигурации ClickHouse. Например, `check.crcs=true` будет соответствовать `<check_crcs>true</check_crcs>`.
 
+## Виртуальные столбцы
+
+- `_topic` — топик Kafka.
+- `_key` — ключ сообщения.
+- `_offset` — оффсет сообщения.
+- `_timestamp` — временная метка сообщения.
+- `_partition` — секция топика Kafka.
+
+**Смотрите также**
+
+- [Виртуальные столбцы](index.md#table_engines-virtual_columns)
+
 [Оригинальная статья](https://clickhouse.yandex/docs/ru/operations/table_engines/kafka/) <!--hide-->
+

docs/ru/operations/table_engines/merge.md

@@ -52,18 +52,12 @@ FROM WatchLog
 
 ## Виртуальные столбцы
 
-Виртуальные столбцы — столбцы, предоставляемые движком таблиц независимо от определения таблицы. То есть, такие столбцы не указываются в `CREATE TABLE`, но доступны для `SELECT`.
+- `_table` — содержит имя таблицы, из которой данные были прочитаны. Тип — [String](../../data_types/string.md).
 
-Виртуальные столбцы отличаются от обычных следующими особенностями:
+    В секции `WHERE/PREWHERE` можно установить константное условие на столбец `_table` (например, `WHERE _table='xyz'`). В этом случае операции чтения выполняются только для тех таблиц, для которых выполняется условие на значение `_table`, таким образом, столбец `_table` работает как индекс.
 
--   они не указываются в определении таблицы;
--   в них нельзя вставить данные при `INSERT`;
--   при `INSERT` без указания списка столбцов виртуальные столбцы не учитываются;
--   они не выбираются при использовании звёздочки (`SELECT *`);
--   виртуальные столбцы не показываются в запросах `SHOW CREATE TABLE` и `DESC TABLE`;
+**Смотрите также**
 
-Таблица типа `Merge` содержит виртуальный столбец `_table` типа `String`. (Если в таблице уже есть столбец `_table`, то виртуальный столбец называется `_table1`; если уже есть `_table1`, то `_table2` и т. п.) Он содержит имя таблицы, из которой были прочитаны данные.
-
-Если секция `WHERE/PREWHERE` содержит (в качестве одного из элементов конъюнкции или в качестве всего выражения) условия на столбец `_table`, не зависящие от других столбцов таблицы, то эти условия используются как индекс: условия выполняются над множеством имён таблиц, из которых нужно читать данные, и чтение будет производиться только из тех таблиц, для которых условия сработали.
+- [Виртуальные столбцы](index.md#table_engines-virtual_columns)
 
 [Оригинальная статья](https://clickhouse.yandex/docs/ru/operations/table_engines/merge/) <!--hide-->

docs/ru/query_language/misc.md

@@ -199,7 +199,7 @@ RENAME TABLE [db11.]name11 TO [db12.]name12, [db21.]name21 TO [db22.]name22, ...
 SET param = value
 ```
 
-Устанавливает значение `value` для настройки `param` в текущей сессии. [Конфигурационные параметры сервера](../operations/server_settings/index.md) нельзя изменить подобным образом.
+Устанавливает значение `value` для [настройки](../operations/settings/index.md) `param` в текущей сессии. [Конфигурационные параметры сервера](../operations/server_settings/index.md) нельзя изменить подобным образом.
 
 Можно одним запросом установить все настройки из заданного профиля настроек.