# Импорт CSV: как работает коннектор

В этой статье вы узнаете, как коннектор «Импорт CSV» загружает файл в хранилище ROMI center: какие есть ограничения, откуда берутся имена и типы колонок. Поля этого коннектора не описываются отдельной статьёй — колонки таблицы всегда те же, что и в вашем файле.

## Что выгружается: один файл — одна таблица

Подключение — это разовый импорт одного файла. Файл загружается в мастере, его строки ложатся в таблицу хранилища, и подключение получает статус «Завершено». Синхронизации нет: изменения в исходном файле в хранилище не попадают.

Первая строка файла становится названиями колонок, остальные — строками таблицы. Совсем пустая строка пропускается, а строка из одних разделителей (`;;;`) попадает в таблицу строкой пустых значений.

> **Важно**
> Имя таблицы — имя файла латиницей, без номера подключения: «Заказы 2026.csv» даёт `zakazy_2026`. Если в хранилище уже есть таблица с таким именем — от прошлого импорта или другого коннектора, — загрузка остановится с ошибкой «Таблица … уже существует». Не импортируйте два одноимённых файла одновременно: второй затрёт таблицу первого.

> **Примечание**
> Слово `reklama` между подчёркиваниями в имени таблицы (например, из файла «Отчёт реклама Март.csv» получится `otchet_reklama_mart`) режут блокировщики рекламы, и «Просмотр данных» такой таблицы у пользователя с блокировщиком не откроется. Лучше переименовать файл до загрузки.

## Периодичность

Периодичности нет: данные загружаются один раз, в момент сохранения подключения. В меню подключения только «Удалить подключение» — ни «Редактировать», ни «Приостановить выгрузку», ни «Загрузить исторические данные».

## Ограничения

| Что | Ограничение |
| --- | --- |
| Формат | только `.csv` в кодировке UTF-8, метка BOM допускается. Файл с кириллицей в другой кодировке (например Windows-1251) отклоняется с ошибкой. |
| Размер файла | до 100 МБ. |
| Разделитель | `,` или `;` — определяется сам по первой строке. |
| Число импортов | до 10 на проект (считаются завершённые и не удалённые). |
| Тариф | импорт бесплатный и в лимит подключений тарифа не входит. |

> **Важно**
> Разделитель определяется по первой строке: `;` выбирается, если точек с запятой в ней больше, чем запятых, иначе `,`. Запятые внутри заголовков в кавычках тоже считаются — у файла с разделителем `;` и заголовками `"Сумма, руб.";"Дата"` разделитель определится как `,`, и колонки разберутся неверно.

## Как сохраняет данные

*   **Куда:** хранилище ROMI center на движке ClickHouse. Хранилище на PostgreSQL CSV-импорт не поддерживает — сохранение подключения закончится ошибкой.
*   **Таблица создаётся при сохранении подключения**, файл записывается в неё целиком.
*   **Структура:** движок `MergeTree`, без разбиения на партиции и без ключа сортировки.
*   **Колонки берутся из первой строки** и сопоставляются с данными по позиции.
*   **Обновить данные нельзя.** Чтобы загрузить новую версию файла, удалите подключение и импортируйте файл заново — удаление подключения удаляет и таблицу.

## Настройки

| Шаг мастера | Что делается |
| --- | --- |
| «Доступ» | Загрузка файла — перетаскиванием или выбором. Мастер показывает размер, число строк, разделитель, число колонок и имя таблицы. |
| «Выбор полей» | Какие колонки импортировать: по умолчанию отмечены все. Тип каждой колонки определён автоматически и не меняется. |

После импорта подключение не редактируется: выбрать другие колонки можно только новым импортом.

## Имена колонок

| Заголовок в файле | Колонка в таблице |
| --- | --- |
| Текст | Транслитерация в нижнем регистре, только латиница, цифры и `_`: «Дата» → `data`. Пробел становится `_`, а дефис, точка и запятая выбрасываются: «UTM-метка» → `utmmetka`. |
| Начинается с цифры | С префиксом `col_`: «2026 план» → `col_2026_plan`. |
| Пустой | `col_`, следующий пустой — `col__2`. |
| Повторяется | Суффикс `_2`, `_3` по порядку колонок. |

Подписью колонки в «Просмотре данных» остаётся исходный заголовок.

## Типы колонок

Тип определяется по непустым значениям первых 1000 строк и дальше не меняется:

| Тип | Тип поля | Когда выбирается |
| --- | --- | --- |
| Целое число | Целое число | все значения — целые числа без пробелов и ведущего нуля, не длиннее 18 цифр |
| Дробное число | Дробное число | все значения — числа, и хотя бы у одного есть дробная часть через точку или запятую |
| Дата | Дата | все значения в формате `2026-09-20` |
| Дата и время | Дата и время | все значения в формате `2026-09-20 14:05` или `2026-09-20T14:05:33` |
| Строка | Строка | всё остальное, в том числе пустая колонка |

> **Важно**
> Даты в русском формате остаются строкой. `20.09.2026`, `20/09/2026` и любые другие форматы, кроме `2026-09-20`, дают строковую колонку. Так же строкой становятся числа с пробелами (`1 234`), знаком процента (`12%`), валютой и ведущим нулём (`007`).

> **Важно**
> Строки после первой тысячи тип не проверяют — значения к нему приводятся. Если в целочисленной колонке дальше встретится `abc` или прочерк «-», запишется 0, `12.5` станет 12, а «1 234» — 1. В колонке даты значение в другом формате разбирается как получится: `20.09.2026` запишется верно, а `01.02.26` и `15.03` станут датой импорта. В колонке даты всё раньше 1970 года станет `1970-01-01`, всё позже 2149 года — `2149-06-06`.