Skip to content

Commit 308862b

Browse files
authored
Merge pull request #74 from ClickHouse/chloecdc-patch-2
Update cloud-quick-start.md
2 parents 7828478 + e58d69d commit 308862b

File tree

1 file changed

+47
-8
lines changed

1 file changed

+47
-8
lines changed

docs/en/cloud/get-started/cloud-quick-start.md

Lines changed: 47 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -54,13 +54,18 @@ By default, the scale tier will create 3 replicas each with 4 VCPUs and 16 GiB R
5454
Users can customize the service resources if required, specifying a minimum and maximum size for replicas to scale between. When ready, select `Create service`.
5555

5656
<div class="eighty-percent">
57-
![New ClickHouse Service](@site/docs/en/_snippets/images/scaling_limits.png)
57+
[Scaling Limits](@site/docs/en/_snippets/images/scaling_limits.png)
5858
</div>
5959
<br/>
6060

6161
Congratulations! Your ClickHouse Cloud service is up and running and onboarding is complete. Keep reading for details on how to start ingesting and querying your data.
6262

6363
## 2. Connect to ClickHouse
64+
There are 2 ways to connect to ClickHouse:
65+
- Connect using our web-based SQL console
66+
- Connect with your app
67+
68+
### Connect using SQL console
6469

6570
For getting started quickly, ClickHouse provides a web-based SQL console to which you will be redirected on completing onboarding.
6671

@@ -87,7 +92,43 @@ You should see 4 databases in the list, plus any that you may have added.
8792

8893
That's it - you are ready to start using your new ClickHouse service!
8994

90-
## 3. Create a database and table
95+
### Connect with your app
96+
97+
Press the connect button from the navigation menu. A modal will open offering the credentials to your service and offering you a set of instructions on how to connect with your interface or language clients.
98+
99+
<div class="eighty-percent">
100+
![Service Connect](@site/docs/en/_snippets/images/service_connect.png)
101+
</div>
102+
<br/>
103+
104+
If you can’t see your language client, you may want to check our list of [Integrations](https://clickhouse.com/docs/en/integrations).
105+
106+
## 3. Add data
107+
108+
ClickHouse is better with data! There are multiple ways to add data and most of them are available on the Data Sources page, which can be accessed in the navigation menu.
109+
110+
<div class="eighty-percent">
111+
![Data sources](@site/docs/en/_snippets/images/data_sources.png)
112+
</div>
113+
<br/>
114+
115+
You can upload data using the following methods:
116+
- Setup a ClickPipe to start ingesting data from data sources like S3, Postgres, Kafka, GCS
117+
- Use the SQL console
118+
- Use the ClickHouse client
119+
- Upload a file - accepted formats include JSON, CSV and TSV
120+
- Upload data from file URL
121+
122+
### ClickPipes
123+
124+
[ClickPipes](http://clickhouse.com/docs/en/integrations/clickpipes) is a managed integration platform that makes ingesting data from a diverse set of sources as simple as clicking a few buttons. Designed for the most demanding workloads, ClickPipes's robust and scalable architecture ensures consistent performance and reliability. ClickPipes can be used for long-term streaming needs or one-time data loading job.
125+
126+
<div class="eighty-percent">
127+
![Select data source](@site/docs/en/_snippets/images/select_data_source.png)
128+
</div>
129+
<br/>
130+
131+
### Add data using the SQL Console
91132

92133
Like most database management systems, ClickHouse logically groups tables into **databases**. Use the `CREATE DATABASE` command to create a new database in ClickHouse:
93134

@@ -125,7 +166,7 @@ The table engine determines:
125166
There are many engines to choose from, but for a simple table on a single-node ClickHouse server, [MergeTree](/en/engines/table-engines/mergetree-family/mergetree.md) is your likely choice.
126167
:::
127168

128-
### 3a. A Brief Intro to Primary Keys
169+
#### A Brief Intro to Primary Keys
129170

130171
Before you go any further, it is important to understand how primary keys work in ClickHouse (the implementation
131172
of primary keys might seem unexpected!):
@@ -143,7 +184,7 @@ then the key becomes the tuple specified in the `ORDER BY` clause. If you specif
143184
The primary key is also the sorting key, which is a tuple of `(user_id, timestamp)`. Therefore, the data stored in each
144185
column file will be sorted by `user_id`, then `timestamp`.
145186

146-
## 4. Insert Data
187+
#### Insert data into your table
147188

148189
You can use the familiar `INSERT INTO TABLE` command with ClickHouse, but it is important to understand that each insert into a `MergeTree` table causes a **part** to be created in storage.
149190

@@ -174,9 +215,7 @@ Let's verify it worked:
174215
SELECT * FROM helloworld.my_first_table
175216
```
176217

177-
You should see the four rows of data that were inserted:
178-
179-
## 5. Using the ClickHouse Client
218+
### Add data using the ClickHouse Client
180219

181220
You can also connect to your ClickHouse Cloud service using a command-line tool named [**clickhouse client**](/docs/en/interfaces/cli). Click `Connect` on the left menu to access these details. From the dialog select `Native` from the drop-down:
182221

@@ -253,7 +292,7 @@ Query id: 3604df1c-acfd-4117-9c56-f86c69721121
253292
exit
254293
```
255294

256-
## 6. Insert a CSV file
295+
### Upload a File
257296

258297
A common task when getting started with a database is to insert some data that you already have in files. We have some
259298
sample data online that you can insert that represents clickstream data - it includes a user ID, a URL that was visited, and

0 commit comments

Comments
 (0)