Преобразование данных в Zendesk (предварительная версия) с помощью Фабрики данных Azure или Synapse Analytics

ОБЛАСТЬ ПРИМЕНЕНИЯ: Фабрика данных Azure Azure Synapse Analytics

Совет

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

В этой статье описано, как использовать Поток данных для преобразования данных в Zendesk (предварительная версия). Дополнительные сведения см. в вводной статье о Фабрике данных Azure или Azure Synapse Analytics.

Внимание

Сейчас этот соединитель доступен в режиме предварительной версии. Попробуйте поработать с ним и оставьте свой отзыв. Если вы хотите использовать в своем решении зависимость от соединителей в предварительной версии, обратитесь в службу поддержки Azure.

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

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

Поддерживаемые возможности	IR
Поток данных для сопоставления (источник/-)	(1)

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

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

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

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

1. Перейдите на вкладку "Управление" в Фабрике данных Azure или рабочей области Synapse и выберите "Связанные службы", затем щелкните "Создать".

   Фабрика данных Azure

   

   Azure Synapse

   

2. Выполните поиск Zendesk (предварительная версия) и выберите соединитель Zendesk (предварительная версия).

   

3. Настройте сведения о службе, проверьте подключение и создайте связанную службу.

   

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

Следующие разделы содержат сведения о свойствах, которые используются для определения сущностей Фабрики данных и конвейеров Synapse, характерных для Zendesk.

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

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

Свойство	Описание:	Обязательное поле
type	Для свойства типа необходимо задать значение Zendesk.	Да
URL-адрес	Базовый URL-адрес службы Zendesk.	Да
authenticationType	Тип проверки подлинности, используемый для подключения к службе Zendesk. Допустимые значения: basic и token. Обратитесь к соответствующим разделам ниже, в которых описываются дополнительные свойства и примеры.	Да

Обычная проверка подлинности

Задайте для свойства authenticationType значение basic. В дополнение к общим свойствам, описанных в предыдущих разделах, укажите следующие свойства:

Свойство	Описание:	Обязательное поле
userName	Имя пользователя, используемое для входа в Zendesk.	Да
password	Введите пароль для учетной записи пользователя, указанной для выбранного имени пользователя. Пометьте это поле как SecureString для безопасного хранения. Вы можете также указать секрет, хранящийся в Azure Key Vault.	Да

Пример:

{
    "name": "ZendeskLinkedService",
    "properties": {
        "type": "Zendesk",
        "typeProperties": {
            "url": "<base url>",
            "authenticationType": "basic",
            "userName": "<user name>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

Проверка подлинности на базе токенов

Задайте для свойства authenticationType значение token. В дополнение к общим свойствам, описанных в предыдущих разделах, укажите следующие свойства:

Свойство	Описание:	Обязательное поле
apiToken	Укажите токен API для Zendesk. Пометьте это поле как SecureString для безопасного хранения. Вы можете также указать секрет, хранящийся в Azure Key Vault.	Да

Пример:

{
    "name": "ZendeskLinkedService",
    "properties": {
        "type": "Zendesk",
        "typeProperties": {
            "url": "<base url>",
            "authenticationType": "token",
            "apiToken": {
                "type": "SecureString",
                "value": "<API token>"
            }
        }
    }
}

Свойства потока данных для сопоставления

При преобразовании данных в потоке данных для сопоставления можно выполнять операции чтения таблиц из Zendesk. Чтобы узнать больше, изучите преобразование источника в потоках данных для сопоставления. В качестве типа источника можно использовать только встроенный набор данных.

Преобразование источника

В приведенной ниже таблице указаны свойства, поддерживаемые источником Zendesk. Изменить эти свойства можно на вкладке Source options (Параметры источника).

Имя	Описание	Обязательное поле	Допустимые значения	Свойство скрипта для потока данных
Объект	Логическое имя сущности в Zendesk.	Да, если используется встроенный режим	activities group_memberships groups organizations requests satisfaction_ratings sessions tags targets ticket_audits ticket_fields ticket_metrics tickets triggers users views	Сущность

Примеры сценария источника Zendesk

source(allowSchemaDrift: true,
	validateSchema: false,
	store: 'zendesk',
	format: 'rest',
	entity: 'tickets') ~> ZendeskSource

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

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