Google Sheets

Renta позволяет отправлять данные из вашего хранилища данных напрямую в Google Sheets. Настройте модель данных один раз, и Renta будет поддерживать лист таблицы в актуальном состоянии, чтобы команда работала с живыми данными из хранилища без ручных выгрузок.

Аутентификация

Для аутентификации в Google Sheets Renta использует GCP Service Account. Вы один раз загружаете JSON-файл ключа, после чего для синхронизации доступна любая таблица, к которой предоставлен доступ для email сервисного аккаунта.

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

1. В Google Cloud Console откройте IAM & Admin > Service Accounts и создайте сервисный аккаунт или выберите существующий.
2. Включите Google Sheets API и Google Drive API в GCP-проекте сервисного аккаунта.
3. На вкладке Keys нажмите Add Key > Create new key, выберите JSON и скачайте файл.
4. Предоставьте доступ к каждой таблице, которую хотите синхронизировать, для email сервисного аккаунта с ролью Editor.

Создание пайплайна

После подключения назначения создайте пайплайн, чтобы синхронизировать модель данных в таблицу.

Настройка пайплайна

На финальном шаге выберите, какую модель данных синхронизировать и куда именно записывать данные в таблице.

Настройки синхронизации

Укажите для пайплайна модель данных и таблицу.

1. What would you like Renta to sync.
   Выберите Worksheet, чтобы зеркально синхронизировать модель данных в один лист таблицы.
2. Data model.
   Выберите модель данных для синхронизации. От этого выбора зависят колонки, доступные для маппинга ниже.
3. Spreadsheet.
   Выберите таблицу Google. В списке отображаются все таблицы, к которым у сервисного аккаунта есть доступ. Для самой синхронизации нужна роль Editor: с ролью Viewer запуск завершится ошибкой доступа.

Лист

Выберите лист, в который будут записываться данные. Лист полностью перезаписывается при каждой синхронизации.

1. Worksheet Синхронизируйте данные в существующий лист или позвольте Renta создать новый.

   Режим	Описание
   Use an existing worksheet	Выберите лист из таблицы. Renta перезаписывает его содержимое при каждой синхронизации.
   Create a new worksheet	Укажите имя, и Renta добавит лист в таблицу при создании пайплайна.

2. Existing worksheet Для режима существующего листа выберите лист, в который синхронизировать данные.

   Имя нового листа должно быть уникальным в пределах таблицы, не длиннее 100 символов и не может содержать символы : / \ ? * [ ].

Маппинг полей

Сопоставьте колонки модели данных с колонками листа. Каждая замапленная колонка становится колонкой в листе, а её имя становится текстом заголовка в строке 1.

При создании пайплайна все колонки модели замаплены автоматически: удалите ненужные или переименуйте колонки листа. Используйте Add mapping, чтобы добавить новые:

Затем укажите Integration name — отображаемое имя пайплайна. Измените его по своему усмотрению.

Расписание

Выберите, как часто будет запускаться пайплайн.

Для расписания Daily укажите Update time — точное время запуска, затем нажмите Create pipeline.

Новый пайплайн появится в разделе Pipelines на вкладке Reverse ETL, где можно отслеживать его запуски и прогресс.

Стратегия синхронизации

Каждая синхронизация полностью перезаписывает лист, чтобы он в точности соответствовал текущему состоянию модели данных.

При каждом запуске Renta выполняет запрос модели данных в вашем хранилище, изменяет размер листа точно под размер результата, записывает заголовки в строку 1 и заполняет строки ниже результатами запроса. Строки, удалённые из модели, удаляются и из листа, поэтому лист всегда соответствует модели без устаревших строк и дублей. Если модель не вернула строк, в листе останется только строка заголовков.

1. Переименование листа безопасно.
   Renta отслеживает лист по внутреннему ID, поэтому синхронизация продолжится в переименованный лист.
2. Удаление листа восстановимо.
   Если лист больше не существует, при следующей синхронизации Renta создаст новый с заданным в настройках именем.
3. Ручные правки перезаписываются.
   Renta перезаписывает все значения ячеек и удаляет строки и колонки за пределами синхронизируемого диапазона, при этом форматирование ячеек, защита и правила проверки данных внутри диапазона сохраняются. Держите формулы, графики и заметки на других листах той же таблицы и ссылайтесь на синхронизируемый лист оттуда.

Лимиты

1. Ячейки за синхронизацию.
   За одну синхронизацию можно записать до 5 миллионов ячеек: количество строк, включая строку заголовков, умноженное на количество замапленных колонок. Если модель данных превышает лимит, запуск завершится ошибкой до записи данных, а текущее содержимое листа останется без изменений. Уменьшите количество строк в модели или количество замапленных колонок.
2. Ячейки в таблице.
   Сам Google Sheets ограничивает таблицу 10 миллионами ячеек по всем листам. Если таблица превышает этот лимит, синхронизация завершится ошибкой с предложением удалить неиспользуемые листы или колонки либо синхронизировать данные в новую таблицу.
3. Форматирование значений.
   Renta записывает значения так, как их ввёл бы пользователь, поэтому Google Sheets применяет своё обычное распознавание: числа становятся числами, а строки в формате дат — датами. Пустые значения модели становятся пустыми ячейками.