Google Sheets

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

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

Renta поддерживает два метода аутентификации для Google Sheets:

1. OAuth (Google Account).
   Лучше всего подходит для частных лиц и небольших команд.
2. Service Account.
   Лучше всего подходит для корпоративной безопасности и централизованного контроля доступа.

Подключение Google Sheets

Следуйте этим шагам, чтобы добавить Google Sheets как источник в Renta. Можно использовать OAuth или Service Account.

Перейдите в каталогStep 1

Перейдите в раздел Connections > Catalog в левой боковой панели.

Выберите Google SheetsStep 2

Найдите и выберите Google Sheets в списке источников.

Выберите метод авторизацииStep 3

Выберите предпочтительный способ авторизации:

1. Authenticate with Google Account.
   Быстрая авторизация через OAuth (Google).
2. GCP Service Account.
   Требует загрузки JSON-ключа (см. шаги ниже).

Service Account: Создание ключаStep 4

При использовании Service Account:

Подробную пошаговую инструкцию по созданию GCP Service Account смотрите в нашем руководстве по интеграции Google Sheets и Snowflake.

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

Service Account: Доступ к таблицеStep 5

1. Откройте Google Таблицу.
2. Нажмите Share (Настройки доступа).
3. Добавьте email сервисного аккаунта с правами Viewer (Читатель).

Настройка подключенияStep 6

Заполните параметры подключения:

1. Source name.
   Имя источника в интерфейсе Renta.
2. Google Spreadsheet ID.
   Вставьте полный URL таблицы. Renta автоматически извлечет ID.

Нажмите Save для завершения.

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

При создании пайплайна с источником Google Sheets необходимо настроить следующие параметры:

1. Select Worksheet.
   Выберите лист (вкладку) для синхронизации.
2. Header row number.
   Укажите номер строки с заголовками столбцов (по умолчанию: 1). Поддерживаются только английские названия столбцов. Renta автоматически нормализует заголовки, удаляя пробелы, специальные символы и приводя к нижнему регистру в соответствии с требованиями целевой таблицы.
3. Worksheet columns.
   Выберите столбцы для синхронизации из вашей таблицы. Это обязательное поле. Чтобы добавить новые столбцы после создания пайплайна, обновите эту настройку и явно выберите новые столбцы.

Планирование синхронизации

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

В следующей таблице описаны стратегии синхронизации, используемые Renta для Google Sheets:

Типы данных и ограничения

1. Типы данных.
   Все данные загружаются как текст (тип string). Renta не проверяет типы данных, поэтому столбцы могут содержать смешанные типы (текст, числа, даты).
2. Пустые строки.
   Пустые строки автоматически пропускаются.
3. Изменение схемы: Добавление столбцов.
   Если вы добавите новые столбцы в Google Таблицу, они не появятся в целевой таблице, пока вы вручную не обновите настройки пайплайна и не выберете их в поле Worksheet columns.
4. Изменение схемы: Удаление столбцов.
   Если вы удалите столбец из Google Таблицы, соответствующий столбец в целевой таблице продолжит существовать, но будет получать пустые значения при всех новых синхронизациях.