Merge branch 'BayoNet-en-docs/CLICKHOUSEDOCS-272-query-profiler'

docs/en/getting_started/install.md

@@ -14,7 +14,7 @@ To run ClickHouse on processors that do not support SSE 4.2 or have AArch64 or P
 
 ## Available Installation Options
 
-### From DEB Packages
+### From DEB Packages {#install-from-deb-packages}
 
 It is recommended to use official pre-compiled `deb` packages for Debian or Ubuntu.
 
@@ -37,6 +37,13 @@ sudo apt-get install clickhouse-client clickhouse-server
 
 You can also download and install packages manually from here: <https://repo.yandex.ru/clickhouse/deb/stable/main/>.
 
+#### Packages
+
+- `clickhouse-common-static` — Installs ClickHouse compiled binary files.
+- `clickhouse-server` — Creates symbolic link for `clickhouse-server`. Installs server configuration.
+- `clickhouse-client` — Creates symbolic link for `clickhouse-client` and other client-related tools. Installs client configurations.
+- `clickhouse-common-static-dbg` — Installs ClickHouse compiled binary files with debug info.
+
 ### From RPM Packages
 
 It is recommended to use official pre-compiled `rpm` packages for CentOS, RedHat and all other rpm-based Linux distributions.

docs/en/getting_started/tutorial.md

@@ -6,7 +6,7 @@ By going through this tutorial you'll learn how to set up basic ClickHouse clust
 
 ## Single Node Setup
 
-To postpone complexities of distributed environment, we'll start with deploying ClickHouse on a single server or virtual machine. ClickHouse is usually installed from [deb](index.md#from-deb-packages) or [rpm](index.md#from-rpm-packages) packages, but there are [alternatives](index.md#from-docker-image) for the operating systems that do no support them.
+To postpone complexities of distributed environment, we'll start with deploying ClickHouse on a single server or virtual machine. ClickHouse is usually installed from [deb](index.md#install-from-deb-packages) or [rpm](index.md#from-rpm-packages) packages, but there are [alternatives](index.md#from-docker-image) for the operating systems that do no support them.
 
 For example, you have chosen `deb` packages and executed:
 ``` bash

docs/en/operations/server_settings/settings.md

@@ -16,33 +16,40 @@ Default value: 3600.
 ```
 
 
-## compression
+## compression {#server-settings-compression}
 
-Data compression settings.
+Data compression settings for [MergeTree](../table_engines/mergetree.md)-engine tables.
 
 !!! warning
     Don't use it if you have just started using ClickHouse.
 
-The configuration looks like this:
+Configuration template:
 
 ```xml
 <compression>
     <case>
-      <parameters/>
+      <min_part_size>...</min_part_size>
+      <min_part_size_ratio>...</min_part_size_ratio>
+      <method>...</method>
     </case>
     ...
 </compression>
 ```
 
-You can configure multiple sections `<case>`.
+`<case>` fields:
 
-Block field `<case>`:
+- `min_part_size` – The minimum size of a data part.
+- `min_part_size_ratio` – The ratio of the data part size to the table size.
+- `method` – Compression method. Acceptable values: `lz4` or `zstd`.
 
-- ``min_part_size`` – The minimum size of a table part.
-- ``min_part_size_ratio`` – The ratio of the minimum size of a table part to the full size of the table.
-- ``method`` – Compression method. Acceptable values ​: ``lz4`` or ``zstd``(experimental).
+You can configure multiple `<case>` sections.
 
-ClickHouse checks `min_part_size` and `min_part_size_ratio` and processes the `case` blocks that match these conditions. If none of the `<case>` matches, ClickHouse applies the `lz4` compression algorithm.
+Actions when conditions are met:
+
+- If a data part matches a condition set, ClickHouse uses the specified compression method.
+- If a data part matches multiple condition sets, ClickHouse uses the first matched condition set.
+
+If no conditions met for a data part, ClickHouse uses the `lz4` compression.
 
 **Example**
 
