通过

使用 Azure 数据工厂或 Synapse Analytics 在 Zendesk（预览版）中转换数据

  • 项目

适用于：Azure 数据工厂 Azure Synapse Analytics

本文概述了如何使用数据流在 Zendesk（预览版）中转换数据。 有关详细信息，请阅读 Azure 数据工厂或 Azure Synapse Analytics 的简介文章。

重要

此连接器目前提供预览版。 欢迎试用并提供反馈。 若要在解决方案中使用预览版连接器的依赖项，请联系 Azure 客户支持。

支持的功能

此 Zendesk 连接器支持以下功能：

支持的功能 IR
映射数据流（源/-） ①

① Azure 集成运行时 ② 自承载集成运行时

如需可以用作源/接收器的数据存储的列表，请参阅支持的数据存储表。

使用 UI 创建 Zendesk 链接服务

使用以下步骤在 Azure 门户 UI 中创建 Zendesk 链接服务。

  1. 浏览到 Azure 数据工厂或 Synapse 工作区中的“管理”选项卡，并选择“链接服务”，然后单击“新建”：

  2. 搜索“Zendesk（预览版）”，并选择“Zendesk（预览版）”连接器。

    显示选择 Zendesk 连接器的屏幕截图。

  3. 配置服务详细信息、测试连接并创建新的链接服务。

    Zendesk 链接服务配置的屏幕截图。

连接器配置详细信息

下面各部分介绍了用于定义 Zendesk 特定数据工厂和 Synapse 管道实体的属性的信息。

链接服务属性

Zendesk 链接服务支持以下属性：

属性 描述 必需
type type 属性必须设置为 Zendesk。 是
url Zendesk 服务的基 URL。 是
authenticationType 用于连接到 Zendesk 服务的身份验证类型。 允许的值为：基本和令牌。 有关其他属性和示例，请参阅下面的相应部分。 是

基本身份验证

将 authenticationType 属性设置为“基本”。 除了前面部分所述的通用属性，还指定以下属性：

属性 描述 必选
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 属性设置为“令牌”。 除了前面部分所述的通用属性，还指定以下属性：

属性 描述 必需
apiToken 指定用于 Zendesk 的 API 令牌。 将此字段标记为 SecureString 以安全存储它。 或者，可以引用 Azure Key Vault 中存储的机密。 是

示例：

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

映射数据流属性

转换映射数据流中的数据时，可以从 Zendesk 中读取表。 有关详细信息，请参阅映射数据流中的源转换。 只能使用内联数据集作为源类型。

源转换

下表列出了 Zendesk 源支持的属性。 你可以在“源选项”选项卡中编辑这些属性。

名称 说明 必需 允许的值 数据流脚本属性
实体 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

相关内容

有关复制活动支持作为源和接收器的数据存储的列表，请参阅受支持的数据存储。