> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Вставка данных в ClickHouse Cloud с помощью clickhouse-client

> Узнайте, как с помощью clickhouse-client вставлять данные из локальных файлов CSV и Parquet в сервис ClickHouse Cloud через командную строку.

[All quickstarts](https://clickhouse.com/docs/get-started/quickstarts/home.md)

Real-time аналитикаХранилище данныхОбсервабилитиAI/MLCloud

## Предварительные требования

To successfully follow this guide, you'll need the following:

* A running ClickHouse Cloud service. If you don't have one yet, complete the [ClickHouse Cloud quick start](https://clickhouse.com/docs/get-started/setup/cloud.md) first.

Вам также следует пройти следующее руководство из раздела «Быстрый старт»:

* [Получите сведения о подключении к Cloud](https://clickhouse.com/docs/ru/get-started/quickstarts/obtain-your-cloud-connection-details.md) - для подключения вам понадобятся имя хоста, имя пользователя и пароль

## Что вы создадите

В этом руководстве из раздела «Быстрый старт» вы будете использовать **clickhouse-client** — официальный клиент ClickHouse для командной строки — чтобы загрузить данные из локального CSV-файла в сервис ClickHouse Cloud.
Вы установите clickhouse-client, подготовите пример набора данных, подключитесь к своему сервису ClickHouse Cloud, создадите таблицу и выполните вставку данных с локальной машины.
В итоге вы узнаете, как с помощью clickhouse-client загружать локальные файлы в ClickHouse Cloud — этот способ работает с CSV, Parquet, JSON и многими другими форматами.

### 1. Установите clickhouse-client

`clickhouse-client` — официальный CLI для подключения к ClickHouse. Он входит в состав бинарного файла ClickHouse.

Установите его с помощью универсального установщика:

```bash theme={null}
curl https://clickhouse.com/ | sh
```

Это скачает последний бинарный файл `clickhouse` в текущий каталог. Проверьте установку:

```bash theme={null}
./clickhouse client --version
```

Вы должны увидеть вывод с номером версии ClickHouse, подтверждающий, что `clickhouse-client` готов к работе.

### 2. Подготовьте небольшой CSV-файл для примера

Создайте небольшой CSV-файл, чтобы это руководство по быстрому запуску было самодостаточным. Выполните в терминале следующее:

```bash theme={null}
cat <<'EOF' > sample_data.csv
timestamp,event_type,user_id,duration_ms,status
2024-01-15 10:30:00,page_view,1001,120,success
2024-01-15 10:31:15,click,1002,45,success
2024-01-15 10:32:00,page_view,1003,200,success
2024-01-15 10:33:30,purchase,1001,1500,success
2024-01-15 10:34:00,click,1004,60,error
2024-01-15 10:35:45,page_view,1002,95,success
2024-01-15 10:36:10,purchase,1005,2200,success
2024-01-15 10:37:00,click,1003,30,success
2024-01-15 10:38:20,page_view,1004,150,error
2024-01-15 10:39:00,purchase,1002,1800,success
EOF
```

### 3. Подключитесь к своему сервису ClickHouse Cloud

Команды ниже предполагают, что вы экспортировали `CLICKHOUSE_HOST`, `CLICKHOUSE_USER` и `CLICKHOUSE_PASSWORD` в виде переменных окружения, как описано в руководстве быстрого старта [Получение сведений о подключении к Cloud](https://clickhouse.com/docs/ru/get-started/quickstarts/obtain-your-cloud-connection-details.md). Если нет, вы можете напрямую подставить свои значения.

Проверьте подключение, выполнив простой запрос к своему сервису ClickHouse Cloud:

```bash theme={null}
./clickhouse client \
  --host $CLICKHOUSE_HOST \
  --port 9440 \
  --user $CLICKHOUSE_USER \
  --password $CLICKHOUSE_PASSWORD \
  --secure \
  -q "SELECT 1"
```

Если подключение прошло успешно, в терминале будет выведено `1`. Если возникает ошибка подключения, проверьте, что ваш сервис запущен в консоли Cloud, а имя хоста и пароль указаны верно.

> [!NOTE]
>
> Порт `9440` — это защищённый порт собственного протокола для ClickHouse Cloud. Флаг `--secure` включает шифрование TLS. Это требуется для всех подключений к Cloud.

### 4. Создайте целевую таблицу и вставьте данные

Сначала создайте таблицу в вашем сервисе ClickHouse Cloud для приема данных:

```bash theme={null}
./clickhouse client \
  --host $CLICKHOUSE_HOST \
  --port 9440 \
  --user $CLICKHOUSE_USER \
  --password $CLICKHOUSE_PASSWORD \
  --secure \
  -q "
    CREATE TABLE IF NOT EXISTS events (
      timestamp DateTime,
      event_type LowCardinality(String),
      user_id UInt32,
      duration_ms UInt32,
      status LowCardinality(String)
    )
    ENGINE = MergeTree
    ORDER BY (event_type, timestamp)
  "
```

Теперь выполните вставку данных из локального CSV-файла. Это ключевой шаг — `clickhouse-client` читает файл из stdin и потоково передает его в удаленный сервис:

```bash theme={null}
./clickhouse client \
  --host $CLICKHOUSE_HOST \
  --port 9440 \
  --user $CLICKHOUSE_USER \
  --password $CLICKHOUSE_PASSWORD \
  --secure \
  -q "INSERT INTO events FORMAT CSVWithNames" < sample_data.csv
```

`clickhouse-client` напрямую отправляет содержимое CSV-файла в ваш сервис ClickHouse Cloud. Формат `CSVWithNames` указывает ClickHouse, что первая строка содержит заголовки столбцов.

### 5. Проверьте, что данные были вставлены

Выполните запрос к своему сервису ClickHouse Cloud, чтобы убедиться, что строки были вставлены:

```bash theme={null}
./clickhouse client \
  --host $CLICKHOUSE_HOST \
  --port 9440 \
  --user $CLICKHOUSE_USER \
  --password $CLICKHOUSE_PASSWORD \
  --secure \
  -q "SELECT count() FROM events"
```

Вы увидите `10` — это количество строк в примере CSV-файла.

Просмотрите данные:

```bash theme={null}
./clickhouse client \
  --host $CLICKHOUSE_HOST \
  --port 9440 \
  --user $CLICKHOUSE_USER \
  --password $CLICKHOUSE_PASSWORD \
  --secure \
  -q "SELECT * FROM events ORDER BY timestamp LIMIT 5"
```

Этот же процесс работает с Parquet, TSV, JSON, Avro, ORC и многими другими [поддерживаемыми форматами](https://clickhouse.com/docs/ru/reference/formats/index.md) — просто измените предложение `FORMAT` и передайте на вход соответствующий файл.

## Дальнейшие шаги

В этом руководстве по быстрому старту вы установили `clickhouse-client`, подключили его к сервису ClickHouse Cloud и с его помощью загрузили данные из локального CSV-файла в Cloud. Точно так же можно работать с Parquet, JSON и десятками других форматов.

Далее рекомендуем ознакомиться со следующими руководствами по быстрому старту:

* [Создание вашей первой таблицы MergeTree](https://clickhouse.com/docs/ru/get-started/quickstarts/create-your-first-mergetree-table.md)

Или углубитесь в справочную документацию:

* [Справочник по clickhouse-client](https://clickhouse.com/docs/ru/concepts/features/interfaces/client.md)
* [Поддерживаемые форматы ввода/вывода](https://clickhouse.com/docs/ru/reference/formats/index.md)

[![ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level](https://mintcdn.com/private-7c7dfe99/EDr8ydtGBgFPOQea/images/academy.webp?fit=max\&auto=format\&n=EDr8ydtGBgFPOQea\&q=85\&s=27e92fc656183cc2f176211907a7aa49)](https://learn.clickhouse.com/)

Check out the ClickHouse academy for on-demand and live training

[All quickstarts](https://clickhouse.com/docs/get-started/quickstarts/home.md)