@@ -140,10 +147,10 @@ Settings:
 - interval – The interval for sending, in seconds.
 - timeout – The timeout for sending data, in seconds.
 - root_path – Prefix for keys.
-- metrics – Sending data from a [system.metrics](../system_tables.md#system_tables-metrics) table.
-- events – Sending deltas data accumulated for the time period from a [system.events](../system_tables.md#system_tables-events) table.
-- events_cumulative – Sending cumulative data from a [system.events](../system_tables.md#system_tables-events) table.
-- asynchronous_metrics – Sending data from a [system.asynchronous_metrics](../system_tables.md#system_tables-asynchronous_metrics) table.
+- metrics – Sending data from the [system.metrics](../system_tables.md#system_tables-metrics) table.
+- events – Sending deltas data accumulated for the time period from the [system.events](../system_tables.md#system_tables-events) table.
+- events_cumulative – Sending cumulative data from the [system.events](../system_tables.md#system_tables-events) table.
+- asynchronous_metrics – Sending data from the [system.asynchronous_metrics](../system_tables.md#system_tables-asynchronous_metrics) table.
 
 You can configure multiple `<graphite>` clauses. For instance, you can use this for sending different data at different intervals.
 

docs/en/operations/settings/settings.md

@@ -420,17 +420,6 @@ Used for the same purpose as `max_block_size`, but it sets the recommended block
 However, the block size cannot be more than `max_block_size` rows.
 By default: 1,000,000. It only works when reading from MergeTree engines.
 
-## merge_tree_uniform_read_distribution {#setting-merge_tree_uniform_read_distribution}
-
-ClickHouse uses multiple threads when reading from [MergeTree](../table_engines/mergetree.md) tables. This setting turns on/off the uniform distribution of reading tasks over the working threads. The algorithm of the uniform distribution aims to make execution time for all the threads approximately equal in a `SELECT` query.
-
-Possible values:
-
-- 0 — Do not use uniform read distribution.
-- 1 — Use uniform read distribution.
-
-Default value: 1.
-
 ## merge_tree_min_rows_for_concurrent_read {#setting-merge_tree_min_rows_for_concurrent_read}
 
 If the number of rows to be read from a file of a [MergeTree](../table_engines/mergetree.md) table exceeds `merge_tree_min_rows_for_concurrent_read` then ClickHouse tries to perform a concurrent reading from this file on several threads.
@@ -1078,7 +1067,7 @@ Default value: 0.
 
 ## query_profiler_real_time_period_ns {#query_profiler_real_time_period_ns}
 
-Sets the period for a real clock timer of the query profiler. Real clock timer counts wall-clock time.
+Sets the period for a real clock timer of the [query profiler](../performance/sampling_query_profiler.md). Real clock timer counts wall-clock time.
 
 Possible values:
 
@@ -1097,11 +1086,11 @@ Default value: 1000000000 nanoseconds (once a second).
 
 See also:
 
-- [system.trace_log](../system_tables.md#system_tables-trace_log)
+- System table [trace_log](../system_tables.md#system_tables-trace_log)
 
 ## query_profiler_cpu_time_period_ns {#query_profiler_cpu_time_period_ns}
 
-Sets the period for a CPU clock timer of the query profiler. This timer counts only CPU time.
+Sets the period for a CPU clock timer of the [query profiler](../performance/sampling_query_profiler.md). This timer counts only CPU time.
 
 Possible values:
 
@@ -1120,7 +1109,7 @@ Default value: 1000000000 nanoseconds.
 
 See also:
 
-- [system.trace_log](../system_tables.md#system_tables-trace_log)
+- System table [trace_log](../system_tables.md#system_tables-trace_log)
 
 ## allow_introspection_functions {#settings-allow_introspection_functions}
 
@@ -1133,6 +1122,11 @@ Possible values:
 
 Default value: 0.
 
+**See Also**
+
+- [Sampling Query Profiler](../performance/sampling_query_profiler.md)
+- System table [trace_log](../system_tables.md#system_tables-trace_log)
+
 ## input_format_parallel_parsing
 
 - Type: bool

docs/en/operations/table_engines/jdbc.md

@@ -54,18 +54,14 @@ mysql> select * from test;
 Creating a table in ClickHouse server and selecting data from it:
 
 ```sql
-CREATE TABLE jdbc_table ENGINE JDBC('jdbc:mysql://localhost:3306/?user=root&password=root', 'test', 'test')
-```
-```sql
-DESCRIBE TABLE jdbc_table
-```
-```text
-┌─name───────────────┬─type───────────────┬─default_type─┬─default_expression─┐
-│ int_id             │ Int32              │              │                    │
-│ int_nullable       │ Nullable(Int32)    │              │                    │
-│ float              │ Float32            │              │                    │
-│ float_nullable     │ Nullable(Float32)  │              │                    │
-└────────────────────┴────────────────────┴──────────────┴────────────────────┘
+CREATE TABLE jdbc_table
+(
+    `int_id` Int32,
+    `int_nullable` Nullable(Int32),
+    `float` Float32,
+    `float_nullable` Nullable(Float32)
+)
+ENGINE JDBC('jdbc:mysql://localhost:3306/?user=root&password=root', 'test', 'test')
 ```
 ```sql
 SELECT *

docs/en/operations/table_engines/mergetree.md

@@ -331,10 +331,10 @@ Function (operator) / Index | primary key | minmax | ngrambf_v1 | tokenbf_v1 | b
 [equals (=, ==)](../../query_language/functions/comparison_functions.md#function-equals) | ✔ | ✔ | ✔ | ✔ | ✔ 
 [notEquals(!=, <>)](../../query_language/functions/comparison_functions.md#function-notequals) | ✔ | ✔ | ✔ | ✔ | ✔
 [like](../../query_language/functions/string_search_functions.md#function-like) | ✔ | ✔ | ✔ | ✗ |  ✗
-[notLike](../../query_language/functions/string_search_functions.md#function-notlike) | ✔ | ✔ | ✔ | ✔ | ✗
+[notLike](../../query_language/functions/string_search_functions.md#function-notlike) | ✔ | ✔ | ✔ | ✗ | ✗
 [startsWith](../../query_language/functions/string_functions.md#function-startswith) | ✔ | ✔ | ✔ | ✔ | ✗
 [endsWith](../../query_language/functions/string_functions.md#function-endswith) | ✗ | ✗ | ✔ | ✔ | ✗
-[multiSearchAny](../../query_language/functions/string_search_functions.md#function-multisearchany) | ✗ | ✗ | ✔ | ✔ | ✗
+[multiSearchAny](../../query_language/functions/string_search_functions.md#function-multisearchany) | ✗ | ✗ | ✔ | ✗ | ✗
 [in](../../query_language/functions/in_functions.md#in-functions) | ✔ | ✔ | ✔ | ✔ | ✔ 
 [notIn](../../query_language/functions/in_functions.md#in-functions) | ✔ | ✔ | ✔ | ✔ | ✔ 
 [less (<)](../../query_language/functions/comparison_functions.md#function-less) | ✔ | ✔ | ✗ | ✗ | ✗

docs/en/query_language/create.md

@@ -129,7 +129,7 @@ Defines storage time for values. Can be specified only for MergeTree-family tabl
 
 ### Column Compression Codecs {#codecs}
 
-By default, ClickHouse applies the compression method, defined in [server settings](../operations/server_settings/settings.md#compression), to columns. You can also define the compression method for each individual column in the `CREATE TABLE` query.
+By default, ClickHouse applies the `lz4` compression method. For `MergeTree`-engine family you can change the default compression method in the [compression](../operations/server_settings/settings.md#server-settings-compression) section of a server configuration. You can also define the compression method for each individual column in the `CREATE TABLE` query.
 
 ```sql
 CREATE TABLE codec_example
@@ -151,10 +151,10 @@ If a codec is specified, the default codec doesn't apply. Codecs can be combined
 
 Compression is supported for the following table engines:
 
-- [MergeTree](../operations/table_engines/mergetree.md) family
-- [Log](../operations/table_engines/log_family.md) family
-- [Set](../operations/table_engines/set.md)
-- [Join](../operations/table_engines/join.md)
+- [MergeTree](../operations/table_engines/mergetree.md) family. Supports column compression codecs and selecting the default compression method by [compression](../operations/server_settings/settings.md#server-settings-compression) settings.
+- [Log](../operations/table_engines/log_family.md) family. Uses the `lz4` compression method by default and supports column compression codecs.
+- [Set](../operations/table_engines/set.md). Only supported the default compression.
+- [Join](../operations/table_engines/join.md). Only supported the default compression.
 
 ClickHouse supports common purpose codecs and specialized codecs.
 

docs/en/query_language/dicts/external_dicts_dict_sources.md

@@ -435,22 +435,16 @@ SOURCE(MYSQL(
 Setting fields:
 
 - `port` – The port on the MySQL server. You can specify it for all replicas, or for each one individually (inside `<replica>`).
-
 - `user` – Name of the MySQL user. You can specify it for all replicas, or for each one individually (inside `<replica>`).
-
 - `password` – Password of the MySQL user. You can specify it for all replicas, or for each one individually (inside `<replica>`).
-
 - `replica` – Section of replica configurations. There can be multiple sections.
-    - `replica/host` – The MySQL host.
 
-    \* `replica/priority` – The replica priority. When attempting to connect, ClickHouse traverses the replicas in order of priority. The lower the number, the higher the priority.
+    - `replica/host` – The MySQL host.
+    - `replica/priority` – The replica priority. When attempting to connect, ClickHouse traverses the replicas in order of priority. The lower the number, the higher the priority.
 
 - `db` – Name of the database.
-
 - `table` – Name of the table.
-
-- `where ` – The selection criteria. Optional parameter.
-
+- `where ` – The selection criteria. The syntax for conditions is the same as for `WHERE` clause in MySQL, for example, `id > 10 AND id < 20`. Optional parameter.
 - `invalidate_query` – Query for checking the dictionary status. Optional parameter. Read more in the section [Updating dictionaries](external_dicts_dict_lifetime.md).
 
 MySQL can be connected on a local host via sockets. To do this, set `host` and `socket`.

docs/en/query_language/misc.md

@@ -184,7 +184,9 @@ Changes already made by the mutation are not rolled back.
 OPTIMIZE TABLE [db.]name [ON CLUSTER cluster] [PARTITION partition | PARTITION ID 'partition_id'] [FINAL] [DEDUPLICATE]
 ```
 
-This query tries to initialize an unscheduled merge of data parts for tables with a table engine from the [MergeTree](../operations/table_engines/mergetree.md) family. Other kinds of table engines aren't supported.
+This query tries to initialize an unscheduled merge of data parts for tables with a table engine from the [MergeTree](../operations/table_engines/mergetree.md) family.
+
+The `OPTMIZE` query is also supported for the [MaterializedView](../operations/table_engines/materializedview.md) and the [Buffer](../operations/table_engines/buffer.md) engines. Other table engines aren't supported.
 
 When `OPTIMIZE` is used with the [ReplicatedMergeTree](../operations/table_engines/replication.md) family of table engines, ClickHouse creates a task for merging and waits for execution on all nodes (if the `replication_alter_partitions_sync` setting is enabled).
 

docs/en/query_language/select.md

@@ -107,7 +107,7 @@ The `FROM` clause specifies the source to read data from:
 `ARRAY JOIN` and the regular `JOIN` may also be included (see below).
 
 Instead of a table, the `SELECT` subquery may be specified in parenthesis.
-In contrast to standard SQL, a synonym does not need to be specified after a subquery. For compatibility, it is possible to write `AS name` after a subquery, but the specified name isn't used anywhere.
+In contrast to standard SQL, a synonym does not need to be specified after a subquery.
 
 To execute a query, all the columns listed in the query are extracted from the appropriate table. Any columns not needed for the external query are thrown out of the subqueries.
 If a query does not list any columns (for example, `SELECT count() FROM t`), some column is extracted from the table anyway (the smallest one is preferred), in order to calculate the number of rows.

docs/en/query_language/table_functions/index.md

@@ -4,13 +4,14 @@ Table functions are methods for constructing tables.
 
 You can use table functions in:
 
+* [FROM](../select.md#select-from) clause of the `SELECT` query.
+
+    The method for creating a temporary table that is available only in the current query. The table is deleted when the query finishes.
+
 * [CREATE TABLE AS <table_function()>](../create.md#create-table-query) query.
 
     It's one of the methods of creating a table.
 
-* [FROM](../select.md#select-from) clause of the `SELECT` query.
-
-    The method for creating a temporary table that is available only in the current query. The table is deleted when the query finishes.
 
 !!! warning "Warning"
     You can't use table functions if the [allow_ddl](../../operations/settings/permissions_for_queries.md#settings_allow_ddl) setting is disabled.

docs/ru/getting_started/install.md

@@ -14,7 +14,7 @@ $ grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not
 
 ## Доступные варианты установки
 
-### Из DEB пакетов {#from-deb-packages}
+### Из DEB пакетов {#install-from-deb-packages}
 
 Яндекс рекомендует использовать официальные скомпилированные `deb` пакеты для Debian или Ubuntu.
 

docs/ru/operations/server_settings/settings.md

@@ -134,15 +134,15 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
 
 Настройки:
 
-- host - Сервер Graphite.
-- port - Порт сервера Graphite.
-- interval - Период отправки в секундах.
-- timeout - Таймаут отправки данных в секундах.
-- root_path - Префикс для ключей.
-- metrics - Отправка данных из таблицы [system.metrics](../system_tables.md#system_tables-metrics).
-- events - Отправка дельты данных, накопленной за промежуток времени из таблицы [system.events](../system_tables.md#system_tables-events).
-- events_cumulative - Отправка суммарных данных из таблицы [system.events](../system_tables.md#system_tables-events).
-- asynchronous_metrics - Отправка данных из таблицы [system.asynchronous_metrics](../system_tables.md#system_tables-asynchronous_metrics).
+- host – Сервер Graphite.
+- port – Порт сервера Graphite.
+- interval – Период отправки в секундах.
+- timeout – Таймаут отправки данных в секундах.
+- root_path – Префикс для ключей.
+- metrics – Отправка данных из таблицы [system.metrics](../system_tables.md#system_tables-metrics).
+- events – Отправка дельты данных, накопленной за промежуток времени из таблицы [system.events](../system_tables.md#system_tables-events).
+- events_cumulative – Отправка суммарных данных из таблицы [system.events](../system_tables.md#system_tables-events).
+- asynchronous_metrics – Отправка данных из таблицы [system.asynchronous_metrics](../system_tables.md#system_tables-asynchronous_metrics).
 
 Можно определить несколько секций `<graphite>`, например, для передачи различных данных с различной частотой.
 

docs/ru/query_language/dicts/external_dicts_dict_sources.md

@@ -330,18 +330,18 @@ $ sudo apt-get install tdsodbc freetds-bin sqsh
 
 Поля настройки:
 
--   `port` - порт сервера MySQL. Можно указать для всех реплик или для каждой в отдельности (внутри `<replica>`).
--   `user` - имя пользователя MySQL. Можно указать для всех реплик или для каждой в отдельности (внутри `<replica>`).
--   `password` - пароль пользователя MySQL. Можно указать для всех реплик или для каждой в отдельности (внутри `<replica>`).
--   `replica` - блок конфигурации реплики. Блоков может быть несколько.
-
-    -   `replica/host` - хост MySQL.
-
-    \* `replica/priority` - приоритет реплики. При попытке соединения ClickHouse обходит реплики в соответствии с приоритетом. Чем меньше цифра, тем выше приоритет.
--   `db` - имя базы данных.
--   `table` - имя таблицы.
--   `where` - условие выбора. Необязательный параметр.
--   `invalidate_query` - запрос для проверки статуса словаря. Необязательный параметр. Читайте подробнее в разделе [Обновление словарей](external_dicts_dict_lifetime.md).
+- `port` — порт сервера MySQL. Можно указать для всех реплик или для каждой в отдельности (внутри `<replica>`).
+- `user` — имя пользователя MySQL. Можно указать для всех реплик или для каждой в отдельности (внутри `<replica>`).
+- `password` — пароль пользователя MySQL. Можно указать для всех реплик или для каждой в отдельности (внутри `<replica>`).
+- `replica` — блок конфигурации реплики. Блоков может быть несколько.
+
+    - `replica/host` — хост MySQL.
+    - `replica/priority` — приоритет реплики. При попытке соединения ClickHouse обходит реплики в соответствии с приоритетом. Чем меньше цифра, тем выше приоритет.
+
+- `db` — имя базы данных.
+- `table` — имя таблицы.
+- `where` — условие выбора. Синтаксис условия совпадает с синтаксисом секции `WHERE` в MySQL, например, `id > 10 AND id < 20`. Необязательный параметр.
+- `invalidate_query` — запрос для проверки статуса словаря. Необязательный параметр. Читайте подробнее в разделе [Обновление словарей](external_dicts_dict_lifetime.md).
 
 MySQL можно подключить на локальном хосте через сокеты, для этого необходимо задать `host` и `socket`.
 

docs/toc_en.yml

@@ -36,48 +36,49 @@ nav:
     - 'Visual Interfaces': 'interfaces/third-party/gui.md'
     - 'Proxies': 'interfaces/third-party/proxy.md'
 
-- 'Database Engines':
-    - 'Introduction': 'database_engines/index.md'
-    - 'MySQL': 'database_engines/mysql.md'
-    - 'Lazy': 'database_engines/lazy.md'
+- 'Engines':
+  - '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'
+      - 'JDBC': 'operations/table_engines/jdbc.md'
+      - 'ODBC': 'operations/table_engines/odbc.md'
+      - 'HDFS': 'operations/table_engines/hdfs.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'
 
-- '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'
-    - 'JDBC': 'operations/table_engines/jdbc.md'
-    - 'ODBC': 'operations/table_engines/odbc.md'
-    - 'HDFS': 'operations/table_engines/hdfs.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'
+  - 'Database Engines':
+      - 'Introduction': 'database_engines/index.md'
+      - 'MySQL': 'database_engines/mysql.md'
+      - 'Lazy': 'database_engines/lazy.md'
 
 - 'SQL Reference':
   - 'hidden': 'query_language/index.md'
@@ -191,13 +192,14 @@ nav:
   - 'Requirements': 'operations/requirements.md'
   - 'Monitoring': 'operations/monitoring.md'
   - 'Troubleshooting': 'operations/troubleshooting.md'
-  - 'Usage Recommendations': 'operations/tips.md'
   - 'ClickHouse Update': 'operations/update.md'
   - 'Access Rights': 'operations/access_rights.md'
   - 'Data Backup': 'operations/backup.md'
   - 'Configuration Files': 'operations/configuration_files.md'
   - 'Quotas': 'operations/quotas.md'
   - 'System Tables': 'operations/system_tables.md'
+  - 'Optimizing Performance':
+    - 'Query Profiling': operations/performance/sampling_query_profiler.md
   - 'Testing Hardware': 'operations/performance_test.md'
   - 'Server Configuration Parameters':
     - 'Introduction': 'operations/server_settings/index.md'
@@ -215,7 +217,8 @@ nav:
     - 'clickhouse-copier': 'operations/utils/clickhouse-copier.md'
     - 'clickhouse-local': 'operations/utils/clickhouse-local.md'
     - 'clickhouse-benchmark': 'operations/utils/clickhouse-benchmark.md'
-
+  - 'Usage Recommendations': 'operations/tips.md'
+  
 - 'Development':
   - 'hidden': 'development/index.md'
   - 'The Beginner ClickHouse Developer Instruction': 'development/developer_instruction.md'