Renta / Документация / Источники / Salesforce

Salesforce

Renta выгружает в ваше хранилище данных объекты Salesforce: лиды, аккаунты, контакты, сделки, обращения и любой другой стандартный или кастомный объект вашей организации.

Один пайплайн выгружает один объект в одну таблицу. Строка содержит поля одной записи, включая кастомные, в том состоянии, в каком они были в Salesforce на момент запуска.

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

Renta использует OAuth для аутентификации в Salesforce. Вас перенаправит на страницу Salesforce, где вы войдёте в организацию и дадите Renta доступ к ней.

Перед входом вы выбираете Environment: Production для рабочей организации, Sandbox для sandbox-организации, вход в которую Salesforce проводит через test.salesforce.com. На экране согласия Salesforce запрашивает полный доступ и право выполнять запросы в любое время. Renta использует этот доступ, чтобы читать описание объектов и записи, и ничего не записывает обратно.

Ваши учётные данные шифруются при передаче и хранении и никогда не попадают в прикладную базу данных Renta. Вы контролируете доступ и можете отозвать его в любой момент на странице Connected Apps OAuth Usage в разделе Setup вашей организации Salesforce.

Подключите Salesforce как источник

Откройте каталогStep 1
  1. В консоли Renta откройте Connections > Catalog в левом меню.
  2. Откройте категорию CRM и нажмите карточку Salesforce.
Карточка Salesforce в категории CRM каталога подключений Renta
Выберите окружение и начните авторизациюStep 2

Выберите Environment организации, которую подключаете, и нажмите Log in to your Salesforce account. Renta передаст вас на страницу Salesforce.

Поле Environment со значением Production и кнопка входа на странице подключения Salesforce
Войдите и разрешите доступStep 3

Войдите под пользователем Salesforce с правом читать объекты, которые собираетесь выгружать. На следующем экране Salesforce покажет список разрешений, которые запрашивает Renta. Нажмите Allow, чтобы вернуться в Renta.

Страница входа Salesforce, на которой вы авторизуетесь перед выдачей доступа Renta
Назовите подключение и сохранитеStep 4

Завершите настройку:

  1. Source name.
    Название подключения. Используется только внутри консоли Renta.
  2. Access granted.
    Пользователь Salesforce, от имени которого выполнена авторизация.

Нажмите Save.

Если авторизация позже перестанет работать, например после смены пароля Salesforce или отзыва подключённого приложения, нажмите Re-authorize на этом подключении. Оно обновится на месте, а построенные на нём пайплайны продолжат работать.

Поле Source name и подтверждённый аккаунт Salesforce в форме подключения
Проверьте подключениеStep 5

Подключение появится в списке Sources со статусом Active и будет готово к созданию пайплайнов.

Список Sources с новым подключением Salesforce в статусе Active

Создайте пайплайн Salesforce

Выберите Salesforce как источникStep 1

В левом меню нажмите New pipeline. Оставьте вкладку ETL, найдите Salesforce в блоке Already connected и нажмите Next step.

Шаг выбора источника в мастере пайплайна, Salesforce в блоке Already connected
Выберите подключениеStep 2

Выберите созданное подключение Salesforce и нажмите Next step. На карточке виден пользователь Salesforce, от имени которого оно создано. Это помогает, когда разные люди подключили разные организации.

Шаг выбора подключения Salesforce с авторизо�ванным пользователем на карточке
Выберите назначениеStep 3

На шаге Destination выберите хранилище, которое будет получать данные, и нажмите Next step.

Шаг выбора назначения с подключёнными хранилищами
Выберите подключение назначенияStep 4

Выберите подключение назначения и нажмите Next step.

Шаг выбора подключения назначения

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

Последний шаг мастера собирает все настройки в одну прокручиваемую форму.

Объект Salesforce

Объект определяет, какие записи выгружает пайплайн.

Список Salesforce objects в настройках пайплайна с выбранным объектом Lead

Список содержит стандартные и кастомные объекты вашей организации. Выберите один. Чтобы выгрузить несколько объектов, создайте пайплайн для каждого из них.

Версия коннектора

