Настройка подключения объектов Salesforce

В этой статье описаны действия по созданию соединения объектов Salesforce.

Поддерживаемые типы аутентификации

Соединитель объектов Salesforce поддерживает следующие типы проверки подлинности для копирования и потока данных 2-го поколения соответственно.

Тип аутентификации Копия Поток данных 2-го поколения
Учетная запись организации √ √

Настройте ваше подключение для Dataflow Gen2

Вы можете подключить поток данных 2-го поколения в Microsoft Fabric к объектам Salesforce с помощью соединителей Power Query. Выполните следующие действия, чтобы создать подключение:

  1. Проверьте возможности, ограничения и рекомендации , чтобы убедиться, что ваш сценарий поддерживается.
  2. Полные предварительные требования для объектов Salesforce.
  3. Получение данных в системе Fabric.
  4. Подключение к объектам Salesforce.

Возможности

  • Производство
  • Настраиваемый
    • Личные домены
    • Перенаправление записей типа CNAME
    • Столбцы связей

Необходимые условия

Чтобы использовать соединитель Salesforce Objects, необходимо иметь имя пользователя и пароль учетной записи Salesforce.

Кроме того, необходимо включить доступ к API Salesforce. Чтобы проверить параметры доступа, перейдите на личную страницу Salesforce, откройте параметры профиля и найдите и убедитесь, что установлен флажок с включенным API . Обратите внимание, что у учетных записей пробной версии Salesforce нет доступа к API.

Получение данных

Чтобы получить данные в фабрике данных, выполните приведенные действия.

  1. В левой части Фабрики данных выберите Рабочие области.

  2. В рабочей области Data Factory выберите Новый>Dataflow Gen2, чтобы создать новый поток данных.

    снимок экрана: рабочая область, в которой вы решили создать новый поток данных.

  3. В Power Query выберите Получить данные на ленте или выберите Получить данные из другого источника в текущем представлении.

    снимок экрана: рабочая область Power Query с выделенным параметром

  4. На странице Выбор источника данных используйте поиска для поиска имени соединителя или выберите просмотреть дополнительные в правой части соединителя, чтобы просмотреть список всех соединителей, доступных в службе Power BI.

    снимок экрана страницы

  5. Если вы решили просмотреть дополнительные соединители, вы по-прежнему можете использовать поиск по имени соединителя или выбрать категорию, чтобы просмотреть список соединителей, связанных с этой категорией.

    снимок экрана страницы с источниками данных фабрики данных, отображаемой после выбора

Подключение к объектам Salesforce

Чтобы подключиться к данным Salesforce Objects, выполните приведенные действия.

  1. Выберите объекты Salesforce из списка соединителей данных для конкретного продукта и нажмите кнопку "Подключить". Дополнительные сведения см. в раздел "Где получить данные".

  2. В объектах Salesforce выберите URL-адрес, который требуется использовать для подключения. Выберите URL-адрес Production, если вы используете Production URL-адрес Salesforce (https://www.salesforce.com) для входа.

    Снимок экрана: окно

    Замечание

    В настоящее время может потребоваться выбрать Настраиваемый URL-адрес, ввести https://www.salesforce.com в текстовое поле, а затем выбрать Рабочую среду для подключения к данным.

    Вы также можете выбрать custom и ввести настраиваемый URL-адрес для входа. Этот пользовательский URL-адрес может быть личным доменом, созданным в Salesforce, например https://contoso.salesforce.com. Вы также можете использовать выбор пользовательского URL-адреса, если вы используете собственную запись CNAME, которая перенаправляется в Salesforce.

    Кроме того, можно выбрать включить столбцы связей. Этот выбор изменяет запрос, включив столбцы, которые могут иметь связи внешнего ключа с другими таблицами. Если этот флажок снят, эти столбцы не отображаются.

  3. Если вы впервые делаете это подключение, при необходимости выберите локальный шлюз данных.

  4. Выберите вход , чтобы войти в учетную запись Salesforce. После успешного входа нажмите кнопку "Далее".

  5. В диалоговом окне "Навигатор" выберите объекты Salesforce, которые требуется загрузить. Затем выберите "Преобразовать данные ", чтобы преобразовать данные.

Ограничения и рекомендации

  • Если в результатах соединителя Salesforce Objects отсутствуют таблицы, одной из причин может быть необходимость указания или обновления параметра ApiVersion до версии, которую поддерживает Salesforce. Чтобы указать или обновить ApiVersion, используйте расширенный редактор и явно добавьте ApiVersion этот параметр. Рассмотрим пример.

    Source = Salesforce.Data("https://login.salesforce.com/", [ApiVersion = 54.0])

    Salesforce периодически устраняет устаревшие версии API, поэтому убедитесь, что вы указываете поддерживаемую версию API Salesforce.

  • Существует ограничение на количество полей, которые может содержать запрос к Salesforce. Ограничение зависит от типа столбцов, количества вычисляемых столбцов и т. д. При получении Query is either selecting too many fields or the filter conditions are too complicated ошибки это означает, что запрос превышает ограничение. Чтобы избежать этой ошибки, используйте расширенный параметр select Query и укажите нужные поля.

  • Параметры сеанса Salesforce могут блокировать эту интеграцию. Убедитесь, что настройка блокировать сеансы по IP-адресу, с которого они начались отключена.

  • Необходимо включить доступ к API Salesforce. Чтобы проверить параметры доступа, перейдите к параметрам профиля для текущего пользователя и установите флажок " Включить API ".

  • У учетных записей пробной версии Salesforce нет доступа к API.

  • Операции "Создать запись" и "Обновить запись" не поддерживают настраиваемые поля типа Picklist (Multi-Select).

  • URL-адреса Lightning не поддерживаются.

  • Пользовательские URL-адреса поддерживают только домены salesforce.com и cloudforce.com. Использование других доменов приводит к ошибке "Недопустимые аргументы".

  • Salesforce ограничивает количество одновременных запросов, которые может выполнять одна учетная запись. Ошибка "INVALID_QUERY_LOCATOR" Это ограничение Salesforce и может возникнуть при наличии нескольких одновременных запросов к Salesforce с помощью одной и той же учетной записи. Это ограничение включает все клиентские приложения (а не только соединитель PowerQuery) с помощью API Salesforce. Чтобы уменьшить вероятность этой ошибки, выполните следующие действия.

    • Убедитесь, что количество запросов к Salesforce сведено к минимуму.
    • Используйте доступные опции (например, потоки данных) для промежуточного хранения данных из Salesforce.
    • Убедитесь, что другие использования API Salesforce с той же учетной записью не запланированы одновременно.

Дополнительные сведения о внутренних ограничениях API Salesforce см. в кратком справочнике по ограничениям и выделению ресурсов Salesforce.

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

  • Last updated on