Настройка Salesforce в действии копирования
В этой статье описывается, как использовать действие копирования в конвейере данных для копирования данных из Salesforce и обратно.
Поддерживаемая конфигурация
Для настройки каждой вкладки в действии копирования перейдите к следующим разделам соответственно.
Общие
Ознакомьтесь с руководством по общим параметрам, чтобы настроить вкладку "Общие параметры".
Исходный код
Следующие свойства поддерживаются для Salesforce на вкладке "Источник " действия копирования.
Требуются следующие свойства:
- Подключение. Выберите подключение Salesforce из списка подключений. Если подключение отсутствует, создайте новое подключение Salesforce, нажав кнопку "Создать".
- Используйте запрос: выберите из API объектов, отчета или запроса SOQL.
Если выбрать API объектов:
- API объектов: укажите имя объекта Salesforce для получения данных. Выберите имя из раскрывающегося списка.
Если выбрать отчет:
Идентификатор отчета: укажите идентификатор отчета Salesforce для получения данных. Он не поддерживается в назначении. При использовании отчетов существуют ограничения .
Если выбрать SOQL-запрос:
ЗАПРОС SOQL: используйте пользовательский запрос для чтения данных. Запрос языка запросов объектов Salesforce (SOQL) можно использовать только с ограничениями, которые понять массовый API 2.0. Если запрос SOQL не указан, будут извлечены все данные объекта Salesforce, указанного в API объектов или идентификаторе отчета.
В разделе "Дополнительно" можно указать следующие поля:
- Включить удаленные объекты: укажите, следует ли запрашивать существующие записи (неизбираемые) или запрашивать все записи, включая удаленные (выбранные).
- Дополнительные столбцы: добавление дополнительных столбцов данных для хранения относительного пути или статического значения исходных файлов. Выражение поддерживается для последнего.
Назначение
Следующие свойства поддерживаются для Salesforce на вкладке "Назначение " действия копирования.
Требуются следующие свойства:
- Подключение. Выберите подключение Salesforce из списка подключений. Если подключение отсутствует, создайте новое подключение Salesforce, нажав кнопку "Создать".
- 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.
Сведения об источнике
| Имя | Описание | Значение | Обязательное поле | Свойство скрипта JSON |
|---|---|---|---|---|
| Соединение | Подключение к исходному хранилищу данных. | <подключение Salesforce> | Да | подключение |
| Тип подключения | Тип подключения. Выберите объекты Salesforce. | SalesforceObject | Да | / |
| Использование запроса | Способ чтения данных из Salesforce. | • API объектов • Отчет • ЗАПРОС SOQL |
Да | / |
| Для API объектов | ||||
| API объектов | Укажите имя объекта Salesforce, из которого извлекаются данные. | < имя объекта > | Да | objectApiName |
| Для отчета | ||||
| Идентификатор отчета | Идентификатор отчета Salesforce для получения данных. Он не поддерживается в назначении. При использовании отчетов существуют ограничения . | <идентификатор отчета> | Да | reportId |
| Запрос SOQL | ||||
| Запрос SOQL | Используйте пользовательский запрос для чтения данных. Запрос языка запросов объектов Salesforce (SOQL) можно использовать только с ограничениями, которые понять массовый API 2.0. Если запрос SOQL не указан, будут извлечены все данные объекта Salesforce, указанного в API объектов или идентификаторе отчета. | < запрос SOQL > | Да | query |
| Включение удаленных объектов | Указывает, следует ли запрашивать существующие записи или все записи, включая удаленные. | выбран или не выбран (по умолчанию) | No | includeDeletedObjects: true или false (по умолчанию) |
| Дополнительные столбцы | Добавьте дополнительные столбцы данных для хранения относительного пути или статического значения исходных файлов. Выражение поддерживается для последнего. | • Имя •Ценность |
No | additionalColumns: •имя •ценность |
Сведения о назначении
| Имя | Описание | Значение | Обязательное поле | Свойство скрипта JSON |
|---|---|---|---|---|
| Соединение | Подключение к целевому хранилищу данных. | <подключение Salesforce> | Да | подключение |
| API объектов | Укажите имя объекта Salesforce для записи данных. | < имя объекта > | Да | objectApiName |
| Поведение записи | Поведение операции при записи. Допустимые значения: Insert (Вставка) и Upsert (Вставка-обновление). Вы можете выбрать поведение из раскрывающегося списка. | •Вставка • Upsert |
Нет (по умолчанию используется Insert) | writeBehavior: Вставить upsert |
| Поле внешнего идентификатора | Имя поля для внешнего идентификатора при операции upsert. Указанное поле должно быть определено как поле внешнего идентификатора в объекте Salesforce. Оно не может иметь значения NULL в соответствующих входных данных. | < поле внешнего идентификатора > | "Да" для операции Upsert (Вставка-обновление) | externalIdFieldName |
| Игнорировать значения NULL | Указывает, следует ли игнорировать значения NULL из входных данных во время операции записи. | выбран или не выбран (по умолчанию) | No | ignoreNullValues: true или false (по умолчанию) |
| Размер пакета записи | Количество строк данных, записываемых в Salesforce одним пакетом. Рекомендуем задать это значение от 10 000 до 200 000. Слишком мало строк в каждом пакете снижает производительность копирования. Слишком много строк в каждом пакете может привести к истечении времени ожидания API. | <количество строк> (целое число) |
Нет (по умолчанию — 100 000) | writeBatchSize |
| Максимальное число одновременных подключений | Верхний предел одновременных подключений, установленных для хранилища данных при выполнении действия. Указывайте значение только при необходимости ограничить количество одновременных подключений. | <максимальное число одновременных подключений> | No | maxConcurrentConnections |
Ограничения api Bulk API Salesforce 2.0
Мы используем API Salesforce Bulk API 2.0 для запроса и приема данных. В пакетном API 2.0 пакеты создаются автоматически. Вы можете отправлять до 15 000 пакетов на 24-часовой период. Если пакеты превышают предел, возникают сбои.
В пакетном API 2.0 только задания приема используют пакеты. Задания запросов не выполняются. Дополнительные сведения см. в руководстве разработчика по массовому api 2.0.
Дополнительные сведения см. в разделе "Общие ограничения" в ограничениях разработчика Salesforce.