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

# Загрузка файлов в Cloud

> Узнайте, как загрузить файлы в Cloud

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

ClickHouse Cloud предоставляет простой способ импортировать файлы и поддерживает
следующие форматы:

| Формат                          |
| ------------------------------- |
| `CSV`                           |
| `CSVWithNamesAndTypes`          |
| `CSVWithNames`                  |
| `JSONEachRow`                   |
| `TabSeparated`                  |
| `TabSeparatedWithNames`         |
| `TabSeparatedWithNamesAndTypes` |

<Steps>
  <Step title="Загрузите файл" id="upload-file">
    На главной странице Cloud выберите свой сервис, как показано ниже:

    <Image img="https://mintcdn.com/private-7c7dfe99/96hCVnfqPOLWGWdD/images/cloud/migrate/csv_01.webp?fit=max&auto=format&n=96hCVnfqPOLWGWdD&q=85&s=761f8fbb5a039818bdc4af4abca8fb93" alt="upload_file_02" width="3024" height="1483" data-path="images/cloud/migrate/csv_01.webp" />

    Если ваш сервис бездействует, его нужно будет вывести из спящего режима.

    Выберите `Data sources` на вкладке слева, как показано ниже:

    <Image img="https://mintcdn.com/private-7c7dfe99/96hCVnfqPOLWGWdD/images/cloud/migrate/csv_02.webp?fit=max&auto=format&n=96hCVnfqPOLWGWdD&q=85&s=5544d863af2adf43a7b4ca21d2bbefb6" alt="upload_file_03" width="3024" height="1483" data-path="images/cloud/migrate/csv_02.webp" />

    Затем в правой части страницы источников данных выберите `Upload a file`:

    <Image img="https://mintcdn.com/private-7c7dfe99/96hCVnfqPOLWGWdD/images/cloud/migrate/csv_03.webp?fit=max&auto=format&n=96hCVnfqPOLWGWdD&q=85&s=7ca141db54a34b6fcb7b64fb1fcc361a" alt="upload_file_04" width="3024" height="1483" data-path="images/cloud/migrate/csv_03.webp" />

    Откроется диалоговое окно выбора файла, в котором вы сможете выбрать файл для
    вставки данных в таблицу вашего сервиса Cloud.

    <Image img="https://mintcdn.com/private-7c7dfe99/96hCVnfqPOLWGWdD/images/cloud/migrate/csv_04.webp?fit=max&auto=format&n=96hCVnfqPOLWGWdD&q=85&s=7f9bca5a28d0b4dc13933730035aa6e1" alt="upload_file_05" width="1267" height="736" data-path="images/cloud/migrate/csv_04.webp" />
  </Step>

  <Step title="Настройте таблицу" id="configure-table">
    После загрузки файла вы сможете настроить таблицу, в которую хотите
    вставить данные. Также будет показан предварительный просмотр таблицы с первыми тремя строками.

    <Image img="https://mintcdn.com/private-7c7dfe99/96hCVnfqPOLWGWdD/images/cloud/migrate/csv_08.webp?fit=max&auto=format&n=96hCVnfqPOLWGWdD&q=85&s=18ff31278410be6fa2bcf6e4b7249abf" alt="upload_file_08" width="3018" height="1476" data-path="images/cloud/migrate/csv_08.webp" />

    Теперь вы можете выбрать целевую таблицу. Доступны следующие варианты:

    * новая таблица
    * существующая таблица

    <br />

    Вы можете указать, в какую базу данных загрузить данные, а в случае
    новой таблицы — имя таблицы, которая будет создана. Также вы сможете выбрать ключ сортировки:

    <Image img="https://mintcdn.com/private-7c7dfe99/96hCVnfqPOLWGWdD/images/cloud/migrate/csv_05.webp?fit=max&auto=format&n=96hCVnfqPOLWGWdD&q=85&s=7f2f52992d289d50a8cebf78829b8f0f" alt="upload_file_05" width="3016" height="1474" data-path="images/cloud/migrate/csv_05.webp" />

    Столбцы, считанные из файла, отображаются как `Source field`, и для каждого поля
    вы можете изменить:

    * автоматически определённый тип
    * значение по умолчанию
    * сделать ли столбец [Nullable](/docs/ru/reference/data-types/nullable)

    <Image img="https://mintcdn.com/private-7c7dfe99/96hCVnfqPOLWGWdD/images/cloud/migrate/csv_06.webp?fit=max&auto=format&n=96hCVnfqPOLWGWdD&q=85&s=56960a2be3b06953dd684d098441d108" alt="upload_file_06" width="3012" height="1476" data-path="images/cloud/migrate/csv_06.webp" />

    <Info>
      **Исключение полей**

      Вы также можете удалить поле, если не хотите включать его в импорт
    </Info>

    Вы можете указать, какой движок таблицы хотите использовать:

    * `MergeTree`
    * `ReplacingMergeTree`
    * `SummingMergeTree`
    * `Null`

    <br />

    Вы можете указать выражение ключа партиционирования и выражение первичного
    ключа.

    <Image img="https://mintcdn.com/private-7c7dfe99/96hCVnfqPOLWGWdD/images/cloud/migrate/csv_07.webp?fit=max&auto=format&n=96hCVnfqPOLWGWdD&q=85&s=f9b7401acd4785f9e8c407b2e4d9cb1b" alt="upload_file_07" width="3004" height="1476" data-path="images/cloud/migrate/csv_07.webp" />

    Нажмите `Import to ClickHouse` (показано выше), чтобы импортировать данные. Импорт будет поставлен в очередь, что
    обозначается значком статуса `queued` в столбце `Status`, как показано ниже. Вы также можете нажать
    `Open as query` (показано выше), чтобы открыть запрос на вставку в SQL-консоли. Этот запрос выполнит вставку
    файла, который был загружен в S3 бакет с помощью табличной функции `URL`.

    <Image img="https://mintcdn.com/private-7c7dfe99/96hCVnfqPOLWGWdD/images/cloud/migrate/csv_09.webp?fit=max&auto=format&n=96hCVnfqPOLWGWdD&q=85&s=506ad6ab84629eef0d02229d4502ea03" alt="upload_file_09" width="1271" height="487" data-path="images/cloud/migrate/csv_09.webp" />

    Если задание завершится с ошибкой, вы увидите значок статуса `failed` в столбце `Status` на
    вкладке `Data upload history`. Вы можете нажать `View Details`, чтобы получить больше информации
    о причине сбоя загрузки. В зависимости от сообщения об ошибке для неудавшейся вставки
    вам может потребоваться изменить настройки таблицы или очистить данные.

    <Image img="https://mintcdn.com/private-7c7dfe99/96hCVnfqPOLWGWdD/images/cloud/migrate/csv_10.webp?fit=max&auto=format&n=96hCVnfqPOLWGWdD&q=85&s=db1272a4d7a37a6488c66aeabb42c580" alt="upload_file_11" width="1260" height="262" data-path="images/cloud/migrate/csv_10.webp" />
  </Step>
</Steps>
