Skip to content

Commit 96245af

Browse files
committed
Merge branch 'main' of https://github.com/ClickHouse/clickhouse-docs into Blargian-patch-482828
2 parents ea66a7a + 004bb32 commit 96245af

File tree

132 files changed

+5044
-855
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

132 files changed

+5044
-855
lines changed

.github/CODEOWNERS

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
* @ClickHouse/docs
2-
/docs/integrations/data-ingestion/clickpipes/ @ClickHouse/clickpipes @ClickHouse/docs
32
/docs/integrations/ @ClickHouse/integrations-ecosystem @ClickHouse/docs
3+
/docs/integrations/data-ingestion/clickpipes/ @ClickHouse/clickpipes @ClickHouse/docs

.github/workflows/trademark-cla-approval.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ jobs:
1515
- name: Generate Token
1616
id: generate-token
1717
continue-on-error: true
18-
uses: actions/create-github-app-token@v1
18+
uses: actions/create-github-app-token@v2
1919
with:
2020
app-id: "${{ secrets.WORKFLOW_AUTH_PUBLIC_APP_ID }}"
2121
private-key: "${{ secrets.WORKFLOW_AUTH_PUBLIC_PRIVATE_KEY }}"

.github/workflows/trademark-cla-notice.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ jobs:
1919
- name: Generate Token
2020
id: generate-token
2121
continue-on-error: true
22-
uses: actions/create-github-app-token@v1
22+
uses: actions/create-github-app-token@v2
2323
with:
2424
app-id: "${{ secrets.WORKFLOW_AUTH_PUBLIC_APP_ID }}"
2525
private-key: "${{ secrets.WORKFLOW_AUTH_PUBLIC_PRIVATE_KEY }}"

