Various docs fixes

docs/en/engines/database-engines/materialized-postgresql.md

@@ -9,6 +9,13 @@ Creates a ClickHouse database with tables from PostgreSQL database. Firstly, dat
 
 Replication is implemented with PostgreSQL Logical Replication Protocol, which does not allow to replicate DDL, but allows to know whether replication breaking changes happened (column type changes, adding/removing columns). Such changes are detected and according tables stop receiving updates. Such tables can be automatically reloaded in the background in case required setting is turned on (can be used starting from 22.1). Safest way for now is to use `ATTACH`/ `DETACH` queries to reload table completely. If DDL does not break replication (for example, renaming a column) table will still receive updates (insertion is done by position).
 
+:::note
+This database engine is experimental. To use it, set `allow_experimental_database_materialized_postgresql` to 1 in your configuration files or by using the `SET` command:
+```sql
+SET allow_experimental_database_materialized_postgresql=1
+```
+:::
+
 ## Creating a Database {#creating-a-database}
 
 ``` sql
@@ -137,7 +144,7 @@ FROM pg_class
 WHERE oid = 'postgres_table'::regclass;
 ```
 
-:::warning 
+:::warning
 Replication of [**TOAST**](https://www.postgresql.org/docs/9.5/storage-toast.html) values is not supported. The default value for the data type will be used.
 :::
 

docs/en/engines/table-engines/integrations/postgresql.md

@@ -43,14 +43,14 @@ or via config (since version 21.11):
     <postgres1>
         <host></host>
         <port></port>
-        <username></username>
+        <user></user>
         <password></password>
         <table></table>
     </postgres1>
     <postgres2>
         <host></host>
         <port></port>
-        <username></username>
+        <user></user>
         <password></password>
     </postgres2>
 </named_collections>
@@ -73,7 +73,7 @@ All joins, aggregations, sorting, `IN [ array ]` conditions and the `LIMIT` samp
 
 PostgreSQL `Array` types are converted into ClickHouse arrays.
 
-:::warning    
+:::warning
 Be careful - in PostgreSQL an array data, created like a `type_name[]`, may contain multi-dimensional arrays of different dimensions in different table rows in same column. But in ClickHouse it is only allowed to have multidimensional arrays of the same count of dimensions in all table rows in same column.
 :::
 

docs/en/sql-reference/functions/ip-address-functions.md

@@ -13,10 +13,18 @@ Alias: `INET_NTOA`.
 
 ## IPv4StringToNum(s) {#ipv4stringtonums}
 
-The reverse function of IPv4NumToString. If the IPv4 address has an invalid format, it returns 0.
+The reverse function of IPv4NumToString. If the IPv4 address has an invalid format, it throws exception.
 
 Alias: `INET_ATON`.
 
+## IPv4StringToNumOrDefault(s) {#ipv4stringtonums}
+
+Same as `IPv4StringToNum`, but if the IPv4 address has an invalid format, it returns 0.
+
+## IPv4StringToNumOrNull(s) {#ipv4stringtonums}
+
+Same as `IPv4StringToNum`, but if the IPv4 address has an invalid format, it returns null.
+
 ## IPv4NumToStringClassC(num) {#ipv4numtostringclasscnum}
 
 Similar to IPv4NumToString, but using xxx instead of the last octet.
@@ -123,7 +131,7 @@ LIMIT 10
 
 ## IPv6StringToNum {#ipv6stringtonums}
 
-The reverse function of [IPv6NumToString](#ipv6numtostringx). If the IPv6 address has an invalid format, it returns a string of null bytes.
+The reverse function of [IPv6NumToString](#ipv6numtostringx). If the IPv6 address has an invalid format, it throws exception.
 
 If the input string contains a valid IPv4 address, returns its IPv6 equivalent.
 HEX can be uppercase or lowercase.
@@ -168,6 +176,14 @@ Result:
 
 -   [cutIPv6](#cutipv6x-bytestocutforipv6-bytestocutforipv4).
 
+## IPv6StringToNumOrDefault(s) {#ipv6stringtonums}
+
+Same as `IPv6StringToNum`, but if the IPv6 address has an invalid format, it returns 0.
+
+## IPv6StringToNumOrNull(s) {#ipv6stringtonums}
+
+Same as `IPv6StringToNum`, but if the IPv6 address has an invalid format, it returns null.
+
 ## IPv4ToIPv6(x) {#ipv4toipv6x}
 
 Takes a `UInt32` number. Interprets it as an IPv4 address in [big endian](https://en.wikipedia.org/wiki/Endianness). Returns a `FixedString(16)` value containing the IPv6 address in binary format. Examples:
@@ -261,6 +277,14 @@ SELECT
 └───────────────────────────────────┴──────────────────────────┘
 ```
 
+## toIPv4OrDefault(string) {#toipv4ordefaultstring}
+
+Same as `toIPv4`, but if the IPv4 address has an invalid format, it returns 0.
+
+## toIPv4OrNull(string) {#toipv4ornullstring}
+
+Same as `toIPv4`, but if the IPv4 address has an invalid format, it returns null.
+
 ## toIPv6 {#toipv6string}
 
 Converts a string form of IPv6 address to [IPv6](../../sql-reference/data-types/domains/ipv6.md) type. If the IPv6 address has an invalid format, returns an empty value.
@@ -317,6 +341,14 @@ Result:
 └─────────────────────┘
 ```
 
+## IPv6StringToNumOrDefault(s) {#toipv6ordefaultstring}
+
+Same as `toIPv6`, but if the IPv6 address has an invalid format, it returns 0.
+
+## IPv6StringToNumOrNull(s) {#toipv6ornullstring}
+
+Same as `toIPv6`, but if the IPv6 address has an invalid format, it returns null.
+
 ## isIPv4String {#isipv4string}
 
 Determines whether the input string is an IPv4 address or not. If `string` is IPv6 address returns `0`.

docs/ru/getting-started/tutorial.md

@@ -476,7 +476,7 @@ clickhouse-client --query "INSERT INTO tutorial.hits_v1 FORMAT TSV" --max_insert
 clickhouse-client --query "INSERT INTO tutorial.visits_v1 FORMAT TSV" --max_insert_block_size=100000 < visits_v1.tsv
 ```
 
-ClickHouse has a lot of [settings to tune](../operations/settings/overview.md) and one way to specify them in console client is via arguments, as we can see with `--max_insert_block_size`. The easiest way to figure out what settings are available, what do they mean and what the defaults are is to query the `system.settings` table:
+ClickHouse has a lot of [settings to tune](../operations/settings/) and one way to specify them in console client is via arguments, as we can see with `--max_insert_block_size`. The easiest way to figure out what settings are available, what do they mean and what the defaults are is to query the `system.settings` table:
 
 ``` sql
 SELECT name, value, changed, description

docs/ru/interfaces/http.md

@@ -242,7 +242,7 @@ $ echo 'SELECT 1' | curl -H 'X-ClickHouse-User: user' -H 'X-ClickHouse-Key: pass
 Если пользователь не задан,то используется `default`. Если пароль не задан, то используется пустой пароль.
 Также в параметрах URL вы можете указать любые настройки, которые будут использованы для обработки одного запроса, или целые профили настроек. Пример:http://localhost:8123/?profile=web&max_rows_to_read=1000000000&query=SELECT+1
 
-Подробнее смотрите в разделе [Настройки](../operations/settings/overview.md).
+Подробнее смотрите в разделе [Настройки](../operations/settings/).
 
 ``` bash
 $ echo 'SELECT number FROM system.numbers LIMIT 10' | curl 'http://localhost:8123/?' --data-binary @-
@@ -432,7 +432,7 @@ $ curl -v 'http://localhost:8123/predefined_query'
 ``` xml
 <http_handlers>
     <rule>
-        <url><![CDATA[/query_param_with_url/\w+/(?P<name_1>[^/]+)(/(?P<name_2>[^/]+))?]]></url>
+        <url><![CDATA[regex:/query_param_with_url/\w+/(?P<name_1>[^/]+)(/(?P<name_2>[^/]+))?]]></url>
         <methods>GET</methods>
         <headers>
             <XXX>TEST_HEADER_VALUE</XXX>

docs/ru/operations/access-rights.md

@@ -111,7 +111,7 @@ ClickHouse поддерживает управление доступом на
 
 ## Профиль настроек {#settings-profiles-management}
 
-Профиль настроек — это набор [настроек](settings/overview.md). Профиль настроек содержит настройки и ограничения, а также список ролей и/или пользователей, по отношению к которым применяется данный профиль.
+Профиль настроек — это набор [настроек](settings/index.md). Профиль настроек содержит настройки и ограничения, а также список ролей и/или пользователей, по отношению к которым применяется данный профиль.
 
 Запросы управления:
 

docs/ru/operations/index.md

@@ -19,6 +19,6 @@ sidebar_label: "Эксплуатация"
 - [Системные таблицы](system-tables/index.md)
 - [Конфигурационные параметры сервера](server-configuration-parameters/index.md)
 - [Тестирование серверов с помощью ClickHouse](performance-test.md)
-- [Настройки](settings/overview.md#settings)
+- [Настройки](settings/index.md#settings)
 - [Утилиты](utilities/index.md)
 

docs/ru/operations/server-configuration-parameters/index.md

@@ -9,7 +9,7 @@ sidebar_position: 54
 
 Рассмотренные настройки хранятся в файле `config.xml` сервера ClickHouse.
 
-Прочие настройки описаны в разделе «[Настройки](../settings/overview.md#settings)».
+Прочие настройки описаны в разделе «[Настройки](../settings/index.md#settings)».
 
 Перед изучением настроек ознакомьтесь с разделом [Конфигурационные файлы](../configuration-files.md#configuration_files), обратите внимание на использование подстановок (атрибуты `incl` и `optional`).
 

docs/ru/operations/settings/index.md

@@ -1,6 +1,7 @@
 ---
 sidebar_label: Settings
 sidebar_position: 55
+slug: /ru/operations/settings/
 ---
 
 # Настройки {#session-settings-intro}

docs/ru/operations/settings/settings.md

@@ -1,6 +1,7 @@
 ---
 sidebar_position: 60
 sidebar_label: "Настройки"
+slug: /ru/operations/settings/settings
 ---
 
 # Настройки {#settings}
@@ -391,7 +392,7 @@ INSERT INTO test VALUES (lower('Hello')), (lower('world')), (lower('INSERT')), (
 
 ## input_format_tsv_enum_as_number {#settings-input_format_tsv_enum_as_number}
 
-Включает или отключает парсинг значений перечислений как порядковых номеров. 
+Включает или отключает парсинг значений перечислений как порядковых номеров.
 
 Если режим включен, то во входящих данных в формате `TCV` значения перечисления (тип `ENUM`) всегда трактуются как порядковые номера, а не как элементы перечисления. Эту настройку рекомендуется включать для оптимизации парсинга, если данные типа `ENUM` содержат только порядковые номера, а не сами элементы перечисления.
 
@@ -1176,8 +1177,8 @@ SELECT type, query FROM system.query_log WHERE log_comment = 'log_comment test'
 
 Может быть использована для ограничения скорости сети при репликации данных для добавления или замены новых узлов.
 
-    :::note 
+    :::note
-    60000000 байт/с примерно соответствует 457 Мбит/с (60000000 / 1024 / 1024 * 8). 
+    60000000 байт/с примерно соответствует 457 Мбит/с (60000000 / 1024 / 1024 * 8).
     :::
 ## max_replicated_sends_network_bandwidth_for_server {#max_replicated_sends_network_bandwidth_for_server}
 
@@ -1196,8 +1197,8 @@ SELECT type, query FROM system.query_log WHERE log_comment = 'log_comment test'
 
 Может быть использована для ограничения скорости сети при репликации данных для добавления или замены новых узлов.
 
-    :::note 
+    :::note
-    60000000 байт/с примерно соответствует 457 Мбит/с (60000000 / 1024 / 1024 * 8). 
+    60000000 байт/с примерно соответствует 457 Мбит/с (60000000 / 1024 / 1024 * 8).
     :::
 ## connect_timeout_with_failover_ms {#connect-timeout-with-failover-ms}
 
@@ -1419,13 +1420,13 @@ load_balancing = round_robin
 
 Значение по умолчанию: `1`.
 
-**См. также** 
+**См. также**
 
 -   [min_count_to_compile_aggregate_expression](#min_count_to_compile_aggregate_expression)
 
 ## min_count_to_compile_aggregate_expression {#min_count_to_compile_aggregate_expression}
 
-Минимальное количество вызовов агрегатной функции с одинаковым выражением, при котором функция будет компилироваться в нативный код в ходе выполнения запроса. Работает только если включена настройка [compile_aggregate_expressions](#compile_aggregate_expressions).  
+Минимальное количество вызовов агрегатной функции с одинаковым выражением, при котором функция будет компилироваться в нативный код в ходе выполнения запроса. Работает только если включена настройка [compile_aggregate_expressions](#compile_aggregate_expressions).
 
 Возможные значения:
 
@@ -1554,7 +1555,7 @@ SELECT area/period FROM account_orders FORMAT JSON;
 
 ## input_format_csv_enum_as_number {#settings-input_format_csv_enum_as_number}
 
-Включает или отключает парсинг значений перечислений как порядковых номеров. 
+Включает или отключает парсинг значений перечислений как порядковых номеров.
 Если режим включен, то во входящих данных в формате `CSV` значения перечисления (тип `ENUM`) всегда трактуются как порядковые номера, а не как элементы перечисления. Эту настройку рекомендуется включать для оптимизации парсинга, если данные типа `ENUM` содержат только порядковые номера, а не сами элементы перечисления.
 
 Возможные значения:
@@ -1761,11 +1762,11 @@ SETTINGS non_replicated_deduplication_window = 100;
 
 INSERT INTO test_table Values SETTINGS insert_deduplication_token = 'test' (1);
 
--- следующая вставка не будет дедуплицирована, потому что insert_deduplication_token отличается 
+-- следующая вставка не будет дедуплицирована, потому что insert_deduplication_token отличается
 INSERT INTO test_table Values SETTINGS insert_deduplication_token = 'test1' (1);
 
 -- следующая вставка будет дедуплицирована, потому что insert_deduplication_token
--- тот же самый, что и один из предыдущих 
+-- тот же самый, что и один из предыдущих
 INSERT INTO test_table Values SETTINGS insert_deduplication_token = 'test' (2);
 
 SELECT * FROM test_table
@@ -1868,7 +1869,7 @@ SELECT * FROM test_table
 
 ## distributed_push_down_limit {#distributed-push-down-limit}
 
-Включает или отключает [LIMIT](#limit), применяемый к каждому шарду по отдельности. 
+Включает или отключает [LIMIT](#limit), применяемый к каждому шарду по отдельности.
 
 Это позволяет избежать:
 - отправки дополнительных строк по сети;
@@ -1993,7 +1994,7 @@ SELECT * FROM test_table
 
    - 0 — оптимизация отключена.
    - 1 — оптимизация включена.
-   
+
 Значение по умолчанию: `1`.
 
 См. также:
@@ -2871,7 +2872,7 @@ SELECT CAST(toNullable(toInt32(0)) AS Int32) as x, toTypeName(x);
 
 Значение по умолчанию: `1`.
 
-## output_format_csv_null_representation {#output_format_csv_null_representation}
+## format_csv_null_representation {#format_csv_null_representation}
 
 Определяет представление `NULL` для формата выходных данных [CSV](../../interfaces/formats.md#csv). Пользователь может установить в качестве значения любую строку, например, `My NULL`.
 
@@ -2896,7 +2897,7 @@ SELECT * FROM csv_custom_null FORMAT CSV;
 Запрос:
 
 ```sql
-SET output_format_csv_null_representation = 'My NULL';
+SET format_csv_null_representation = 'My NULL';
 SELECT * FROM csv_custom_null FORMAT CSV;
 ```
 
@@ -2908,7 +2909,7 @@ My NULL
 My NULL
 ```
 
-## output_format_tsv_null_representation {#output_format_tsv_null_representation}
+## format_tsv_null_representation {#format_tsv_null_representation}
 
 Определяет представление `NULL` для формата выходных данных [TSV](../../interfaces/formats.md#tabseparated). Пользователь может установить в качестве значения любую строку.
 
@@ -2933,7 +2934,7 @@ SELECT * FROM tsv_custom_null FORMAT TSV;
 Запрос
 
 ```sql
-SET output_format_tsv_null_representation = 'My NULL';
+SET format_tsv_null_representation = 'My NULL';
 SELECT * FROM tsv_custom_null FORMAT TSV;
 ```
 
@@ -3679,7 +3680,7 @@ SETTINGS index_granularity = 8192 │
 
 ## max_hyperscan_regexp_length {#max-hyperscan-regexp-length}
 
-Задает максимальную длину каждого регулярного выражения в [hyperscan-функциях](../../sql-reference/functions/string-search-functions.md#multimatchanyhaystack-pattern1-pattern2-patternn)  поиска множественных совпадений в строке. 
+Задает максимальную длину каждого регулярного выражения в [hyperscan-функциях](../../sql-reference/functions/string-search-functions.md#multimatchanyhaystack-pattern1-pattern2-patternn)  поиска множественных совпадений в строке.
 
 Возможные значения:
 

docs/ru/operations/system-tables/settings.md

@@ -45,7 +45,7 @@ SELECT * FROM system.settings WHERE changed AND name='load_balancing'
 
 **Cм. также**
 
--   [Настройки](../settings/overview.md#settings)
+-   [Настройки](../settings/index.md#settings)
 -   [Разрешения для запросов](../settings/permissions-for-queries.md#settings_readonly)
 -   [Ограничения для значений настроек](../settings/constraints-on-settings.md)
 -   Выражение [SHOW SETTINGS](../../sql-reference/statements/show.md#show-settings)

docs/ru/operations/utilities/clickhouse-benchmark.md

@@ -59,7 +59,7 @@ clickhouse-benchmark [keys] < queries_file;
 -   `--stage=WORD` — стадия обработки запроса на сервере. ClickHouse останавливает обработку запроса и возвращает ответ `clickhouse-benchmark` на заданной стадии. Возможные значения: `complete`, `fetch_columns`, `with_mergeable_state`. Значение по умолчанию: `complete`.
 -   `--help` — показывает справку.
 
-Если нужно применить [настройки](../../operations/settings/overview.md) для запросов, их можно передать как ключ `--<session setting name>= SETTING_VALUE`. Например, `--max_memory_usage=1048576`.
+Если нужно применить [настройки](../../operations/settings/) для запросов, их можно передать как ключ `--<session setting name>= SETTING_VALUE`. Например, `--max_memory_usage=1048576`.
 
 ## Вывод {#clickhouse-benchmark-output}
 

docs/ru/sql-reference/functions/other-functions.md

@@ -1927,7 +1927,7 @@ SELECT randomStringUTF8(13)
 
 ## getSetting {#getSetting}
 
-Возвращает текущее значение [пользовательской настройки](../../operations/settings/overview.md#custom_settings).
+Возвращает текущее значение [пользовательской настройки](../../operations/settings/index.md#custom_settings).
 
 **Синтаксис**
 
@@ -1958,7 +1958,7 @@ SELECT getSetting('custom_a');
 
 **См. также**
 
--   [Пользовательские настройки](../../operations/settings/overview.md#custom_settings)
+-   [Пользовательские настройки](../../operations/settings/index.md#custom_settings)
 
 ## isDecimalOverflow {#is-decimal-overflow}
 
@@ -2158,7 +2158,7 @@ currentRoles()
 
 **Возвращаемое значение**
 
--   Список текущих ролей для текущего пользователя. 
+-   Список текущих ролей для текущего пользователя.
 
 Тип: [Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md)).
 
@@ -2174,13 +2174,13 @@ enabledRoles()
 
 **Возвращаемое значение**
 
--   Список доступных ролей для текущего пользователя. 
+-   Список доступных ролей для текущего пользователя.
 
 Тип: [Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md)).
 
 ## defaultRoles {#default-roles}
 
-Возвращает имена ролей, которые задаются по умолчанию для текущего пользователя при входе в систему. Изначально это все роли, которые разрешено использовать текущему пользователю (см. [GRANT](../../sql-reference/statements/grant/#grant-select)). Список ролей по умолчанию может быть изменен с помощью выражения [SET DEFAULT ROLE](../../sql-reference/statements/set-role.md#set-default-role-statement). 
+Возвращает имена ролей, которые задаются по умолчанию для текущего пользователя при входе в систему. Изначально это все роли, которые разрешено использовать текущему пользователю (см. [GRANT](../../sql-reference/statements/grant/#grant-select)). Список ролей по умолчанию может быть изменен с помощью выражения [SET DEFAULT ROLE](../../sql-reference/statements/set-role.md#set-default-role-statement).
 
 **Синтаксис**
 
@@ -2190,7 +2190,7 @@ defaultRoles()
 
 **Возвращаемое значение**
 
--   Список ролей по умолчанию. 
+-   Список ролей по умолчанию.
 
 Тип: [Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md)).
 
@@ -2337,7 +2337,7 @@ shardNum()
 Запрос:
 
 ``` sql
-CREATE TABLE shard_num_example (dummy UInt8) 
+CREATE TABLE shard_num_example (dummy UInt8)
     ENGINE=Distributed(test_cluster_two_shards_localhost, system, one, dummy);
 SELECT dummy, shardNum(), shardCount() FROM shard_num_example;
 ```

docs/ru/sql-reference/statements/select/index.md

@@ -24,7 +24,7 @@ SELECT [DISTINCT [ON (column1, column2, ...)]] expr_list
 [LIMIT [n, ]m] [WITH TIES]
 [SETTINGS ...]
 [UNION ALL ...]
-[INTO OUTFILE filename [COMPRESSION type] ] 
+[INTO OUTFILE filename [COMPRESSION type] ]
 [FORMAT format]
 ```
 
@@ -273,7 +273,7 @@ SELECT * REPLACE(i + 1 AS i) EXCEPT (j) APPLY(sum) from columns_transformers;
 
 Вы можете задать значения необходимых настроек непосредственно в запросе `SELECT` в секции `SETTINGS`. Эти настройки действуют только в рамках данного запроса, а после его выполнения сбрасываются до предыдущего значения или значения по умолчанию.
 
-Другие способы задания настроек описаны [здесь](../../../operations/settings/overview.md).
+Другие способы задания настроек описаны [здесь](../../../operations/settings/index.md).
 
 **Пример**
 

docs/ru/sql-reference/statements/set.md

@@ -9,7 +9,7 @@ sidebar_label: SET
 SET param = value
 ```
 
-Устанавливает значение `value` для [настройки](../../operations/settings/overview.md) `param` в текущей сессии. [Конфигурационные параметры сервера](../../operations/server-configuration-parameters/settings.md) нельзя изменить подобным образом.
+Устанавливает значение `value` для [настройки](../../operations/settings/index.md) `param` в текущей сессии. [Конфигурационные параметры сервера](../../operations/server-configuration-parameters/settings.md) нельзя изменить подобным образом.
 
 Можно одним запросом установить все настройки из заданного профиля настроек.
 

docs/zh/sql-reference/operators/index.md

@@ -44,9 +44,9 @@
 
 `a > b` – 对应函数 `greater(a, b)`
 
-`a LIKE s` – 对应函数 `like(a, b)`
+`a LIKE b` – 对应函数 `like(a, b)`
 
-`a NOT LIKE s` – 对应函数 `notLike(a, b)`
+`a NOT LIKE b` – 对应函数 `notLike(a, b)`
 
 `a BETWEEN b AND c` – 等价于 `a >= b AND a <= c`