Копирование данных из Salesforce Marketing Cloud с помощью Фабрики данных Azure или Synapse Analytics

Статья
12/09/2023

Область применения:Фабрика данных Azure Azure Synapse Analytics

Совет

Попробуйте использовать фабрику данных в Microsoft Fabric, решение для аналитики с одним интерфейсом для предприятий. Microsoft Fabric охватывает все, от перемещения данных до обработки и анализа данных в режиме реального времени, бизнес-аналитики и отчетности. Узнайте, как бесплатно запустить новую пробную версию !

В этой статье описывается, как с помощью действия Copy в конвейере Фабрики данных Azure или Synapse Analytics копировать данные из Salesforce Marketing Cloud. Это продолжение статьи об обзоре действия копирования, в которой представлены общие сведения о действии копирования.

Поддерживаемые возможности

Этот соединитель Salesforce Marketing Cloud поддерживается для следующих действий:

Поддерживаемые возможности	IR
Действие копирования (источник/-)	① ②
Действие поиска	① ②

① Среда выполнения интеграции Azure ② Локальная среда выполнения интеграции

Список хранилищ данных, которые поддерживаются в качестве источников/приемников, см. в таблице Поддерживаемые хранилища данных.

Соединитель Salesforce Marketing Cloud поддерживает аутентификацию OAuth 2, а также устаревшие и расширенные типы пакетов. Соединитель устанавливается поверх REST API Salesforce Marketing Cloud.

Примечание.

Этот соединитель не поддерживает получение представлений, пользовательских объектов или пользовательских расширений данных.

Начало работы

Вы можете создать конвейер с помощью операции копирования, используя пакет SDK для .NET, пакет SDK для Python, Azure PowerShell, API REST или шаблон Azure Resource Manager. Пошаговые инструкции по созданию конвейера с действием копирования см. в руководстве по действию копирования.

Создание связанной службы для Salesforce Marketing Cloud с помощью пользовательского интерфейса

Выполнив указанные ниже действия, можно создать связанную службу для Salesforce Marketing Cloud с помощью пользовательского интерфейса на портале Azure.

Перейдите на вкладку "Управление" в рабочей области Фабрики данных Azure или Synapse и выберите "Связанные службы", после чего нажмите "Создать":
- Фабрика данных Azure
- Azure Synapse
Выполните поиск по слову "Salesforce" и выберите соединитель Salesforce Marketing Cloud.
Настройте сведения о службе, проверьте подключение и создайте связанную службу.

Примечание.

Интеграция API область в Cloud Salesforce Marketing Cloud должна иметь значение Hub | Кампания | Считывает, чтобы соединитель был успешно выполнен.

Сведения о конфигурации соединителя

Следующие разделы содержат сведения о свойствах, которые используются для определения сущностей фабрики данных, относящихся к соединителю Salesforce Marketing Cloud.

Свойства связанной службы

Для связанной службы Salesforce Marketing Cloud поддерживаются следующие свойства:

Свойство	Описание:	Обязательное поле
type	Для свойства type нужно задать значение Salesforce Marketing Cloud.	Да
connectionProperties	Группа свойств, определяющих способ подключения к Salesforce Marketing Cloud.	Да
В разделе `connectionProperties`:
authenticationType	Указывает используемый метод проверки подлинности. Допустимые значения: `Enhanced sts OAuth 2.0` или `OAuth_2.0`. Устаревший пакет Salesforce Marketing Cloud поддерживает только `OAuth_2.0`, в то время как для расширенного пакета требуется `Enhanced sts OAuth 2.0`. С 1 августа 2019 г. в Salesforce Marketing Cloud была удалена возможность создания устаревших пакетов. Все новые пакеты являются расширенными.	Да
host	Для расширенного пакета узел должен быть поддоменом, представленным 28-символьной строкой, начинающейся с букв "mc", например `mc563885gzs27c5t9-63k636ttgm`. Для устаревшего пакета укажите `www.exacttargetapis.com`.	Да
clientId	Идентификатор клиента, связанного с приложением Salesforce Marketing Cloud.	Да
clientSecret	Секрет клиента, связанного с приложением Salesforce Marketing Cloud. Вы можете обозначить это поле как SecureString, чтобы безопасно хранить его в службе, или сохранить секрет в Azure Key Vault и позволить действию Copy службы передавать его оттуда при копировании данных. Подробные сведения см. в разделе Хранение учетных данных в Key Vault.	Да
useEncryptedEndpoints	Указывает, шифруются ли конечные точки источника данных с помощью протокола HTTPS. Значение по умолчанию — true.	No
useHostVerification	Указывает, следует ли требовать, чтобы имя узла в сертификате сервера совпадало с именем узла сервера при подключении по протоколу TLS. Значение по умолчанию — true.	No
usePeerVerification	Указывает, следует ли проверять удостоверение сервера при подключении по протоколу TLS. Значение по умолчанию — true.	No

