Перейти к основному содержимому

Настройка Salesforce Data 360 Бета-версия

Адаптер dbt-salesforce доступен через CLI dbt v2. Чтобы получить доступ к адаптеру, установите dbt v2. В качестве интерфейса разработки рекомендуем использовать расширение для VS Code. Поддержка в dbt platform появится в ближайшее время.

Предварительные требования​

Для подключения dbt к Salesforce Data 360 вам потребуется следующее:

Создание закрытого ключа и сертификата​

Прежде чем создавать внешнее клиентское приложение, создайте закрытый ключ (server.key) и самоподписанный сертификат (server.crt) в Salesforce. Salesforce использует сертификат для проверки токена JWT Bearer, отправляемого dbt. Инструкции см. в разделе Создание закрытого ключа и самоподписанного цифрового сертификата.

примечание

Рекомендуется создавать эти учётные данные под служебной учётной записью, а не под личной учётной записью пользователя, чтобы упростить управление учётными данными.

Создание внешнего клиентского приложения​

Для аутентификации dbt с использованием потока JWT Bearer необходимо создать и настроить внешнее клиентское приложение в Salesforce Data 360.

Следуйте инструкциям в разделе Создание локального внешнего клиентского приложения, чтобы создать внешнее клиентское приложение. На шаге 6 обязательно выберите Packaged.

Затем настройте параметры OAuth для приложения:

  1. В разделе API (Enable OAuth Settings) выберите Enable OAuth.
  2. Установите для Callback URL значение https://login.salesforce.com/services/oauth2/callback.
  3. В разделе OAuth Scopes добавьте в список Selected OAuth Scopes следующие области доступа:
    • api — для управления пользовательскими данными через API
    • refresh_token, offline_access — для выполнения запросов в любое время, даже когда пользователь не в сети или срок действия токенов истёк
    • cdp_query_api — для выполнения SQL-запросов к данным Data 360
  4. В разделе Flow Enablement выберите Enable JWT Bearer Flow.
  5. Нажмите Upload Files и загрузите файл server.crt, созданный в разделе Создание закрытого ключа и сертификата.
  6. Нажмите Create.
  7. На вкладке Policies выберите Edit.
  8. В разделе OAuth Policies > Plugin Policies > Permitted Users выберите Admin approved users are pre-authorized. Появится список Select Profiles and Select Permission Sets.
  9. Выберите профили и наборы разрешений, которым следует предоставить доступ к внешнему клиентскому приложению.
  10. В разделе App Authorization установите для IP Relaxation значение Relax IP Restrictions.
  11. Нажмите Save.

Настройка dbt v2​

Чтобы подключить dbt к Salesforce Data 360, настройте файл profiles.yml. Используйте следующую конфигурацию:

~/.dbt/profiles.yml
company-name:
  target: dev
  outputs:
    dev:
      type: salesforce
      method: jwt_bearer
      client_id: [Consumer Key of your Data 360 app]
      private_key_path: [local file path of your server key]
      login_url: "https://login.salesforce.com"
      username: [username on the Data 360 Instance]
Поле профиляОбязательноОписаниеПример
methodДаМетод аутентификации. В настоящее время поддерживается только jwt_bearer.jwt_bearer
client_idДаЗначение Consumer Key из секретов подключенного приложения.
private_key_pathДаПуть к файлу server.key на вашем компьютере./Users/dbt_user/Documents/server.key
login_urlДаURL для входа в экземпляр Salesforce.https://login.salesforce.com
usernameДаИмя пользователя в экземпляре Data 360.dbt_user@dbtlabs.com

Дополнительная информация​

Информацию о настройках, специфичных для Salesforce, можно найти в справочном руководстве по адаптеру Salesforce.

Нашли ошибку?

0
Loading