You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: docs/en/about-us/distinctive-features.md
+2-2
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,7 @@ description: Understand what makes ClickHouse stand apart from other database ma
9
9
10
10
## True Column-Oriented Database Management System
11
11
12
-
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.
12
+
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.
13
13
14
14
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.
15
15
@@ -63,7 +63,7 @@ Unlike other database management systems, secondary indexes in ClickHouse do not
63
63
64
64
## Suitable for Online Queries {#suitable-for-online-queries}
65
65
66
-
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”).
66
+
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").
67
67
68
68
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.
Copy file name to clipboardexpand all lines: docs/en/architecture/cluster-deployment.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -18,7 +18,7 @@ This ClickHouse cluster will be a homogenous cluster. Here are the steps:
18
18
3. Create local tables on each instance
19
19
4. Create a [Distributed table](../engines/table-engines/special/distributed.md)
20
20
21
-
A [distributed table](../engines/table-engines/special/distributed.md) is a kind of “view” to the local tables in a ClickHouse cluster. A SELECT query from a distributed table executes using resources of all cluster’s shards. You may specify configs for multiple clusters and create multiple distributed tables to provide views for different clusters.
21
+
A [distributed table](../engines/table-engines/special/distributed.md) is a kind of "view" to the local tables in a ClickHouse cluster. A SELECT query from a distributed table executes using resources of all cluster’s shards. You may specify configs for multiple clusters and create multiple distributed tables to provide views for different clusters.
22
22
23
23
Here is an example config for a cluster with three shards, with one replica each:
Copy file name to clipboardexpand all lines: docs/en/cloud/manage/backups.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ Database backups provide a safety net by ensuring that if data is lost for any u
15
15
16
16
## How backups work in ClickHouse Cloud
17
17
18
-
ClickHouse Cloud backups are a combination of “full” and “incremental” backups that constitute a backup chain. The chain starts with a full backup, and incremental backups are then taken over the next several scheduled time periods to create a sequence of backups. Once a backup chain reaches a certain length, a new chain is started. This entire chain of backups can then be utilized to restore data to a new service if needed. Once all backups included in a specific chain are past the retention timeframe set for the service (more on retention below), the chain is discarded.
18
+
ClickHouse Cloud backups are a combination of "full" and "incremental" backups that constitute a backup chain. The chain starts with a full backup, and incremental backups are then taken over the next several scheduled time periods to create a sequence of backups. Once a backup chain reaches a certain length, a new chain is started. This entire chain of backups can then be utilized to restore data to a new service if needed. Once all backups included in a specific chain are past the retention timeframe set for the service (more on retention below), the chain is discarded.
19
19
20
20
In the screenshot below, the solid line squares show full backups and the dotted line squares show incremental backups. The solid line rectangle around the squares denotes the retention period and the backups that are visible to the end user, which can be used for a backup restore. In the scenario below, backups are being taken every 24 hours and are retained for 2 days.
* Enter the Username and Password received when you set up your ClickHouse Cloud API keys:
@@ -45,32 +45,32 @@ The Postman Application is available for use within a web browser or can be down
45
45
### Enable Variables
46
46
*[Variables](https://learning.postman.com/docs/sending-requests/variables/) enable the storage and reuse of values in Postman allowing for easier API testing.
47
47
#### Set the Organization ID and Service ID
48
-
* Within the “Collection”, click the “Variable” tab in the middle pane (The Base URL will have been set by the earlier API import):
49
-
* Below “baseURL” click the open field “Add new value”, and Substitute your organization ID and service ID:
48
+
* Within the "Collection", click the "Variable" tab in the middle pane (The Base URL will have been set by the earlier API import):
49
+
* Below "baseURL" click the open field "Add new value", and Substitute your organization ID and service ID:
50
50

51
51
52
52
## Test the ClickHouse Cloud API functionalities
53
53
### Test "GET list of available organizations"
54
-
* Under the “OpenAPI spec for ClickHouse Cloud”, expand the folder > V1 > organizations
55
-
* Click “GET list of available organizations” and press the blue "Send" button on the right:
54
+
* Under the "OpenAPI spec for ClickHouse Cloud", expand the folder > V1 > organizations
55
+
* Click "GET list of available organizations" and press the blue "Send" button on the right:
56
56

57
-
* The returned results should deliver your organization details with “status”: 200. (If you receive a “status” 400 with no organization information your configuration is not correct).
57
+
* The returned results should deliver your organization details with "status": 200. (If you receive a "status" 400 with no organization information your configuration is not correct).
* The returned results should deliver your organization details with “status”: 200. (If you receive a “status” 400 with no organization information your configuration is not correct).
68
+
* The returned results should deliver your organization details with "status": 200. (If you receive a "status" 400 with no organization information your configuration is not correct).
69
69
70
70
### Test "GET service details"
71
-
* Click “GET service details”
71
+
* Click "GET service details"
72
72
* Edit the Values for organizationid and serviceid with {{orgid}} and {{serviceid}} respectively.
73
-
* Press “Save” and then the blue “Send” button on the right.
73
+
* Press "Save" and then the blue "Send" button on the right.
74
74

75
-
* The returned results should deliver a list of your services and their details with “status”: 200. (If you receive a “status” 400 with no service(s) information your configuration is not correct).
75
+
* The returned results should deliver a list of your services and their details with "status": 200. (If you receive a "status" 400 with no service(s) information your configuration is not correct).
Copy file name to clipboardexpand all lines: docs/en/cloud/reference/changelog.md
+8-8
Original file line number
Diff line number
Diff line change
@@ -323,7 +323,7 @@ Backups are important for every database (no matter how reliable), and we've tak
323
323
324
324
### Create APIs from your SQL queries (Beta)
325
325
326
-
When you write a SQL query for ClickHouse, you still need to connect to ClickHouse via a driver to expose your query to your application. Now with our now **Query Endpoints** feature, you can execute SQL queries directly from an API without any configuration. You can specify the query endpoints to return JSON, CSV, or TSVs. Click the “Share” button in the cloud console to try this new feature with your queries. Read more about Query Endpoints [here](https://clickhouse.com/blog/automatic-query-endpoints).
326
+
When you write a SQL query for ClickHouse, you still need to connect to ClickHouse via a driver to expose your query to your application. Now with our now **Query Endpoints** feature, you can execute SQL queries directly from an API without any configuration. You can specify the query endpoints to return JSON, CSV, or TSVs. Click the "Share" button in the cloud console to try this new feature with your queries. Read more about Query Endpoints [here](https://clickhouse.com/blog/automatic-query-endpoints).
@@ -335,7 +335,7 @@ There are 12 free training modules in ClickHouse Develop training course. Prior
335
335
336
336
### Load data from S3 and GCS using ClickPipes
337
337
338
-
You may have noticed in our newly released cloud console that there’s a new section called “Data sources”. The “Data sources” page is powered by ClickPipes, a native ClickHouse Cloud feature which lets you easily insert data from a variety of sources into ClickHouse Cloud.
338
+
You may have noticed in our newly released cloud console that there’s a new section called "Data sources". The "Data sources" page is powered by ClickPipes, a native ClickHouse Cloud feature which lets you easily insert data from a variety of sources into ClickHouse Cloud.
339
339
340
340
Our most recent ClickPipes update features the ability to directly upload data directly from Amazon S3 and Google Cloud Storage. While you can still use our built-in table functions, ClickPipes is a fully-managed service via our UI that will let you ingest data from S3 and GCS in just a few clicks. This feature is still in Private Preview, but you can try it out today via the cloud console.
341
341
@@ -399,7 +399,7 @@ This release introduces support for Microsoft Azure, Horizontal Scaling via API,
399
399
400
400
### General updates
401
401
- Introduced support for Microsoft Azure in Private Preview. To gain access, please reach out to account management or support, or join the [waitlist](https://clickhouse.com/cloud/azure-waitlist).
402
-
- Introduced Release Channels – the ability to specify the timing of upgrades based on environment type. In this release, we added the “fast” release channel, which enables you to upgrade your non-production environments ahead of production (please contact support to enable).
402
+
- Introduced Release Channels – the ability to specify the timing of upgrades based on environment type. In this release, we added the "fast" release channel, which enables you to upgrade your non-production environments ahead of production (please contact support to enable).
403
403
404
404
### Administration changes
405
405
- Added support for horizontal scaling configuration via API (private preview, please contact support to enable)
@@ -421,7 +421,7 @@ This release introduces support for Microsoft Azure, Horizontal Scaling via API,
421
421
- ClickHouse Python Client: [Added support](https://github.com/ClickHouse/clickhouse-connect/issues/155) for query streaming via PyArrow (community contribution)
422
422
423
423
### Security updates
424
-
- Updated ClickHouse Cloud to prevent [“Role-based Access Control is bypassed when query caching is enabled”](https://github.com/ClickHouse/ClickHouse/security/advisories/GHSA-45h5-f7g3-gr8r) (CVE-2024-22412)
424
+
- Updated ClickHouse Cloud to prevent ["Role-based Access Control is bypassed when query caching is enabled"](https://github.com/ClickHouse/ClickHouse/security/advisories/GHSA-45h5-f7g3-gr8r) (CVE-2024-22412)
425
425
426
426
## March 14, 2024
427
427
@@ -439,7 +439,7 @@ This release makes available in early access the new Cloud Console experience, C
439
439
440
440
### Integrations changes
441
441
- Grafana: Fixed dashboard migration for v4, ad-hoc filtering logic
442
-
- Tableau Connector: Fixed DATENAME function and rounding for “real” arguments
442
+
- Tableau Connector: Fixed DATENAME function and rounding for "real" arguments
443
443
- Kafka Connector: Fixed NPE in connection initialization, added ability to specify JDBC driver options
444
444
- Golang client: Reduced the memory footprint for handling responses, fixed Date32 extreme values, fixed error reporting when compression is enabled
445
445
- Python client: Improved timezone support in datetime parameters, improved performance for Pandas DataFrame
@@ -673,14 +673,14 @@ This release brings the beta release of the PowerBI Desktop official connector,
673
673
674
674
## Aug 24, 2023
675
675
676
-
This release adds support for the MySQL interface to the ClickHouse database, introduces a new official PowerBI connector, adds a new “Running Queries” view in the cloud console, and updates the ClickHouse version to 23.7.
676
+
This release adds support for the MySQL interface to the ClickHouse database, introduces a new official PowerBI connector, adds a new "Running Queries" view in the cloud console, and updates the ClickHouse version to 23.7.
677
677
678
678
### General updates
679
679
- Added support for the [MySQL wire protocol](https://clickhouse.com/docs/en/interfaces/mysql), which (among other use cases) enables compatibility with many existing BI tools. Please reach out to support to enable this feature for your organization.
680
680
- Introduced a new official PowerBI connector
681
681
682
682
### Console changes
683
-
- Added support for “Running Queries” view in SQL Console
683
+
- Added support for "Running Queries" view in SQL Console
684
684
685
685
### ClickHouse 23.7 version upgrade
686
686
- Added support for Azure Table function, promoted geo datatypes to production-ready, and improved join performance - see 23.5 release [blog](https://clickhouse.com/blog/clickhouse-release-23-05) for details
@@ -753,7 +753,7 @@ This release makes ClickHouse Cloud on GCP generally available, brings a Terrafo
753
753
- Improved caching while processing large inserts
754
754
755
755
### Administration changes
756
-
- Expanded local dictionary creation for non “default” users
756
+
- Expanded local dictionary creation for non "default" users
0 commit comments