Docapi 3818 stripe log (#4191)

* Update of english version of descriprion of the table function `file`.

* New syntax for ReplacingMergeTree.
Some improvements in text.

* Significantly change article about SummingMergeTree.
Article is restructured, text is changed in many places of the document. New syntax for table creation is described.

* Descriptions of AggregateFunction and AggregatingMergeTree are updated. Russian version.

* New syntax for new syntax of CREATE TABLE

* Added english docs on Aggregating, Replacing and SummingMergeTree.

* CollapsingMergeTree docs. English version.

* 1. Update of CollapsingMergeTree. 2. Minor changes in markup

* Update aggregatefunction.md

* Update aggregatefunction.md

* Update aggregatefunction.md

* Update aggregatingmergetree.md

* GraphiteMergeTree docs update.
New syntax for creation of Replicated* tables.
Minor changes in *MergeTree tables creation syntax.

* Markup fix

* Markup and language fixes

* Clarification in the CollapsingMergeTree article

* DOCAPI-4821. Sync between ru and en versions of docs.

* Fixed the ambiguity in geo functions description.

* Example of JOIN in ru docs

* Deleted misinforming example.

* Fixed links to IN operators.

* Updated the description of ALTER MODIFY.

* [RU] Updated ALTER MODIFY description.

* Fixed anchors.

* DOCAPI-3818: The Family of Log engines. StripeLog. Tocs sync.

* DOCAPI-3818: Edits after review by Ivan Blinkov.

docs/en/operations/server_settings/settings.md

@@ -61,7 +61,7 @@ ClickHouse checks `min_part_size` and `min_part_size_ratio` and processes the `c
 
 The default database.
 
-To get a list of databases, use the [SHOW DATABASES](../../query_language/misc.md#query_language_queries_show_databases) query.
+To get a list of databases, use the [SHOW DATABASES](../../query_language/misc.md#show-databases) query.
 
 **Example**
 

docs/en/operations/table_engines/log.md

@@ -1,6 +1,9 @@
 # Log
 
-Log differs from TinyLog in that a small file of "marks" resides with the column files. These marks are written on every data block and contain offsets that indicate where to start reading the file in order to skip the specified number of rows. This makes it possible to read table data in multiple threads.
+Engine belongs to the family of log engines. See the common properties of log engines and their differences in the [Log Engine Family](log_family.md) article.
+
+
+Log differs from [TinyLog](tinylog.md) in that a small file of "marks" resides with the column files. These marks are written on every data block and contain offsets that indicate where to start reading the file in order to skip the specified number of rows. This makes it possible to read table data in multiple threads.
 For concurrent data access, the read operations can be performed simultaneously, while write operations block reads and each other.
 The Log engine does not support indexes. Similarly, if writing to a table failed, the table is broken, and reading from it returns an error. The Log engine is appropriate for temporary data, write-once tables, and for testing or demonstration purposes.
 

docs/en/operations/table_engines/log_family.md

@@ -0,0 +1,42 @@
+#Log Engine Family
+
+These engines were developed for scenarios when you need to write many tables with the small amount of data (less than 1 million rows).
+
+Engines of the family:
+
+- [StripeLog](stripelog.md)
+- [Log](log.md)
+- [TinyLog](tinylog.md)
+
+## Common properties
+
+Engines:
+
+- Store data on a disk.
+- Append data to the end of file when writing.
+- Do not support [mutation](../../query_language/alter.md#alter-mutations) operations.
+- Do not support indexes.
+
+    This means that `SELECT` queries for ranges of data are not efficient.
+
+- Do not write data atomically.
+
+    You can get a table with corrupted data if something breaks the write operation, for example, abnormal server shutdown.
+
+## Differences
+
+The `Log` and `StripeLog` engines support:
+
+- Locks for concurrent data access.
+
+    During `INSERT` query the table is locked, and other queries for reading and writing data both wait for unlocking. If there are no writing data queries, any number of reading data queries can be performed concurrently.
+
+- Parallel reading of data.
+
+    When reading data ClickHouse uses multiple threads. Each thread processes separated data block.
+
+The `Log` engine uses the separate file for each column of the table. The `StripeLog` stores all the data in one file. Thus the `StripeLog` engine uses fewer descriptors in the operating system, but the `Log` engine provides a more efficient reading of the data.
+
+The `TinyLog` engine is the simplest in the family and provides the poorest functionality and lowest efficiency. The `TinyLog` engine does not support a parallel reading and concurrent access and stores each column in a separate file. It reads the data slower than both other engines with parallel reading, and it uses almost as many descriptors as the `Log` engine. You can use it in simple low-load scenarios.
+
+[Original article](https://clickhouse.yandex/docs/en/operations/table_engines/log_family/) <!--hide-->

docs/en/operations/table_engines/stripelog.md

@@ -0,0 +1,86 @@
+# StripeLog
+
+Engine belongs to the family of log engines. See the common properties of log engines and their differences in the [Log Engine Family](log_family.md) article.
+
+Use this engine in scenarios, when you need to write many tables with the small amount of data (less than 1 million rows).
+
+## Creating a Table {#table_engines-stripelog-creating-a-table}
+
+```
+CREATE TABLE [IF NOT EXISTS] [db.]table_name [ON CLUSTER cluster]
+(
+    column1_name [type1] [DEFAULT|MATERIALIZED|ALIAS expr1],
+    column2_name [type2] [DEFAULT|MATERIALIZED|ALIAS expr2],
+    ...
+) ENGINE = StripeLog
+```
+
+See the detailed description of [CREATE TABLE](../../query_language/create.md#create-table-query) query.
+
+## Writing the Data {#table_engines-stripelog-writing-the-data}
+
+The `StripeLog` engine stores all the columns in one file. The `Log` and `TinyLog` engines store columns in separate files. For each `INSERT` query, ClickHouse appends data block to the end of a table file, writing columns one by one.
+
+For each table ClickHouse writes two files:
+
+- `data.bin` — Data file.
+- `index.mrk` — File with marks. Marks contain offsets for each column of each data block inserted.
+
+The `StripeLog` engine does not support the `ALTER UPDATE` and `ALTER DELETE` operations.
+
+## Reading the Data {#table_engines-stripelog-reading-the-data}
+
+File with marks allows ClickHouse parallelize the reading of data. This means that `SELECT` query returns rows in an unpredictable order. Use the `ORDER BY` clause to sort rows.
+
+## Example of Use {#table_engines-stripelog-example-of-use}
+
+Creating a table:
+
+```sql
+CREATE TABLE stripe_log_table
+(
+    timestamp DateTime,
+    message_type String,
+    message String
+)
+ENGINE = StripeLog
+```
+
+Inserting data:
+
+```sql
+INSERT INTO stripe_log_table VALUES (now(),'REGULAR','The first regular message')
+INSERT INTO stripe_log_table VALUES (now(),'REGULAR','The second regular message'),(now(),'WARNING','The first warning message')
+```
+
+We used two `INSERT` queries to create two data block inside the `data.bin` file.
+
+When selecting data, ClickHouse uses multiple threads. Each thread reads the separate data block and returns resulting rows independently as it finished. It causes that the order of blocks of rows in the output does not match the order of the same blocks in the input in the most cases. For example:
+
+```sql
+SELECT * FROM stripe_log_table
+```
+```
+┌───────────timestamp─┬─message_type─┬─message────────────────────┐
+│ 2019-01-18 14:27:32 │ REGULAR      │ The second regular message │
+│ 2019-01-18 14:34:53 │ WARNING      │ The first warning message  │
+└─────────────────────┴──────────────┴────────────────────────────┘
+┌───────────timestamp─┬─message_type─┬─message───────────────────┐
+│ 2019-01-18 14:23:43 │ REGULAR      │ The first regular message │
+└─────────────────────┴──────────────┴───────────────────────────┘
+```
+
+Sorting the results (ascending order by default):
+
+```sql
+SELECT * FROM stripe_log_table ORDER BY timestamp
+```
+```
+┌───────────timestamp─┬─message_type─┬─message────────────────────┐
+│ 2019-01-18 14:23:43 │ REGULAR      │ The first regular message  │
+│ 2019-01-18 14:27:32 │ REGULAR      │ The second regular message │
+│ 2019-01-18 14:34:53 │ WARNING      │ The first warning message  │
+└─────────────────────┴──────────────┴────────────────────────────┘
+```
+
+[Original article](https://clickhouse.yandex/docs/en/operations/table_engines/stripelog/) <!--hide-->

docs/en/operations/table_engines/tinylog.md

@@ -1,5 +1,7 @@
 # TinyLog
 
+Engine belongs to the family of log engines. See the common properties of log engines and their differences in the [Log Engine Family](log_family.md) article.
+
 The simplest table engine, which stores data on a disk.
 Each column is stored in a separate compressed file.
 When writing, data is appended to the end of files.
@@ -17,5 +19,4 @@ The situation when you have a large number of small tables guarantees poor produ
 
 In Yandex.Metrica, TinyLog tables are used for intermediary data that is processed in small batches.
 
-
 [Original article](https://clickhouse.yandex/docs/en/operations/table_engines/tinylog/) <!--hide-->

docs/en/query_language/alter.md

@@ -228,11 +228,11 @@ For non-replicatable tables, all `ALTER` queries are performed synchronously. Fo
 For `ALTER ... ATTACH|DETACH|DROP` queries, you can use the `replication_alter_partitions_sync` setting to set up waiting.
 Possible values: `0` – do not wait; `1` – only wait for own execution (default); `2` – wait for all.
 
-### Mutations {#query_language_queries_show_databases}
+### Mutations {#alter-mutations}
 
 Mutations are an ALTER query variant that allows changing or deleting rows in a table. In contrast to standard `UPDATE` and `DELETE` queries that are intended for point data changes, mutations are intended for heavy operations that change a lot of rows in a table.
 
-The functionality is in beta stage and is available starting with the 1.1.54388 version. Currently *MergeTree table engines are supported (both replicated and unreplicated).
+The functionality is in beta stage and is available starting with the 1.1.54388 version. Currently `*MergeTree` table engines are supported (both replicated and unreplicated).
 
 Existing tables are ready for mutations as-is (no conversion necessary), but after the first mutation is applied to a table, its metadata format becomes incompatible with previous server versions and falling back to a previous version becomes impossible.
 

docs/en/query_language/create.md

@@ -10,7 +10,7 @@ CREATE DATABASE [IF NOT EXISTS] db_name
 If `IF NOT EXISTS` is included, the query won't return an error if the database already exists.
 
 
-## CREATE TABLE
+## CREATE TABLE {#create-table-query}
 
 The `CREATE TABLE` query can have several forms.
 

docs/en/query_language/misc.md

@@ -31,13 +31,13 @@ The query response contains the `result` column with a single row. The row has a
 
 - 0 - The data in the table is corrupted.
 - 1 - The data maintains integrity.
- 
+
 The `CHECK TABLE` query is only supported for the following table engines:
 
 - [Log](../operations/table_engines/log.md)
 - [TinyLog](../operations/table_engines/tinylog.md)
-- StripeLog
- 
+- [StripeLog](../operations/table_engines/stripelog.md)
+
 These engines do not provide automatic data recovery on failure. Use the `CHECK TABLE` query to track data loss in a timely manner.
 
 To avoid data loss use the [MergeTree](../operations/table_engines/mergetree.md) family tables.
@@ -182,7 +182,7 @@ SHOW CREATE [TEMPORARY] TABLE [db.]table [INTO OUTFILE filename] [FORMAT format]
 
 Returns a single `String`-type 'statement' column, which contains a single value – the `CREATE` query used for creating the specified table.
 
-## SHOW DATABASES
+## SHOW DATABASES {#show-databases}
 
 ``` sql
 SHOW DATABASES [INTO OUTFILE filename] [FORMAT format]

docs/fa/data_types/special_data_types/nothing.md

@@ -0,0 +1 @@
+../../../en/data_types/special_data_types/nothing.md

docs/fa/data_types/uuid.md

@@ -0,0 +1 @@
+../../en/data_types/uuid.md

docs/fa/getting_started/example_datasets/metrica.md

@@ -0,0 +1 @@
+../../../en/getting_started/example_datasets/metrica.md

docs/fa/operations/table_engines/log_family.md

@@ -0,0 +1 @@
+../../../en/operations/table_engines/log_family.md

docs/fa/operations/table_engines/stripelog.md

@@ -0,0 +1 @@
+../../../en/operations/table_engines/stripelog.md

docs/fa/query_language/functions/uuid_functions.md

@@ -0,0 +1 @@
+../../../en/query_language/functions/uuid_functions.md

docs/ru/operations/server_settings/settings.md

@@ -61,7 +61,7 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
 
 База данных по умолчанию.
 
-Перечень баз данных можно получить запросом [SHOW DATABASES](../../query_language/misc.md#query_language_queries_show_databases).
+Перечень баз данных можно получить запросом [SHOW DATABASES](../../query_language/misc.md#show-databases).
 
 **Пример**
 

docs/ru/operations/table_engines/log_family.md

@@ -0,0 +1 @@
+../../../en/operations/table_engines/log_family.md

docs/ru/operations/table_engines/stripelog.md

@@ -0,0 +1 @@
+../../../en/operations/table_engines/stripelog.md

docs/ru/query_language/alter.md

@@ -225,7 +225,7 @@ ALTER TABLE [db.]table FETCH PARTITION 'name' FROM 'path-in-zookeeper'
 Для запросов `ALTER ... ATTACH|DETACH|DROP` можно настроить ожидание, с помощью настройки `replication_alter_partitions_sync`.
 Возможные значения: `0` - не ждать, `1` - ждать выполнения только у себя (по умолчанию), `2` - ждать всех.
 
-### Мутации {#query_language_queries_show_databases}
+### Мутации {#alter-mutations}
 
 Мутации - разновидность запроса ALTER, позволяющая изменять или удалять данные в таблице. В отличие от стандартных запросов `DELETE` и `UPDATE`, рассчитанных на точечное изменение данных, область применения мутаций - достаточно тяжёлые изменения, затрагивающие много строк в таблице.
 

docs/ru/query_language/create.md

@@ -9,7 +9,9 @@ CREATE DATABASE [IF NOT EXISTS] db_name
 `База данных` - это просто директория для таблиц.
 Если написано `IF NOT EXISTS`, то запрос не будет возвращать ошибку, если база данных уже существует.
 
-## CREATE TABLE
+
+
+## CREATE TABLE {#create-table-query}
 
 Запрос `CREATE TABLE` может иметь несколько форм.
 

docs/ru/query_language/misc.md

@@ -179,7 +179,7 @@ SHOW CREATE [TEMPORARY] TABLE [db.]table [INTO OUTFILE filename] [FORMAT format]
 
 Возвращает один столбец statement типа `String`, содержащий одно значение - запрос `CREATE`, с помощью которого создана указанная таблица.
 
-## SHOW DATABASES
+## SHOW DATABASES {#show-databases}
 
 ```sql
 SHOW DATABASES [INTO OUTFILE filename] [FORMAT format]
@@ -256,4 +256,3 @@ USE db
 Позволяет установить текущую базу данных для сессии.
 Текущая база данных используется для поиска таблиц, если база данных не указана в запросе явно через точку перед именем таблицы.
 При использовании HTTP протокола запрос не может быть выполнен, так как понятия сессии не существует.
-

docs/toc_en.yml

@@ -57,6 +57,41 @@ nav:
     - 'Set': 'data_types/special_data_types/set.md'
     - 'Nothing': 'data_types/special_data_types/nothing.md'
 
+- 'Table Engines':
+  - 'Introduction': 'operations/table_engines/index.md'
+  - 'MergeTree Family':
+    - 'MergeTree': 'operations/table_engines/mergetree.md'
+    - 'Data Replication': 'operations/table_engines/replication.md'
+    - 'Custom Partitioning Key': 'operations/table_engines/custom_partitioning_key.md'
+    - 'ReplacingMergeTree': 'operations/table_engines/replacingmergetree.md'
+    - 'SummingMergeTree': 'operations/table_engines/summingmergetree.md'
+    - 'AggregatingMergeTree': 'operations/table_engines/aggregatingmergetree.md'
+    - 'CollapsingMergeTree': 'operations/table_engines/collapsingmergetree.md'
+    - 'VersionedCollapsingMergeTree': 'operations/table_engines/versionedcollapsingmergetree.md'
+    - 'GraphiteMergeTree': 'operations/table_engines/graphitemergetree.md'
+  - 'Log Family':
+    - 'Introduction': 'operations/table_engines/log_family.md'
+    - 'StripeLog': 'operations/table_engines/stripelog.md'
+    - 'Log': 'operations/table_engines/log.md'
+    - 'TinyLog': 'operations/table_engines/tinylog.md'
+  - 'Integrations':
+    - 'Kafka': 'operations/table_engines/kafka.md'
+    - 'MySQL': 'operations/table_engines/mysql.md'
+  - 'Special':
+    - 'Distributed': 'operations/table_engines/distributed.md'
+    - 'External data': 'operations/table_engines/external_data.md'
+    - 'Dictionary': 'operations/table_engines/dictionary.md'
+    - 'Merge': 'operations/table_engines/merge.md'
+    - 'File': 'operations/table_engines/file.md'
+    - 'Null': 'operations/table_engines/null.md'
+    - 'Set': 'operations/table_engines/set.md'
+    - 'Join': 'operations/table_engines/join.md'
+    - 'URL': 'operations/table_engines/url.md'
+    - 'View': 'operations/table_engines/view.md'
+    - 'MaterializedView': 'operations/table_engines/materializedview.md'
+    - 'Memory': 'operations/table_engines/memory.md'
+    - 'Buffer': 'operations/table_engines/buffer.md'
+
 - 'SQL Reference':
   - 'hidden': 'query_language/index.md'
   - 'SELECT': 'query_language/select.md'
@@ -127,38 +162,6 @@ nav:
   - 'Monitoring': 'operations/monitoring.md'
   - 'Troubleshooting': 'operations/troubleshooting.md'
   - 'Usage Recommendations': 'operations/tips.md'
-  - 'Table Engines':
-    - 'Introduction': 'operations/table_engines/index.md'
-    - 'MergeTree Family':
-      - 'MergeTree': 'operations/table_engines/mergetree.md'
-      - 'Data Replication': 'operations/table_engines/replication.md'
-      - 'Custom Partitioning Key': 'operations/table_engines/custom_partitioning_key.md'
-      - 'ReplacingMergeTree': 'operations/table_engines/replacingmergetree.md'
-      - 'SummingMergeTree': 'operations/table_engines/summingmergetree.md'
-      - 'AggregatingMergeTree': 'operations/table_engines/aggregatingmergetree.md'
-      - 'CollapsingMergeTree': 'operations/table_engines/collapsingmergetree.md'
-      - 'VersionedCollapsingMergeTree': 'operations/table_engines/versionedcollapsingmergetree.md'
-      - 'GraphiteMergeTree': 'operations/table_engines/graphitemergetree.md'
-    - 'For Small Data':
-      - 'TinyLog': 'operations/table_engines/tinylog.md'
-      - 'Log': 'operations/table_engines/log.md'
-      - 'Memory': 'operations/table_engines/memory.md'
-      - 'Buffer': 'operations/table_engines/buffer.md'
-      - 'External data': 'operations/table_engines/external_data.md'
-    - 'Special':
-      - 'Distributed': 'operations/table_engines/distributed.md'
-      - 'Dictionary': 'operations/table_engines/dictionary.md'
-      - 'Merge': 'operations/table_engines/merge.md'
-      - 'File': 'operations/table_engines/file.md'
-      - 'Null': 'operations/table_engines/null.md'
-      - 'Set': 'operations/table_engines/set.md'
-      - 'Join': 'operations/table_engines/join.md'
-      - 'URL': 'operations/table_engines/url.md'
-      - 'View': 'operations/table_engines/view.md'
-      - 'MaterializedView': 'operations/table_engines/materializedview.md'
-    - 'Integrations':
-      - 'Kafka': 'operations/table_engines/kafka.md'
-      - 'MySQL': 'operations/table_engines/mysql.md'
   - 'Access Rights': 'operations/access_rights.md'
   - 'Data Backup': 'operations/backup.md'
   - 'Configuration Files': 'operations/configuration_files.md'

docs/toc_fa.yml

@@ -16,7 +16,8 @@ nav:
     - 'WikiStat': 'getting_started/example_datasets/wikistat.md'
     - ' ترابایت از لاگ های کلیک از سرویس Criteo': 'getting_started/example_datasets/criteo.md'
     - ' بنچمارک Star Schema': 'getting_started/example_datasets/star_schema.md'
-
+    - 'Yandex.Metrica Data': 'getting_started/example_datasets/metrica.md'
+    
 - 'Interfaces':
   - 'Interface ها': 'interfaces/index.md'
   - ' کلاینت Command-line': 'interfaces/cli.md'
@@ -39,6 +40,7 @@ nav:
   - ' مقادیر Boolean': 'data_types/boolean.md'
   - 'String': 'data_types/string.md'
   - 'FixedString(N)': 'data_types/fixedstring.md'
+  - 'UUID': 'data_types/uuid.md'
   - 'Date': 'data_types/date.md'
   - 'DateTime': 'data_types/datetime.md'
   - 'Enum': 'data_types/enum.md'
@@ -53,14 +55,50 @@ nav:
     - 'hidden': 'data_types/special_data_types/index.md'
     - 'Expression': 'data_types/special_data_types/expression.md'
     - 'Set': 'data_types/special_data_types/set.md'
+    - 'Nothing': 'data_types/special_data_types/nothing.md'
 
-- 'SQL reference':
+- 'Table Engines':
+  - 'Introduction': 'operations/table_engines/index.md'
+  - 'MergeTree Family':
+    - 'MergeTree': 'operations/table_engines/mergetree.md'
+    - 'Data Replication': 'operations/table_engines/replication.md'
+    - 'Custom Partitioning Key': 'operations/table_engines/custom_partitioning_key.md'
+    - 'ReplacingMergeTree': 'operations/table_engines/replacingmergetree.md'
+    - 'SummingMergeTree': 'operations/table_engines/summingmergetree.md'
+    - 'AggregatingMergeTree': 'operations/table_engines/aggregatingmergetree.md'
+    - 'CollapsingMergeTree': 'operations/table_engines/collapsingmergetree.md'
+    - 'VersionedCollapsingMergeTree': 'operations/table_engines/versionedcollapsingmergetree.md'
+    - 'GraphiteMergeTree': 'operations/table_engines/graphitemergetree.md'
+  - 'Log Family':
+    - 'Introduction': 'operations/table_engines/log_family.md'
+    - 'StripeLog': 'operations/table_engines/stripelog.md'
+    - 'Log': 'operations/table_engines/log.md'
+    - 'TinyLog': 'operations/table_engines/tinylog.md'
+  - 'Integrations':
+    - 'Kafka': 'operations/table_engines/kafka.md'
+    - 'MySQL': 'operations/table_engines/mysql.md'
+  - 'Special':
+    - 'Distributed': 'operations/table_engines/distributed.md'
+    - 'External data': 'operations/table_engines/external_data.md'
+    - 'Dictionary': 'operations/table_engines/dictionary.md'
+    - 'Merge': 'operations/table_engines/merge.md'
+    - 'File': 'operations/table_engines/file.md'
+    - 'Null': 'operations/table_engines/null.md'
+    - 'Set': 'operations/table_engines/set.md'
+    - 'Join': 'operations/table_engines/join.md'
+    - 'URL': 'operations/table_engines/url.md'
+    - 'View': 'operations/table_engines/view.md'
+    - 'MaterializedView': 'operations/table_engines/materializedview.md'
+    - 'Memory': 'operations/table_engines/memory.md'
+    - 'Buffer': 'operations/table_engines/buffer.md'
+
+- 'SQL Reference':
   - 'hidden': 'query_language/index.md'
   - 'SELECT': 'query_language/select.md'
   - 'INSERT INTO': 'query_language/insert_into.md'
   - 'CREATE': 'query_language/create.md'
   - 'ALTER': 'query_language/alter.md'
-  - 'Other kinds of queries': 'query_language/misc.md'
+  - 'Other Kinds of Queries': 'query_language/misc.md'
   - 'Functions':
     - 'Introduction': 'query_language/functions/index.md'
     - 'Arithmetic': 'query_language/functions/arithmetic_functions.md'
@@ -80,6 +118,7 @@ nav:
     - 'Hash': 'query_language/functions/hash_functions.md'
     - 'Generating Pseudo-Random Numbers': 'query_language/functions/random_functions.md'
     - 'Encoding': 'query_language/functions/encoding_functions.md'
+    - 'Working with UUID': 'query_language/functions/uuid_functions.md'
     - 'Working with URLs': 'query_language/functions/url_functions.md'
     - 'Working with IP Addresses': 'query_language/functions/ip_address_functions.md'
     - 'Working with JSON.': 'query_language/functions/json_functions.md'
@@ -91,12 +130,12 @@ nav:
     - 'Working with geographical coordinates': 'query_language/functions/geo.md'
     - 'Working with Nullable arguments': 'query_language/functions/functions_for_nulls.md'
     - 'Other': 'query_language/functions/other_functions.md'
-  - 'Aggregate functions':
+  - 'Aggregate Functions':
     - 'Introduction': 'query_language/agg_functions/index.md'
-    - 'Function reference': 'query_language/agg_functions/reference.md'
+    - 'Reference': 'query_language/agg_functions/reference.md'
     - 'Aggregate function combinators': 'query_language/agg_functions/combinators.md'
     - 'Parametric aggregate functions': 'query_language/agg_functions/parametric_functions.md'
-  - 'Table functions':
+  - 'Table Functions':
     - 'Introduction': 'query_language/table_functions/index.md'
     - 'file': 'query_language/table_functions/file.md'
     - 'merge': 'query_language/table_functions/merge.md'
@@ -106,87 +145,54 @@ nav:
     - 'jdbc': 'query_language/table_functions/jdbc.md'
   - 'Dictionaries':
     - 'Introduction': 'query_language/dicts/index.md'
-    - 'External dictionaries':
-      - 'General description': 'query_language/dicts/external_dicts.md'
-      - 'Configuring an external dictionary': 'query_language/dicts/external_dicts_dict.md'
-      - 'Storing dictionaries in memory': 'query_language/dicts/external_dicts_dict_layout.md'
-      - 'Dictionary updates': 'query_language/dicts/external_dicts_dict_lifetime.md'
-      - 'Sources of external dictionaries': 'query_language/dicts/external_dicts_dict_sources.md'
-      - 'Dictionary key and fields': 'query_language/dicts/external_dicts_dict_structure.md'
-    - 'Internal dictionaries': 'query_language/dicts/internal_dicts.md'
-  - 'Operators': 'query_language/operators.md'
-  - 'General syntax': 'query_language/syntax.md'
+    - 'External Dictionaries':
+      - 'General Description': 'query_language/dicts/external_dicts.md'
+      - 'Configuring an External Dictionary': 'query_language/dicts/external_dicts_dict.md'
+      - 'Storing Dictionaries in Memory': 'query_language/dicts/external_dicts_dict_layout.md'
+      - 'Dictionary Updates': 'query_language/dicts/external_dicts_dict_lifetime.md'
+      - 'Sources of External Dictionaries': 'query_language/dicts/external_dicts_dict_sources.md'
+      - 'Dictionary Key and Fields': 'query_language/dicts/external_dicts_dict_structure.md'
+    - 'Internal Dictionaries': 'query_language/dicts/internal_dicts.md'
+    - 'Operators': 'query_language/operators.md'
+    - 'General Syntax': 'query_language/syntax.md'
 
 - 'Operations':
   - 'hidden': 'operations/index.md'
   - 'Requirements': 'operations/requirements.md'
   - 'Monitoring': 'operations/monitoring.md'
   - 'Troubleshooting': 'operations/troubleshooting.md'
-  - 'Usage recommendations': 'operations/tips.md'
-  - 'Table engines':
-    - 'Introduction': 'operations/table_engines/index.md'
-    - 'MergeTree family':
-      - 'MergeTree': 'operations/table_engines/mergetree.md'
-      - 'Data replication': 'operations/table_engines/replication.md'
-      - 'Custom partitioning key': 'operations/table_engines/custom_partitioning_key.md'
-      - 'ReplacingMergeTree': 'operations/table_engines/replacingmergetree.md'
-      - 'SummingMergeTree': 'operations/table_engines/summingmergetree.md'
-      - 'AggregatingMergeTree': 'operations/table_engines/aggregatingmergetree.md'
-      - 'CollapsingMergeTree': 'operations/table_engines/collapsingmergetree.md'
-      - 'VersionedCollapsingMergeTree': 'operations/table_engines/versionedcollapsingmergetree.md'
-      - 'GraphiteMergeTree': 'operations/table_engines/graphitemergetree.md'
-    - 'For small data':
-      - 'TinyLog': 'operations/table_engines/tinylog.md'
-      - 'Log': 'operations/table_engines/log.md'
-      - 'Memory': 'operations/table_engines/memory.md'
-      - 'Buffer': 'operations/table_engines/buffer.md'
-      - 'External data': 'operations/table_engines/external_data.md'
-    - 'Special':
-      - 'Distributed': 'operations/table_engines/distributed.md'
-      - 'Dictionary': 'operations/table_engines/dictionary.md'
-      - 'Merge': 'operations/table_engines/merge.md'
-      - 'File': 'operations/table_engines/file.md'
-      - 'Null': 'operations/table_engines/null.md'
-      - 'Set': 'operations/table_engines/set.md'
-      - 'Join': 'operations/table_engines/join.md'
-      - 'URL': 'operations/table_engines/url.md'
-      - 'View': 'operations/table_engines/view.md'
-      - 'MaterializedView': 'operations/table_engines/materializedview.md'
-    - 'Integrations':
-      - 'Kafka': 'operations/table_engines/kafka.md'
-      - 'MySQL': 'operations/table_engines/mysql.md'
-  - 'Access rights': 'operations/access_rights.md'
+  - 'Usage Recommendations': 'operations/tips.md'
+  - 'Access Rights': 'operations/access_rights.md'
   - 'Data Backup': 'operations/backup.md'
-  - 'Configuration files': 'operations/configuration_files.md'
+  - 'Configuration Files': 'operations/configuration_files.md'
   - 'Quotas': 'operations/quotas.md'
-  - 'System tables': 'operations/system_tables.md'
-  - 'Server configuration parameters':
+  - 'System Tables': 'operations/system_tables.md'
+  - 'Server Configuration Parameters':
     - 'Introduction': 'operations/server_settings/index.md'
-    - 'Server settings': 'operations/server_settings/settings.md'
+    - 'Server Settings': 'operations/server_settings/settings.md'
   - 'Settings':
     - 'Introduction': 'operations/settings/index.md'
-    - 'Permissions for queries': 'operations/settings/permissions_for_queries.md'
-    - 'Restrictions on query complexity': 'operations/settings/query_complexity.md'
+    - 'Permissions for Queries': 'operations/settings/permissions_for_queries.md'
+    - 'Restrictions on Query Complexity': 'operations/settings/query_complexity.md'
     - 'Settings': 'operations/settings/settings.md'
-    - 'Settings profiles': 'operations/settings/settings_profiles.md'
-
+    - 'Settings Profiles': 'operations/settings/settings_profiles.md'
   - 'Utilities':
     - 'Overview': 'operations/utils/index.md'
     - 'clickhouse-copier': 'operations/utils/clickhouse-copier.md'
     - 'clickhouse-local': 'operations/utils/clickhouse-local.md'
 
 - 'F.A.Q.':
-  - 'General questions': 'faq/general.md'
+  - 'General Questions': 'faq/general.md'
 
 - 'Development':
   - 'hidden': 'development/index.md'
-  - 'Overview of ClickHouse architecture': 'development/architecture.md'
-  - 'How to build ClickHouse on Linux': 'development/build.md'
-  - 'How to build ClickHouse on Mac OS X': 'development/build_osx.md'
-  - 'How to write  C++ code': 'development/style.md'
-  - 'How to run ClickHouse tests': 'development/tests.md'
+  - 'Overview of ClickHouse Architecture': 'development/architecture.md'
+  - 'How to Build ClickHouse on Linux': 'development/build.md'
+  - 'How to Build ClickHouse on Mac OS X': 'development/build_osx.md'
+  - 'How to Write C++ code': 'development/style.md'
+  - 'How to Run ClickHouse Tests': 'development/tests.md'
 
-- 'What''s new':
+- 'What''s New':
   - 'Roadmap': 'roadmap.md'
   - 'Changelog': 'changelog.md'
-  - 'Security changelog': 'security_changelog.md'
+  - 'Security Changelog': 'security_changelog.md'

docs/toc_ru.yml

@@ -56,6 +56,41 @@ nav:
     - 'Set': 'data_types/special_data_types/set.md'
     - 'Nothing': 'data_types/special_data_types/nothing.md'
 
+- 'Движки таблиц':
+  - 'Введение': 'operations/table_engines/index.md'
+  - 'Семейство MergeTree':
+    - 'MergeTree': 'operations/table_engines/mergetree.md'
+    - 'Репликация данных': 'operations/table_engines/replication.md'
+    - 'Произвольный ключ партиционирования': 'operations/table_engines/custom_partitioning_key.md'
+    - 'ReplacingMergeTree': 'operations/table_engines/replacingmergetree.md'
+    - 'SummingMergeTree': 'operations/table_engines/summingmergetree.md'
+    - 'AggregatingMergeTree': 'operations/table_engines/aggregatingmergetree.md'
+    - 'CollapsingMergeTree': 'operations/table_engines/collapsingmergetree.md'
+    - 'VersionedCollapsingMergeTree': 'operations/table_engines/versionedcollapsingmergetree.md'
+    - 'GraphiteMergeTree': 'operations/table_engines/graphitemergetree.md'
+  - 'Log Family':
+    - 'Introduction': 'operations/table_engines/log_family.md'
+    - 'StripeLog': 'operations/table_engines/stripelog.md'
+    - 'Log': 'operations/table_engines/log.md'
+    - 'TinyLog': 'operations/table_engines/tinylog.md'
+  - 'Интеграции':
+    - 'Kafka': 'operations/table_engines/kafka.md'
+    - 'MySQL': 'operations/table_engines/mysql.md'
+  - 'Особые':
+    - 'Distributed': 'operations/table_engines/distributed.md'
+    - 'Внешние данные': 'operations/table_engines/external_data.md'
+    - 'Dictionary': 'operations/table_engines/dictionary.md'
+    - 'Merge': 'operations/table_engines/merge.md'
+    - 'File': 'operations/table_engines/file.md'
+    - 'Null': 'operations/table_engines/null.md'
+    - 'Set': 'operations/table_engines/set.md'
+    - 'Join': 'operations/table_engines/join.md'
+    - 'URL': 'operations/table_engines/url.md'
+    - 'View': 'operations/table_engines/view.md'
+    - 'MaterializedView': 'operations/table_engines/materializedview.md'
+    - 'Memory': 'operations/table_engines/memory.md'
+    - 'Buffer': 'operations/table_engines/buffer.md'
+
 - 'Справка по SQL':
   - 'hidden': 'query_language/index.md'
   - 'SELECT': 'query_language/select.md'
@@ -125,38 +160,6 @@ nav:
   - 'Мониторинг': 'operations/monitoring.md'
   - 'Решение проблем': 'operations/troubleshooting.md'
   - 'Советы по эксплуатации': 'operations/tips.md'
-  - 'Движки таблиц':
-    - 'Введение': 'operations/table_engines/index.md'
-    - 'Семейство MergeTree':
-      - 'MergeTree': 'operations/table_engines/mergetree.md'
-      - 'Репликация данных': 'operations/table_engines/replication.md'
-      - 'Произвольный ключ партиционирования': 'operations/table_engines/custom_partitioning_key.md'
-      - 'ReplacingMergeTree': 'operations/table_engines/replacingmergetree.md'
-      - 'SummingMergeTree': 'operations/table_engines/summingmergetree.md'
-      - 'AggregatingMergeTree': 'operations/table_engines/aggregatingmergetree.md'
-      - 'CollapsingMergeTree': 'operations/table_engines/collapsingmergetree.md'
-      - 'VersionedCollapsingMergeTree': 'operations/table_engines/versionedcollapsingmergetree.md'
-      - 'GraphiteMergeTree': 'operations/table_engines/graphitemergetree.md'
-    - 'Для небольших объемов данных':
-      - 'TinyLog': 'operations/table_engines/tinylog.md'
-      - 'Log': 'operations/table_engines/log.md'
-      - 'Memory': 'operations/table_engines/memory.md'
-      - 'Buffer': 'operations/table_engines/buffer.md'
-      - 'Внешние данные': 'operations/table_engines/external_data.md'
-    - 'Особые':
-      - 'Distributed': 'operations/table_engines/distributed.md'
-      - 'Dictionary': 'operations/table_engines/dictionary.md'
-      - 'Merge': 'operations/table_engines/merge.md'
-      - 'File': 'operations/table_engines/file.md'
-      - 'Null': 'operations/table_engines/null.md'
-      - 'Set': 'operations/table_engines/set.md'
-      - 'Join': 'operations/table_engines/join.md'
-      - 'URL': 'operations/table_engines/url.md'
-      - 'View': 'operations/table_engines/view.md'
-      - 'MaterializedView': 'operations/table_engines/materializedview.md'
-    - 'Интеграции':
-      - 'Kafka': 'operations/table_engines/kafka.md'
-      - 'MySQL': 'operations/table_engines/mysql.md'
   - 'Права доступа': 'operations/access_rights.md'
   - 'Резервное копирование': 'operations/backup.md'
   - 'Конфигурационные файлы': 'operations/configuration_files.md'

docs/toc_zh.yml

@@ -39,6 +39,7 @@ nav:
   - 'Boolean values': 'data_types/boolean.md'
   - 'String': 'data_types/string.md'
   - 'FixedString(N)': 'data_types/fixedstring.md'
+  - 'UUID': 'data_types/uuid.md'
   - 'Date': 'data_types/date.md'
   - 'DateTime': 'data_types/datetime.md'
   - 'Enum': 'data_types/enum.md'
@@ -55,6 +56,41 @@ nav:
     - 'Set': 'data_types/special_data_types/set.md'
     - 'Nothing': 'data_types/special_data_types/nothing.md'
 
+- 'Table Engines':
+  - 'Introduction': 'operations/table_engines/index.md'
+  - 'MergeTree Family':
+    - 'MergeTree': 'operations/table_engines/mergetree.md'
+    - 'Data Replication': 'operations/table_engines/replication.md'
+    - 'Custom Partitioning Key': 'operations/table_engines/custom_partitioning_key.md'
+    - 'ReplacingMergeTree': 'operations/table_engines/replacingmergetree.md'
+    - 'SummingMergeTree': 'operations/table_engines/summingmergetree.md'
+    - 'AggregatingMergeTree': 'operations/table_engines/aggregatingmergetree.md'
+    - 'CollapsingMergeTree': 'operations/table_engines/collapsingmergetree.md'
+    - 'VersionedCollapsingMergeTree': 'operations/table_engines/versionedcollapsingmergetree.md'
+    - 'GraphiteMergeTree': 'operations/table_engines/graphitemergetree.md'
+  - 'Log Family':
+    - 'Introduction': 'operations/table_engines/log_family.md'
+    - 'StripeLog': 'operations/table_engines/stripelog.md'
+    - 'Log': 'operations/table_engines/log.md'
+    - 'TinyLog': 'operations/table_engines/tinylog.md'
+  - 'Integrations':
+    - 'Kafka': 'operations/table_engines/kafka.md'
+    - 'MySQL': 'operations/table_engines/mysql.md'
+  - 'Special':
+    - 'Distributed': 'operations/table_engines/distributed.md'
+    - 'External data': 'operations/table_engines/external_data.md'
+    - 'Dictionary': 'operations/table_engines/dictionary.md'
+    - 'Merge': 'operations/table_engines/merge.md'
+    - 'File': 'operations/table_engines/file.md'
+    - 'Null': 'operations/table_engines/null.md'
+    - 'Set': 'operations/table_engines/set.md'
+    - 'Join': 'operations/table_engines/join.md'
+    - 'URL': 'operations/table_engines/url.md'
+    - 'View': 'operations/table_engines/view.md'
+    - 'MaterializedView': 'operations/table_engines/materializedview.md'
+    - 'Memory': 'operations/table_engines/memory.md'
+    - 'Buffer': 'operations/table_engines/buffer.md'
+
 - 'SQL语法':
   - 'hidden': 'query_language/index.md'
   - 'SELECT': 'query_language/select.md'
@@ -81,6 +117,7 @@ nav:
     - 'Hash': 'query_language/functions/hash_functions.md'
     - 'Generating Pseudo-Random Numbers': 'query_language/functions/random_functions.md'
     - 'Encoding': 'query_language/functions/encoding_functions.md'
+    - 'Working with UUID': 'query_language/functions/uuid_functions.md'
     - 'Working with URLs': 'query_language/functions/url_functions.md'
     - 'Working with IP Addresses': 'query_language/functions/ip_address_functions.md'
     - 'Working with JSON.': 'query_language/functions/json_functions.md'
@@ -124,38 +161,6 @@ nav:
   - 'Monitoring': 'operations/monitoring.md'
   - 'Troubleshooting': 'operations/troubleshooting.md'
   - 'Usage recommendations': 'operations/tips.md'
-  - 'Table engines':
-    - 'Introduction': 'operations/table_engines/index.md'
-    - 'MergeTree family':
-      - 'MergeTree': 'operations/table_engines/mergetree.md'
-      - 'Data replication': 'operations/table_engines/replication.md'
-      - 'Custom partitioning key': 'operations/table_engines/custom_partitioning_key.md'
-      - 'ReplacingMergeTree': 'operations/table_engines/replacingmergetree.md'
-      - 'SummingMergeTree': 'operations/table_engines/summingmergetree.md'
-      - 'AggregatingMergeTree': 'operations/table_engines/aggregatingmergetree.md'
-      - 'CollapsingMergeTree': 'operations/table_engines/collapsingmergetree.md'
-      - 'VersionedCollapsingMergeTree': 'operations/table_engines/versionedcollapsingmergetree.md'
-      - 'GraphiteMergeTree': 'operations/table_engines/graphitemergetree.md'
-    - 'For small data':
-      - 'TinyLog': 'operations/table_engines/tinylog.md'
-      - 'Log': 'operations/table_engines/log.md'
-      - 'Memory': 'operations/table_engines/memory.md'
-      - 'Buffer': 'operations/table_engines/buffer.md'
-      - 'External data': 'operations/table_engines/external_data.md'
-    - 'Special':
-      - 'Distributed': 'operations/table_engines/distributed.md'
-      - 'Dictionary': 'operations/table_engines/dictionary.md'
-      - 'Merge': 'operations/table_engines/merge.md'
-      - 'File': 'operations/table_engines/file.md'
-      - 'Null': 'operations/table_engines/null.md'
-      - 'Set': 'operations/table_engines/set.md'
-      - 'Join': 'operations/table_engines/join.md'
-      - 'URL': 'operations/table_engines/url.md'
-      - 'View': 'operations/table_engines/view.md'
-      - 'MaterializedView': 'operations/table_engines/materializedview.md'
-    - 'Integrations':
-      - 'Kafka': 'operations/table_engines/kafka.md'
-      - 'MySQL': 'operations/table_engines/mysql.md'
   - 'Access rights': 'operations/access_rights.md'
   - 'Data backup': 'operations/backup.md'
   - 'Configuration files': 'operations/configuration_files.md'
@@ -170,7 +175,6 @@ nav:
     - 'Restrictions on query complexity': 'operations/settings/query_complexity.md'
     - 'Settings': 'operations/settings/settings.md'
     - 'Settings profiles': 'operations/settings/settings_profiles.md'
-
   - 'Utilities':
     - 'Overview': 'operations/utils/index.md'
     - 'clickhouse-copier': 'operations/utils/clickhouse-copier.md'

docs/zh/data_types/uuid.md

@@ -0,0 +1 @@
+../../en/data_types/uuid.md

docs/zh/operations/table_engines/log_family.md

@@ -0,0 +1 @@
+../../../en/operations/table_engines/log_family.md

docs/zh/operations/table_engines/stripelog.md

@@ -0,0 +1 @@
+../../../en/operations/table_engines/stripelog.md

docs/zh/query_language/create.md

@@ -10,7 +10,7 @@ CREATE DATABASE [IF NOT EXISTS] db_name
 如果查询中存在`IF NOT EXISTS`，则当数据库已经存在时，该查询不会返回任何错误。
 
 
-## CREATE TABLE
+## CREATE TABLE {#create-table-query}
 
 对于`CREATE TABLE`，存在以下几种方式。
 

docs/zh/query_language/functions/uuid_functions.md

@@ -0,0 +1 @@
+../../../en/query_language/functions/uuid_functions.md