docs/about-us/adopters.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -334,6 +334,7 @@ The following list of companies using ClickHouse and their success stories is as
334334
| [Neocom](https://www.neocom.ai/) | AI SaaS | Main product | [Job listing](https://news.ycombinator.com/item?id=38497724) |||
335335
| [Neocom](https://www.neocom.ai/) | Software & Technology | Sales Platform | [Hacker News, September 2023](https://news.ycombinator.com/item?id=37359122) |||
336336
| [NeonDB](https://neon.tech/) | Cloud | Postgres management | [Blog, 2024](https://double.cloud/resources/case—studies/neon—increases—data—granularity—with—managed—clickhouse/) |||
337+
| [NetApp Instaclustr](https://www.instaclustr.com/platform/managed-clickhouse/) | Cloud Storage | Analytics | [Documentation](https://www.instaclustr.com/support/documentation/clickhouse/getting-started-with-clickhouse/creating-a-clickhouse-cluster/) |||
337338
| [NetMeta](https://github.com/monogon—dev/NetMeta/blob/main/README.md) | Observability | Main Product | [Twitter, December 2022](https://twitter.com/leolukde/status/1605643470239977475) |||
338339
| [Netflix](https://www.netflix.com/) | Software & Technology | Video Streaming | [Meetup, March 2025](https://youtu.be/64TFG_Qt5r4) |||
339340
| [Netskope](https://www.netskope.com/) | Network Security || [Job advertisement, March 2021](https://www.mendeley.com/careers/job/senior—software—developer—backend—developer—1346348) |||

docs/about-us/distinctive-features.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,15 @@ keywords: ['compression', 'secondary-indexes','column-oriented']
1313

1414
In a real column-oriented DBMS, no extra data is stored with the values. This means that constant-length values must be supported to avoid storing their length "number" next to the values. For example, a billion UInt8-type values should consume around 1 GB uncompressed, or this strongly affects the CPU use. It is essential to store data compactly (without any "garbage") even when uncompressed since the speed of decompression (CPU usage) depends mainly on the volume of uncompressed data.
1515

16-
This is in contrast to systems that can store values of different columns separately, but that cannot effectively process analytical queries due to their optimization for other scenarios, such as HBase, Bigtable, Cassandra, and Hypertable. You would get throughput around a hundred thousand rows per second in these systems, but not hundreds of millions of rows per second.
16+
This is in contrast to systems that can store values of different columns separately, but that cannot effectively process analytical queries due to their optimization for other scenarios, such as HBase, Bigtable, Cassandra, and Hypertable. You would get throughput of around a hundred thousand rows per second in these systems, but not hundreds of millions of rows per second.
1717

1818
Finally, ClickHouse is a database management system, not a single database. It allows creating tables and databases in runtime, loading data, and running queries without reconfiguring and restarting the server.
1919

2020
## Data compression {#data-compression}
2121

2222
Some column-oriented DBMSs do not use data compression. However, data compression plays a key role in achieving excellent performance.
2323

24-
In addition to efficient general-purpose compression codecs with different trade-offs between disk space and CPU consumption, ClickHouse provides [specialized codecs](/sql-reference/statements/create/table.md#specialized-codecs) for specific kinds of data, which allow ClickHouse to compete with and outperform more niche databases, like time-series ones.
24+
In addition to efficient general-purpose compression codecs with different trade-offs between disk space and CPU consumption, ClickHouse provides [specialized codecs](/sql-reference/statements/create/table.md#specialized-codecs) for specific kinds of data, which allows ClickHouse to compete with and outperform more niche databases, like time-series ones.
2525

2626
## Disk storage of data {#disk-storage-of-data}
2727

@@ -41,9 +41,9 @@ In ClickHouse, data can reside on different shards. Each shard can be a group of
4141

4242
## SQL support {#sql-support}
4343

44-
ClickHouse supports [SQL language](/sql-reference/) that is mostly compatible with the ANSI SQL standard.
44+
ClickHouse supports [a declarative query language](/sql-reference/) based on SQL that is mostly compatible with the ANSI SQL standard.
4545

46-
Supported queries include [GROUP BY](../sql-reference/statements/select/group-by.md), [ORDER BY](../sql-reference/statements/select/order-by.md), subqueries in [FROM](../sql-reference/statements/select/from.md), [JOIN](../sql-reference/statements/select/join.md) clause, [IN](../sql-reference/operators/in.md) operator, [window functions](../sql-reference/window-functions/index.md) and scalar subqueries.
46+
Supported queries include [GROUP BY](../sql-reference/statements/select/group-by.md), [ORDER BY](../sql-reference/statements/select/order-by.md), subqueries in [FROM](../sql-reference/statements/select/from.md), the [JOIN](../sql-reference/statements/select/join.md) clause, the [IN](../sql-reference/operators/in.md) operator, [window functions](../sql-reference/window-functions/index.md) and scalar subqueries.
4747

4848
Correlated (dependent) subqueries are not supported at the time of writing but might become available in the future.
4949

@@ -67,7 +67,7 @@ Unlike other database management systems, secondary indexes in ClickHouse do not
6767

6868
Most OLAP database management systems do not aim for online queries with sub-second latencies. In alternative systems, report building time of tens of seconds or even minutes is often considered acceptable. Sometimes it takes even more time, which forces systems to prepare reports offline (in advance or by responding with "come back later").
6969

70-
In ClickHouse "low latency" means that queries can be processed without delay and without trying to prepare an answer in advance, right at the same moment as the user interface page is loading. In other words, online.
70+
In ClickHouse, "low latency" means that queries can be processed without delay and without trying to prepare an answer in advance, right at the moment when the user interface page is loading — in other words, *online*.
7171

7272
## Support for approximated calculations {#support-for-approximated-calculations}
7373

@@ -79,7 +79,7 @@ ClickHouse provides various ways to trade accuracy for performance:
7979

8080
## Adaptive join algorithm {#adaptive-join-algorithm}
8181

82-
ClickHouse adaptively chooses how to [JOIN](../sql-reference/statements/select/join.md) multiple tables, by preferring hash-join algorithm and falling back to the merge-join algorithm if there's more than one large table.
82+
ClickHouse adaptively chooses how to [JOIN](../sql-reference/statements/select/join.md) multiple tables, by preferring hash join and falling back to merge join if there's more than one large table.
8383

8484
## Data replication and data integrity support {#data-replication-and-data-integrity-support}
8585

@@ -89,7 +89,7 @@ For more information, see the section [Data replication](../engines/table-engine
8989

9090
## Role-Based Access Control {#role-based-access-control}
9191

92-
ClickHouse implements user account management using SQL queries and allows for [role-based access control configuration](/guides/sre/user-management/index.md) similar to what can be found in ANSI SQL standard and popular relational database management systems.
92+
ClickHouse implements user account management using SQL queries and allows for [role-based access control configuration](/guides/sre/user-management/index.md) similar to what can be found in the ANSI SQL standard and popular relational database management systems.
9393

9494
## Features that can be considered disadvantages {#clickhouse-features-that-can-be-considered-disadvantages}
9595

0 commit comments

Comments
 (0)