Merge 'master' into ncb/fix-flake-02935

Author: bharatnc

README.md

@@ -47,14 +47,19 @@ Please feel free to reach out to tyler `<at>` clickhouse `<dot>` com.
 You can also peruse [ClickHouse Events](https://clickhouse.com/company/news-events) for a list of all upcoming trainings, meetups, speaking engagements, etc.
 
 Upcoming meetups
-* [Jakarta Meetup with AWS](https://www.meetup.com/clickhouse-indonesia-user-group/events/306973747/) - April 22, 2025
-* [Denver Meetup](https://www.meetup.com/clickhouse-denver-user-group/events/306934991/) - April 23, 2025
 * [Austin Meetup](https://www.meetup.com/clickhouse-austin-user-group/events/307289908) - May 13, 2025
 * [London Meetup](https://www.meetup.com/clickhouse-london-user-group/events/306047172/) - May 14, 2025
 * [Istanbul Meetup](https://www.meetup.com/clickhouse-turkiye-meetup-group/events/306978337/) - May 15, 2025
 * [Shenzhen Meetup](https://www.huodongxing.com/event/7803892350511) - May 17, 2025
+* [Seattle Meetup](https://www.meetup.com/clickhouse-seattle-user-group/events/307622716/) - May 20, 2025
+* [Washington DC Meetup](https://www.meetup.com/clickhouse-dc-user-group/events/307622954/) - June 12, 2025
+* [Atlanta Meetup](https://www.meetup.com/clickhouse-atlanta-meetup-group/events/307627590/) - July 8, 2025
+* [New York Meetup](https://www.meetup.com/clickhouse-new-york-user-group/events/307627675/) - July 15, 2025
+
 
 Recent meetups
+* [Denver Meetup](https://www.meetup.com/clickhouse-denver-user-group/events/306934991/) - April 23, 2025
+* [Jakarta Meetup with AWS](https://www.meetup.com/clickhouse-indonesia-user-group/events/306973747/) - April 22, 2025
 * [Kuala Lumper Meetup with CNCF](https://www.meetup.com/clickhouse-malaysia-meetup-group/events/306697678/) - April 16, 2025
 * [Tokyo Meetup with Confluent](https://www.meetup.com/clickhouse-tokyo-user-group/events/306832118/) - April 15, 2025
 * [Ho Chi Minh Meetup with AWS & Infinite Lambda](https://www.meetup.com/clickhouse-vietnam-meetup-group/events/306810105/) - April 12, 2025
@@ -73,12 +78,7 @@ Recent meetups
 * [Seattle Meetup](https://www.meetup.com/clickhouse-seattle-user-group/events/305916325) - March 5, 2025
 * [Paris Meetup](https://www.meetup.com/clickhouse-france-user-group/events/305792997) - March 4, 2025
 * [Shanghai Meetup](https://www.huodongxing.com/event/3794544969111?td=3894807410019) - March 1, 2025
-* [Singapore Meetup](https://www.meetup.com/clickhouse-singapore-meetup-group/events/305917892/) - Feb 25, 2025
-* [Los Angeles Meetup (with DevOpsDays)](https://www.meetup.com/clickhouse-los-angeles-user-group/events/305952193) - Feb 20, 2025
-* [Wellington Meetup](https://www.meetup.com/clickhouse-wellington-user-group/events/305666164/) - Feb 20, 2025
-* [Auckland Meetup](https://www.meetup.com/clickhouse-auckland-meetup-group/events/305666103/) - Feb 19, 2025
-* [Dubai Meetup](https://www.meetup.com/clickhouse-dubai-meetup-group/events/303096989/) - Feb 10, 2025
-* [Bangalore Meetup](https://www.meetup.com/clickhouse-bangalore-user-group/events/305497951/) - Feb 8, 2025
+
 
 
 

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

contrib/zlib-ng-cmake/CMakeLists.txt

@@ -1,4 +1,4 @@
-set (SOURCE_DIR ${PROJECT_SOURCE_DIR}/contrib/zlib-ng)
+set (SOURCE_DIR "${ClickHouse_SOURCE_DIR}/contrib/zlib-ng")
 
 add_definitions(-DZLIB_COMPAT)
 add_definitions(-DWITH_GZFILEOP)

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/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/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)

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

@@ -1,55 +1,76 @@
 ---
-description: 'Documentation for ALTER DATABASE ... MODIFY COMMENT Statements'
+description: 'Documentation for ALTER DATABASE ... MODIFY COMMENT statements
+which allow adding, modifying, or removing database comments.'
 slug: /sql-reference/statements/alter/database-comment
 sidebar_position: 51
-sidebar_label: 'UPDATE'
+sidebar_label: 'ALTER DATABASE ... MODIFY COMMENT'
 title: 'ALTER DATABASE ... MODIFY COMMENT Statements'
+keywords: ['ALTER DATABASE', 'MODIFY COMMENT']
 ---
 
 # ALTER DATABASE ... MODIFY COMMENT
 
-Adds, modifies, or removes comment to the database, regardless of whether it was set before. Comment change is reflected in both [system.databases](/operations/system-tables/databases.md) and `SHOW CREATE DATABASE` query.
+Adds, modifies, or removes a database comment, regardless of whether it was set
+before or not. The comment change is reflected in both [`system.databases`](/operations/system-tables/databases.md) 
+and the `SHOW CREATE DATABASE` query.
 
-**Syntax**
+## Syntax {#syntax}
 
 ``` sql
 ALTER DATABASE [db].name [ON CLUSTER cluster] MODIFY COMMENT 'Comment'
 ```
 
-**Examples**
+## Examples {#examples}
 
-Creating a DATABASE with comment (for more information, see the [COMMENT](/sql-reference/statements/create/table#comment-clause) clause):
+To create a `DATABASE` with a comment:
 
 ``` sql
 CREATE DATABASE database_with_comment ENGINE = Memory COMMENT 'The temporary database';
 ```
 
-Modifying the table comment:
+To modify the comment:
 
 ``` sql
-ALTER DATABASE database_with_comment MODIFY COMMENT 'new comment on a database';
-SELECT comment FROM system.databases WHERE name = 'database_with_comment';
+ALTER DATABASE database_with_comment 
+MODIFY COMMENT 'new comment on a database';
 ```
 
-Output of a new comment:
+To view the modified comment:
+
+```sql
+SELECT comment 
+FROM system.databases 
+WHERE name = 'database_with_comment';
+```
 
 ```text
 ┌─comment─────────────────┐
 │ new comment on database │
 └─────────────────────────┘
 ```
 
-Removing the database comment:
+To remove the database comment:
 
 ``` sql
-ALTER DATABASE database_with_comment MODIFY COMMENT '';
-SELECT comment FROM system.databases WHERE  name = 'database_with_comment';
+ALTER DATABASE database_with_comment 
+MODIFY COMMENT '';
 ```
 
-Output of a removed comment:
+To verify that the comment was removed:
 
-```text
+```sql title="Query"
+SELECT comment 
+FROM system.databases 
+WHERE  name = 'database_with_comment';
+```
+
+```text title="Response"
 ┌─comment─┐
 │         │
 └─────────┘
 ```
+
+## Related content {#related-content}
+
+- [`COMMENT`](/sql-reference/statements/create/table#comment-clause) clause
+- [`ALTER TABLE ... MODIFY COMMENT`](./comment.md)

docs/en/sql-reference/statements/select/all.md

@@ -7,15 +7,17 @@ title: 'ALL Clause'
 
 # ALL Clause
 
-If there are multiple matching rows in the table, then `ALL` returns all of them. `SELECT ALL` is identical to `SELECT` without `DISTINCT`. If both `ALL` and `DISTINCT` specified, exception will be thrown.
+If there are multiple matching rows in a table, then `ALL` returns all of them. `SELECT ALL` is identical to `SELECT` without `DISTINCT`. If both `ALL` and `DISTINCT` are specified, then an exception will be thrown.
 
+`ALL` can be specified inside aggregate functions, although it has no practical effect on the query's result.
 
-`ALL` can also be specified inside aggregate function with the same effect(noop), for instance:
+For example:
 
 ```sql
 SELECT sum(ALL number) FROM numbers(10);
 ```
-equals to
+
+Is equivalent to:
 
 ```sql
 SELECT sum(number) FROM numbers(10);