Skip to content

Commit 6786d70

Browse files
committed
move to " quotes
1 parent 630cbcb commit 6786d70

Some content is hidden

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

49 files changed

+158
-158
lines changed

docs/en/about-us/distinctive-features.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ description: Understand what makes ClickHouse stand apart from other database ma
99

1010
## True Column-Oriented Database Management System
1111

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.
1313

1414
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.
1515

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

6464
## Suitable for Online Queries {#suitable-for-online-queries}
6565

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").
6767

6868
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.
6969

docs/en/architecture/cluster-deployment.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ This ClickHouse cluster will be a homogenous cluster. Here are the steps:
1818
3. Create local tables on each instance
1919
4. Create a [Distributed table](../engines/table-engines/special/distributed.md)
2020

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.
2222

2323
Here is an example config for a cluster with three shards, with one replica each:
2424

docs/en/cloud/manage/backups.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ Database backups provide a safety net by ensuring that if data is lost for any u
1515

1616
## How backups work in ClickHouse Cloud
1717

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.
1919

2020
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.
2121

docs/en/cloud/manage/postman.md

+16-16
Original file line numberDiff line numberDiff line change
@@ -16,27 +16,27 @@ The Postman Application is available for use within a web browser or can be down
1616
![Create workspace](@site/docs/en/cloud/manage/images/postman/postman2.png)
1717

1818
### Create a Collection
19-
* Below Explore on the top left Menu click Import:
19+
* Below "Explore" on the top left Menu click "Import":
2020
![Explore > Import](@site/docs/en/cloud/manage/images/postman/postman3.png)
2121

2222
* A modal will appear:
2323
![API URL entry](@site/docs/en/cloud/manage/images/postman/postman4.png)
2424

25-
* Enter the API address: https://api.clickhouse.cloud/v1 and press 'Enter':
25+
* Enter the API address: "https://api.clickhouse.cloud/v1" and press 'Enter':
2626
![Import](@site/docs/en/cloud/manage/images/postman/postman5.png)
2727

28-
* Select Postman Collection by clicking on the Import button:
28+
* Select "Postman Collection" by clicking on the "Import" button:
2929
![Collection > Import](@site/docs/en/cloud/manage/images/postman/postman6.png)
3030

3131
### Interface with the ClickHouse Cloud API spec
32-
* The API spec for ClickHouse Cloud will now appear within Collections (Left Navigation).
32+
* The "API spec for ClickHouse Cloud" will now appear within "Collections" (Left Navigation).
3333
![Import your API](@site/docs/en/cloud/manage/images/postman/postman7.png)
3434

35-
* Click on API spec for ClickHouse Cloud. From the middle pain select the ‘Authorization’ tab:
35+
* Click on "API spec for ClickHouse Cloud." From the middle pain select the ‘Authorization’ tab:
3636
![Import complete](@site/docs/en/cloud/manage/images/postman/postman8.png)
3737

3838
### Set Authorization
39-
* Toggle the dropdown menu to select Basic Auth:
39+
* Toggle the dropdown menu to select "Basic Auth":
4040
![Basic auth](@site/docs/en/cloud/manage/images/postman/postman9.png)
4141

4242
* 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
4545
### Enable Variables
4646
* [Variables](https://learning.postman.com/docs/sending-requests/variables/) enable the storage and reuse of values in Postman allowing for easier API testing.
4747
#### 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:
5050
![Organization ID and Service ID](@site/docs/en/cloud/manage/images/postman/postman11.png)
5151

5252
## Test the ClickHouse Cloud API functionalities
5353
### 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:
5656
![Test retrieval of organizations](@site/docs/en/cloud/manage/images/postman/postman12.png)
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).
5858
![Status](@site/docs/en/cloud/manage/images/postman/postman13.png)
5959

6060
### Test "GET organizational details"
61-
* Under the organizationid folder, navigate to GET organizational details:
61+
* Under the organizationid folder, navigate to "GET organizational details":
6262
* In the middle frame menu under Params an organizationid is required.
6363
![Test retrieval of organization details](@site/docs/en/cloud/manage/images/postman/postman14.png)
6464
* Edit this value with "orgid" in curly braces "{{orgid}}" (From setting this value earlier a menu will appear with the value):
6565
![Submit test](@site/docs/en/cloud/manage/images/postman/postman15.png)
6666
* After pressing the "Save" button, press the blue "Send" button at the top right of the screen.
6767
![Return value](@site/docs/en/cloud/manage/images/postman/postman16.png)
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).
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).
6969

7070
### Test "GET service details"
71-
* Click GET service details
71+
* Click "GET service details"
7272
* 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.
7474
![List of services](@site/docs/en/cloud/manage/images/postman/postman17.png)
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).
7676

docs/en/cloud/reference/changelog.md

+8-8
Original file line numberDiff line numberDiff line change
@@ -323,7 +323,7 @@ Backups are important for every database (no matter how reliable), and we've tak
323323

324324
### Create APIs from your SQL queries (Beta)
325325

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).
327327

328328
<img alt="Configure query endpoints" style={{width: '450px', marginLeft: 0}} src={require('./images/may-17-query-endpoints.png').default} />
329329

@@ -335,7 +335,7 @@ There are 12 free training modules in ClickHouse Develop training course. Prior
335335

336336
### Load data from S3 and GCS using ClickPipes
337337

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.
339339

340340
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.
341341

@@ -399,7 +399,7 @@ This release introduces support for Microsoft Azure, Horizontal Scaling via API,
399399

400400
### General updates
401401
- 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).
403403

404404
### Administration changes
405405
- 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,
421421
- ClickHouse Python Client: [Added support](https://github.com/ClickHouse/clickhouse-connect/issues/155) for query streaming via PyArrow (community contribution)
422422

423423
### 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)
425425

426426
## March 14, 2024
427427

@@ -439,7 +439,7 @@ This release makes available in early access the new Cloud Console experience, C
439439

440440
### Integrations changes
441441
- 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
443443
- Kafka Connector: Fixed NPE in connection initialization, added ability to specify JDBC driver options
444444
- Golang client: Reduced the memory footprint for handling responses, fixed Date32 extreme values, fixed error reporting when compression is enabled
445445
- 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,
673673

674674
## Aug 24, 2023
675675

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.
677677

678678
### General updates
679679
- 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.
680680
- Introduced a new official PowerBI connector
681681

682682
### Console changes
683-
- Added support for Running Queries view in SQL Console
683+
- Added support for "Running Queries" view in SQL Console
684684

685685
### ClickHouse 23.7 version upgrade
686686
- 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
753753
- Improved caching while processing large inserts
754754

755755
### Administration changes
756-
- Expanded local dictionary creation for non default users
756+
- Expanded local dictionary creation for non "default" users
757757

758758
## May 30, 2023
759759

0 commit comments

Comments
 (0)