Пример. Использование расширенной проверки подлинности OAuth 2 STS для расширенного пакета

{
    "name": "SalesforceMarketingCloudLinkedService",
    "properties": {
        "type": "SalesforceMarketingCloud",
        "typeProperties": {
            "connectionProperties": {
                "host": "<subdomain e.g. mc563885gzs27c5t9-63k636ttgm>",
                "authenticationType": "Enhanced sts OAuth 2.0",
                "clientId": "<clientId>",
                "clientSecret": {
                     "type": "SecureString",
                     "value": "<clientSecret>"
            	},
                "useEncryptedEndpoints": true,
                "useHostVerification": true,
                "usePeerVerification": true
            }
        }
    }
}

Пример. Использование проверки подлинности OAuth 2 для устаревшего пакета

{
    "name": "SalesforceMarketingCloudLinkedService",
    "properties": {
        "type": "SalesforceMarketingCloud",
        "typeProperties": {
            "connectionProperties": {
                "host": "www.exacttargetapis.com",
                "authenticationType": "OAuth_2.0",
                "clientId": "<clientId>",
                "clientSecret": {
                     "type": "SecureString",
                     "value": "<clientSecret>"
            	},
                "useEncryptedEndpoints": true,
                "useHostVerification": true,
                "usePeerVerification": true
            }
        }
    }
}

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

{
    "name": "SalesforceMarketingCloudLinkedService",
    "properties": {
        "type": "SalesforceMarketingCloud",
        "typeProperties": {
            "clientId": "<clientId>",
            "clientSecret": {
                 "type": "SecureString",
                 "value": "<clientSecret>"
            },
            "useEncryptedEndpoints": true,
            "useHostVerification": true,
            "usePeerVerification": true
        }
    }
}

Свойства набора данных

Полный список разделов и свойств, доступных для определения наборов данных, см. в статье о наборах данных. Этот раздел содержит список свойств, поддерживаемых набором данных Salesforce Marketing Cloud.

Чтобы скопировать данные из Salesforce Marketing Cloud, для свойства type набора данных установите значение SalesforceMarketingCloudObject. Поддерживаются следующие свойства:

Свойство	Описание:	Обязательное поле
type	Свойство type для набора данных должно иметь значение SalesforceMarketingCloudObject	Да
tableName	Имя таблицы.	Нет (если свойство query указано в источнике действия)

Пример

{
    "name": "SalesforceMarketingCloudDataset",
    "properties": {
        "type": "SalesforceMarketingCloudObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SalesforceMarketingCloud linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

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

Полный список разделов и свойств, используемых для определения действий, см. в статье Конвейеры и действия в фабрике данных Azure. Этот раздел содержит список свойств, поддерживаемых источником Salesforce Marketing Cloud.

Salesforce Marketing Cloud в качестве источника

Чтобы скопировать данные из Salesforce Marketing Cloud, установите тип источника SalesforceMarketingCloudSource в действии копирования. В разделе source действия копирования поддерживаются следующие свойства:

Свойство	Описание:	Обязательное поле
type	Свойство type источника действия копирования должно иметь значение SalesforceMarketingCloudSource.	Да
query	Используйте пользовательский SQL-запрос для чтения данных. Например: `"SELECT * FROM MyTable"`.	Нет (если для набора данных задано свойство tableName)

Пример:

"activities":[
    {
        "name": "CopyFromSalesforceMarketingCloud",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SalesforceMarketingCloud input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SalesforceMarketingCloudSource",
                "query": "SELECT * FROM MyTable"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Примечание.

Таблица контактов не поддерживается.

Свойства действия поиска

Подробные сведения об этих свойствах см. в разделе Действие поиска.

Список хранилищ данных, которые поддерживаются в качестве источников и приемников для действия Copy, приведен в таблице Поддерживаемые хранилища данных и форматы.

Копирование данных из Salesforce Marketing Cloud с помощью Фабрики данных Azure или Synapse Analytics

Поддерживаемые возможности

Начало работы

Создание связанной службы для Salesforce Marketing Cloud с помощью пользовательского интерфейса

Сведения о конфигурации соединителя

Свойства связанной службы

Свойства набора данных

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

Salesforce Marketing Cloud в качестве источника

Свойства действия поиска

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

Дополнительные ресурсы