Настройка Salesforce в действии копирования

В этой статье описывается, как использовать действие копирования в конвейере для копирования данных из Salesforce и обратно.

Поддерживаемая конфигурация

Для настройки каждой вкладки в действии копирования перейдите к следующим разделам соответственно.

• Общие сведения
• Источник
• Назначение
• Картирование
• Параметры

Общие

Ознакомьтесь с руководством по общим параметрам, чтобы настроить вкладку "Общие параметры".

Источник

Следующие свойства поддерживаются для Salesforce на вкладке "Источник " действия копирования.

Требуются следующие свойства:

• Подключение. Выберите подключение Salesforce из списка подключений. Если подключение отсутствует, создайте новое подключение Salesforce, нажав кнопку "Создать".
• Используйте запрос: выберите из API объектов, отчета или запроса SOQL.

  • Если выбрать API объектов:

    • API объектов: укажите имя объекта Salesforce для получения данных. Выберите имя из раскрывающегося списка.

  • Если выбрать отчет:

    • Идентификатор отчета: укажите идентификатор отчета Salesforce для получения данных. Он не поддерживается в целевой среде. При использовании отчетов существуют ограничения .

      

  • Если выбрать SOQL-запрос:

    • ЗАПРОС SOQL: используйте пользовательский запрос для чтения данных. Вы можете использовать запрос языка запросов объектов Salesforce (SOQL) только с ограничениями Понимание массового API 2.0 Query. Если вы не укажете запрос SOQL, будут извлечены все данные объекта Salesforce, определённые в объекте API или идентификаторе отчёта.

      

В разделе "Дополнительно" можно указать следующие поля:

• Включить удаленные объекты: укажите, следует ли запрашивать существующие записи (неизбираемые) или запрашивать все записи, включая удаленные (выбранные).
• Сохранение масштаба из схемы: укажите, следует ли включить округление десятичного масштабирования или нет в соответствии с определением десятичного масштабирования в схеме. Округление происходит только в том случае, если свойству присвоено значение true (выбрано). Если оно не указано, поведение по умолчанию равно false (не выбрано). Например, если столбец определен как десятичный (18,3) в схеме, значение 123,123789 округляется до 123,124, если этот параметр выбран.
• Параметр секционирования. Предоставление возможности автоматического обнаружения и применения оптимального алгоритма секционирования для оптимизации пропускной способности чтения при необходимости. Рекомендуется выбрать автоопределение для долговременной копии, которая может использовать многопоточные операции чтения. Значение по умолчанию — автоматическое обнаружение.
• Дополнительные столбцы: добавление дополнительных столбцов данных для хранения относительного пути или статического значения исходных файлов. Выражение поддерживается для последнего.

Назначение

Следующие свойства поддерживаются для Salesforce на вкладке "Назначение " действия копирования.

Требуются следующие свойства:

• Подключение. Выберите подключение Salesforce из списка подключений. Если подключение отсутствует, создайте новое подключение Salesforce, нажав кнопку "Создать".
• Object API: Укажите имя объекта Salesforce, в который будут записываться данные. Выберите имя из раскрывающегося списка.

В разделе "Дополнительно" можно указать следующие поля:

• Поведение записи: укажите поведение записи для операции. Допустимые значения: Insert (Вставка) и Upsert (Вставка-обновление). Вы можете выбрать поведение из раскрывающегося списка.

  Если выбрать Upsert:

  • Поле внешнего идентификатора: имя поля внешнего идентификатора для операции upsert. Указанное поле должно быть определено как поле внешнего идентификатора в объекте Salesforce. Оно не может иметь значения NULL в соответствующих входных данных.

    

• Игнорировать значения NULL. Укажите, следует ли игнорировать значения NULL из входных данных во время операции записи.

  • Когда выбрано: оставьте данные в целевом объекте без изменений при выполнении операции upsert или update. При выполнении операции вставки (insert) вставьте определенное значение по умолчанию.
  • При отмене выбора: обновите данные в целевом объекте до NULL при выполнении операции upsert или update. При выполнении операции вставки (insert) вставьте значение NULL.

• Напишите размер пакета: укажите количество строк, записанных в Salesforce в каждом пакете. Рекомендуем задать это значение от 10 000 до 200 000. Слишком мало строк в каждом пакете снижает производительность копирования. Слишком большое количество строк в каждом пакете может вызвать превышение времени ожидания API.

• Максимальное число одновременных подключений: верхний предел одновременных подключений, установленных в хранилище данных во время выполнения действия. Указывайте значение только при необходимости ограничить количество одновременных подключений.

Сопоставление

Сведения о настройке вкладки "Сопоставление" см. в разделе "Настройка сопоставлений" на вкладке "Сопоставление".

Настройки

Для настройки вкладки "Параметры" перейдите к разделу "Настройка других параметров" на вкладке "Параметры".

Сводка таблицы

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

Сведения об источнике

Сведения о назначении

Ограничения Salesforce Bulk API 2.0

Мы используем API Salesforce Bulk API 2.0 для запроса и приема данных. В Bulk API 2.0 партии создаются для вас автоматически. Вы можете отправлять до 15 000 пакетов на 24-часовой период. Если пакеты превышают предел, возникают сбои.

В версии Bulk API 2.0 только задания на импорт обрабатывают пакеты. Задания запросов не выполняются. Для получения подробной информации см. раздел "Как обрабатываются запросы в руководстве разработчика Bulk API 2.0".

Дополнительные сведения см. в разделе "Общие ограничения" в ограничениях разработчика Salesforce.

Связанный контент

• Общие сведения о объектах Salesforce