Skip to content

Cloud: update csv file load page #4014

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jul 4, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
113 changes: 113 additions & 0 deletions docs/cloud/migrate/upload-a-csv-file.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,113 @@
---
title: 'Uploading files'
slug: /cloud/migrate/upload-a-csv-file
description: 'Learn how to upload files to Cloud'
---

import Image from '@theme/IdealImage';
import csv_01 from '@site/static/images/cloud/migrate/csv_01.png';
import csv_02 from '@site/static/images/cloud/migrate/csv_02.png';
import csv_03 from '@site/static/images/cloud/migrate/csv_03.png';
import csv_04 from '@site/static/images/cloud/migrate/csv_04.png';
import csv_05 from '@site/static/images/cloud/migrate/csv_05.png';
import csv_06 from '@site/static/images/cloud/migrate/csv_06.png';
import csv_07 from '@site/static/images/cloud/migrate/csv_07.png';
import csv_08 from '@site/static/images/cloud/migrate/csv_08.png';
import csv_09 from '@site/static/images/cloud/migrate/csv_09.png';
import csv_10 from '@site/static/images/cloud/migrate/csv_10.png';

# Upload files to Cloud

ClickHouse Cloud provides an easy way to import your files and supports the
following formats:

| Format |
|---------------------------------|
| `CSV` |
| `CSVWithNamesAndTypes` |
| `CSVWithNames` |
| `JSONEachRow` |
| `TabSeparated` |
| `TabSeparatedWithNames` |
| `TabSeparatedWithNamesAndTypes` |

<VerticalStepper headerLevel="h2">

## Upload a file {#upload-file}

From the Cloud homepage, select your service as shown below:

<Image img={csv_01} alt="upload_file_02" />

If your service is idle you will need to wake it.

Select `Data sources` in the left hand tab as shown below:

<Image img={csv_02} alt="upload_file_03" />

Next select `Upload a file` on the right side of the data sources page:

<Image img={csv_03} alt="upload_file_04" />

A file dialogue will pop up allowing you to select the file that you wish to
use to insert data into a table on your Cloud service.

<Image img={csv_04} alt="upload_file_05" />

## Configure table {#configure-table}

Once the file has uploaded you will be able to configure the table where you want
to insert the data to. A preview of the table with the first three rows is shown.

<Image img={csv_08} alt="upload_file_08" />

You can now select a destination table. The options are:

- a new table
- an existing table

<br/>
You can specify which database you want to upload the data to, and in the case of
a new table, the name of the table that will be created. You will also be able to select the sorting key:

<Image img={csv_05} alt="upload_file_05" />

Columns read from the file are shown as `Source field`s and for each field, you
can change:
- the inferred type
- the default value
- whether to make the column [Nullable](/sql-reference/data-types/nullable) or not

<Image img={csv_06} alt="upload_file_06" />

:::note Excluding fields
You can also remove a field if you don't want to include it in the import
:::

You can specify the type of table engine that you want to use:

- `MergeTree`
- `ReplacingMergeTree`
- `SummingMergeTree`
- `Null`
<br/>
You can specify a partitioning key expression and primary
key expression.

<Image img={csv_07} alt="upload_file_07" />

Click `Import to ClickHouse` (shown above) to import the data. The data import will be queued as
indicated by the `queued` status badge in the `Status` column as shown below. You can also click
`Open as query` (shown above) to open the insert query in the SQL console. The query will insert
the file which was uploaded to an S3 bucket using the `URL` table function.

<Image img={csv_09} alt="upload_file_09" />

If the job fails you will see a `failed` status badge under the `Status` column of
the `Data upload history` tab. You can click `View Details` for more information
on why the upload failed. You may need to modify the table configuration or clean
the data based on the error message for the failed insert.

<Image img={csv_10} alt="upload_file_11" />

</VerticalStepper>
6 changes: 3 additions & 3 deletions docs/integrations/migration/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,11 @@
This section of the docs explores how you can migrate from ClickHouse to ClickHouse Cloud.
Take a look at the pages below for further information.

| Page | Description |
|----------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
| Page | Description |
|--------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Overview](/integrations/migration/overview) | Provides an overview of the available ways to migrate from ClickHouse to ClickHouse Cloud |
| [Migrating to ClickHouse using clickhouse-local](/cloud/migration/clickhouse-local) | Learn how to migrate to ClickHouse using clickhouse-local. | |
| [ClickHouse to ClickHouse Cloud](/cloud/migration/clickhouse-to-cloud) | This guide will show how to migrate from a self-managed ClickHouse server to ClickHouse Cloud, and also how to migrate between ClickHouse Cloud services. |
| [Using a 3rd-party ETL Tool](/cloud/migration/etl-tool-to-clickhouse) | Learn more about the popular ETL and ELT tools for moving data from an external data source into ClickHouse. |
| [Object Storage to ClickHouse Cloud](/integrations/migration/object-storage-to-clickhouse) | Learn how to use various table functions to import data from Cloud Object Storage into ClickHouse Cloud. |
| [Upload a CSV File](/integrations/migration/upload-a-csv-file) | Learn how to upload data to ClickHouse Cloud using a CSV or TSV file. |
| [Upload a CSV File](/cloud/migrate/upload-a-csv-file) | Learn how to upload data to ClickHouse Cloud using a CSV or TSV file. |

Check notice on line 20 in docs/integrations/migration/index.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.Uppercase

Suggestion: Instead of uppercase for 'TSV', use lowercase or backticks (`) if possible. Otherwise, ask a Technical Writer to add this word or acronym to the rule's exception list.
39 changes: 0 additions & 39 deletions docs/integrations/migration/upload-a-csv-file.md

This file was deleted.

2 changes: 1 addition & 1 deletion sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -483,7 +483,7 @@ const sidebars = {
"integrations/migration/clickhouse-local-etl",
"integrations/migration/etl-tool-to-clickhouse",
"integrations/migration/object-storage-to-clickhouse",
"integrations/migration/upload-a-csv-file",
"cloud/migrate/upload-a-csv-file",
],
},
],
Expand Down
Binary file added static/images/cloud/migrate/csv_01.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/cloud/migrate/csv_02.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/cloud/migrate/csv_03.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/cloud/migrate/csv_04.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/cloud/migrate/csv_05.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/cloud/migrate/csv_06.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/cloud/migrate/csv_07.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/cloud/migrate/csv_08.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/cloud/migrate/csv_09.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/cloud/migrate/csv_10.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
11 changes: 8 additions & 3 deletions vercel.json
Original file line number Diff line number Diff line change
Expand Up @@ -3357,9 +3357,14 @@
"permanent": true
},
{
"source" : "/docs/getting-started/quick-start",
"destination" : "/docs/get-started/quick-start",
"permanent" : true
"source": "/docs/getting-started/quick-start",
"destination": "/docs/get-started/quick-start",
"permanent": true
},
{
"source": "/docs/integrations/migration/upload-a-csv-file",
"destination": "/docs/cloud/migrate/upload-a-csv-file",
"permanent": true
}
]
}