Merge branch 'master' of github.com:ClickHouse/ClickHouse into add-test-62816

Author: nikitamikhaylov

ci/jobs/scripts/check_style/aspell-ignore/en/aspell-dict.txt

@@ -1251,6 +1251,7 @@ aggthrow
 aiochclient
 alloc
 allocator
+allowlist
 alphaTokens
 amplab
 analysisOfVariance
@@ -1687,6 +1688,7 @@ denormalize
 denormalized
 denormalizing
 denormals
+denylist
 dequeued
 dequeues
 dereference

ci/jobs/scripts/workflow_hooks/trusted.py

@@ -7,10 +7,10 @@
     e.lower()
     for e in [
         "amosbird",
+        "azat",
         "den-crane",  # Documentation contributor
         "taiyang-li",
         "ucasFL",  # Amos Bird's friend
-        "tonickkozlov",  # Cloudflare
         "canhld94",
     ]
 }

docker/test/fuzzer/run-fuzzer.sh

@@ -379,8 +379,11 @@ EOF
     elif [ "$server_died" == 1 ]
     then
         # The server has died.
-        if ! rg --text -o 'Received signal.*|Logical error.*|Assertion.*failed|Failed assertion.*|.*runtime error: .*|.*is located.*|(SUMMARY|ERROR): [a-zA-Z]+Sanitizer:.*|.*_LIBCPP_ASSERT.*|.*Child process was terminated by signal 9.*' server.log > description.txt
+        if rg --text -o 'Received signal.*|Logical error.*|Assertion.*failed|Failed assertion.*|.*runtime error: .*|.*is located.*|(SUMMARY|ERROR): [a-zA-Z]+Sanitizer:.*|.*_LIBCPP_ASSERT.*|.*Child process was terminated by signal 9.*' server.log > description.txt
         then
+            # Save the stack trace of the server to the description file and preserve in raw text output.
+            rg --text '\s<Fatal>\s' server.log >> description.txt || :
+        else
             echo "Lost connection to server. See the logs." > description.txt
         fi
 

docs/en/engines/table-engines/mergetree-family/annindexes.md

@@ -394,7 +394,7 @@ returns
    └────┴─────────┘
 ```
 
-# References {#references}
+## References {#references}
 
 Blogs:
 - [Vector Search with ClickHouse - Part 1](https://clickhouse.com/blog/vector-search-clickhouse-p1)

docs/en/engines/table-engines/mergetree-family/invertedindexes.md

@@ -60,10 +60,6 @@ ENGINE = MergeTree
 ORDER BY key
 ```
 
-:::note
-In earlier versions of ClickHouse, the corresponding index type name was `inverted`.
-:::
-
 where `N` specifies the tokenizer:
 
 - `gin(0)` (or shorter: `gin()`) set the tokenizer to "tokens", i.e. split strings along spaces,

docs/en/interfaces/formats/Null.md

@@ -2,7 +2,7 @@
 alias: []
 description: 'Documentation for the Null format'
 input_format: false
-keywords: ['Null']
+keywords: ['Null', 'format']
 output_format: true
 slug: /interfaces/formats/Null
 title: 'Null'
@@ -24,4 +24,26 @@ The `Null` format can be useful for performance testing.
 
 ## Example Usage {#example-usage}
 
-## Format Settings {#format-settings}
+Connect to `play.clickhouse.com` with clickhouse client:
+
+```bash
+clickhouse client --secure --host play.clickhouse.com --user explorer
+```
+
+Run the following the query:
+
+```sql title="Query"
+SELECT town
+FROM uk_price_paid
+LIMIT 1000
+FORMAT `Null`
+```
+
+```response title="Response"
+0 rows in set. Elapsed: 0.002 sec. Processed 1.00 thousand rows, 2.00 KB (506.97 thousand rows/s., 1.01 MB/s.)
+Peak memory usage: 297.74 KiB.
+```
+
+Note how 1000 rows were processed, but 0 rows were output in the result set.
+
+## Format Settings {#format-settings}

docs/en/operations/system-tables/functions.md

@@ -20,6 +20,7 @@ Columns:
 - `arguments`, ([String](../../sql-reference/data-types/string.md)) - What arguments does the function take.
 - `returned_value`, ([String](../../sql-reference/data-types/string.md)) - What does the function return.
 - `examples`, ([String](../../sql-reference/data-types/string.md)) - Example usage of the function.
+- `introduced_in`, ([String](../../sql-reference/data-types/string.md)) - ClickHouse version in which the function was first introduced.
 - `categories`, ([String](../../sql-reference/data-types/string.md)) - The category of the function.
 
 **Example**

docs/en/sql-reference/formats.mdx