Версия коннектора определяет, какие поля попадут в таблицу и как Renta будет её обновлять.

Список Connector version в настройках пайплайна со значением v2
ВерсияОписание
v2Вы выбираете поля для выгрузки. В назначении с поддержкой merge таблица обновляется инкрементально: после первого запуска каждый следующий загружает только записи, созданные или изменённые после предыдущего. Числовые поля приходят числами.
v1Прежнее поведение. Выгружаются все поля объекта, и каждый запуск перезагружает таблицу целиком. Свой тип сохраняют только текстовые, логические, денежные поля, даты и даты со временем. Остальные поля приходят текстом.

Новые пайплайны создаются на версии v2. Пайплайны, созданные до появления выбора версии, работают на v1, пока вы не переключите их в настройках. Вместе с версией меняется набор колонок, поэтому следующий запуск перезагрузит объект целиком.

Параметры

Отметьте поля Salesforce, которые станут колонками таблицы назначения. Список полей показывается только для версии v2.

Список параметров пайплайна Salesforce с отмеченными полями объекта Lead и заблокированными системными полями

В списке все поля выбранного объекта, включая кастомные. Под именем каждого поля подписан его тип данных в Salesforce. Чтобы взять все поля сразу, нажмите Select All.

Поля Id, CreatedDate и поле, которое Salesforce обновляет при каждом изменении записи (у большинства объектов это SystemModstamp), отмечены заранее, и снять их нельзя. По ним Renta находит запись и определяет изменения.

Имя интеграции и таблицы

Назовите пайплайн в Renta и таблицу в назначении.

Поля Integration name и Table name в настройках пайплайна
  1. Integration name.
    Название пайплайна в консоли Renta.
  2. Table name.
    Таблица в назначении. Оставьте сгенерированное имя или введите своё.

Расписание

Расписание определяет, как часто запускается пайплайн. Время, которое вы задаёте здесь, Renta читает в UTC.

Выбор типа расписания с отмеченным вариантом Daily
Тип расписанияОписание
ManualПайплайн запускается только вручную из консоли Renta или через API.
DailyПайплайн запускается раз в сутки в указанное время обновления.
IntervalПайплайн запускается с заданным интервалом.
Cron ExpressionПайплайн запускается по расписанию, заданному cron-выражением.

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

Поле Update time и кнопка Create pipeline

Renta также поддерживает запуск через API и оркестраторы Apache Airflow, Dagster и Prefect. Подробности в документации по расписанию.

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

Список пайплайнов с пайплайном Salesforce и именем таблицы назначения

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

Способ обновления таблицы зависит от версии коннектора, назначения и объекта.

СтратегияГде применяетсяОписание
Инкрементальное обновление (merge)Пайплайны v2 с назначением, которое поддерживает merge, для объектов, у которых есть Id и CreatedDateПервый запуск загружает объект целиком. Каждый следующий забирает записи, созданные или изменённые после предыдущего запуска, отбирая их по SystemModstamp (или по LastModifiedDate, если у объекта нет SystemModstamp), и обновляет их в назначении по Id. Таблица партиционируется по created_date: это день из CreatedDate, который Renta добавляет отдельной колонкой.
Полная перезагрузкаПайплайны v1, пайплайны v2 с любым другим назначением и объекты без Id или CreatedDateКаждый запуск заменяет таблицу целиком текущим состоянием объекта в Salesforce.

Инкрементальному обновлению нужно назначение с поддержкой merge. Какие назначения его поддерживают, показано в таблице на странице назначений. С другими назначениями пайплайн v2 перезагружает выбранные поля всего объекта на каждом запуске.

Записи, удалённые в Salesforce, остаются в таблице с инкрементальным обновлением. Salesforce не отдаёт удалённые записи в ответах, поэтому Renta не узнаёт об удалении. Из таблицы, которую Renta перезагружает целиком, они пропадают на следующем запуске.

Часто задаваемые вопросы

Ready to get started?

Build your data pipeline today or get a personalized demo. Start free!

Need help?

Get expert support to ensure your project succeeds. We're here to help!

Feature requests?

Help shape our product! Share your ideas for new features and integrations.