# Google Таблицы: как работает коннектор

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

> **Примечание**
> Здесь описана новая форма подключения — с выбором нескольких листов файла, которую с 7 сентября 2026 года создаёт мастер подключения в кабинете. Подключения старой формы с одним листом здесь не рассматриваются, как и отдельный коннектор расходов из Google Sheets.

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

Подключение — это один файл Google Таблиц по ссылке. На шаге «Доступ» в нём отмечаются листы, и каждый отмеченный лист выгружается в свою таблицу хранилища. Первая строка листа становится названиями колонок, остальные — строками таблицы; полностью пустая строка пропускается.

> **Важно**
> Таблица — точный снимок листа. При каждой синхронизации лист читается целиком, и таблица собирается заново: удалённые в листе строки из неё пропадают, исправленные — меняются. Истории изменений нет.

Коннектор файл только читает. Имя таблицы — `gsc_<название листа латиницей>_<id подключения>`; фиксируется, когда лист добавлен, переименование листа меняет только подпись. Слова `reklama` и `ads` в имени заменяются на `rkl` — их режут блокировщики рекламы.

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

Все включённые листы синхронизируются каждые 3 часа (в 00:00, 03:00, 06:00 и так далее), задание на лист. Первая выгрузка нового листа идёт сразу после сохранения подключения.

> **Примечание**
> Синхронизации Google Таблиц идут по одной за раз на всю систему. Синхронизация пропускается, если истекла лицензия проекта, у подключения ошибка доступа к Google-аккаунту, хранилище в ошибке доступа или нажато «Приостановить выгрузку» — когда причина уходит, следующая синхронизация снова забирает листы целиком, так что пропуск ничего не теряет.

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

*   **Куда:** хранилище ROMI center на движке ClickHouse (поддерживается также хранилище на PostgreSQL).
*   **Пересборка без пустого окна.** Лист записывается во временную таблицу, и та меняется местами с рабочей — запрос во время синхронизации видит либо старую версию таблицы, либо новую, но никогда не пустую и не половину.
*   **Структура:** движок `MergeTree`, без разбиения на партиции и без ключа сортировки.
*   **Колонки сопоставляются по заголовку, а не по позиции:** вставка или перестановка столбцов в листе значения не сдвигает.

## Что будет, если поменять файл в Google

| Что поменяли | Что будет в хранилище |
| --- | --- |
| Добавили колонку | Сама в таблицу не попадёт — её нужно отметить на шаге «Выбор полей». |
| Удалили колонку | Колонка остаётся и заполняется пустыми значениями, пока её не снимут на шаге «Выбор полей». |
| Переименовали заголовок колонки | Для коннектора это удаление старой колонки и появление новой: старая опустеет, новую нужно отметить. |
| Переименовали лист | Меняется только подпись, имя таблицы прежнее. |
| Удалили лист | Синхронизация останавливается с ошибкой «Лист больше не найден в файле», таблица остаётся с последними данными. Уберите лист на шаге «Доступ». |
| Очистили первую строку | Синхронизация листа падает, таблица остаётся с последними данными. |
| Закрыли доступ к файлу или удалили его | Ошибка «Файл недоступен». Синхронизация возобновится сама, когда доступ или файл вернут. |

## Перезагрузка данных

Функция «Загрузить исторические данные» в меню подключения не зависит от выбранного периода: все включённые листы сразу перечитываются целиком — это внеочередная синхронизация, она работает и на паузе.

> **Примечание**
> Галочка «Удалить ранее загруженные данные за период» у этого коннектора ничего не удаляет отдельно — таблица и так каждый раз заменяется целиком. Подсказка про режим «По добавлению строк» относится к старой форме подключения.

## Дополнительные настройки

| Настройка | Что делает |
| --- | --- |
| Google-аккаунт | Шаг «Доступ»: вход через Google. У аккаунта должен быть доступ к файлу. |
| Ссылка на файл | Шаг «Доступ»: ссылка на файл или его id. После создания подключения не меняется. |
| Листы таблицы | Шаг «Доступ»: какие листы выгружать. Снятый лист при сохранении сразу удаляет свою таблицу из хранилища. |
| Таблицы, колонки и типы | Шаг «Выбор полей»: карточка на каждый лист — включить или выключить таблицу, отметить колонки, задать тип каждой. Выключенная таблица остаётся в хранилище с последними данными и больше не обновляется. |

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

| Заголовок в листе | Колонка в таблице |
| --- | --- |
| Текст | Транслитерация в нижнем регистре: «Дата» → `data`, «Кампания» → `kampaniya`. Пробел становится `_`, дефис, точка и запятая выбрасываются. |
| Пустой | `column_<номер столбца>`. |
| `id` или начинается с `rc_` | С префиксом `f_`: `id` → `f_id`. |
| Повторяется | Суффикс `_2`, `_3` по порядку столбцов. |

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

На шаге «Выбор полей» у каждой колонки выбирается тип. По умолчанию стоит «Авто» — тип оценивается по первой 1000 строк листа.

| Тип в визарде | Тип поля | Как пишется значение |
| --- | --- | --- |
| Строка | Строка | как показано в ячейке |
| Целое число | Целое число | число без дробной части; дробное число в такой колонке — пусто |
| Дробное число | Дробное число | число |
| Дата | Дата | дата; значение со временем — пусто |
| Дата и время | Дата и время | дата и время; дата без времени — полночь |
| Авто | один из пяти выше | тип выбирается по значениям при каждой синхронизации |

Логического типа нет: «да» и «нет» остаются строкой.

> **Важно**
> Числа: пробелы, знаки валют (₽, $, €, ₴, ₸, £, ¥, руб., р.) и % отбрасываются — «1 234,50 ₽» станет 1234.5, «12%» — 12. Запятая — десятичный разделитель, а в файлах с английской локалью — разделитель тысяч; если есть и точка, и запятая, дробный тот, что правее.

> **Важно**
> Двузначный год в дате читается как год нашей эры: `20.09.26` ложится в хранилище как `1900-01-01` — самая ранняя дата, которую хранит колонка. Год в листе нужно писать четырьмя цифрами.

> **Важно**
> «Авто» выбирает первый тип из ряда «целое → дробное → дата → дата и время», под который подходят все непустые значения колонки, иначе — строка. Одно значение не по формату — и вся колонка становится строкой (на бою сумма заказа определилась строкой из-за трёх ячеек с прочерком «-»). Тип пересчитывается при каждой синхронизации по всему листу: появилось в числовой колонке слово — со следующей синхронизации колонка станет строкой. Если тип важен для отчётов, задайте его явно — тогда значение не по формату станет пустым, а тип не изменится.