@@ -4,6 +4,7 @@ sidebar_position: 50
 sidebar_label: 'Input and Output Formats'
 title: 'Formats for Input and Output Data'
 description: 'Supported input and output formats'
+hide_title: true
 ---
 
 import Content from '../interfaces/formats.md';

docs/en/sql-reference/functions/geo/s2.md

@@ -9,7 +9,7 @@ description: 'Documentation for functions for working with S2 indexes'
 
 ## S2Index {#s2index}
 
-[S2](https://s2geometry.io/) is a geographical indexing system where all geographical data is represented on a three-dimensional sphere (similar to a globe).
+[S2](https://s2geometry.io/) is a geographical indexing system where all geographical data is represented on a sphere (similar to a globe).
 
 In the S2 library points are represented as the S2 Index - a specific number which encodes internally a point on the surface of a unit sphere, unlike traditional (latitude, longitude) pairs. To get the S2 point index for a given point specified in the format (latitude, longitude) use the [geoToS2](#geotos2) function. Also, you can use the [s2ToGeo](#s2togeo) function for getting geographical coordinates corresponding to the specified S2 point index.
 

docs/en/sql-reference/statements/alter/comment.md

@@ -1,24 +1,28 @@
 ---
-description: 'Documentation for ALTER TABLE ... MODIFY COMMENT'
-sidebar_label: 'COMMENT'
+description: 'Documentation for ALTER TABLE ... MODIFY COMMENT which allow
+adding, modifying, or removing table comments'
+sidebar_label: 'ALTER TABLE ... MODIFY COMMENT'
 sidebar_position: 51
 slug: /sql-reference/statements/alter/comment
 title: 'ALTER TABLE ... MODIFY COMMENT'
+keywords: ['ALTER TABLE', 'MODIFY COMMENT']
 ---
 
 # ALTER TABLE ... MODIFY COMMENT
 
-Adds, modifies, or removes comment to the table, regardless if it was set before or not. Comment change is reflected in both [system.tables](../../../operations/system-tables/tables.md) and `SHOW CREATE TABLE` query.
+Adds, modifies, or removes a table comment, regardless of whether it was set 
+before or not. The comment change is reflected in both [`system.tables`](../../../operations/system-tables/tables.md) 
+and in the `SHOW CREATE TABLE` query.
 
-**Syntax**
+## Syntax {#syntax}
 
 ```sql
 ALTER TABLE [db].name [ON CLUSTER cluster] MODIFY COMMENT 'Comment'
 ```
 
-**Examples**
+## Examples {#examples}
 
-Creating a table with comment (for more information, see the [COMMENT](/sql-reference/statements/create/table#comment-clause) clause):
+To create a table with a comment:
 
 ```sql
 CREATE TABLE table_with_comment
@@ -30,38 +34,56 @@ ENGINE = Memory()
 COMMENT 'The temporary table';
 ```
 
-Modifying the table comment:
+To modify the table comment:
 
 ```sql
-ALTER TABLE table_with_comment MODIFY COMMENT 'new comment on a table';
-SELECT comment FROM system.tables WHERE database = currentDatabase() AND name = 'table_with_comment';
+ALTER TABLE table_with_comment 
+MODIFY COMMENT 'new comment on a table';
 ```
 
-Output of a new comment:
+To view the modified comment:
 
-```text
+```sql title="Query"
+SELECT comment 
+FROM system.tables 
+WHERE database = currentDatabase() AND name = 'table_with_comment';
+```
+
+```text title="Response"
 ┌─comment────────────────┐
 │ new comment on a table │
 └────────────────────────┘
 ```
 
-Removing the table comment:
+To remove the table comment:
 
 ```sql
 ALTER TABLE table_with_comment MODIFY COMMENT '';
-SELECT comment FROM system.tables WHERE database = currentDatabase() AND name = 'table_with_comment';
 ```
 
-Output of a removed comment:
+To verify that the comment was removed:
+
+```sql title="Query"
+SELECT comment 
+FROM system.tables 
+WHERE database = currentDatabase() AND name = 'table_with_comment';
+```
 
-```text
+```text title="Response"
 ┌─comment─┐
 │         │
 └─────────┘
 ```
 
-**Caveats**
+## Caveats {#caveats}
+
+For Replicated tables, the comment can be different on different replicas. 
+Modifying the comment applies to a single replica.
+
+The feature is available since version 23.9. It does not work in previous 
+ClickHouse versions.
 
-For Replicated tables, the comment can be different on different replicas. Modifying the comment applies to a single replica.
+## Related content {#related-content}
 
-The feature is available since version 23.9. It does not work in previous ClickHouse versions.
+- [`COMMENT`](/sql-reference/statements/create/table#comment-clause) clause
+- [`ALTER DATABASE ... MODIFY COMMENT`](./database-comment.md)